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.

Bitte beachten Sie: Um Komplikationen aufgrund fehlender Berechtigungen auf Betriebssystemebene zu vermeiden, führen Sie die nachfolgenden Schritte unter einem Benutzerkonto mit Administrationsrechten durch.

Stoppen des JobRouter-Systems

1.Beenden Sie alle JobRouter-Dienste über die Windows-Diensteverwaltung.

2.Beenden Sie die Ausführung des Webservers über die IIS-Verwaltungskonsole.

Datensicherung

1.Führen Sie ein komplettes Backup der JobRouter-Datenbank durch.

2.Sichern Sie sämtliche im Installationsverzeichnis der JobRouter-Webanwendung liegenden Dateien.

3.Sichern Sie alle Dateien im Verzeichnis der jeweiligen zu aktualisierenden Dienste.

Aktualisierung der JobRouter-Webanwendung

Bitte beachten Sie: Verwenden Sie ausschließlich das zu Ihrer PHP-Installation passende Update-Paket! Sollte es für Ihre PHP-Version kein Update-Paket geben, müssen Sie zunächst Ihre PHP-Installation aktualisieren.

1.Entpacken Sie das Updatepaket der JobRouter-Webanwendung in ein temporäres Verzeichnis auf dem Webserver.

Bitte beachten Sie: Die ZIP-Datei sollte niemals direkt in das vorhandene Installationsverzeichnis der JobRouter-Webanwendung entpackt werden, da ansonsten die vorhandenen Rechte auf Dateisystemebene verloren gehen bzw. überschrieben werden können.

Im Unterverzeichnis notes finden Sie für die aktuelle Version eine Textdatei (jobrouter_5.0.txt), in der alle Änderungen seit dem letzten Patch oder Service-Pack dokumentiert sind. Lesen Sie diese bitte sorgfältig durch.

2.Löschen Sie aus dem Installationsverzeichnis der JobRouter-Webanwendung die Unterverzeichnisse includes und library. Hierdurch gewährleisten Sie, dass bisher benötigte, nun jedoch nicht mehr verwendete Dateien nicht weiter im System verbleiben.

3.Kopieren Sie die zuvor entpackten Installationsdateien aus dem temporären Verzeichnis in das Installationsverzeichnis der JobRouter-Webanwendung und überschreiben Sie dabei sämtliche vorhandenen Dateien.

Bitte beachten Sie: Haben Sie in den folgenden JobRouter-Ordnern spezielle Einstellungen im IIS oder direkt über die web.config vorgenommen, werden diese überschrieben: api/rest, api/jobarchivelink, assets, assets/public/fonts, images, mobile, setup/images.

Falls Sie das Dashboard-Verzeichnis ausgelagert haben, löschen Sie im ausgelagerten Verzeichnis die JobRouter-Widgets und übernehmen Sie diese aus dem Installationsverzeichnis der JobRouter-Webanwendung.

4.Nachdem der Kopiervorgang abgeschlossen ist, starten Sie den Webserver über die IIS-Verwaltungskonsole neu.

5.Rufen Sie die JobRouter-Webanwendung auf und melden Sie sich als Benutzer mit Konfigurationsrecht an.

6.Die Installation der notwendigen Patches erfolgt daraufhin automatisch.

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 hierbei 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.

Aktualisierung der JobRouter-Dienste

Die Versionierung der Dienste ist innerhalb eines Service-Packs für ein Release unabhängig von der Versionierung der Webanwendung. D. h. zur Version 5.0 der JobRouter-Webanwendung kann der neueste Patch-Level 5.0.3 sein, während der Dienst noch in Version 5.0.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 5.1.x) bestimmt sind.

Bitte beachten Sie: Wenn Sie von der JobRouter-Version 3.x aktualisieren und eine MySQL-Datenbank benutzen, müssen Sie MySql Connector/Net 6.9.9 installieren.

1.Installieren Sie die Updates für alle vorhandenen JobRouter-Dienste.

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.

2.Starten Sie die JobRouter-Dienste über die Windows-Diensteverwaltung.

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.