H7.6. Dr.Web Agent for UNIX Remote Installation Utility

Dr.Web Agent for UNIX remote installation utility lets you install Dr.Web Agent on protected workstations running a UNIX system-based operating system in your anti-virus network. The utility can also be used to install Dr.Web for UNIX File Servers, if necessary.

The utility has a command-line interface and it is available in several versions:

Executable file

Location

Description

drweb-unix-install-<OS>-<bitness>

Control Center, the Administration → Utilities section

Independent version, which can be run from any directory and on any computer with a corresponding operating system. It is updated together with the repository or Dr.Web Server.

The webmin/utilities Dr.Web Server directory

drwunixinstall

The bin Dr.Web Server directory

A version, which depends on available server libraries and therefore, can be run from its original location only. It is updated together with the Dr.Web Server only.

info

The drweb-unix-install-<OS>-<bitness> and drwunixinstall versions are the same in terms of features. Further in this section, the drwunixinstall version is used, but the format and allowed switches are the same for both versions.

The start instruction format

drwunixinstall [<switches>] <station_1_IP_address>[:<SSH_port>[^<user_name>[^<password>]]] <station_2_IP_address>[:<SSH_port>[^<user_name>[^<password>]]] ...

Allowed Switches

info

The drwunixinstall utility uses switches according to the general rules described in Appendix H. Command Line Parameters of the Programs Included in Dr.Web Enterprise Security Suite.

--help — show the help message.

--ak <authorization_parameters> — set the alternative parameters of authorization on remote workstations using encryption keys in the following format:

<user_name>^<path_to_Dr.Web_Server_private_key>^<path_to_Dr.Web_Server_public_key>[^<private_key_password>]

info

If you set both the standard authorization parameters (the <user_name>^<password> pair) and the alternative parameters using encryption keys, the latter will be the used first when the utility is executed.

--ap <user_name>^<password> — use the keyboard-interactive authorization on remote workstations.

--certificate <path> — set a path to the Dr.Web Server certificate file. By default it is webmin/install/unix/workstation/drwcsd-certificate.pem.

--cpus <number> — set a number of CPU cores to use for remote installation. By default it is 4.

--ctimeout <time> — set the maximum time to wait for installation package transferring to complete on remote workstations. Shall be specified in seconds, by default it is 600.

--debug — enable logging in debug mode. By default set to no.

--esuite <Dr.Web_Server_address> — enter address of Dr.Web Server to be used for remote installation. The Agent will connect to this Dr.Web Server once the installation is complete. Shall be specified in the following format: [udp://]<IP address or DNS name>[:<port>]

--etimeout <time> — set the maximum time to wait for package installation to complete on remote workstations. Shall be specified in seconds, by default it is 900.

--from <path> — set a path to a directory on Dr.Web Server containing the installation packages. By default it is webmin/install/unix.

--long — enable logging with timestamps included. By default set to no.

--pwd <password> — set a password for authorization on remote workstations while using the su and/or sudo command.

--remote-temp <path> — set a path to a directory on remote workstations to temporarily store installation files and the Dr.Web Server's certificate. By default, the utility uses a temporary directory set in the operating system.

--server — install Dr.Web for UNIX File Servers instead of Dr.Web Agent. By default set to no.

--simultaneously <number> — set the maximum number of Dr.Web Agent installations on remote workstations at the same time.

--sshdebug — enable logging in debug mode, with extra details on all operations using the SSH protocol. By default set to no.

--sshwaitdebug — enable logging in debug mode, with extra detail on all operations using the SSH protocol and timer-related operations. By default set to no.

--stimeout <time> — set the maximum time to wait for password input allowing the use of the su and/or sudo commands on remote workstations. Shall be specified in seconds, by default it is 10.

--su — use the su command during the installation to elevate privileges up to the root level on remote workstations. By default set to no.

--sudo — use the sudo command during the installation to elevate privileges up to the root level on remote workstations. By default set to no.

--temp <path> — set a path to a directory on Dr.Web Server to temporarily store the certificate. By default, the utility uses a temporary directory set in the operating system.

--timeout <time> — set the maximum time to wait to establish connection and authenticate on remote workstations. Shall be specified in seconds, by default it is 30.

--verbosity <details_level> — set a level of detail while logging. By default it is info. Allowed values are all, debug3, debug2, debug1, debug, trace3, trace2, trace1, trace, info, notice, warning, error, crit. The all and debug3 values are synonyms.

--version — show the utility version.