Contents
-
Introducing Nomad 7.0.200
-
Implementing Nomad
-
Working with Nomad
-
Troubleshooting
-
Training
-
Reference
-
Supported Platforms
-
Server sizing
-
Communication ports
-
Nomad installer properties
-
Nomad registry values
-
Alphabetic NomadBranch registry values
-
AssumedLinkSpeed
-
AuthenticatedUsers
-
BlockSize
-
CacheCleanCycleHrs
-
CachePath
-
CentralMCastExtraDelayMins
-
CertIssuer
-
CertSubject
-
CompatibilityFlags
-
ContentProviderOnWifi
-
ContentRegistration
-
ContentRegSyncBatchSz
-
ContentRegSyncCycleHrs
-
ContentRegSyncReqDelay
-
Debug
-
DebugDynamicBlock
-
DownloadTimeout
-
DpCacheCleanupEnabled
-
DPNotAvailableCodes
-
EncryptionType
-
EnforceQuotas
-
ExtraReplyDelayMs
-
GenerateWEREvents
-
HAACKTimeoutMins
-
InstallationDirectory
-
KnownMobileDevices
-
LocalCachePath
-
LocalSsdStagger
-
LogFileName
-
MaxAllocRequest
-
MaxAllowedLinkSpeed
-
MaxBusyBackOffSecs
-
MaxCacheDays
-
MaxCacheSizeMB
-
MaxConcurrency
-
MaxDevicesFromAE
-
MaxElectionResponseLogging
-
MaximumMegaByte
-
MaxLogFileSize
-
MaxPackageSizeFastLAN
-
MaxPackageSizeRAS
-
MaxPackageSizeSlowLAN
-
MaxPacketsPerSecond
-
MaxPreCacheDays
-
MaxStatusFrequency
-
MaxStuckCount
-
MaxSUCacheDays
-
MaxWorkRates
-
MultiCastMADCAPScope
-
MulticastSupport
-
NoHardlink
-
NomadInhibitedADSites
-
NomadInhibitedSubnets
-
NomadNeverUseSubnets
-
NoSsdReqOnInhibitedSubnets
-
P2P_Port
-
P2PClientCertWaitPeriodMins
-
P2PDisqualifyMaxNumPeers
-
P2PDisqualifyMaxWindowMins
-
P2PElectionWeight
-
P2PEnabled
-
P2PHttpPort
-
P2PHttpsPort
-
P2PSslSettings
-
PercentAvailableDisk
-
PercentDelayedContentReg
-
PermittedLSZShares
-
PlatformURL
-
PostCompleteTimeoutHours
-
PrecachePollBatchSize
-
PrecachePollMinutes
-
PreCompleteTimeoutHours
-
RecycleDPDelay
-
RunUncachedPermittedFastLAN
-
SigsFolder
-
SiteSsdStagger
-
SpecialNetShare
-
SSDEnabled
-
SSPBAEnabled
-
StatusMsgEvents
-
SuccessCodes
-
WakeUpBatchSize
-
WakeUpEnabled
-
WakeUpMinPackageSizeMB
-
WLanBlipSecs
-
WLanProfileList
-
AssumedLinkSpeed
-
Nomad client registry values and installer properties
-
Alphabetic NomadBranch registry values
-
Nomad command-line switches
-
Nomad return codes
-
Status messages for download events
-
Nomad local multicast
-
Basic Nomad behavior in a simple environment
-
Index
-
Release notes
-
Log files
-
Supported Platforms
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 value | Description |
---|---|
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:
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. |
NMDS\EnforceQuotas | Determines whether Windows Disk Quotas (if configured) are enforced on the PBA share defined in CachePath . |
NMDS\ExtraReplyDelayMs | Time by which PBA peer reply window should be extended to avoid network spikes. |
NMDS\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. |
NMDS\MaxAllocRequest | Sets the maximum amount of space in MB that can be requested by each PBA client. |
NMDS\MaxConcurrency | Sets the maximum number of concurrent PBA sessions that may be in use on the host. |
NMDS\MaximumMegaByte | 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
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).
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 formhttp://server/ActiveEfficiency
or http://server:port/ActiveEfficiency
depending on how the ActiveEfficiency Web service is configured. HTTP and HTTPS protocols are supported.