H7.7. Dr.Web Agent for Windows Remote Installation Utility

Dr.Web Agent for Windows remote installation utility lets you install Dr.Web Agent on protected workstations running Windows in your anti-virus network.

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

Executable file

Location

Description

drweb-windows-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

drwwindowsinstall

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-windows-install-<OS>-<bitness> and drwwindowsinstall versions are the same in terms of features. Further in this section, the drwwindowsinstall version is used, but the format and allowed switches are the same for both versions.

The start instruction format

drwwindowsinstall <switches>

Allowed Switches

info

The drwwindowsinstall 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.

--console=yes|no — print the utility logging to console. By default set to no.

--disable-v1=yes|no — disable the SMB version 1 (SMBv1) protocol while the utility is working. By default set to no.

--distribution <file_name> — manually enter the file name of the Agent installer, which will be run on remote workstations. By default it is drwinst.exe.

--install-address <workstation_IP_address> — enter address of a remote station, where Dr.Web Agent will be installed to. If you specify several stations at once, make sure to divide their addresses with comma (",") or semicolon (";"), no spaces.

--install-certificate <path> — set a path to the Dr.Web Server certificate file.

--install-clients <number> — set the maximum number of the Agent installations on remote stations at a time. By default it is 8.

--install-compression <mode> — set the compression mode for traffic between Dr.Web Server and connected workstations: on to enable traffic compression, off to disable, possible to make it possible. The latter means that the mode depends on corresponding settings on Dr.Web Server. By default it is possible.

--install-encryption <mode> — set the encryption mode for traffic between Dr.Web Server and connected workstations: on to enable traffic encryption, off to disable, possible to make it possible. The latter means that the mode depends on corresponding settings on Dr.Web Server. By default it is possible.

--install-language <language_code> — set the installed Agent's interface language as a two-letter code according to the ISO 639-1 standard. If the switch is not used or Dr.Web Agent is not available in requested language, the remote station's default system language will be used instead.

--install-path <path> — set a path to Dr.Web Agent installation directory on remote stations. By default it is %ProgramFiles%\DrWeb.

--install-register=yes|no — register the Agent in the system list of installed software once the installation is complete. By default set to no.

--install-server <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. The switch format: [udp://]<IP_address_or_DNS_name>[:<port>].

--install-timeout <time> — set the maximum time to wait for the Agent installation to complete on remote workstations. Shall be specified in seconds, by default it is 300.

--install-user <user_name>@<domain>:<password> or <domain>\<user_name>:<password> — set user name and password to use for authorization on remote workstations.

--log <path> — set a path to the utility log file. By default it is drwsmb.log in the var subdirectory of the Dr.Web Server installation directory.

--machine <name> — specify the name to be assigned to a remote workstation in the Dr.Web Enterprise Security Suite anti-virus network once the Agent installation is compete and it is connected to Dr.Web Server. By default, a computer name registered in the operating system is used.

--rotate=<N><f>,<M><u> — set the utility log rotation mode. The switch format is the same as the one used to manage the Dr.Web Server log rotation mode. By default it is 10,10m.

--service-id <name_in_registry> — set the registry key name to be assigned to the Agent remote installation service in the Windows registry. By default it is DrWebRsvcRunner.

--service-name <displayed_name> — set the Agent remote installation service name as it is displayed in the Services snap-in. By default it is Dr.Web Remote Runner Service.

--target-root <directory_name> — set the name of a directory in the administrative share on a remote station, which will be used to run the Agent installer copied from Dr.Web Server. By default it is TEMP.

--target-volume <share_name> — set the administrative share name, which will contain the Agent installation files. By default it is ADMIN$.

--threads <number> — set the number of I/O threads in a pool. By default set to 2.

--verbosity <level> — set the utility logging level. By default set to trace. Allowed values: 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.