Wichtige Hinweise
Allgemeines
1.Die nachfolgende Anleitung beschreibt, wie bei der Durchführung eines Updates der JobRouter-Webanwendung sowie der JobRouter-Dienste grundsätzlich vorzugehen ist. Die aktuelle JobRouter-Version können Sie im Kunden- und Partnerportal herunterladen.
2.Um Komplikationen aufgrund fehlender Berechtigungen auf Betriebssystemebene zu vermeiden, führen Sie die nachfolgenden Schritte unter einem Benutzerkonto mit Administrationsrechten durch.
3.Ein Update auf die neuesten LTS- oder STS-Versionen (ab 2023.1) erfordert mindestens die JobRouter-Version 2022.1. Das Update ist erst ab dieser Version möglich. Grundsätzlich setzt jedes Update voraus, dass zumidest die letzte LTS-Version installiert ist. Ein direktes Überspringen von LTS-Versionen wird nicht unterstützt. Bitte beachten Sie auch die Update-Anleitungen dieser Vorversionen, falls Sie einen größeren Update-Sprung machen.
4.Bei dem Update der JobRouter-Webanwendung auf dieser Version muss die eingesetzte PHP-Version ebenfalls auf PHP 8.4 aktualisiert werden, wie im Abschnitt Durchführen von PHP-Updates beschrieben.
5.Mit der Änderung der PHP-Version können keine Dateien geladen werden, die für eine Vorversion verschlüssselt wurden. Entfernen Sie bitte vor dem Update sämtliche php-Dateien in dem JobRouter-Verzeichnis und Unterverzeichnissen, die nicht zu einer Kunden-spezifischen Implementierung gehören.
Datenbankoptimierung: Indizes
Bitte beachten Sie, dass durch unsere stetige Weiterentwicklung am JobRouter Core sich auch unsere genutzten SQL-Statements und zugrundeliegende Datenbankstruktur durch JobRouter Patches verändern kann. Diese Änderungen haben zur Folge, dass bisherige Indizes auf der Datenbank eventuell nicht mehr genutzt und daher gelöscht werden können und für die neuen Bedingungen neu erstellt werden müssen. Der JobDBOptimizer führt dies in MSSQL für die von Ihm selbst erstellten Indizes, ab der JobServer Diensteversion 5.0.0, selbstständig anhand der Datenbanknutzungsstatistiken durch. Diese Datenbankstatistiken bauen sich jedoch erst nach realistischer und intensiver Systembenutzung auf, daher kann eine Performanceverbesserung unter Umständen erst nach einigen Tagen beobachtet werden.
Der JobDBOptimizer ersetzt keinen Datenbankspezialisten, der Ihre Datenbank regelmäßig prüft und optimiert, um eine optimale Performance zu gewährleisten. Durch die Weiterentwicklung sowie neue Funktionen des JobRouter Systems, kann sich auch die Lastverteilung verändern. Daher sollten Sie bei Ihrer Infrastruktur darauf achten, dass Sie die Lastverteilung des gesamten Systems durch eine einfache Erweiterung und Optimierung Ihrer Infrastruktur sicherstellen können. Wenn sich Ihre Systemlast negativ verändert, prüfen Sie bitte unsere Tipps zur Performanceoptimierung in der Technischen Dokumentation, sowie unsere Anleitung im Installationshandbuch zu Empfehlungen zum Aufsetzen von Microsoft SQL Server. Oftmals sind auch alte PHP-Versionen, falsche php.ini Einstellungen sowie fehlerhafte Konfigurationswerte im IIS die Ursache für eine schlechte Performance des Systems. Diese Einstellungen können Sie gemäß aktuellem Installationshandbuch zur manuellen Installation abgleichen.
Aktualisierung der JobRouter-Webanwendung
Vorbereitung
1.Beenden Sie alle JobRouter-Dienste.
2.Beenden Sie die Ausführung des Webservers.
3.Führen Sie ein komplettes Backup der JobRouter-Datenbank durch.
4.Sichern Sie sämtliche im Installationsverzeichnis der JobRouter-Webanwendung liegenden Dateien. Im folgenden Verlauf müssen diverse Dateien und Verzeichnisse wiederhergestellt werden.
5.Entpacken Sie das Updatepaket der JobRouter-Webanwendung in ein temporäres Verzeichnis auf dem Webserver. Die ZIP-Datei niemals direkt in das vorhandene Installationsverzeichnis der JobRouter-Webanwendung entpacken. Im Unterverzeichnis notes finden Sie für die aktuelle Version eine Textdatei (jobrouter.txt), in der alle Änderungen seit dem letzten Patch oder Service-Pack dokumentiert sind. Lesen Sie diese bitte sorgfältig durch.
6.Bitte beachten Sie: Nur für SQLSRV (MS SQL): Wenn die Datenbank unter einem abweicheichenden Standardschema erstellt worden ist, d.h. nicht mit dem dbo Schema, ist es ab der Version 2024.1 notwendig, vor dem Update-Vorgang, die config.php um den Eintrag defaultSchema im db Abschnitt zu ergänzen.
Beispiel:
'db' => array(
'user' => 'jr_user',
...
'defaultSchema' => 'example_schema',
),
Update
Folgende Verzeichnisse sollten im weiteren Vorgehen nicht gelöscht werden (s. u. A. Pfad-Konfiguration):
oCache-Verzeichnis (Standard: <jobrouter>/cache) sowie alle Unterverzeichnisse außer service und symfony
oKonfigurations-Verzeichnis <jobrouter>/config
oDashboard-Verzeichnis (Standard: <jobrouter>/dashboard)
oData-Verzeichnis (Standard: <jobrouter>/data)
oExport-Verzeichnis (Standard: <jobrouter>/export)
oFunctions-Verzeichnis (Standard: <jobrouter>/functions)
oLizenz-Verzeichnis (Standard: <jobrouter>/license)
oKonfiguration Mobile Client <jobrouter>/mobile/config
oBausteine des JobLink for SAP Moduls <jobrouter>/modules/jobsapbapi/bapi
oOutput-Verzeichnis (Standard: <jobrouter>/output)
oSystemaktivitäts-Verzeichnis (Standard: <jobrouter>/systemactivities)
oUploads-Verzeichnis (Standard: <jobrouter>/uploads)
oVolltext-Backup-Verzeichnis (Falls konfiguriert)
1.Löschen Sie aus dem Installationsverzeichnis der JobRouter-Webanwendung alle nicht aufgeführten Verzeichnisse und Dateien sowie cache/service und cache/symfony. Durch das Aufräumen gewährleisten Sie, dass nur noch benötigte Dateien im System verbleiben. Einige Dateien würden, sofern diese auf dem System verbleiben, zu massiven Problemen führen.
2.Kopieren Sie die zuvor entpackten Installationsdateien aus dem temporären Verzeichnis in das Installationsverzeichnis der JobRouter-Webanwendung und überschreiben Sie dabei sämtliche vorhandene Dateien.
3.Folgende Dateien und Verzeichnisse müssen nach dem Kopiervorgang aus der Sicherung wiederhergestellt werden, falls vorhanden:
o<jobrouter>/modules/jobselect/images
o<jobrouter>/modules/jobselect/js
o<jobrouter>/js/custom.js
o<jobrouter>/setup/xml/custom
o<jobrouter>/setup/xml/phptemplates.xml (falls modifiziert)
o<jobrouter>/setup/xml/jstemplates.xml (falls modifiziert)
o<jobrouter>/config/prizmconfig.xml (verschoben von <jobrouter>/cache)
oSonstige Eigenimplementierungen in <jobrouter>/plugins
4.Setzen Sie für folgende Verzeichnisse erneut Schreibrechte für den ausführenden Webserver-Benutzer:
o<jobrouter>/assets/cache
5.Benennen Sie die Dateien folgende Dateien um. Falls hier spezielle anpassungen gemacht wurden, übernehmen Sie diese Änderungen aus den Dateien der Sicherung.
o.htaccess-jobrouter in .htaccess
oweb.config-jobrouter in web.config
6.Löschen Sie alle JobRouter-Widgets, die ursprünglich von JobRouter mitgeliefert wurden, aus dem dashboard-Verzeichnis.
7.Starten Sie den Webserver neu.
8.Rufen Sie die JobRouter-Webanwendung auf und melden Sie sich als Benutzer mit Konfigurationsrecht an.
9.Die Installation der notwendigen Patches erfolgt daraufhin automatisch.
10. Deaktivieren Sie den Wartungsmodus.
Bitte beachten Sie: Erscheint die Fehlermeldung SystemActivity is invalid for encryption method, dann bedeutet dies, dass eine veraltete Systemaktivität in Ihrem System liegt. Diese wurde mit einer veralteten Verschlüsselung erstellt und kann vom System nicht geladen werden. Wird die Systemaktivität nicht mehr verwendet, dann kann sie aus dem System gelöscht werden.
Wird die Systemaktivität weiterhin benötigt, wenden Sie sich an Ihren JobRouter-Partner oder den JobRouter-Support.
Bitte beachten Sie: Details zu eventuell auftretenden Problemen oder Fehlern finden Sie in der Logdatei patch_YYYYMMDD.log im Unterverzeichnis output/log der JobRouter-Installation. Beheben Sie die aufgetretenen Fehler und führen Sie den Patch erneut aus, indem Sie sich aus JobRouter abmelden und neu anmelden. Die Patches werden nun erneut ausgeführt. Schlägt der Patch nun weiterhin fehl, wenden Sie sich bitte an Ihren JobRouter-Partner oder den JobRouter-Support.
Überprüfung der Moduleinstellungen
Bei einem Patch werden je nach JobRouter-Lizenz und der JobRouter Version manche Module automatisch aktiviert oder deaktiviert. Bitte überprüfen Sie nach dem Update, ob alle benötigten Module in der JobRouter Oberfläche im Menüpunkt Konfiguration -> Moduleinstellungen vorhanden und korrekt eingestellt sind. Sollten hier bestimmte Module fehlen, überprüfen Sie bitte, ob alle benötigten Module in der Datenbanktabelle JRMODULECFG auf active = 1 stehen.
Bitte beachten Sie: Für das Modul JobMind Head muss auch das Modul JobMind BAU aktiviert sein.
Durchführen von Updates auf einem instanziierten JobRouter
Das Aktualisieren eines instanziierten JobRouter verläuft analog zu einem JobRouter ohne Instanzen. Der einzige Unterschied besteht darin, dass man sich nach dem Einspielen der neuen JobRouter-Dateien bei jeder Instanz anmelden muss, damit das Release/Service-Pack bzw. der Patch eingespielt werden kann. Erst danach kann das Update von JobRouter fortgesetzt werden, indem Sie die JobRouter-Dienste aktualisieren.
Aktualisierung der JobRouter-Dienste
Die Version der Dienste ist innerhalb eines Service-Packs für ein Release unabhängig von der Version der Webanwendung. D. h. zur Version 2026.1 der JobRouter-Webanwendung kann der neueste Patch-Level 2026.1.3 sein, während der Dienst noch in Version 2026.1.0 aktuell ist. Sie können also jederzeit ein Update der Dienste durchführen, sofern diese nicht für ein neueres Service Pack (z. B. Version 2026.2.x) bestimmt sind.
1.Sichern Sie alle Dateien im Verzeichnis der jeweiligen zu aktualisierenden Dienste.
2.Installieren Sie die Updates für alle vorhandenen JobRouter-Dienste und für die JobRouter-Dienstekonfiguration Anwendung.
Bitte beachten Sie: Beim Deinstallieren und Neuinstallieren wird der ausführende Benutzer zurückgesetzt. Standardmäßig wird der Dienst unter dem lokalen Systemkonto installiert. Wenn Sie einen speziellen Benutzer zur Ausführung der Dienste verwenden, muss dieser neu hinterlegt werden.
3.Wenn Sie von einer JobRouter-Version älter als 5.1.0 aktualisieren, starten Sie bitte die JobRouter-Dienstekonfiguration Anwendung, laden Sie die Datei instance.key aus dem Unterverzeichnis config der JobRouter-Webanwendung ins Feld Key hoch und speichern Sie anschließend die Konfiguration.
4.Starten Sie die JobRouter-Dienste über die Windows-Diensteverwaltung.
Aktualisierung von JobRouterMQ
Mit dem Dienst JobRunner ist es notwendig, das Installationspaket JobRouterMQ auszuführen. Die Kommunikation von JobRouter mit JobRunner geschieht über diese Software. Bei der Ausführung wird Erlang OTP und RabbitMQ Server installiert. Zusätzlich haben Sie die Möglichkeit, die Verbindungsdaten direkt anzugeben. Sie finden JobRouterMQ im Auslieferungspaket von JobRouter; alternativ können Sie dies über das Kunden- und Partnerportal herunterladen.
Notwendige Informationen zur Installation von JobRouterMQ können Sie dem Installationshandbuch entnehmen.
