Configuration Parameters

Top  Previous 

The component uses configuration parameters which are specified in [Update] section of the integrated configuration file of Dr.Web for UNIX.

The section contains the following parameters:

LogLevel = {logging level}

Logging level.

If the parameter value is not specified, the DefaultLogLevel parameter value from the [Root] section is used.

Default value:

LogLevel = Notice

Log = {log type}

Logging method.

Default value:

Log = Auto

ExePath = {path to file}

Path to the executable file of the component.

Default value:

ExePath = <opt_dir>/bin/drweb-update

For Linux:

ExePath = /opt/drweb.com/bin/drweb-update

For FreeBSD:

ExePath = /usr/local/libexec/drweb.com/bin/drweb-update

For Solaris:

ExePath = /opt/drweb.com/bin/drweb-update

RunAsUser = {UID | user name}

The parameter determines under which user name the component should be run. The user name can be specified either as the user’s number UID or as the user’s login. If the user name consists of numbers (i.e. similar to number UID), it is specified with the “name:” prefix, for example: RunAsUser = name:123456.

When a user name is not specified, the component operation terminates with an error after the startup.

Default value:

RunAsUser = drweb

UpdateInterval = {time interval}

The frequency to check for updates. This is a time period between a previous successful update (initiated automatically or manually) and the next attempt to perform an update.

Default value:

UpdateInterval = 30m

RetryInterval = {time interval}

Frequency of repeated update attempts if the previous update failed.

The parameter can have a value of 1m to 30m inclusively.

Default value:

RetryInterval = 3m

MaxRetries = {integer}

Number of repeated attempts to perform an update (at the rate specified in RetryInterval) if the previous attempt failed.

If the value is set to 0, repeated attempts are not made (the next update will be performed after the time period specified in UpdateInterval).

Default value:

MaxRetries = 3

Proxy = {connection string}

Stores the parameters for connecting to a proxy server that is used by the updater component (Dr.Web Updater) when it is connecting to updates servers (for example, if direct connections to external servers are prohibited by your network’s security policies).

If the parameter value is not specified, the proxy server is not used.

Allowed values:

<connection string>—Proxy server connection string. The string has the following format (URL):

