9.1.2. Upgrading Dr.Web Enterprise Server for UNIX® System-Based OS

Upgrading the Server software over the previous version is possible not for all UNIX system-based OS. Thus, under UNIX system-based OS, in which upgrading is not supported, it is recommended to delete the Server software of previous versions and install the 6.0.4 version.

Saving Configuration Files

After the Server has been removed, the following files will remain:

File

Description

Default folder

dbinternal.dbs

internal database

for Linux OS: /var/opt/drwcs/

for Solaris and FreeBSD OS: /var/drwcs/

drwcsd.conf (the name may vary)

Server configuration file

for Linux OS: /var/opt/drwcs/etc

for Solaris and FreeBSD OS: /var/drwcs/etc

webmin.conf

Dr.Web Control Center configuration file

common.conf

configuration file (for some UNIX system-based OS)

enterprise.key (the name may vary)

Server  license key file

agent.key (the name may vary)

Agent license key file

certificate.pem

SSL certificate

private-key.pem

RSA private key

drwcsd.pri

private encryption key

drwcsd.pub

public encryption key

for Linux and Solaris OS:

/opt/drwcs/Installer/

/opt/drwcs/webmin/install

for FreeBSD OS:

/usr/local/drwcs/Installer/

/usr/local/drwcs/webmin/install

Saving Database

Before upgrade Dr.Web Enterprise Security Suite software, it is recommender to backup database.

To backup database:

1.Stop the Server.

2.Export DB to the file:

For FreeBSD OS:
# /usr/local/etc/rc.d/drwcsd.sh exportdb /var/drwcs/etc/esbase.es

For Linux OS:
# /etc/init.d/drwcsd exportdb /var/opt/drwcs/etc/esbase.es

For Solaris OS:
# /etc/init.d/drwcsd exportdb /var/drwcs/etc/esbase.es

For Servers with external DB, it is recommended to use standard tools supplied with the database.

 

Make sure, that Dr.Web ESS DB export completed successfully. If DB backup copy is not  available, the Server could not be restored in emergency case.

 

Important Notes

 

All actions must be performed under the root administrator account.

 

During Server update to 6.0.4 version from 5.0 and earlier versions, it is necessary to delete the repository and install the new repository.

 

For a network with several Severs, from the main Server with 6.0.4 version to child Servers with 5.0 and earlier versions, only virus bases are transmitted.

To transmit all software and Agent updates, upgrade child Servers to 6.0.4 version (for repositories  compatibility).

 

Starting from version 5.0 anti-virus package includes SpIDer Gate and Office Control components. For using this components, they must be included in you license (Antivirus+Antispam). If you license does not include this components, it is recommended to perform the actions described below.

 

Automatic Upgrade

If you update the Server from 5.XX version to 6.0.4 version for Linux OS, instead of deleting old version and installing new version of the Server, you can use the following commands to update the Server:

for rpm: rpm -U <package_name>

for dpkg: dpkg -i <package_name>
for upgrading deb packages, the /root/drwcs catalog must be empty or absent.

All automatically saved files will be stored in corresponding directories and manual replacement is not required.

During upgrade of package for rpm distribution kits of 5.0 or 6.0 Server, if before Server upgrade, the webmin.conf Control Center configuration file had been changed, the webmin.conf file is saved form the old version, and the new file is created with the webmin.conf.rpmnew name.

