Zum Inhalt
Sie verwenden eine veraltete Dokumentation Zur aktuellen Version wechseln

# 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:

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

#### Durchführung der Aktualisierung

1. Programm `s342 - Systemaktualisierung` aufrufen
2. Anwender und Passwort eingeben, der berechtigt ist, denn IIS zu administrieren
3. Schaltfläche `Weiter` betätigen
4. Frage nach Backup mit `Ja` oder `Nein` beantworten
5. Frage nach dem Server-Neustart mit `Ja` beantworten
6. Vollständigen Neustart der Anwendung im Browser abwarten
7. Programm `s342 - Systemaktualisierung` erneut starten (Programm sollte Information zum Abschluss der Installation enthalten)
8. Aktualisierung des Anwendungscodes starten
9. Abfrage nach Serverneustart mit `Ja` beantworten
10. Vollständigen Neustart der Anwendung im Browser abwarten
11. 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.

28. August 2025
12. Juni 2025