Zum Inhalt

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. iis-startmodus.png

Leerlauftimeout (Minuten)#

Setzen sie im Anwendungspool des H2R Servers im Abschnitt Prozessmodell das Leerlauftimeout auf den Wert 0. iis-leerlauftimeout.png

Vorabladen aktiviert (Preload Enabled)#

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

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.

{
    "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. iis-konfigurations-editor.png.

Im folgenden Dialog wählen sie den Abschnitt system.webServer/applicationInitialization iis-webserver-application-initialization.png

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

Abschließend setzen sie zusätzlich im Konfigurations-Editor die Einstellung doAppInitAfterRestart auf True. iis-app-init-restart.png

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:

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

W3p.exe Prozess