PXE Everywhere Agent settings
Installer and configuration settings for the PXE Everywhere Agent client module of the 1E Client supported only on Windows computers.
1E Client is available as 32-bit and 64-bit versions, and the correct version must be installed. This means the PXE Everywhere Agent registry location is the same for x86 and x64:
HKEY_LOCAL_MACHINE\SOFTWARE\1E\PXEEverywhere
Note
Registry settings:
AlwaysBootImageId | AlwaysIsMandatory | BindTo | CommsPort | ConfigServerAddress | Debug | DefaultBlockSize | DhcpPort | ElectionWaitSecs | ElectionWeight | EncryptionType | Flags | IgnoreGatewayAddress | IgnoreWireless | LogFileName | LogFormat | MaxBlockSize | MaxLogFilesize | Mode | ReserveSecs | SessionTimeoutSecs | TftpRoot
Note
Installer properties:
Module.PXEEverywhere.Enabled | MODULE.PXEEVERYWHERE.COMMSPORT | MODULE.PXEEVERYWHERE.CONFIGSERVERURL | MODULE.PXEEVERYWHERE.DEBUG | MODULE.PXEEVERYWHERE.DHCPPORT | MODULE.PXEEVERYWHERE.ELECTIONWAITSECS | MODULE.PXEEVERYWHERE.ELECTIONWEIGHT | MODULE.PXEEVERYWHERE.USEFIPS | MODULE.PXEEVERYWHERE.LOGPATH | MODULE.PXEEVERYWHERE.LOGFORMAT | MODULE.PXEEVERYWHERE.MAXLOGFILESIZE | MODULE.PXEEVERYWHERE.MODE | MODULE.PXEEVERYWHERE.RESERVESECS | MODULE.PXEEVERYWHERE.TFTPROOT
1E Client installers include a template configuration file that contains the more important settings with default values that match hard-coded default values. The configuration file is updated during installation and named 1E.Client.conf in the installation folder along with the 1E Client executable.
After installation, configuration file settings can be managed using 1E Client command-line parameters, Endpoint Troubleshooting configuration instructions, Endpoint Automation policies, Configuration Manager baselines or other means. Registry settings can also be managed by Windows Group Policy.
PXE Everywhere Agent installation settings
This table lists the configuration settings visible in the PXE Everywhere screen during an interactive installation of the 1E Client. Other installer properties are available when using a command-line installation or a transform.
Note
You must use UPPERCASE when specifying the name of any installer property in a mst transform file, and preferably when including them in a msiexec command-line.
Names of settings stored in the configuration file are not case-sensitive. Setting names stored in the registry may be case-sensitive and should be specified as shown.
Settings that have numeric values must be set using decimal integers, unless otherwise specified.
Installer property | Mandatory | Default value | Description |
|---|---|---|---|
No | false | Set this property to true to enable the PXE Everywhere Agent client module. The default value is false. NoteIf enabled, when the 1E Client starts it will attempt to automatically remove any previous installations of PXE Everywhere Agent. This setting does not have an associated registry entry and is stored in the 1E Client configuration file. | |
MODULE.PXEEVERYWHERE.CONFIGSERVERURL | Yes | http://SERVER/PXELite/PXELiteConfiguration.asmx | URL for the PXE Everywhere Central web service in the format: where NoteThe http prefix to the URL is case-sensitive and must be entered in all lower case letters. The URL is not verified by the installer, so you will need to ensure that the correct URL is entered. This setting has an associated ConfigServerAddress registry value. |
MODULE.PXEEVERYWHERE.USEFIPS | No | 0 | You must use the same FIPS encryption setting on all PXE Everywhere Agents. Use of FIPS compliant encryption for communications.
This setting has an associated EncryptionType registry value. |
MODULE.PXEEVERYWHERE.DHCPPORT | No | 67 | This installer property is set to 2067 if Enable DHCP Snooping support is checked during an interactive installation of the 1E Client installer. This is the UDP port on which the PXE Everywhere Agent will listen for PXE requests. If DHCP Snooping is not being used, then this port must be 67 (default), and you do not need to install Responders. When manually installing the PXE Everywhere Agent, if the DHCP Snooping option is enabled in the installer UI, the default port is changed from 67 (43 hex) to 2067 (813 hex). If the MODULE.PXEEVERYWHERE.DHCPPORT installer property is used to specify a port other than 67, the installer UI assumes the DHCP Snooping option is enabled. If DHCP Snooping is being used, then DhcpPort on Agents must be the same value as AltPxeServerPort on Responders. The default value of AltPxeServerPort is 2067. If a value other than 2067 is specified as a custom port number on Agents, you will also need to manually create the AltPxeServerPort (and AltPxeClientPort) registry values on Responders. This setting has an associated DhcpPort registry value. |
PXE Everywhere Agent registry settings
This table lists all registry setting and their associated installer properties.
Note
You must use UPPERCASE when specifying the name of any installer property in a mst transform file, and preferably when including them in a msiexec command-line.
Names of settings stored in the configuration file are not case-sensitive. Setting names stored in the registry may be case-sensitive and should be specified as shown.
Settings that have numeric values must be set using decimal integers, unless otherwise specified.
Registry name | Registry type | Installer property | Mandatory | Default value | Description |
|---|---|---|---|---|---|
REG_SZ | This value does not have an installer property. | No | Registry value is not created. | A string value containing a valid package id of a boot image. If specified, do not get boot image ID from PXE Everywhere Central but use this one instead. | |
REG_DWORD | This value does not have an installer property. | No | Registry value is not created. | Whether the boot image is mandatory (value 1) or not (0). Only relevant in combination with | |
REG_SZ | This value does not have an installer property. | No | Registry value is not created. | Comma-separated list of IP addresses which PXE Everywhere Agent listens for DHCP (PXE) and TFTP requests. If not present, PXE Everywhere Local listens on all IP addresses. Use this if there is more than one network interface. | |
REG_DWORD | No | 2012 | Used for UDP election broadcast messages, this must be opened in the Windows firewall. | ||
REG_SZ | Yes | http://SERVER/PXELite/PXELiteConfiguration.asmx | URL for the PXE Everywhere Central web service in the format: where NoteThe http prefix to the URL is case-sensitive and must be entered in all lower case letters. The URL is not verified by the installer, so you will need to ensure that the correct URL is entered. | ||
REG_DWORD | No | 1 | The debug level. Leave this at
The following two bits will perform centralized logging via SOAP calls to the PXE Central Server:
| ||
REG_DWORD | This value does not have an installer property. | No | Registry value is not created. | Default TFTP block size. 512 if not specified. | |
REG_DWORD | No | 67 | This is the UDP port on which the PXE Everywhere Agent will listen for PXE requests. If DHCP Snooping is not being used, then this port must be 67 (default), and you do not need to install Responders. When manually installing the PXE Everywhere Agent, if the DHCP Snooping option is enabled in the installer UI, the default port is changed from 67 (43 hex) to 2067 (813 hex). If the MODULE.PXEEVERYWHERE.DHCPPORT installer property is used to specify a port other than 67, the installer UI assumes the DHCP Snooping option is enabled. If DHCP Snooping is being used, then DhcpPort on Agents must be the same value as AltPxeServerPort on Responders. The default value of AltPxeServerPort is 2067. If a value other than 2067 is specified as a custom port number on Agents, you will also need to manually create the AltPxeServerPort (and AltPxeClientPort) registry values on Responders. | ||
REG_DWORD | No | 1 | Time (in seconds) to wait for responses to the election request before broadcasting the result. Can be any positive integer value above 0. | ||
REG_DWORD | No | 50 | When set, this manually created registry value determines the likelihood of the machine winning elections, all else being equal. The value must be between 0 and 99 inclusive. The higher the value the the higher the likelihood of winning. If no value is set, a default of 50 is used. | ||
REG_DWORD | No | 0 | You must use the same FIPS encryption setting on all PXE Everywhere Agents.Use of FIPS compliant encryption for communications.
| ||
REG_DWORD | This value does not have an installer property. | No | Registry value is not created. | If set to Any value other than 1 is treated as default 0.acknowledgment | |
REG_DWORD | This value does not have an installer property. | No | Registry value is not created. | If set to any value other than If not set then assumes default | |
REG_DWORD | This value does not have an installer property. | No | 0 | If set to 1 then PXE Everywhere Agent does not bind on wireless adapters. Any value other than 1 is treated as default 0. | |
REG_SZ | NoteThis property only specifies the location of the log file. | No | %ALLUSERSPROFILE%\1E\PXEEverywhere PXEEverywhere.log | The location of the PXE Everywhere log file. The path is created if it does not exist. The logfile name is | |
REG_DWORD | No | 1 | Formatting depends on which bits are set:
| ||
REG_DWORD | NoteThis value does not have an installer property, but is configurable when deployed using 1E Client Deployment Assistant. Please refer to Installing PXE Everywhere Agents: Preparing a Configuration Manager Application for PXE Everywhere Agent using the 1E Client Deployment Assistant. | No | Registry value is not created. | Maximum value for the block size (in bytes). PXE Everywhere uses the system MTU to derive the size of TFTP packets. May require limiting when using VPN tunnels. In most cases, this value should not be altered. Default is 8192 (8 kbytes). NoteThe actual block size used for the TFTP protocol is the lesser value of the tftpBlockSize and the MaxBlockSize registry values. The tftpBlockSize value is specified in the CreateBCD.exe utility command-line, and does not have a registry entry or installer property. | |
REG_DWORD | No | 10485760 | Maximum size for the log file in bytes. Once the file reaches the specified size, a copy is made with a Default is 10485760 (10 MBytes). | ||
REG_DWORD | No | 2 | Mode must be one of the following:
| ||
REG_DWORD | No | 60 | Time (in seconds) an election result remains active. 60 if not specified or 0 is specified. Can be any positive integer value. | ||
REG_DWORD | This value does not have an installer property. | No | Registry value is not created. | Timeout for the TFTP listener. 600 if not specified or 0 is specified. Can be any positive integer value. | |
REG_SZ | No |
| Location for the PXE Everywhere Agent |