2.4 Deploying and Managing Preboot Services

The following sections explain how to set up, deploy, and manage Preboot Services, and how to set up standard DHCP and novell-proxydhcp on the same server.

For information on using Preboot, see Section 3.0, Using Imaging.

2.4.1 Checking the Preboot Services Imaging Server Setup

This section provides information on how to check the configuration of Preboot Services after it is installed.

Overview of Preboot Services Components

The following components are installed as part of Preboot Services:

Table 2-1 Preboot Service Components

Windows Executable and Service Names

Linux Daemon

Description

novell-pbserv.exe

Novell ZENworks Preboot Service

novell-pbserv

Provides imaging services to devices.

novell-proxydhcp.exe

Novell Proxy DHCP Service

novell-proxydhcp

Runs alongside a standard DHCP server to inform PXE devices of the IP address of the TFTP server. The Proxy DHCP server also responds to PXE devices to indicate which bootstrap program (nvlnbp.sys or nvlnbpx64.efi) to use.

novell-tftp.exe

Novell TFTP Service

novell-tftp

Used by PXE devices to request files that are needed to perform imaging tasks. The TFTP server also provides a central repository for these imaging files, such as the Linux kernel, initrd, and nvlnbp.sys or nvlnbpx64.efi.

A PXE device uses this server to download the bootstrap program (nvlnbp.sys or nvlnbpx64.efi).

novell-zmgprebootpolicy.exe

Novell ZENworks Preboot Policy Service

novell-zmgprebootpolicy

The PXE devices use this to check if there are any Preboot bundles that are assigned to the device.

Novell-proxydhcp must be started and does not need to be run on all Imaging Servers.

HINT:To automatically start novell-proxydhcp on server start-up, run the following command as root: chkconfig novell-proxydhcp on. For more information, see Unable to use chkconfig with the novell-proxydhcp init script on SLES 11 or SLED 11.

While taking an image, the novell-pbserv service must be running on the server where the ZENworks image is to be stored. During restoring the image, the novell-pbserv service must be running on the server where the ZENworks image is located.

The other three services are started automatically when installing ZENworks, or any time the server is rebooted, and must run on all Imaging Servers.

For more information, see Section D.10, Imaging Server.

Checking the Setup

After the Preboot Services components are installed, the following should be installed and running on the server. You can use these methods to check their status:

Table 2-2 Preboot Services Or Daemons

Service

Method to Check Its Status

novell-pbserv

Windows: In the Services dialog box, review the Status column of Novell ZENworks Preboot Service.

Linux: /etc/init.d/novell-pbserv status

novell-tftp

Windows: In the Services dialog box, review the Status column of Novell TFTP Service.

Linux: /etc/init.d/novell-tftp status

novell-zmgprebootpolicy

Windows: In the Services dialog box, review the Status column of Novell ZENworks Preboot Policy Service.

Linux: /etc/init.d/novell-zmgprebootpolicy status

NOTE:To check the status of Preboot services on SLES12 OS onwards, use the systemctl command:

  • systemctl status novell-pbserv.service

  • systemctl status novell-tftp.service

  • systemctl status novell-zmgprebootpolicy.service

You should not change the default configuration of these services.

If the server where the Preboot Services components are installed is also a DHCP server, see Configuring LAN Environments for Preboot Services.

2.4.2 Deploying Preboot Services in a Network Environment

To implement the network deployment strategies outlined in this section, you must have a solid understanding of the TCP/IP network protocol and specific knowledge of TCP/IP routing and the DHCP discovery process.

Deploying Preboot Services (with PXE) in a single network segment is a relatively simple process. However, Preboot Services deployment in a multi-segment network is far more complex and might require configuration of both the Preboot Services services or daemons and the network switches and routers that lie between the server and the PXE devices.

Configuring the routers or switches to correctly forward Preboot Services network traffic requires a solid understanding of the DHCP protocol, DHCP relay agents, and IP forwarding. The actual configuration of the switch or router must be performed by a person with detailed knowledge of the hardware.

We strongly recommend that you initially set up Preboot Services in a single segment to ensure that the servers are configured correctly and are operational.

This section includes the following information:

Server Configuration

