Content Distribution client settings

Multi-tenant SaaS platform Green checkmark | Single-tenant SaaS platform Green checkmark | On-premises platform Green checkmark

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

Module.Nomad.Enabled

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.

MODULE.NOMAD.AUTHENTICATEDUSERS

Determines which of the built-in security groups is granted read-only permissions to the The Content Distribution share.

Refer to AuthenticatedUsers.

MODULE.NOMAD.BLOCKSIZE

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

Refer to BlockSize.

MODULE.NOMAD.CACHECLEANCYCLEHRS

Determines the number of hours between automatically running the Content Distribution cache cleaner.

Refer to CacheCleanCycleHrs.

MODULE.NOMAD.CACHECLEANSUBNETLOOKUP

If enabled, sets the cache clean subnet lookup.

Refer to CacheCleanSubnetLookup.

MODULE.NOMAD.CACHEPATH

Determines the value of:

  • NomadBranch\LocalCachePath - the location of local Content Distribution package cache

Refer to CachePath

Refer to LocalCachePath

MODULE.NOMAD.CACHESTATESYNCINTERVALMINUTES

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.

MODULE.NOMAD.CERTISSUER

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

  • Configuration Manager client authentication certificate - used when downloading over HTTPS from Distribution Points and when communicating with Management Points during pre-caching.

  • Content Distribution 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.

Refer to CertIssuer.

MODULE.NOMAD.CERTSUBJECT

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.

MODULE.NOMAD.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.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
msiexec /i 1E.Client-x64.msi MODULE.NOMAD.COMPATIBILITYFLAGS=131073 [other properties] /qn

Refer to CompatibilityFlags.

MODULE.NOMAD.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.

Refer to ContentProviderOnWifi

MODULE.NOMAD.CONTENTREGISTRATION

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.

MODULE.NOMAD.DEBUG

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

Refer to Debug.

MODULE.NOMAD.DOREPORTINGENABLED

Enables Delivery Optimization monitoring and reporting if ContentRegistration is enabled.

Refer to DeliveryOptimizationReportingEnabled.

MODULE.NOMAD.DOWNLOADTIMEOUT

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

Refer to DownloadTimeout.

MODULE.NOMAD.DPCACHECLEANUPENABLED

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

Refer to DpCacheCleanupEnabled.

MODULE.NOMAD.DPNOTAVAILABLECODES

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
> msiexec /i 1E.Client-x64.msi MODULE.NOMAD.DPNOTAVAILABLECODES="0x205A,0x205D" [other properties] /qn

Refer to DPNotAvailableCodes.

MODULE.NOMAD.ENFORCEQUOTAS

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

Refer to EnforceQuotas.

MODULE.NOMAD.GENERATEWEREVENTS

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

Refer to GenerateWEREvents.

MODULE.NOMAD.HAACKTIMEOUTMINS

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.

MODULE.NOMAD.LOCALSSDSTAGGER

Sets the site SSD query stagger duration (seconds).

Refer to LocalSsdStagger.

MODULE.NOMAD.LOGNAME

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.

MODULE.NOMAD.LOGPATH

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

MODULE.NOMAD.MAXALLOCREQUEST

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

Refer to MaxAllocRequest.

MODULE.NOMAD.MAXCACHEDAYS

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.

MODULE.NOMAD.MAXCACHEDAYSTHRESHOLD

This is the maximum number of days content is present on a client.

Refer to MaxCacheDaysThreshold.

MODULE.NOMAD.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.

Refer to MaxCacheSizeMB.

MODULE.NOMAD.MAXCONCURRENCY

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

Refer to MaxConcurrency.

MODULE.NOMAD.MAXDEVICESFROMAE

The maximum number of devices with the content that Content Distribution can retrieve from Content Distribution in one call.

Refer to MaxDevicesFromAE.

MODULE.NOMAD.MAXELECTIONRESPONSELOGGING

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

Refer to MaxElectionResponseLogging.

MODULE.NOMAD.MAXIMUMMEGABYTE

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

Refer to MaximumMegaByte.

MODULE.NOMAD.MAXLOGSIZE

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

Refer to MaxLogFileSize.

MODULE.NOMAD.MAXPACKAGEFAST

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

Refer to MaxPackageSizeFastLAN.

MODULE.NOMAD.MAXPACKAGERAS

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

Refer to MaxPackageSizeRAS.

MODULE.NOMAD.MAXPACKAGESLOW

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

Refer to MaxPackageSizeSlowLAN.

