Creating an Appliance Template¶
You can create either Linux-based or Windows-based appliance templates. The steps differ slightly. Please refer to the appropriate section below.
Creating a Linux-based Appliance¶
To create a new appliance in your private workspace:
Select
Apps
icon on the left.On the
Appliance Library
page, click oncreate
in the top right.Enter the
Name
andVersion
of the appliance.From the drop-down menus, select the operating system (distribution, release and architecture).
Click the
create
button. This creates a skeleton of an appliance template in the platform which you can now customize with operating system packages, middleware and application software.Note
If SELinux is installed (ie the file
/etc/selinux/config
exists), the filesystem will be relabeled on the first boot of a UForge generated machine image in order to add the SELinux context in the all system files extended attribute. At boot time,init.rc
checks for the existence of/.autorelabel
. If this file exists, SELinux performs a complete file system relabel (using the/sbin/fixfiles -f -F relabel
command), and then deletes/.autorelabel
.)
- You should now see the appliance overview page. You can add a description to your appliance (optional) and a logo (optional). The logo format must be .jpg, .jpeg or .png.
- An OS profile is mandatory. See Adding a New OS Profile. However, you can leave the appliance at this point and edit it later.
- If you have made any modifications, click the checkmark to save.
Note
When you create an appliance, the packages are stored locally in the UForge cache repository. This ensures that the packages will always be available.
Note
Due to a known missing dependency issue with packages nss-softokn and nss-softokn-freebl for CentOS and Red Hat Enterprise Linux versions 6.5 and 6.6, if your OS profile includes one of these packages you have to:
- Either add the missing dependency manually
- Go to Stack > OS Profile
- Make sure that you have both nss-softokn-freebl and nss-softokn 3.14.3. If one of the packages is missing, you must add it to the OS profile.
- Or update your OS to version 6.7 (or above)
- Go to Updates tab
- Click on 6.7 milestone (or above)
- Click
simulate
thenupdate
Otherwise, image generation will fail with a dependency checking error.
Creating a Windows-based Appliance¶
To create a Windows Appliance:
From the
Apps
tab, selectcreate
.Enter the appliance name and version.
Choose
Windows
from the OS Distribution drop-down menu.Select the Release and Architecture from the drop-down menus.
Click
create
.From the
Stack
page, select the OS Profile from the drop-down list underProfile name
. Clicksave
.Note
Once you have chosen the OS Profile, you cannot add any packages or run updates. The OS Profile is static. Once created, if you select OS Profile, you will only be able to view the details of the profile you selected.
Set the Install profile and click
Save
. For more information, refer to Updating a Windows-based Install Profile.Note
Unlike Linux, the following cannot be set for Windows appliances: Root User, Users and Groups, Security, Kernel, Keyboards, Licences.
- Optionally you can add partitions.
- Click on
Partitioning
and selectAdvanced Partitioning
.- Click on the + sign at the top right.
- You can modify the name and partition type
- Select the filesystem to
ntfs
and mount point toD:
(for example).- Enter the size. The install disk should be 12 Gb for core versions and not less than 32Gb for the full version.
- Check the box in the
Grow
column if you want the partition to be growable.- Click
save
.Add software bundles from the
Projects
orMySoftware
pages.Warning
Software bundles included in
MySoftware
andProjects
will be put on the image disk but the UForge generation tool WILL NOT install them even if these are executable/installers files (.exe, .msi, etc.). It is up to the end user to manually complete the installation of the software bundles.For Windows, .exe or .msi files can be given extra parameters. The parameters depend on the .exe or .msi file, and can be used for example for silent installation, providing extra configuration values, etc.
Note
For Windows, with Software bundle whose name begins with UForgeWinDrivers
, you can specify drivers to be installed in a generated machine image.
Note
A binary called uforge-install-config
is embedded at generation time, which helps the final user of the Appliance do the last-mile configuration.
Note
A Windows appliance created using a golden image will not list the applications and services under Stack
> OS Profile
.