Upgrade MDSS

Upgrading is typically a two-step process:

1. Upgrade the mdss package by installing the newer version.
2. Update the codebase by downloading and applying new container images.

Upgrading to version 4.0.0 or newer

Starting with version 4.0.0 of MDSS the database will be migrated from MongoDB to PostgreSQL. Please follow the Upgrade Guide to PostgreSQL to ensure the upgrade completes successfully and all data is migrated.

Unix-Based Systems

Step 1: Download the Installer

Visit My OPSWAT to download the latest .deb or .rpm package. For offline deployments, follow the Offline Upgrade instructions.

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 MetaDefender Storage Security Installation Package from My OPSWAT portal.
2. Download the latest MetaDefender Storage Security Offline Docker Tool Kit from My OPSWAT portal.

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 v3.4.0 or newer

To upgrade from a previous version, running the new installer is enough. The installer will walk you through the Windows Installation Wizard Section

Upgrading from v3.3.4 or earlier to v3.4.0 or newer

Upgrading to v.3.4.0 from an older version requires a special procedure due to major architectural changes. If a clean install with configuration import is not possible, please see the steps below.

Caution: This operation modifies a live database. Errors may cause irreversible data loss. Proceed with caution and ensure adequate backups. We advise on performing this operation only if absolutely necessary.

All commands should be run in a PowerShell terminal.

1. Update MDSS to the latest version

.\mdss.ps1 -u update

2. Edit the following file: C:\Program Files\OPSWATMetaDefender Storage Security\docker\docker-compose.main.linux.yml
3. Under the mongodb container modify the image to use version 6.0. It should look like this:

version: '3'

services:

    mongodb:

        platform: linux/amd64

        image: "mongo:6.0"

        volumes:

            - mongo_db:/data/db

4. Repeat procedure for C:\Program Files\OPSWATMetaDefender Storage Security\docker\docker-compose.main.all.linux.yml
5. Run the upgrade command from the installation directory (C:\Program Files\OPSWAT\MetaDefender Storage Security\docker):

.\mdss.ps1 -u upgrade_db

Depending on you DB size, this operation will may take more than 30 minutes

6. After upgrade is finished, export the DB

.\mdss.ps1 -u export_db

7. Copy the exported DB archive to a different location, ex: C:\temp
8. In that different location, extract the archive

tar -xf .\db_{timestamp}.tar

9. Compress the files in a zip format

Compress-Archive .\dump\  db_{timestamp}.zip

10. Uninstall MetaDefender Storage Security 3.3.4 as documented Uninstall.
11. Run the latest installer for MetaDefender Storage Security as documented Installation Methods
12. Run the stop command from the installation directory (C:\Program Files\OPSWAT\MetaDefender Storage Security\scripts)

.\mdss.ps1 -c stop

13. Copy the .zip file you created eariler (db__{timestamp}_.zip) to the installation directory (by default, (C:\Program Files\OPSWAT\MetaDefender Storage Security)
14. Import the DB

.\mdss.ps1 -u import_db

15. Run the start command:

.\mdss.ps1 -c start