Update to 6.2#
Note
We highly recommend to update on a test instance first.
This documentation explains how to update to the Znuny 6.2 release.
Please note that your current system needs to be a:
Znuny 6.1.x
to perform the update. We do not support direct updates from any version of OTRS, ((OTRS)) Community Edition, Znuny LTS or before 6.1
Preparations#
Before the update can started we need to perform some tasks to prepare the update.
Check if every add-on your are using is available for version 6.2. You don’t have to care on packages which are already integrated, see the list of them in the release notes.
Create a backup of the database, the application and all data, especially the attachments.
# Stop the webserver
systemctl stop httpd # CentOS / RHEL
systemctl stop apache2 # Debian / Ubuntu
# Stop your local MTA, mostly Postfix, sometimes Exim or Sendmail
systemctl stop postfix
# Remove crontab, stop daemon
su -c 'bin/Cron.sh stop' - otrs
su -c 'bin/otrs.Daemon.pl stop' - otrs
Update via RPM#
The update via RPM.
You can find the correct URL for your RPM at https://www.znuny.org/releases.
# Update to Znuny 6.2 (RHEL 7 / CentOS 7)
yum update -y https://download.znuny.org/releases/RPMS/rhel/7/znuny-6.2.1-02.noarch.rpm
# Check for missing modules and add required modules
/opt/otrs/bin/otrs.CheckModules.pl --all
Update via source#
The installation from source takes some more steps. If there are more file to restore than mentioned in the restore block, add them by yourself.
# Download latest Znuny 6.2
cd /opt
wget https://download.znuny.org/releases/znuny-latest-6.2.tar.gz
# Extract
tar xfz znuny-latest-6.2.tar.gz
# Set permissions
/opt/znuny-6.2.1/bin/otrs.SetPermissions.pl
# Restore Kernel/Config.pm, articles, etc.
cp -av /opt/otrs/Kernel/Config.pm /opt/znuny-6.2.1/Kernel/
mv /opt/otrs/var/article/* /opt/znuny-6.2.1/var/article/
# Restore dotfiles from the homedir to the new directory
for f in $(find -L /opt/otrs -maxdepth 1 -type f -name .\* -not -name \*.dist); do cp -av "$f" /opt/znuny-6.2.1/; done
# Restore modified and custom cron job
for f in $(find -L /opt/otrs/var/cron -maxdepth 1 -type f -name .\* -not -name \*.dist); do cp -av "$f" /opt/znuny-6.2.1/var/cron/; done
# Delete the old symlink
rm /opt/otrs
# Create a symlink
ln -s /opt/znuny-6.2.1 /opt/otrs
# Check for missing modules and add required modules
/opt/otrs/bin/otrs.CheckModules.pl --all
Execute the migration script#
su - otrs
scripts/MigrateToZnuny6_2.pl
Update installed packages#
Note
Packages for earlier version of Znuny LTS (6.0.x) Znuny are might not compatible with Znuny 6.2 and have to be updated.
su - otrs
bin/otrs.Console.pl Admin::Package::UpgradeAll
Restart everything#
# Fill the crontab and wait(!) at least 5 minutes that the Daemon is started via cron
su -c 'bin/Cron.sh start' - otrs
# Start the webserver
systemctl start httpd # CentOS / RHEL
systemctl start apache2 # Debian / Ubuntu
# Start your local MTA, mostly Postfix, sometimes Exim or Sendmail
systemctl start postfix