Installation des Edge Gateway Docker

Import des Docker-Abbilds

Bevor Sie einen Container Edge Gateway Docker erstellen können, müssen Sie das Docker-Abbild importieren. Öffnen Sie dazu eine Shell, in der Ihnen die Docker-Befehle sowie die Datei cleanroom-gateway-4.6.1-33-v4.tgz zur Verfügung stehen. Führen Sie aus der Shell den folgenden Befehl aus und passen Sie den Pfad zur Datei TGZ an, wenn sie sich nicht im aktuellen Verzeichnis befindet:

docker load --input cleanroom-gateway-4.6.1-33-v4.tgz

Prüfen Sie anschließend mit dem folgenden Befehl, ob der Import erfolgreich war:

docker inspect --type=image cleanroom-gateway:4.6.1-33-v4

Die erwartete Ausgabe ist die folgende (die SHA256-Kennung kann je nach Betriebssystem abweichen, auf dem Docker installiert ist; die Beispiele stammen von Debian 13). Ist dies nicht der Fall, ist der Import fehlgeschlagen:

[
    {
        "Id": "sha256:c63645a09181bc3b83958bedf2eb3d7ea5fbbc2526126edb660a519b93338974",
        "RepoTags": [
            "cleanroom-gateway:4.6.1-33-v4"
        ],

Vollständige Ausgabe

[
    {
        "Id": "sha256:c63645a09181bc3b83958bedf2eb3d7ea5fbbc2526126edb660a519b93338974",
        "RepoTags": [
            "cleanroom-gateway:4.6.1-33-v4"
        ],
        "RepoDigests": [
            "cleanroom-gateway@sha256:fd96104ea219a05216c90c71c39b761083c989cbab8ef1f388cac09015bd54a3"
        ],
        "Comment": "buildkit.dockerfile.v0",
        "Created": "2026-02-17T16:21:12.399890264+01:00",
        "Config": {
            "User": "root",
            "ExposedPorts": {
                "9080/tcp": {}
            },
            "Env": [
                "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin",
                "DEBIAN_FRONTEND=noninteractive",
                "IMAGE_BUILD_DATE=20260217T161839",
                "IMAGE_BUILD_VERSION=4.6.1-33-v4",
                "IMAGE_IPDIPC=IPC-54826,IPC-53702,IPC-55425"
            ],
            "Entrypoint": [
                "/entrypoint.sh"
            ],
            "Volumes": {
                "/etc/ipdiva/": {},
                "/var/log/": {}
            },
            "Labels": {
                "maintainer": "contact@systancia.com",
                "org.label-schema.build-date": "20260217T161839",
                "org.label-schema.description": "Systancia Cleanroom Gateway",
                "org.label-schema.name": "Systancia Cleanroom 4.6.1-33-v4 Gateway",
                "org.label-schema.url": "http://systancia.com/",
                "org.label-schema.vendor": "Systancia",
                "version": "4.6.1-33-v4"
            },
            "Healthcheck": {
                "Test": [
                    "CMD-SHELL",
                    "/usr/lib/nagios/plugins/IPdivaSensorGateway -a isConnected -g 127.0.0.1:9080"
                ],
                "Interval": 300000000000,
                "Timeout": 10000000000,
                "Retries": 3
            }
        },
        "Architecture": "amd64",
        "Os": "linux",
        "Size": 1248982227,
        "GraphDriver": {
            "Data": {
                "LowerDir": "/var/lib/docker/overlay2/5a32af4bf30239320f2d4f04e9dde6e448d138d0e00dbcd0aa07ff859518bfd5/diff:/var/lib/docker/overlay2/da3ceed2e06933403d5e2b503f654efe58afd3067562d4991615cc79109f5000/diff:/var/lib/docker/overlay2/022f1b9fc82a6210ac50a7bf20705651a5a6bd2bfcdd8ca4993778870c4f04ce/diff:/var/lib/docker/overlay2/7675c3cb606871d89d593c5b40746256a109640e03d4846ee49392792f94c29b/diff:/var/lib/docker/overlay2/a0bc243e1069486711b74a39142def4596f99b21d00d286a2bd6212cf8902401/diff:/var/lib/docker/overlay2/fe91732a9355873a0d60ec041ea365567f0fbc963173c9428ab896b591fcb460/diff:/var/lib/docker/overlay2/d4af0110a3ab43120dea8c19e35b7552ad8f8d993d556c34143ecb3c4bd7e670/diff:/var/lib/docker/overlay2/399d72a9751679283e1435dffa5ea7b5abc07f264987815be3846e8e617cf031/diff:/var/lib/docker/overlay2/5c1723a91777858469dc540b3a91738f4b6fc6c0a3cc6686d48b4cb85a9c0400/diff:/var/lib/docker/overlay2/60b4e962507a658aa32be63de9cea55df0a45459b2f3549b3eef3443b35519b9/diff:/var/lib/docker/overlay2/9ff870b850857af52af3de1939f1abd129e96a91d608f3b8f68e0cbcd09eb181/diff",
                "MergedDir": "/var/lib/docker/overlay2/48efe7a9b5e8c4e24a395024dd0876c942b03a52ea161df553d5ee566505c4a8/merged",
                "UpperDir": "/var/lib/docker/overlay2/48efe7a9b5e8c4e24a395024dd0876c942b03a52ea161df553d5ee566505c4a8/diff",
                "WorkDir": "/var/lib/docker/overlay2/48efe7a9b5e8c4e24a395024dd0876c942b03a52ea161df553d5ee566505c4a8/work"
            },
            "Name": "overlay2"
        },
        "RootFS": {
            "Type": "layers",
            "Layers": [
                "sha256:51e78f04fd47b324ef2558bbed0cb5bc0d6d8e5ca3c56d5b98b91866a88f37bb",
                "sha256:3bb2b94a7a30506f2a91d55a04aa0e90a487b3a321d2e1df4f97dfbcfe32cfc0",
                "sha256:deb44bbc3e3d6990e142dc66532aeace714d6c191f1ede7a0f6fd8dcd7e751d3",
                "sha256:e61e4e2f89a04cb7bed974b2c8f510dd72d76e4bf998a000d082fc33bf29947e",
                "sha256:96b1236ab0e31d36a0d0fd17878770d969a11c8d4d33f8cacac568d0b0d76324",
                "sha256:989a4d7dbba1836ad30f58ca73f3101b21b80929f732d5ebdc87a69939b8cf6d",
                "sha256:1f2b05f37aceed6edd80cbe798657a7eb8fce3c7383df8d40d9fdeb273867a9d",
                "sha256:63aa193be3dc44af0057719f79991745e40d8b522a2aa49743dd04fe81b6a637",
                "sha256:02dcea7c2ed886996c81bd6980516420b90e2cdd930dc805388bcd5c7e14b5b3",
                "sha256:1f8c0ab2de5021d138baa67506b22d4d21750a23d0e9278a152daa2e7e953bff",
                "sha256:3601c2e047e3c5019a5e45fb23b478154beb6188761e31aeddb4326bfe16f81c",
                "sha256:20963ed8264d1ceaeb3680375c9c3df4045aa17af258957f3fa83f6224e62138"
            ]
        },
        "Metadata": {
            "LastTagTime": "0001-01-01T00:00:00Z"
        }
    }
]

Konfiguration des Containers

Umgebungsvariablen

Variablen für die Bereitstellung durch Pairing

Name	Pflicht	Standardwert	Kommentar
ENV_MEDIATION	JA		Wird für die Verbindung durch Pairing verwendet. Gibt den Tenant CyberElements an.
ENV_TOKEN	JA		Wird für die Verbindung durch Pairing verwendet. Gibt das Pairing-Token an, das für die Verbindung mit dem Mediation Controller zu verwenden ist.
ENV_NO_CHECK_CERT	NEIN	false	Wird für die Verbindungen durch Pairing verwendet. Deaktiviert die Prüfung des Webzertifikats des Mediation Controller oder nicht; nützlich beim Zugriff über eine IP-Adresse oder wenn das Webzertifikat von den standardmäßigen öffentlichen Zertifizierungsstellen nicht anerkannt wird. Zulässige Werte: true oder false.

Variablen für die manuelle Bereitstellung

Name	Pflicht	Standardwert	Kommentar
ENV_GW_CERT_NAME	JA		Wird für die Verbindung mit manueller Konfiguration verwendet. Name der Zertifikatsdatei für die Verbindung mit dem SSL Router.
ENV_GW_CERT_PASSWORD	JA		Wird für die Verbindung mit manueller Konfiguration verwendet. Passwort der Zertifikatsdatei für die Verbindung mit dem SSL Router.
ENV_CARE_CERT_NAME	NEIN	Wert von ENV_GW_CERT_NAME	Wird für die Verbindung mit manueller Konfiguration verwendet. Name der Zertifikatsdatei des Aufzeichnungsdienstes.
ENV_CARE_CERT_PASSWORD	NEIN	Wert von ENV_GW_CERT_PASSWORD	Wird für die Verbindung mit manueller Konfiguration verwendet. Passwort der Zertifikatsdatei des Aufzeichnungsdienstes.
ENV_SSL_ROUTER_IP	JA		Wird für die Verbindung mit manueller Konfiguration verwendet. IP-Adresse oder DNS-Name des SSL Router, mit dem sich das Edge Gateway verbindet.
ENV_SSL_ROUTER_PORT	NEIN	443	Wird für die Verbindung mit manueller Konfiguration verwendet. Port des SSL Router, mit dem sich das Edge Gateway verbindet.

Verschiedene Variablen

Name	Pflicht	Standardwert	Kommentar
ENV_DISABLE_RSYSLOG	NEIN	false	Deaktivierung des Dienstes rsyslog. Zulässige Werte: true oder false.
ENV_KERBEROS_CONFIG_ENABLE	NEIN	false	Aktiviert die Kerberos-Konfiguration, damit sich RDP-Anwendungen im Modus ohne Agent über Kerberos authentifizieren können. Zulässige Werte: true oder false. Bei false werden die übrigen Kerberos-Variablen ignoriert.
ENV_KERBEROS_DEFAULT_REALM	JA (wenn die Kerberos-Konfiguration aktiviert ist)		Name des Kerberos-Realms.
ENV_KERBEROS_DEFAULT_DOMAIN	JA (wenn die Kerberos-Konfiguration aktiviert ist)		Name der Kerberos-Domäne.
ENV_KERBEROS_CONTROLLER_ADDRESS	JA (wenn die Kerberos-Konfiguration aktiviert ist)		Verbindungsadresse zum Kerberos-Controller.

Volumes

Volume	Kommentar
/etc/ipdiva/	Konfigurationsvolume des Edge Gateway. Wir empfehlen, es in ein benanntes Volume oder in das Dateisystem der Hostmaschine einzuhängen.
/opt/certificates/	Volume, das das oder die Zertifikate des Edge Gateway in einer Konfiguration ohne Pairing enthält.
/var/lib/ipdiva/carerecord/archives/	Volume, das die grafischen Archive enthält. Wir empfehlen, es in ein benanntes Volume oder in das Dateisystem der Hostmaschine einzuhängen.
/var/ipdiva/care/sshrecord/	Volume, das die SSH-Archive enthält. Wir empfehlen, es in ein benanntes Volume oder in das Dateisystem der Hostmaschine einzuhängen.
/var/log/	Volume, das die Protokolle des Edge Gateway enthält.

Ports

Port	Kommentar
2222 (oder jeder andere vom Administrator gewählte verfügbare Port)	Lauschender Port des Dienstes für den direkten SSH/SFTP-Zugriff.
3389	Lauschender Port des Dienstes für den direkten RDP-Zugriff.
8443	Lauschender Port des Aufzeichnungsdienstes, der bei Verwendung des Windows-Aufzeichnungsagenten verfügbar zu machen ist.

Bereitstellung des Edge Gateway Docker

Bereitstellung mit Pairing

Voraussetzungen

Bevor Sie das Edge Gateway Docker bereitstellen, müssen Sie ein Pairing-Token beziehen.

Die nachstehend beschriebene Bereitstellung verwendet alle verfügbaren Volumes (außer /opt/certificates/, das in diesem Zusammenhang nicht von Nutzen ist) und macht alle Ports verfügbar.
Die Volumes werden im Dateisystem der Hostmaschine am Ort EDGE_GATEWAY_REP eingehängt. Innerhalb dieses Ortes befinden sich die folgenden Unterverzeichnisse:

• config
• graphical_archives
• ssh_archives
• log

Sie können die Variablen der folgenden Befehle anpassen:

Angepasster Wert	Variable	Kommentar
	DOCKER_NAME	Name des Docker-Containers.
	EDGE_GATEWAY_REP	Ort im Dateisystem, an dem die Volumes eingehängt werden.
	ENV_MEDIATION_VALUE	Wert der Umgebungsvariablen ENV_MEDIATION.
	ENV_TOKEN_VALUE	Wert der Umgebungsvariablen ENV_TOKEN.
	ENV_NO_CHECK_CERT_VALUE	Wert der Umgebungsvariablen ENV_NO_CHECK_CERT.
	ENV_KERBEROS_CONFIG_ENABLE_VALUE	Wert der Umgebungsvariablen ENV_KERBEROS_CONFIG_ENABLE.
	ENV_KERBEROS_DEFAULT_REALM_VALUE	Wert der Umgebungsvariablen ENV_KERBEROS_DEFAULT_REALM.
	ENV_KERBEROS_DEFAULT_DOMAIN_VALUE	Wert der Umgebungsvariablen ENV_KERBEROS_DEFAULT_DOMAIN.
	ENV_KERBEROS_CONTROLLER_ADDRESS_VALUE	Wert der Umgebungsvariablen ENV_KERBEROS_CONTROLLER_ADDRESS.

Legen Sie die für das Einhängen der Volumes erforderliche Verzeichnisstruktur im Dateisystem an:

mkdir -p EDGE_GATEWAY_REP/config
mkdir EDGE_GATEWAY_REP/graphical_archives
mkdir EDGE_GATEWAY_REP/ssh_archives
mkdir EDGE_GATEWAY_REP/log

Und starten Sie zuletzt einen neuen Container:

docker run -d --restart unless-stopped --name "DOCKER_NAME" \
-e ENV_MEDIATION="ENV_MEDIATION_VALUE" \
-e ENV_TOKEN="ENV_TOKEN_VALUE" \
-e ENV_NO_CHECK_CERT="ENV_NO_CHECK_CERT_VALUE" \
-e ENV_KERBEROS_CONFIG_ENABLE="ENV_KERBEROS_CONFIG_ENABLE_VALUE" \
-e ENV_KERBEROS_DEFAULT_REALM="ENV_KERBEROS_DEFAULT_REALM_VALUE" \
-e ENV_KERBEROS_DEFAULT_DOMAIN="ENV_KERBEROS_DEFAULT_DOMAIN_VALUE" \
-e ENV_KERBEROS_CONTROLLER_ADDRESS="ENV_KERBEROS_CONTROLLER_ADDRESS_VALUE" \
-v "EDGE_GATEWAY_REP/config/:/etc/ipdiva/:rw" \
-v "EDGE_GATEWAY_REP/graphical_archives/:/var/lib/ipdiva/carerecord/archives/:rw" \
-v "EDGE_GATEWAY_REP/ssh_archives/:/var/ipdiva/care/sshrecord/:rw" \
-v "EDGE_GATEWAY_REP/log/:/var/log/:rw" \
-p 2222:2222 \
-p 3389:3389 \
-p 8443:8443 \
cleanroom-gateway:4.6.1-33-v4

Die Protokolle des Containers lassen sich mit dem folgenden Befehl einsehen:

docker logs -f DOCKER_NAME

Manuelle Bereitstellung

Voraussetzungen

Bevor Sie das Edge Gateway Docker bereitstellen, müssen Sie über die erforderlichen Zertifikate für das Edge Gateway und für den Aufzeichnungsdienst verfügen.

Die nachstehend beschriebene Bereitstellung verwendet alle verfügbaren Volumes und macht alle Ports verfügbar.
Die Volumes werden im Dateisystem der Hostmaschine am Ort MANUAL_REP eingehängt. Innerhalb dieses Ortes befinden sich die folgenden Unterverzeichnisse:

• config
• graphical_archives
• ssh_archives
• log
• certificates

Sie können die Variablen der folgenden Befehle anpassen:

Angepasster Wert	Variable	Kommentar
	MANUAL_NAME	Name des Docker-Containers.
	MANUAL_REP	Ort im Dateisystem, an dem die Volumes eingehängt werden.
	ENV_GW_CERT_NAME_VALUE	Wert der Umgebungsvariablen ENV_GW_CERT_NAME.
	ENV_GW_CERT_PASSWORD_VALUE	Wert der Umgebungsvariablen ENV_GW_CERT_PASSWORD.
	ENV_CARE_CERT_NAME_VALUE	Wert der Umgebungsvariablen ENV_CARE_CERT_NAME.
	ENV_CARE_CERT_PASSWORD_VALUE	Wert der Umgebungsvariablen ENV_CARE_CERT_PASSWORD.
	ENV_SSL_ROUTER_IP_VALUE	Wert der Umgebungsvariablen ENV_SSL_ROUTER_IP.
	ENV_SSL_ROUTER_PORT_VALUE	Wert der Umgebungsvariablen ENV_SSL_ROUTER_PORT.
	ENV_KERBEROS_CONFIG_ENABLE_MANUAL_VALUE	Wert der Umgebungsvariablen ENV_KERBEROS_CONFIG_ENABLE.
	ENV_KERBEROS_DEFAULT_REALM_MANUAL_VALUE	Wert der Umgebungsvariablen ENV_KERBEROS_DEFAULT_REALM.
	ENV_KERBEROS_DEFAULT_DOMAIN_MANUAL_VALUE	Wert der Umgebungsvariablen ENV_KERBEROS_DEFAULT_DOMAIN.
	ENV_KERBEROS_CONTROLLER_ADDRESS_MANUAL_VALUE	Wert der Umgebungsvariablen ENV_KERBEROS_CONTROLLER_ADDRESS.

Legen Sie die für das Einhängen der Volumes erforderliche Verzeichnisstruktur im Dateisystem an:

mkdir -p MANUAL_REP/config
mkdir MANUAL_REP/graphical_archives
mkdir MANUAL_REP/ssh_archives
mkdir MANUAL_REP/log
mkdir MANUAL_REP/certificates

Legen Sie anschließend die Zertifikate für das Edge Gateway und für den Aufzeichnungsdienst in MANUAL_REP/certificates ab.

Starten Sie zuletzt einen neuen Container:

docker run -d --restart unless-stopped --name "MANUAL_NAME" \
-e ENV_GW_CERT_NAME="ENV_GW_CERT_NAME_VALUE" \
-e ENV_GW_CERT_PASSWORD="ENV_GW_CERT_PASSWORD_VALUE" \
-e ENV_CARE_CERT_NAME="ENV_CARE_CERT_NAME_VALUE" \
-e ENV_CARE_CERT_PASSWORD="ENV_CARE_CERT_PASSWORD_VALUE" \
-e ENV_SSL_ROUTER_IP="ENV_SSL_ROUTER_IP_VALUE" \
-e ENV_SSL_ROUTER_PORT="ENV_SSL_ROUTER_PORT_VALUE" \
-e ENV_KERBEROS_CONFIG_ENABLE="ENV_KERBEROS_CONFIG_ENABLE_MANUAL_VALUE" \
-e ENV_KERBEROS_DEFAULT_REALM="ENV_KERBEROS_DEFAULT_REALM_MANUAL_VALUE" \
-e ENV_KERBEROS_DEFAULT_DOMAIN="ENV_KERBEROS_DEFAULT_DOMAIN_MANUAL_VALUE" \
-e ENV_KERBEROS_CONTROLLER_ADDRESS="ENV_KERBEROS_CONTROLLER_ADDRESS_MANUAL_VALUE" \
-v "MANUAL_REP/config/:/etc/ipdiva/:rw" \
-v "MANUAL_REP/graphical_archives/:/var/lib/ipdiva/carerecord/archives/:rw" \
-v "MANUAL_REP/ssh_archives/:/var/ipdiva/care/sshrecord/:rw" \
-v "MANUAL_REP/log/:/var/log/:rw" \
-v "MANUAL_REP/certificates/:/opt/certificates/:ro" \
-p 2222:2222 \
-p 3389:3389 \
-p 8443:8443 \
cleanroom-gateway:4.6.1-33-v4

Die Protokolle des Containers lassen sich mit dem folgenden Befehl einsehen:

docker logs -f MANUAL_NAME