Edge Gateway Docker -asennus

Docker-levykuvan tuonti

Ennen kuin voit luoda Edge Gateway Docker -kontin, sinun on tuotava Docker-levykuva. Avaa tätä varten komentotulkki, jossa Docker-komennot sekä tiedosto cleanroom-gateway-4.6.1-33-v4.tgz ovat käytettävissäsi. Suorita komentotulkista seuraava komento ja muokkaa TGZ-tiedoston polkua, jos tiedosto ei ole nykyisessä hakemistossa:

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

Tarkista sen jälkeen seuraavalla komennolla, että tuonti onnistui:

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

Odotettu tuloste on seuraava (SHA256-tunniste voi vaihdella sen käyttöjärjestelmän mukaan, johon Docker on asennettu; esimerkit ovat Debian 13:sta). Jos näin ei ole, tuonti on epäonnistunut:

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

Täydellinen tuloste

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

Kontin määritys

Ympäristömuuttujat

Pairing-käyttöönoton muuttujat

Nimi	Pakollinen	Oletusarvo	Kommentti
ENV_MEDIATION	KYLLÄ		Käytetään pairing-yhteydessä. DNS-nimi tai IP-osoite yhteyden muodostamiseen CyberElements Bastion -alustan verkkoliittymään.
ENV_TOKEN	KYLLÄ		Käytetään pairing-yhteydessä. Ilmoittaa pairing-tokenin, jota käytetään yhteyden muodostamiseen Mediation Controller -palvelimeen.
ENV_NO_CHECK_CERT	EI	false	Käytetään pairing-yhteyksissä. Poistaa Mediation Controller -palvelimen verkkosertifikaatin tarkistuksen käytöstä tai ei; hyödyllinen CyberElements Bastion -tuotteessa, kun käyttö tapahtuu IP-osoitteen kautta tai kun verkkosertifikaatti ei ole julkisten oletusvarmentajien tunnustama sertifikaatti. Hyväksytyt arvot: true tai false.

Manuaalisen käyttöönoton muuttujat

Nimi	Pakollinen	Oletusarvo	Kommentti
ENV_GW_CERT_NAME	KYLLÄ		Käytetään yhteydessä, jonka määritys on tehty käsin. Sen sertifikaattitiedoston nimi, jolla muodostetaan yhteys SSL Router -palveluun.
ENV_GW_CERT_PASSWORD	KYLLÄ		Käytetään yhteydessä, jonka määritys on tehty käsin. SSL Router -palveluun yhdistämiseen käytettävän sertifikaattitiedoston salasana.
ENV_CARE_CERT_NAME	EI	Muuttujan ENV_GW_CERT_NAME arvo	Käytetään yhteydessä, jonka määritys on tehty käsin. Tallennuspalvelun sertifikaattitiedoston nimi.
ENV_CARE_CERT_PASSWORD	EI	Muuttujan ENV_GW_CERT_PASSWORD arvo	Käytetään yhteydessä, jonka määritys on tehty käsin. Tallennuspalvelun sertifikaattitiedoston salasana.
ENV_SSL_ROUTER_IP	KYLLÄ		Käytetään yhteydessä, jonka määritys on tehty käsin. Sen SSL Router -palvelun IP-osoite tai DNS-nimi, johon Edge Gateway muodostaa yhteyden.
ENV_SSL_ROUTER_PORT	EI	443	Käytetään yhteydessä, jonka määritys on tehty käsin. Sen SSL Router -palvelun portti, johon Edge Gateway muodostaa yhteyden.

Muut muuttujat

Nimi	Pakollinen	Oletusarvo	Kommentti
ENV_DISABLE_RSYSLOG	EI	false	Palvelun rsyslog poistaminen käytöstä. Hyväksytyt arvot: true tai false.
ENV_KERBEROS_CONFIG_ENABLE	EI	false	Ottaa Kerberos-määrityksen käyttöön, jotta RDP-sovellukset voivat tunnistautua ilman agenttia Kerberosin avulla. Hyväksytyt arvot: true tai false. Jos arvo on false, muut Kerberos-muuttujat ohitetaan.
ENV_KERBEROS_DEFAULT_REALM	KYLLÄ (jos Kerberos-määritys on käytössä)		Kerberos-realmin nimi.
ENV_KERBEROS_DEFAULT_DOMAIN	KYLLÄ (jos Kerberos-määritys on käytössä)		Kerberos-toimialueen nimi.
ENV_KERBEROS_CONTROLLER_ADDRESS	KYLLÄ (jos Kerberos-määritys on käytössä)		Kerberos-ohjaimen yhteysosoite.

Volumet

Volume	Kommentti
/etc/ipdiva/	Edge Gateway -palvelimen määritysvolume. Suosittelemme liittämään sen nimettyyn volumeen tai isäntäkoneen tiedostojärjestelmään.
/opt/certificates/	Volume, joka sisältää Edge Gateway -palvelimen sertifikaatin tai sertifikaatit määrityksessä, jossa ei käytetä pairingia.
/var/lib/ipdiva/carerecord/archives/	Volume, joka sisältää graafiset arkistot. Suosittelemme liittämään sen nimettyyn volumeen tai isäntäkoneen tiedostojärjestelmään.
/var/ipdiva/care/sshrecord/	Volume, joka sisältää SSH-arkistot. Suosittelemme liittämään sen nimettyyn volumeen tai isäntäkoneen tiedostojärjestelmään.
/var/log/	Volume, joka sisältää Edge Gateway -palvelimen lokit.

