Administration

Incendi als Webanwendung

Zur Zeit laufen die Vorkehrungen, um das Incendi - Prognosesystem für Waldbrandgefahr als Webanwendung zu betreiben.

Mit Incendi - Prognosesystem für Waldbrandgefahr als Webanwendung entfällt die nachfolgend beschriebene Installation. BenutzerInnen benötigen dann ausser einem aktuellen Web-Browser und den Zugangsdaten keine weiteren Vorkehrungen, um die Software zu verwenden.

Die Umsetzung von Incendi - Prognosesystem für Waldbrandgefahr als Webanwendung erfolgt im Sommer 2020. Die aktuelle Incendi-Testversion kann hier aufgerufen werden www.incendi-app.ch. Zugangsdaten und weitere Info's unter Kontakt.

Installation

Die Incendi - Prognosesystem für Waldbrandgefahr Applikation ist eine Desktop Software. Sie wird lokal auf dem PC jedes Benutzers installiert, oder - falls eine virtuelle Umgebung vorhanden ist - auf dem Server (Virtual Server, Citrix o.ä.).

Für den Betrieb der Applikation sind zwei Komponenten erforderlich:

• Das Incendi User Interface (UI).
• Die Oracle ODP.NET Komponenten für den Datenzugriff auf die Incendi Oracle-Datenbank.

Die Installation ist durch Systemadministratoren durchzuführen.

Das User Interface (UI)

Dateien bereitstellen (xcopy)

Die Incendi-Installationsdateien werden als zip-Datei auf Nachfrage bereitgestellt (siehe Kontakt).

• Diese zip Datei in ein beliebiges Installationsverzeichnis mit Schreibzugriff extrahieren (z.B. c:\incendi).
• In der Datei Incendi.exe.config den OracleIncendiConnectionString im Abschnitt <connectionStrings> gemäss den Anweisungen unten und gemäss den Angaben des Oracle Datenbankadministrators setzen.
• In der Datei Incendi.exe.config weitere Angaben gemäss den Anweisungen unter Einstellungen vornehmen unten überprüfen und allenfalls anpassen.

Einstellungen vornehmen

Dieser Abschnitt beschreibt die relevanten Einstellungen in der Incendi.exe.config im Installationsverzeichnis.

Abschnitt <connectionStrings\>

<add name="OracleIncendiConnectionString" connectionString="Data Source=**your-host**/**your-servicename**;Persist Security Info=True;" />
<!--<add name="OracleIncendiConnectionString" providerName="Oracle.DataAccess.Client" connectionString="Data Source=(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=localhost)(PORT=1521)))(CONNECT_DATA=(SERVER=DEDICATED)(SERVICE_NAME=ORACLE)));" /> -->

Die Einträge **your-...** in den beiden Abschnitten sind durch die intern erhaltenen Angaben ersetzen.

Abschnitt <appSettings>

<appSettings>
<add key="Schema" value="**your-schemaname**"/>
<add key="HideFireniche" value="false"/>
<add key="IndicesDaysBack" value="400"/>
<add key="DebugMode" value="true"/>
</appSettings>

Hinweise, weitere Einstellungen zu <appSettings>:

• Schema: Schema Name der Oracle Incendi Datenbank.
• HideFireniche: Das FireNiche Modul ist nur in Kantonen anzuwenden, wo FireNiche angewendet wird. Die Einrichtung erfolgt in Zusammenarbeit mit dem WSL (Regionen, FireNiche, Lambda u.a.) [true|false].
• IndicesDaysBack: Einstellung für die Anzahl Tage, die in der Auswertung Meteo-Indices ab dem gewählten Datum in die Vergangenheit angezeigt werden [Ganzzahl].

Abschnitt <DbProviderFactories>

Die Versionsangabe überprüfen: Version=4.121.2.0.

<DbProviderFactories>
  <remove invariant="Oracle.DataAccess.Client"/>
  <add name="Oracle Data Provider for .NET" invariant="Oracle.DataAccess.Client" description="Oracle Data Provider for .NET" type="Oracle.DataAccess.Client.OracleClientFactory, Oracle.DataAccess, Version=4.121.2.0, Culture=neutral, PublicKeyToken=89b483f429c47342" />
