The settings.txt file contains parameters that control how the imaging boot process occurs. You should maintain the working copy of settings.txt at the root of the imaging boot device (CD, DVD or bootable USB, or ZENworks partition):
Windows: %ZENWORKS_HOME%\bin\preboot\
Linux: /opt/microfocus/zenworks/preboot/bin/winutils/
The Imaging distro is based on SLES 11. This requires you to additionally maintain a working copy of settings.txt in the /tftp/boot/ directory of the Imaging Server.
Settings.txt is a plain text file that contains various parameters, each on a separate line. Each parameter has the general format of PARAMETER=value. Lines that begin with a pound sign (#) signify comments and are ignored during the imaging boot process.
You can edit this file in a text editor, or by making configuration changes in the zmediacreator.exe utility.
IMPORTANT:If you edit the settings.txt file to provide any paths to executables, make sure that you provide the full path, or the executable might not run. Also, make sure not to change the order of the settings in the file.
The format and function of each parameter in the settings.txt file are described in Table D-7:
Table D-7 Settings.txt File Parameters
|
Parameter |
Specifies |
|---|---|
|
PROMPT |
Specifies whether to prompt for each configuration setting when you boot a device from the imaging boot media. If you leave this parameter commented out or set it to No, the device boots using the configuration settings specified in settings.txt and you can’t override the settings when booting, unless you type config at the boot prompt before the operating system begins to load. If you set this parameter to Yes, you are automatically prompted for each configuration setting when booting. |
|
MANUALREBOOT |
Specifies whether you must reboot a device after it was booted from the imaging boot media in automatic mode. If the device was booted from the imaging boot media in manual mode, you must always reboot the device . If you boot a device from the imaging boot media and you let the boot process proceed in automatic mode, the ZENworks Imaging Engine starts and checks the Imaging Server to see if an imaging operation should be performed on the device. If so, it performs the imaging operation and quits. If not, it quits without doing anything. What happens next depends on how you set this parameter:
Example: MANUALREBOOT=YES |
|
PARTITIONSIZE |
Specifies the number of megabytes to allocate to the ZENworks partition if you choose to create one locally on a device when you boot the device from the imaging boot media. The default size is 150 MB. The minimum partition size is 50 MB. The maximum size allowed is 2048 MB (2 GB). If you plan to store an image in the ZENworks partition, such as to enable the device to be restored to a certain state without connecting to the network, you might want to specify a larger size for this parameter. Example: PARTITIONSIZE=500 |
|
NOABORTBUTTON |
To cancel any Imaging operation in progress, you need the ABORT button on the Imaging interface. If you do not need this functionality, you can hide this button by setting the NOABORTBUTTON variable appropriately. Example: export NOABORTBUTTON=a |
|
netsetup |
If you are using DHCP, keep this option enabled. By default, the value is “dhcp,now”. If you are using a specific IP address, replace “dhcp, now” with “-dhcp, now” and uncomment and configure the other three IP address lines (HostIP, netmask, and gateway). Example: netsetup=-dhcp,now NOTE:Specificing an IP address is not applicable for PXE boot. |
|
HostIP |
The IP address used by a device to communicate on the network when you boot the device from the imaging boot media, if a static IP address is needed. Example: HostIP=123.45.67.89 If you want DHCP to be used, leave this and the next two parameters commented out. |
|
netmask |
Specifies the subnet mask to be used by the device, if the device is using a static IP address. Example: netmask=255.255.252.0 If DHCP is being used, leave this parameter commented out. |
|
gateway |
Specifies the IP address of the gateway (router) to be used by the device, if the device is using a static IP address. Example: gateway=123.45.67.254 If DHCP is being used, leave this parameter commented out. |
|
nameserver |
Specifies the list of DNS name servers, by IP address, to use for resolving DNS domain names used on this device. Use a space to separate entries. Example: nameserver=123.45.6.7 123.45.6.9 If DHCP is being used, leave this parameter commented out. |
|
domain |
Specifies the list of DNS domain suffixes to be used to identify connections used by this device. Use a space to separate entries. For example: domain=example.novell.com example.xyz.org If DHCP is being used, leave this parameter commented out. |
|
PROXYADDR |
Specifies the IP address or full DNS name of the imaging (proxy) server to connect to when you boot a device from the imaging boot media in auto-imaging mode. Examples:
This parameter is used to set the PROXYADDR environment variable when the device is booted from an imaging boot media (other than PXE). The ZENworks Imaging Engine then reads this variable to determine which server to contact if it is running in automatic mode. Whether it is running in automatic or manual mode, the ZENworks Imaging Engine attempts to log the imaging results to the server specified in this variable. IMPORTANT:This parameter is set automatically when booting PXE and normally should not be modified in the copy of settings.txt that is used by PXE: Windows: %ZENWORKS_HOME%\share\tftp\boot\ Linux: /srv/tftp/boot/ |
|
export IMGCMD |
Alters the behavior of automated imaging. If this variable is defined as a script (or a series of commands), then that script (or those commands) are executed instead of the usual img -auto command (see /bin/imaging.s). |
|
netdevice=eth0 |
Selects a specific network adapter. If necessary, replace eth0 with the correct interface. |