InhaltInstallation und Einrichtung

Installation mit Apache Tomcat

Gilt für ISPICIO_E 2.1.1.0 Stand

Java und Apache Tomcat installieren, die Webanwendung ISPICIO_E bereitstellen und mit der PostgreSQL-Datenbank verbinden.

Auf dieser Seite

Voraussetzungen

  • Java 25 oder neuer und Apache Tomcat 11 oder neuer für ISPICIO_E 2.1.1.0.
  • Die PostgreSQL-Datenbank ist eingerichtet, siehe Datenbank einrichten.
  • Das SAP-System ist vorbereitet, siehe Vorbereitung in SAP.
  • Sie haben ISPICIO_E von der Seite Downloads heruntergeladen und das ZIP-Archiv entpackt. Es enthält die Webanwendung als WAR-Datei e2022.war.

Die Schritte beschreiben die Installation unter Windows. Für Linux enthält diese Seite nur die Datei für die Datenbankverbindung.

Java installieren

  1. Öffnen Sie bei Adoptium die Seite Windows MSI installer packages und klicken Sie auf Download.

    Adoptium-Seite Windows MSI installer packages mit markiertem Link Download

  2. Wählen Sie auf der Release-Seite Ihr Betriebssystem und unter Version Java 25 oder neuer. Laden Sie die .msi-Datei herunter.

    Release-Seite von Eclipse Temurin mit den Filtern Operating System, Architecture, Package Type und Version

  3. Starten Sie den Installer. Aktivieren Sie auf der Seite Custom Setup die Funktion Set JAVA_HOME variable.

    Temurin-Setup, Seite Custom Setup mit markierter Funktion Set JAVA_HOME variable

  4. Öffnen Sie ein Terminal und prüfen Sie die Installation:

    java --version

Apache Tomcat installieren

  1. Laden Sie den Windows Service Installer von der offiziellen Website herunter: Apache Tomcat 11 Software Downloads.

  2. Starten Sie den Installer und klicken Sie auf Next >.

    Begrüßungsseite des Apache-Tomcat-Setups

  3. Wählen Sie auf der Seite Choose Components die Komponenten. Das Bildschirmfoto zeigt die Installationsart Normal mit Start Menu Items, Documentation und Manager.

    Tomcat-Setup, Choose Components: Installationsart Normal mit Start Menu Items, Documentation und Manager

  4. Legen Sie auf der Seite Configuration im Feld HTTP/1.1 Connector Port den Port fest. Die Vorgabe ist 8080. Wenn Sie den Tomcat Manager nutzen wollen, tragen Sie unter Tomcat Administrator Login zusätzlich Benutzername und Passwort ein.

    Tomcat-Setup, Configuration: HTTP/1.1 Connector Port 8080 markiert, darunter der Tomcat Administrator Login

  5. Wählen Sie auf der Seite Java Virtual Machine den Ordner der Java-Installation aus dem vorigen Abschnitt.

    Tomcat-Setup, Java Virtual Machine: Pfad der installierten Java-Version

  6. Lassen Sie auf der letzten Seite Run Apache Tomcat markiert und klicken Sie auf Finish. Tomcat startet.

    Letzte Seite des Tomcat-Setups mit markiertem Run Apache Tomcat und der Schaltfläche Finish

ISPICIO_E bereitstellen

  1. Öffnen Sie den Ordner webapps Ihrer Tomcat-Installation, zum Beispiel C:\Program Files\Apache Software Foundation\Tomcat 9.0\webapps.

  2. Kopieren Sie die WAR-Datei in diesen Ordner, zum Beispiel per Drag-and-drop.

    Windows-Explorer mit dem Tomcat-Ordner webapps; ein Hinweis fordert auf, die WAR-Datei dorthin zu ziehen

Mit der Datenbank verbinden

ISPICIO_E liest die Datenbankverbindung aus Umgebungsvariablen. Sie setzen sie in einer Datei im Tomcat-Ordner bin.

  1. Öffnen Sie den Ordner bin Ihrer Tomcat-Installation, zum Beispiel C:\Program Files\Apache Software Foundation\Tomcat 9.0\bin.

  2. Legen Sie eine neue Textdatei an: Klicken Sie mit der rechten Maustaste und wählen Sie New > Text Document.

    Windows-Explorer im Tomcat-Ordner bin: Kontextmenü New mit dem Eintrag Text Document

  3. Tragen Sie je nach Betriebssystem die folgenden Zeilen ein. Passen Sie die Werte an Ihre Datenbank an, vor allem Benutzer und Passwort.

    Windows:

    set ISPE_DB_HOST=localhost
    set ISPE_DB_PORT=5432
    set ISPE_DB_NAME=ispe
    set ISPE_DB_USER=postgres
    set ISPE_DB_PASSWORD=ispicio

    Linux:

    export ISPE_DB_HOST=localhost
    export ISPE_DB_PORT=5432
    export ISPE_DB_NAME=ispe
    export ISPE_DB_USER=postgres
    export ISPE_DB_PASSWORD=ispicio
  4. Speichern Sie die Datei und ändern Sie Namen und Dateityp:

    • Windows: setenv.bat
    • Linux: setenv.sh

    Neue Datei im Tomcat-Ordner bin, während sie in eine .bat-Datei umbenannt wird

    Der Dateiname muss genau setenv.bat oder setenv.sh lauten.

    Unter Linux muss die Datei außerdem ausführbar sein, siehe Umstieg von e2016.

  5. Starten Sie Tomcat neu.

Nächster Schritt

Tomcat stellt die Anwendung unter dem Namen der WAR-Datei bereit. Mit e2022.war und Port 8080 öffnen Sie ISPICIO_E im Browser unter localhost:8080/e2022. Die erste Anmeldung und die Einrichtung beschreibt die Seite Admin.