[<protocol>://][<user>:<password>@]<proxyhost>:<port>

where

<protocol>—Type of the used protocol (in the current version, only http is available).

<user>—Name of the user for connection to proxy.

<password>—Password for connection to proxy.

<proxyhost>—Address of the host where the proxy operates (IP address or domain name).

<port>—Used port.

The <protocol> and <user>:<password> parameters can be absent. The address of proxy <proxyhost>:<port> is obligatory.

If the user name (<user>) or password (<password>) contains the following characters: '@',', '%' or ':', these characters must be changed to the following codes: "%40", "%25" и "%3A" respectively.

Examples:

1.In the configuration file:

Connection to a proxy on the host proxyhost.company.org using the port 123:

Proxy = proxyhost.company.org:123

Connection to the proxy on the node 10.26.127.0 using the port 3336 over http: protocol as user "legaluser" with the password "passw":

Proxy = http://legaluser:passw@10.26.127.0:3336

Connection to the proxy on the node 10.26.127.0 using the port 3336 as a user "user@company.com" with the password ''passw%123:":

Proxy = user%40company.com:passw%25123%3A@10.26.127.0:3336

2.Using the command drweb-ctl cfset: for specifying the same parameters:

# drweb-ctl cfset Update.Proxy proxyhost.company.org:123
# drweb-ctl cfset Update.Proxy http://legaluser:passw@10.26.127.0:3336
# drweb-ctl cfset Update.Proxy user%40company.com:passw%25123%3A@10.26.127.0:3336

Default value:

Proxy =

ExcludedFiles = {file name}

Defines the name of the file that will not be updated by the Dr.Web Updater component.

You can specify a comma-separated list as the parameter value. The parameter can be specified more than once in the section.

It is recommended that you specify one value per line:

ExcludedFiles = file1
ExcludedFiles = file2

Default value:

ExcludedFiles = drweb32.lst

NetworkTimeout = {time interval}

A time-out period imposed on the network-related operations of the updater component during the updating process.

This parameter is used when a connection is temporarily lost: if the connection is established again before the timeout expires, the interrupted updating process will be continued.

Specifying the time out value larger than 75s has no effect as the connection is closed by TCP timeout. The minimum allowed value is 5s.

Default value:

NetworkTimeout = 60s

BaseDrlPath = {path to file}

Path to the signed file that contains the list of update servers of a standard update zone, which are used by the update component for updating virus databases and anti-virus engine.

Default value:

BaseDrlPath = <var_dir>/drl/bases/update.drl

For Linux:

BaseDrlPath = /var/opt/drweb.com/drl/bases/update.drl

For FreeBSD:

BaseDrlPath = /var/drweb.com/drl/bases/update.drl

For Solaris:

BaseDrlPath = /var/opt/drweb.com/drl/bases/update.drl

BaseCustomDrlPath = {path to file}

Path to the signed file that contains the list of update servers of a special update zone, which are used by the update components for updating virus databases and anti-virus engine.

If the parameter or the content of the specified file is not empty, only these servers are used for updating. The main list (see above) is ignored.

Default value:

BaseCustomDrlPath = <var_dir>/drl/bases/custom.drl

For Linux:

BaseCustomDrlPath = /var/opt/drweb.com/drl/bases/custom.drl

For FreeBSD:

BaseCustomDrlPath = /var/drweb.com/drl/bases/custom.drl

For Solaris:

BaseCustomDrlPath = /var/opt/drweb.com/drl/bases/custom.drl

BaseUpdateEnabled = {boolean}

Indicator that shows whether or not updating of virus databases and anti-virus engine is allowed.

Allowed values:

Yes—updating is allowed and will be performed.

No—updating is not allowed and will not be performed.

Default value:

BaseUpdateEnabled = Yes

VersionDrlPath = {path to file}

The parameter is not used.

Default value:

VersionDrlPath =

VersionUpdateEnabled = {boolean}

The parameter is not used.

Default value:

VersionUpdateEnabled = No

DwsDrlPath = {path to file}

Path to the signed file that contains the list of the servers of a standard update zone, which are used for updating database of web resource categories. (if the network traffic monitor components are included in the product).

Default value:

DwsDrlPath = <var_dir>/drl/dws/update.drl

For Linux:

DwsDrlPath = /var/opt/drweb.com/drl/dws/update.drl

For FreeBSD:

DwsDrlPath = /var/drweb.com/drl/dws/update.drl

For Solaris:

DwsDrlPath = /var/opt/drweb.com/drl/dws/update.drl

DwsCustomDrlPath = {path to file}

Path to the signed file that contains the list of the servers of a special update zone, which are used for updating database of web resource categories (if the network traffic monitor components are included in the product).

If the parameter or the content of the specified file is not empty, only these servers are used for updating. The main list (see above) is ignored.

Default value:

DwsCustomDrlPath = <var_dir>/drl/dws/custom.drl

For Linux:

DwsCustomDrlPath = /var/opt/drweb.com/drl/dws/custom.drl

For FreeBSD:

DwsCustomDrlPath = /var/drweb.com/drl/dws/custom.drl

For Solaris:

DwsCustomDrlPath = /var/opt/drweb.com/drl/dws/custom.drl

DwsUpdateEnabled = {boolean}

Indicator that shows whether or not updating of database of web resource categories is allowed (if the network traffic monitor components are included in the product).

Allowed values:

Yes—updating is allowed and will be performed.

No—updating is not allowed and will not be performed.

Default value:

DwsUpdateEnabled = Yes

AntispamDrlPath = {path to file}

Path to the signed file that contains the list of update servers, which are used for updating the anti-spam library (if the network traffic monitor components are included in the product).

Default value:

AntispamDrlPath = <var_dir>/drl/antispam/update.drl

For Linux:

AntispamDrlPath = /var/opt/drweb.com/drl/antispam/update.drl

For FreeBSD:

AntispamDrlPath = /var/drweb.com/drl/antispam/update.drl

For Solaris:

AntispamDrlPath = /var/opt/drweb.com/drl/antispam/update.drl

AntispamCustomDrlPath = {path to file}

Path to the signed file that contains the list of the servers of a special update zone, which are used by the update component for updating the anti-spam library (if the network traffic monitor components are included in the product).

If the parameter or the content of the specified file is not empty, only these servers are used for updating. The main list (see above) is ignored.

Default value:

AntispamCustomDrlPath = <var_dir>/drl/antispam/custom.drl

For Linux:

AntispamCustomDrlPath = /var/opt/drweb.com/drl/antispam/custom.drl

For FreeBSD:

AntispamCustomDrlPath = /var/drweb.com/drl/antispam/custom.drl

For Solaris:

AntispamCustomDrlPath = /var/opt/drweb.com/drl/antispam/custom.drl

AntispamUpdateEnabled = {boolean}

Indicator that shows whether or not updating of the anti-spam library is allowed (if the network traffic monitor components are included in the product).

Allowed values:

Yes—updating is allowed and will be performed.

No—updating is not allowed and will not be performed.

Default value:

AntispamUpdateEnabled = No

BackupDir = {path to directory}

Path to the directory, where the previous versions of updated files are saved for possible rollback. Upon every update only updated files are backed up.

Default value:

BackupDir = /tmp/update-backup

MaxBackups = {integer}

The maximum number of the previous versions of updated files, which are saved. If this number is exceeded the oldest copy is removed upon the next update.

If the parameter value is zero, the previous versions of the files are not saved.

Default value:

MaxBackups = 0