There are three important points about configuring servers for Preboot Services:

  • DHCP Server: The Preboot Services environment requires a standard DHCP server. It is up to you to install your standard DHCP server.

  • Preboot Services or Daemons: The four Preboot Services services or daemons (novell-pbserv, novell-tftp, novell-proxydhcp, and novell-zmgprebootpolicy) are all installed on the Imaging Server when you install ZENworks. These services or daemons must run together on the same server.

  • Imaging Server: The Preboot Services services or daemons can be installed and run on the same or different server than DHCP.

The following sections give general information about these services:

It is seldom necessary to make changes to the default configuration of these services. However, if you need more detailed configuration information, see Configuring Preboot Services Imaging Servers.

The DHCP Server

The standard DHCP server must be configured with an active scope to allocate IP addresses to the PXE devices. The scope options should also specify the gateway or router that the PXE devices should use.

If Preboot Services (specifically novell-proxydhcp) is installed on the same server as the DHCP server, the DHCP server must be configured with a special option tag. For more information, see Configuring LAN Environments for Preboot Services.

Novell-pbserv

Provides imaging services to devices.

This includes sending and receiving image files, discovering assigned Preboot bundles, acting as session master for multicast imaging, and so on.

Novell-proxydhcp

The Preboot Services Proxy DHCP server runs alongside a standard DHCP server to inform PXE devices of the IP address of the TFTP server, the IP address of the server where novell-zmgprebootpolicy is running, and the name of the network bootstrap program (nvlnbp.sys or nvlnbpx64.efi).

Novell-tftp

Used by PXE devices to request files that are needed to perform imaging tasks. The TFTP server also provides a central repository for these files.

A PXE device uses one of these servers to download the network bootstrap program (nvlnbp.sys or nvlnbpx64.efi).

Novell-zmgprebootpolicy

PXE devices use novell-zmgprebootpolicy to check if there are any imaging actions that need to be performed on the device. It forwards requests to novell-pbserv on behalf of PXE devices.

If you are using Intel AMT, support for it should be enabled in the novell-zmgprebootpolicy.conf file, which is located at:

Windows: %ZENWORKS_HOME%\conf\preboot\

Linux: /etc/opt/novell/zenworks/preboot/

Network Configuration

The configuration required to run Preboot Services in your network depends on your network setup. Design your network so that PXE devices can effectively connect to the server where the Preboot Services services or daemons are running. Make sure you consider the number of PXE devices to be installed on the network and the bandwidth available to service these devices. To understand how the devices and servers need to interact during the Preboot Services process, see Section 1.5, The Preboot Services Processes.

You can configure Preboot Services where Preboot Services and DHCP are running on the same server or on different servers in both LAN and WAN/VLAN environments:

Understanding Preboot Services in LAN and WAN/VLAN Environments

Imaging servers should be installed so that PXE devices have access to imaging services within their LAN. A good design ensures that a client does not need to connect to imaging services through a slow WAN link.

Although you can have any number of Imaging Servers, generally only one Proxy DHCP server should be enabled per DHCP server scope.

In a WAN, the PXE device is usually separated from the Proxy DHCP and DHCP servers by one or more routers. The PXE device broadcasts for DHCP information, but by default the router does not forward the broadcast to the servers, causing the Preboot Services session to fail.

In a VLAN (Virtual LAN) environment, the PXE device is logically separated from the Proxy DHCP server and the DHCP server by a switch. At the IP level, this configuration looks very similar to a traditional WAN (routed) environment.

In a typical VLAN environment, the network is divided into a number of subnets by configuring virtual LANs on the switch. Devices in each virtual LAN usually obtain their IP address information from a central DHCP server. In order for this system to work, it is necessary to have Bootp or IP helpers configured on each gateway. These helpers forward DHCP requests from devices in each subnet to the DHCP server, allowing the DHCP server to respond to devices in that subnet.

Comparing Preboot Services Setups in LAN and WAN/VLAN Environments

The following illustrates the differences for a LAN configuration between installing Preboot Services on the same server as DHCP, or on a separate server. In this case, only the PXE devices on the LAN connect to the Preboot Services Imaging Server.

Table 2-3 LAN Configuration Differences Between the Same and Separate Servers

Information

On the Same Server

On Separate Servers

Configuration

Because Preboot Services and DHCP are running on the same server, option tag 60 must be set on the DHCP server.

For information on setting this tag, see Configuring LAN Environments for Preboot Services.

None required.

