Site Overlay

Migration of a Mayan Instance from Ubuntu 20.04 VirtualBox to Ubuntu 22.04 Server

1. Installation of Mayan on Ubuntu 22.04 Server

First thing we have to do is to put a naked installation of Mayan on the new Ubuntu 22.04 Server. Installation steps are well described in the official Mayan documentation. These instructions refer to Debian 11 though, and there are some minor hurdles to take to make Mayan work on Ubuntu 22.04.

Step 1: Modify apt package installations

Need Python packages for version 3.8, not default 3.10

The first problem to be solved is that Ubuntu 22.04 ships with Python 3.10 installed whereas we need Python 3.8 or pip will later fall when installing the mayan-edms PyPI package.

Therefore we activate the deadsnakes PPA as follows:

For any Python apt package that is installed in step 1, we will (later) install a Python 3.8 package instead: pyhton3-dev becomes python3.8-dev and pyhton3-venv becomes python3.8-venv.

libldap

libldap-2.4-2 is not available under Ubuntu 22.04, but its more recent version 2.5-0 is. We therefore tell apt to install libldap-2.5-0.

The complete command to install packages in step 1 therefore is:

Step 4: Create Python venv

Naturally, after installing Python 3.8 in the previous section, we have to make sure that our virtual environment is also based on Python 3.8 and not on the 3.10 version that Ubuntu provides by default. We therefore modify the creation command for the virtual environment in step 4 as follows: