Default.Ini Parameters

Using the Image Prepare System › Default.ini › Default.Ini Parameters

Default.Ini Parameters

The default.ini parameter sections have the following structure:

[parametername] Type={ Text | Pwd | IP | Num | BootImage | OSImage | Mac | MapList | MapListExt | TextList | TextListExt }

The remaining entries of a parameter definition section and their ranges depend on the parameter type (Type=).

Text Parameter

Provides any simple text string. The length of the string can be limited by the MaxLength attribute. The following parameter attributes are valid for this parameter type:

Attribute	Meaning	Range
MaxLength	Maximum length of the strings to be assigned	1 to 255 characters
Comment	Comment on the parameter	any string
Trans	Drives the inheritance of parameter settings	{yes\|no}
UpdateDefault	Overwrites the default value when updating the image	{yes\|no}

Password Parameter

Provides an encoded password. The password can be limited to MaxLength characters. A password is always related to a user ID. The following parameter attributes are valid for this parameter type:

Attribute	Meaning	Range
MaxLength	Maximum length of the password to be assigned	1 to 255 characters
Comment	Comment on the parameter	any string
Trans	Drives the inheritance of parameter settings	{yes\|no}
UpdateDefault	Overwrites the default value when updating the image	{yes\|no}

IP Parameter

Specifies an IP address of the format a.b.c.d where each a...d represents an integer value between 0 and 255. The following parameter attributes are valid for this parameter type:

Attribute	Meaning	Range
MaxLength	Maximum length of the IP address	17 characters
Comment	Comment on the parameter	any string
Trans	Drives the inheritance of parameter settings	{yes\|no}
UpdateDefault	Overwrites the default value when updating the image	{yes\|no}

Numeric Parameter

Specifies a numeric value. The range of the value is given by the attributes MaxValue, which specifies the maximum, and MinValue, which specifies the minimum. The value of MinValue must be less than or equal to the value of MaxValue. The following parameter attributes are valid for this parameter type:

Attribute	Meaning	Range
MaxValue	Maximum of the value assigned	-2147483648 to 2147483647
MinValue	Minimum of the value assigned	-2147483648 to 2147483647 and MinValue <= MaxValue
Comment	Comment on the parameter	any string
Trans	Drives the inheritance of parameter settings	{yes\|no}
UpdateDefault	Overwrites the default value when updating the image	{yes\|no}

Boot Image Parameter

Specifies the name of a boot image. The following parameter attributes are valid for this parameter type:

Attribute	Meaning	Range
MaxLength	Maximum length of the boot image name	1 to 8 characters
Comment	Comment on the parameter	any string
Trans	Drives the inheritance of parameter settings	{yes\|no}
UpdateDefault	Overwrites the default value when updating the image	{yes\|no}

OS Image Parameter

Specifies the name of an operating system image. The following parameter attributes are valid for this parameter type:

Attribute	Meaning	Range
MaxLength	Maximum length of the operating system image name	1 to 10 characters
Comment	Comment on the parameter	any string
Trans	Drives the inheritance of parameter settings	{yes\|no}
UpdateDefault	Overwrites the default value when updating the image	{yes\|no}

Mac Parameter

Specifies a MAC address of the format ab.cd.ef.gh.ij.kl where each a...l represents a hexadecimal digit (0-9, a-f). The following parameter attributes are valid for this parameter type:

Attribute	Meaning	Range
MaxLength	Maximum length of the IP address	12 characters
Comment	Comment on the parameter	any string
Trans	Drives the inheritance of parameter settings	{yes\|no}
UpdateDefault	Overwrites the default value when updating the image	{yes\|no}

Mapping List / Mapping List Extended Parameter

Specifies a list of item=<string1> <string2>. String2 is shown in the editor only, when string1 has been assigned a value.

The parameter editor can extend parameters of type MapListExt, but not of type MapList.

When assigning a value to a parameter, it can only be a string that is appearing in the list.

The following parameter attributes are valid for these parameter types:

Attribute	Meaning	Range
MaxLength	Maximum length of a list entry	1 to 255 characters
Comment	Comment on the parameter	any string
Trans	Drives the inheritance of parameter settings	{yes\|no}
UpdateDefault	Overwrites the default value when updating the image	{yes\|no}
Item	Specifies a list item. This attribute can occur more than once.	"string1" "string2"

Text List / Extended Text List Parameter

TextListExt specifies a list of item=<string>; that is, it is the same as a TextList parameter, but the list can be extended with the parameter editor later on.

The following parameter attributes are valid for this parameter type:

Attribute	Meaning	Range
MaxLength	Maximum length of a list entry	1 to 255 characters
Comment	Comment on the parameter	any string
Trans	Drives the inheritance of parameter settings	{yes\|no}
UpdateDefault	Overwrites the default value when updating the image	{yes\|no}
Item	Specifies a list item. This attribute can occur more than once.	any string

UpdateDefault

The RegisterOSImage command provides an option to overwrite the default values of the parameters in the database. For the overwrite operation to be successful, you must set the UpdateDefault attribute of the parameter to Yes; Otherwise, the default value are not overwritten. The following RegisterOS command overwrites the default values:

RegisterOSImage -i <image_name> -s <manager> -e [-b]