Instalacija poslužitelja Edge Gateway¶

Napomena

Podsjetnik: prebacivanje na root na računalima sa sustavom Debian mora se izvršiti sljedećom naredbom:

su -

Preuzimanje zrcala i potrebnih alata¶

Zrcalo za CyberElements Cleanroom 4.6 i ključ za potpis repozitorija tvrtke Systancia mogu se preuzeti s ove poveznice (potrebno je stvoriti račun klijenta): Systancia Marketplace

Uz zrcalo i ključ, za postupak nadogradnje bit će potrebni alati trećih strana:

SSH klijent (u sustavu Windows možete upotrijebiti PuTTY)
SCP klijent (u sustavu Windows možete upotrijebiti alate WinSCP ili FileZilla)

Upotrijebite SSH klijent za udaljeno povezivanje sa svojim poslužiteljem.

Upotrijebite SCP klijent za prijenos datoteka na udaljeno računalo.

Priprema za instalaciju¶

Konfiguracija mreže¶

Izričito se preporučuje definirati statičku mrežnu adresu za poslužitelj Edge Gateway. Da biste to učinili, najprije morate dohvatiti naziv mrežnog sučelja svojeg računala i njegovu MAC adresu. Pokrenite sljedeću naredbu kao root:

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

Ova naredba prikazuje naziv mrežnog sučelja, njegovo stanje, njegovu MAC adresu i postavke sučelja.

Primjer

Nakon izvršavanja naredbe prikazuje se sljedeći izlaz:

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

Naziv mrežnog sučelja je ens192, a njegova je MAC adresa 00:50:56:a1:56:9f.

Kada ste dobili naziv mrežnog sučelja i MAC adresu, sada možete urediti mrežnu konfiguraciju računala.
Uredite datoteku /etc/network/interfaces i izmijenite je prema sljedećem predlošku:

# 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 čemu:

INTERFACE_NAME treba zamijeniti nazivom prethodno dohvaćenog mrežnog sučelja.
MAC_ADDRESS treba zamijeniti prethodno dohvaćenom MAC adresom.
IP_GW treba zamijeniti IP adresom poslužitelja.
NETMASK treba zamijeniti mrežnom maskom pridruženom IP adresi.
NETWORK_GATEWAY treba zamijeniti zadanim mrežnim pristupnikom.
IP_DNS treba zamijeniti IP adresom DNS poslužitelja. Ako treba konfigurirati nekoliko poslužitelja (najviše 3), odvojite ih razmakom.
DNS_SUFFIX treba zamijeniti DNS sufiksom koji će se upotrebljavati. Ako sufiks nije potrebno unijeti, izbrišite redak.

Primjer

# 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

Prije primjene konfiguracije treba dovršiti još tri koraka.

Prvi je instalacija paketa resolvconf i bridge-utils kako bi se mogla primijeniti DNS konfiguracija navedena u prethodnoj datoteci i kako bi se moglo upotrebljavati sučelje br0:

apt install -y resolvconf bridge-utils

Drugi je provjera konfiguracije datoteke /etc/hosts u pogledu primarne IP adrese računala (IP_GW).
Da biste to učinili, uredite datoteku /etc/hosts i provjerite je li drugi redak u sljedećem obliku:

2	`IP_GW FQDN MACHINE_NAME`

Primjer

Ako je naziv računala EDGE-GATEWAY, računalo ne pripada domeni, a njegova je IP adresa IP_GW jednaka 172.16.10.10, datoteka bi se ispunila na sljedeći način:

2	`172.16.10.10 EDGE-GATEWAY`

Ako računalo pripada domeni DOMAIN.LOCAL, datoteka bi se ispunila na sljedeći način:

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

Pozor!

Neispravna konfiguracija datoteke može uzrokovati pogrešku pri instalaciji paketa collectd.

Preostaje samo ponovno pokrenuti poslužitelj:

reboot

Konfiguriranje upravitelja paketa APT¶

Prenesite datoteke preuzete sa servisa Systancia Marketplace u direktorij /tmp/ na poslužitelju pomoću SCP klijenta:

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

Prijavite se na poslužitelj kao root, a zatim pokrenite sljedeće naredbe da biste raspakirali repozitorij tvrtke Systancia, konfigurirali njegovu upotrebu u alatu APT i provjerili njegovu autentičnost.

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

