InhaltInstallation und Einrichtung

Umstieg von e2016

Gilt für ISPICIO_E 2.1.1.0 Stand

Eine bestehende Installation von e2016 unter Apache Tomcat auf e2022 umstellen: Java, Tomcat und PostgreSQL aktualisieren, die neue Anwendung bereitstellen und die alte entfernen.

Auf dieser Seite

e2016 ist die frühere Generation von ISPICIO_E. Die aktuelle Generation heißt e2022; die WAR-Datei und die Adresse der Anwendung tragen diesen Namen.

Java aktualisieren

ISPICIO_E setzt Java 25 oder neuer voraus. Installieren Sie ein passendes JDK auf dem Server, auf dem ISPICIO_E läuft. Java lässt sich auf mehreren Wegen installieren. Empfohlen sind OpenJDK und Eclipse Temurin. Eclipse Temurin ist gut dokumentiert, siehe die Installationsanleitung.

Tomcat aktualisieren

ISPICIO_E setzt Apache Tomcat 11 oder neuer voraus. Apache Tomcat stellt für jede Hauptversion einen Migrationsleitfaden bereit, siehe Migration Guide. Den Schritt von 8.5.x auf 9.0.x beschreibt zum Beispiel der Migrationsleitfaden für Tomcat 9.0.x.

PostgreSQL aktualisieren

ISPICIO_E setzt PostgreSQL ab 19 voraus. Mit PostgreSQL 12.0 oder älter startet ISPICIO_E nicht.

Erstellen Sie einen Dump (Sicherung) Ihrer Datenbank, bevor Sie PostgreSQL aktualisieren. Wie das geht, beschreibt die PostgreSQL-Dokumentation: SQL Dump. Wählen Sie dort die Dokumentation zu Ihrer PostgreSQL-Version.

ISPICIO_E aktualisieren

Laden Sie die aktuelle Version von der Seite Downloads herunter und entpacken Sie das ZIP-Archiv. Es enthält die WAR-Datei e2022.war.

e2016 stoppen

Stoppen Sie die Anwendung e2016 im Tomcat Manager. Sie erreichen ihn unter YOUR_SERVER_URL:8080/manager. Einzelheiten stehen in der Tomcat-Dokumentation: Tomcat Web Application Manager How To.

Neue Version bereitstellen

  1. Verbinden Sie sich per SFTP mit Ihrem Server.

  2. Kopieren Sie die neue WAR-Datei in den Tomcat-Ordner webapps/, in dem die Anwendung e2016 liegt (tomcat/webapps/e2016).

  3. Richten Sie die Verbindung zur PostgreSQL-Datenbank ein. Dafür gibt es zwei Wege. Nutzen Sie nur einen davon und kombinieren Sie sie nicht. Die bisherigen Einstellungen von e2016 finden Sie in tomcat/webapps/e2016/WEB-INF/classes/application.properties.

    Variante A: Umgebungsvariablen (dringend empfohlen)

    Setzen Sie die Umgebungsvariablen in tomcat/bin/setenv.sh. Gibt es die Datei nicht, legen Sie sie an und machen Sie sie ausführbar:

    touch tomcat/bin/setenv.sh
    chmod 755 tomcat/bin/setenv.sh

    Tragen Sie den folgenden Inhalt in setenv.sh ein und füllen Sie die Werte aus:

    # Ispe config
    export ISPE_DB_HOST=
    export ISPE_DB_PORT=5432 # change if port is different
    export ISPE_DB_NAME=ispe # change if db name is different
    export ISPE_DB_USER=
    export ISPE_DB_PASSWORD=

    Unter Windows heißt die Datei setenv.bat, siehe Installation mit Apache Tomcat.

    Variante B: Konfigurationsdatei (nicht empfohlen)

    Bearbeiten Sie die Datei tomcat/webapps/e2022/WEB-INF/classes/application-e2022.yml und ersetzen Sie die Variablen in ${...} durch Ihre Datenbankeinstellungen:

    spring:
      datasource:
        url: jdbc:postgresql://${ISPE_DB_HOST}:${ISPE_DB_PORT}/${ISPE_DB_NAME}
        username: ${ISPE_DB_USER}
        password: ${ISPE_DB_PASSWORD}
  4. Starten Sie Tomcat neu, zum Beispiel im Terminal:

    1. Verbinden Sie sich per SSH mit Ihrem Tomcat-Server.
    2. Wechseln Sie in den Ordner tomcat_home/bin.
    3. Stoppen Sie Apache Tomcat mit ./shutdown.sh.
    4. Starten Sie Apache Tomcat mit ./startup.sh.
  5. Prüfen Sie, ob e2022 erreichbar ist. Die neue Anwendung läuft im neuen Kontext e2022: Ersetzen Sie in der Adresse im Browser e2016 durch e2022, zum Beispiel my-ispicio-server.com/e2022. Es erscheint ein Anmeldeformular.

    Ist e2022 nicht erreichbar, prüfen Sie die Protokolle, entweder im Tomcat Manager oder per SSH oder SFTP auf dem Tomcat-Server. Der Abschnitt „Fehlerbehebung“ unten nennt die Logdatei.

e2016 entfernen

Nach der erfolgreichen Anmeldung an e2022 können Sie e2016 von Ihrem Server entfernen. Sichern Sie bei Bedarf die Datei /webapps/e2016.war, löschen Sie sie und starten Sie Tomcat neu.

Fehlerbehebung

Logdatei prüfen

ISPICIO_E schreibt sein Protokoll in tomcat/logs/ispicio-e2022.log. Stellen Sie sicher, dass der Tomcat-Benutzer in diese Datei schreiben kann.