Contents

The following table shows the supported NomadBranch registry value and any associated installer properties. Installer properties must be upper-case and those that use numeric values must be set using decimal integers on the command-line.

Registry valueDescription

ActiveEfficiency\PlatformURL

The URL of the ActiveEfficiency web service, usually of the form http://server/ActiveEfficiency or http://server:port/ActiveEfficiency depending on how the ActiveEfficiency Web service is configured. HTTP and HTTPS protocols are supported.

ActiveEfficiency\ContentRegistration

Determines if content in Nomad's cache (packages, applications, software updates, boot images, etc.) is registered with ActiveEfficiency. Content registration is necessary if a host is to be available as a Single-site download (SSD) provider or can be woken up if a Nomad peer requires the content locally.

ActiveEfficiency\ContentProviderOnWifi

 Determines whether a device on a WLAN can become content provider. By default, only devices connected to a LAN can become content providers when using Single Site Download (SSD).

This setting is only applicable to SSD and has no effect on P2P content transfers on the local subnet.


AssumedLinkSpeed is obsolete. Its value may exist in the Nomad registry but it is not used. Instead Nomad now relies on the actual content being downloaded to gauge link speed.

Determines which of the built-in security groups is granted read-only permissions to the Nomad cache.

Value (in bytes) for the minimum size of each block of data Nomad copies from the package source folder.

Determines the number of hours between automatically running the Nomad cache cleaner.

An integer value that sets the delay for receiving Central Multicast. Normally you would not need to set this value.
Defines one or more certificate issuers that Nomad will use to select the appropriate PKI certificate for the:
  • Configuration Manager (CM) client authentication certificate - used when downloading over HTTPS from Distribution Points and when communicating with Management Points during pre-caching
  • Nomad Server Authentication certificate - used to share content between peers over HTTPS
  • Client Authentication certificate - used for certificate-based client authentication when sharing content between peers over HTTPS.

In most cases Nomad will be able to identify a suitable certificate in the Local Computer Personal certificate store without needing to specify CertIssuer (refer to Peer copy over HTTP or HTTPS: Certificate Selection for more details). You should use CertIssuer if the CM client is not using PKI certificates and there are multiple Client Authentication certificates issued by different Certificate Authorities in the store, and if there is a chance some of those certificates may not be trusted by other peers or CM site systems.

Defines one or more certificate subject names that Nomad uses to select the appropriate PKI certificate for authentication with Configuration Manager (CM) site systems configured to use HTTPS. It does not affect certificate selection for client authentication certificates used for peer-to-peer authentication or for selection of server authentication certificates.

In most cases Nomad will be able to identify a suitable certificate in the Local Computer Personal certificate store without the need to specify CertSubject (refer to Peer copy over HTTP or HTTPS: Certificate Selection for more details).

Determines different compatibility settings which relate to specific customer related functionality and should not generally be changed from the default value under normal conditions, unless advised.
The level of messages logged in the Nomad logs for debugging purposes.

The level of messages related to the Dynamic Block Size (DBS) feature logged in the Nomad logs for debugging purposes.

Sets the timeout in seconds after which a job will be cancelled if the download has not been successful.
Determines which error codes will cause Nomad to retry a download using an alternative distribution point.
DpCacheCleanupEnabled

Delete all obsolete LSZ files on the DP where the associated content is no longer present in ContentLib.

ContentProviderOnWifi
Determines whether a device on a WLAN can become content provider. By default, only devices connected to a LAN can become content providers when using Single Site Download (SSD).
This setting is only applicable to SSD and has no effect on P2P content transfers on the local subnet.
Determines the type of encryption used by Nomad to encrypt its communications between Nomad peers.
Determines whether Windows Error Reporting memory dumps should be sent to Microsoft Winqual.
The installation directory for Nomad.
The location of local Nomad package cache.
The path and filename of the Nomad log file.
(Optional setting) If set, defines the maximum possible link speed in bits per second.
The maximum duration (in seconds) that Nomad backs-off between blocks of data.

When the Nomad cache cleaner runs, delete any application or package content that last triggered Nomad elections before the specified number of days ago.

Provided for backward compatibility only – use PercentAvailableDisk instead. The value (in bytes) for the maximum size the cache is allowed to grow to, before automatic cache cleaning takes place.
The maximum number of devices with the content that Nomad can retrieve from ActiveEfficiency server in one call.
MaxElectionResponseLogging

