Zum Inhalt

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