Installatie van de Edge Gateway Docker

Het Docker-image importeren

Voordat u een Edge Gateway Docker-container kunt aanmaken, moet u het Docker-image importeren. Open daarvoor een shell waarin de Docker-opdrachten en het bestand cleanroom-gateway-4.6.1-33-v4.tgz voor u beschikbaar zijn. Voer vanuit de shell de volgende opdracht uit en pas het pad naar het TGZ-bestand aan als het zich niet in de huidige map bevindt:

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

Controleer daarna met de volgende opdracht of de import is gelukt:

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

De verwachte uitvoer is de volgende (de SHA256-id kan verschillen naargelang het besturingssysteem waarop Docker is geïnstalleerd; de voorbeelden komen van Debian 13). Als dit niet het geval is, is de import mislukt:

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

Volledige uitvoer

[
    {
        "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"
        }
    }
]

Configuratie van de container

Omgevingsvariabelen

Variabelen voor de implementatie via pairing

Naam	Verplicht	Standaardwaarde	Opmerking
ENV_MEDIATION	JA		Wordt gebruikt voor de verbinding via pairing. Geeft de CyberElements-tenant aan.
ENV_TOKEN	JA		Wordt gebruikt voor de verbinding via pairing. Geeft het pairing-token aan dat voor de verbinding met de Mediation Controller moet worden gebruikt.
ENV_NO_CHECK_CERT	NEE	false	Wordt gebruikt voor de verbindingen via pairing. Schakelt de controle van het webcertificaat van de Mediation Controller al dan niet uit; nuttig bij toegang via een IP-adres of wanneer het webcertificaat niet wordt erkend door de standaard openbare certificeringsinstanties. Toegestane waarden: true of false.

Variabelen voor de handmatige implementatie

Naam	Verplicht	Standaardwaarde	Opmerking
ENV_GW_CERT_NAME	JA		Wordt gebruikt voor de verbinding met handmatige configuratie. Naam van het certificaatbestand voor de verbinding met de SSL Router.
ENV_GW_CERT_PASSWORD	JA		Wordt gebruikt voor de verbinding met handmatige configuratie. Wachtwoord van het certificaatbestand voor de verbinding met de SSL Router.
ENV_CARE_CERT_NAME	NEE	Waarde van ENV_GW_CERT_NAME	Wordt gebruikt voor de verbinding met handmatige configuratie. Naam van het certificaatbestand van de opnameservice.
ENV_CARE_CERT_PASSWORD	NEE	Waarde van ENV_GW_CERT_PASSWORD	Wordt gebruikt voor de verbinding met handmatige configuratie. Wachtwoord van het certificaatbestand van de opnameservice.
ENV_SSL_ROUTER_IP	JA		Wordt gebruikt voor de verbinding met handmatige configuratie. IP-adres of DNS-naam van de SSL Router waarmee de Edge Gateway verbinding maakt.
ENV_SSL_ROUTER_PORT	NEE	443	Wordt gebruikt voor de verbinding met handmatige configuratie. Poort van de SSL Router waarmee de Edge Gateway verbinding maakt.

Diverse variabelen

Naam	Verplicht	Standaardwaarde	Opmerking
ENV_DISABLE_RSYSLOG	NEE	false	Uitschakeling van de service rsyslog. Toegestane waarden: true of false.
ENV_KERBEROS_CONFIG_ENABLE	NEE	false	Schakelt de Kerberos-configuratie in zodat RDP-applicaties zich in de modus zonder agent via Kerberos kunnen authenticeren. Toegestane waarden: true of false. Bij false worden de overige Kerberos-variabelen genegeerd.
ENV_KERBEROS_DEFAULT_REALM	JA (als de Kerberos-configuratie is ingeschakeld)		Naam van het Kerberos-realm.
ENV_KERBEROS_DEFAULT_DOMAIN	JA (als de Kerberos-configuratie is ingeschakeld)		Naam van het Kerberos-domein.
ENV_KERBEROS_CONTROLLER_ADDRESS	JA (als de Kerberos-configuratie is ingeschakeld)		Verbindingsadres van de Kerberos-controller.

Volumes

Volume	Opmerking
/etc/ipdiva/	Configuratievolume van de Edge Gateway. Wij raden aan het te mounten op een benoemd volume of op het bestandssysteem van de hostmachine.
/opt/certificates/	Volume dat het certificaat of de certificaten van de Edge Gateway bevat in een configuratie zonder pairing.
/var/lib/ipdiva/carerecord/archives/	Volume dat de grafische archieven bevat. Wij raden aan het te mounten op een benoemd volume of op het bestandssysteem van de hostmachine.
/var/ipdiva/care/sshrecord/	Volume dat de SSH-archieven bevat. Wij raden aan het te mounten op een benoemd volume of op het bestandssysteem van de hostmachine.
/var/log/	Volume dat de logs van de Edge Gateway bevat.

Poorten

Poort	Opmerking
2222 (of elke andere beschikbare poort die de beheerder kiest)	Luisterpoort van de service voor directe SSH/SFTP-toegang.
3389	Luisterpoort van de service voor directe RDP-toegang.
8443	Luisterpoort van de opnameservice, die beschikbaar moet worden gemaakt wanneer de Windows-opname-agent wordt gebruikt.