Advantages

  • Easy installation and setup.

  • No network configuration is required.

  • Easiest installation and setup.

  • No network configuration is required.

  • No DHCP server configuration is required.

Disadvantages

  • DHCP server configuration is required (option tag 60).

  • Limited use, because a single-LAN environment only exists in small lab-type networks.

  • Limited use, because a single-LAN environment only exists in small lab-type networks.

The following illustrates the differences for a WAN/VLAN configuration between installing Preboot Services on the same server as DHCP, or on a separate server. In this case, all PXE devices over the entire WAN/VLAN connect to the Preboot Services Imaging Server.

Table 2-4 WAN/VLAN Configuration Differences Between the Same and Separate Servers

Information

On the Same Server

On Separate Servers

Configuration

The routers/switches have been configured with IP helpers to forward network traffic to the DHCP server.

Because Preboot Services and DHCP are running on the same server, option tag 60 is set on the DHCP server.

For information on setting this tag, see Configuring a WAN/VLAN with Preboot Services and DHCP Running on the Same Server.

A DHCP relay agent or IP helper is configured on the router/switch serving the subnet that the PXE device belongs to. The helper is configured to forward all DHCP broadcasts that are detected in the subnet to the DHCP and Proxy DHCP servers.

This normally requires two helpers to be configured: the first to forward DHCP broadcasts to the DHCP server, and the second to forward the DHCP broadcasts to the Proxy DHCP server.

Advantages

  • No network equipment (routers/switches) needs to be configured to forward network traffic to the TFTP server.

  • Common network setup.

  • Multiple Preboot Services Imaging Servers can be installed so that each server provides service only for certain subnets.

Disadvantages

  • DHCP server configuration required (option tag 60).

  • Only one Preboot Services Imaging Server can be installed because it needs to run on the same server as the DHCP server (and there is usually only one DHCP server).

  • The network equipment (routers/switches) must be configured with additional IP helpers. Some network equipment might not function properly when more than one additional IP helper is configured.

Configuring LAN Environments for Preboot Services

If you have Preboot Services and DHCP running on separate servers, no network configuration is required.

If you have Preboot Services and DHCP are running on the same server, option tag 60 must be set on the DHCP server. Do the following according to the server’s platform:

Linux DHCP Server : Do the following to set up standard DHCP and Proxy DHCP on the same Linux server:

  1. Stop the DHCP services on the Linux Imaging Server.

  2. On this server, open /etc/dhcpd.conf, the DHCP configuration file, in an editor.

  3. Insert the following line in the file:

    option vendor-class-identifier "PXEClient";
  4. Save the file.

  5. Restart the DHCP service.

Windows DHCP Server : Do the following to set up standard DHCP and Proxy DHCP on the same Windows server:

  1. At the command prompt, enter netsh.

  2. At the netsh prompt, enter dhcp server.

  3. At the dhcp server prompt, enter the following:

    add optiondef 60 ClassID STRING 0 PXEClient
    set optionvalue 60 STRING PXEClient
    show optionvalue all
    exit
  4. Add the definition type in the DHCP setup menus.

Configuring a WAN/VLAN with Preboot Services and DHCP Running on the Same Server

You can install Configuration Management (which includes Preboot Services) on the same server where DHCP is installed and running. However, you must do the following to make it work:

  • Set option tag 60 on the DHCP server so that it can work with novell-proxydhcp. See the steps in the previous section (Configuring LAN Environments for Preboot Services).

  • On the server, edit the novell-proxydhcp.conf file and change:

    LocalDHCPFlag = 0

    to

    LocalDHCPFlag = 1

    The file is located at:

    Windows: %ZENWORKS_HOME%\conf\preboot\

    Linux: /etc/opt/novell/

    Then restart the service so that the change is recognized by entering the following command on the server:

    Windows: In the Services dialog box, right-click Novell Proxy DHCP Service, then select Restart.

    Linux: /etc/init.d/novell-proxydhcp restart

IMPORTANT:If the switch is acting as a firewall and limiting the type of traffic on the network, understand that novell-tftp and novell-zmgprebootpolicy are not firewall or network filter friendly. You should not attempt to run these services or daemons through a firewall. If users need to pass preboot work through a firewall, then all Preboot Services work needs to be on the outside and merely reference a Web service inside the firewall.

Configuring a WAN/VLAN With Preboot Services and DHCP Running on Separate Servers