</DbProviderFactories>

Abschnitt <runtime>

Im Eintrag <assemblyIdentity name="Oracle.DataAccess".. ebenfalls die Versionsangabe überprüfen: newVersion="4.121.2.0".

<dependentAssembly>
  <assemblyIdentity name="Oracle.DataAccess" publicKeyToken="89B483F429C47342" culture="neutral"/>
  <bindingRedirect oldVersion="0.0.0.0-4.112.3.0" newVersion="4.121.2.0"/>
</dependentAssembly>

Abschnitt <oracle.dataaccess.client>

Falls vorhanden, kann der gesamte Abschnitt entfernt werden.

Oracle ODP.NET

Einrichtung

• ODAC121024Xcopy32bit hier herunterladen, 69 MB und in ein temporäres Verzeichnis extrahieren (Quellverzeichnis, zum Beispiel c:\tmp).
• In diesem Quellverzeichnis mit DOS command prompt als Windows Benutzer mit Administrator Rechten die ODP.NET Installation starten mit (z.B.) install odp.net4 c:\incendi\odp.net odpnet4. Der 2. Parameter, c:\incendi\odp.net, ist der Speicherort für ODP.NET. Es wird vorgeschlagen, hierfür ein Unterverzeichnis vom Incendi Installationsverzeichnis zu verwenden. Für den 3. Parameter soll die Bezeichnung odpnet4 verwendet werden.
• Der Erfolg der Installation wird in der Datei install.log im ODP.NET Installationsverzeichnis protokolliert.

Deinstallation von ODP.NET

Die rückstandsfreie Deinstallation erfolgt ab DOS command prompt (Admin) im ODP.NET Installationsverzeichnis mit uninstall.bat all odpnet4. Die Datei uninstall.log gibt Auskunft über den Erfolg.

Weitergehende Informationen (Insider)

ODP.NET

• Oracle ODP.NET ist erforderlich für den Zugriff auf die Oracle Datenbank des BackEnd. Falls Oracle auf demselben Computer (z. B. im Fall einer virtuellen Serverumgebung) installiert ist, lässt sich allenfalls die ODP.NET Installation vermeiden. Hierzu sind die Einträge der Abschnitte <DbProviderFactories> und <dependentAssembly> in der Datei Incendi.exe.config entsprechend anzupassen.
• Das Incendi UI bezieht die Daten (Json) per HttpRequest über den ORM Mapper (ServiceStack). Dieser wiederum hat über ODP.NET Zugriff auf die Oracle Datenbank.
• Der ServiceStack.OrmLite.Oracle ORM erfordert gemäss ServiceStack Oracle Provider Notes das Einrichten von ODP.NET (The Oracle provider requires an installation of Oracle’s ODP.NET). Es braucht keine Oracle Client (oder Instant Client) Installation.
• Die 32-bit Variante ist zwingend erforderlich, da die Incendi-App zwingend 32-bit ist (auch wegen des Chromium Embedded Framework).
• Configuring Oracle Data Provider for .NET.
• Installing Oracle Data Provider for .NET | c# - The provider is not compatible with the version of Oracle client - Stack Overflow.

Falls Probleme mit der ODP.NET Installation

• Im temporären Quellverzeichnis der ODP.NET Installationsdateien die readme.htm konsultieren.
• Im Zielverzeichnis der ODP.NET Installation den Inhalt der Datei install.log konsultieren! (u.a. interessant im Z’hang mit den Versionsangaben von Oracle.DataAccess in Incendi.exe.config!).
• Einträge in Registry Schlüssel untersuchen: HKEYLOCAL_MACHINE\SOFTWARE\WOW6432Node\Oracle. Hinweis: wenn das Betriebssystem 64-bit ist, lautet der Registry-Schlüssel _HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Oracle..., da wir die ODP.net 32-bit Variante installiert haben!
• Zu DLLPath siehe: hier und hier.