Operating System Upgrade

Upgrading MetaDefender Sandbox from version 1.x.x to 2.x.x requires an operating system upgrade from Ubuntu 20.04 to Ubuntu 22.04 LTS. This guide shows how to upgrade Ubuntu before MetaDefender Sandbox is installed.

Backup your system

Before starting the Ubuntu upgrade process, please create a backup of your system if possible!

Step #1 - Unmonitor Sandbox services and delete monit service

sudo monit unmonitor fsiobroker
sudo monit unmonitor fsio
sudo systemctl stop monit
sudo systemctl disable monit
sudo apt-get purge -y monit

Step #2 - Stop and disable Sandbox services

Please be aware that the path /home/filescanio/FileScanIO can differ based on the configuration used for the installation.

sudo service fsioweb stop
sudo /home/filescanio/FileScanIO/shutdown_webservice.sh

sudo service fsiobroker stop
sudo service fsio stop

sudo systemctl disable fsioweb
sudo systemctl disable fsiobroker
sudo systemctl disable fsio

Step #3 - Uninstall docker and remove Tesseract PPA

sudo apt-get purge -y --allow-change-held-packages docker-ce docker-ce-cli docker-ce-rootless-extras docker-buildx-plugin docker-compose-plugin containerd.io

sudo rm -f /etc/apt/sources.list.d/alex-p-ubuntu-tesseract-ocr-focal.list

sudo apt autoremove -y

Step #4 - Upgrade Ubuntu from 20.04 LTS to 22.04 LTS

Please follow this guide to upgrade your operating system: https://www.cyberciti.biz/faq/upgrade-ubuntu-20-04-lts-to-22-04-lts/

Step #4.1 - Sandbox related configuration files

During the installation there could be questions about modified configuration files, e.g./etc/multitail.conf .

Please choose: Y or I : install the package maintainer's version.

Step #4.2 - Obsolete packages

It is recommended to remove obsolete packages during the upgrade process.

Step #4.3 - Enabling third party repositories or mirrors

When enabling these repositories in /etc/apt/sources.list.d please double check to use the correct version (22.04) and codename (jammy) in the .list files.

Step #5 - Upgrade MetaDefender Sandbox to 2.x.x

Please follow the guide on the Upgrade page.