Defines the number of election responses Nomad will write to the log for a given election.

The maximum size (in bytes) of the Nomad log file. Default is 5MB.
The maximum size (in bytes) of a package that Nomad attempts to cache on a Fast LAN (>500 kbps) connection.
The maximum size (in bytes) of a package that Nomad will attempt to cache on a RAS (<55 kbps) connection.
Maximum size (in bytes) of a package that Nomad attempts to cache on a Slow LAN (55-500 kbps) connection.
The maximum rate at which multicast packets are sent.

When the Nomad cache cleaner runs, delete any pre-cached content that last triggered Nomad elections before the specified number of days ago.

he minimum interval (in seconds) between sending transfer progress status messages, thereby governing the overall maximum frequency for sending the messages.

Registry value to hold an integer determining the number of times Nomad attempts to copy content and gets stuck before aborting.

When the Nomad cache cleaner runs, delete any software updates that last triggered Nomad elections before the specified number of days ago.

MaxWorkRates is a registry key, that must be created, to hold registry values for each day of the week (Day0 to Day6) where the hourly maximums for the variable work rates are set.
The MADCAP scope for multicast.
The behavior of local multicast.
NMDS\CachePath
This value holds the location of the base peer backup assistant (PBS) share where user data is copied to.
Determines whether Windows Disk Quotas (if configured) are enforced on the PBA share defined in CachePath .

Time by which PBA peer reply window should be extended to avoid network spikes.

The time-out period in minutes for the Peer Backup Assistant - High Availability (PBA-HA) task sequence action. If a machine running this action does not receive an acknowledgement message within this period from the PBA host performing the additional backups, the action will fail.
Sets the maximum amount of space in MB that can be requested by each PBA client.
Sets the maximum number of concurrent PBA sessions that may be in use on the host.
The maximum amount of space (in MB) that can be used for all the PBA shares combined on the host.
The duration (in hours) after which the PBA share is deleted from the host.

The duration (in hours) after which PBA share is deleted from the host.

Determines whether hard links are used between the Nomad cache and the Configuration Manager cache.
Prevents Nomad from calling an election when it is connected to the specified AD sites, meaning that each Nomad client on the listed AD sites will automatically become a Nomad master. This prevents P2P sharing as each master downloads its own copy of the content.
Prevents Nomad from calling an election when it is connected to specified IP subnet, meaning that each Nomad client on the IP subnet automatically becomes a Nomad master. This prevents P2P sharing as each master downloads its own copy of the content.
Prevents Nomad from using specific network adaptors based on the IP subnet. For example, this can be used to exclude Server backup subnets.
P2PClientCertWaitPeriodMins

Defines the number of minutes that Nomad waits from the start time of the download job for a valid client authentication certificate before failing the download job.

Defines the max number of devices which a device will disqualify during a peer-to-peer copy.

Defines the max number of minutes within which a device will disqualify a peer during a peer-to-peer copy.

Determines the outcome of Nomad elections.
Determines how the Nomad cache is accessed. See Peer access to the Nomad cache for more details.
The HTTP port to use for peer copy.
The HTTPS port to use for peer copy.
Port used to broadcast election messages, for connectionless cache access and package status broadcasts.
P2PSslSettings
Defines server and client authentication options when using HTTPS for P2P content transfer (i.e. P2PEnabled 0x60 option is set).
The limit on the Nomad cache. Specified as a percentage of the available disk space, it controls the automatic cache cleaning to ensure that the cache does not grow to a size whereby the percentage of available disk space is less than this value.
Restricts Nomad LSZ file generation requests to a list of permitted package source locations.
The number of notifications a client processes in one pre-cache poll cycle.
The interval (in minutes) between Nomad polling ActiveEfficiency for new pre-cache jobs.
The delay (in seconds) before restarting retries from the first DP after the whole list of available DPs have been tried.
Determines where the download package is run from under certain conditions.
The path to the Configuration Manager signature files.
Sets various special feature options related to the Nomad share.
Enables Single-Site Download (SSD).
Enables the use of single-site functionality for PBA data stores. See single-site peer backup assistant for more details.
Determines which Nomad events are reported using Configuration Manager status messages.
A list of Nomad return codes that are translated as success to the Content Transfer Manager (CTM) component of the Configuration Manager client.
The maximum number of machines to wake up in a single call.
Enables WakeUp integration, see Integrating with WakeUp for more details.
The minimum size of content (in megabytes) that will cause a request for a wakeup. See Integrating with WakeUp for more details.
The duration for temporarily disabling a wireless connection when a wired LAN connection becomes available, to provide time for the OS and Nomad to switch to the LAN connection. This is useful for OS versions and drivers that do not automatically switch to a preferred wired connection.
A list of wireless SSIDs to enable switching from wireless to wired LAN connections.

