The settings.txt file contains parameters that control how the imaging boot-up process occurs. This file is mandatory for Interim Release 4 (IR4) or later.
You should maintain the working copy of settings.txt at the root of the imaging boot device (CD or DVD, or ZENworks partition). For IR4, you should also maintain the 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 (#) are comments and are ignored during the imaging boot process.
You can edit this file manually in a text editor, manually using the option in the zimgboot.exe utility, or by making configuration changes in the zimgboot.exe utility.
NOTE:For IR4 or later, ensure that you do not change the order of the settings in the Settings.txt file.
The format and function of each parameter in the settings.txt file are described in Table 63-6:
Table 63-6 Settings.txt Parameters
|
Parameter |
Description |
|---|---|
|
MANUALREBOOT |
Specifies whether to access the bash prompt to reboot a workstation manually after it was booted from the imaging device in automatic mode. (If the workstation was booted from the imaging device in manual mode, you must always reboot the workstation manually.) If you boot a workstation from the imaging device and you let the boot process proceed in automatic mode, the ZENworks Imaging Engine starts and checks the ZENworks Imaging server to see if an imaging operation should be performed on the workstation. If so, it performs the imaging operation and then quits. If not, it quits without doing anything. What happens next depends on how you set this parameter. If you leave it commented out or set it to , you are prompted to remove the imaging device (such as the CD or diskette, if necessary) and press any key to reboot the workstation to the native operating system. If you set this parameter to , the workstation doesn’t reboot automatically but instead displays the Linux prompt, allowing you to perform additional imaging-related tasks using the Linux menu or at the command line. This is helpful if you want to do things like check the current partition information or the image-safe data before booting to the native operating system. Example: MANUALREBOOT=YES |
|
PARTITIONSIZE |
The number of megabytes to allocate to the ZENworks partition if you choose to create one locally on a workstation when you boot the workstation from the imaging device. 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, for example to enable the workstation 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 |
|
netsetup |
For IR1, IR2, or IR3a: If you are using DHCP, keep netsetup=dhcp,all enabled. If you are using a specific IP address, replace dhcp,all with -dhcp,all then uncomment and configure the other three IP address lines (HostIP, NETMASK, and GATEWAY). Example: netsetup=-dhcp,all For IR4 or later: If you are using DHCP, keep netsetup=dhcp,now, all enabled. If you are using a specific IP address, do the following:
|
|
HostIP |
The IP address used by a device to communicate on the network when you boot the device from the imaging device, if a static IP address is needed. Example: HostIP=137.65.95.126 If you want DHCP to be used, leave this and the next two parameters commented. |
|
NETMASK |
The subnet mask to be used by the workstation, if the workstation is using a static IP address. Example: NETMASK=255.255.252.0 If DHCP is being used, leave this parameter commented. |
|
GATEWAY |
The IP address of the gateway (router) to be used by the workstation, if the workstation is using a static IP address. Example: gateway=137.65.95.254 If DHCP is being used, leave this parameter commented. |
|
NAMESERVER |
For IR1, IR2, or IR3a: The list of DNS name servers, by IP address, to use for resolving DNS domain names used on this workstation. 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. For IR4 or later: The list of DNS name servers, by IP address, to use for resolving DNS domain names used on this workstation. Use a comma to separate entries. Example: NAMESERVER=123.45.6.7,123.45.6.9 If DHCP is being used, leave this parameter commented. |
|
DOMAIN |
The list of DNS domain suffixes to be used to identify connections used by this workstation. Use a space to separate entries. Example: DOMAIN=example.novell.com example.xyz.org If DHCP is being used, leave this parameter commented. |
|
PROXYADDR |
The IP address or full DNS name of the imaging (proxy) server to connect to when you boot a workstation from the imaging device in auto-imaging mode. Examples: PROXYADDR=137.65.95.127 PROXYADDR=imaging.xyz.com This parameter is used to set the PROXYADDR environment variable in Linux when the workstation is booted from the imaging device. The ZENworks Imaging Engine then reads this variable to determine which server to contact if it’s running in automatic mode. Whether it’s running in automatic or manual mode, the ZENworks Imaging Engine attempts to log the imaging results to the server specified in this variable. |
|
export PS1="\`pwd \`#" |
Configures the string used by the bash shell. You can change the string by editing the text after the = symbol. The ‘ character is not a single quote mark, but is from the ~ key. |
|
export IMGCMD |
Use this parameter to alter 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. |