Contents
The Nomad client module of 1E Client replaces the legacy NomadBranch component of Nomad.
When the 1E Client starts, and the Nomad client module is enabled, it will only initialize the Nomad client module if the OS version is Windows 7 or later. The 1E Client will automatically remove any previous installation of NomadBranch, keeping relevant NomadBranch registry settings.
The 1E Client Nomad 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.)
Configuration file settings can be managed using 1E Client reconfiguration, Tachyon Explorer configuration instructions, Tachyon Guaranteed State 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 Nomad client module of the 1E Client. Installer properties that use numeric values must be set using decimal integers on the installer command-line.
Each installer property listed below has a link to its corresponding registry value page.
Nomad client settings
Installer property | Description |
---|---|
Module.Nomad.Enabled | Set this property to true to enable the Nomad 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 Nomad 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 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. | |
Determines the value of :
| |
Determines the certificate issuer for the following.
| |
MODULE.NOMAD.CERTSUBJECT | Determines the client certificate subject to use when downloading over HTTPS from internet facing distribution points. It is also used when communicating with management points as part of the Nomad pre-caching feature. |
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 |
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. |
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. | |
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. | |
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. | |
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. | |
The level of messages logged in the Nomad logs for debugging purposes. The installer property must be set to sum of the integer values for the required bits. For example, to set all three supported debug levels, run: | |
MODULE.NOMAD.DOWNLOADTIMEOUT | Sets the timeout in seconds after which a job will be cancelled if the download has not been successful. |
MODULE.NOMAD.DPNOTAVAILABLECODES | Determines which error codes will cause Nomad to retry a download using an alternative distribution point. For example, the following would set Nomad to the default value on the 1E Client installer command-line: |
Determines whether Windows Disk Quotas (if configured) are enforced on the PBA share defined in CachePath . | |
Determines whether Windows Error Reporting memory dumps should be sent to Microsoft Winqual. | |
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 site SSD query stagger duration (seconds). | |
Name of the Nomad 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 Nomad 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 | |
The MADCAP scope for multicast. | |
MODULE.NOMAD.MAXALLOCREQUEST | Sets the maximum amount of space in MB that can be requested by each PBA client. |
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. | |
Sets the maximum number of concurrent PBA sessions that may be in use on the host. | |
MODULE.NOMAD.MAXDEVICESFROMAE | The maximum number of devices with the content that Nomad can retrieve from ActiveEfficiency server in one call. |
MODULE.NOMAD.MAXIMUMMEGABYTE | The maximum amount of space (in MB) that can be used for all the PBA shares combined on the host. |
MODULE.NOMAD.MAXLOGSIZE | The maximum size (in bytes) of the Nomad log file. Default is 5MB. |
MODULE.NOMAD.MAXPACKAGEFAST | The maximum size (in bytes) of a package that Nomad attempts to cache on a Fast LAN (>500 kbps) connection. |
MODULE.NOMAD.MAXPACKAGERAS | 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. | |
When the Nomad cache cleaner runs, delete any software updates that last triggered Nomad elections before the specified number of days ago. | |
The behavior of local multicast. | |
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. | |
Delay the content registration request made to ActiveEfficiency by the Content Registration Sync Cycle process that runs every ContentRegSyncCycleHrs. Do not use unless advised by 1E. | |
Determines how the Nomad cache is accessed. See Peer access to the Nomad cache for more details. The installer property must be set to sum of the integer values for the required bits. For example, the following would set Nomad to use connectionless P2P on the 1E Client installer command-line: | |
MODULE.NOMAD.P2PHTTPPORT | The HTTP port to use for peer copy. |
MODULE.NOMAD.P2PHTTPSPORT | The HTTPS port to use for peer copy. |
Port used to broadcast election messages, for connectionless cache access and package status broadcasts. | |
Determines the type of certificate (self-signed or PKI) to use. | |
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. | |
MODULE.NOMAD.PERMITUNCACHED | Determines where the download package is run from under certain conditions. |
MODULE.NOMAD.PLATFORMURL | The URL of the ActiveEfficiency web service, usually of the form |
MODULE.NOMAD.POSTCOMPLETETIMEOUTHOURS | The duration (in hours) after which the PBA share is deleted from the host. |
MODULE.NOMAD.PRECACHEPOLLBATCHSIZE | The number of notifications a client processes in one pre-cache poll cycle. |
MODULE.NOMAD.PRECACHEPOLLMINUTES | The interval (in minutes) between Nomad polling ActiveEfficiency for new pre-cache jobs. |
MODULE.NOMAD.PRECOMPLETETIMEOUTHOURS | The duration (in hours) after which PBA share is deleted from the host. |
The delay (in seconds) before restarting retries from the first DP after the whole list of available DPs have been tried. | |
The path to the Configuration Manager signature files. | |
Sets the site SSD query stagger duration (seconds). | |
Sets various special feature options related to the Nomad 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 Nomad 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: > msiexec /i 1E.Client-x64.msi MODULE.NOMAD.SPECIALNETSHARE=129 [other properties] /qn | |
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. > msiexec /i 1E.Client-x64.msi MODULE.NOMAD.SSDENABLED=3 [other properties] /qn |
MODULE.NOMAD.SSPBAENABLED | 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. | |
This installer property sets the Nomad EncryptionType registry entry. Determines the type of encryption used by Nomad to encrypt its communications between Nomad peers. | |
The maximum number of machines to wake up in a single call. | |
MODULE.NOMAD.WAKEUPENABLED | Enables WakeUp integration, see Integrating with WakeUp for more details. |
MODULE.NOMAD.WAKEUPMINPACKAGESIZEMB | The minimum size of content (in megabytes) that will cause a request for a wakeup. See Integrating with WakeUp for more details. |
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 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. |
MODULE.NOMAD.WLANPROFILELIST | A list of wireless SSIDs to enable switching from wireless to wired LAN connections. |
NomadBranch\NMDS