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.

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.