IRIS installation (Docker): Unterschied zwischen den Versionen
Ddang (Diskussion | Beiträge) |
Ddang (Diskussion | Beiträge) |
||
Zeile 21: | Zeile 21: | ||
Usually, Linux admin-rights are necessary for Docker-installations. | Usually, Linux admin-rights are necessary for Docker-installations. | ||
− | + | The most commands therefore require a "sudo" in front or have to be executed as a root user. | |
− | == | + | == First installation == |
− | === | + | === Download / copy IRIS === |
− | + | You receive a download link for IRIS from our support. | |
− | + | To upload the container-image, you can upload the file via scp into the home directory of the Docker-host: | |
− | scp iris-1.X.X.tar.gz < | + | scp iris-1.X.X.tar.gz <username>@<servername>:~/ |
− | + | Alternatively, donwloading directlyon the machine via download link: | |
− | wget < | + | wget <downloadlink> |
− | === IRIS Docker | + | === load IRIS Docker image === |
docker load -i iris-1.X.X.tar.gz | docker load -i iris-1.X.X.tar.gz | ||
− | === | + | === prepare volumes and networks === |
docker volume create hsc-db | docker volume create hsc-db | ||
Zeile 48: | Zeile 48: | ||
docker network create hsc-network | docker network create hsc-network | ||
− | === | + | === create container from image === |
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 | 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 | ||
− | === | + | === connect network === |
docker network connect hsc-network iris | docker network connect hsc-network iris | ||
− | === | + | === start container === |
docker start iris | docker start iris | ||
− | === | + | === check container logs === |
docker logs iris | docker logs iris | ||
− | + | An entry should be displayed in the logs that sounds similar to:<syntaxhighlight lang="text" line="1" start="1"> | |
2023-02-08 17:22:38.926 -08 WARN [main] (init.ServiceInitializer:166) - A new user has been created.: | 2023-02-08 17:22:38.926 -08 WARN [main] (init.ServiceInitializer:166) - A new user has been created.: | ||
Username: root@localhost | Username: root@localhost | ||
Password: P6oV-GK3GYsdnn_5usDg1tBmn00 | Password: P6oV-GK3GYsdnn_5usDg1tBmn00 | ||
Please login with this user and change your password immediately! | Please login with this user and change your password immediately! | ||
− | </syntaxhighlight> | + | </syntaxhighlight>Please note this username + password immediately. |
Sollte dieser Eintrag nicht erscheinen, warten Sie einen Moment und führen Sie den Befehl "docker logs iris" erneut aus. | Sollte dieser Eintrag nicht erscheinen, warten Sie einen Moment und führen Sie den Befehl "docker logs iris" erneut aus. |
Version vom 19. April 2023, 15:14 Uhr
Information
IRIS version
In the following text, you can find many commands that contain the current version of IRIS.
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.
The most commands therefore require a "sudo" in front or have to be executed as a root user.
First installation
Download / copy IRIS
You receive a download link for IRIS from our support.
To upload the container-image, you can upload the file via scp into the home directory of the Docker-host:
scp iris-1.X.X.tar.gz <username>@<servername>:~/
Alternatively, donwloading directlyon the machine via download link:
wget <downloadlink>
load IRIS Docker image
docker load -i iris-1.X.X.tar.gz
prepare volumes and networks
docker volume create hsc-db
docker volume create hsc-config
docker network create hsc-network
create container from image
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
connect network
docker network connect hsc-network iris
start container
docker start iris
check container logs
docker logs iris
An entry should be displayed in the logs that sounds similar to:
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!
Please note this username + password immediately.
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