Umstieg von e2016
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
-
Verbinden Sie sich per SFTP mit Ihrem Server.
-
Kopieren Sie die neue WAR-Datei in den Tomcat-Ordner
webapps/, in dem die Anwendung e2016 liegt (tomcat/webapps/e2016). -
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.shTragen Sie den folgenden Inhalt in
setenv.shein 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.ymlund 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} -
Starten Sie Tomcat neu, zum Beispiel im Terminal:
- Verbinden Sie sich per SSH mit Ihrem Tomcat-Server.
- Wechseln Sie in den Ordner
tomcat_home/bin. - Stoppen Sie Apache Tomcat mit
./shutdown.sh. - Starten Sie Apache Tomcat mit
./startup.sh.
-
Prüfen Sie, ob e2022 erreichbar ist. Die neue Anwendung läuft im neuen Kontext
e2022: Ersetzen Sie in der Adresse im Browsere2016durche2022, zum Beispielmy-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.