H7. Dr.Web Proxy Server

To configure the Proxy server parameters, run with corresponding switches the drwcsd-proxy executable file, which resides in the bin subdirectory of the Proxy server installation directory.

The Start Instruction Format

drwcsd-proxy [<switches>] [<commands>] [<command_arguments>]

Allowed Switches

Crossplatform Switches

--сonsole=yes|no—run the Proxy server in the interactive mode. At this, the Proxy server operation log is written to the console.

Default: no.

--etc-root=<path>—path to the configuration files directory (drwcsd-proxy.conf, drwcsd.proxy.auth and etc.).

Default: $var/etc

--home=<path>—path to the Proxy server installation directory.

Default: $exe-dir/

--log-root=<path>—path to the directory with the Proxy server operation log files.

Default: $var/log

--pool-size=<N>—pool size for clients connections.

Default: core number of the computer with the Proxy server installed (not less than 2).

--rotate=<N><f>,<M><u>—Proxy server log rotation mode, where:

Parameter

Description

<N>

Total number of log files (including current and archive).

<f>

Log files storing format, possible values:

z (gzip)—compress files, used by default,

p (plain)—do not compress files.

<M>

Log file size or rotation time, depending on the <u> value;

<u>

Unit measure, possible values:

to set rotation by log file size:

k—Kb,

m—Mb,

g—Gb.

to set rotation by time:

H—hours,

D—days,

W—weeks.

info

If rotation by time is set, synchronisation performs independently on command launch time: the H value means synchronisation with the beginning of an hour, D—with beginning of a day, W—with beginning of a week (00:00 on Monday) according to the multiplicity specified in the <u> parameter.

Initial reference point—January 01, year 01 AD, UTC+0.

Default is 10,10m, which means storing of 10 files of 10 megabytes each, use compression.

--trace=yes|no—enable detailed logging of Proxy server calls. Available only if the Proxy server supports calls stack tracing (if an exception occurs, stack is written to the log).

Default: no.

--tmp-root=<path>—path to the temporary files directory. Is used at Proxy server automatic update.

Default: $var/tmp.

--var-root=<path>—path to the Proxy server working directory to store cache and database.

Default:

Windows OS: %ALLUSERSPROFILE%\Doctor Web\drwcs

Linux OS: /var/opt/drwcs

FreeBSD OS: /var/drwcs

--verbosity=<details_level>—log details level. Default is TRACE. Allowed values are: ALL, DEBUG3, DEBUG2, DEBUG1, DEBUG, TRACE3, TRACE2, TRACE1, TRACE, INFO, NOTICE, WARNING, ERROR, CRIT. The ALL and DEBUG3 values are synonyms.

info

All switches for setting Proxy server parameters can be set simultaneously.

Switches for UNIX system-based OS

--user—set the user identifier. The switch is relevant for both, normal and daemon modes.

--group—set the group identifier. The switch is relevant for both, normal and daemon modes.

Allowed Commands and their Arguments

info

If the command is not specified, the run command is used.

import <path> [<revision>] [<products>]—import files from Dr.Web Server repository to the Proxy server cache.

<path>path to the directory with Dr.Web Server repository. The Server repository must be preliminary downloaded to the computer with the Proxy server installed.

<revision>—maximum number of revisions to import. If the value is not set, all revision will be imported.

<products>the list of products divided by the space that are intended to import. By default, the list is empty, i.e. import all repository products except Dr.Web Server. If the list is set, only the products from the list will be imported.

help—show help message on switches for Proxy server configuration.

run—start the Proxy server in normal mode.

For Windows OS only

install—install the service.

uninstall—uninstall the service.

start—start the installed service.

stop—stop the started service.

For UNIX system-based OS only

daemon—run the Proxy server as a daemon (see also Switches for UNIX system-based OS).