Kurzanleitung für die Erstinstallation von Intrexx 20.09 und das Upgrade auf Intrexx 20.09


Installation

Die folgende Kurzanleitung gibt Ihnen einen Überblick über die zentralen Schritte, die Sie bei einer Erstinatallation von Intrexx 20.09 durchführen müssen.
Gleichzeitig beschreibt Sie die zentralen Schritte, die Sie für das Upgrade von Intrexx 18.03 (oder einer Vorgängerversion) auf Intrexx 20.09 durchführen müssen.
(Bei einem Upgrade von Intrexx 19.03, 19.09 oder 20.03 auf Intrexx 20.09 haben Sie die hier beschriebenen Schritte bereits bei der Installation von Intrexx 19.03, 19.09 oder 20.03 durchgeführt.)
Diese Kurzanleitung kann Ihnen auch als eine Checkliste während des Installationsprozesses dienen.

Die Kurzanleitung geht davon aus, dass Sie über eine Windows-Umgebung verfügen und den IIS (Internet Information Services) von Microsoft als "Frontend-Webserver" einsetzen.

Die Kurzanleitung setzt voraus, dass Sie sich bereits gut mit Intrexx auskennen.

Reihenfolge Beachten Sie, dass Sie zunächst vorbereitende Schritte "außerhalb" von Intrexx vornehmen müssen. Erst wenn diese durchgeführt sind, können Sie ein erfolgreiches Upgrade von Intrexx durchführen.

  1. SSL-Zertifikat
    Verfügen Sie bereits über ein SSL-Zertifikat?
    Falls dies nicht der Fall ist, erwerben oder erstellen Sie ein Zertifikat.
    (Dieses benötigen Sie für das Einrichten einer verschlüsselten Verbindung [HTTPS] zwischen Browser und Ihrem Portal. Eine unverschlüsselte Verbindung [http] ist nicht mehr zulässig.)
  2. Website (Hostname) im DNS (Domain Name Service) hinterlegen
    Hinterlegen Sie im DNS den im IIS (oder in NGINX) vergebenen Hostnamen (vgl. "5. IIS konfigurieren").
    Wenn Sie mehrere Portale einsetzen, benötigt jedes Portal einen eigenen DNS-Eintrag.
  3. IIS einrichten
    Der IIS ist Bestandteil des Betriebssystems. Daher ist nur eine Einrichtung nicht aber eine Installation erforderlich.
    (Als Alternative zum IIS kann in einer Linux-Umgebung NGINX verwendet werden.)
  4. Features im IIS hinzufügen
    • .NET-Erweiterbarkeit 4.6 (4.5 ist ebenfalls ausreichend)
    • ASP.NET 4.6 (4.5 ist ebenfalls möglich)
    • ISAPI-Erweiterungen
    • ISAPI-Filter
    • Installieren Sie im IIS den IIS Web Platform Installer
    • Installieren Sie im IIS ARR und URL-Rewrite
  5. IIS konfigurieren & Website anlegen
    • Richten Sie den IIS als Reverse Proxy ein (im ARR)
    • Fügen Sie Websites im IIS hinzu. (Für jedes produktive Portal eine Website)
      (Websites ersetzen "Virtuelle Verzeichnisse". Diese können für den Einsatz von Intrexx 20.09 nicht verwendet werden.)
    • Wählen Sie unter Bindung den Typ "https" aus.
    • Erfassen Sie einen Hostnamen für die Website.
      (Über den Hostnamen ist das Portal über den Browser aufrufbar.)
    • Wählen Sie ein SSL-Zertifikat aus.
      (Damit richten Sie eine verschlüsselte Verbindung zu Ihrem Portal ein.)
  6. Upgrade Intrexx 20.09 durchführen
  7. Portaleigenschaften konfigurieren
    Nehmen Sie in den Portaleigenschaften von Intrexx folgende Einstellungen vor:
    Frontend Webserver
    • Typ - Wählen Sie hier "Internet Information Service (IIS)" aus.
    • IIS Website - Wählen Sie hier die Webseite aus, die Sie im IIS für das Portal angelegt haben.
    • Embedded Tomcat Port - Hier wird der Port angezeigt, den Sie in der Vorgängerversion von Intrexx verwendet hatten. Diesen Port können Sie belassen.
      Hinweis Bei einer Neuinstallation ist hier der Port 1337 voreingestellt.
    • Basis-URL des Portals - Hier muss die Basis-URL hinterlegt sein.
      Der erste Teil besteht aus der Angabe des Protokolls. Beachten Sie, dass hier https angegeben ist. Der zweite Teil besteht aus der Angabe des Hostnamens, den Sie im IIS hinterlegt haben. Beachten Sie, dass ein abschließender Slash (/) angegeben ist. Die korrekte Angabe ist zwingend erforderlich, damit Ihr Portal im Browser aufgerufen werden kann.