D.5 Imaging Configuration Parameters (settings.txt)

The settings.txt file contains parameters that control how the imaging boot process occurs. A copy is located in the /opt/novell/zenworks/zdm/imaging/winutils directory on the imaging server where ZENworks Linux Management is installed. You should maintain the working copy of settings.txt at the root of the imaging boot device (CD or DVD, or ZENworks partition).

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 manually in a text editor, or by making configuration changes in the zimgboot.exe utility (see Section D.4, ZENworks Imaging Floppy Boot Disk Creator (zmediacreator.exe)).

IMPORTANT:If you manually 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.

The format and function of each parameter in the settings.txt file are described in Table D-4:

Table D-4 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 Linux 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 manually 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 manually.

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:

  • If you leave it commented out or set it to No, you are prompted to remove the imaging boot media (if necessary) and press any key to reboot the device to the native operating system.

  • If you set this parameter to Yes, the device doesn’t reboot automatically, but instead displays the Linux bash 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 such as check the current partition information or the image-safe data before booting to the native operating system.

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 on this parameter.

Example: PARTITIONSIZE=500

netsetup

If you are using DHCP, keep this option enabled. If you are using a specific IP address, replace “dhcp” with “1” and uncomment and configure the other three IP address lines (HostIP, NETMASK, and GATEWAY).

Example: netsetup=dhcp

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=137.65.95.126

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=137.65.95.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:

  • PROXYADDR=137.65.95.127
  • PROXYADDR=imaging.xyz.com

This parameter is used to set the PROXYADDR environment variable in Linux 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 specified in /srv/tftp/boot/settings.txt, which is the copy of settings.txt that is used by PXE.

/bin/setleds -D +num < /dev/tty1

Turns on NUMLOCK upon booting.

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 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).

export ENTERPISE_NAME=name

This feature is not supported in Novell ZENworks Linux Management.

This should be a valid Enterprise Name for an AMT device, such as entZENworks. It allows imaging utilities to access image-safe data in AMT NVRAM when AMT devices are disconnected from the ZENworks Management Zone.

If you do not use this parameter for disconnected AMT devices, the imaging utilities might not be able to keep the image-safe data up to date.

netdevice=eth0

Selects a specific network adapter. If necessary, replace eth0 with the correct interface.

noshell=1

Suppresses a secondary terminal program from displaying.