Izričito preporučujemo da onemogućite instalaciju nepotrebnih paketa pri pokretanju naredbi apt. Da biste to učinili, pokrenite sljedeću naredbu:

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

Instalacija poslužitelja Edge Gateway za CyberElements Bastion¶

Instalacija osnovnih komponenti¶

Pokrenite instalaciju komponenti sljedećom naredbom kao root:

apt install -y ipdiva-base

Nakon preuzimanja svih zavisnosti otvorit će se prozor u kojem se od vas traži da odaberete vrstu poslužitelja. Odaberite gateway:

Što učiniti u slučaju pogreške?

Ako postoji pogreška u podacima koje ste unijeli, nastavite instalaciju paketa ipdiva-base, a zatim upotrijebite sljedeću naredbu za ponovno konfiguriranje poslužitelja:

1	`dpkg-reconfigure ipdiva-base`

Instalacija komponenti Edge Gateway¶

Zatim pokrenite instalaciju komponenti specifičnih za poslužitelj Edge Gateway sljedećom naredbom:

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

Komponente poslužitelja Edge Gateway sada su instalirane. Preostaje samo ponovno pokrenuti računalo kako bi se novoinstalirane komponente mogle inicijalizirati:

reboot

Instalacija komponenti HTML5 Gateway¶

Upotrijebite sljedeću naredbu da biste pokrenuli instalaciju komponenti HTML5 Gateway na poslužitelju Edge Gateway:

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

Upotrijebite sljedeće naredbene retke da biste omogućili i konfigurirali značajke prijenosa datoteka i virtualnog pisača:

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

Konfiguracija¶

Konfiguracije prije povezivanja komponente HTML5 Gateway¶

Da bi aplikacije HTML5 radile, potrebno je konfigurirati dodatne postavke na poslužitelju Mediation Controller. Prijavite se na poslužitelj Mediation Controller kao root.

Stvorite ili izmijenite datoteku /etc/ipdiva/httpd/commonParameters.extra.conf kako biste dodali odjeljak ekvivalentan sljedećem:

<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 čemu:

URL_HTML5 treba zamijeniti sadržajem polja URL komponente HTML5 Gateway konfigurirane u administratorskoj konzoli prilikom generiranja tokena pairinga.
GW_NAME treba zamijeniti nazivom komponente Edge Gateway koja se nalazi na istom poslužitelju kao i komponenta HTML5 Gateway. Znak | na kraju retka mora se zadržati.
ORGANIZATION_NAME treba zamijeniti nazivom organizacije s kojom se povezuje prethodna komponenta Edge Gateway.

Primjer

Za platformu sa sljedećim postavkama:

Naziv organizacije: my-organization-name
Deklaracija komponente HTML5 Gateway u administratorskoj konzoli:
- Naziv: html5-gateway
- URL: HTML5
- Protocol: WebSocket
Poslužitelj Edge Gateway ima:
- Uslugu Edge Gateway pod nazivom edge-gateway
- Uslugu HTML5 Gateway pod nazivom html5-gateway

Stvorena konfiguracijska datoteka /etc/ipdiva/httpd/commonParameters.extra.conf bit će postavljena na sljedeći način:

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

Prije primjene novih postavki morate provjeriti da nova konfiguracija ne uzrokuje blokirajuće pogreške za web-poslužitelj Apache2.
Da biste to učinili, pokrenite sljedeću naredbu:

1	`apache2ctl configtest`

Ako je odgovor Syntax OK, promjene se mogu primijeniti naredbom u nastavku. U suprotnom provjerite svoju konfiguraciju u datoteci /etc/ipdiva/httpd/commonParameters.extra.conf.

1	`systemctl reload apache2`

Povezivanje komponenti Edge Gateway i HTML5 Gateway¶

Pozor!

Ako za komponentu SSL Router upotrebljavate certifikate koje je izdalo certifikacijsko tijelo (CA) koje nije tijelo tvrtke Systancia, morate dodati korijensko certifikacijsko tijelo među pouzdana certifikacijska tijela komponente Edge Gateway: dodajte korijensko certifikacijsko tijelo komponente SSL Router među pouzdana certifikacijska tijela za vezu komponente Edge Gateway ili HTML5 Gateway.

Da biste konfigurirali instance komponenti Edge Gateway i HTML5 Gateway na poslužitelju, slijedite informacije navedene u sljedećoj dokumentaciji: Pairing poslužitelja