Summary

Settings available in the 1E Client configuration file, with details of which settings are mandatory or optional during installation, and which settings can be re-configured post-installation.

1E Client installers include a template configuration file that contains the more important settings with default values that match hard-coded default values. The configuration file is updated during installation.

After installation, configuration file settings can be managed using 1E Client reconfiguration, Tachyon Explorer configuration instructions, Tachyon Guaranteed State policies, Configuration Manager baselines or other means. Registry settings can also be managed by Windows Group Policy.

1E Client installer zips

Zip files for 1E Client installers can be downloaded from the 1E support portal page (https://1eportal.force.com/s/1eclienttopicdetail). The following installer zips are available and contain the following files, where 5.1.x.xxx is a specific build:

1EClient.v5.1.x.xxx.zip1EClient_Non-Windows.v5.1.x.xxx.zip
  • Licenses.txt
  • 1E Client release information.html
  • 1EClient-x64.msi
  • 1EClient-x86.msi
  • Licenses.txt
  • 1E Client release information.html
  • 1e.client-CentOS_8.1_x64_v5.1.x.xxx.rpm
  • 1e.client-Debian_10.4_x64_v5.1.x.xxx.deb
  • 1e.client-Fedora_32_x64_v5.1.x.xxx.rpm
  • 1e.client-macOS_v5.1.x.xxx.dmg
  • 1e.client-macOS_v5.1.x.xxx.pkg
  • 1e.client-openSUSE_Leap_15.1_x64_v5.1.x.xxx.rpm
  • 1e.client-RHEL_7.1_x64_v5.1.x.xxx.rpm
  • 1e.client-RHEL_8.1_x64_v5.1.x.xxx.rpm
  • 1e.client-SLES_15.1_x64_v5.1.x.xxx.rpm
  • 1e.client-Solaris_11.3_SPARC_v5.1.x.xxx.p5p
  • 1e.client-Solaris_11.4_x64_v5.1.x.xxx.p5p
  • 1e.client-Ubuntu_18.04_x64_v5.1.x.xxx.deb

Please refer to Supported Platforms: 1E Clients for details of supported OS versions and their prerequisites.

Deploying the 1E Client

Windows computers

When deploying 1E Client to Windows devices you can install using the MSI interactively but this only allows you to specify some configuration settings. You can configure these and some other settings using installer properties on the command-line or in one or more MST transform files. 

The 1E Client Deployment Assistant 1.5 (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.

 

Please refer to:

Non-Windows devices

Please refer to:

1E Client settings

Configuration settings can be set during or after installation, depending on the platform, as described in the table below. Installer command-lines are described in Deploying 1E Client on Windows.

PlatformNotes
Windows
  • Some settings may be set during installation and others can only be set in the configuration file
  • Setting names are not case sensitive
  • Windows installer properties are not case sensitive
  • Nomad, PXE Everywhere, and WakeUp client modules have settings that are stored in the registry instead of the configuration file
Linux
  • Settings may be set during installation or modified in the configuration file
  • Setting names are not case sensitive
Mac and Solaris
  • Settings must be set after installation using the supplied bash script
  • Setting names are not case sensitive

The following applies to all configuration settings that are stored in the 1E Client configuration file:

  • they can be reconfigured after installation either manually or as described in 1E Client command-line parameters
  • property names and values are not case-sensitive, but convention is to store them in mixed-case
  • if you omit a mandatory property or its value, the 1E Client will not start
  • if you omit an optional property or its value, the 1E Client will use the default value instead


1E Client configuration file location and name

The 1E Client is controlled via the 1E Client configuration file 1E.Client.conf which resides in the installation folder along with the 1E Client executable.

The default installation location used for the different OS supported by the 1E Client are given in the following table:

OSDefault install location
Windows%ProgramFiles%\1E\Client
Linux and Solaris/etc/1E/Client
Mac'/Library/Application Support/1E/Client'

1E Client running on Android is configured using the Application Preferences interface, not based on a configuration file.

The configuration file uses ASCII encoding.

A comment line starts with the # symbol.


Installer properties

The following are lists of all installer properties for 1E Client modules and features. Those listed in mixed case are stored in the  1E Client configuration file , and those listed in UPPERCASE are stored in the registry. 

You must use UPPERCASE when specifying the name of any installer property in a mst transform file, and preferably when including them in a msiexec command-line.

Configuration settings

The following are lists of all settings stored in the 1E Client configuration file, used by 1E Client modules and features. Where relevant, the locations of Windows registry settings are provided.

Names of settings stored in the configuration file are not case-sensitive. Setting names stored in the registry may be case-sensitive and should be specified as shown.

Installer properties for Windows:

Configuration file settings:

1E Client has no registry settings, however InstallationDirectory is stored in HKLM\SOFTWARE\1E\Client.

Installer properties for Windows and non-Windows. Some settings are only available for Windows, and some are not available as installer properties.

Core settings common to Windows and non-Windows platforms: 

Core settings for Windows only: 

Interaction module settings (only supported on Windows):

Inventory module settings:

Where <source> is :

Configuration file settings for Windows and non-Windows. Some settings are only available for Windows.

Core settings common to Windows and non-Windows platforms: 

Core settings for Windows only: 

Interaction module settings (only supported on Windows):

Inventory module settings:

Where <source> is :

Additional settings common to Windows and non-Windows platforms that are only available in the Configuration file, not as installer properties: 

Tachyon client has no registry settings, however some data is stored in HKLM\SOFTWARE\1E\Client\Persist.

Installer properties for Windows:

Module.Nomad.Enabled | MODULE.NOMAD.AUTHENTICATEDUSERS | MODULE.NOMAD.BLOCKSIZE | MODULE.NOMAD.CACHECLEANCYCLEHRS | MODULE.NOMAD.CACHEPATH | | MODULE.NOMAD.CACHESTATESYNCINTERVALMINUTES | MODULE.NOMAD.CERTISSUER | MODULE.NOMAD.CERTSUBJECT | MODULE.NOMAD.COMPATIBILITYFLAGS | MODULE.NOMAD.CONTENTPROVIDERONWIFI | MODULE.NOMAD.CONTENTREGISTRATION | MODULE.NOMAD.CONTENTREGSYNCCYCLEHRS | MODULE.NOMAD.CONTENTREGSYNCREQDELAY | MODULE.NOMAD.CONTENTREGSYNCBATCHSZ | MODULE.NOMAD.DEBUG | MODULE.NOMAD.DOWNLOADTIMEOUT | MODULE.NOMAD.DPNOTAVAILABLECODES | MODULE.NOMAD.ENFORCEQUOTAS | MODULE.NOMAD.GENERATEWEREVENTS | MODULE.NOMAD.HAACKTIMEOUTMINS | MODULE.NOMAD.LOCALSSDSTAGGER | MODULE.NOMAD.LOGNAME | MODULE.NOMAD.LOGPATH | MODULE.NOMAD.MADCAPSCOPE | MODULE.NOMAD.MAXALLOCREQUEST | MODULE.NOMAD.MAXCACHEDAYS | MODULE.NOMAD.MAXCACHESIZEMB | MODULE.NOMAD.MAXCONCURRENCY | MODULE.NOMAD.MAXDEVICESFROMAE | MODULE.NOMAD.MAXELECTIONRESPONSELOGGING | MODULE.NOMAD.MAXIMUMMEGABYTE | MODULE.NOMAD.MAXLOGSIZE | MODULE.NOMAD.MAXPACKAGEFAST | MODULE.NOMAD.MAXPACKAGERAS | MODULE.NOMAD.MAXPACKAGESLOW | MODULE.NOMAD.MAXPACKETSPERSECOND | MODULE.NOMAD.MAXPRECACHEDAYS | MODULE.NOMAD.MAXSTATUSFREQUENCY | MODULE.NOMAD.MAXSTUCKCOUNT | MODULE.NOMAD.MAXSUCACHEDAYS | MODULE.NOMAD.MULTICASTSUPPORT | MODULE.NOMAD.NOHARDLINK | MODULE.NOMAD.NOMADINHIBITEDADSITES | MODULE.NOMAD.PERCENTDELAYEDCONTENTREG |  MODULE.NOMAD.P2PDISQUALIFYMAXNUMPEERS |  MODULE.NOMAD.P2PDISQUALIFYMAXWINDOWMINS | MODULE.NOMAD.P2PENABLED | MODULE.NOMAD.P2PHTTPPORT | MODULE.NOMAD.P2PHTTPSPORT | MODULE.NOMAD.P2PPORT | MODULE.NOMAD.P2PSSLSETTINGS | MODULE.NOMAD.PERCENTAVAILABLEDISK | MODULE.NOMAD.PERMITTEDLSZSHARES | MODULE.NOMAD.PERMITUNCACHED | MODULE.NOMAD.PLATFORMURL | MODULE.NOMAD.POSTCOMPLETETIMEOUTHOURS | MODULE.NOMAD.PRECACHEPOLLBATCHSIZE | MODULE.NOMAD.PRECACHEPOLLMINUTES | MODULE.NOMAD.PRECOMPLETETIMEOUTHOURS | MODULE.NOMAD.RECYCLEDPDELAY | MODULE.NOMAD.SIGSFOLDER | MODULE.NOMAD.SITESSDSTAGGER | MODULE.NOMAD.SPECIALNETSHARE | MODULE.NOMAD.SSDENABLED | MODULE.NOMAD.SSPBAENABLED | MODULE.NOMAD.STATUSMSGEVENTS | MODULE.NOMAD.SUCCESSCODES | MODULE.NOMAD.USEFIPS | MODULE.NOMAD.WAKEUPBATCHSIZE | MODULE.NOMAD.WAKEUPENABLED | MODULE.NOMAD.WAKEUPMINPACKAGESIZEMB | MODULE.NOMAD.WLANBLIPSECS | MODULE.NOMAD.WLANPROFILELIST

Nomad client stores its settings under the registry key HKLM\SOFTWARE\1E\NomadBranch.

For details of Nomad client registry settings, please refer to installer properties.