G5. 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

Cross-platform Switches

•--console=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:

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.

If necessary, it is possible to set specific levels of detail for several message sources at once in the following format:

-verbosity=<message_source1>:<level1>,<message_source2>:<level2>, <message_source3>:<level3> and so on. In this case, <level> is inherited on general principle, i.e. it looks for the closest parental source with specified level of detail. The -verbosity=all:all switch is equal to the -verbosity=all switch (see also Appendix J. Log Files Format).

Switches for Unix-like 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.

•--pid=<path>—path to the directory with the process identifier.

Default:/var/opt/drwcs/run/drwcsd-proxy.pid

Allowed Commands and their Arguments

•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 Dr.Web 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 separated 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.

•start—start the installed service.

•stop—stop the started service.

•uninstall—uninstall the service.

Commands available under Unix-like OS only:

•daemon—run the Proxy Server as a daemon (see also Switches for Unix-like OS).

Proxy server control script and variables available under Unix-like OS

To make the administration of Dr.Web Proxy Server under Unix-like OS easier, administrator is provided with variables which reside in the drwcsd-proxy.sh script file executed with the help of an initialization script:

•Linux: /etc/init.d/dwcp_proxy

•FreeBSD: /usr/local/etc/rc.d/dwcp_proxy

The script accepts the following commands:

•import <path> [<revision>] [<products>]—import files from Dr.Web Server repository to the Proxy Server cache (same as the command of Proxy Server—see above).

•interactive—run the Proxy Server in the interactive mode. At this, the Proxy Server operation log is written to the console.

•start—run the Proxy Server as a daemon.

•status—check if the daemon is launched.

•stop—stop the started daemon.

Correspondence between variables and command switches for the drwcsd-proxy is described in the Table H-3.

Table H-3.