MODULE.NOMAD.MAXPRECACHEDAYS

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.

MODULE.NOMAD.MAXSTATUSFREQUENCY

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

Refer to MaxStatusFrequency.

MODULE.NOMAD.MAXSTUCKCOUNT

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.

MODULE.NOMAD.MAXSUCACHEDAYS

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.

MODULE.NOMAD.NOHARDLINK

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

Refer to NoHardlink.

MODULE.NOMAD.NOMADINHIBITEDADSITES

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.

MODULE.NOMAD.NOMADINHIBITEDSUBNETS

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.

MODULE.NOMAD.P2PDISQUALIFYMAXNUMPEERS

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

Refer to P2PDisqualifyMaxNumPeers.

MODULE.NOMAD.P2PDISQUALIFYMAXWINDOWMINS

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

Refer to P2PDisqualifyMaxWindowMins.

MODULE.NOMAD.P2PENABLED

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
> msiexec /i 1E.Client-x64.msi MODULE.NOMAD.P2PENABLED=6 [other properties] /qn

MODULE.NOMAD.P2PHTTPPORT

The HTTP port to use for peer copy.

Refer to P2PHttpPort.

MODULE.NOMAD.P2PHTTPSPORT

The HTTPS port to use for peer copy.

Refer to P2PHttpsPort.

MODULE.NOMAD.P2PPORT

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

Refer to P2P_Port.

MODULE.NOMAD.P2PSSLSETTINGS

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

Refer to P2PSslSettings.

MODULE.NOMAD.PERCENTAVAILABLEDISK

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.

MODULE.NOMAD.PERMITTEDLSZSHARES

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

Refer to PermittedLSZShares.

MODULE.NOMAD.PERMITUNCACHED

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

Refer to RunUncachedPermittedFastLAN.

MODULE.NOMAD.PLATFORMURL

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.

MODULE.NOMAD.POSTCOMPLETETIMEOUTHOURS

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

Refer to PostCompleteTimeoutHours.

MODULE.NOMAD.PRECACHEPOLLBATCHSIZE

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

Refer to PrecachePollBatchSize.

MODULE.NOMAD.PRECACHEPOLLMINUTES

The interval (in minutes) between Content Distribution polling Microsoft content distribution for new pre-cache jobs.

Refer to PrecachePollMinutes.

MODULE.NOMAD.PRECOMPLETETIMEOUTHOURS

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

Refer to PreCompleteTimeoutHours.

MODULE.NOMAD.RECYCLEDPDELAY

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

Refer to RecycleDPDelay.

MODULE.NOMAD.RANDOMIZEREMOTEPATHS

Allows you to enable and disable the remote paths randomization for Configuration Manager and pre-cache jobs.

Refer to RandomizeRemotePaths.

MODULE.NOMAD.SIGSFOLDER

The path to the Configuration Manager signature files.

Refer to SigsFolder.

MODULE.NOMAD.SITESSDSTAGGER

Sets the site SSD query stagger duration (seconds).

Refer to SiteSsdStagger.

MODULE.NOMAD.SITESSDMINPACKAGESIZEKB

Allows you to configure a minimum content size before making an SSD request.

Refer to SiteSSDMinPackageSizeKB.

MODULE.NOMAD.SPECIALNETSHARE

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
> msiexec /i 1E.Client-x64.msi MODULE.NOMAD.SPECIALNETSHARE=129 [other properties] /qn

Refer to SpecialNetShare.

MODULE.NOMAD.SSDENABLED

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
> msiexec /i 1E.Client-x64.msi MODULE.NOMAD.SSDENABLED=3 [other properties] /qn

Refer to SSDEnabled.

MODULE.NOMAD.SSPBAENABLED

Enables the use of Single Site functionality for PBA data stores. See Single Site Peer Backup Assistant - SSPBA for more details.

Refer to SSPBAEnabled.

MODULE.NOMAD.STATUSMSGEVENTS

Determines which Content Distribution events are reported using Configuration Manager status messages.

Refer to StatusMsgEvents.

MODULE.NOMAD.SUCCESSCODES

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.

MODULE.NOMAD.SUPPORTWPAD

Provides support for Web Proxy Auto-Discovery Protocol (WPAD).

Refer to SupportWPAD.

MODULE.NOMAD.USEFIPS

This installer property sets the Content Distribution EncryptionType registry entry.

MODULE.NOMAD.WLANBLIPSECS

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.

MODULE.NOMAD.WLANPROFILELIST

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

Refer to WLanProfileList.