Updates

Bemerkung

Es wird dringend empfohlen, zuerst ein Test-Update auf einem separaten Testsystem durchzuführen.

Bemerkung

Auf Debian-System kann es erforderlich sein, dass man einige perl-Pakete manuell installieren muss, bevor man von 10.0 auf 10.1 upgraden kann

sudo apt-get install -y libarchive-zip-perl libtimedate-perl libdatetime-perl libconvert-binhex-perl libcgi-psgi-perl libdbi-perl libdbix-connector-perl libfile-chmod-perl liblist-allutils-perl libmoo-perl libnamespace-autoclean-perl libnet-dns-perl libnet-smtp-ssl-perl libpath-class-perl libsub-exporter-perl libtemplate-perl libtemplate-perl libtext-trim-perl libtry-tiny-perl libxml-libxml-perl libyaml-libyaml-perl libdbd-mysql-perl libapache2-mod-perl2 libmail-imapclient-perl libauthen-sasl-perl libauthen-ntlm-perl libjson-xs-perl libtext-csv-xs-perl libpath-class-perl libplack-perl libplack-middleware-header-perl libplack-perl libplack-middleware-reverseproxy-perl libencode-hanextra-perl libio-socket-ssl-perl libnet-ldap-perl libcrypt-eksblowfish-perl libxml-libxslt-perl libxml-parser-perl libconst-fast-perl

Schritt 1: Alle relevanten Dienste und den OTOBO Daemon stoppen

Stellen Sie sicher, dass keine Dienste oder Cronjobs mehr aktiv sind und auf OTOBO zugreifen möchten. Hierfür ist ausschlaggebend, wie Ihre Dienste konfiguriert sind.

sudo systemctl stop postfix
sudo systemctl stop apache2
sudo systemctl stop cron

Stoppen Sie alle OTOBO Cron Jobs und den Daemon (in dieser Reihenfolge):

cd /opt/otobo/
sudo -u otobo bin/Cron.sh stop
sudo -u otobo bin/otobo.Daemon.pl stop

Schritt 2: Dateien und Datenbank sichern

Erstellen Sie ein Backup des gesamten /opt/otobo-Verzeichnis sowie der Datenbank.

Beispiel für eine Standardinstallation mit Ubuntu und MySQL

sudo mkdir /root/otobo-update                            # Create a update directory
cd /root/otobo-update                                    # Change into the update directory
sudo cp -pr /opt/otobo otobo-prod-old                    # Backup the hole OTOBO directory to the update directory
sudo mysqldump -u otobo -p otobo -r otobo-prod-old.sql   # Backup the otobo database to otobo-prod-old.sql

Stellen Sie sicher, dass alle Dateien valide sind. Sie haben nun ein Backup mit allen benötigten Daten.

Warnung

Fahren Sie nicht fort, ohne ein vollständiges Backup Ihres Systems zu erstellen. Sie können dafür auch das Backup und Wiederherstellung-Skript verwenden.

Schritt 3: Neues Release installieren

Download the latest OTOBO release from https://ftp.otobo.org/pub/otobo/.

cd /opt/otobo-update                                                      # Change into the update directory
sudo wget https://ftp.otobo.org/pub/otobo/otobo-latest-10.1.tar.gz        # Download the latest OTOBO 10.1 release

Bemerkung

(Optional) It’s recommended to validate the downloaded file’s integrity before continuing. This has should be done in the same folder than the tar.gz file obtained previously.

sudo wget https://ftp.otobo.org/pub/otobo/checksums/otobo-latest-10.1.tar.gz.sha256
sudo sha256sum -c otobo-latest-10.1.tar.gz.sha256

The output from the last prompt should be „OK“. Otherwise the installation with that file shouldn’t be continued.

After that, unpack the source archive (for example, using tar) into the directory /opt/otobo-update:

