Aktualisierung SASKIA.H2R

Über das Programm s342 - Systemaktualisierung kann die H2R Software SASKIA.H2R und SASKIA.H2R-Jobserver aktualisiert werden.

Voraussetzung für die Nutzung des Progamms#

Nutzung von IIS als Server zur Bereitstellung von SASKIA.H2R bzw. SASKIA.H2R-Jobserver
Nutzer des Anwendungspool (ApplicationPoolIdentity) muss IIS-Berechtigung zur Verwaltung der Webanwendung besitzen
Aufruf der Anwendung über den Web-Browser mittels Windows-Authentifizierung
dotnet 8 oder hoeher

Konfiguration Default.json OnlineUpdate#

Bitte nehmen sie folgende Parameter für die Grundkonfiguration des OnlineUpdates in die Default.json auf

    "settings": {
        "OnlineUpdate.Feed": "https://service.saskia.de/autoupdate",
        "OnlineUpdate.JobServerPath": "",
        "OnlineUpdate.WorkingDirectory": ""
    }

OnlineUpdate.WorkingDirectory: Basispfad des OnlineUpdates zum Speichern von heruntergeladenen Aktualisierungen und Backups
OnlineUpdate.Feed: URL des Servers, der die OnlineUpdates bereithält (Default ist https://service.saskia.de/autoupdate)
OnlineUpdate.JobServerPath": Pfad zum SASKIA.H2R Jobserver Ordner (Physical Path). Diese Ordner ist die Basis für die SASKIA.H2R Jobserver Aktualisierung

Es werden beim Start des Programms Informationen zur aktuellen Installation angegeben:

Name des ApplicationPools
Name der ApplicationPoolIdentity
Installationspfad der Anwendung (physischer Pfad)
Quellpfad für die Aktualisierung (mit diesen Dateien wird die aktuelle H2R-Installation aktualisiert)

Erklärungen zu den Installationsoptionen#

OnlineUpdate interaktiv starten: sasupcli.exe wird auf dem Server gestartet und erlaubt weitere Einstellungen.

Hinweis

Der Aufruf im interkativen Modus ist nur möglich, wenn man die Systemaktualisierung direkt im Browser auf dem Server startet

OnlineUpdate Ordner vorab bereinigen: Der Ordner H2R_UPDATE wird komplet gelöscht und das OnlineUpdate lädt die letzte aktuelle Version erneut herunter
OnlineUpdate vorbereitet: der oben angegebene Ordner enthält bereits die aktuellen Dateien und wird vorab nicht aktualisiert bzw. ausgetauscht. Ermöglicht das Einspielen von noch nicht veröffentlichten Release-Ständen und anderen Test-Szenarien

Grundlegende Erläuterungen zum Aktualisierungsvorgang#

H2R bzw. H2R Server können in unterschiedlichen Server-Szenarien bereitgestellt werden Die Systemaktualisierung erfolgt in 3 Schritten:

Herunterladen der aktuellsten Version von H2R bzw. H2R Server
Erstellung einer Schattenkopie der H2R Anwendung durch Anpassung des pyhsischen Pfades der Webanwendung (notwendig für den Austausch der in Nutzung befindlichen Quellcode-Dateien)
Neustart der H2R Anwendung durch Nutzung des Schattenkopie-Ordners
Austausch der Dateien im alten physischen Pfad der Anwendung mit den aktualisierten Dateien im H2R_UPDATE Ordner
Rücksetzen des physischen Pfades der H2R Anwendung auf den ursprünglichen Dateipfad
Neustart der Server-Anwendung und Abschluss der Aktualisierung

Durchführung der Aktualisierung#

Programm s342 - Systemaktualisierung aufrufen
Anwender und Passwort eingeben, der berechtigt ist, denn IIS zu administrieren
Schaltfläche Weiter betätigen
Frage nach Backup mit Ja oder Nein beantworten
Frage nach dem Server-Neustart mit Ja beantworten
Vollständigen Neustart der Anwendung im Browser abwarten
Programm s342 - Systemaktualisierung erneut starten (Programm sollte Information zum Abschluss der Installation enthalten)
Aktualisierung des Anwendungscodes starten
Abfrage nach Serverneustart mit Ja beantworten
Vollständigen Neustart der Anwendung im Browser abwarten
Manuelle Installationsschritte (Releasewechsel) durchführen

Individuelle Anpassung der Aktualisierungsschritte#

Die Durchführung der Aktualisierungen auf dem Sever werden u.a. durch die Nutzung von Powershell-Skripten realisiert. Innerhalb der Installation können individuelle Skripte vor und nach der Installation genutzt werden. Dazu müssen im Root-Ordner der Anwendung (physikalischer Pfad) hinterlegt werden. Diese Dateien werden beim Aktualisierungsprozess nicht gelöscht oder aktualisiert.

Folgende Powershell-Skripte können angegeben werden

before_update.ps1
after_update.ps1

Wird im Ordner ebenfalls eine update.ps1 Datei gefunden, wird diese für den Aktualisierungsvorgang verwendet. Standardmäßig findet der Skript aus der Online-Aktualisierung (H2R_UPDATE\bin\updater\update_default.ps1) Verwendung. Der Skript enthält beim Aufruf die folgenden Parameter

$source: Quellpfad der Aktualisierung (Absoluter Pfad zum `H2R_UPDATE Ordner)
$destination: Zielpfad, in den installiert wird (absoluter Pfad, entspricht dem ursprünglichen physikalischen Pfad)

param([String]$source,
    [String]$destination
)

Hinweis

Im Ordner /images können weiterhin individuelle Logodateien abgelegt werden. Diese werden beim Durchführen der Online-Aktualisierung nicht gelöscht oder überschrieben.