Axcient Help Center

How to Silently Install the Desktop Client

A desktop client can be installed and registered in unattended mode (silently) by running the desktop client's executable file from the command line.

Installing a Desktop Client in Unattended Mode

First, the desktop client must be installed. The following arguments can be used to control the installation process:

--help

Display the list of valid options

--revision

Display product information

--unattendedmodeui

Unattended Mode UI

Default: none

Allowed: none, minimal, minimalwithdialogs

--mode

Installation mode

Default: win32

Allowed: win32 unattended

--installer-language

Language selection

Default: en

Allowed: en ar bg ca da nl et fr fi de el es es_AR he hr hu it ja ko pl pt_BR pt ro ru no sl sk sq sv tr zh_TW zh_CN va cy cs

--create_shortcuts

Creates Desktop shortcut with value of 1

Allowed: 0, 1

Default: 1

--host

Host name

Note: Do not include http or https protocol; do not include port number, if applicable

--port

Server Port

Default: 443

--httpport

Server Web Port

Default: 80

The following example will install the desktop client silently without registering it:

  1. From the command-line, navigate to the location of the executable file (installation file). Please note that you should not rename the downloaded executable file when conducting a silent installation. The name of the executable file determines both branding settings and the current revision of the desktop client. If you alter the name of the executable file, branding settings will not be reflected, and the current revision of the desktop client will not be installed. For example, if the executable file exists on the Desktop, run the following commend:

    cd C:\Users\jane\Desktop
    
  2. Run the executable file from the command-line using the following arguments, making sure to replace the information appropriate to the specific environment and user.

    SyncedTool_OrganizationA.syncedtool.com_15059-2.4.0.815.exe --unattendedmodeui none --mode unattended --host OrganizationA.syncedtool.com
12.png
Registering a Desktop Client in Unattended Mode

After the installation process completes, the desktop client can then be registered to a user silently. The following arguments can be used to control the registration process:

--help

Produce help message

--config

Config file

--action

Action to perform (required)

[register|filestatus|userinfo]

--user

Username (email or domain\ad_username)

--password

Password

--auth_code

Two-Factor Authentication code (when the Two-Factor Authentication policy has been enabled and configured)

--localuser

Local user

--path

Path

The following example will register the desktop client using the desktop client_cmdui.exe file located in the installation directory bin folder.

  1. From the command-line, navigate to the Synced Tool installation directory (for example, C:\Program Files (x86)\SyncedTool).

    cd C:\Program Files (x86)\SyncedTool
  2. Run the desktop client_cmdui.exe file using the following arguments, making sure to replace the text with information appropriate to the specific environment and user. Please note that you should execute agent_cmdui.exe from its parent folder (for example, C:\Program Files (x86)\SyncedTool) as noted in the example above.

    bin\agent_cmdui.exe --config "C:\Program Files (x86)\SyncedTool\conf\config.ini" --action register --user jane@axcient.test --password PASSWORD --path "C:\Users\Synced"
    4silentinstall.png
Troubleshooting

After silently registering the user, you might notice that the application UI still indicates that registration is not complete. Run the following command from the installation directory BIN folder (for example, C:\Program Files (x86)\SyncedTool\bin):

agent_gui.exe --message check_registration