Contents
-
Introducing Tachyon
-
Quick Start
-
Implementing Tachyon
-
Using Settings
-
Using Explorer
-
Using Guaranteed State
-
Using Inventory
-
Using Experience
-
Using Patch Success
-
Troubleshooting
-
Extending Tachyon
-
Training
-
Reference
-
Supported Platforms
-
1E Companion Products
-
Server Sizing
-
Communication Ports
-
Tachyon installation requirements on-premises
-
Naming conventions
-
Log files
-
Server installers
-
Tachyon Server reference
- Tachyon client reference
-
Explorer reference
-
Inventory reference
-
Tachyon Product Packs reference
-
Tachyon release information
-
Glossary
-
Index
-
Supported Platforms
Command-line parameters
-console
Instead of running the 1E Client as a service or daemon, run it as a console application. To stop the 1E Client, press ctrl-C
.
-runservice
This is the normal invocation of the 1E Client to run it as a service or daemon.
Do not use this mode from the command line.
-uninstall[=module1,module2,...]
Run the uninstall action on all (by default) or the specified modules. Case is not significant.
Most modules use the default uninstall action which does nothing, but a few such as Nomad perform important tasks.
This CLI action checks that the 1E Client service/daemon is not currently running, and aborts if it is, because it is not safe to uninstall a module that is active.
-getdbkey
In rare circumstances 1E Support may ask for a copy of the Tachyon persistent stoarge database for diagnostic purposes. This option gives an encrypted form of the DB's key.
Do not use this option unless requested by 1E Support.
Because the DB is generated and encrypted by the 1E Client runs using the system account, you must fetch the key in the same context. On Windows the SysInternals psexec
command is convenient for this, as follows:
psexec -s 1E.Client.exe -getdbkey
-reconfigure name1=value1 ...
This is a convenient way to change settings in the 1E Client configuration file. One or more name=value pairs should be specified, and the configuration file will be updated. A value can be empty, although that is only valid for a few configuration settings. Case of the name-part is not signficant, but the case of the value is preserved when it is written to the configuration file.
You can change only configuration file settings using this method, you must use other methods to change registry settings. For further guidance please refer to Reconfiguring 1E Client.
This CLI action can be used in combination with -start and -restart (and -stop although that is not very useful).
Examples
Set the Switch
and BackgroundChannelUrl
values, then restart the 1E Client (after a random stagger interval) to pick up the new values.
On Windows:
"C:\Program Files\1E\Client\1E.Client.exe" -reconfigure Switch=ACME-DMZ01.ACME.LOCAL:4000 BackgroundChannelUrl=https://ACME-DMZ01.ACME.LOCAL:443/Background/ -restart
On Linux and Solaris:
/usr/sbin/1E.Client -reconfigure Switch=ACME-DMZ01.ACME.LOCAL:4000 BackgroundChannelUrl=https://ACME-DMZ01.ACME.LOCAL:443/Background/ -restart
On macOS:
cd /Library/Application Support/1E/Client # Do not prefix cd with sudo ./1E.Client -reconfigure Switch=ACME-DMZ01.ACME.LOCAL:4000 BackgroundChannelUrl=https://ACME-DMZ01.ACME.LOCAL:443/Background/ -restart
-stdin
Read configuration values from standard input rather than the configuration file. This is only used with -console when debugging.
-stop [-immediate]
Stop the running 1E Client service or daemon. if -immediate is given, the 1E Client will shut down immediately (or as soon as possible to preserve instruction integrity), otherwise it will happen after a random number of seconds in a range between the ConnectionRetryTimeInSecondsMin
and ConnectionRetryTimeInSecondsMax
configuration values. . This is to prevent flooding, for example, the Tachyon Switch with offline messages, depending which client options have been enabled.
-start [-immediate]
Start the 1E Client service or daemon if it is not already running. if -immediate is given, the 1E Client will start immediately, otherwise it will happen after a random number of seconds in a range between the ConnectionRetryTimeInSecondsMin
and ConnectionRetryTimeInSecondsMax
configuration values. This is to prevent flooding, for example, the Tachyon Switch with online messages, or Nomad content registration messages, depending which client options have been enabled.
-restart [-immediate]
Shut down if necessary then (re)start the 1E Client service or daemon. if -immediate is given, this will happen immediately, otherwise it will happen after a random number of seconds in a range between the ConnectionRetryTimeInSecondsMin
and ConnectionRetryTimeInSecondsMax
configuration values. This is to prevent flooding, for example, the Tachyon Switch with offline and online messages, or Nomad content registration messages, depending which client options have been enabled.