Installasjon av Edge Gateway Docker

Import av Docker-imaget

Før du kan opprette en Edge Gateway Docker-container, må du importere Docker-imaget. Start til dette formålet et shell der Docker-kommandoene er tilgjengelige for deg, sammen med filen cleanroom-gateway-4.6.1-33-v4.tgz. Kjør følgende kommando fra shellet, og tilpass banen til filen TGZ hvis den ikke ligger i den gjeldende katalogen:

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

Kontroller deretter at importen var vellykket med følgende kommando:

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

Forventet utdata er som følger (SHA256-ID-en kan variere avhengig av operativsystemet Docker er installert på; eksemplene er fra Debian 13). Hvis dette ikke er tilfellet, har importen mislyktes:

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

Fullstendig utdata

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

Konfigurasjon av containeren

Miljøvariabler

Variabler for utrulling med pairing

Navn	Obligatorisk	Standardverdi	Kommentar
ENV_MEDIATION	JA		Brukes for tilkobling med pairing. DNS-navn eller IP-adresse for tilkobling til webgrensesnittet til en CyberElements Bastion-plattform.
ENV_TOKEN	JA		Brukes for tilkobling med pairing. Angir pairing-tokenet som skal brukes for tilkobling til Mediation Controller.
ENV_NO_CHECK_CERT	NEI	false	Brukes for tilkoblinger med pairing. Deaktiverer kontrollen av web-sertifikatet til Mediation Controller eller ikke; nyttig med CyberElements Bastion når tilgangen skjer via IP-adresse, eller når web-sertifikatet ikke er et sertifikat som er anerkjent av de offentlige standardsertifiseringsinstansene. Godtatte verdier: true eller false.

Variabler for manuell utrulling

Navn	Obligatorisk	Standardverdi	Kommentar
ENV_GW_CERT_NAME	JA		Brukes for tilkobling med manuell konfigurasjon. Navnet på sertifikatfilen for tilkobling til SSL Router.
ENV_GW_CERT_PASSWORD	JA		Brukes for tilkobling med manuell konfigurasjon. Passordet til sertifikatfilen for tilkobling til SSL Router.
ENV_CARE_CERT_NAME	NEI	Verdien til ENV_GW_CERT_NAME	Brukes for tilkobling med manuell konfigurasjon. Navnet på sertifikatfilen for opptakstjenesten.
ENV_CARE_CERT_PASSWORD	NEI	Verdien til ENV_GW_CERT_PASSWORD	Brukes for tilkobling med manuell konfigurasjon. Passordet til sertifikatfilen for opptakstjenesten.
ENV_SSL_ROUTER_IP	JA		Brukes for tilkobling med manuell konfigurasjon. IP-adresse eller DNS-navn til SSL Router som Edge Gateway skal koble seg til.
ENV_SSL_ROUTER_PORT	NEI	443	Brukes for tilkobling med manuell konfigurasjon. Porten på SSL Router som Edge Gateway skal koble seg til.

Diverse variabler

Navn	Obligatorisk	Standardverdi	Kommentar
ENV_DISABLE_RSYSLOG	NEI	false	Deaktivering av tjenesten rsyslog. Godtatte verdier: true eller false.
ENV_KERBEROS_CONFIG_ENABLE	NEI	false	Aktiverer Kerberos-innstillingene slik at RDP-applikasjoner kan autentisere seg i modus uten agent ved hjelp av Kerberos. Godtatte verdier: true eller false. Hvis false, ignoreres de øvrige Kerberos-variablene.
ENV_KERBEROS_DEFAULT_REALM	JA (hvis Kerberos-konfigurasjonen er aktivert)		Navnet på Kerberos-realmet.
ENV_KERBEROS_DEFAULT_DOMAIN	JA (hvis Kerberos-konfigurasjonen er aktivert)		Navnet på Kerberos-domenet.
ENV_KERBEROS_CONTROLLER_ADDRESS	JA (hvis Kerberos-konfigurasjonen er aktivert)		Tilkoblingsadresse til Kerberos-kontrolleren.

Volumer

