IRIS installation (Docker) - Versionsgeschichte

Ddang am 26. April 2023 um 12:53 Uhr

2023-04-26T12:53:09Z

Ddang: /* Neuen IRIS Container mit neuer Version erstellen */

2023-04-26T12:32:34Z

Neuen IRIS Container mit neuer Version erstellen

Ddang am 26. April 2023 um 12:12 Uhr

2023-04-26T12:12:40Z

Ddang am 26. April 2023 um 12:08 Uhr

2023-04-26T12:08:21Z

Ddang am 26. April 2023 um 11:55 Uhr

2023-04-26T11:55:57Z

Sbaumbach am 26. April 2023 um 06:46 Uhr

2023-04-26T06:46:06Z

Sbaumbach: /* configure reverse proxy */

2023-04-21T09:11:10Z

configure reverse proxy

Ddang am 19. April 2023 um 13:36 Uhr

2023-04-19T13:36:30Z

Ddang am 19. April 2023 um 13:14 Uhr

2023-04-19T13:14:53Z

Ddang am 19. April 2023 um 12:31 Uhr

2023-04-19T12:31:22Z

← Nächstältere Version		Version vom 26. April 2023, 12:53 Uhr
Zeile 25:		Zeile 25:


−	== ~~First installation~~ ==	+	== Initial setup ==

	=== Download / copy IRIS ===		=== Download / copy IRIS ===

@@ Zeile 146: / Zeile 146: @@
   docker rm iris
-=== Neuen IRIS Container mit neuer Version erstellen ===
+=== Create new IRIS container with new version ===
   docker create --name iris --hostname iris --network bridge --publish 80:80 --publish 443:443 --volume hsc-db:/var/lib/mysql --volume hsc-config:/etc/heidler --restart unless-stopped iris:1.X.X
-=== Container starten ===
+=== Start container ===
   docker start iris
-=== Altes Container-Image entfernen ===
+=== Remove old container image ===
-Achtung! Im folgenden Befehl die Version 1.X.X durch die vorherige (nicht aktuelle) Version von IRIS ersetzen
+Note! Replace in the following command, version 1.X.X with previous (not current) version of IRIS
   docker image rm iris:1.X.X

@@ Zeile 140: / Zeile 140: @@
 === Stop IRIS ===
-Achtung: Ab hier ist IRIS für ca. 1 Minute nicht erreichbar
+Note: After this, IRIS is unavailable for approx. 1 minute
   docker stop iris
-=== IRIS Container löschen ===
+=== Delete IRIS container ===
   docker rm iris

@@ Zeile 38: / Zeile 38: @@
   wget <downloadlink>
-=== load IRIS Docker image ===
+=== Load IRIS Docker image ===
   docker load -i iris-1.X.X.tar.gz
-=== prepare volumes and networks ===
+=== Prepare volumes and networks ===
   docker volume create hsc-db
   docker volume create hsc-config
-=== create container from image ===
+=== Create container from image ===
   docker create --name iris --hostname iris --network bridge --publish 80:80 --publish 443:443 --volume hsc-db:/var/lib/mysql --volume hsc-config:/etc/heidler --restart unless-stopped iris:1.X.X
-=== start container ===
+=== Start container ===
   docker start iris
-=== check container logs ===
+=== Check container logs ===
   docker logs iris
 An entry should be displayed in the logs that sounds similar to:<syntaxhighlight lang="text" line="1" start="1">
@@ Zeile 136: / Zeile 136: @@
   wget <downloadlink>
-=== load IRIS Docker image ===
+=== Load IRIS Docker image ===
   docker load -i iris-1.X.X.tar.gz
-=== stop IRIS ===
+=== Stop IRIS ===
 Achtung: Ab hier ist IRIS für ca. 1 Minute nicht erreichbar
   docker stop iris

@@ Zeile 125: / Zeile 125: @@
 == Updates ==
-=== Herunterladen / Kopieren von IRIS ===
+=== Download / copy IRIS ===
-Sie erhalten den Downloadlink für IRIS von unserem Support
+You receive a download link for IRIS from our support.
-Zum Hochladen des Container-Images können Sie die Datei per scp in das Home-Verzeichnis des Docker-Hosts hochladen:
+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 <Benutzername>@<Servername>:~/
+  scp iris-1.X.X.tar.gz <username>@<servername>:~/
-Alternativ direkt über den Downloadlink auf der Maschine herunterladen:
+Alternatively, donwloading directlyon the machine via download link:
-  wget <Downloadlink>
+  wget <downloadlink>
-=== Docker Image laden ===
+=== load IRIS Docker image ===
   docker load -i iris-1.X.X.tar.gz