AssumedLinkSpeed

AssumedLinkSpeed is obsolete. Its value may exist in the Nomad registry but it is not used. Instead Nomad now relies on the actual content being downloaded to gauge link speed.

AuthenticatedUsers

Determines which of the built-in security groups is granted read-only permissions to the Nomad cache.

BlockSize

Value (in bytes) for the minimum size of each block of data Nomad copies from the package source folder.

CacheCleanCycleHrs

Determines the number of hours between automatically running the Nomad cache cleaner.

CachePath

This value holds the location of the base peer backup assistant (PBS) share where user data is copied to.

CentralMCastExtraDelayMins

An integer value that sets the delay for receiving Central Multicast. Normally you would not need to set this value.

CertIssuer

Defines one or more certificate issuers that Nomad will use to select the appropriate PKI certificate for the:

  • Configuration Manager (CM) client authentication certificate - used when downloading over HTTPS from Distribution Points and when communicating with Management Points during pre-caching
  • Nomad Server Authentication certificate - used to share content between peers over HTTPS
  • Client Authentication certificate - used for certificate-based client authentication when sharing content between peers over HTTPS.

In most cases Nomad will be able to identify a suitable certificate in the Local Computer Personal certificate store without needing to specify CertIssuer (refer to Peer copy over HTTP or HTTPS: Certificate Selection for more details). You should use CertIssuer if the CM client is not using PKI certificates and there are multiple Client Authentication certificates issued by different Certificate Authorities in the store, and if there is a chance some of those certificates may not be trusted by other peers or CM site systems.

CertSubject

Defines one or more certificate subject names that Nomad uses to select the appropriate PKI certificate for authentication with Configuration Manager (CM) site systems configured to use HTTPS. It does not affect certificate selection for client authentication certificates used for peer-to-peer authentication or for selection of server authentication certificates.

In most cases Nomad will be able to identify a suitable certificate in the Local Computer Personal certificate store without the need to specify CertSubject (refer to Peer copy over HTTP or HTTPS: Certificate Selection for more details).

CompatibilityFlags

Determines different compatibility settings which relate to specific customer related functionality and should not generally be changed from the default value under normal conditions, unless advised.

ContentProviderOnWifi

Determines whether a device on a WLAN can become content provider. By default, only devices connected to a LAN can become content providers when using Single Site Download (SSD).

This setting is only applicable to SSD and has no effect on P2P content transfers on the local subnet.

ContentRegistration

Determines if content in Nomad's cache (packages, applications, software updates, boot images, etc.) is registered with ActiveEfficiency. Content registration is necessary if a host is to be available as a Single-site download (SSD) provider or can be woken up if a Nomad peer requires the content locally.

ContentRegSyncBatchSz

Number of content registrations that will be attempted in each content registration cycle. Registrations can fail when ActiveEfficiency or the SQL Server hosting ActiveEfficiency DB is busy, overloaded or down for maintenance, resulting in content registration mismatch between the clients and ActiveEfficiency.

ContentRegSyncCycleHrs

Value (in hours) for Nomad to register pending and failed content registrations with ActiveEfficiency. Registrations can fail when ActiveEfficiency or the SQL Server hosting ActiveEfficiency DB is busy, overloaded or down for maintenance, resulting in content registration mismatch between the clients and ActiveEfficiency.

ContentRegSyncReqDelay

Delay (in milliseconds) between successive content registration API calls to ActiveEfficiency. Registrations can fail when ActiveEfficiency or the SQL Server hosting ActiveEfficiency DB is busy, overloaded or down for maintenance, resulting in content registration mismatch between the clients and ActiveEfficiency.

