Skip to main content

1E 8.1 (on-premises)

NomadPackageLocator.exe command-line switches

NomadPackageLocator.exe is used by the Nomad custom task sequence actions, we recommend that these are used to perform the appropriate functions in preference to the command-line, but details are provided here for reference purposes.

It is installed as part of Nomad. It is also available in Nomad OSD tools in order to include in WinPE images so that Nomad can be used in OS Deployments. Please refer to Installing Nomad Branch Tools.

The format of the NomadPackageLocator command-line is:

NomadPackageLocator.exe [options]
Nomad Package Locator general command-line switches

The following table describes the general NomadPackageLocator.exe command-line switches:

Switch

Default value

Description

Debug

Enables extra logging.

FailOverToDP

Points to the distribution point if the required package cannot be found pre-cached in any local Nomad clients.

ForceNomadMachine

Name of a specific Nomad client whose cache you want to use. This prevents NomadPackageLocator from polling for a Nomad client whose cache contains the content.

HideErrorDialog

Suppresses error messages during the image deployment task sequence for packages that cannot be located in a Nomad cache.

HTTP

Uses HTTP to download content if it is not available on the local subnet.

Port

1779

Sets the communications port.

RemoveHttpLocations

If used on the NomadPackageLocator.exe command-line, the HTTP locations will be cleared from the task sequence, ensuring that the content is downloaded from Nomad peers on the local subnet.

RequireNomad

If used on the NomadPackageLocator.exe command-line, Nomad is used for the referenced packages.

If the Nomad Package Locator fails to locate all the referenced packages, it generated an error, which is used to terminate the task sequence.

Timeout

3

Maximum wait time (in seconds) between messages. Applies to each package listed in the TS environment.

Nomad Package Locator NMDS command-line switches

The NMDS command are used by the Nomad Peer Backup Assistant (PBA) feature. These commands invoke NomadBranch.exe to do most of the work, however NomadPackageLocator.exe is the recommended command-line interface to use because it uses and sets crucial task sequence variables.

All of the NMDS commands have corresponding custom task sequence action dialogs, and these should be used in preference to creating command line actions.

Switch

Default value

Description

NMDS_COMPLETE

The NMDS_COMPLETE argument is available on the NomadPackageLocator.exe (recommended) or NomadBranch.exe service argument-line. It indicates that all user data has been copied to the PBA share and the connection can be closed. When run, it disconnects from its associated share and fixes its contents for the duration defined in the Nomad PostCompleteTimeoutHours registry value on the device where the share is hosted. It is only for use within a task sequence.

NMDS_DELETE

The NMDS_DELETE argument is available on the NomadPackageLocator.exe (recommended) or NomadBranch.exe service argument-line. When run, it deletes the share, contents and user associated with the shared cache. It is only for use in a task sequence.

NMDS_FIND

The NMDS_FIND argument is available on the NomadPackageLocator.exe (recommended) or NomadBranch.exe service argument-line. When run, it locates and connects to the share associated with it. It is only for use in a task sequence.

NMDS_HA

The NMDS_HA argument is available on the NomadPackageLocator.exe (recommended) or NomadBranch.exe service argument-line. It creates additional backup copies of the user data that has been copied to the PBA share, so it must be run after the share has been closed using NMDS_COMPLETE. It is only for use within a task sequence.

NMDS_POLL

The NMDS_POLL argument is available on either the NomadPackageLocator.exe (recommended) or NomadBranch.exe service command-line. When run, it places a request for a network share and size associated with it. It must only be used within a task sequence.