Inštalácia komponentu Edge Gateway Docker

Import obrazu Docker

Pred vytvorením kontajnera Docker Edge Gateway musíte importovať obraz Docker. Na tento účel spustite prostredie shell, v ktorom máte k dispozícii príkazy Docker, ako aj súbor cleanroom-gateway-4.6.1-33-v4.tgz. V prostredí shell spustite nasledujúci príkaz a ak sa súbor TGZ nenachádza v aktuálnom adresári, upravte cestu k nemu:

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

Potom pomocou nasledujúceho príkazu overte, či bol import úspešný:

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

Očakávaný výstup je nasledujúci (ID SHA256 sa môže líšiť v závislosti od operačného systému, v ktorom je Docker nainštalovaný; príklady pochádzajú zo systému Debian 13). Ak to tak nie je, import zlyhal:

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

Úplný výstup

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

Konfigurácia kontajnera

Premenné prostredia

Premenné pre nasadenie pomocou pairingu

Názov	Povinné	Predvolená hodnota	Komentár
ENV_MEDIATION	ÁNO		Používa sa na pripojenie pomocou pairingu. Označenie tenanta CyberElements.
ENV_TOKEN	ÁNO		Používa sa na pripojenie pomocou pairingu. Označenie tokenu pairingu, ktorý sa má použiť na pripojenie k službe Mediation Controller.
ENV_NO_CHECK_CERT	NIE	false	Používa sa na pripojenia pomocou pairingu. Určuje, či sa má zakázať kontrola webového certifikátu služby Mediation Controller; užitočné pri prístupe cez IP adresu alebo keď webový certifikát nie je certifikátom uznávaným predvolenými verejnými certifikačnými autoritami. Akceptované hodnoty: true alebo false.

Premenné pre manuálne nasadenie

Názov	Povinné	Predvolená hodnota	Komentár
ENV_GW_CERT_NAME	ÁNO		Používa sa na pripojenie s manuálnou konfiguráciou. Názov súboru certifikátu na pripojenie k serveru SSL Router.
ENV_GW_CERT_PASSWORD	ÁNO		Používa sa na pripojenie s manuálnou konfiguráciou. Heslo súboru certifikátu na pripojenie k serveru SSL Router.
ENV_CARE_CERT_NAME	NIE	Hodnota ENV_GW_CERT_NAME	Používa sa na pripojenie s manuálnou konfiguráciou. Názov súboru certifikátu služby nahrávania.
ENV_CARE_CERT_PASSWORD	NIE	Hodnota ENV_GW_CERT_PASSWORD	Používa sa na pripojenie s manuálnou konfiguráciou. Heslo súboru certifikátu služby nahrávania.
ENV_SSL_ROUTER_IP	ÁNO		Používa sa na pripojenie s manuálnou konfiguráciou. IP adresa alebo názov DNS servera SSL Router, ku ktorému sa komponent Edge Gateway pripojí.
ENV_SSL_ROUTER_PORT	NIE	443	Používa sa na pripojenie s manuálnou konfiguráciou. Port servera SSL Router, ku ktorému sa komponent Edge Gateway pripojí.

Rôzne premenné

Názov	Povinné	Predvolená hodnota	Komentár
ENV_DISABLE_RSYSLOG	NIE	false	Deaktivácia služby rsyslog. Akceptované hodnoty: true alebo false.
ENV_KERBEROS_CONFIG_ENABLE	NIE	false	Povolí nastavenia protokolu Kerberos, aby sa aplikácie RDP mohli overovať v režime bez agenta pomocou protokolu Kerberos. Akceptované hodnoty: true alebo false. Ak je hodnota false, ostatné premenné Kerberos sa ignorujú.
ENV_KERBEROS_DEFAULT_REALM	ÁNO (ak je konfigurácia Kerberos povolená)		Názov sféry Kerberos.
ENV_KERBEROS_DEFAULT_DOMAIN	ÁNO (ak je konfigurácia Kerberos povolená)		Názov domény Kerberos.
ENV_KERBEROS_CONTROLLER_ADDRESS	ÁNO (ak je konfigurácia Kerberos povolená)		Adresa na pripojenie k radiču Kerberos.

Zväzky

Zväzok	Komentár
/etc/ipdiva/	Konfiguračný zväzok komponentu Edge Gateway. Odporúčame ho pripojiť k pomenovanému zväzku alebo do systému súborov hostiteľského počítača.
/opt/certificates/	Zväzok obsahujúci certifikát(y) komponentu Edge Gateway v konfigurácii bez pairingu.
/var/lib/ipdiva/carerecord/archives/	Zväzok obsahujúci grafické archívy. Odporúčame ho pripojiť k pomenovanému zväzku alebo do systému súborov hostiteľského počítača.
/var/ipdiva/care/sshrecord/	Zväzok obsahujúci archívy SSH. Odporúčame ho pripojiť k pomenovanému zväzku alebo do systému súborov hostiteľského počítača.
/var/log/	Zväzok obsahujúci logy komponentu Edge Gateway.

Porty

Port	Komentár
2222 (alebo akýkoľvek iný dostupný port zvolený správcom)	Port, na ktorom načúva služba priameho prístupu SSH/SFTP.
3389	Port, na ktorom načúva služba priameho prístupu RDP.
8443	Port, na ktorom načúva služba nahrávania; treba ho sprístupniť pri používaní agenta nahrávania pre Windows.

Nasadenie komponentu Edge Gateway Docker