Debug

The level of messages logged in the Nomad logs for debugging purposes.

DebugDynamicBlock

The level of messages related to the Dynamic Block Size (DBS) feature logged in the Nomad logs for debugging purposes.

DownloadTimeout

Sets the timeout in seconds after which a job will be cancelled if the download has not been successful.

DpCacheCleanupEnabled

Delete all obsolete LSZ files on the DP where the associated content is no longer present in ContentLib.

DPNotAvailableCodes

Determines which error codes will cause Nomad to retry a download using an alternative distribution point.

EncryptionType

Determines the type of encryption used by Nomad to encrypt its communications between Nomad peers.

EnforceQuotas

Determines whether Windows Disk Quotas (if configured) are enforced on the PBA share defined in CachePath .

ExtraReplyDelayMs

Time by which PBA peer reply window should be extended to avoid network spikes.

GenerateWEREvents

Determines whether Windows Error Reporting memory dumps should be sent to Microsoft Winqual.

HAACKTimeoutMins

The time-out period in minutes for the Peer Backup Assistant - High Availability (PBA-HA) task sequence action. If a machine running this action does not receive an acknowledgement message within this period from the PBA host performing the additional backups, the action will fail.

InstallationDirectory

The installation directory for Nomad.

KnownMobileDevices

Mobile device connections known to Nomad. When a device running the Nomad client uses a mobile connection whose identifier appears on this list, it will only receive packages that have the --mobok command-line switch set.

LocalCachePath

The location of local Nomad package cache.

LocalSsdStagger

Sets the site SSD query stagger duration (seconds).

LogFileName

The path and filename of the Nomad log file.

MaxAllocRequest

Sets the maximum amount of space in MB that can be requested by each PBA client.

MaxAllowedLinkSpeed

(Optional setting) If set, defines the maximum possible link speed in bits per second.

MaxBusyBackOffSecs

The maximum duration (in seconds) that Nomad backs-off between blocks of data.

MaxCacheDays

When the Nomad cache cleaner runs, delete any application or package content that last triggered Nomad elections before the specified number of days ago.

MaxCacheSizeMB

Provided for backward compatibility only – use PercentAvailableDisk instead. The value (in bytes) for the maximum size the cache is allowed to grow to, before automatic cache cleaning takes place.

MaxConcurrency

Sets the maximum number of concurrent PBA sessions that may be in use on the host.

MaxDevicesFromAE

The maximum number of devices with the content that Nomad can retrieve from ActiveEfficiency server in one call.

MaxElectionResponseLogging

Defines the number of election responses Nomad will write to the log for a given election.

MaximumMegaByte

The maximum amount of space (in MB) that can be used for all the PBA shares combined on the host.

MaxLogFileSize

The maximum size (in bytes) of the Nomad log file. Default is 5MB.

MaxPackageSizeFastLAN

The maximum size (in bytes) of a package that Nomad attempts to cache on a Fast LAN (>500 kbps) connection.

MaxPackageSizeRAS

The maximum size (in bytes) of a package that Nomad will attempt to cache on a RAS (<55 kbps) connection.

MaxPackageSizeSlowLAN

Maximum size (in bytes) of a package that Nomad attempts to cache on a Slow LAN (55-500 kbps) connection.

MaxPacketsPerSecond

The maximum rate at which multicast packets are sent.

MaxPreCacheDays

When the Nomad cache cleaner runs, delete any pre-cached content that last triggered Nomad elections before the specified number of days ago.

MaxStatusFrequency

he minimum interval (in seconds) between sending transfer progress status messages, thereby governing the overall maximum frequency for sending the messages.

MaxStuckCount

Registry value to hold an integer determining the number of times Nomad attempts to copy content and gets stuck before aborting.

MaxSUCacheDays

When the Nomad cache cleaner runs, delete any software updates that last triggered Nomad elections before the specified number of days ago.

MaxWorkRates

MaxWorkRates is a registry key, that must be created, to hold registry values for each day of the week (Day0 to Day6) where the hourly maximums for the variable work rates are set.

MultiCastMADCAPScope

The MADCAP scope for multicast.

MulticastSupport

The behavior of local multicast.

NoHardlink

Determines whether hard links are used between the Nomad cache and the Configuration Manager cache.

NomadInhibitedADSites