You can install Configuration Management (which includes Preboot Services) on a separate server than where DHCP is installed and running. However, you must configure the network equipment so that it correctly forwards Preboot Services network traffic.

IMPORTANT:If the switch is acting as a firewall and limiting the type of traffic on the network, understand that novell-tftp and novell-zmgprebootpolicy are not firewall or network filter friendly. You should not attempt to run these services or daemons through a firewall. If users need to pass preboot work through a firewall, then all Preboot Services work needs to be on the outside and merely reference a Web service inside the firewall.

An example deployment is given below of a WAN/VLAN environment with Preboot Services and DHCP running on separate servers. The following sections provide the specific steps required to configure network equipment so that it correctly forwards Preboot Services network traffic.

Example Deployment

In this example, three VLANs are configured on a Bay Networks Accel 1200 switch running firmware version 2.0.1. One VLAN hosts the Proxy DHCP server, the second VLAN hosts the DHCP server, and the third VLAN hosts the PXE device. The PXE device’s DHCP broadcast is forwarded by the switch to both the Proxy DHCP server and the DHCP server. The response from both servers is then routed correctly back to the PXE device, and the PXE device starts the Preboot Services session correctly.

The three VLANs are all 24-bit networks; their subnet mask is 255.255.255.0.

The first VLAN gateway is 10.0.0.1. This VLAN hosts the PXE device that is allocated an IP in the range of 10.0.0.2 to 10.0.0.128. This VLAN is named VLAN1.

The second VLAN gateway is 10.1.1.1. This VLAN hosts the DHCP server with IP 10.1.1.2. This VLAN is named VLAN2.

The third VLAN gateway is 196.10.229.1. This VLAN hosts the server running novell-proxydhcp and novell-zmgprebootpolicy. The server’s IP is 196.10.229.2. This VLAN is named VLAN3.

Routing is enabled between all VLANs. Each VLAN must be in its own spanning tree group.

Configuring Cisco Equipment

  1. Go to the Global configuration mode.

  2. Type ip forward-protocol udp 67, then press Enter.

  3. Type ip forward-protocol udp 68, then press Enter.

  4. Go to the LAN interface that serves the PXE device.

  5. Type ip helper-address 10.1.1.2, then press Enter.

  6. Type ip helper-address 196.10.229.2, then press Enter.

  7. Save the configuration.

Configuring Nortel Networks Equipment

  1. Connect to the router with Site Manager.

  2. Ensure that IP is routable.

  3. Enable the Bootp check box on the PXE device subnet/VLAN.

  4. Select the interface that the PXE devices are connected to.

  5. Edit the circuit.

  6. Click Protocols.

  7. Click Add/Delete.

  8. Ensure that there is a check mark in the Bootp check box.

  9. Click OK.

  10. Click Protocols > IP > Bootp > Relay Agent interface table.

    The interface where Bootp was enabled is visible in the list.

  11. Click Preferred server.

  12. Change the Pass through mode value to Bootp and DHCP.

  13. Set up the relay agents:

    1. Click Add.

    2. In the Relay agent IP address box, type the local LAN IP address.

    3. In the Target server IP address box, type the DHCP server IP address.

    4. Click OK.

    5. Change the Pass through mode value to Bootp and DHCP.

    6. Perform Step 1 to Step 5 again and specify the Proxy DHCP server IP address at Step 3.

    7. Apply the configuration.

Configuring Bay Networks Equipment

Perform the following steps on the switch:

  1. Enable DHCP for the client VLAN using the following command lines:

    # config vlan1 ip
    # dhcp enable
  2. Configure IP helpers to forward DHCP requests from the device subnet to the TFTP server, using the following command lines:

    # config ip dhcp-relay
    # create 10.0.0.1 10.1.1.2 mode dhcp state enable
    # create 10.0.0.1 196.10.229.2 mode dhcp state enable

    The create command has the form create agent server mode dhcp state enable, where agent is the IP address of the gateway that serves the PXE device, and server is the IP address of the server that the DHCP frame should be forwarded to.

  3. Save the configuration.

Configuring Filters on Switches and Routers

Some network devices filter network traffic that passes through them. Preboot Services makes use of several different types of traffic, and all of these must be able to successfully pass through the router or switch for the Preboot Services session to be successful. The Preboot Services session uses the following destination ports:

Table 2-5 Destination Ports for Preboot Services

