Академический Документы
Профессиональный Документы
Культура Документы
All rights reserved. No part of this document or of the software (the software) to which it relates shall
be reproduced, adapted, stored in a retrieval system, or transmitted by any means, electronic,
mechanical, photocopying, recording, or otherwise, without permission from 1E Ltd. It is the
responsibility of the user to use the software in accordance with this document and 1E Ltd shall not be
responsible if the user fails to do so. Although every precaution has been taken in the preparation of this
document, 1E Ltd and the authors assume no responsibility for errors or omissions, nor shall they be
liable for damages resulting from any information in it.
Trademarks
1E, the 1E device, APPCLARITY, ACTIVEEFFICIENCY, NIGHTWATCHMAN, NOMAD ENTERPRISE, PXE
EVERYWHERE, DROWSY and DROWSY SERVER are trademarks belonging to 1E Ltd. 1E is registered in
the UK, EU and the US. The 1E device is registered in the UK, EU, Australia and the US.
NIGHTWATCHMAN is registered in the EU and the US. Nomad is registered in the EU and the US.
DROWSY is registered in the UK. DROWSY SERVER is registered in the US.
MICROSOFT, WINDOWS 8, WINDOWS 7, WINDOWS VISTA, WINDOWS XP, SMS, CONFIGURATION
MANAGER, INTERNET EXPLORER are all trademarks of Microsoft Corporation in the United States and
other countries.
Macintosh is a trademark of Apple Inc., registered in the U.S. and other countries.
2. Introduction ................................................................................................... 6
2.1 Introduction ...................................................................................................... 6
Who is this guide for? ......................................................................................... 6
1. Welcome
Welcome to the Nomad 2012 v5.2 on-line documentation. Here you can learn about how Nomad 2012
works, the new features it supports and how the Nomad 2012 components fit together to provide
enterprise-wide, efficient and secure content download.
Installation Engineers can find out about the prerequisites for installing Nomad 2012 and check the
installation steps .
Systems administrators can find out how to: configure Nomad 2012 for use with Configuration Manager
2012, configure Nomad 2012 for OS deployments, monitor Nomad 2012 downloads, manage the Nomad
2012 cache and find information on the Nomad 2012 command-line switches, return codes, status
message events and registry entries .
Enterprises interested in providing bare metal OS deployment in branch scenarios can find out how to
install and configure PXE Everywhere v2.1 .
Support for ConfigMgr 2012 R2, Windows 8.1 and Windows Server 2012 R2
Pre-stage content using Nomad custom task sequence action now supports the use of custom
ports in ConfigMgr 2012 and ConfigMgr 2007 when using Nomad for OS Deployment
App-V Streaming - Nomad integrates with App-V streaming applications, recognizing that the
initial download is only partial enabling full download at a later date.
2. Introduction
2.1 Introduction
Welcome to Nomad, the key software from 1E that increases the efficiency of software and patch
distribution and saves you money in the process. It maximizes WAN availability during download by
providing features such as: Central Multicast, download once to branch, and download resumption with
built-in consistency checking.
Nomad reduces the load on the central Distribution Points and eliminates the necessity for local
Distribution Points. This allows the ConfigMgr infrastructure to be simplified while still retaining coverage
of the entire network and reducing maintenance costs.
PXE Everywhere v2.1, a tool that helps deliver OS updates to bare metal computers
Key benefits
Nomad solves problems in key areas of distributing large amounts of data across a distributed network.
In particular Nomad provides the following benefits:
Significantly reduces the bandwidth required for delivering software.
Small offices or sites connected via poor network links can receive software updates more
reliably.
Reduces the need for large numbers of ConfigMgr servers.
Faster ConfigMgr implementations because fewer servers are required.
Installing Nomad
Full details on the prerequisites required for installing Nomad can be found here and the steps for
installing the Nomad components can be found here.
Support for ConfigMgr 2012 R2, Windows 8.1 and Windows Server 2012 R2
Pre-stage content using Nomad custom task sequence action now supports the use of custom
ports in ConfigMgr 2012 and ConfigMgr 2007 when using Nomad for OS Deployment
App-V Streaming - Nomad integrates with App-V streaming applications, recognizing that the
initial download is only partial enabling full download at a later date.
Multicast support added to Install and configure Nomad in WinPE and Pre-stage content using
Nomad Task Sequence actions.
Pre-stage content using Nomad Task Sequence action no longer requires the use of LSZ
Delegation for non-site server distribution points.
Pre-stage content using Nomad Task Sequence action now displays progress information in the
Task Sequence User Interface.
Streamlined OSD Task Sequence Nomad integration.
Nomad FanOut - this feature enables more Nomad Peers to be updated with the download from
the Nomad Master by allowing the machines directly connected to the Nomad Master to
themselves share out the download.
Single Site Download - this feature ensures that downloads are performed only once per branch
site, not per branch subnet - thereby maximizing the efficient distribution of downloads without
using the WAN more than once.
PXE Everywhere v2.1 - PXE Everywhere is a new feature in Nomad that lets you configure branch
networks to allow bare metal OS deployment efficiently in a scalable way that requires minimal
resources.
ConfigMgr 2012 support Nomad now integrates closely with the ConfigMgr 2012 Application
Model to support content download for Packages, Task Sequences, Driver Packages, Operating
System Images, Boot images, Applications and Software Updates.
Sensitive Server Weighting Election weighting now takes a special case value that prevents a
business critical server from becoming a master.
OSD Migration Tools Nomad is now bundled with the NomadPackageLocator and TSEnv2 OSD
support tools. These help to support the new Peer Backup Assistant and Nomad WinPE 3x
features. 32- and 64-bit variants of these tools, which were previously bundled with the PXE
Everywhere installer, are now installed as part of the NomadBranchAdminUIExt.msi installer.
Mobile data connection awareness The increased usage of mobile devices operating over
various standards and technologies has also increased the need for awareness of the connection
type. This is essential in order not to incur cost and performance penalties when transferring
large amounts of systems management content or data, especially as many mobile providers
limit data usage with large cost penalties for exceeding the limits.
Nomad provides a mechanism for identifying and managing the connection type. If the agent
connection type matches a locally configured list of known devices it is determined to be a
mobile data connection and only Packages specifically configured to use a mobile data connection
will be transferred.
Wireless stability provides extra stability by managing a machine's connections as they move
between wired and wireless LAN. Often once an SMB or HTTP session is running on wireless it
will remain on wireless even when a wired LAN becomes available. The wired LAN connection is
normally deemed to be faster, more stable and reliable, so if Nomad is presented with a scenario
where a session is running on wireless but a wired LAN becomes available, it will drop the
wireless connection and seamlessly resume on the wired LAN.
LSZ delegation This feature supports distribution point server shares where ConfigMgr 2007
and Nomad 2012 are not installed and, as a result, the required .LSZ file cannot be produced. A
DP server share can be created on a Windows Server or NAS device. A file called
DelegatedLSZ.txt must be manually created upon the NAS DP. This provides a pointer to the
location of an alternate DP (usually the upstream DP). The client agent will then contact the
alternate location for its package LSZ files, and download the package content from the DP
server share.
P2P enhancements v4 has some new peertopeer connection options that enable it to work in
a wider range of scenarios than previously.
Internet Protocol Version 6 support Internet Protocol version 6 (IPv6) is the successor to
Internet Protocol version 4 (IPv4). The main driver to support IPv6 has been a recent directive
for all US federal organizations to move to this protocol. By providing support for IPv6
environments v4.0 also supports distribution to clients connected to the corporate network using
DirectAccess.
Distribution Point Resilience ConfigMgr provides a list of DPs to support failover capabilities
should access to a DP encounter problems. Nomad v4 supports cycling through this list of
available DPs until one can be reached and will now attempt to do this multiple times until a
configurable timeout has been reached.
Windows 7 Embedded support is now available on Windows Embedded Standard 2011
(formerly known as Windows 7 Embedded). As long as a fully working ConfigMgr 2007 client is
present all existing functionality can be fully utilized.
Permitted LSZ Shares enhancement the PermittedLszShares registry entry can now take
wildcards to provide flexible naming convention support.
Dynamic election weighting v4 now dynamically weights the chances of a computer
successfully winning a master election. Computers running Server Operating Systems are
favored whereas computers with a chassis type of mobile or with a connection type of wireless
are negatively weighted. This dynamic adjustment happens in addition to any locally configured
settings.
Domain Controller support v4 can now be deployed on Domain Controllers to allow them to
use Nomad features to get any locally required content, while ensuring as they perform mission
critical functions that they never have to provide any services to other computers on the
network.
The Multicast functionality is enabled by a specific product license. Please contact Sales for more
details.
Key benefits
Significantly reduces the bandwidth required for delivering software.
Small offices or sites connected via poor network links can receive software updates more
reliably.
Reduces the need for large numbers of ConfigMgr servers.
Faster ConfigMgr implementations because fewer servers are required.
Distribute software to home, mobile and remote office users
Low cost easy to deploy
No new infrastructure or skills required
Reduces software distribution costs
3. Prerequisites
This section describes prerequisites needed to ensure a successful deployment of Nomad.
Requirements Notes
General The following requirements should be met before installing Nomad on your network.
When upgrading we recommend that you update all versions of Nomad
running on a single subnet at the same time. It is also highly recommended
that all the Site Servers and Distribution Points are updated first with Nomad
5.x before updating versions of Nomad running on the clients to avoid
known compatibility issues between Nomad 5.x clients and Distribution
Points running earlier versions of Nomad.
Ensure DNS is working properly
OS Nomad and Nomad Multicast should install and be configurable on any workstation
running the following Microsoft operating systems:
Windows 8.1 (Professional, Enterprise)
Windows 8 (Professional, Enterprise)
Nomad and Nomad Multicast should install and be configurable on any server
running the following Microsoft operating systems:
Windows Server 2012 R2
Nomad installers Nomad has two sets of installers one for 32-bit systems and the other for 64-bit
systems. The set that should be used depends on the ConfigMgr client installed on
the local machine.
ConfigMgr 2007 clients are always 32-bit so only the 32-bit Nomad installers
should be regardless of whether the target computer is 32-bit or 64-bit.
ConfigMgr 2012 clients may be either 32-bit or 64-bit client so the Nomad
installers used must match the local client.
The Nomad 32-bit installers are in the NomadBranch.v5.x.x.x.zip file:
NomadBranch.msi (in both the ConfigMgr2007 and ConfigMgr2012
directories)
NomadBranchAdminUIExt.msi (in ConfigMgr2007)
NomadBranchGui.msi (in DownloadMonitor)
The Nomad installers for 64-bit systems are in the ConfigMgr2012 directory in the
NomadBranch.v5.x.x.x.zip file:
Distribution Point To support enhanced Package consistency checking, Nomad requires that the Nomad
agent is installed on each ConfigMgr Distribution Point (DP). This agent enables file-
level consistency checking by creating a manifest file on the DP for every version of
each Package created.
This allows Nomad to check that each file it downloads is consistent with the version
available on the DP.
Note
On ConfigMgr 2012 systems LSZ generation using HTTP/HTTPS is not enabled by
default on standalone Distribution Points. You will need to manually enable it on
the Nomad agent running on the standalone DP by configuring the
SpecialNetShare registry entry to include the 0x4000 value.
If the DP is not installed on a Primary or Secondary Site server you must ensure that
the Nomad registry setting PermittedLsZShares on the DP is updated to contain the
local share name(s) used on the server (e.g. SMSPKGF$; SMSPKGG$; etc) to host
ConfigMgr packages
To support Nomad RDC integration the Remote Differential Compression Feature
must also be installed using the Windows Server Manager. You will also need to set
the SigsFolder registry entry to point to the ConfigMgr RDC signatures folder. If the
DP is installed on a site server this step is not required as Nomad retrieves the DP
share name information directly from WMI.
For more details please refer to the description of the PERMITTEDLSZSHARES and
SIGSFOLDER installer command-line properties.
System Center For each ConfigMgr Site Server where you intend to administer Task Sequence
Configuration Packages to use Nomad as the alternate download Provider, you need to ensure the
Manager following conditions hold:
Nomad Download The following components must be present prior to installing the Nomad Download
Monitor Monitor:
Nomad To install the NomadBranchTools for ConfigMgr 2012 the following needs to be
NomadBranchTool present:
s
A local installation of the System Center Configuration Manager 2012 Site
Server.
Nomad Admin To install the Admin Console GUI extensions the following needs to be present:
Console GUI
A local installation of the System Center Configuration Manager Admin
extensions
Console.
Nomad Multicast To use the Multicast functionality for Nomad you will need a specific multicast license
key available from 1E.
For more information on purchasing license keys contact Sales, details on contacting
1E are provided in Technical Support for Nomad.
Attention
If you change the default port, please ensure all Nomad clients are communicating
using the same port.
4. Installation
Before attempting to install Nomad 2012 you should ensure that the Prerequisites have been met.
Here you can view:
Installer Description
Distribution Points
Site servers
Installer Description
Distribution Points.
Installer Description
PowerShell scripts:
Installer Description
Before starting the installation you should check and ensure that all the Prerequisites have been met.
Destination Folder - Click Next to accept the default installation directory or click the Change... button
to change this.
The defaults for the Destination Folder for the various systems and installers are shown in the
following boxes:
C:\Program Files\1E\NomadBranch\
Multicast Configuration - This screen configures the Nomad use of multicast as described below:
Information
This screen will always appear even if you have entered a standard Nomad license without
the Multicast option. If this is the case ensure the No Multicast option is selected and click
Next on the page to go to the next phase of the installation. All machines in a single branch
must be configured using the same setting for this option.
No Multicast this option turns off multicast mode.
Data Only Multicast data refers to the contents of the downloaded Package. Select this
option for standard Nomad Multicast.
Control Only Multicast control information refers to the communications between Nomad
enabled machines, especially the election information.
Control and Data Multicast selecting this option enables the multicasting of both control
and data information
The use of MADCAP is configured by entering the scope description in the MADCAP Scope Name field.
This field is disabled when the No Multicast option is selected. The scope description may be either of
the following formats:
<ScopeName>
where <ScopeName> is the name of a scope defined on the DHCP (if you are using the Microsoft
implementation of MADCAP). You should use this format if you have multiple MADCAP servers.
or
where
<MADCAP_ServerIP> is the IP address of a specific MADCAP server.
<MADCAP_ScopeIP> is the IP base address for the multicast defined on the DHCP (if you are using
the Microsoft implementation of MADCAP).
<TTL> (time to live) specifies the number of routers that multicast packets will pass through on
the network.
ActiveEfficiency URL - Here you configure the connection between Nomad and ActiveEfficiency for use
with the Single Site Download and Single Site PBA feature.
The Enable ActiveEfficiency checkbox must first be checked in order to make any configuration
changes.
Once enabled, you must provide a URL to a valid ActiveEfficiency instance in the ActiveEfficiency URL
field.
You can then go through the options for Single Site Download
Option Description
Disabled SSD will be turned off, the Nomad machine will take no part in the SSD
functionality on the site.
Consume SSD will be turned on but the Nomad machine will only fetch downloads
using SSD and will not serve downloads to other machines. This setting
should be used for sensitive servers or WinPE installations.
Provide SSD will be turned on but the Nomad machine will only provide downloads.
Consume + Provide SSD will be turned on and the Nomad machine will both provide and fetch
downloads using SSD.
Ready to Install the Program - Having entered all the appropriate configuration details click Install to
begin the installation.
Selecting the Typical option configures the installer to install all the components to the local computer.
Ready to Install the Program - Having entered all the appropriate configuration details click Install to
begin the installation.
where ABCD-1234-5678-8765-4321 is a place holder for a valid license key obtained from 1E.
Information
The Nomad executable will be installed either to "Program Files\1E\NomadBranch" or
"Program Files (x86)\1E\NomadBranch" and the appropriate path will be included on the
PATH variable. The ConfigMgr client is not aware of updates to the PATH until after a machine
reboot.
To install Nomad silently with Nomad FanOut and Single Site Download and features enabled, execute
the following example command-line:> msiexec /i NomadBranch.msi PIDKEY=ABCD-1234-5678-8765-
4321 SPECIALNETSHARE=64 SSDENABLED=3 PLATFORMURL="http://<server>/ActiveEfficiency" /qn
where "SpecialNetShare=64" enables Nomad Fanout and "SSDEnabled=3" along with PlatformURL
information enables Single Site Download feature. "<server>" in the PlatformURL is a place holder for the
hostname/FQDN of a valid ActiveEfficiency Platform server.
The list of available command-line switches can be seen in Installer Switches.
Uninstall Nomad
When uninstalling Nomad you should take the following points into account:
Before uninstalling NomadBranchAdminUIExt.msi, NomadBranchAdminUIExt2012.msi or
NomadBranchTools.msi you will need to close the Configuration Manager Admin Console.
If you are using the Nomad Download Monitor, you should uninstall this prior to Nomad itself.
Before uninstalling the Nomad service you should ensure that there are no running jobs using
Nomad.
To uninstall Nomad use the Add/Remove Programs applet in the Control Panel.
Information
Files which have been retained in the Nomad cache will not be deleted when Nomad is
uninstalled. This is usually a good idea as any .msi files in the Nomad cache may be
required for repair at some point. These must be deleted manually or by running
CacheCleaner.exe -deleteall prior to uninstalling Nomad.
License Nomad
Nomad and Nomad Multicast must be configured with their own unique license key. Please contact Sales
to obtain any keys. Nomad and Nomad Multicast can be licensed in the following ways.
Using Windows Installer You can enter a valid license key in the interactive Windows Installer setup
interactively wizard when prompted.
Evaluation licenses If you leave the License Key field blank, the product will be installed with a
time limited license for evaluation purposes only. This will give you full
functionality, including Multicast, for 30 days from the date of initial
installation. If you require an extension to your evaluation period, please
contact 1E Sales.
Using the Windows Include the property PIDKEY=<License Key> on the Windows Installer
Installer command-line command-line.
For example, to register the Nomad executable and service you would run the
following command:
Using the Nomad You can also relicense the product from the command-line:
command-line
> NomadBranch.exe -relicense=ABCD-1234-5678-8765-4321
Silent Installation
The following example shows how to silently install the Nomad Download Monitor in basic mode:
The following example shows how to silently install the Nomad Download Monitor in advanced mode:
Property Description
UI Sets the mode for the Nomad download monitor. This may be set to one of
the following values:
Value Description
Prerequisites
The prerequisites for installing the ConfiMgr Admin Console GUI extensions are described here.
Installing NomadBranchTools.msi
The only option when running NomadBranchTools.msi is to read and accept the license agreement
before continuing.
Tools Description
Upgrading ConfigMgr
Note
If you upgrade ConfigMgr 2012 to ConfigMgr SP1 after installing the ConfigMgr Admin Console GUI
extensions you will need to reinstall the extensions as the upgrade overwrites the osdinjection.xml
and TaskSequenceProvider.mof files.
Note
#pragma namespace(\\\\.\\root\\SMS\\site_%SITECODE%)
3. Whenever changes are made to a WinPE Boot Image and distribution points are updated, the
OSDInjection.xml controls which files get injected into the boot wim. This file needs to be
updated on the remote SMS Providers to ensure the Nomad binaries are also replaced.
Locate the OSDInjection.xml on the remote provider server (typically located in
C:\SMSPROV\bin\x64\osdinjection.xml)
<File name="NBCacheActions.exe">
<Destination>sms\bin\i386</Destination>
<LocaleNeeded>false</LocaleNeeded>
<Source>bin\i386</Source>
</File>
<File name="NomadBranch.exe">
<Destination>windows\system32</Destination>
<LocaleNeeded>false</LocaleNeeded>
<Source>bin\i386</Source>
</File>
<File name="NomadPackageLocator.exe">
<Destination>sms\bin\i386</Destination>
<LocaleNeeded>false</LocaleNeeded>
<Source>bin\i386</Source>
</File>
<File name="SMSNomad.exe">
<Destination>windows\system32</Destination>
<LocaleNeeded>false</LocaleNeeded>
<Source>bin\i386</Source>
</File>
<File name="SnoItfPS.dll">
<Destination>windows\system32</Destination>
<LocaleNeeded>false</LocaleNeeded>
<Source>bin\i386</Source>
</File>
<File name="TSEnv2.exe">
<Destination>sms\bin\i386</Destination>
<LocaleNeeded>false</LocaleNeeded>
<Source>bin\i386</Source>
</File>
b. Place the following under <Architecture imgArch="x64"> Find the line <FileList
source="SCCM"> and add:
<File name="NBCacheActions.exe">
<Destination>sms\bin\x64</Destination>
<LocaleNeeded>false</LocaleNeeded>
<Source>bin\x64</Source>
</File>
<File name="NomadBranch.exe">
<Destination>windows\system32</Destination>
<LocaleNeeded>false</LocaleNeeded>
<Source>bin\x64</Source>
</File>
<File name="NomadPackageLocator.exe">
<Destination>sms\bin\x64</Destination>
<LocaleNeeded>false</LocaleNeeded>
<Source>bin\x64</Source>
</File>
<File name="SMSNomad.exe">
<Destination>windows\system32</Destination>
<LocaleNeeded>false</LocaleNeeded>
<Source>bin\x64</Source>
</File>
<File name="SnoItfPS.dll">
<Destination>windows\system32</Destination>
<LocaleNeeded>false</LocaleNeeded>
<Source>bin\x64</Source>
</File>
<File name="TSEnv2.exe">
<Destination>sms\bin\x64</Destination>
<LocaleNeeded>false</LocaleNeeded>
<Source>bin\x64</Source>
</File>
Nomad Cache
The following installer properties relate to configuring the Nomad Cache:
AUTHENTICATEDUSERS, MAXCACHESIZEMB, NOHARDLINK, NOMADINHIBITEDADSITES,
NOMADINHIBITEDSUBNETS, PERCENTAVAILABLEDISK
Status Message
MAXSTATUSFREQUENCY, STATUSMSGEVENTS
Multicast
MADCAPSCOPE, MAXPACKETSPERSECOND, MULTICASTSUPPORT
ASSUMEDLINKSPEED Specifies a value in bits per second to be used for the link speed
calculations at the beginning of a download. This value should only be
modified if requested by 1E support.
When this value is set to 0, an unreliable IPv4 ping test is performed
to gauge the bandwidth of the WAN link before starting a download.
By default the value is set to 100 so as to disable the ICMP test and
calculate the end-to-end bandwidth based on actual data blocks.
BLOCKSIZE Integer defining the size of each block of data copied by Nomad in
bytes. Each file is downloaded from the package source folder in
segments of this size.
Must be between 4096 to 65536 inclusive. We recommend
32768 as a minimum amount, and it must be set to this value
when using multicast.
Attention
CACHEPATH Location of local package cache. The path will be created if it does not
exist.
If the drive letter does not exist, and it is not possible to create the
specified path, %TEMP% will be used instead.
Default values are dependent on OS.
C:\ProgramData\1E\NomadBranch
CERTISSUER Defines the client certificate issuer. For use with internet facing
clients, for example, CERTSVR01
CERTSUBJECT Defines the client certificate subject. For use with internet facing
clients, for example, machine.ashby.com
Configure either CERTISSUER or CERTSUBJECT.
The installer property must be set to sum of the integer values for the
required bits.
For example, the following installer command-line would disable hash
value checking (1) and DelegatedLSZ checks and errors (131072):
The default value for this entry is 0x09 (9), which is a combination
of 0x01 (Minimal logging) and 0x08 (Registry changes).
The installer property must be set to sum of the integer values for the
required bits.
For example, the following would set all three supported levels of
debug on the NomadBranch.msi installer command-line:
DOWNLOADTIMEOUT Sets the timeout in seconds after which a job will be canceled if the
download has not been successful.
If a value greater than zero is set the download timeout will either use
this or the ConfigMgr setting depending on which is the smaller value.
When the timeout has been reached the job Package download will be
canceled and a success will be sent to the ConfigMgr client with the
ERROR_MAXDURATION timeout error sent as the Package status
message.
The default for the timeout is 0 which sets the download to use the
ConfigMgr setting, which has a default of 28 days.
For example, the following would set Nomad to the default value on
the NomadBranch.msi installer command-line:
ENFORCEQUOTAS This value determines whether Quotas are enforced on the PBA share.
Setting the value to 0x1 limits the access to the share using disk
quotas.
HAACKTIMEOUTMINS This value sets a timeframe in minutes within which if the machine
running the Task Sequence does not receive an acknowledgement
message from the PBA Host performing the additional backups, the
PBA-HA Task Sequence step will fail.
This setting applies to synchronized backups only and the PBA Host
sends the acknowledgement messages back to the machine running
the Task Sequence approximately every 5% of the synchronized copy.
INSTALLDIR Location of Nomad. The path will be created if it does not exist. This
installation directory should be added to the path or included in the
ConfigMgr Program command line.
LOGNAME 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.
The log file name is set by two properties in the installer, LOGNAME
sets the log file name component and LOGPATH sets the path
component.
LOGPATH 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.
C:\ProgramData\1E\NomadBranch\LogFiles\NomadBranch.log
The log file name is set by two properties in the installer, LOGPATH
sets the path component andLOGNAME sets the log file name
component.
MAXALLOCREQUEST This value sets the maximum amount of space in MB that can be
requested by each PBA client.
MAXCACHESIZEMB Sets the value in bytes for the maximum size the cache is allowed to
grow to, before automatic cache cleaning starts to take place.
Attention
This setting is provided for backwards compatibility only. It is
recommended that PercentAvailableDisk is used for future
implementations.
MAXCONCURRENCY This value sets the maximum number of concurrent PBA sessions that
may be in use on the host.
MAXLOGSIZE Size (in bytes) of Nomad log file. When this size is reached, the file is
renamed with a .LO_ extension and a new .LOG file is created. The
.LO_ file is overwritten each time.
MAXIMUMMEGABYTE This value sets the maximum amount of space in MB that can be used
for all the PBA shares combined on the host.
Setting this value to a non-zero value turns the PBA feature on.
MAXPACKAGEFAST Maximum size (in bytes) of a package that Nomad will attempt to
cache on a Fast LAN (>500 kbps) connection.
This registry entry works in conjunction with the
RunUncachedPermittedFastLAN registry entry.
Attention
This setting is only used in stand-alone mode and does not work
with Configuration Manager.
MAXPACKAGERAS Maximum size (in bytes) of a package that Nomad will attempt to
cache on a RAS (<55 kbps) connection.
MAXPACKAGESLOW Maximum size (in bytes) of a package that Nomad will attempt to
cache on a Slow LAN (55-500 kbps) connection.
MAXPACKETSPERSECOND Used to set the rate at which Multicast will proceed - if packets are
sent too fast then machines will drop packets and Multicast will not be
affective - too slow and Multicast will only work slowly.
MAXSTATUSFREQUENCY This parameter sets the maximum frequency for transfer progress
status messages.
MADCAPSCOPE Configure the MADCAP scope for multicast. This may either of the
following formats:
Format Description
0.0.0.0,239.0.9.0,3
Note
The valid range for TTL is a number
between 1 and 255
Attention
All machines in a single branch must be configured using the same
value for this parameter.
0 no Multicast.
1 data Multicast. Selecting this option enables the
multicasting of data only (Package contents). Nomad control
communications will be broadcast as normal on the local
subnet. Select this option for standard functionality.
2 control Multicast. Selecting this option enables the
multicasting of control information only. This may be used if
there is more than one subnet in a single location to enable a
single Nomad master to be elected for all the subnets.
3 control and Data Multicast. Selecting this option enables
the multicasting of both data and control information. Select
this option if a branch has multiple subnets connected by high
speed routers.
NOHARDLINK Sets the use of hard links between the Nomad cache and the
ConfigMgr cache.
0 hard links will be used. The Nomad cache will link to the
ConfigMgr cache so only a single copy of a package is held
locally.
1 hard links will not be used. This results in the content
being double-cached
site1,site2,site3
10.2.0.0/16,192.168.9.0/24
Note
Only IPv4 subnets are supported, not IPv6.
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 NomadBranch.msi installer command-line:
PERCENTAVAILABLEDISK This sets a 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.
The value of the registry entry is not altered by using the
PercentAvailableDisk cache cleaner command-line switch, any
settings made there only apply for the duration of the command. If
you want to change the default maximum size for the cache you will
need to change this registry entry by hand.
The default value is 10. The cache will not grow such that less that
10% of total disk space is available.
The maximum value is 80. The cache will not grow beyond 20% of the
total available disk space.
This method for determining the maximum size of the cache is
provided as an alternative to MaxCacheSizeMB:
If PercentAvailableDisk has a value greater than zero set
its method will be used to control the cache size.
PERMITTEDLSZSHARES This enables increased security and is only used by the Nomad
Distribution Point agent. It contains a comma-separated list of
Package source locations. Nomad LSZ file generation requests will
only be completed if the content location is listed. If you are using
additional package source locations then you will need to manually
add these to this registry value.
PermittedLSZShares can incorporate wildcard characters to provide
flexible naming convention support.
The default value for this registry entry is:
SMSPKG*$,SMS_DP_SMSPKG*$
SMSPKGC$,SMS_DP_SMSPKGC$,SMSPKGD$,SMS_DP_SMSPKGD$
If you leave the registry value blank, no security checks upon package
source location are performed.
PERMITUNCACHED Determines where the download Package is run from under certain
conditions.
To ensure that the un-cached mode works correctly you will need to
set the Program Environment Properties to include the Drive
mode/Require drive letter option.
This works in conjunction with MaxPackageSizeFastLAN which will
need to be set to a value greater than zero.
Attention
This should not be set to 1 if you are using Nomad with
Configuration Manager.
PIDKEY Set the Nomad license key. This value should be set to a valid license
key obtained from Sales.
POSTCOMPLETETIMEOUTHOURS This value sets the duration in hours after which PBA share will be
deleted from the host. This value only applies to an PBA share after
the NMDS_COMPLETE command has been run for it, otherwise the
PreCompleteTimeoutHours value will apply.
The intention is that an incomplete share will only be available for a
short period of time, as defined by the PreCompleteTimeoutHours
value; once the NMDS_COMPLETE command has been sent it will be
fixed for this longer time.
When the share is deleted the folder and associated user will be
removed.
PRECOMPLETETIMEOUTHOURS This value sets the duration in hours after which PBA share will be
deleted from the host. This value only applies to an PBA share after
the NMDS_POLL command has been run for it, but not the
NMDS_COMPLETE command.
The intention is that an incomplete share will only be available for a
short period of time, as specified in this value.
When the share is deleted the folder and associated user will be
removed.
RECYCLEDPDELAY Sets the delay in seconds for retrying from the first DP after all the
available DPs have been cycled through.
Must be between 600 and 3600 inclusive
C:\SMSSIG$
SPECIALNETSHARE This parameter is used to set multiple special feature options for
Nomad. It is possible to set more than one option at the same time by
combining the bit values.
So to use the Machine 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).
The installer property must be set to sum of the integer values for the
required bits.
For example, to use the Machine 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 NomadBranch.msi installer command-
line:
SSDENABLED This registry entry determines the status of the Single Site Download
(SSD) feature. It is configured by the installer and defaults to a value
of 0 which sets the SSD feature off.
To turn on SSD post-installation for normal usage you will need to set
both Bit 0 and Bit 1 (0x3).
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.
SSPBAENABLED Configures the use of the Single Site option for PBA data stores.
Value Description
Note
To turn Single Site PBA feature on you will also need to set
SSDEnabled=0x3 in order to enable ActiveEfficiency integration
required for Single Site PBA feature to work.
STATUSMSGEVENTS Set to a 64-bit value that determines which Nomad events are
reported via ConfigMgr status messages. The full list of events is listed
in Nomad status message events .
WLANBLIPSECS Sets a time for disabling a wireless LAN when a wired LAN connection
becomes available. To enable this feature set the value for
WLanBlipSecs to 20 seconds or more.
3. Install the latest version of Nomad Tools on the site servers and latest version of Nomad Admin
UI Extensions on machines that have the ConfigMgr Console installed
4. Update the source of the ConfigMgr Package / Application used to deploy Nomad on clients with
the latest version of Nomad and re-deploy to the clients
5. Check the Nomad installer logs and Nomad client logs
6. In Task Sequences, check the Install Package / Application step used to deploy Nomad is using
the updated Nomad Package / Application
7. Reapply the Nomad steps used in Task Sequences to ensure latest updates in the Nomad custom
Task Sequence actions are being reflected
8. Update the new license key in "Install and configure Nomad in WinPE" Task Sequence step
9. Update Distribution Points for any relevant boot images
10. Distribute a test package to a subset of clients to ensure Nomad downloads the package
To upgrade from versions earlier than 4.1.100 please contact 1E support for details of the upgrade
process.
Upgrading ConfigMgr
When upgrading ConfigMgr you may need to restart the Nomad service:
Note
If you upgrade the ConfigMgr 2007 client to ConfigMgr 2012 client or the ConfigMgr 2012 RTM client
to ConfigMgr 2012 SP1 client you will need to restart the Nomad service otherwise Nomad will not be
used as the alternate download provider for downloading content.