Summary

A step-by-step guide to installing the Nomad OSD tools, also known as Nomad Branch Tools.The Nomad OSD tools are:

  • NBCacheActions.exe – performs specific functions on the Nomad cache

  • NomadBranch.exe – the Nomad service

  • NomadPackageLocator.exe – locates content in local Nomad caches

  • SMSNomad.exe – the Nomad executable

  • SMSTSNomad.exe – Nomad executable used in task sequences

  • SnoItfPS.dll –  the Nomad Enterprise COM/DCOM interface

  • TSEnv2.exe – sets environment variables in task sequences

Each of the executables also has a corresponding .pdb file.

On this page:

Installing the Nomad OSD tools

The tools required for integrating Nomad with OSD task sequences in Configuration Manager are installed by running NomadBranchTools.msi from an elevated command prompt.

To install Nomad tools for operating system deployment (OSD):

  1. Download the Nomad Branch software ZIP file from our Support portal.
  2. Extract  NomadBranchTools.msi  from the downloaded ZIP file.
  3. Start a Command Prompt with elevated rights, navigate to the location where you extracted the  NomadBranchTools.msi  and run it with the following command-line:

    > msiexec /i NomadBranchTools.msi /l*v NomadBranchToolsInstall.log REBOOT=REALLYSUPPRESS
  4. On the Welcome screen, click Next.
  5. Accept the license agreement and click Next.
  6. On the Ready to Install the Program screen, click Install.
  7. If a User Account Control dialog pops up, click Yes.
  8. Click Finish when the installation is done.

The tools must be installed on all Site servers (except Secondary) and on all SMS Provider servers.

Nomad 7.0 (and later) no longer requires the post-installation configuration steps necessary in previous versions of Nomad when installing on SMS Provider servers are remote from the Configuration Manager site server.


In this version of Nomad you need to install and uninstall the Nomad OSD Tools using an elevated command prompt.

Verifying that the tools have been installed

To verify that the tools have been successfully installed:

  1. Open the Configuration Manager console.
  2. Open the Software Library workspace, expand the Operating Systems node and expand Task Sequences.
  3. Choose an existing Task Sequence or create a temporary one. Right-click on an existing Task Sequence and click Edit.
  4. In the Task Sequence Editor, click Add – note the new Nomad tasks that can be added to a task sequence.
  5. Click Cancel to close the Task Sequence editor without saving any changes.
  6. Browse to C:\Program Files\Microsoft Configuration Manager\OSD\bin\i386 and \x64 folders where you will find the following files: 

    • NBCacheActions.exe – performs specific functions on the Nomad cache

    • NomadBranch.exe – the Nomad service

    • NomadPackageLocator.exe – locates content in local Nomad caches

    • SMSNomad.exe – the Nomad executable

    • SMSTSNomad.exe – Nomad executable used in task sequences

    • SnoItfPS.dll –  the Nomad Enterprise COM/DCOM interface

    • TSEnv2.exe – sets environment variables in task sequences

    Each of the executables also has a corresponding .pdb file.

    To list the files together, you can sort by Date modified. Or you can add sort columns for Company or Product name.

  7. Open C:\Program Files\Microsoft Configuration Manager\bin\x64\osdinjection.xml in Notepad. 

    This manifest defines the files that are to be added into the Windows PE boot image when it is updated on a distribution point. The additional tools are added to this manifest, ensuring that they are included in all boot images that are updated on a distribution point from this point on.

If you upgrade Configuration Manager after installing the Nomad OSD tools, you will need to reinstall them as the Configuration Manager upgrade overwrites the osdinjection.xml and TaskSequenceProvider.mof files that are updated by Nomad OSD tools.

Updating boot images

After installing the Nomad tools into your Configuration Manager environment, you must update any existing boot images that have been distributed to a Distribution Point or Distribution Point Group so that the tools will be included in those images.

To do this:

  1. In the Configuration Manager Console, navigate to the Software Library → Operating Systems → Boot Images node.
  2. Select an existing boot image.
  3. Right-click the boot image and from the context menu, choose Update Distribution Points.
  4. On the Update Distribution Points Wizard, click Next.
  5. Verify that the wizard completed successfully and click Close. The selected boot image will now contain the latest Nomad Tools for OSD.
  6. Repeat this process for any other boot images that are used.

Updating boot images on DPs

Uninstalling the Nomad OSD tools

To uninstall Nomad tools for operating system deployment (OSD):

  1. Start a Command Prompt with elevated rights, navigate to the location where you extracted the  NomadBranchTools.msi  and run it with the following command-line:

    > msiexec /x NomadBranchTools.msi /l*v NomadBranchToolsUninstall.log REBOOT=REALLYSUPPRESS
  2. On the Welcome screen, click Next.
  3. Click Finish when the uninstallation is done.