Namestitev strežnika Edge Gateway¶

Opomba

Opomnik: na računalnikih Debian je treba na root preklopiti z naslednjim ukazom:

su -

Prenos zrcala in potrebnih orodij¶

Zrcalo CyberElements Cleanroom 4.6 in ključ za podpis skladišča Systancia lahko prenesete s te povezave (zahteva ustvarjanje računa stranke): Systancia Marketplace

Poleg zrcala in ključa boste za postopek nadgradnje potrebovali orodja drugih ponudnikov:

Odjemalec SSH (v sistemu Windows lahko uporabite PuTTY)
Odjemalec SCP (v sistemu Windows lahko uporabite orodji WinSCP ali FileZilla)

Z odjemalcem SSH se oddaljeno povežite s strežnikom.

Z odjemalcem SCP prenesite datoteke na oddaljeni računalnik.

Priprava na namestitev¶

Konfiguracija omrežja¶

Za strežnik Edge Gateway je zelo priporočljivo določiti statični omrežni naslov. Za to morate najprej pridobiti ime omrežnega vmesnika računalnika in njegov naslov MAC. Kot root zaženite naslednji ukaz:

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

Ta ukaz prikaže ime omrežnega vmesnika, njegovo stanje, njegov naslov MAC in nastavitve vmesnika.

Primer

Ko se ukaz izvede, se prikaže naslednji izhod:

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

Ime omrežnega vmesnika je ens192, njegov naslov MAC pa 00:50:56:a1:56:9f.

Ko imate ime omrežnega vmesnika in naslov MAC, lahko uredite omrežno konfiguracijo računalnika.
Uredite datoteko /etc/network/interfaces in jo spremenite po naslednji predlogi:

# 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

Pri čemer:

INTERFACE_NAME je treba zamenjati z imenom prej pridobljenega omrežnega vmesnika.
MAC_ADDRESS je treba zamenjati s prej pridobljenim naslovom MAC.
IP_GW je treba zamenjati z naslovom IP strežnika.
NETMASK je treba zamenjati z omrežno masko, povezano z naslovom IP.
NETWORK_GATEWAY je treba zamenjati s privzetim omrežnim prehodom.
IP_DNS je treba zamenjati z naslovom IP strežnika DNS. Če je treba konfigurirati več strežnikov (največ 3), jih ločite s presledkom.
DNS_SUFFIX je treba zamenjati s pripono DNS, ki jo želite uporabiti. Če pripone ni treba vnesti, izbrišite vrstico.

Primer

# 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

Preden uporabite konfiguracijo, morate opraviti še tri korake.

Prvi je namestitev paketov resolvconf in bridge-utils, da bo mogoče uporabiti konfiguracijo DNS, določeno v prejšnji datoteki, in uporabljati vmesnik br0:

apt install -y resolvconf bridge-utils

Drugi je preverjanje konfiguracije datoteke /etc/hosts glede glavnega naslova IP računalnika (IP_GW).
To naredite tako, da uredite datoteko /etc/hosts in preverite, ali je druga vrstica v naslednji obliki:

2	`IP_GW FQDN MACHINE_NAME`

Primer

Če je ime računalnika EDGE-GATEWAY, računalnik ne spada v nobeno domeno in je njegov naslov IP IP_GW enak 172.16.10.10, bi bila datoteka izpolnjena takole:

2	`172.16.10.10 EDGE-GATEWAY`

Če računalnik spada v domeno DOMAIN.LOCAL, bi bila datoteka izpolnjena takole:

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

Pozor!

Napačna konfiguracija datoteke lahko povzroči napako pri nameščanju paketa collectd.

Preostane le še ponovni zagon strežnika:

reboot

Konfiguracija upravitelja paketov APT¶

Datoteke, prenesene s Systancia Marketplace, z odjemalcem SCP naložite v imenik /tmp/ na strežniku:

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

Prijavite se v strežnik kot root in nato zaženite naslednje ukaze, da razširite skladišče Systancia, konfigurirate njegovo uporabo v APT in preverite njegovo pristnost.

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

