Internal MongoDB upgrade procedure

Warning

This operation is not reversible and operates on a live DB. Please ensure a system backup before proceeding.

Before performing the upgrade, make sure that the host is compatible with the latest platform requirements for MongoDB.

Notice

This process should not be performed when using an external database, in this case the upgrade should be performed manually following the MongoDB provider documentation.

Instructions for upgrading MongoDB on 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:

SHA256	C79E06CA7D3268440B266A8C3E2CEC4E693AD5E3BFF82781D5AD5080E3FC5C7E
SHA1	6E64B122F628AB69E509721FE17588EA5A9C45C1
MD5	AFED1E97381689366F14A6A32E392051
Download Link

Steps

Edit the following file: /etc/mdss/customer.env
Modify MONGO_TAG=3.6 to MONGO_TAG=7.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 MongoDB on 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

Last updated on

Was this page helpful?