Edge Gateway serveri installimine¶

Märkus

Tuletame meelde, et Debiani arvutites tuleb kasutajale root lülituda järgmise käsuga:

su -

Peegli ja vajalike tööriistade allalaadimine¶

CyberElements Cleanroom 4.6 peegli ja Systancia hoidla allkirjavõtme saab alla laadida sellelt lingilt (nõuab kliendikonto loomist): Systancia Marketplace

Lisaks peeglile ja võtmele on versiooniuuenduse protsessiks vaja kolmanda osapoole tööriistu:

SSH-klient (Windowsis saate kasutada programmi PuTTY)
SCP-klient (Windowsis saab kasutada tööriistu WinSCP või FileZilla)

Kasutage SSH-klienti, et luua serveriga kaugühendus.

Kasutage SCP-klienti, et edastada faile kaugarvutisse.

Installimiseks ettevalmistamine¶

Võrgu konfigureerimine¶

Edge Gateway serverile on tungivalt soovitatav määrata staatiline võrguaadress. Selleks peate esmalt hankima oma arvuti võrguliidese nime ja selle MAC-aadressi. Käivitage kasutajana root järgmine käsk:

ip -br link | grep -ve "^lo"

See käsk kuvab võrguliidese nime, selle oleku, selle MAC-aadressi ja liidese sätted.

Näide

Pärast käsu käivitamist kuvatakse järgmine väljund:

ens192           UP             00:50:56:a1:56:9f <BROADCAST,MULTICAST,UP,LOWER_UP>

Võrguliidese nimi on ens192 ja selle MAC-aadress on 00:50:56:a1:56:9f.

Kui võrguliidese nimi ja MAC-aadress on hangitud, saab nüüd arvuti võrgukonfiguratsiooni redigeerida.
Redigeerige faili /etc/network/interfaces, et muuta seda järgmise malli järgi:

# This file describes the network interfaces available on your system
# and how to activate them. For more information, see interfaces(5).

