InhaltInstallation und Einrichtung

Aktualisieren

Gilt für ISPICIO_E 2.1.1.0 Stand

ISPICIO_E auf die neueste freigegebene Version bringen, mit Docker oder unter Apache Tomcat.

Auf dieser Seite

ISPICIO_E gibt es als freigegebene Version und in Einzelfällen als Beta-Version:

  • Freigegeben: voll funktionsfähig und getestet. Das ist die Version auf der Seite Downloads.
  • Beta: enthält Fehlerbehebungen und Funktionswünsche, die noch nicht vollständig getestet oder freigegeben sind. Beta-Versionen sind für Kunden gedacht, deren Fehlermeldung oder Funktionswunsch umgesetzt, aber noch nicht ausgerollt ist. Sie erhalten eine Beta-Version vom ISPICIO-Support: die WAR-Datei aus einem separaten Downloadverzeichnis, das Docker-Image über ein eigenes Image oder eine eigene Versionsnummer (Tag).

Docker

Der Befehl docker pull lädt nur das neue Image. Für die Aktualisierung muss der laufende Container aus diesem Image neu erstellt werden. Der Ablauf hängt davon ab, wie Sie ISPICIO_E installiert haben, siehe Installation mit Docker.

Installation mit der Compose-Datei

  1. Öffnen Sie ein Terminal und wechseln Sie in den Ordner mit der Datei docker-compose.yml. Verwenden Sie dieselbe Compose-Datei und denselben Projektnamen wie bei der Installation.

  2. Ermitteln Sie den Namen des Dienstes, zu dem der Container ispicio_e2022 gehört. Er steht in der Spalte SERVICE. Mit der Beispieldatei aus der Installation heißt der Dienst e2022.

    docker compose ps -a
  3. Hat das neue Image einen anderen Tag, tragen Sie ihn zuerst in der Compose-Datei unter image: ein.

  4. Laden Sie das Image und erstellen Sie den Container neu. Ersetzen Sie <service> durch den Namen des Dienstes.

    docker compose up -d --pull always <service>

    Compose ersetzt den Container, wenn sich das Image oder die Konfiguration des Dienstes geändert hat. Eingebundene Volumes bleiben erhalten.

  5. Prüfen Sie Status und Protokoll des Dienstes:

    docker compose ps <service>
    docker compose logs --tail 100 <service>
  6. Prüfen Sie, ob ISPICIO_E im Browser erreichbar ist und die erwartete Version anzeigt.

Installation mit docker run

  1. Öffnen Sie ein Terminal und laden Sie das neue Image herunter:

    docker pull ispiciogmbh/e2022:latest
  2. Stoppen Sie den bisherigen Container und benennen Sie ihn vorübergehend um. Im Beispiel heißt er ispicio_e.

    docker stop ispicio_e
    docker rename ispicio_e ispicio_e_alt
  3. Starten Sie den neuen Container unter dem ursprünglichen Namen. Verwenden Sie dieselben Ports, Mounts, Umgebungsvariablen und weiteren Startoptionen wie bei der Installation, zum Beispiel:

    docker run -d \
      -e ISPE_DB_HOST='<DB-HOST>' \
      -e ISPE_DB_NAME='<DB-NAME>' \
      -e ISPE_DB_USER='<DB-USER>' \
      -e ISPE_DB_PASSWORD='<DB-PASSWORD>' \
      -p 8080:8080 \
      --name ispicio_e \
      ispiciogmbh/e2022:latest
  4. Prüfen Sie, ob ISPICIO_E im Browser erreichbar ist und die erwartete Version anzeigt.

  5. Läuft die neue Version, entfernen Sie den alten Container:

    docker rm ispicio_e_alt

Auf eine Beta-Version wechseln

Gehen Sie vor wie bei der Aktualisierung. Verwenden Sie dabei das Image und den Tag, die der ISPICIO-Support Ihnen nennt, zum Beispiel ispiciogmbh/ispe-test:latest:

  • Installation mit der Compose-Datei: Tragen Sie Image und Tag in der Compose-Datei unter image: ein (Schritt 3).
  • Installation mit docker run: Verwenden Sie Image und Tag in den Befehlen docker pull und docker run (Schritte 1 und 3).

Apache Tomcat

  1. Laden Sie die aktuelle Version von der Seite Downloads herunter und entpacken Sie das ZIP-Archiv. Es enthält die WAR-Datei e2022.war. Eine Beta-Version laden Sie stattdessen aus dem Downloadverzeichnis, das der ISPICIO-Support Ihnen nennt.

  2. Ersetzen Sie die WAR-Datei im Ordner webapps Ihrer Tomcat-Installation durch die neue Datei, siehe Installation mit Apache Tomcat.

  3. Starten Sie Tomcat neu.