Installation av Edge Gateway Docker

Importera Docker-avbilden

Innan du kan skapa en container Edge Gateway Docker måste du importera Docker-avbilden. Öppna för detta en shell där Docker-kommandona samt filen cleanroom-gateway-4.6.1-33-v4.tgz är tillgängliga för dig. Kör följande kommando från shellen och anpassa sökvägen till filen TGZ om den inte finns i den aktuella katalogen:

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

Kontrollera därefter med följande kommando att importen lyckades:

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

Den förväntade utskriften är följande (SHA256-identifieraren kan variera beroende på det operativsystem som Docker är installerat på; exemplen kommer från Debian 13). Om så inte är fallet har importen misslyckats:

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

Fullständig utskrift

[
    {
        "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 av containern

Miljövariabler

Variabler för utrullning genom pairing

Namn	Obligatorisk	Standardvärde	Kommentar
ENV_MEDIATION	JA		Används för anslutning genom pairing. DNS-namn eller IP-adress för anslutning till webbgränssnittet för en CyberElements Bastion-plattform.
ENV_TOKEN	JA		Används för anslutning genom pairing. Anger den pairing-token som ska användas för anslutningen till Mediation Controller.
ENV_NO_CHECK_CERT	NEJ	false	Används för anslutningar genom pairing. Inaktiverar kontrollen av webbcertifikatet för Mediation Controller eller inte; användbart med CyberElements Bastion när åtkomsten sker via IP-adress eller när webbcertifikatet inte är ett certifikat som erkänns av de offentliga standardcertifikatutfärdarna. Godtagna värden: true eller false.

Variabler för manuell utrullning

Namn	Obligatorisk	Standardvärde	Kommentar
ENV_GW_CERT_NAME	JA		Används för anslutning med manuell konfiguration. Namn på certifikatfilen för anslutningen till SSL Router.
ENV_GW_CERT_PASSWORD	JA		Används för anslutning med manuell konfiguration. Lösenord för certifikatfilen för anslutningen till SSL Router.
ENV_CARE_CERT_NAME	NEJ	Värdet för ENV_GW_CERT_NAME	Används för anslutning med manuell konfiguration. Namn på inspelningstjänstens certifikatfil.
ENV_CARE_CERT_PASSWORD	NEJ	Värdet för ENV_GW_CERT_PASSWORD	Används för anslutning med manuell konfiguration. Lösenord för inspelningstjänstens certifikatfil.
ENV_SSL_ROUTER_IP	JA		Används för anslutning med manuell konfiguration. IP-adress eller DNS-namn för den SSL Router som Edge Gateway ansluter till.
ENV_SSL_ROUTER_PORT	NEJ	443	Används för anslutning med manuell konfiguration. Port på SSL Router som Edge Gateway ansluter till.

Övriga variabler

Namn	Obligatorisk	Standardvärde	Kommentar
ENV_DISABLE_RSYSLOG	NEJ	false	Inaktivering av tjänsten rsyslog. Tillåtna värden: true eller false.
ENV_KERBEROS_CONFIG_ENABLE	NEJ	false	Aktiverar Kerberos-inställningarna så att RDP-applikationer kan autentisera sig i läget utan agent via Kerberos. Tillåtna värden: true eller false. Vid false ignoreras de övriga Kerberos-variablerna.
ENV_KERBEROS_DEFAULT_REALM	JA (om Kerberos-konfigurationen är aktiverad)		Namn på Kerberos-realm.
ENV_KERBEROS_DEFAULT_DOMAIN	JA (om Kerberos-konfigurationen är aktiverad)		Namn på Kerberos-domänen.
ENV_KERBEROS_CONTROLLER_ADDRESS	JA (om Kerberos-konfigurationen är aktiverad)		Anslutningsadress till Kerberos-controllern.

Volymer

Volym	Kommentar
/etc/ipdiva/	Konfigurationsvolym för Edge Gateway. Vi rekommenderar att den monteras på en namngiven volym eller på värdmaskinens filsystem.
/opt/certificates/	Volym som innehåller Edge Gateway-certifikatet eller -certifikaten i en konfiguration utan pairing.
/var/lib/ipdiva/carerecord/archives/	Volym som innehåller de grafiska arkiven. Vi rekommenderar att den monteras på en namngiven volym eller på värdmaskinens filsystem.
/var/ipdiva/care/sshrecord/	Volym som innehåller SSH-arkiven. Vi rekommenderar att den monteras på en namngiven volym eller på värdmaskinens filsystem.
/var/log/	Volym som innehåller loggarna för Edge Gateway.

Portar

Port	Kommentar
2222 (eller vilken annan tillgänglig port som administratören väljer)	Lyssnande port för tjänsten för direkt SSH/SFTP-åtkomst.
3389	Lyssnande port för tjänsten för direkt RDP-åtkomst.
8443	Lyssnande port för inspelningstjänsten, som ska exponeras när Windows-inspelningsagenten används.

Utrullning av Edge Gateway Docker

Utrullning med pairing

Förutsättningar

Innan du rullar ut Edge Gateway Docker måste du skaffa en pairing-token.

Den utrullning som beskrivs nedan använder alla tillgängliga volymer (utom /opt/certificates/, som inte är till någon nytta i detta sammanhang) och exponerar alla portar.
Volymerna monteras på värdmaskinens filsystem på platsen EDGE_GATEWAY_REP. Inuti denna plats finns följande underkataloger:

• config
• graphical_archives
• ssh_archives
• log

Du kan anpassa variablerna i följande kommandon:

Anpassat värde	Variabel	Kommentar
	DOCKER_NAME	Namn på Docker-containern.
	EDGE_GATEWAY_REP	Plats i filsystemet där volymerna ska monteras.
	ENV_MEDIATION_VALUE	Värdet för miljövariabeln ENV_MEDIATION.
	ENV_TOKEN_VALUE	Värdet för miljövariabeln ENV_TOKEN.
	ENV_NO_CHECK_CERT_VALUE	Värdet för miljövariabeln ENV_NO_CHECK_CERT.
	ENV_KERBEROS_CONFIG_ENABLE_VALUE	Värdet för miljövariabeln ENV_KERBEROS_CONFIG_ENABLE.
	ENV_KERBEROS_DEFAULT_REALM_VALUE	Värdet för miljövariabeln ENV_KERBEROS_DEFAULT_REALM.
	ENV_KERBEROS_DEFAULT_DOMAIN_VALUE	Värdet för miljövariabeln ENV_KERBEROS_DEFAULT_DOMAIN.
	ENV_KERBEROS_CONTROLLER_ADDRESS_VALUE	Värdet för miljövariabeln ENV_KERBEROS_CONTROLLER_ADDRESS.

Skapa den katalogstruktur i filsystemet som krävs för att montera volymerna:

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

Och starta slutligen en ny 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

Containerns loggar kan visas med följande kommando:

docker logs -f DOCKER_NAME

Manuell utrullning

Förutsättningar

Innan du rullar ut Edge Gateway Docker måste du ha de certifikat som krävs för Edge Gateway och för inspelningstjänsten.

Den utrullning som beskrivs nedan använder alla tillgängliga volymer och exponerar alla portar.
Volymerna monteras på värdmaskinens filsystem på platsen MANUAL_REP. Inuti denna plats finns följande underkataloger:

• config
• graphical_archives
• ssh_archives
• log
• certificates

Du kan anpassa variablerna i följande kommandon:

Anpassat värde	Variabel	Kommentar
	MANUAL_NAME	Namn på Docker-containern.
	MANUAL_REP	Plats i filsystemet där volymerna ska monteras.
	ENV_GW_CERT_NAME_VALUE	Värdet för miljövariabeln ENV_GW_CERT_NAME.
	ENV_GW_CERT_PASSWORD_VALUE	Värdet för miljövariabeln ENV_GW_CERT_PASSWORD.
	ENV_CARE_CERT_NAME_VALUE	Värdet för miljövariabeln ENV_CARE_CERT_NAME.
	ENV_CARE_CERT_PASSWORD_VALUE	Värdet för miljövariabeln ENV_CARE_CERT_PASSWORD.
	ENV_SSL_ROUTER_IP_VALUE	Värdet för miljövariabeln ENV_SSL_ROUTER_IP.
	ENV_SSL_ROUTER_PORT_VALUE	Värdet för miljövariabeln ENV_SSL_ROUTER_PORT.
	ENV_KERBEROS_CONFIG_ENABLE_MANUAL_VALUE	Värdet för miljövariabeln ENV_KERBEROS_CONFIG_ENABLE.
	ENV_KERBEROS_DEFAULT_REALM_MANUAL_VALUE	Värdet för miljövariabeln ENV_KERBEROS_DEFAULT_REALM.
	ENV_KERBEROS_DEFAULT_DOMAIN_MANUAL_VALUE	Värdet för miljövariabeln ENV_KERBEROS_DEFAULT_DOMAIN.
	ENV_KERBEROS_CONTROLLER_ADDRESS_MANUAL_VALUE	Värdet för miljövariabeln ENV_KERBEROS_CONTROLLER_ADDRESS.

Skapa den katalogstruktur i filsystemet som krävs för att montera volymerna:

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

Placera därefter certifikaten för Edge Gateway och för inspelningstjänsten i MANUAL_REP/certificates.

Starta slutligen en ny 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

Containerns loggar kan visas med följande kommando:

docker logs -f MANUAL_NAME