source /etc/network/interfaces.d/*

# The loopback network interface
auto lo
iface lo inet loopback

# The primary network interface
auto br0
iface br0 inet static
    bridge_ports INTERFACE_NAME
    bridge_stp off
    bridge_fd 0
    bridge_maxwait 2
    bridge_hw MAC_ADDRESS
    address IP_GW
    netmask NETMASK
    gateway NETWORK_GATEWAY
    dns-nameservers IP_DNS_1 IP_DNS_2
    dns-search DNS_SUFFIX

Kus:

INTERFACE_NAME tuleb asendada varem hangitud võrguliidese nimega.
MAC_ADDRESS tuleb asendada varem hangitud MAC-aadressiga.
IP_GW tuleb asendada serveri IP-aadressiga.
NETMASK tuleb asendada IP-aadressiga seotud võrgumaskiga.
NETWORK_GATEWAY tuleb asendada võrgu vaikelüüsiga.
IP_DNS tuleb asendada DNS-serveri IP-aadressiga. Kui on vaja konfigureerida mitu serverit (kuni 3), eraldage need tühikuga.
DNS_SUFFIX tuleb asendada kasutatava DNS-järelliitega. Kui järelliidet pole vaja sisestada, kustutage rida.

Näide

# This file describes the network interfaces available on your system
# and how to activate them. For more information, see interfaces(5).

source /etc/network/interfaces.d/*

# The loopback network interface
auto lo
iface lo inet loopback

# The primary network interface
auto br0
iface br0 inet static
    bridge_ports ens192
    bridge_stp off
    bridge_fd 0
    bridge_maxwait 2
    bridge_hw 00:50:56:a1:56:9f
    address 172.16.10.10
    netmask 255.255.255.0
    gateway 172.16.10.254
    dns-nameservers 172.16.11.2 172.16.11.3
    dns-search domain.local

Enne konfiguratsiooni rakendamist tuleb teha veel kolm sammu.

Esimene on installida paketid resolvconf ja bridge-utils, et eelmises failis määratud DNS-konfiguratsiooni saaks rakendada ja liidest br0 saaks kasutada:

apt install -y resolvconf bridge-utils

Teine on kontrollida faili /etc/hosts konfiguratsiooni arvuti peamise IP-aadressi (IP_GW) osas.
Selleks redigeerige faili /etc/hosts ja kontrollige, et teine rida oleks järgmises vormingus:

2	`IP_GW FQDN MACHINE_NAME`

Näide

Kui arvuti nimi on EDGE-GATEWAY, see ei kuulu domeeni ja selle IP-aadress IP_GW on 172.16.10.10, täidetakse fail järgmiselt:

2	`172.16.10.10 EDGE-GATEWAY`

Kui arvuti kuulub domeeni DOMAIN.LOCAL, täidetakse fail järgmiselt:

2	`172.16.10.10 EDGE-GATEWAY.DOMAIN.LOCAL EDGE-GATEWAY`

Tähelepanu!

Faili vale konfiguratsioon võib põhjustada tõrke paketi collectd installimisel.

Jääb üle vaid server taaskäivitada:

reboot

APT-paketihalduri konfigureerimine¶

Laadige Systancia Marketplace'ist allalaaditud failid SCP-kliendi abil üles serveri kataloogi /tmp/:

systancia.gpg
cleanroom-4.6.1-build33.1096.D12-full.tgz

Logige serverisse sisse kasutajana root ja käivitage seejärel järgmised käsud, et pakkida lahti Systancia hoidla, konfigureerida selle kasutamine APT-s ja see autentida.

mv /tmp/systancia.gpg /etc/apt/trusted.gpg.d/
mkdir -p /opt/systancia/repository/
tar xvzf /tmp/cleanroom-4.6*.tgz -C /opt/systancia/repository/
echo "deb file:///opt/systancia/repository/ bookworm ipdiva" > /etc/apt/sources.list.d/systancia.list
apt update

Soovitame tungivalt apt-käskude käivitamisel mittevajalike pakettide installimise välja lülitada. Selleks käivitage järgmine käsk:

echo -e 'APT::Install-Recommends false;\nAPT::Install-Suggests false;' > /etc/apt/apt.conf.d/99norecommends

CyberElements Bastion lahenduse Edge Gateway serveri installimine¶

Põhikomponentide installimine¶

Alustage komponentide installimist järgmise käsuga kasutajana root:

apt install -y ipdiva-base

Kui kõik sõltuvused on alla laaditud, avaneb aken, kus palutakse valida serveri tüüp. Valige gateway:

Mida teha tõrke korral?

Kui sisestatud teabes on viga, jätkake paketi ipdiva-base installimist ja seejärel kasutage serveri uuesti konfigureerimiseks järgmist käsku:

1	`dpkg-reconfigure ipdiva-base`

Edge Gateway komponentide installimine¶

Seejärel alustage Edge Gateway serveri spetsiifiliste komponentide installimist järgmise käsuga:

apt install -y ipdiva-safe-gateway ipdiva-gateway-setup

Edge Gateway serveri komponendid on nüüd installitud. Jääb üle vaid arvuti taaskäivitada, et äsja installitud komponendid saaksid lähtestuda:

reboot

HTML5 Gateway komponentide installimine¶

Kasutage järgmist käsku, et alustada HTML5 Gateway komponentide installimist Edge Gateway serverisse:

apt install -y ipdiva-html5gateway ipdiva-html5-webapp ipdiva-guacamole-server1

Kasutage järgmisi käsuridu failiedastuse ja virtuaalprinteri funktsioonide sisselülitamiseks ja konfigureerimiseks:

apt install -y ghostscript
echo -e "printer=cyberelements HTML5 Printer\nprinterDriver=MS Publisher Imagesetter" > /etc/guacamole/printer-config
mkdir /home/systanciahtml5share

Konfiguratsioon¶

Konfiguratsioonid enne HTML5 Gateway komponendi ühendamist¶

HTML5-rakenduste toimimiseks tuleb Mediation Controller serveris konfigureerida lisasätted. Logige Mediation Controller serverisse sisse kasutajana root.

Looge või muutke faili /etc/ipdiva/httpd/commonParameters.extra.conf, et lisada järgmisega samaväärne jaotis:

<Location /URL_HTML5/>
        Order allow,deny
        Allow from all
        RequestHeader set X-Forwarded-Proto "https"
        RequestHeader set X-IPdiva-Gateway GW_NAME|
        RequestHeader set X-IPdiva-Orgname ORGANIZATION_NAME
        RequestHeader set X-IPdiva-Service 127.0.0.1:8080

        ProxyPass http://127.0.0.1:9016/systanciaHTML5-6.0/ flushpackets=on
</Location>

<Location /URL_HTML5/websocket-tunnel>
        Order allow,deny
        Allow from all
        RequestHeader set X-Forwarded-Proto "https"
        RequestHeader set X-IPdiva-Gateway GW_NAME|
        RequestHeader set X-IPdiva-Orgname ORGANIZATION_NAME
        RequestHeader set X-IPdiva-Service 127.0.0.1:8080

        ProxyPass ws://127.0.0.1:9016/systanciaHTML5-6.0/websocket-tunnel
</Location>

Kus:

URL_HTML5 tuleb asendada selle HTML5 Gateway komponendi välja URL sisuga, mis konfigureeriti halduskonsoolis pairingu tokeni genereerimisel.
GW_NAME tuleb asendada sellise Edge Gateway komponendi nimega, mis asub HTML5 Gateway komponendiga samas serveris. Rea lõpus olev märk | tuleb säilitada.
ORGANIZATION_NAME tuleb asendada selle organisatsiooni nimega, millega eelmine Edge Gateway komponent ühenduse loob.

Näide

Platvormi puhul, millel on järgmised sätted:

Organisatsiooni nimi: my-organization-name
HTML5 Gateway komponendi deklareerimine halduskonsoolis:
- Name: html5-gateway
- URL: HTML5
- Protocol: WebSocket
Edge Gateway serveril on:
- Edge Gateway teenus nimega edge-gateway
- HTML5 Gateway teenus nimega html5-gateway

Loodud konfiguratsioonifail /etc/ipdiva/httpd/commonParameters.extra.conf seadistatakse järgmiselt:

<Location /HTML5/>
        Order allow,deny
        Allow from all
        RequestHeader set X-Forwarded-Proto "https"
        RequestHeader set X-IPdiva-Gateway edge-gateway|
        RequestHeader set X-IPdiva-Orgname my-organization-name
        RequestHeader set X-IPdiva-Service 127.0.0.1:8080

        ProxyPass http://127.0.0.1:9016/systanciaHTML5-6.0/ flushpackets=on
</Location>

<Location /HTML5/websocket-tunnel>
        Order allow,deny
        Allow from all
        RequestHeader set X-Forwarded-Proto "https"
        RequestHeader set X-IPdiva-Gateway edge-gateway|
        RequestHeader set X-IPdiva-Orgname my-organization-name
        RequestHeader set X-IPdiva-Service 127.0.0.1:8080

        ProxyPass ws://127.0.0.1:9016/systanciaHTML5-6.0/websocket-tunnel
</Location>

Enne uute sätete rakendamist peate kontrollima, et uus konfiguratsioon ei põhjusta veebiserverile Apache2 blokeerivaid tõrkeid.
Selleks käivitage järgmine käsk:

1	`apache2ctl configtest`

Kui vastus on Syntax OK, saab muudatused rakendada alloleva käsuga. Vastasel juhul kontrollige oma konfiguratsiooni failis /etc/ipdiva/httpd/commonParameters.extra.conf.

1	`systemctl reload apache2`

Edge Gateway ja HTML5 Gateway komponendi ühendamine¶

Tähelepanu!

Kui kasutate SSL Router komponendi jaoks sertifikaate, mille on väljastanud mõni muu sertifitseerimisasutus (CA) kui Systancia oma, peate lisama juur-CA Edge Gateway komponendi usaldusväärsete CA-de hulka: lisage SSL Router komponendi juur-CA Edge Gateway või HTML5 Gateway ühenduse usaldusväärsete CA-de hulka.

Edge Gateway ja HTML5 Gateway eksemplaride konfigureerimiseks serveris järgige järgmises dokumentatsioonis toodud teavet: Serveri pairing