Configuration Parameters

Top  Previous  Next

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

The section contains the following parameters:

LogLevel

{logging level}

Logging level of the component.

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

Default value: Notice

Log

{log type}

Logging method

ExePath

{path to file}

Path to the executable file of the component.

Default value: <opt_dir>/bin/drweb-update

For Linux, Solaris: /opt/drweb.com/bin/drweb-update

For FreeBSD: /usr/local/libexec/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: drweb

UpdateInterval

{time interval}

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

Default value: 30m

RetryInterval

{time interval}

Frequency of repeated attempts to perform an update using the update servers if the previous attempt failed.

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

Default value: 3m

MaxRetries

{integer}

Number of repeated attempts to perform an update using the update servers (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: 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 Dr.Web 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, i.e. FQDN).

<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" and "%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.Specifying the same parameter value via command drweb-ctl cfset:

# 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: (not specified)

ExcludedFiles

{file name}

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

You can specify a list as the parameter value. The values in the list must be separated with commas (each value in the quotation marks). The parameter can be specified more than once in the section (in this case, all its values are combined into one list).

Example: Add to the list the following files: 123.vdb and 456.dws.

1.Adding of values to the configuration file.

Two values in one string

[Update]
ExcludedFiles = "123.vdb", "456.dws"

Two strings (one value per a string)

[Update]
ExcludedFiles = 123.vdb
ExcludedFiles = 456.dws

2.Adding values via the command drweb-ctl cfset.

# drweb-ctl cfset Update.ExcludedFiles -a 123.vdb
# drweb-ctl cfset Update.ExcludedFiles -a 456.dws

Default value: 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: 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: <var_dir>/drl/bases/update.drl

For Linux, Solaris: /var/opt/drweb.com/drl/bases/update.drl

For FreeBSD: /var/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 is not empty, and the specified file exists, only servers are used for the update. The main file of the list (see above) is ignored. If the file identified by the parameter is empty, the update attempt will fail.

Default value: <var_dir>/drl/bases/update.drl

For Linux, Solaris: /var/opt/drweb.com/drl/bases/custom.drl

For FreeBSD: /var/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: Yes

VersionDrlPath

{path to file}

Defines a path to the signed file that contains the list of the servers of an update zone, which are used by the update component for updating Dr.Web for UNIX Mail Servers components.

Default value: <var_dir>/drl/version/update.drl

For Linux, Solaris: /var/opt/drweb.com/drl/version/update.drl

For FreeBSD: /var/drweb.com/drl/version/update.drl

VersionUpdateEnabled

{Boolean}

Indicator that shows whether or not updating of Dr.Web for UNIX Mail Servers component’s version is allowed.

Allowed values:

Yes—updating is allowed and will be performed.

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

Default value: Yes

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

Default value: <var_dir>/drl/dws/update.drl

For Linux, Solaris: /var/opt/drweb.com/drl/dws/update.drl

For FreeBSD: /var/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 parameter is not empty, and the specified file exists, only servers are used for the update. The main file of the list (see above) is ignored. If the file identified by the parameter is empty, the update attempt will fail.

Default value: <var_dir>/drl/dws/custom.drl

For Linux, Solaris: /var/opt/drweb.com/drl/dws/custom.drl

For FreeBSD: /var/drweb.com/drl/dws/custom.drl

DwsUpdateEnabled

{Boolean}

Indicator that shows whether or not updating of database of web resource categories is allowed.

Allowed values:

Yes—updating is allowed and will be performed.

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

Default value: 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.

Default value: <var_dir>/drl/antispam/update.drl

For Linux, Solaris: /var/opt/drweb.com/drl/antispam/update.drl

For FreeBSD: /var/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 parameter is not empty, and the specified file exists, only servers are used for the update. The main file of the list (see above) is ignored. If the file identified by the parameter is empty, the update attempt will fail.

Default value: <var_dir>/drl/antispam/custom.drl

For Linux, Solaris: /var/opt/drweb.com/drl/antispam/custom.drl

For FreeBSD: /var/drweb.com/drl/antispam/custom.drl

AntispamUpdateEnabled

{Boolean}

Indicator that shows whether or not updating of the anti-spam library is allowed.

Allowed values:

Yes—updating is allowed and will be performed.

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

Default value: 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: /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: 0