Component

Port

DHCP and Proxy DHCP servers

UDP Ports 67, 68, and 4011

TFTP server

UDP Port 69

novell-zmgprebootpolicy

UDP Port 13331

IMPORTANT:If the switch is acting as a firewall and limiting the type of traffic on the network, understand that novell-tftp and novell-zmgprebootpolicy are not firewall or network filter friendly. You should not attempt to run these services or daemons through a firewall. If users need to pass preboot work through a firewall, then all Preboot Services work needs to be on the outside and merely reference a Web service inside the firewall.

Spanning Tree Protocol in Switched Environments

The spanning tree protocol (STP) is available on certain switches and is designed to detect loops in the network. When a device (typically a network hub or a device) is patched into a port on the switch, the switch indicates to the device that the link is active, but instead of forwarding frames from the port to the rest of the network, the switch checks each frame for loops and then drops it. The switch can remain in this listening state from 15 to 45 seconds.

The effect of this is to cause the DHCP requests issued by PXE to be dropped by the switch, causing the Preboot Services session to fail.

It is normally possible to see that the STP is in progress by looking at the link light on the switch. When the device is off, the link light on the switch is obviously off. When the device is turned on, the link light changes to amber, and after a period of time changes to a normal green indicator. As long as the link light is amber, STP is in progress.

This problem only affects PXE devices that are patched directly into an Ethernet switch. To correct this problem, perform one of the following:

  • Turn off STP on the switch entirely.

  • Set STP to Port Fast for every port on the network switch where a PXE device is attached.

After the problem is resolved, the link light on the port should change to green almost immediately after a device connected to that port is turned on.

Information about STP and its influence on DHCP can be found at Using PortFast and Other Commands to Fix End-Station Startup Connectivity Problems.

2.4.3 Administering Preboot Services

This section includes information about administering and configuring Preboot Services:

Configuring Preboot Services Imaging Servers

In Preboot Services, the services or daemons do not use switches. Instead, to configure a service or daemon to do something that is not a default, you need to edit the configuration files.

You can edit configuration files while the service or daemon is running, because they are only read when the service or daemon starts. After editing the file you must restart the service or daemon for the changes to take effect.

For more information on the service or daemon configuration files, see Section D.10, Imaging Server.

NOTE:To start or stop the following imaging services on SLES12 OS onwards, use the systemctl command.

  • novell-pbserv

  • novell-proxydhcp

  • novell-tftp

  • novell-zislnx

  • novell-zmgprebootpolicy

Syntax: systemctl reload|restart|start|status|stop|... <my_service(s)>.service

Example: systemctl reload|restart|start|status|stop novell-proxydhcp.service

The following sections explain how to configure the following ZENworks Imaging Servers:

Configuring the TFTP Server

It is seldom necessary to change the default TFTP server configuration values. If you need to change them, use the following procedure:

  1. Open the following file in an editor:

    Windows: %ZENWORKS_HOME%\conf\preboot\novell-tftp.conf

    Linux: /etc/opt/novell/novell-tftp.conf

  2. Edit the configuration settings according to the instructions within the file.

  3. Save the changes.

  4. On a command line, enter the following:

    Windows: In the Services dialog box, right-click Novell TFTP Service, then select Restart.

    Linux: /etc/init.d/novell-tftp restart

Configuring the Proxy DHCP Server

The Proxy DHCP server provides PXE devices with the information that they require to be able to connect to the Preboot Services system.

Use the following steps to modify the settings of novell-proxydhcp:

  1. Open the following file in an editor:

    Windows: %ZENWORKS_HOME%\conf\preboot\novell-proxydhcp.conf

    Linux: /etc/opt/novell/novell-proxydhcp.conf

  2. Edit the configuration settings according to the instructions within the file.

  3. Save the changes.

  4. On a command line, enter the following:

    Windows: In the Services dialog box, right-click Novell Proxy DHCP Service, then select Restart.

    Linux: /etc/init.d/novell-proxydhcp restart

You can set any of the IP address fields to 0.0.0.0 in the configuration utility. The server replaces these entries with the IP address of the first network adapter installed in the server.

Configuring Novell-pbserv

Novell-pbserv provides imaging services to the devices.

