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.
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.