IRIS installation (Docker)

Information

IRIS version

In the following text, you can find many commands that the current version of IRIS contains.

Please replace the version with the latest version of IRIS.

Example:

docker load -i iris-1.X.X.tar.gz

to

docker load -i iris-1.0.8.tar.gz

or rather the latest version

Docker on Linux

Following description applies to the installation of Docker on Linux.

For other operating systems, the commands or steps must be changed accordingly.

Usually, Linux admin-rights are necessary for Docker-installations.

Die meisten Befehle benötigen deshalb ein "sudo" davor oder müssen als root User ausgeführt werden.

Erstinstallation

Herunterladen / Kopieren von IRIS

Sie erhalten den Downloadlink für IRIS von unserem Support

Zum Hochladen des Container-Images können Sie die Datei per scp in das Home-Verzeichnis des Docker-Hosts hochladen:

scp iris-1.X.X.tar.gz <Benutzername>@<Servername>:~/

Alternativ direkt über den Downloadlink auf der Maschine herunterladen:

wget <Downloadlink>

IRIS Docker Image laden

docker load -i iris-1.X.X.tar.gz

Volumes und Netzwerke vorbereiten

docker volume create hsc-db

docker volume create hsc-config

docker network create hsc-network

Container aus Image erstellen

docker create --name iris --network bridge --hostname iris --publish 127.0.0.1:8080:443 --volume hsc-db:/var/lib/mysql --volume hsc-config:/etc/heidler --restart unless-stopped iris:1.X.X

Netzwerk verbinden

docker network connect hsc-network iris

Container starten

docker start iris

Logs des Containers prüfen

docker logs iris

In den Logs sollte ein Eintrag erscheinen, der so ähnlich lautet:

2023-02-08 17:22:38.926 -08 WARN  [main] (init.ServiceInitializer:166) - A new user has been created.:
Username: root@localhost
Password: P6oV-GK3GYsdnn_5usDg1tBmn00
Please login with this user and change your password immediately!

Bitte notieren Sie sich diesen Benutzer + Passwort umgehend.

Sollte dieser Eintrag nicht erscheinen, warten Sie einen Moment und führen Sie den Befehl "docker logs iris" erneut aus.

Reverse Proxy konfigurieren

Es muss ein bereits mit HTTPS konfigurierter Reverse Proxy eingerichtet sein.

Wir können den SSL-Config Generator von Mozilla hierfür empfehlen: https://ssl-config.mozilla.org/

Bitte prüfen Sie vor der Konfiguration der Verknüpfung von nginx -> iris, ob eine gültige HTTPS Verbindung mit einer statischen Seite hergestellt werden kann.

Danach können Sie unter nginx den "location /" Eintrag wie folgt abändern.

   location / {

       proxy_pass      https://localhost:8080;

       proxy_read_timeout               300;

       proxy_connect_timeout            300;

       proxy_set_header                 X-Real-IP                                       $remote_addr;

       proxy_set_header                 X-Forwarded-For                                 $proxy_add_x_forwarded_for;

       proxy_set_header                 Host                                            $host;

       proxy_ssl_verify                 off;

   }

Updates

Herunterladen / Kopieren von IRIS

Sie erhalten den Downloadlink für IRIS von unserem Support

Zum Hochladen des Container-Images können Sie die Datei per scp in das Home-Verzeichnis des Docker-Hosts hochladen:

scp iris-1.X.X.tar.gz <Benutzername>@<Servername>:~/

Alternativ direkt über den Downloadlink auf der Maschine herunterladen:

wget <Downloadlink>

Docker Image laden

docker load -i iris-1.X.X.tar.gz

IRIS stoppen

Achtung: Ab hier ist IRIS für ca. 1 Minute nicht erreichbar

docker stop iris

IRIS Container löschen

docker rm iris

Neuen IRIS Container mit neuer Version erstellen

docker create --name iris --network bridge --hostname iris --publish 127.0.0.1:8080:443 --volume hsc-db:/var/lib/mysql --volume hsc-config:/etc/heidler --restart unless-stopped iris:1.X.X

Netzwerk verbinden

docker network connect hsc-network iris

Container starten

docker start iris

Altes Container-Image entfernen

Achtung! Im folgenden Befehl die Version 1.X.X durch die vorherige (nicht aktuelle) Version von IRIS ersetzen

docker image rm iris:1.X.X