Summary

How to install, uninstall, licence repair and upgrade Nomad.

On this page

In this section

Installing the Nomad client interactively

A step-by-step guide to interactively installing the Nomad client.

Installing the Nomad client using Configuration Manager

A step-by-step guide to installing the Nomad client to all Configuration Manager client machines using Configuration Manager.

Installing the Configuration Manager console extensions

A step-by-step guide to installing the Configuration Manager console extensions.

Installing Nomad tools for operating system deployment

A step-by-step guide to installing the Nomad OSD tools.

Installing the Nomad download monitor

A step-by-step guide to interactively installing the Nomad download monitor.

Post-installation tasks

Post-installation tasks that may be necessary to ensure that Nomad will work correctly in your environment.

Upgrading Nomad

A step-by-step guide to upgrading 1E Nomad.

ActiveEfficiency

Although not a requirement for generally using Nomad, ActiveEfficiency must be installed and available before you can use certain Nomad features. It is therefore highly recommended that the latest version of ActiveEfficiency is installed before installing Nomad. The following Nomad features require ActiveEfficiency:

  • Single-site download
  • Single-site peer backup assistant
  • WakeUp integration (also requires version 7.2.500 of NightWatchman Management Center and WakeUp Servers)
  • Nomad Pre-caching
  • Nomad Download Pause (also requires Tachyon 3.3 or later)
  • Nomad Dashboard
 

If you plan to use any of these Nomad features you must install or upgrade to the latest version of ActiveEfficiency first, as the Nomad clients need to refer to the location of ActiveEfficiency during deployment.

Nomad installers

Before you install Nomad, ensure that you have read and met the Prerequisites. When you download and extract the Nomad zip file, you will find the following:

  • NomadBranch.msi – installer for 1E NomadBranch for clients on a 32-bit platform architecture
  • NomadBranch-x64.msi – installer for 1E NomadBranch x64 for clients on a 64-bit platform architecture and on distribution points
  • NomadBranchAdminUIExt.msi – installer for 1E Nomad Branch Admin Extensions on Configuration Manager consoles
  • NomadBranchTools.msi – installer for 1E NomadBranch Tools (for OSD) on Configuration Manager site servers
  • NomadBranchGui.msi – located in the DownloadMonitor folder, installer for a useful tool for troubleshooting Nomad activity. It has no dependency on Configuration Manager.
  • PostADSitesandSubnets.psl – located in the scripts folder, a collection of sample PowerShell scripts for populating the ActiveEfficiency database with Nomad features (single-site download, high-availability peer backup assistant and WakeUp integration)
  1. Configuration Manager clients may either be 32- or 64-bit so when you install Nomad components, ensure you use the corresponding installer for the client or distribution points.
  2. Configuration Manager Console should not be running when NomadBranchAdminUIExt and NomadBranchTools are installed/upgraded.

We recommend you install Nomad in the following order:

  1. On the Configuration Manager Consoles install the Configuration Manager Console extensions.
  2. On the Configuration Manager Distribution Points install the Nomad client.
  3. On all the Configuration Manager clients install the Nomad client.
  4. If you are planning to take advantage of Nomad's OSD features, install Nomad Tools for OSD on the Configuration Manager primary sites (and extra SMS Providers, if they exist).

By default, IIS is configured to prevent certain file types from being downloaded. You will need to allow Nomad to download all content as it does not use the Configuration Manager workaround to bypass this Microsoft security feature. We recommend you read IIS request filtering which describes how to update the filtering on all distribution points to enable Nomad to function as expected. You might also want to configure any virus checkers running on your network to make exceptions for the Nomad executables and support files.

Installing Nomad in unattended mode

  • You can install Nomad (with all its features) in unattended mode by running:

    msiexec.exe /i NomadBranch.msi PIDKEY=ABCD-1234-5678-8765-4321 /qn


    where ABCD-1234-5678-8765-4321 is your license key. The Nomad executable is installed to Program Files\1E\NomadBranch and the path is included in the PATH variable. The Configuration Manager client is not aware of updates to the PATH variable until after a machine reboot.

  • If you do not want to take advantage of the benefits of the Client Health features, run:

    msiexec /i NomadBranch.msi /quiet ENABLECLIENTHEALTH=0
  • If you had inadvertently installed the Client Health feature, but do not want to benefit from it, you can remove it with:

    msiexec /i NomadBranch.msi /quiet REMOVE=Clienthealth
  • If you did not install the Client Health feature but want to benefit from it, run:

    msiexec /i NomadBranch.msi /quiet ENABLECLIENTHEALTH=1 ADDLOCAL=Clienthealth
  • Here is another example if you want to install Nomad with its FanOut and SSD features enabled:

    msiexec.exe /i NomadBranch.msi PIDKEY=ABCD-1234-5678-8765-4321 SPECIALNETSHARE=64 SSDENABLED=3 CONTENTREGISTRATION=1 PLATFORMURL="http://<server>/ActiveEfficiency" /qn
    • SPECIALNETSHARE=64 enables FanOut
    • SSDENABLED=3 along with CONTENTREGISTRATION=1 and PLATFORMURL enables SSD
    • Where <server> in PLATFORMURL is the hostname/FQDN of your ActiveEfficiency server

