Zum Inhalt
Sie verwenden eine veraltete Dokumentation Zur aktuellen Version wechseln

# SASKIA.H2R (Net 8.0)

### Voraussetzungen

Ausführliche Informationen zu Systemvoraussetzungen finden sie hier.

### Installation IIS Webserver

Die Installationsschritte auf dem IIS Webserver entsprechen den Installationsschritten der H2R Installation für Net Framework (net48). Um Net8 oder höheren Code im IIS ausführen zu können, müssen sie zusätzlich das `Dotnet Core Hosting Bundle` installieren.

Den Download und weiterführende Informationen finden sie hier

### Installation H2R Anwendung

Es werden die Unterschiede zur Installation von H2R für Net Framework 48 beschrieben.

Öffnen sie den IIS Manager und erstellen sie einen neuen Anwendungspool `H2R` mit den folgenden Einstellungen

- Name: `H2R`
- .Net CLR-Version: `kein verwalteter Code`
- verwalteter Pipelinemodus: `Integriert`
- Anwendungspool sofort starten: `Aktiviert`

Wichtig dabei ist, dass die .Net CLR (Common Language Runtime) auf `kein verwalteter Code` umgestellt wird.

Weiterhin ist die `Web.config` durch die Umstellung auf .Net vereinfacht. So sind unter anderem die notwendigen Runtime-Anpassungen entfallen und können aus einer bestehenden Datei entfernt werden (XML Pfad `<configuration>/<runtime>`)

Die bisherigen appSettings (XML Pfad `<configuration>/<appSettings>`) können ebenfalls entfallen. Die Einstellungen werden nun komplett in der Defaul.json verwaltet. Das OnlineUpdate liefert entsprechend Standard-Dateien mit aus, die alle möglichen Settings enthält.

Die Anwendung selbst wird zusätzlich durch die Angabe `<aspNetCore stdoutLogEnabled="false" hostingModel="InProcess" processPath=".\bin\SIS.H2r.exe" arguments="" />` unter dem XML Pfad `<configuration>\<system.webServer>` eingebunden.

Weiterführende Informationen erhalten sie unter (https://learn.microsoft.com/en-us/aspnet/core/host-and-deploy/iis/web-config?view=aspnetcore-8.0)[https://learn.microsoft.com/en-us/aspnet/core/host-and-deploy/iis/web-config?view=aspnetcore-8.0]

##### Anpassungen Web.config

    <?xml version="1.0" encoding="UTF-8"?>
    <!--
      For more information on how to configure your ASP.NET application, please visit
      http://go.microsoft.com/fwlink/?LinkId=169433
      -->
    <configuration>
        <configSections>
            <!-- For more information on Entity Framework configuration, visit https://go.microsoft.com/fwlink/?LinkID=237468 -->
            <section name="entityFramework"
            type="System.Data.Entity.Internal.ConfigFile.EntityFrameworkSection, EntityFramework, Version=6.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"
            requirePermission="false"/>
            <section name="oracle.manageddataaccess.client"
            type="OracleInternal.Common.ODPMSectionHandler, Oracle.ManagedDataAccess, Version=4.122.23.1, Culture=neutral, PublicKeyToken=89b483f429c47342"/>
        </configSections>
        <appSettings>
            <add key="Wisej.DefaultTheme" value="saskia" />
            <add key="dbname" value="oifrentw" />
            <add key="configFile" value="central.config" />
            <add key="replication" value="false" />
            <add key="environment" value="production"/>
        </appSettings>
        <system.data>
            <DbProviderFactories>
                <remove invariant="Oracle.ManagedDataAccess.Client" />
                <add name="ODP.NET, Managed Driver" invariant="Oracle.ManagedDataAccess.Client" description="Oracle Data Provider for .NET, Managed Driver" type="Oracle.ManagedDataAccess.Client.OracleClientFactory, Oracle.ManagedDataAccess, Version=4.122.23.1, Culture=neutral, PublicKeyToken=89b483f429c47342" />
            </DbProviderFactories>
        </system.data>
        <system.net>
            <defaultProxy>
                <proxy autoDetect="True" bypassonlocal="False" proxyaddress="http://my.proxy.de:12345" />
            </defaultProxy>
        </system.net>
        <system.web>
            <authentication mode="Windows" />
        </system.web>
        <system.webServer>
            <modules>
                <remove name="Wisej"/>
                <add name="Wisej" type="Wisej.Core.HttpModule, Wisej.Framework"/>
            </modules>
            <handlers>
                <remove name="aspNetCore"/>
                <add name="aspNetCore" path="*" verb="*" modules="AspNetCoreModuleV2" resourceType="Unspecified" />
                <remove name="wisej"/>
                <add name="wisej" verb="*" path="*.wx" type="Wisej.Core.HttpHandler, Wisej.Framework"/>
            </handlers>
            <aspNetCore stdoutLogEnabled="false" hostingModel="InProcess" processPath=".\bin\SIS.H2r.exe" arguments="" />
        </system.webServer>
    </configuration>

##### Proxy Konfiguration

Im Unterschied zu Net Framework erfolgt die Proxy-Konfiguration über folgende Umgebungsvariablen innerhalb der geladenen Aspnet Core Anwendung.

            <aspNetCore stdoutLogEnabled="false" hostingModel="inprocess" processPath=".\bin\SIS.H2r.exe" arguments="">
                <environmentVariables>
                    <environmentVariable name="http_proxy" value="http://my.proxy.de:80"/>
                    <environmentVariable name="https_proxy" value="https://my.proxy.de:80"/>
                    <environmentVariable name="no_proxy" value=".local,.my.other.domain"/>
                </environmentVariables>
            </aspNetCore>

Beachten sie dabei die Syntax für die Verwendung von Auflistungen bei `no_proxy`. Details zur erlaubten Syntax entnehmen sie bitte hier

28. August 2025
12. Juni 2025