Implementatie van de Edge Gateway Docker

Implementatie met pairing

Voorwaarden

Voordat u de Edge Gateway Docker implementeert, moet u een pairing-token verkrijgen.

De hieronder beschreven implementatie gebruikt alle beschikbare volumes (behalve /opt/certificates/, dat in deze context niet nuttig is) en stelt alle poorten beschikbaar.
De volumes worden gemount in het bestandssysteem van de hostmachine op de locatie EDGE_GATEWAY_REP. Binnen deze locatie bevinden zich de volgende submappen:

• config
• graphical_archives
• ssh_archives
• log

U kunt de variabelen van de volgende opdrachten aanpassen:

Aangepaste waarde	Variabele	Opmerking
	DOCKER_NAME	Naam van de Docker-container.
	EDGE_GATEWAY_REP	Locatie in het bestandssysteem waar de volumes worden gemount.
	ENV_MEDIATION_VALUE	Waarde van de omgevingsvariabele ENV_MEDIATION.
	ENV_TOKEN_VALUE	Waarde van de omgevingsvariabele ENV_TOKEN.
	ENV_NO_CHECK_CERT_VALUE	Waarde van de omgevingsvariabele ENV_NO_CHECK_CERT.
	ENV_KERBEROS_CONFIG_ENABLE_VALUE	Waarde van de omgevingsvariabele ENV_KERBEROS_CONFIG_ENABLE.
	ENV_KERBEROS_DEFAULT_REALM_VALUE	Waarde van de omgevingsvariabele ENV_KERBEROS_DEFAULT_REALM.
	ENV_KERBEROS_DEFAULT_DOMAIN_VALUE	Waarde van de omgevingsvariabele ENV_KERBEROS_DEFAULT_DOMAIN.
	ENV_KERBEROS_CONTROLLER_ADDRESS_VALUE	Waarde van de omgevingsvariabele ENV_KERBEROS_CONTROLLER_ADDRESS.

Maak de mappenstructuur aan die nodig is om de volumes in het bestandssysteem te mounten:

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

En start ten slotte een nieuwe 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

De logs van de container kunnen met de volgende opdracht worden bekeken:

docker logs -f DOCKER_NAME

Handmatige implementatie

Voorwaarden

Voordat u de Edge Gateway Docker implementeert, moet u over de vereiste certificaten voor de Edge Gateway en voor de opnameservice beschikken.

De hieronder beschreven implementatie gebruikt alle beschikbare volumes en stelt alle poorten beschikbaar.
De volumes worden gemount in het bestandssysteem van de hostmachine op de locatie MANUAL_REP. Binnen deze locatie bevinden zich de volgende submappen:

• config
• graphical_archives
• ssh_archives
• log
• certificates

U kunt de variabelen van de volgende opdrachten aanpassen:

Aangepaste waarde	Variabele	Opmerking
	MANUAL_NAME	Naam van de Docker-container.
	MANUAL_REP	Locatie in het bestandssysteem waar de volumes worden gemount.
	ENV_GW_CERT_NAME_VALUE	Waarde van de omgevingsvariabele ENV_GW_CERT_NAME.
	ENV_GW_CERT_PASSWORD_VALUE	Waarde van de omgevingsvariabele ENV_GW_CERT_PASSWORD.
	ENV_CARE_CERT_NAME_VALUE	Waarde van de omgevingsvariabele ENV_CARE_CERT_NAME.
	ENV_CARE_CERT_PASSWORD_VALUE	Waarde van de omgevingsvariabele ENV_CARE_CERT_PASSWORD.
	ENV_SSL_ROUTER_IP_VALUE	Waarde van de omgevingsvariabele ENV_SSL_ROUTER_IP.
	ENV_SSL_ROUTER_PORT_VALUE	Waarde van de omgevingsvariabele ENV_SSL_ROUTER_PORT.
	ENV_KERBEROS_CONFIG_ENABLE_MANUAL_VALUE	Waarde van de omgevingsvariabele ENV_KERBEROS_CONFIG_ENABLE.
	ENV_KERBEROS_DEFAULT_REALM_MANUAL_VALUE	Waarde van de omgevingsvariabele ENV_KERBEROS_DEFAULT_REALM.
	ENV_KERBEROS_DEFAULT_DOMAIN_MANUAL_VALUE	Waarde van de omgevingsvariabele ENV_KERBEROS_DEFAULT_DOMAIN.
	ENV_KERBEROS_CONTROLLER_ADDRESS_MANUAL_VALUE	Waarde van de omgevingsvariabele ENV_KERBEROS_CONTROLLER_ADDRESS.

Maak de mappenstructuur aan die nodig is om de volumes in het bestandssysteem te mounten:

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

Plaats daarna de certificaten voor de Edge Gateway en voor de opnameservice in MANUAL_REP/certificates.

Start ten slotte een nieuwe 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

De logs van de container kunnen met de volgende opdracht worden bekeken:

docker logs -f MANUAL_NAME