ContentsInstallation and setup

Update

Applies to ISPICIO_E 2.1.1.0 Last reviewed

Update ISPICIO_E to the latest released version, with Docker or on Apache Tomcat.

On this page

ISPICIO_E is available as a released version and, in individual cases, as a beta version:

  • Released: fully functional and tested. This is the version on the Downloads page.
  • Beta: contains bug fixes and feature requests that are not yet fully tested or approved. Beta versions are intended for customers whose bug report or feature request has been implemented but not yet rolled out. You receive a beta version from ISPICIO support: the WAR file from a separate download directory, the Docker image as a separate image or under its own version number (tag).

Docker

The command docker pull only downloads the new image. For the update, the running container must be recreated from this image. The procedure depends on how you installed ISPICIO_E, see Installation with Docker.

Installation with the Compose file

  1. Open a terminal and change to the folder that contains the file docker-compose.yml. Use the same Compose file and the same project name as for the installation.

  2. Find the name of the service that the container ispicio_e2022 belongs to. It is shown in the SERVICE column. With the sample file from the installation, the service is called e2022.

    docker compose ps -a
  3. If the new image has a different tag, first enter it in the Compose file under image:.

  4. Download the image and recreate the container. Replace <service> with the name of the service.

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

    Compose replaces the container if the image or the configuration of the service has changed. Mounted volumes are kept.

  5. Check the status and the log of the service:

    docker compose ps <service>
    docker compose logs --tail 100 <service>
  6. Check that ISPICIO_E can be reached in the browser and shows the expected version.

Installation with docker run

  1. Open a terminal and download the new image:

    docker pull ispiciogmbh/e2022:latest
  2. Stop the existing container and rename it temporarily. In the example it is called ispicio_e.

    docker stop ispicio_e
    docker rename ispicio_e ispicio_e_old
  3. Start the new container under the original name. Use the same ports, mounts, environment variables and other start options as for the installation, for example:

    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. Check that ISPICIO_E can be reached in the browser and shows the expected version.

  5. When the new version is running, remove the old container:

    docker rm ispicio_e_old

Switch to a beta version

Proceed as for the update. Use the image and the tag that ISPICIO support gives you, for example ispiciogmbh/ispe-test:latest:

  • Installation with the Compose file: enter the image and the tag in the Compose file under image: (step 3).
  • Installation with docker run: use the image and the tag in the commands docker pull and docker run (steps 1 and 3).

Apache Tomcat

  1. Download the current version from the Downloads page and unpack the ZIP archive. It contains the WAR file e2022.war. For a beta version, download the file from the download directory that ISPICIO support gives you instead.

  2. Replace the WAR file in the folder webapps of your Tomcat installation with the new file, see Installation with Apache Tomcat.

  3. Restart Tomcat.