Silently install the desktop client - x360Sync

Written By Tami Sutcliffe (Super Administrator)

Updated at February 15th, 2024

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

Install 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

Register 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"

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





 SUPPORT | 720-204-4500 | 800-352-0248


1721

876849