Volum	Kommentar
/etc/ipdiva/	Konfigurasjonsvolum for Edge Gateway. Vi anbefaler å montere det på et navngitt volum eller i filsystemet til vertsmaskinen.
/opt/certificates/	Volum som inneholder sertifikatet eller sertifikatene til Edge Gateway i en konfigurasjon uten pairing.
/var/lib/ipdiva/carerecord/archives/	Volum som inneholder de grafiske arkivene. Vi anbefaler å montere det på et navngitt volum eller i filsystemet til vertsmaskinen.
/var/ipdiva/care/sshrecord/	Volum som inneholder SSH-arkivene. Vi anbefaler å montere det på et navngitt volum eller i filsystemet til vertsmaskinen.
/var/log/	Volum som inneholder loggene til Edge Gateway.

Porter

Port	Kommentar
2222 (eller en annen ledig port valgt av administratoren)	Lytteport for tjenesten for direkte SSH-/SFTP-tilgang.
3389	Lytteport for tjenesten for direkte RDP-tilgang.
8443	Lytteport for opptakstjenesten, som må eksponeres når Windows-opptaksagenten brukes.

Utrulling av Edge Gateway Docker

Utrulling med pairing

Forutsetninger

Før du ruller ut Edge Gateway Docker, må du skaffe et pairing-token.

Utrullingen som beskrives nedenfor, bruker alle tilgjengelige volumer (bortsett fra /opt/certificates/, som ikke er til nytte i denne sammenhengen) og eksponerer alle porter.
Volumene monteres i filsystemet til vertsmaskinen på plasseringen EDGE_GATEWAY_REP. Inne i denne plasseringen finnes følgende underkataloger:

• config
• graphical_archives
• ssh_archives
• log

Du kan tilpasse variablene for følgende kommandoer:

Tilpasset verdi	Variabel	Kommentar
	DOCKER_NAME	Navnet på Docker-containeren.
	EDGE_GATEWAY_REP	Plassering i filsystemet der volumene skal monteres.
	ENV_MEDIATION_VALUE	Verdien til miljøvariabelen ENV_MEDIATION.
	ENV_TOKEN_VALUE	Verdien til miljøvariabelen ENV_TOKEN.
	ENV_NO_CHECK_CERT_VALUE	Verdien til miljøvariabelen ENV_NO_CHECK_CERT.
	ENV_KERBEROS_CONFIG_ENABLE_VALUE	Verdien til miljøvariabelen ENV_KERBEROS_CONFIG_ENABLE.
	ENV_KERBEROS_DEFAULT_REALM_VALUE	Verdien til miljøvariabelen ENV_KERBEROS_DEFAULT_REALM.
	ENV_KERBEROS_DEFAULT_DOMAIN_VALUE	Verdien til miljøvariabelen ENV_KERBEROS_DEFAULT_DOMAIN.
	ENV_KERBEROS_CONTROLLER_ADDRESS_VALUE	Verdien til miljøvariabelen ENV_KERBEROS_CONTROLLER_ADDRESS.

Opprett katalogstrukturen som kreves for å montere volumene i filsystemet:

BashPowerShell

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

New-Item -ItemType Directory -Force -Path "EDGE_GATEWAY_REP\config", "EDGE_GATEWAY_REP\graphical_archives", "EDGE_GATEWAY_REP\ssh_archives", "EDGE_GATEWAY_REP\log"

Og til slutt starter du en ny container:

BashPowerShell

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

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

Loggene til containeren kan vises med følgende kommando:

docker logs -f DOCKER_NAME

Manuell utrulling

Forutsetninger

Før du ruller ut Edge Gateway Docker, må du ha de nødvendige sertifikatene for Edge Gateway og for opptakstjenesten.

Passord er synlige med docker inspect

Miljøvariablene i en container, inkludert sertifikatpassordene, kan fortsatt leses av alle som har lov til å kjøre docker inspect på Docker-serveren. Derfor bør utrulling med pairing, som ikke bruker noe sertifikatpassord, foretrekkes.

Utrullingen som beskrives nedenfor, bruker alle tilgjengelige volumer og eksponerer alle porter.
Volumene monteres i filsystemet til vertsmaskinen på plasseringen MANUAL_REP. Inne i denne plasseringen finnes følgende underkataloger:

• config
• graphical_archives
• ssh_archives
• log
• certificates

Du kan tilpasse variablene for følgende kommandoer:

Tilpasset verdi	Variabel	Kommentar
	MANUAL_NAME	Navnet på Docker-containeren.
	MANUAL_REP	Plassering i filsystemet der volumene skal monteres.
	ENV_GW_CERT_NAME_VALUE	Verdien til miljøvariabelen ENV_GW_CERT_NAME.
	ENV_CARE_CERT_NAME_VALUE	Verdien til miljøvariabelen ENV_CARE_CERT_NAME.
	ENV_SSL_ROUTER_IP_VALUE	Verdien til miljøvariabelen ENV_SSL_ROUTER_IP.
	ENV_SSL_ROUTER_PORT_VALUE	Verdien til miljøvariabelen ENV_SSL_ROUTER_PORT.
	ENV_KERBEROS_CONFIG_ENABLE_MANUAL_VALUE	Verdien til miljøvariabelen ENV_KERBEROS_CONFIG_ENABLE.
	ENV_KERBEROS_DEFAULT_REALM_MANUAL_VALUE	Verdien til miljøvariabelen ENV_KERBEROS_DEFAULT_REALM.
	ENV_KERBEROS_DEFAULT_DOMAIN_MANUAL_VALUE	Verdien til miljøvariabelen ENV_KERBEROS_DEFAULT_DOMAIN.
	ENV_KERBEROS_CONTROLLER_ADDRESS_MANUAL_VALUE	Verdien til miljøvariabelen ENV_KERBEROS_CONTROLLER_ADDRESS.

Opprett katalogstrukturen som kreves for å montere volumene i filsystemet:

BashPowerShell

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

New-Item -ItemType Directory -Force -Path "MANUAL_REP\config", "MANUAL_REP\graphical_archives", "MANUAL_REP\ssh_archives", "MANUAL_REP\log", "MANUAL_REP\certificates"

Legg deretter sertifikatene for Edge Gateway og for opptakstjenesten i MANUAL_REP/certificates.

Skriv inn sertifikatpassordene i miljøvariabler i den gjeldende økten, slik at de ikke blir liggende i shell-historikken (det du skriver inn, vises ikke):

BashPowerShell

read -rsp "Edge Gateway certificate password: " ENV_GW_CERT_PASSWORD; echo
read -rsp "Recording service certificate password: " ENV_CARE_CERT_PASSWORD; echo
export ENV_GW_CERT_PASSWORD ENV_CARE_CERT_PASSWORD

$env:ENV_GW_CERT_PASSWORD = [Net.NetworkCredential]::new('', (Read-Host -AsSecureString "Edge Gateway certificate password")).Password
$env:ENV_CARE_CERT_PASSWORD = [Net.NetworkCredential]::new('', (Read-Host -AsSecureString "Recording service certificate password")).Password

Start til slutt en ny container:

BashPowerShell

docker run -d --restart unless-stopped --name "MANUAL_NAME" \
-e ENV_GW_CERT_NAME="ENV_GW_CERT_NAME_VALUE" \
-e ENV_GW_CERT_PASSWORD \
-e ENV_CARE_CERT_NAME="ENV_CARE_CERT_NAME_VALUE" \
-e ENV_CARE_CERT_PASSWORD \
-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

docker run -d --restart unless-stopped --name "MANUAL_NAME" `
-e "ENV_GW_CERT_NAME=ENV_GW_CERT_NAME_VALUE" `
-e ENV_GW_CERT_PASSWORD `
-e "ENV_CARE_CERT_NAME=ENV_CARE_CERT_NAME_VALUE" `
-e ENV_CARE_CERT_PASSWORD `
-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

Fjern disse variablene fra økten når containeren har startet:

BashPowerShell

unset ENV_GW_CERT_PASSWORD ENV_CARE_CERT_PASSWORD

Remove-Item Env:ENV_GW_CERT_PASSWORD, Env:ENV_CARE_CERT_PASSWORD

Loggene til containeren kan vises med følgende kommando:

docker logs -f MANUAL_NAME