Use the following steps to modify the settings of novell-pbserv:

  1. Open the following file in an editor:

    Windows: %ZENWORKS_HOME%\conf\preboot\novell-pbserv.conf

    Linux: /etc/opt/novell/zenworks/preboot/novell-pbserv.conf

  2. Edit the configuration settings according to the instructions within the file.

  3. Save the changes.

  4. On a command line, enter the following:

    Windows: In the Services dialog box, right-click Novell ZENworks Preboot Service, then select Restart.

    Linux: /etc/init.d/novell-pbserv restart

Configuring Novell-zmgprebootpolicy

Novell-zmgprebootpolicy is used to check if there are any imaging actions that need to be performed on the device. It forwards requests to novell-pbserv on behalf of PXE devices.

Use the following steps to modify the settings of novell-zmgprebootpolicy:

  1. Open the following file in an editor:

    Windows: %ZENWORKS_HOME%\conf\preboot\novell-zmgprebootpolicy.conf

    Linux: /etc/opt/novell/zenworks/preboot/novell-zmgprebootpolicy.conf

  2. Edit the configuration settings according to the instructions within the file.

  3. Save the changes.

  4. On a command line, enter the following:

    Windows: In the Services dialog box, right-click Novell ZENworks Preboot Policy Service, then select Restart.

    Linux: /etc/init.d/novell-zmgprebootpolicy restart

Configuring the DHCP Server

The DHCP server needs to have option 60 (decimal) added to the DHCP tags if the Proxy DHCP and DHCP servers are running on the same physical server. This option should be a string type and must contain the letters PXEClient.

For more information, see Configuring LAN Environments for Preboot Services.

Configuring IP Port Usage

This section describes the network ports used by Preboot Services. Using the information in this section, you can configure routers to correctly forward the network traffic generated by Preboot Services. For further information about configuring routers, see Section 2.4.2, Deploying Preboot Services in a Network Environment.

Preboot Services uses both well-known and proprietary IP ports.

The well-known IP ports include:

  • 67 Decimal: The Proxy DHCP server listens on this port for PXE information requests. This is the same port used by a standard DHCP server.

  • 68 Decimal: The DHCP/Proxy DHCP server responds to client requests on this port. This is the same port used by a standard DHCP server.

  • 69 Decimal: The TFTP server listens on this port for file requests from PXE devices.

  • 4011 Decimal: When running on the same server as the DHCP service or daemon, the Proxy DHCP server listens on this port for PXE information requests.

The proprietary IP ports include:

  • 998 Decimal: Novell-pbserv client connection port. It receives all connection requests from the Preboot Services devices on this port.

  • 13331 Decimal: Novell-zmgprebootpolicy client connection port. It receives all connection requests from the PXE devices on this port.

Although PXE devices make their initial requests to novell-tftp and novell-zmgprebootpolicy on the ports listed above, the remainder of the transactions can occur on any available port. For this reason, Imaging Servers cannot be separated from their clients by a firewall.

IMPORTANT:Novell-tftp and novell-zmgprebootpolicy are not firewall or network filter friendly. You should not attempt to run these services or daemons through a firewall. If users need to pass preboot work through a firewall, then all Preboot Services work needs to be on the outside and merely reference a Web service inside the firewall.

2.4.4 Editing the Novell Preboot Services Menu

Depending on the configuration settings for Preboot Services in ZENworks Control Center, PXE devices might be able to display the Novell Preboot Services Menu during the boot process. The menu has the following options:

  • Start ZENworks Imaging

  • Start ZENworks Imaging Maintenance

  • Disable ZENworks Partition

  • Enable ZENworks Partition

  • Exit

For information on configuring how the menu used, see Section 2.5.1, Configuring Novell Preboot Services Menu Options.

There might be circumstances when you want to modify the options on the Novell Preboot Services Menu. You can customize these options by editing a text file contained on the Imaging Server. For example, you can:

  • Add, delete, and modify menu options

  • Add submenu items

  • Change the color scheme

  • Change the menu title and screen name

The following procedures should be done on each Imaging Server where you want to customize the menu.

Editing the Menu

