Skip to content

Installation

1. Installations- und Updateanleitung CMI API

Es folgt eine Zusammenfassung, die den Betrieb des CMI API mit IIS beschreibt. Grundsätzlich kann der IIS gemäss der Dokumentation von Microsoft für eine ASP.NET Core konfiguriert werden.

Fachwörter (wie Application Pool) beziehen sich auf ein Windows mit englischem Sprachpaket. Diese Anleitung beschreibt eine Basis IIS Application Installation und kann daher an das eigene Deployment angepasst werden.

1.1 Voraussetzungen

  • Die .NET Runtime (Version 6.0.3) muss auf dem Server installiert sein. Diese kann unter https://dotnet.microsoft.com/en-us/download/dotnet/thank-you/runtime-aspnetcore-6.0.3-windows-hosting-bundle-installer heruntergeladen werden.
  • IIS
  • Windows Feature: Web Server / Application Development

1.2 Abhängigkeiten

Die CMI API muss den MetaTool Service unter dem OWIN Private Port erreichen können.

2. Installation

Die CMI API wird als eine IIS Applikation installiert. Diese Anleitung beschreibt eine minimale Installation im IIS.

2.1 Application Pool

  1. Unter "Application Pools" einen neuen Application Pool hinzufügen
  2. Folgende Parameter befüllen:
    • Name: Frei wählbar (Bsp. cmi-api)
    • .NET CLR Version: No Managed Code
    • Managed pipeline mode: Integrated
    • Start application pool immediately: Aktiviert
  3. Mit OK bestätigen.

2.2 Website

  1. Im IIS unter Sites eine neue Website hinzufügt
  2. Folgende Parameter befüllen:
    • Site name: Beliebig wählbar (Bsp. cmi-api)
    • Application pool: Den erstellen Application pool vom Schritt 2.1 auswählen
    • Physical path: Beliebiger Pfad, unter welchem sich die Installationsdateien der API-Applikation befinden werden
    • Binding type: Https
    • IP-Adresse: All Unassigned
    • Port: Frei wählbar
    • Hostname: Domäne eintragen
    • SSL certificate: Ein gültiges SSL-certificate, welches auf dem Host name gebunden ist
    • Start Website: immediately
  3. Das ausgelieferte ZIP auf dem Server kopieren und den Inhalt unter \Installationsdateien im Zielverzeichnis kopieren.
    • Zielverzeichnis ist das Verzeichnis was beim Physical path eingetragen wurde
    • Appsettings.json Konfiguration vornehmen
    • Den Application Pool recyclen

3 Update

3.1 Anleitung

  1. Die IIS-Website stoppen
  2. Alle Dateien und Ordner bis auf die folgenden löschen:
    • (Datei) appsettings.json
  3. Das ausgelieferte ZIP auf dem Server kopieren und den Inhalt unter \Installationsdateien im Zielverzeichnis kopieren (Achtung! Die obig aufgelisteten Dateien und Ordner nicht überschreiben)
  4. Die IIS-Website wieder starten

4 Validierung

Wird die Website aufgerufen, so sollte folgendes sichtbar sein: Tenant-Selection.