The original documentation to upgrade Znuny 6.0 to latest 6.1 is focused on many different Linux distributions. Here we focus on Ubuntu 20.04 LTS (shall work also with 22.04 LTS).
If you are a administrator of OTRS/Znuny and mostly maintaining the (web-)servers based on Linux or like recommended from our side on Ubuntu, you may face also the issues, that the major issues come from a unclear documentation of OTRS/Znuny. And it looks like the documentation was made by very experienced admins or developers TO very experienced Znuny admins or Znuny developers.
In this article you will find tools and paths how to ensure a clean migration from Znuny 6.0 to Znuny 6.1 under Ubuntu 20.04.
How to get started?
In the article Prepare / start a upgrade / migration of OTRS / Znuny all steps are explained.
Read and execute them carefully to avoid data or e-mail losses!
Doing the migration from Znuny 6.0 to 6.1
The migration is separated into 3 steps.
Now let us prepare the migration steps.
First you have to check your installed packages in Znuny. In all our tests the autoupgrade of the packages failed, even if this feature shall work from the commit history.
Therfore best way is to note your custom installed packages and to uninstall them. You can later reinstall them easily.
Go to /otrs/index.pl?Action=AdminPackageManager or manually via navigating to Admin > Package Manager
Under Local Repository you will find your installed Packages.
Fetch the migration script
We have provided you the steps as a script to avoid typos or common mistakes.
First we ensure our required packages are installed
sudo apt install wget findutils git screen
Now fetch the scripts
cd /opt git clone https://github.com/itgovernanceportal/otrs-znuny-helpers.git cd /opt/otrs-znuny-helpers/migrationHelpers/znuny60_2_znuny61
Starting the migration from OTRS to Znuny
Now we can start with the migration itself.
Now run the download znuny and integrate our prior backuped configuration files
Even with big installations 10 million tickets this migration shall only take a few minutes.
You will see some output like this:
Step 15 of 19: Clean up the cache ... Step 16 of 19: Rebuild configuration another time ... Step 17 of 19: Deploy ACLs ... Step 18 of 19: Deploy processes ... Step 19 of 19: Check invalid settings ... Migration completed! clean caches Deleting cache... Done. Deleting all sessions... asdfasdfggaabcdefghiasdfasdf Done. upgrading installed packages There are no installed packages Done.
If you are lucky the migration went through without any issues. If not see the related articles, if some of your issues is already covered there.
Reinstall your packages
Now reinstall your deinstalled packages and you are done with your migration