Upgrading from a previous version
Upgrading from a previous version on Unix-based deployments
Preliminary notes
Upgrading is usually a two-step process:
- upgrade the mdss package by installing the newer package
- 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
In case of an offline deployment, the MDSS offline package also has to be acquired from here: https://metascanbucket.s3.amazonaws.com/Metadefender/MetaDefender_Secure_Storage_resources_v3/latest/deployment.zip
In this scenario the upgrade steps below have the following changes:
Updating packages might not work when offline, this can be skipped if the packages are already up to date.
Before running the installer, the offline package must be loaded with
docker load -i <extracted_archive_path>\mdcs.tar
as in the offline installation steps.The
sudo mdss -u update
command is replaced withsudo mdss -c start
since the update has been performed with the offline package.
Debian / Ubuntu package (.deb)
- Update your packages
- Move to the folder containing the installer and install it
- Start the service
- Optionally, you can check the status using the following command:
- Open a browser and navigate to the web interface: http://<server> to configure your deployment.
Red Hat Enterprise Linux / CentOS package (.rpm)
- Update your packages
- Move to the folder containing the installer and install it
- Start the service
- Optionally, you can check the status using the following command:
- Open a browser and navigate to the web interface: http://<server> to configure your deployment.
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:
- Upgrade to the latest available version
- A restart is required for the installation to complete
If your docker-compose version is below 1.28.5 please run the following command in order to upgrade your docker-compose installation:
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 for Secure Storage' (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.