Portit

Portti	Kommentti
2222 (tai mikä tahansa muu järjestelmänvalvojan valitsema vapaa portti)	SSH/SFTP-suorapääsypalvelun kuunteluportti.
3389	RDP-suorapääsypalvelun kuunteluportti.
8443	Tallennuspalvelun kuunteluportti, joka on avattava Windows-tallennusagenttia käytettäessä.

Edge Gateway Docker -käyttöönotto

Käyttöönotto pairingin avulla

Edellytykset

Ennen Edge Gateway Docker -käyttöönottoa sinun on hankittava pairing-token.

Alla kuvattu käyttöönotto käyttää kaikkia käytettävissä olevia volumeja (paitsi /opt/certificates/, josta ei ole hyötyä tässä yhteydessä) ja avaa kaikki portit.
Volumet liitetään isäntäkoneen tiedostojärjestelmään sijaintiin EDGE_GATEWAY_REP. Tämän sijainnin sisällä ovat seuraavat alihakemistot:

• config
• graphical_archives
• ssh_archives
• log

Voit muokata seuraavien komentojen muuttujia:

Muokattu arvo	Muuttuja	Kommentti
	DOCKER_NAME	Docker-kontin nimi.
	EDGE_GATEWAY_REP	Tiedostojärjestelmän sijainti, johon volumet liitetään.
	ENV_MEDIATION_VALUE	Ympäristömuuttujan ENV_MEDIATION arvo.
	ENV_TOKEN_VALUE	Ympäristömuuttujan ENV_TOKEN arvo.
	ENV_NO_CHECK_CERT_VALUE	Ympäristömuuttujan ENV_NO_CHECK_CERT arvo.
	ENV_KERBEROS_CONFIG_ENABLE_VALUE	Ympäristömuuttujan ENV_KERBEROS_CONFIG_ENABLE arvo.
	ENV_KERBEROS_DEFAULT_REALM_VALUE	Ympäristömuuttujan ENV_KERBEROS_DEFAULT_REALM arvo.
	ENV_KERBEROS_DEFAULT_DOMAIN_VALUE	Ympäristömuuttujan ENV_KERBEROS_DEFAULT_DOMAIN arvo.
	ENV_KERBEROS_CONTROLLER_ADDRESS_VALUE	Ympäristömuuttujan ENV_KERBEROS_CONTROLLER_ADDRESS arvo.

Luo volumejen liittämiseen tarvittava hakemistorakenne tiedostojärjestelmään:

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

Käynnistä lopuksi uusi kontti:

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

Kontin lokeja voi tarkastella seuraavalla komennolla:

docker logs -f DOCKER_NAME

Manuaalinen käyttöönotto

Edellytykset

Ennen Edge Gateway Docker -käyttöönottoa sinulla on oltava tarvittavat sertifikaatit Edge Gateway -palvelimelle ja tallennuspalvelulle.

Alla kuvattu käyttöönotto käyttää kaikkia käytettävissä olevia volumeja ja avaa kaikki portit.
Volumet liitetään isäntäkoneen tiedostojärjestelmään sijaintiin MANUAL_REP. Tämän sijainnin sisällä ovat seuraavat alihakemistot:

• config
• graphical_archives
• ssh_archives
• log
• certificates

Voit muokata seuraavien komentojen muuttujia:

Muokattu arvo	Muuttuja	Kommentti
	MANUAL_NAME	Docker-kontin nimi.
	MANUAL_REP	Tiedostojärjestelmän sijainti, johon volumet liitetään.
	ENV_GW_CERT_NAME_VALUE	Ympäristömuuttujan ENV_GW_CERT_NAME arvo.
	ENV_GW_CERT_PASSWORD_VALUE	Ympäristömuuttujan ENV_GW_CERT_PASSWORD arvo.
	ENV_CARE_CERT_NAME_VALUE	Ympäristömuuttujan ENV_CARE_CERT_NAME arvo.
	ENV_CARE_CERT_PASSWORD_VALUE	Ympäristömuuttujan ENV_CARE_CERT_PASSWORD arvo.
	ENV_SSL_ROUTER_IP_VALUE	Ympäristömuuttujan ENV_SSL_ROUTER_IP arvo.
	ENV_SSL_ROUTER_PORT_VALUE	Ympäristömuuttujan ENV_SSL_ROUTER_PORT arvo.
	ENV_KERBEROS_CONFIG_ENABLE_MANUAL_VALUE	Ympäristömuuttujan ENV_KERBEROS_CONFIG_ENABLE arvo.
	ENV_KERBEROS_DEFAULT_REALM_MANUAL_VALUE	Ympäristömuuttujan ENV_KERBEROS_DEFAULT_REALM arvo.
	ENV_KERBEROS_DEFAULT_DOMAIN_MANUAL_VALUE	Ympäristömuuttujan ENV_KERBEROS_DEFAULT_DOMAIN arvo.
	ENV_KERBEROS_CONTROLLER_ADDRESS_MANUAL_VALUE	Ympäristömuuttujan ENV_KERBEROS_CONTROLLER_ADDRESS arvo.

Luo volumejen liittämiseen tarvittava hakemistorakenne tiedostojärjestelmään:

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

Aseta sen jälkeen Edge Gateway -palvelimen ja tallennuspalvelun sertifikaatit hakemistoon MANUAL_REP/certificates.

Käynnistä lopuksi uusi kontti:

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

Kontin lokeja voi tarkastella seuraavalla komennolla:

docker logs -f MANUAL_NAME