Aktualisieren

Schritt 1: Alle relevanten Dienste und den OTRS Deamon beenden

Stellen Sie sicher, dass keine weiteren Dienste oder Cron-Jobs mehr vorhanden sind, die versuchen, auf OTRS zuzugreifen. Dies hängt von Ihrer Dienstkonfiguration und der OTRS-Version ab.

Die folgenden systemctl -Befehle sind nur Beispiele und können sich auf dem Zielsystem unterscheiden, wenn es einen anderen Mailer oder Webserver verwendet.

root> systemctl stop postfix
root> systemctl stop apache2
root> systemctl stop otrs-daemon
root> systemctl stop otrs-webserver

Schritt 2: Dateien und Datenbank sichern

Erstellen Sie eine Sicherung der folgenden Dateien und Ordner:

• Kernel/Config.pm

• Kernel/WebApp.conf

• var/*

• Dateien, die nicht Teil des offiziellen Release-Pakets sind, aber manuell dem System hinzugefügt werden (benutzerdefinierte Sprachdateien, Logos, CSS-Stylesheets, XML-Konfiguration usw.)

• ebenfalls die Datenbank

Schritt 3: Das neue Release installieren

Sie können entweder otrs-patchlevel-update-x.y.z.tar.gz oder otrs-patchlevel-update-x.y.z.tar.bz2 erhalten. Entpacken Sie das Quellarchiv (z. B. mit tar ``) in das Verzeichnis ``/opt und erstellen Sie einen symbolischen Link /opt/otrs , der auf /opt/otrs-x.y.z verweist.

Vergessen Sie nicht die Versionsnummern zu ersetzen!

Befehl für entpacken von otrs-patchlevel-update-x.y.z.tar.gz:

root> tar -xzf otrs-patchlevel-update-x.y.z.tar.gz -C /opt

Befehl für entpacken von otrs-patchlevel-update-x.y.z.tar.bz2:

root> tar -xjf otrs-patchlevel-update-x.y.z.tar.bz2 -C /opt

Es wird empfohlen, einen symbolischen Link mit dem Namen /opt/otrs zu erstellen, der immer auf die neueste OTRS-Version verweist. Die Verwendung eines symbolischen Links erleichtert die Verwaltung der OTRS-Updates, da Sie das Verzeichnis der vorherigen Version unberührt lassen können, nur der symbolische Link muss geändert werden.

Führen Sie diesen Befehl aus, um einen symbolischen Link zu erstellen:

root> ln -fns /opt/otrs-x.y.z /opt/otrs

Wenn Sie das Update rückgängig machen müssen, können Sie das Ziel des symbolischen Links ändern, wenn Sie das Migrationsskript bereits in Schritt 4 nicht ausgeführt haben. Wenn das Migrationsskript ausgeführt wurde, muss die Datenbank im Falle eines Rollbacks aus dem Backup wiederhergestellt werden.

root> cd OTRS-BACKUP/var/stats
root> cp *.installed /opt/otrs/var/stats

root> /opt/otrs/bin/otrs.SetPermissions.pl

root> perl /opt/otrs/bin/otrs.CheckEnvironment.pl
Checking for Perl Modules:
  o Archive::Tar.....................ok (v1.90)
  o Archive::Zip.....................ok (v1.37)
  o Crypt::Eksblowfish::Bcrypt.......ok (v0.009)
...

root> /opt/otrs/bin/otrs.CheckEnvironment.pl --list

Schritt 4: Migrationsskript ausführen

Das Migrationsskript führt viele Überprüfungen auf Ihrem System durch und gibt Ihnen Ratschläge, wie Sie fehlende Perl-Module usw. installieren können, falls dies erforderlich ist. Erfolgten alle Prüfungen, werden die notwendigen Migrationsschritte durchgeführt.

Migrationsskript ausführen:

otrs> /opt/otrs/scripts/DBUpdate.pl

Das Migrationsskript überprüft auch, ob ACLs und Systemkonfigurationseinstellungen korrekt sind. Im Falle einer ungültigen Systemkonfigurationseinstellung bietet das Skript eine Möglichkeit zur Korrektur, indem es aus einer Liste möglicher Werte ausgewählt wird. Wenn das Skript in einem nicht interaktiven Modus ausgeführt wird, werden ungültige Einstellungen automatisch korrigiert. Wenn dies fehlschlägt, werden Sie aufgefordert, die Einstellung nach der Migration manuell zu aktualisieren.

Wenn veraltete ACLs vorhanden sind, kann das System sie nicht automatisch korrigieren. Sie müssen vom Administrator korrigiert werden. Weitere Informationen finden Sie im letzten Schritt für manuelle Änderungen.

Schritt 5: Installierte Pakete aktualisieren

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. Sie können andere Pakete später über den Paketmanager aktualisieren (dies erfordert einen laufenden OTRS-Daemon).

otrs> /opt/otrs/bin/otrs.Console.pl Admin::Package::UpgradeAll
otrs> /opt/otrs/bin/otrs.Console.pl Admin::Package::ReinstallAll

Schritt 6: Ihre Dienste starten

Danach können die Services gestartet werden. Dies hängt von Konfiguration Ihrer Services ab. Hier ein Beispiel:

root> systemctl start postfix
root> systemctl start apache2

Schritt 7: OTRS-Daemon und Webserver starten

Die OTRS-Webanwendung wird beim ersten Start für die neue Version erstellt. Dies kann eine Weile dauern und verursacht eine Zeitüberschreitung, wenn es mit den systemd-Befehlen gestartet wird. Um dies zu verhindern, starten Sie den OTRS-Webserver einmal als „ OTRS ‚` -Benutzer, um die OTRS-Webanwendung zu erstellen, und stoppen Sie sie anschließend. Dann kann es mit den systemd-Befehlen als „ root „ user gestartet werden.

otrs> ~/bin/otrs.WebServer.pl --deploy-assets
otrs> ~/bin/otrs.WebServer.pl --stop

OTRS enthält Beispiel Systemd-Konfigurationsdateien, mit denen sichergestellt werden kann, dass der OTRS-Daemon und der Webserver nach dem Systemstart automatisch gestartet werden.

root> systemctl start otrs-daemon
root> systemctl start otrs-webserver

Jetzt können Sie sich in Ihrem System anmelden.

Schritt 8: Manuelle Migrationsaufgaben und -änderungen

Die Systemwartungsfunktion wurde gestrichen.

Mit OTRS 8 ist eine neue Standard-Passwortrichtlinie für Agenten und Kundenbenutzer in Kraft getreten. Die Regeln der Passwortrichtlinien können in der Systemkonfiguration geändert werden (PreferencesGroups###Password und CustomerPersonalPreference###Password).

Es ist auch möglich, einige Ausnahmen von der Passwortrichtlinie für Agenten oder Kundenbenutzer hinzuzufügen. Bitte überprüfen Sie die folgenden Konfigurationsoptionen für Details:

• PasswordPolicy::ExceptAgentPasswordComplexity

• PasswordPolicy::ExceptAgentPasswordTTL

• PasswordPolicy::ExceptAgentPasswordHistory

• PasswordPolicy::ExceptAgentPasswordChangeAfterFirstLogin

• PasswordPolicy::ExceptCustomerPasswordComplexity

• PasswordPolicy::ExceptCustomerPasswordTTL

• PasswordPolicy::ExceptCustomerPasswordHistory

• PasswordPolicy::ExceptCustomerPasswordChangeAfterFirstLogin

Da die alten Bildschirmmasken der Kundenoberfläche nicht mehr vorhanden sind, müssen einige ACLs vom Administrator manuell korrigiert werden. Das Migrationsskript hat Sie bereits informiert, wenn dies der Fall ist.

Betroffene ACLs sind solche, die sich auf eine nicht vorhandene Bildschirmmaske für die Kundenoberfläche in ihrer „Action“-Einstellung beziehen. Diese Frontend-Regel muss durch eine entsprechende Endpunkt-Regel ersetzt werden. Eine Tabelle mit möglicher Zuordnung finden Sie nachfolgend.

root> /usr/share/elasticsearch/bin/elasticsearch-plugin remove analysis-icu
root> /usr/share/elasticsearch/bin/elasticsearch-plugin remove ingest-attachment
root> /usr/share/elasticsearch/bin/elasticsearch-plugin install --batch ingest-attachment
root> /usr/share/elasticsearch/bin/elasticsearch-plugin install --batch analysis-icu

root> /usr/share/elasticsearch/bin/elasticsearch-plugin remove analysis-icu
root> /usr/share/elasticsearch/bin/elasticsearch-plugin remove ingest-attachment
root> /usr/share/elasticsearch/bin/elasticsearch-plugin install --batch analysis-icu

otrs> /opt/otrs/bin/otrs.Console.pl Maint::DocumentSearch::Check
Trying to connect to cluster...
  Connection successful.

search.max_open_scroll_context: 1000

Empfehlung: Konvertieren Sie Ihre MySQL-Datenbank

OTRS 7 und frühere Versionen unterstützten nur den utf8 MySQL-Datenbank-Zeichensatz, der nicht in der Lage ist, alle Unicode-Zeichen zu speichern. Seit OTRS 8 wird auch der Zeichensatz utf8mb4 unterstützt, wodurch diese Einschränkung aufgehoben wird. Es wird empfohlen, Ihre Datenbank nach Belieben mit dem eingebauten Migrationsskript zu konvertieren.

Wenn Sie das Migrationsskript ohne Optionen ausführen, wird nur angezeigt, wenn etwas konvertiert werden muss.

otrs> /opt/otrs/bin/otrs.Console.pl Maint::Database::MySQL::UTF8MB4Migration
The following tasks need to be done:
  - 1 table(s) need to be converted to 'DYNAMIC' row format
  - the database needs to be converted to 'utf8mb4'
  - 411 column(s) need to be converted to 'utf8mb4'
  - 156 table(s) need to be converted to 'utf8mb4'

Verwenden Sie die Option --force, um die eigentliche Migration durchzuführen.

otrs> /opt/otrs/bin/otrs.Console.pl Maint::Database::MySQL::UTF8MB4Migration --force
...

Nachdem die Migration abgeschlossen ist, müssen Sie einen neuen Schalter zur Datei Kernel/Config.pm hinzufügen, um die utf8mb4` Unterstützung zu aktivieren.

$Self->{'Database::mysql::utf8mb4'} = 1;