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 and make sure the command line is opened as an administrator 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:
- From the command-line, opened as an administrator, 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 - 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.
vBoxxSync_web.vboxx.nl_2-3.4.1.116 --unattendedmodeui none --mode unattended
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.
- From the command-line, navigate to the vBoxx Sync Tool installation directory (for example, C:\Program Files (x86)\vBoxx Sync).
cd C:\Program Files (x86)\vBoxx Sync - 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)\vBoxx Sync) as noted in the example above.
bin\agent_cmdui.exe --config "C:\Program Files (x86)\vBoxx Sync\conf\config.ini" --action register --user test@vboxx.test --password PASSWORD --path "C:\Users\vBoxx Sync"
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)\vBoxx Sync\bin):
agent_gui.exe --message check_registration