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:
Appsicon on the left.
Appliance Librarypage, click on
createin the top right.
Versionof the appliance.
From the drop-down menus, select the operating system (distribution, release and architecture).
createbutton. This creates a skeleton of an appliance template in the platform which you can now customize with operating system packages, middleware and application software.
If SELinux is installed (ie the file
/etc/selinux/configexists), 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.rcchecks for the existence of
/.autorelabel. If this file exists, SELinux performs a complete file system relabel (using the
/sbin/fixfiles -f -F relabelcommand), and then deletes
- 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.
When you create an appliance, the packages are stored locally in the UForge cache repository. This ensures that the packages will always be available.
Creating a Windows-based Appliance¶
To create a Windows Appliance:
Enter the appliance name and version.
Windowsfrom the OS Distribution drop-down menu.
Select the Release and Architecture from the drop-down menus.
Stackpage, select the OS Profile from the drop-down list under
Profile name. Click
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.
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
- Click on the + sign at the top right.
- You can modify the name and partition type
- Select the filesystem to
ntfsand mount point to
- 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
Growcolumn if you want the partition to be growable.
Add software bundles from the
Software bundles included in
Projectswill 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.
For Windows, with Software bundle whose name begins with
UForgeWinDrivers, you can specify drivers to be installed in a generated machine image.
A binary called
uforge-install-config is embedded at generation time, which helps the final user of the Appliance do the last-mile configuration.
A Windows appliance created using a golden image will not list the applications and services under