The list of command-line arguments you can use to install Nomad in unattended mode is detailed in installer properties.

Uninstalling Nomad

If you are uninstalling Nomad, we recommend you do it in the following order:

  1. Close the Configuration Manager Admin Console before you uninstall the Configuration Manager Console extensions and Nomad Tools for OSD.
  2. If you have installed the Nomad download monitor, uninstall this before Nomad.
  3. Ensure there are no running jobs before you uninstall the Nomad service.
  4. Content in the cache may not be automatically deleted when you uninstall Nomad (and some MSI-based installations and files may be required for future application repairs etc). You can delete these files/folders manually or run CacheCleaner.exe -deleteall before you uninstall Nomad.
  5. Uninstall Nomad from the Add/Remove Programs applet in Control Panel.

Licensing Nomad

Nomad and Nomad multicast are licensed with different keys. If you do not have the respective production license, contact our Sales division for one. You can license Nomad and Nomad multicast by:

Licensing methodsNotes
Using installer interactivelyEnter a valid license key in the interactive installer setup wizard when prompted.
Evaluation licenses

If a license key is not provided during installation, Nomad installs with a 30-day evaluation license where you have full functionality, including multicast. If you need an extension to your evaluation, please contact our Sales division.

Using the installer command-line

To install a license on the command-line:

msiexec /i NomadBranch.msi PIDKEY=ABCD-1234-5678-8765-4321 /qn

where ABCD-1234-5678-8765-4321 is your license key.

Using the Nomad command-line

To relicense Nomad from the command-line:

NomadBranch.exe -relicense=ABCD-1234-5678-8765-4321

where ABCD-1234-5678-8765-4321 is your license key.

Handling license expiry gracefully

Nomad v6.3 and above can now be configured to pass back responsibility for downloading content to the Configuration Manager Agent when the Nomad license has expired - thereby minimizing the potential impact on downloads. To implement this feature you need to remove the 0x2062 (Nomad return code for unlicensed version of Nomad) entry from SuccessCodes in the NomadBranch registry settings.

Repairing Nomad

In certain circumstances, it may be necessary to repair the Nomad service – this may occur if Nomad program files have been inadvertently deleted, 

To repair Nomad:

  1. Re-run NomadBranch.msi or NomadBranch-x64.msi over an existing installation.
  2. Choose the Repair option.

Upgrading Nomad

When upgrading, we recommend that you follow these general points:

  1. Upgrades are supported from Nomad 4.1.100
  2. Update all the site servers and distribution points first before updating Nomad running on the clients to avoid known compatibility issues
  3. Update all versions of Nomad running on a single subnet at the same time to avoid having hybrid installations where multiple versions are installed on a subnet and making it difficult to troubleshoot issues
  4. If you are running an earlier version of Nomad and want to upgrade to a later version, please contact 1E support for assistance
  5. If you do not want the benefits of the client health feature when you upgrade, use the command-line:

    msiexec /i NomadBranch-x64.msi /quiet ENABLECLIENTHEALTH=0

If you are upgrading Nomad across your entire network, we recommend you follow these steps (if possible the upgrade should be done in a lab or sandbox environment first):

  1. If you are upgrading to a major release, contact 1E Support for a new license key.
  2. Install the latest version of Nomad Tools on the site servers.
  3. Install the latest version of Nomad Console extensions on machines where the Configuration Manager Console is installed.
  4. Install the latest version of Nomad on Configuration Manager DPs (one at a time and complete the Nomad upgrade on all clients that are managed by that distribution point, subnet by subnet)
  5. Update the source of the Configuration Manager package/application used to deploy Nomad on clients with the latest version and re-deploy to the clients. Check the Nomad installer logs and Nomad client logs.
  6. Distribute a test package to a subset of clients to ensure Nomad downloads the package.
  7. In task sequences, check the Install Package/Application step used to deploy Nomad is using the updated Nomad package/application.
  8. Re-apply the Nomad steps used in task sequences to ensure the latest updates in the custom task sequence actions are being reflected.
  9. Update the new license key in Install and configure Nomad in WinPE task sequence step.
  10. Update distribution points for any relevant boot images.

Notes on upgrading Configuration Manager

If you upgrade the Configuration Manager client to a later version, you will need to restart the Nomad service or it will not be used as the alternate download provider for content.