To edit the menu perform the following:

  1. In a text editor, open the following file on an Imaging Server where the ZENworks Proxy DHCP server (novell-proxydhcp) is running:

    For BIOS:

    • Windows: %ZENWORKS_HOME%\share\tftp\pxemenu.txt

    • Linux: /srv/tftp/pxemenu.txt

    For UEFI:

    • Windows: %ZENWORKS_HOME%\srv\tftp\efi\x86_64\pxemenu.txt

    • Linux: /srv/tftp/efi/x86_64/pxemenu.txt

    IMPORTANT:If you want to save the default options for this menu, we recommend that you make a backup copy of pxemenu.txt, such as pxemenu_orig.txt.

    For example:

    The following is the content of the default menu’s pxemenu.txt file:

    #This file describes a PXEMenu
    
    ScreenName = Novell Preboot Services Menu
    ScreenInfo = Version 2.0 July, 2007
    MenuTitle = ZENworks Preboot Options
    
    FormatVersion = 2
    
    #The screen colors determine the color of the main part of the menu screen
    ScreenColor = bright_white
    ScreenBackgroundColor = blue
    
    #The info colors determine the color of the screen information at the top
    #of the menu screen
    InfoColor = yellow
    InfoBackgroundColor = blue
    
    #The hint colors determine the color of the hint line at the bottom of the screen
    HintColor = lt_cyan
    HintBackgroundColor = blue
    
    #The menu colors determine the color of the menu box and menu title
    MenuColor = yellow
    MenuBackgroundColor = blue
    
    #The option colors determine the color of the menu option
    OptionColor = BRIGHT_WHITE
    OptionBackgroundColor = BLUE
    
    #The chosen colors determine the color of the high-lighted option
    ChosenColor = BRIGHT_WHITE
    ChosenBackgroundColor = RED
    
    #The 'forced option' is the option that will be automatically
    #executed without presenting a menu to the user. It MUST be an
    #option on the first ('Main' by default) menu. The following
    #example will force 'Start ZENworks Imaging Maintenance'
    #ForceOption=2
    
    StartMenu = Main
    
    #Note:  The original version of the pxemenu.txt file does not
    #       require submenus, but example syntax is provided in
    #       comments for demonstration purposes.
    
    [Main]
    MenuTitle = ZENworks Preboot Options
    option = execute ; "Start ZENworks Imaging" ; "ZENworks Imaging
             in Automated Mode" ; pxelinux.0 ; z_auto.cfg
    option = execute ; "Start ZENworks Imaging Maintenance" ;
             "ZENworks Imaging Linux Session in Interactive Mode" ;
             pxelinux.0 ; z_maint.cfg
    option = execute ; "Disable ZENworks Partition" ; "Disable
             Existing ZENworks partition" ;pxelinux.0 ; z_zpdis.cfg
    option = execute ; "Enable ZENworks Partition" ; "Re-enable
             Existing ZENworks partition" ;pxelinux.0 ; z_zpen.cfg
    #option = submenu ; "Sub Menu Options >>" ; "Submenu example with
             more options" ; SUBMenu
    option = exit ; "Exit" ; "Boot to local hard drive"
    
    #[SUBMenu]
    #MenuTitle = Sub Menu Options
    #option = execute ; "Sub Menu #1" ; "Description for sub menu #1" ;
    #        pxelinux.0 ; submenu1.cfg
    #option = execute ; "Sub Menu #2" ; "Description for sub menu #2" ;
    #        pxelinux.0 ; submenu2.cfg
    #option = return ; "Return" ; "Return to main menu"
    #option = exit ; "Exit" ; "Boot to local hard drive"
  2. To change the appearance of the menu, edit the first seven sections (title and colors).

    To change colors, the settings you enter must be selected from the following:

    BLACK

    RED

    GRAY

    LT_GREEN

    BLUE

    MAGENTA

    YELLOW

    LT_CYAN

    GREEN

    BROWN

    BRIGHT_WHITE

    LT_RED

    CYAN

    WHITE

    LT_BLUE

    LT_MAGENTA

  3. To change the menu options, edit the sections under [Main].

    The menu options, their hint descriptions, the pxelinux.0 executable, and configuration file (.cfg) are listed on the option = line.

  4. When you are finished, save the pxemenu.txt file.

Editing the Menu for UEFI

