Content Distribution client settings
Multi-tenant SaaS platform | Single-tenant SaaS platform
| On-premises platform
The product formerly referred to as Nomad has been rebranded as Content Distribution. Although the new name is implemented in the majority of documentation and user interfaces, references to Nomad may still appear in specific tools, scripts, or contexts.
Installer properties and configuration file settings for the Content Distribution client module of the 1E Client, which is supported only on Windows devices.
Installer properties
Module.Nomad.Enabled | MODULE.NOMAD.AUTHENTICATEDUSERS | MODULE.NOMAD.BLOCKSIZE | MODULE.NOMAD.CACHECLEANCYCLEHRS | MODULE.NOMAD.CACHECLEANSUBNETLOOKUP | MODULE.NOMAD.CACHEPATH | MODULE.NOMAD.CACHESTATESYNCINTERVALMINUTES | MODULE.NOMAD.CERTISSUER | MODULE.NOMAD.CERTSUBJECT | MODULE.NOMAD.COMPATIBILITYFLAGS | MODULE.NOMAD.CONTENTPROVIDERONWIFI | MODULE.NOMAD.CONTENTREGISTRATION | MODULE.NOMAD.DEBUG | MODULE.NOMAD.DOREPORTINGENABLED | MODULE.NOMAD.DOWNLOADTIMEOUT | MODULE.NOMAD.DPCACHECLEANUPENABLED | MODULE.NOMAD.DPNOTAVAILABLECODES | MODULE.NOMAD.ENFORCEQUOTAS | MODULE.NOMAD.GENERATEWEREVENTS | MODULE.NOMAD.HAACKTIMEOUTMINS | MODULE.NOMAD.LOCALSSDSTAGGER | MODULE.NOMAD.LOGNAME | MODULE.NOMAD.LOGPATH | MODULE.NOMAD.MAXALLOCREQUEST | MODULE.NOMAD.MAXCACHEDAYS | MODULE.NOMAD.MAXCACHEDAYSTHRESHOLD | MODULE.NOMAD.MAXCACHESIZEMB | MODULE.NOMAD.MAXCONCURRENCY | MODULE.NOMAD.MAXDEVICESFROMAE | MODULE.NOMAD.MAXELECTIONRESPONSELOGGING | MODULE.NOMAD.MAXIMUMMEGABYTE | MODULE.NOMAD.MAXLOGSIZE | MODULE.NOMAD.MAXPACKAGEFAST | MODULE.NOMAD.MAXPACKAGERAS | MODULE.NOMAD.MAXPACKAGESLOW | MODULE.NOMAD.MAXPRECACHEDAYS | MODULE.NOMAD.MAXSTATUSFREQUENCY | MODULE.NOMAD.MAXSTUCKCOUNT | MODULE.NOMAD.MAXSUCACHEDAYS | MODULE.NOMAD.NOHARDLINK | MODULE.NOMAD.NOMADINHIBITEDADSITES | MODULE.NOMAD.NOMADINHIBITEDSUBNETS |MODULE.NOMAD.P2PDISQUALIFYMAXNUMPEERS | MODULE.NOMAD.P2PDISQUALIFYMAXWINDOWMINS | MODULE.NOMAD.P2PENABLED | MODULE.NOMAD.P2PHTTPPORT | MODULE.NOMAD.P2PHTTPSPORT | MODULE.NOMAD.P2PPORT | MODULE.NOMAD.P2PSSLSETTINGS | MODULE.NOMAD.PERCENTAVAILABLEDISK | MODULE.NOMAD.PERMITTEDLSZSHARES | MODULE.NOMAD.PERMITUNCACHED | MODULE.NOMAD.PLATFORMURL | MODULE.NOMAD.POSTCOMPLETETIMEOUTHOURS | MODULE.NOMAD.PRECACHEPOLLBATCHSIZE | MODULE.NOMAD.PRECACHEPOLLMINUTES | MODULE.NOMAD.PRECOMPLETETIMEOUTHOURS | MODULE.NOMAD.RECYCLEDPDELAY | MODULE.NOMAD.RANDOMIZEREMOTEPATHS | MODULE.NOMAD.SIGSFOLDER | MODULE.NOMAD.SITESSDSTAGGER | MODULE.NOMAD.SITESSDMINPACKAGESIZEKB | MODULE.NOMAD.SPECIALNETSHARE | MODULE.NOMAD.SSDENABLED | MODULE.NOMAD.SSPBAENABLED | MODULE.NOMAD.STATUSMSGEVENTS | MODULE.NOMAD.SUCCESSCODES | MODULE.NOMAD.SUPPORTWPAD | MODULE.NOMAD.USEFIPS | MODULE.NOMAD.WLANBLIPSECS | MODULE.NOMAD.WLANPROFILELIST
Configuration file settings: Module.Nomad.Enabled
The Content Distribution client module of 1E Client replaces the legacy NomadBranch component of Content Distribution.
When the 1E Client starts, and the Content Distribution client module is enabled, it will only initialize the Content Distribution client module if the OS version is a supported Windows version. The 1E Client will automatically remove any previous installation of NomadBranch, keeping relevant NomadBranch registry settings.
The 1E Client Content Distribution client module is not supported on:
-
Non-Windows devices
-
Legacy OS (that is OS which Microsoft no longer support including XP, Vista, Server 2008 etc.). Refer to Supported platforms.
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.
The following table shows the supported installer properties for the Content Distribution client module of the 1E Client.
Each installer property listed below has a link to its corresponding registry value page.
Content Distribution client settings
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.
For a complete list of NomadBranch registry values, refer to Alphabetic NomadBranch registry values.
Installer property |
Description |
---|---|
Set this property to true to enable the Content Distribution client module. The default value is false. If enabled, when the 1E Client starts, it will attempt to automatically remove any previous installations of Nomad Branch. This setting does not have an associated Content Distribution registry entry and is stored in the 1E Client configuration file. |
|
Determines which of the built-in security groups is granted read-only permissions to the The Content Distribution share. Refer to AuthenticatedUsers. |
|
Value (in bytes) for the minimum size of each block of data Content Distribution copies from the package source folder. Refer to BlockSize. |
|
Determines the number of hours between automatically running the Content Distribution cache cleaner. Refer to CacheCleanCycleHrs. |
|
If enabled, sets the cache clean subnet lookup. Refer to CacheCleanSubnetLookup. |
|
Determines the value of:
Refer to CachePath Refer to LocalCachePath |
|
Ensures the cache state of a device held on ContentDistribution is in sync with locally held data. This setting controls the Content Registration Sync Cycle feature. Refer to value CacheStateSyncIntervalMinutes. |
|
Defines one or more certificate issuers that Content Distribution will use to select the appropriate PKI certificate for the:
Refer to CertIssuer. |
|
Defines one or more certificate subject names that Content Distribution uses to select the appropriate PKI certificate for authentication with Configuration Manager 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. Refer to CertSubject. |
|
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 installer property must be set to sum of the integer values for the required bits. For example, to disable hash value checking (1) and DelegatedLSZ checks and errors (131072), run the following on the installer command-line. Copy
Refer to CompatibilityFlags. |
|
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. Refer to ContentProviderOnWifi |
|
Determines if content in Content Distribution's cache (packages, applications, software updates, boot images, etc.) is registered with Content Distribution. Content registration is necessary if a host is to be available as a Single Site Download provider or can be woken up if a Content Distribution peer requires the content locally. Refer to ContentRegistration. |
|
The level of messages logged in the Content Distribution logs for debugging purposes. Refer to Debug. |
|
Enables Delivery Optimization monitoring and reporting if ContentRegistration is enabled. Refer to DeliveryOptimizationReportingEnabled. |
|
Sets the timeout in seconds after which a job will be cancelled if the download has not been successful. Refer to DownloadTimeout. |
|
Delete all obsolete LSZ files on the DP where the associated content is no longer present in ContentLib. Refer to DpCacheCleanupEnabled. |
|
Determines which error codes will cause Content Distribution to retry a download using an alternative distribution point. For example, the following would set Content Distribution to the default value on the 1E Client installer command-line: Copy
Refer to DPNotAvailableCodes. |
|
Determines whether Windows Disk Quotas (if configured) are enforced on the PBA share defined in CachePath. Refer to EnforceQuotas. |
|
Determines whether Windows Error Reporting memory dumps should be sent to Microsoft Winqual. Refer to GenerateWEREvents. |
|
The time-out period in minutes for the Peer Backup Assistant: High Availability (deprecated) (PBA-HA) task sequence action. If a machine running this action does not receive an acknowledgment message within this period from the PBA host performing the additional backups, the action will fail. Refer to HAACKTimeoutMins. |
|
Sets the site SSD query stagger duration (seconds). Refer to LocalSsdStagger. |
|
Name of the Content Distribution log file. This value is preserved upon upgrade. This property is combined with MODULE.NOMAD.LOGPATH to create registry value LogFileName. The default value is NomadBranch.log. |
|
Location of the Content Distribution log file. The path will be created if it does not exist. This value is preserved upon upgrade. Default values are dependent on OS. This property is combined with MODULE.NOMAD.LOGNAME to create the registry value LogFileName. The default location is: %ALLUSERSPROFILE%\1E\NomadBranch\LogFiles |
|
Sets the maximum amount of space in MB that can be requested by each PBA client. Refer to MaxAllocRequest. |
|
When the Content Distribution cache cleaner runs, delete any application or package content that last triggered Content Distribution elections before the specified number of days ago. Refer to MaxCacheDays. |
|
This is the maximum number of days content is present on a client. Refer to MaxCacheDaysThreshold. |
|
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. Refer to MaxCacheSizeMB. |
|
Sets the maximum number of concurrent PBA sessions that may be in use on the host. Refer to MaxConcurrency. |
|
The maximum number of devices with the content that Content Distribution can retrieve from Content Distribution in one call. Refer to MaxDevicesFromAE. |
|
Defines the number of election responses Content Distribution will write to the log for a given election. Refer to MaxElectionResponseLogging. |
|
The maximum amount of space (in MB) that can be used for all the PBA shares combined on the host. Refer to MaximumMegaByte. |
|
The maximum size (in bytes) of the Content Distribution log file. Default is 5MB. Refer to MaxLogFileSize. |
|
The maximum size (in bytes) of a package that Content Distribution attempts to cache on a Fast LAN (>500 kbps) connection. Refer to MaxPackageSizeFastLAN. |
|
The maximum size (in bytes) of a package that Content Distribution will attempt to cache on a RAS (<55 kbps) connection. Refer to MaxPackageSizeRAS. |
|
Maximum size (in bytes) of a package that Content Distribution attempts to cache on a Slow LAN (55-500 kbps) connection. Refer to MaxPackageSizeSlowLAN. |
|
When the Content Distribution cache cleaner runs, delete any pre-cached content that last triggered Content Distribution elections before the specified number of days ago. Refer to MaxPreCacheDays. |
|
The minimum interval (in seconds) between sending transfer progress status messages, thereby governing the overall maximum frequency for sending the messages. Refer to MaxStatusFrequency. |
|
Registry value to hold an integer determining the number of times Content Distribution attempts to copy content and gets stuck before aborting. Refer to MaxStuckCount. |
|
When the Content Distribution cache cleaner runs, delete any software updates that last triggered Content Distribution elections before the specified number of days ago. Refer to MaxSUCacheDays. |
|
Determines whether hard links are used between the Content Distribution cache and the Configuration Manager cache. Refer to NoHardlink. |
|
Prevents Content Distribution from calling an election when it is connected to a specified AD site, meaning that each Content Distribution client on the listed AD sites will automatically become a Content Distribution master. This prevents P2P sharing, as each master downloads its own copy of the content. Refer to NomadInhibitedADSites. |
|
Prevents Content Distribution from calling an election when it is connected to a specified IP subnet, meaning that each Content Distribution client on the IP subnet automatically becomes a Content Distribution master. This prevents P2P sharing, as each master downloads its own copy of the content. Refer to NomadInhibitedSubnets. |
|
Defines the max number of devices which a device will disqualify during a peer-to-peer copy. Refer to P2PDisqualifyMaxNumPeers. |
|
Defines the max number of minutes within which a device will disqualify a peer during a peer-to-peer copy. Refer to P2PDisqualifyMaxWindowMins. |
|
Determines how the Content Distribution cache is accessed. Refer to Content Distribution Cache for more details. Refer to P2PEnabled. The installer property must be set to sum of the integer values for the required bits. For example, the following would set Content Distribution to use connectionless P2P on the 1E Client installer command-line: Copy
|
|
The HTTP port to use for peer copy. Refer to P2PHttpPort. |
|
The HTTPS port to use for peer copy. Refer to P2PHttpsPort. |
|
Port used to broadcast election messages, for connectionless cache access and package status broadcasts. Refer to P2P_Port. |
|
Defines server and client authentication options when using HTTPS for P2P content transfer (i.e. P2PEnabled 0x60 option is set). Refer to P2PSslSettings. |
|
The limit on the Content Distribution 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. Refer to PercentAvailableDisk. |
|
Restricts Content Distribution LSZ file generation requests to a list of permitted package source locations. Refer to PermittedLSZShares. |
|
Determines where the download package is run from under certain conditions. Refer to RunUncachedPermittedFastLAN. |
|
The URL of the 1E Platform, specifically the Background Channel, which provides a reverse proxy for the Content Distribution component of 1E Platform. Usually of the form https://<BackgroundChannelServer>:<BackgroundChannelPort>/Background/. Refer to PlatformURL. |
|
The duration (in hours) after which the PBA share is deleted from the host. Refer to PostCompleteTimeoutHours. |
|
The number of notifications a client processes in one pre-cache poll cycle. Refer to PrecachePollBatchSize. |
|
The interval (in minutes) between Content Distribution polling Microsoft content distribution for new pre-cache jobs. Refer to PrecachePollMinutes. |
|
The duration (in hours) after which PBA share is deleted from the host. Refer to PreCompleteTimeoutHours. |
|
The delay (in seconds) before restarting retries from the first DP after the whole list of available DPs have been tried. Refer to RecycleDPDelay. |
|
Allows you to enable and disable the remote paths randomization for Configuration Manager and pre-cache jobs. Refer to RandomizeRemotePaths. |
|
The path to the Configuration Manager signature files. Refer to SigsFolder. |
|
Sets the site SSD query stagger duration (seconds). Refer to SiteSsdStagger. |
|
Allows you to configure a minimum content size before making an SSD request. Refer to SiteSSDMinPackageSizeKB. |
|
Sets various special feature options related to the Content Distribution share. The installer property must be set to sum of the integer values for the required bits. For example, to use the computer$ account for access to the Content Distribution share, and have custom share permissions, you would set the value for the SpecialNetShare registry entry to 129 (0x81 hex). This is shown in the following 1E Client installer command-line: Copy
Refer to SpecialNetShare. |
|
Enables Single Site Download (SSD). The installer property must be set to sum of the integer values for the required bits. For example, the following will turn the complete SSD functionality on: Copy
Refer to SSDEnabled. |
|
Enables the use of Single Site functionality for PBA data stores. See Single Site Peer Backup Assistant - SSPBA for more details. Refer to SSPBAEnabled. |
|
Determines which Content Distribution events are reported using Configuration Manager status messages. Refer to StatusMsgEvents. |
|
A list of Content Distribution return codes that are translated as success to the Content Transfer Manager (CTM) component of the Configuration Manager client. Refer to SuccessCodes. |
|
Provides support for Web Proxy Auto-Discovery Protocol (WPAD). Refer to SupportWPAD. |
|
This installer property sets the Content Distribution EncryptionType registry entry. |
|
The duration for temporarily disabling a wireless connection when a wired LAN connection becomes available, to provide time for the OS and Content Distribution to switch to the LAN connection. This is useful for OS versions and drivers that do not automatically switch to a preferred wired connection. Refer to WLanBlipSecs. |
|
A list of wireless SSIDs to enable switching from wireless to wired LAN connections. Refer to WLanProfileList. |