Shell Commands › Utilities › iso2class: Appliance Distro Creation Utility › iso2class Reference - Usage

iso2class Reference - Usage

Create a singleton class using an OS installed from an ISO image

Syntax

util iso2class app_name=<name> install_size=<size> console_type=<type> iso_volume1=<name> (iso_volume2=<name> iso_volume3=<name> iso_volume4=<name> (<prop>=<val>)*)

Options

app_name=<name>

Name of application to create which will include the singleton.

install_size=<size>

Size of the target volume for the OS install. Format is: <val>[M|G]. Units default to MB unless otherwise specified. Minimum is 10 MB.

console_type=<type>

Type of console to use for OS install. Valid values are 'text' and 'graphic'.

iso_volume1=<name>

The ISO volume to boot from to perform the OS install. _GLOBAL:vol_name copies an existing global volume. http://<path> imports the volume from a URL. vol_name imports the volume from the _impex volume of the grid.

iso_volume2=<name>

optional volume in the same format as iso_volume1. Typically this is a second disk where the install requires multiple CD's or DVD's.

iso_volume3=<name>

An optional volume in the same format as iso_volume1. Typically this is a third disk where the install requires multiple CD's or DVD's.

iso_volume4=<name>

An optional volume in the same format as iso_volume1. Typically this is a fourth disk where the install requires multiple CD's or DVD's.

<prop>=<val>

Operational parameters. The following parameters may be specified:

• os - Name of the OS. This will be put in the descriptor of the appliance. See the Supported Operating Systems section for list of allowed values. If an invalid or no value is specified, iso2class will print the list of supported operating systems and prompt for a choice.
• virt_options - Virtualization options in the form of a comma-separated list of <option>=<val> pairs. For example: virt_options=acpi=1
• virt_mode - Virtualization mode when hvm2pv is used to convert the class to a managed appliance. Valid values are 'xen_pv', 'xen_hvm' and 'vmware'. More than one value can be specified, separated by a coma. Default: 'xen_pv,xen_hvm,vmware'. This has no effect if hvm2pv is not run, in which case virtualization mode will be set to 'xen_hvm,vmware'.
• url_volume1_size - Size of the volume to create when importing a compressed ISO image. If not specified, the image must be uncompressed twice. Format is: <val>[M|G]. Units default to MB unless otherwise specified. Minimum is 10 MB.
• url_volume2_size - Size of the volume to create when importing a compressed ISO image for iso_volume2
• url_volume3_size - Size of the volume to create when importing a compressed ISO image for iso_volume3
• url_volume4_size - Size of the volume to create when importing a compressed ISO image for iso_volume4
• url_user - User name for authentication when importing a volume from a URL. If not specified, no authentication is assumed.
• url_pwd - Password for authentication when importing a volume from a URL.
• cpu - Default CPU allocation for the singleton. Format is: <val>[%].
• mem - Default memory allocation for the singleton. Format is: <val>[M|G]
• bw - Default bandwidth allocation for the singleton. Format is: <val>[M|G]

Notes

• The url_volumeX size should be specified when importing a compressed volume from a URL. If a volume size is not specified, the image is essentially downloaded and uncompressed twice - once to get the uncompressed size and once to transfer the actual data.
• Once the OS install is complete, the application is stopped and the following modifications are made to the singleton:
  • Remove iso_volume(s) from the singleton
  • Disable the external interface.
  • Add 'in', 'out', 'net' and 'mon' terminals.
  • Set the field engineering code according to whether the singleton is managed (for example, contains a Windows MSI install).

Supported Operating Systems

• win2003-datacenter-64 - Microsoft Windows Server 2003, Datacenter Edition (64-bit)
• win2003-enterprise-64 - Microsoft Windows Server 2003, Enterprise Edition (64-bit)
• win2003-standard-64 - Microsoft Windows Server 2003, Standard Edition (64-bit)
• win2003-datacenter - Microsoft Windows Server 2003, Datacenter Edition (32-bit)
• win2003-enterprise - Microsoft Windows Server 2003, Enterprise Edition (32-bit)
• win2003-standard - Microsoft Windows Server 2003, Standard Edition (32-bit)
• win2003-web - Microsoft Windows Server 2003, Web Edition
• win2008r2-64 - Microsoft Windows Server 2008 R2 (64-bit)
• win2008 - Microsoft Windows Server 2008 (32-bit)
• linux - Linux (32-bit)
• linux-64 - Linux (64-bit)
• solaris10 - Sun Solaris 10 (32-bit)
• solaris10-64 - Sun Solaris 10 (64-bit)
• other - Other (32-bit)
• other-64 - Other (64-bit)
• windows - same as win2008r2-64 (backwards compatibility)
• solaris - same as solaris10 (backwards compatibility)

Examples

util iso2class app_name=my-app iso_volume1=_GLOBAL:win-disk-1.iso iso_volume2=_GLOBAL:win-disk-2.iso install_size=3G console_type=graphic virt_options=acpi=1 os=windows

util iso2class app_name=my-app iso_volume1=http://path-to-iso-image url_volume1_size=1G install_size=5G console_type=text mem=1G cpu=1.0