To edit the menu for UEFI:

  1. In a text editor, open the following file on an Imaging Server where the ZENworks Proxy DHCP server (novell-proxydhcp) is running:

    Windows: %ZENWORKS_HOME%\share\tftp\efi\x86_64\pxemenu.txt

    Linux: /srv/tftp/efi/x86_64/pxemenu.txt

    IMPORTANT:To save the default options for this menu, we recommend that you make a backup copy of pxemenu.txt.

    The following is the content available in the pxemenu.txt file of the default menu:

    #This file describes a PXEMenu
    
    ScreenName  = Novell Preboot Services Menu
    ScreenInfo  = Version 1.0  Dec, 2012
    MenuTitle = ZENworks Preboot Options
    
    FormatVersion = 2
    
    MainOptionCount = 10
    
    SubOptionCount = 5
    
    #The screen colors determine the color of the main part of the menu screen
    ScreenColor  = bright_white
    ScreenBackgroundColor = blue
    
    #The info colors determine the color of the screen information at the top of
    #the menu screen
    InfoColor = yellow
    InfoBackgroundColor = blue
    
    #The hint colors determine the color of the hint line at the bottom of the screen
    HintColor = lt_cyan
    HintBackgroundColor = blue
    
    #The menu colors determine the color of the menu box and menu title
    MenuColor = yellow
    MenuBackgroundColor = blue
    
    #The option colors determine the color of the menu option
    OptionColor = BRIGHT_WHITE
    OptionBackgroundColor = BLUE
    
    #The chosen colors determine the color of the high-lighted option
    ChosenColor = BRIGHT_WHITE
    ChosenBackgroundColor = RED
    
    #The 'forced option' is the option that will be automatically executed without presenting
    #a menu to the user.  It MUST be an option on the first ('Main' by default) menu
    #The following example will force 'Start ZENworks Imaging Maintenance'
    #ForceOption=2
    
    StartMenu = Main 
    
    #Note:  The original version of the pxemenu.txt file does not require submenus, but example
    #       syntax is provided in comments for demonstration purposes.
    
    [Main]
    MenuTitle = ZENworks Preboot Options
    option = "execute;Start ZENworks Imaging;ZENworks Imaging in Automated Mode;efi/x86_64/bootx64.efi;efi/x86_64/z_auto.conf"
    option = "execute;Start ZENworks Imaging Maintenance;ZENworks Imaging Linux Session in Interactive Mode;efi/x86_64/bootx64.efi;efi/x86_64/z_maint.conf"
    option = "execute;Disable ZENworks Partition;Disable Existing ZENworks partition;efi/x86_64/bootx64.efi;efi/x86_64/z_zpdis.conf"
    option = "execute;Enable ZENworks Partition;Re-enable Existing ZENworks partition;efi/x86_64/bootx64.efi;efi/x86_64/z_zpen.conf"
    #option = "submenu;Sub Menu Options >>;Submenu example with more options1;SUBMenu"
    option = "exit;Exit;Boot to local hard drive"
    
    
    #[SUBMenu]
    #MenuTitle = Sub Menu Options
    #option = "execute;Sub Menu 1;Description for sub menu 1;efi/x86_64/bootx64.efi;efi/x86_64/submenu1.conf"
    #option = "execute;Sub Menu 2;Description for sub menu 2;efi/x86_64/bootx64.efi;efi/x86_64/submenu2.conf"
    #option = "return;Return;Return to main menu"
    #option = "exit;Exit;Boot to local hard drive"
  2. To change the appearance of the menu, edit the first seven sections (title and colors).

    To change colors, select the related settings from the following:

    BLACK

    RED

    GRAY

    LT_GREEN

    BLUE

    MAGENTA

    YELLOW

    LT_CYAN

    GREEN

    BROWN

    BRIGHT_WHITE

    LT_RED

    CYAN

    WHITE

    LT_BLUE

    LT_MAGENTA

  3. To change the menu options, edit the sections under [Main].

    The menu options, their hint descriptions, the bootx64.efi executable, and configuration file (.conf) are listed on the option = line.

    Example 2-1 Example:

    option = "execute;Start ZENworks Imaging;ZENworks Imaging in Automated Mode;efi/x86_64/bootx64.efi;efi/x86_64/z_auto.conf"

    In the example listed above:

    • Start ZENworks Imaging is the menu entry.

    • ZENworks Imaging in Automated Mode stands for description of the menu entry.

    • efi/x86_64/bootx64.efi is the executable binary.

    • efi/x86_64/z_auto.conf is the configuration file.

      NOTE:The recommended maximum characters:

      • Menu entry: 35

      • Description of the menu entry: 77

  4. When you are finished, save the pxemenu.txt file.