-=== IRIS stoppen ===
+=== stop IRIS ===
 Achtung: Ab hier ist IRIS für ca. 1 Minute nicht erreichbar
   docker stop iris

@@ Zeile 63: / Zeile 63: @@
 If this entry does not appear, wait a moment und execute the command "docker logs iris" again.
-=== Configure SSL certificate ===
+=== Option 1: Configure your own SSL certificate ===
 By default, the docker container will publish a HTTPS server with a self signed certificate.
@@ Zeile 111: / Zeile 111: @@
 /var/lib/docker/volumes/hsc-config/_data/ssl/public
 == Updates ==

@@ Zeile 45: / Zeile 45: @@
   docker volume create hsc-config
 === 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 --hostname iris --network bridge --publish 80:80 --publish 443:443 --volume hsc-db:/var/lib/mysql --volume hsc-config:/etc/heidler --restart unless-stopped iris:1.X.X
 === start container ===
@@ Zeile 68: / Zeile 63: @@
 If this entry does not appear, wait a moment und execute the command "docker logs iris" again.
-=== configure reverse proxy ===
+=== Configure SSL certificate ===
-There already has to be a configured reverse proxy with HTTPS set up.
+By default, the docker container will publish a HTTPS server with a self signed certificate.
-Therefore, we can recommend the ssl-config generator from Mozilla: https://ssl-config.mozilla.org/
+This must be replaced by a public certificate from a recognized certificate authority.
-Please check before the configuration of the connection nginx -> iris, if a valid HTTPS connection can be established with a static site.
+Please place the files under the above mentioned filename into the following folder, as seen by the container:
-After that, you can change the "location /" entry under nginx like following.<blockquote> <code>   location / {</code>
+This folder is being provided by the docker volume "hsc-config".
-  <code>       proxy_pass      <nowiki>https://localhost:8080</nowiki>;</code>
+To find out which folder on the host machine this folder belongs to, you can use the following command:
- <code>       proxy_read_timeout               300;</code>
+Example:
- <code>       proxy_connect_timeout            300;</code>
+"Mountpoint": "/var/lib/docker/volumes/hsc-config/_data"
- <code>       proxy_set_header                 X-Real-IP                                       $remote_addr;</code>
+This would be the path where the files should be placed:
- <code>       proxy_set_header                 X-Forwarded-For                                 $proxy_add_x_forwarded_for;</code>
+/var/lib/docker/volumes/hsc-config/_data/ssl/public
@@ Zeile 121: / Zeile 137: @@
 === 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
+  docker create --name iris --hostname iris --network bridge --publish 80:80 --publish 443:443 --volume hsc-db:/var/lib/mysql --volume hsc-config:/etc/heidler --restart unless-stopped iris:1.X.X
 === Container starten ===

@@ Zeile 66: / Zeile 66: @@
 </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.
+If this entry does not appear, wait a moment und execute the command "docker logs iris" again.
-=== Reverse Proxy konfigurieren ===
+=== configure reverse proxy ===
-Es muss ein bereits mit HTTPS konfigurierter Reverse Proxy eingerichtet sein.
+There already has to be a configured reverse proxy with HTTPS set up.
-Wir können den SSL-Config Generator von Mozilla hierfür empfehlen: https://ssl-config.mozilla.org/
+Therefore, we can recommend the ssl-config generator from Mozilla: 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.
+Please check before the configuration of the connection nginx -> iris, if a valid HTTPS connection can be established with a static site.
-Danach können Sie unter nginx den "location /" Eintrag wie folgt abändern.<blockquote> <code>   location / {</code>
+After that, you can change the "location /" entry under nginx like following.<blockquote> <code>   location / {</code>
   <code>       proxy_pass      <nowiki>https://localhost:8080</nowiki>;</code>

@@ Zeile 3: / Zeile 3: @@
 === IRIS version ===
-In the following text, you can find many commands that the current version of [[IRIS cloud system|IRIS]] contains.
+In the following text, you can find many commands that contain the current version of [[IRIS cloud system|IRIS]].
 Please replace the version with the latest version of IRIS.