sudo tar -xzf otobo-latest-10.1.tar.gz                           # Unzip OTOBO
sudo cp -r otobo-10.1.*/* /opt/otobo                             # Copy the new otobo directory to /opt/otobo

Alte Konfigurationsdateien wiederherstellen

In OTOBO 10 reicht es aus, die Datei Kernel/Config.pm zu kopieren.

cd /root/otobo-update
sudo cp -p otobo-prod-old/Kernel/Config.pm /opt/otobo/Kernel/
sudo cp -p otobo-prod-old/var/cron/* /opt/otobo/var/cron/

Artikeldaten wiederherstellen

Wenn Sie OTOBO so konfiguriert haben, dass Artikeldaten im Dateisystem gespeichert werden, müssen Sie den Ordner article in /opt/otobo/var/ (oder in dem in der Systemkonfiguration angegebenen Ordner) wiederherstellen.

cd /root/otobo-update
sudo cp -pr otobo-prod-old/var/article/* /opt/otobo/var/article/

Bereits installierte Standardstatistiken wiederherstellen

Wenn Sie zusätzliche Pakete mit Standardstatistiken haben, müssen Sie die XML-Statistikdateien mit dem Suffix *.installed in /opt/otobo/var/stats wiederherstellen.

cd /root/otobo-update/otobo-prod-old/var/stats
sudo cp *.installed /opt/otobo/var/stats

Dateiberechtigungen anpassen

Führen Sie folgenden Befehl aus, um die Datei- und Verzeichnis-Berechtigungen für OTOBO zu definieren. Es wird versucht, die passenden Benutzer- und Gruppeneinstellungen für Ihr Setup zu ermitteln.

sudo /opt/otobo/bin/otobo.SetPermissions.pl

Apache-Konfigurationsdateien überprüfen

Neuere Versionen von OTOBO können dich dazu veranlassen, die Apache-Konfiguration anzupassen. Ab Version 10.1 sind wir von CGI zu PSGI gewechselt. Schau dir scripts/apache2-httpd-vhost-443.include.conf an, um zu sehen, welche Einstellungen angepasst/hinzugefügt werden müssen.

Schritt 4: Überprüfung auf neu benötigte perl-Module

OTOBO benötigt für einige Versionssprünge neue CPAN-Pakete. Bitte prüfen Sie, ob neue Pakete benötigt werden und installieren Sie diese gegebenenfalls.

Bemerkung

Auf Debian-Systemen kann es notwendig sein, einige Pakete manuell zu installieren:

sudo apt-get install -y libarchive-zip-perl libtimedate-perl libdatetime-perl libconvert-binhex-perl libcgi-psgi-perl libdbi-perl libdbix-connector-perl libfile-chmod-perl liblist-allutils-perl libmoo-perl libnamespace-autoclean-perl libnet-dns-perl libnet-smtp-ssl-perl libpath-class-perl libsub-exporter-perl libtemplate-perl libtemplate-perl libtext-trim-perl libtry-tiny-perl libxml-libxml-perl libyaml-libyaml-perl libdbd-mysql-perl libapache2-mod-perl2 libmail-imapclient-perl libauthen-sasl-perl libauthen-ntlm-perl libjson-xs-perl libtext-csv-xs-perl libpath-class-perl libplack-perl libplack-middleware-header-perl libplack-perl libplack-middleware-reverseproxy-perl libencode-hanextra-perl libio-socket-ssl-perl libnet-ldap-perl libcrypt-eksblowfish-perl libxml-libxslt-perl libxml-parser-perl libconst-fast-perl
sudo -u otobo perl /opt/otobo/bin/otobo.CheckModules.pl --list

Schritt 5: Aktualisieren bereits installierter Pakete und Konfiguration neukonfigurieren

Sie können den folgenden Befehl verwenden, um alle installierten Pakete zu aktualisieren. Dies funktioniert für alle Pakete, die in Online-Repositorys verfügbar sind. Alle anderen Pakete können Sie später über den Paketmanager aktualisieren (dies erfordert einen laufenden OTOBO-Daemon).

sudo -u otobo /opt/otobo/bin/otobo.Console.pl Admin::Package::ReinstallAll
sudo -u otobo /opt/otobo/bin/otobo.Console.pl Admin::Package::UpgradeAll
sudo -u otobo /opt/otobo/bin/otobo.Console.pl Maint::Config::Rebuild

Schritt 6: Nur für Minor- oder Major-Release-Upgrades (zum Beispiel für ein Upgrade von 10.0 auf 10.1)

sudo -u otobo /opt/otobo/scripts/DBUpdate-to-10.1.pl

Schritt 7: Dienste starten

Starten Sie OTOBO Cron Jobs und den Daemon (in dieser Reihenfolge):

cd /opt/otobo/
sudo -u otobo bin/otobo.Daemon.pl start
sudo -u otobo bin/Cron.sh start

Jetzt können die Dienste wieder gestartet werden. Wie genau vorzugehen ist, hängt von deren Konfiguration ab. Ein Beispiel:

sudo systemctl start postfix
sudo systemctl start apache2
sudo systemctl start cron

Jetzt können Sie sich an Ihrem System anmelden.