Contents
Installing the 1E Client by command-line
In most cases the 1E Client will be installed in quiet mode from the command-line using a software deployment tool such as Configuration Manager.
Because the expected length of the 1E Client installer command-line is likely to exceed the limit imposed by Configuration Manager you will need to use MST transform file(s) for this to work. Please contact your packaging team if you need help to create transform files.
The 1E Client Deployment Assistant 8.0 (CDA) is designed to help install Windows versions of 1E Client and other 1E agents using Configuration Manager. It includes template transform files for each combination of client/agent for 32 and 64-bit platforms, and automatically creates collections and deployments in Configuration Manager, so that you only need to populate the collections.The installer properties listed on this page are for the options visible in the interactive installer above:
Additional installer properties are available for:
- Tachyon client settings
- Nomad client settings
- PXE Everywhere Agent settings
- Shopping client settings
- WakeUp client settings
Some command-line examples are also provided below.
1E Client
The following are common settings for the 1E Client.
Installer property | Description |
---|---|
INSTALLDIR | Sets the installation folder. This value is not stored in the 1E Client configuration file. This value is stored as InstallationDirectory in the Windows registry under HKLM\SOFTWARE\1E\Client\ and must not be changed. Some client modules that run on Windows store their registry settings under their own keys in HKLM\SOFTWARE\1E. This installer property is for Windows only. |
Tachyon client
When installing the full 1E Client (to be used with the Tachyon platform), the following are typical installer properties to use. Additional installer properties are described on the Tachyon client settings page.
As with other Windows installers, uninstallation will leave behind any files, folders and registry entries that were created after installation.
Installer property | Description |
---|---|
BACKGROUNDCHANNELURL | If Tachyon and Nomad client features are not required then the connection to Tachyon Platform is not required, and both Switch and BackgroundChannelUrl settings must be set to none when doing a non-interactive (silent/quiet) install using installer properties on a command-line or in a MST transform file. When doing an interactive install then you must uncheck the Enable Tachyon checkbox. Tachyon client features are not required if the 1E Client is being installed only to support PXE Everwhere, Shopping, or WakeUp. They are only required for Nomad if using Nomad features of the Tachyon Platform. To connect to the Tachyon platform then BackgroundChannelUrl will have one or more entries in the format: BackgroundChannelUrl=https://<BackgroundChannelServer>:<BackgroundChannelPort>/Background/ <BackgroundChannelServer> is the DNS Name FQDN of the server, which is the same as:
<BackgroundChannelPort> is the Port number, which is the same as:
In systems with multiple server and multiple DNS Names, there will be multiple entries on one line using a semi-colon (;) as the delimiter between entries. For example: BackgroundChannelUrl=https://tachyon.acme.local:443/Background/;https://tachyon.acme.com:443/Background/ |
SWITCH | If Tachyon and Nomad client features are not required then the connection to Tachyon Platform is not required, and both Switch and BackgroundChannelUrl settings must be set to none when doing a non-interactive (silent/quiet) install using installer properties on a command-line or in a MST transform file. When doing an interactive install then you must uncheck the Enable Tachyon checkbox. Tachyon client features are not required if the 1E Client is being installed only to support PXE Everwhere, Shopping, or WakeUp. They are only required for Nomad if using Nomad features of the Tachyon Platform. To connect to the Tachyon platform then Switch will have one or more entries in the format: Switch=<SwitchName>:<SwitchPort> <SwitchName> is the DNS Name FQDN for one or more Switches. This is the same as the following except in a custom configuration where the Switch is installed on its own:
<SwitchPort> is the Port number, which has default value of 4000. Any other port number is used only in a complex configuration if advised by 1E. In systems where there are multiple DNS Names, there will be multiple entries using a semi-colon (;) as the delimiter between entries. For example: Switch=tachyon.acme.local:4000;tachyon.acme.com:4000 |
DEFAULTSTAGGERRANGESECONDS | Some operations (including HTTPS downloads from the BackgroundChannel) are randomly time-staggered across Tachyon clients. This property dictates the upper-limit on the default randomization period in seconds. Range is 0 to 3600. Default is 300. Use 0 to instruct Tachyon client not stagger operations by default. Do not change this value unless advised by 1E. Only use 0 or a low value in systems that support less than 500 clients. This setting is not used for HTTPS downloads from the BackgroundChannel if NomadContentDownloadEnabled is true, because Nomad does the bandwidth management. |
The BACKGROUNDCHANNELURL and SWITCH properties are mandatory. If you want to install the 1E Client with the 1E Client modules for Shopping or WakeUp enabled, and the full Tachyon Platform infrastructure has not been installed, you should set both of these properties to none.
However, note that during an upgrade of Tachyon Agent, you must enable the connection to the Tachyon Platform, therefore you must define the BACKGROUNDCHANNELURL and SWITCH properties.
Disabling the connection to the Tachyon Platform is presently only possible for new installations of the 1E Client. If you wish to disable the connection following an upgrade, you must reconfigure the 1E Client once the upgrade has completed. For more detail please refer to Reconfiguring the 1E Client after installation below.
Nomad client
When installing the 1E Client to support Nomad 7.0 or later, the following installer properties are available. Additional installer properties are described on the Nomad client settings page.
As with other Windows installers, uninstallation will leave behind any files, folders and registry entries that were created after installation.
Installer property | Description |
---|---|
MODULE.NOMAD.ENABLED | Nomad is used to support efficient content download for Configuration Manager and Tachyon. For Tachyon, the Nomad content download feature is enabled by default. If Nomad is enabled, when the 1E Client starts it will upgrade any previous installation of the NomadBranch client. |
MODULE.NOMAD.PLATFORMURL | This installer property is no longer supported. The Nomad installer determines the location of servers from the Tachyon client. Specifically, it communicates with Response Stack Switches and Background Channel. |
MODULE.NOMAD.CONTENTREGISTRATION | Set to 1 to enable the Nomad client to act as a content provider across subnets when using Single Site Download. |
MODULE.NOMAD.SSDENABLED | Set to 1 to enable Single-site download, which requires Tachyon Platform with Content Distribution. If you enable both Single-Site Download and Content Registration then Nomad will make its own content available to other Nomad peers. If you enable Single-Site Download but not Content Registration then Nomad will be able to fetch downloads from registered peers on other subnets but will not make its own content available. |
MODULE.NOMAD.WAKEUPENABLED | Set to 1 to enable WakeUp integration, which requires an ActiveEfficiency Server. If you enable WakeUp integration but not Single Site Download, any attempt to wake-up peers with particular content will only be on the local subnet. If Single Site Download is also checked, Nomad will try to wake peers with particular content in neighboring subnets on the site if peers on the local subnet do not wake. |
MODULE.NOMAD.USEFIPS | Set to 1 to configure the Nomad module to use FIPS encrypted communications. You must ensure that Nomad is configured with the same FIPS encryption setting on all your 1E Clients. |
Previous versions of Nomad required a license key (installer property PIDKEY). 1E Client and the Nomad client module do not require a license key. Even so, you must adhere to the terms of your license agreement.
PXE Everywhere Agent
When installing the 1E Client to support PXE Everywhere 4.0, 8.0 or later, the following installer properties are available.
Installer property | Description |
---|---|
MODULE.PXEEVERYWHERE.ENABLED | Set this property to true to enable the PXE Everywhere Agent client module. The default value is false. If enabled, when the 1E Client starts it will attempt to automatically remove any previous installations of PXE Everywhere Agent. |
MODULE.PXEEVERYWHERE.CONFIGSERVERURL | URL for the PXE Everywhere Central web service in the format: where |
MODULE.PXEEVERYWHERE.USEFIPS | You must use the same FIPS encryption setting on all PXE Everywhere Agents. Use of FIPS compliant encryption for communications.
|
MODULE.PXEEVERYWHERE.DHCPPORT | This installer property is set to 2067 if Enable DHCP Snooping support is checked during an interactive installation of the 1E Client installer. This is the UDP port on which the PXE Everywhere Agent will listen for PXE requests. If DHCP Snooping is not being used, then this port must be 67 (default), and you do not need to install Responders. When manually installing the PXE Everywhere Agent, if the DHCP Snooping option is enabled in the installer UI, the default port is changed from 67 (43 hex) to 2067 (813 hex). If the MODULE.PXEEVERYWHERE.DHCPPORT installer property is used to specify a port other than 67, the installer UI assumes the DHCP Snooping option is enabled. If DHCP Snooping is being used, then DhcpPort on Agents must be the same value as AltPxeServerPort on Responders. The default value of AltPxeServerPort is 2067. If a value other than 2067 is specified as a custom port number on Agents, you will also need to manually create the AltPxeServerPort (and AltPxeClientPort) registry values on Responders. |
Shopping client
When installing the 1E Client to support Shopping v5.5 or later, the following installer properties are available.
Installer property | Description |
---|---|
MODULE.SHOPPING.ENABLED | Shopping must be enabled so that users of a computer can use the 1E Shopping self-service portal, the Windows Servicing Assistant, and the 1E Virtual Assistant. If enabled, when the 1E Client starts it will attempt to automatically remove any previous installations of the 1E Shopping Agent. |
MODULE.SHOPPING.SHOPPINGCENTRALURL | Example: This is the URL of the Shopping Central website, comprising:
|
MODULE.SHOPPING.LOOPBACKEXEMPTIONENABLED | Optional. Default value is false. Set this value to true if users are likely to use Microsoft Edge or other Metro browsers to access the Shopping website. The Shopping client requests this value from the Shopping Central website (admin console setting: Loopback exemption enabled). If the client fails to connect to the website, it defaults to using this local setting and retries later. |
WakeUp client
When installing the 1E Client to support the WakeUp component of NightWatchman Enterprise v7.2.500 or later, the following are typical installer properties to use. Additional installer properties are described on the WakeUp client settings page.
Installer property | Description |
---|---|
MODULE.WAKEUP.ENABLED | Set this property to true to enable the WakeUp client module. The default value is false. Enabling this will also cause any installation of the 1E Agent's WakeUp component to be uninstalled the first time the 1E Client is started, leaving the NightWatchman component if that was installed. When true then you must also specify either the name of the NightWatchman Management Center reporting server, or that reporting is turned off. For details of these and all other installer properties please refer to WakeUp client settings. |
MODULE.WAKEUP.USEFIPS | Set to 1 to force the WakeUp agent to use a FIPS-compliant algorithm for:
If enabled, then all components in the NightWatchman and WakeUp system must have FIPS enabled. EncryptionLevel and FIPS settings used by WakeUp do not affect other 1E Client communications. |
MODULE.WAKEUP.REPORTING | Enables WakeUp reporting. Sets whether the Agent sends reporting messages to the NightWatchman Management Center Web Service. May be set to one of the following values:
When installing the 1E Client on a WakeUp Server, set MODULE.WAKEUP.REPORTING=OFF so that the server does not appear as a client in the NightWatchman Management Center Admin Console. This will only disable Agent reporting whilst the WakeUp Server will have reporting enabled for reporting statistics. |
MODULE.WAKEUP.REPORTINGSERVER | Set this parameter to the FQDN (recommended) or NetBIOS name of the server hosting the NightWatchman Management Center Web Service. Mandatory when WakeUp reporting is enabled (default) and using HTTP for communications. If HTTP is not using standard port 80 then specify the port number as part of the server name: |
MODULE.WAKEUP.SECUREREPORTINGSERVER | Set this parameter to the FQDN (required) or NetBIOS name of the server where the NightWatchman Management Center Web Service component secure site has been installed. Mandatory when WakeUp reporting is enabled (default) and using HTTPS for communications. If HTTPS is not using standard port 443 then specify the port number as part of the server name: |
MODULE.WAKEUP.CERTISSUER | Specify the text used to search for a client certificate in the client certificate store. Either MODULE.WAKEUP.CERTISSUER or MODULE.WAKEUP.CERTSUBJECT is mandatory when all the following are true:
If this property is used, it will use the first certificate it finds where the specified text matches the certificate's Issuer CN. |
MODULE.WAKEUP.CERTSUBJECT | Specify the text used to search for a client certificate in the client certificate store. Either MODULE.WAKEUP.CERTISSUER or MODULE.WAKEUP.CERTSUBJECT is mandatory when all the following are true:
If this property is used, it will use the first certificate it finds where the specified text matches the certificate's Subject CN. |
Command-line examples
When installing 1E Client, you should include /l*vx for verbose logging to a log file. The following examples also use /qn for a non-interactive (silent/quiet) installation.
Example command-line using a MST transform file
msiexec /i 1E.Client-x64.msi TRANSFORMS="1EClient.mst" /qn /l*vx C:\Windows\temp\1EClient-install.log
An MST typically only works with a specific version of an MSI, therefore you should test before using an old MST file. An MST may work with both 32 and 64-bit versions of an MSI, provided the MST does not contain any transforms that are platform-specific. Please contact your packaging team if you need help creating transform files.
The 1E Client Deployment Assistant 8.0 (CDA) is designed to help install Windows versions of 1E Client and other 1E agents using Configuration Manager. It includes template transform files for each combination of client/agent for 32 and 64-bit platforms, and automatically creates collections and deployments in Configuration Manager, so that you only need to populate the collections.
Example which enables only Tachyon client
Example Windows 1E Client installer command-line with only the Tachyon client features enabled, other client modules are not enabled. Tachyon uses HTTPS only.
msiexec /i 1E.Client-x64.msi SWITCH="tachyon.acme.local:4000" BACKGROUNDCHANNELURL="https://tachyon.acme.local:443/Background/" /qn /l*vx C:\Windows\temp\1EClient-install.log
Example which enables only Nomad client
Example Windows 1E Client installer command-line with only Nomad client module enabled, which also requires Tachyon client features to be enabled. Tachyon uses HTTPS only.
msiexec /i 1E.Client-x64.msi SWITCH="tachyon.acme.local:4000" BACKGROUNDCHANNELURL="https://tachyon.acme.local:443/Background/" MODULE.NOMAD.ENABLED=true MODULE.NOMAD.CONTENTREGISTRATION=1 MODULE.NOMAD.SSDENABLED=1 /qn /l*vx C:\Windows\temp\1EClient-install.log
Example which enables only PXE Everywhere Agent
Example Windows 1E Client installer command-line with only PXE Everywhere Agent client module enabled, and Tachyon features disabled (by setting SWITCH and BACKGROUNDCHANNELURL to none). PXE Everywhere uses only HTTP.
msiexec /i 1E.Client-x64.msi SWITCH=none BACKGROUNDCHANNELURL=none MODULE.PXEEVERYWHERE.ENABLED=true MODULE.PXEEVERYWHERE.CONFIGSERVERURL="http://pxecentral.acme.local/PXELite/PXELiteConfiguration.asmx" /qn /l*vx C:\Windows\temp\1EClient-install.log
Example which enables only Shopping client
Example Windows 1E Client installer command-line with only Shopping client module enabled, and Tachyon features disabled (by setting SWITCH and BACKGROUNDCHANNELURL to none). Ensure you use HTTP or HTTPS as appropriate.
msiexec /i 1E.Client-x64.msi SWITCH=none BACKGROUNDCHANNELURL=none MODULE.SHOPPING.ENABLED=true MODULE.SHOPPING.SHOPPINGCENTRALURL="https://appstore.acme.local/shopping" MODULE.SHOPPING.LOOPBACKEXEMPTIONENABLED=true /qn /l*vx C:\Windows\temp\1EClient-install.log
Example which enables only WakeUp client
Example Windows 1E Client installer command-line with only WakeUp client module enabled, and Tachyon features disabled (by setting SWITCH and BACKGROUNDCHANNELURL to none).
msiexec /i 1E.Client-x64.msi SWITCH=none BACKGROUNDCHANNELURL=none MODULE.WAKEUP.ENABLED=true MODULE.WAKEUP.REPORTINGSERVER="nwmserver.acme.local" /qn /l*vx C:\Windows\temp\1EClient-install.log
Sysprep and OS images
The following steps are required if the 1E Client will be included in an OS image.
- Stop the 1E Client service.
- Stop the NomadBranch service (if Nomad is enabled).
- Delete the logs folder and its contents. Default is %ALLUSERSPROFILE%\1E\Client
- Delete the registry key and its contents HKLM\SOFTWARE\1E\Client
- Delete the registry key and its contents HKLM\SOFTWARE\1E\Common
- Other registry keys for clients may exist. Please refer to their product documentation for details of sysprepping them.
- HKLM\SOFTWARE\1E\NightWatchman
- HKLM\SOFTWARE\1E\NomadBranch
- HKLM\SOFTWARE\1E\PXEEverywhere
- HKLM\SOFTWARE\1E\WakeUpAgt
- HKLM\SOFTWARE\1E\WSA
You can disable the services during image preparation and re-enable it as an OS Deployment step. The folder and registry keys will be automatically re-created when the services are restarted after the OS is deployed.
If you have 1E WakeUp client module enabled, or 1E NightWatchman Agent installed, then please refer to Installing the 1E NightWatchman Agent for Windows: The 1E NightWatchman Agent, Sysprep and diskimaging.
Uninstalling 1E Client
Manual uninstallation
1E Client can be uninstalled manually by using Windows Apps and Features (appwiz.cpl). A reboot is not normally required.
Disabling a feature or client module
Please refer to Reconfiguring 1E Client for examples of how to use the -reconfigure command-line to reconfigure the 1E Client.
Uninstallation using the Windows Installer
1E Client can be uninstalled automatically by using a Windows Installer command-line, where the {product code} is dependent on the version of the 1E Client. The example below also includes switches that prevents prompting and restarts, and creates a log file.
msiexec /x {BF6F5FA9-64C8-4B72-A6B6-14A582BF96B8} /qn /norestart /l*vx C:\Windows\temp\1EClient-uninstall.log
Tidy up after uninstallation
After uninstallation of 1E Client, the following is left behind. As with other Windows installers, uninstallation will leave behind any files, folders and registry entries that were created after installation.
Location | Artifacts | Recommendation |
---|---|---|
Installation folder | None. | |
Logs folder | Log files remain. Please refer to Log files for log file locations of 1E Client and its client modules. | The log files can be deleted or renamed. If not deleted, then a new installation that uses the same logs folder will continue to use the old log file. |
Client\Persist folder remains. | Leave this folder which contains status information about current instructions. The Persist folder should be deleted only if you do not intend re-installing the 1E Client with Tachyon enabled, or when preparing OS images. | |
Tachyon client registry | HKLM\SOFTWARE\1E\Client\Persist | This registry exists if the Tachyon client feature of the 1E Client is enabled. It is used to keep a record of hash values for its persistent storage files, which includes status information about current instructions. This registry key should be deleted only if you do not intend re-installing the 1E Client with Tachyon enabled, or when preparing OS images. |
Nomad Cache | %ALLUSERSPROFILE%\1E\NomadBranch | The folder should be deleted only if you do not intend re-installing the 1E Client with Nomad enabled. Downloaded content is retained so that if Nomad client is re-enabled it will be scanned and re-registered, to make available for peer sharing with other Nomad clients. |
HKLM\SOFTWARE\1E\Common and HKLM\SOFTWARE\1E\NightWatchman are used by the 1E NightWatchman Agent, previously part of the 1E Agent.