How Do I Install and Register a Desktop Client in Unattended Mode (Silently)
Overview
A desktop client can be installed and registered in unattended mode (silently) by running the 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 |
–version | 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: 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:
- From the command-line, navigate to the location of the executable file (installation file). For example, if the executable file exists on the Desktop, run the following commend:
cd C:\Users\jane\Desktop
Note: 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 version of the desktop client. If you alter the name of the executable file, branding settings will not be reflected, and the current version of the desktop client will not be installed.
- Run the executable file from the command-line using the following arguments, making sure to replace the bold text with 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
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 agent_cmdui.exe file located in the installation directory bin folder.
- From the command-line, navigate to the Synced Tool installation directory (for example, C:\Program Files (x86)\SyncedTool).
cd C:\Program Files (x86)\SyncedTool
- Run the agent_cmdui.exe file using the following arguments, making sure to replace the bold text with information appropriate to the specific environment and user:
bin\agent_cmdui.exe --config "C:\Program Files (x86)\SyncedTool\conf\config.ini" --action register --user jane@efolder.test --password PASSWORD --path "C:\Users\Synced"
Note: Make sure that you execute agent_cmdui.exe from its parent folder (for example, C:\Program Files (x86)\SyncedTool) as noted in the example above.
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)\AXIS Cloud SyncedTool\bin):
agent_gui.exe --message check_registration