Database upgrade

Instructions for upgrading MetaDefender Storage Security version 3.4.2 or newer

In order to upgrade the MongoDB instance deployed as a docker image alongside MDSS, up to version 6.0, the desired version can be set in customer.env and the upgrade performed using the flag -u upgrade_db.

• This process will attempt to pull all intermediate major versions between 3.6 and 6.0.
• If operating in an offline environment, ensure you download the required image archive for all intermediate versions in advance and perform a docker load before initiating the upgrade. Link below:

Steps

• Edit the following file: /etc/mdss/customer.env
• Modify MONGO_TAG=3.6 to MONGO_TAG=6.0
• Run the upgrade command: mdss -u upgrade_db

In some cases when also upgrading the product from an older version, you will need to perform the following additional steps after running the DB upgrade command:

• Edit the following file: /etc/mdss/docker-compose.main.linux.yml
• Replace image: "mongo:3.6" with image: "mongo:${MONGO_TAG}" . As shown below:

version: '3'

services:

    mongodb:

        platform: linux/amd64

        image: "mongo:${MONGO_TAG}"

        volumes:

            - mongo_db:/data/db

Instructions for upgrading MetaDefender Storage Security version 3.4.1 or earlier

In order to upgrade the MongoDB instance deployed as a docker image alongside MDSS, up to version 6.0, the desired version can be set in docker-compose.main.linux.yml and the upgrade performed using the flag -u upgrade_db.

• The mongodb section in docker-compose.main.linux.yml should look like this if upgrading to v6.0:

version: '3'

services:

    mongodb:

        platform: linux/amd64

        image: "mongo:6.0"

        volumes:

            - mongo_db:/data/db

Steps

• Edit the following file: /etc/mdss/docker-compose.main.linux.yml
• Run the upgrade command: mdss -u upgrade_db

Steps for Windows deployments with Docker

• Edit the following file: C:\Program Files\OPSWAT\MetaDefender for Secure Storage\docker\docker-compose.main.linux.yml
• Run the upgrade command from the installation directory (C:\Program Files\OPSWAT\MetaDefender for Secure Storage\docker): .\mdss.ps1 -u upgrade_db