Prevents Nomad from calling an election when it is connected to the specified AD sites, meaning that each Nomad client on the listed AD sites will automatically become a Nomad master. This prevents P2P sharing as each master downloads its own copy of the content.

NomadInhibitedSubnets

Prevents Nomad from calling an election when it is connected to specified IP subnet, meaning that each Nomad client on the IP subnet automatically becomes a Nomad master. This prevents P2P sharing as each master downloads its own copy of the content.

NomadNeverUseSubnets

Prevents Nomad from using specific network adaptors based on the IP subnet. For example, this can be used to exclude Server backup subnets.

NoSsdReqOnInhibitedSubnets

Determines whether local and site SSD requests are disabled from elected masters located in NomadInhibitedSubnet.

P2P_Port

Port used to broadcast election messages, for connectionless cache access and package status broadcasts.

P2PClientCertWaitPeriodMins

Defines the number of minutes that Nomad waits from the start time of the download job for a valid client authentication certificate before failing the download job.

P2PDisqualifyMaxNumPeers

Defines the max number of devices which a device will disqualify during a peer-to-peer copy.

P2PDisqualifyMaxWindowMins

Defines the max number of minutes within which a device will disqualify a peer during a peer-to-peer copy.

P2PElectionWeight

Determines the outcome of Nomad elections.

P2PEnabled

Determines how the Nomad cache is accessed. See Peer access to the Nomad cache for more details.

P2PHttpPort

The HTTP port to use for peer copy.

P2PHttpsPort

The HTTPS port to use for peer copy.

P2PSslSettings

Defines server and client authentication options when using HTTPS for P2P content transfer (i.e. P2PEnabled 0x60 option is set).

PercentAvailableDisk

The limit on the Nomad cache. Specified as a percentage of the available disk space, it controls the automatic cache cleaning to ensure that the cache does not grow to a size whereby the percentage of available disk space is less than this value.

PercentDelayedContentReg

Delay the content registration request made to ActiveEfficiency by the Content Registration Sync Cycle process that runs every ContentRegSyncCycleHrs.

PermittedLSZShares

Restricts Nomad LSZ file generation requests to a list of permitted package source locations.

PlatformURL

The URL of the ActiveEfficiency web service, usually of the form http://server/ActiveEfficiency or http://server:port/ActiveEfficiency depending on how the ActiveEfficiency Web service is configured. HTTP and HTTPS protocols are supported.

PostCompleteTimeoutHours

The duration (in hours) after which the PBA share is deleted from the host.

PrecachePollBatchSize

The number of notifications a client processes in one pre-cache poll cycle.

PrecachePollMinutes

The interval (in minutes) between Nomad polling ActiveEfficiency for new pre-cache jobs.

PreCompleteTimeoutHours

The duration (in hours) after which PBA share is deleted from the host.

RecycleDPDelay

The delay (in seconds) before restarting retries from the first DP after the whole list of available DPs have been tried.

RunUncachedPermittedFastLAN

Determines where the download package is run from under certain conditions.

SigsFolder

The path to the Configuration Manager signature files.

SiteSsdStagger

Sets the site SSD query stagger duration (seconds).

SpecialNetShare

Sets various special feature options related to the Nomad share.

SSDEnabled

Enables Single-Site Download (SSD).

SSPBAEnabled

Enables the use of single-site functionality for PBA data stores. See single-site peer backup assistant for more details.

StatusMsgEvents

Determines which Nomad events are reported using Configuration Manager status messages.

SuccessCodes

A list of Nomad return codes that are translated as success to the Content Transfer Manager (CTM) component of the Configuration Manager client.

WakeUpBatchSize

The maximum number of machines to wake up in a single call.

WakeUpEnabled

Enables WakeUp integration, see Integrating with WakeUp for more details.

WakeUpMinPackageSizeMB

The minimum size of content (in megabytes) that will cause a request for a wakeup. See Integrating with WakeUp for more details.

WLanBlipSecs

The duration for temporarily disabling a wireless connection when a wired LAN connection becomes available, to provide time for the OS and Nomad to switch to the LAN connection. This is useful for OS versions and drivers that do not automatically switch to a preferred wired connection.

WLanProfileList

A list of wireless SSIDs to enable switching from wireless to wired LAN connections.