Toplo priporočamo, da pri izvajanju ukazov apt onemogočite nameščanje nepotrebnih paketov. To naredite tako, da zaženete naslednji ukaz:

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

Namestitev strežnika Edge Gateway za CyberElements Bastion¶

Namestitev osnovnih komponent¶

Namestitev komponent začnite z naslednjim ukazom kot root:

apt install -y ipdiva-base

Ko so prenesene vse odvisnosti, se odpre okno, v katerem morate izbrati vrsto strežnika. Izberite gateway:

Kaj storiti v primeru napake?

Če so v vnesenih podatkih napake, nadaljujte namestitev paketa ipdiva-base in nato z naslednjim ukazom znova konfigurirajte strežnik:

1	`dpkg-reconfigure ipdiva-base`

Namestitev komponent Edge Gateway¶

Nato z naslednjim ukazom začnite namestitev komponent, specifičnih za strežnik Edge Gateway:

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

Komponente strežnika Edge Gateway so zdaj nameščene. Preostane le še ponovni zagon računalnika, da se lahko na novo nameščene komponente inicializirajo:

reboot

Namestitev komponent HTML5 Gateway¶

Z naslednjim ukazom začnite nameščati komponente HTML5 Gateway na strežnik Edge Gateway:

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

Z naslednjimi ukaznimi vrsticami omogočite in konfigurirajte funkciji prenosa datotek in navideznega tiskalnika:

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

Konfiguracija¶

Konfiguracije pred povezovanjem komponente HTML5 Gateway¶

Da bodo aplikacije HTML5 delovale, morate na strežniku Mediation Controller konfigurirati dodatne nastavitve. Prijavite se v strežnik Mediation Controller kot root.

Ustvarite ali spremenite datoteko /etc/ipdiva/httpd/commonParameters.extra.conf in dodajte razdelek, enakovreden naslednjemu:

<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>

Pri čemer:

URL_HTML5 je treba zamenjati z vsebino polja URL komponente HTML5 Gateway, konfigurirane v skrbniški konzoli pri ustvarjanju tokena pairinga.
GW_NAME je treba zamenjati z imenom komponente Edge Gateway, ki je na istem strežniku kot komponenta HTML5 Gateway. Znak | na koncu vrstice je treba ohraniti.
ORGANIZATION_NAME je treba zamenjati z imenom organizacije, s katero se povezuje prej omenjena komponenta Edge Gateway.

Primer

Za platformo z naslednjimi nastavitvami:

Ime organizacije: my-organization-name
Deklaracija komponente HTML5 Gateway v skrbniški konzoli:
- Ime: html5-gateway
- URL: HTML5
- Protocol: WebSocket
Strežnik Edge Gateway ima:
- storitev Edge Gateway z imenom edge-gateway
- storitev HTML5 Gateway z imenom html5-gateway

Ustvarjena konfiguracijska datoteka /etc/ipdiva/httpd/commonParameters.extra.conf bo nastavljena takole:

<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>

Preden uporabite nove nastavitve, morate preveriti, da nova konfiguracija ne povzroča blokirajočih napak za spletni strežnik Apache2.
To storite tako, da zaženete naslednji ukaz:

1	`apache2ctl configtest`

Če je odziv Syntax OK, lahko spremembe uporabite s spodnjim ukazom. V nasprotnem primeru preverite konfiguracijo v datoteki /etc/ipdiva/httpd/commonParameters.extra.conf.

1	`systemctl reload apache2`

Povezovanje komponent Edge Gateway in HTML5 Gateway¶

Pozor!

Če za komponento SSL Router uporabljate potrdila, ki jih je izdal overitelj potrdil (CA), ki ni Systancia, morate korenski CA dodati med zaupanja vredne overitelje potrdil komponente Edge Gateway: dodajte korenski CA komponente SSL Router med zaupanja vredne overitelje potrdil za povezavo komponente Edge Gateway ali HTML5 Gateway.

Za konfiguracijo instanc Edge Gateway in HTML5 Gateway na strežniku upoštevajte informacije iz naslednje dokumentacije: Pairing strežnika