If you want to use functional, provided by changed parameters of configuration file (and also, the Agent installer could be available at http://<server_name>:9080/install page, see Installation Files), copy all changed settings from the old file to the new file and rename the webmin.conf.rpmnew new file to the webmin.conf with replace.

Manual Upgrade

If using an internal database:

1.Stop the Enterprise Server.

2.If you plan to use any files (besides files which are copied automatically during Server uninstall at step 4), backup these files manually. For instance, copy the report templates to a backup folder.

3.Remove the contents of the repository.

4.Remove Enterprise Server software (see Uninstalling the Dr.Web Enterprise Server Software for UNIX system-based OS). You will be prompt to create backup copies, for this specify a folder where to store the backup or accept the default folder.

5.Install Enterprise Server version 6.0.4 (see Installing the Dr.Web Enterprise Server for UNIX system-based OS).

6.After new install, you can replace automatically created files with the backup copies from the previous installation. In case of automatic backup, replace the files in the following folders:

Files

Paths under OSes

Linux

Solaris

FreeBSD

drwcsd.pub

/opt/drwcs/Installer/

/opt/drwcs/webmin/install

/usr/local/drwcs/Installer/

/usr/local/drwcs/webmin/install

dbinternal.dbs

/var/opt/drwcs/

/var/drwcs/

drwcsd.conf

drwcsd.pri

enterprise.key

agent.key

certificate.pem

private-key.pem

/var/opt/drwcs/etc

/var/drwcs/etc

 

Dr.Web Control Center configuration file (webmin.conf) of versions, that is earlier than 6.0.2, is not compatible with the 6.0.4 version software. After upgrading the Server of version, that is earlier than 6.0.2, you cannot replace a new configuration file with a backup copy of the 4.XX configuration file and have to make all necessary changes manually.

 

In case of manual backup, replace the files in the same folders from which you copied the files before new install.

 

For all backup files from the previous Server version (see step 6) assign the user, selected at the installation of the new Server version (drwcs by default), as files owner.

 

7.To upgrade the databases, execute the following commands:

for Linux OS and Solaris OS: /etc/init.d/drwcsd upgradedb

for FreeBSD OS: /usr/local/etc/rc.d/drwcsd.sh upgradedb

8.Launch Enterprise Server.

9.Set up repository upgrade and perform the upgrade.

10.Restart the Server.

If using an external database:

1.Stop Enterprise Server.

2.If you plan to use any files (besides files which are copied automatically during Server uninstall at step 4), backup these files manually. For instance, copy the report templates to a backup folder.

3.Remove the contents of the repository.

4.Remove Enterprise Server software (see the Uninstalling the Dr.Web Enterprise Server Software for UNIX system-based OS section). You will be prompt to create backup copies, for this, specify a folder where to store the backup or accept the default folder.

5.Install Enterprise Server version 6.0.4 (see p. Installing the Dr.Web Enterprise Server for UNIX system-based OS).

6.Move the automatic saved files (see above) to:

for Linux OS: to /var/opt/drwcs/etc, except for the public key. The latter must be saved to /opt/drwcs/Installer/ and to /opt/drwcs/webmin/install

for FreeBSD OS: to /var/drwcs/etc, except for the public key. The latter must be saved to /usr/local/drwcs/Installer/ and to/usr/local /drwcs/webmin/install

for Solaris OS: to /var/drwcs/etc, except for the public key. The latter must be saved to /opt/drwcs/Installer/ and to /opt/drwcs/webmin/install

In case of manual backup, replace the files in the same folders from which you copied the files before new install.

 

For all backup files from the previous Server version (see step 6) assign the user, selected at the installation of the new Server version (drwcs by default), as files owner.

 

7.To upgrade the databases, execute the following commands:

for Linux OS and Solaris OS:

/etc/init.d/drwcsd upgradedb

for FreeBSD OS:

/usr/local/etc/rc.d/drwcsd.sh upgradedb

8.Launch Enterprise Server.

9.Set up repository upgrade and perform the upgrade.

10.Restart the Server.

In upgrading procedure of the Dr.Web Enterprise Server to version 6.0.4, it is recommend to do the following:

1.Before upgrading disable the use of communication protocols with Enterprise Agent and the Network installer. To do this, select the Administration item in the main menu and click Configure Dr.Web Enterprise Server  in the control menu, go to the Modules tab and clear the Protocol Dr.Web Enterprise Agent and the Protocol Dr.Web Network Installer flags. Click Save. A request to restart the Server will be opened. Click Yes.

2.Upgrade the Server to version 6.0.4 as described above (using preserved Server configuration file).

3.After upgrading the Server, configure the set of components installed at the workstations (see p. Anti-Virus Package Composition), in particular if you do not have Antispam license, the cannot option for the SpIDer Gate and Office Control components must be set.

4.Update the components of Dr.Web ESS. To do this, select the Administration item in the main menu and click Repository state in the control menu. In the opened window click Check for updates. Beforehand configure the proxy servers settings for GUS updating if necessary.

5.If necessary, configure ports that is using by the Agents for communication with the Server. To do this, use the Administration Configure Dr.Web Enterprise Server Transport tab.

6.Enable the use of communication protocols with Enterprise Agent and the Network installer, disabled at step 1.

7.Upgrade the workstations software.

The upgraded anti-virus program is ready for operation.

 

After the Server upgrading from the 4.XX version to 6.0.4 version, the transport parameter must be present in the drwcsd.conf configuration file of the Server:

Transport "drwcs" "tcp/0.0.0.0:2193" "udp/231.0.0.1:2193"

where the drwcs is a Server name.

If this parameter is not specified, add it manually and restart the Server.