Zum Inhalt
Sie verwenden eine veraltete Dokumentation Zur aktuellen Version wechseln

# SASKIA.H2R-Jobserver

Der H2R Server wird mit den gleichen Installationsschritten wie die H2R Installation im IIS installiert. Details siehe hier.

Zusätzlich müssen folgende Einstellungen an der Website/Webapplication und dem Anwendungspool der H2R Server Installation vorgenommen werden:

### Anonyme Authentifizierung

Aktivieren sie für diese IIS-Anwendung die anonyme Authentifizierung. Eine automatische Anmeldung mittels Domainenauthentifizierung ist für den H2R Server nicht vorgesehen.

### IIS Feature Anwendungsinitialisierung

Für eine korrekte Einrichtung des H2R Server muss das IIS Feature `Anwendungsinitialisierung` installiert werden. Eine Anleitung zur Installation finden sie hier

### Startmodus AlwaysRunning

Im Anwendungspool des H2R Servers muss im Abschnitt `Allgemein` der Eintrag `Startmodus` auf `AlwaysRunning` gestellt werden.

### Leerlauftimeout (Minuten)

Setzen sie im Anwendungspool des H2R Servers im Abschnitt `Prozessmodell` das `Leerlauftimeout` auf den Wert `0`.

### Vorabladen aktiviert (Preload Enabled)

Aktivieren sie in den Website-Einstellungen der H2R Server Installation im Abschnitt `Allgemein` die Option `Vorabladen aktivert`.

Weiterführende Informationen zu diesem Feature finden sie auf der IIS Microsoft-Website unter https://learn.microsoft.com/de-de/archive/blogs/vijaysk/iis-8-whats-new-website-settings.

### baseUrl Parameter in Default.json setzen

Ergänzen sie in der `Default.json` das Setting `baseUrl` und tragen sie die korrekte Url zum H2rServer ein.

Default.json

    {
        "sessionTimeout": 0,
        "culture": "de-DE",
        "settings": {
            "baseUrl": "https://myserver.domain.de:8443",
        }
    }

### Preload URL im IIS Manager einstellen

Makrieren sie im IIS Manager die H2R Sever Website und starten sie den Konfigurations-Editor. .

Im folgenden Dialog wählen sie den `Abschnitt` `system.webServer/applicationInitialization`

Starten sie anschließend in der Zeile `(Auflistung)` die Erfassung der Preload-Url. Wir tragen dort den Wert `/` ein.

Abschließend setzen sie zusätzlich im Konfigurations-Editor die Einstellung `doAppInitAfterRestart` auf `True`.

Eine ausführliche Anleitung finden sie unter https://learn.microsoft.com/en-us/iis/configuration/system.webserver/applicationinitialization/.

### Preload URL in web.config setzen

Ergänzen sie in der `web.config` folgenden Eintrag und passen sie anschließend die Parameter `initializationPage` und `hostName` entsprechend ihrer Systemumgebung an:

Web.config

    <system.webServer>
        ...
        <applicationInitialization doAppInitAfterRestart="true">
            <add initializationPage="/" hostName="" />
        </applicationInitialization>
    </system.webServer>

##### Anmerkungen

- wenn sie den H2rServer als Webapplication im IIS einbinden, geben sie bitte dort mit `/` beginnend den Pfad an z.B. `/jobserver`
- bei der Einrichtung von H2rServer als IIS-Website ist `/` korrekt
- Hostname ist nicht anzugeben

Neustart

Beachten sie für einen funktionierende Preload mögliche URL-Rewrite Regelungen und fehlerhafte Portangaben bzw. URL's.

Starten sie anschließend den IIS neu, damit die Einstellungen aktiv werden.

Eine funktionierende Preload-Einrichtung erkennen Sie daran, dass im Task-Manager ein `W3p.exe`-Prozess mit dem entsprechenden ApplicationPool entsteht, der direkt startet und 400 MB oder mehr an Arbeitsspeicher reserviert.

28. August 2025
12. Juni 2025