Upgrading from a previous version

Upgrading from a previous version on Unix-based deployments

Preliminary notes

Upgrading is usually a two-step process:

1. upgrade the mdss package by installing the newer package
2. upgrade the existing code by downloading new images

Acquire the installer package

In order to acquire the new package please visit https://www.opswat.com/solution

Debian / Ubuntu package (.deb)

1. Update your packages

sudo apt-get update

2. Move to the folder containing the installer and install it

sudo dpkg -i <name of the file>.deb || sudo apt-get install -f

3. Start the service

sudo mdss -u update

4. Optionally, you can check the status using the following command:

sudo mdss -c status

5. Open a browser and navigate to the web interface: http://<server> to configure your deployment.

Red Hat Enterprise Linux / CentOS package (.rpm)

1. Update your packages

sudo yum -y update

2. Move to the folder containing the installer and install it

sudo yum upgrade <name of the file>.rpm

3. Start the service

sudo mdss -u update

4. Optionally, you can check the status using the following command:

sudo mdss -c status

5. Open a browser and navigate to the web interface: http://<server> to configure your deployment.

Offline Upgrade

1. Download the latest MDSS installation package from My OPSWAT portal.
2. Download latest MDSS deployment.zip
3. Stop the service

sudo mdss -c stop

4. Run the installation script

sudo dpkg -i <name of the file>.deb

5. Extract deployment.zip folder and load the container images

unzip deployment.zip -d <extracting_path>/

cd <extracting_path>/

sudo docker load -i ./mdcs.tar

6. Start the service

sudo mdss -c start

Upgrading from a previous version on Windows-based deployments

Upgrading from v2.1.3 or below

Before your upgrade, please verify your docker and docker-compose version by running the following commands:

• docker -v
• docker-compose -v

If your docker version is below 20.10.3 please run the following commands in order to upgrade your docker installation:

1. Upgrade to the latest available version

Install-Package -Name Docker -ProviderName DockerMSFTProvider -Update -Force -RequiredVersion 20.10.6

2. A restart is required for the installation to complete

Restart-Computer

If your docker-compose version is below 1.28.5 please run the following command in order to upgrade your docker-compose installation:

Invoke-WebRequest "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-Windows-x86_64.exe" -UseBasicParsing -OutFile $Env:ProgramFiles\Docker\docker-compose.exe

Before you proceed, verify that your docker install was upgraded by running docker -v and docker-compose -v again. If everything looks good, please proceed by running the new installer.

Upgrading from v2.1.4 or above

To upgrade from a previous version, running the new installer is enough. The installer will walk you through the installation wizard.

Upgrading from v2.1.5 or below

When upgrading from v2.1.5 or older versions, a warning box may pop up with the following message:

Service 'MetaDefender Storage Security' (mdss) could not be stopped. Verify if you have sufficient privileges to stop system services.

The issue and the steps to solve it have been documented here.