Nasadenie pomocou pairingu

Predpoklady

Pred nasadením komponentu Edge Gateway Docker musíte získať token pairingu.

Nižšie opísané nasadenie použije všetky dostupné zväzky (okrem /opt/certificates/, ktorý v tomto kontexte nie je užitočný) a sprístupní všetky porty.
Zväzky sa pripoja do systému súborov hostiteľského počítača v umiestnení EDGE_GATEWAY_REP. V tomto umiestnení sa nachádzajú nasledujúce podadresáre:

• config
• graphical_archives
• ssh_archives
• log

Premenné pre nasledujúce príkazy môžete prispôsobiť:

Vlastná hodnota	Premenná	Komentár
	DOCKER_NAME	Názov kontajnera Docker.
	EDGE_GATEWAY_REP	Umiestnenie v systéme súborov, kam sa pripoja zväzky.
	ENV_MEDIATION_VALUE	Hodnota premennej prostredia ENV_MEDIATION.
	ENV_TOKEN_VALUE	Hodnota premennej prostredia ENV_TOKEN.
	ENV_NO_CHECK_CERT_VALUE	Hodnota premennej prostredia ENV_NO_CHECK_CERT.
	ENV_KERBEROS_CONFIG_ENABLE_VALUE	Hodnota premennej prostredia ENV_KERBEROS_CONFIG_ENABLE.
	ENV_KERBEROS_DEFAULT_REALM_VALUE	Hodnota premennej prostredia ENV_KERBEROS_DEFAULT_REALM.
	ENV_KERBEROS_DEFAULT_DOMAIN_VALUE	Hodnota premennej prostredia ENV_KERBEROS_DEFAULT_DOMAIN.
	ENV_KERBEROS_CONTROLLER_ADDRESS_VALUE	Hodnota premennej prostredia ENV_KERBEROS_CONTROLLER_ADDRESS.

Vytvorte stromovú štruktúru adresárov potrebnú na pripojenie zväzkov v systéme súborov:

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"

A nakoniec spustite nový kontajner:

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

Logy kontajnera môžete zobraziť pomocou nasledujúceho príkazu:

docker logs -f DOCKER_NAME

Manuálne nasadenie

Predpoklady

Pred nasadením komponentu Edge Gateway Docker musíte mať k dispozícii požadované certifikáty pre Edge Gateway a pre službu nahrávania.

Heslá viditeľné pomocou docker inspect

Premenné prostredia kontajnera vrátane hesiel certifikátov zostávajú čitateľné pre každého, kto smie spúšťať docker inspect na serveri Docker. Preto uprednostnite nasadenie s pairingom, ktoré nepoužíva žiadne heslo certifikátu.

Nasadenie opísané nižšie použije všetky dostupné zväzky a sprístupní všetky porty.
Zväzky sa pripoja do systému súborov hostiteľského počítača v umiestnení MANUAL_REP. V tomto umiestnení sa nachádzajú tieto podadresáre:

• config
• graphical_archives
• ssh_archives
• log
• certificates

Premenné pre nasledujúce príkazy môžete prispôsobiť:

Vlastná hodnota	Premenná	Komentár
	MANUAL_NAME	Názov kontajnera Docker.
	MANUAL_REP	Umiestnenie v systéme súborov, kam sa pripoja zväzky.
	ENV_GW_CERT_NAME_VALUE	Hodnota premennej prostredia ENV_GW_CERT_NAME.
	ENV_CARE_CERT_NAME_VALUE	Hodnota premennej prostredia ENV_CARE_CERT_NAME.
	ENV_SSL_ROUTER_IP_VALUE	Hodnota premennej prostredia ENV_SSL_ROUTER_IP.
	ENV_SSL_ROUTER_PORT_VALUE	Hodnota premennej prostredia ENV_SSL_ROUTER_PORT.
	ENV_KERBEROS_CONFIG_ENABLE_MANUAL_VALUE	Hodnota premennej prostredia ENV_KERBEROS_CONFIG_ENABLE.
	ENV_KERBEROS_DEFAULT_REALM_MANUAL_VALUE	Hodnota premennej prostredia ENV_KERBEROS_DEFAULT_REALM.
	ENV_KERBEROS_DEFAULT_DOMAIN_MANUAL_VALUE	Hodnota premennej prostredia ENV_KERBEROS_DEFAULT_DOMAIN.
	ENV_KERBEROS_CONTROLLER_ADDRESS_MANUAL_VALUE	Hodnota premennej prostredia ENV_KERBEROS_CONTROLLER_ADDRESS.

Vytvorte stromovú štruktúru adresárov potrebnú na pripojenie zväzkov v systéme súborov:

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"

Potom umiestnite certifikáty pre Edge Gateway a pre službu nahrávania do MANUAL_REP/certificates.

Aby sa heslá certifikátov neuchovávali v histórii shellu, zadajte ich do premenných prostredia aktuálnej relácie (zadávaný text sa nezobrazuje):

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

Nakoniec spustite nový kontajner:

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

Po spustení kontajnera odoberte tieto premenné z relácie:

BashPowerShell

unset ENV_GW_CERT_PASSWORD ENV_CARE_CERT_PASSWORD

Remove-Item Env:ENV_GW_CERT_PASSWORD, Env:ENV_CARE_CERT_PASSWORD

Logy kontajnera môžete zobraziť pomocou nasledujúceho príkazu:

docker logs -f MANUAL_NAME