Inštalácia servera Edge Gateway¶

Poznámka

Pripomíname, že prepnutie na root na počítačoch s Debianom je potrebné vykonať nasledujúcim príkazom:

su -

Stiahnutie zrkadla a potrebných nástrojov¶

Zrkadlo CyberElements Cleanroom 4.6 a podpisový kľúč úložiska Systancia si môžete stiahnuť z tohto odkazu (vyžaduje vytvorenie zákazníckeho účtu): Systancia Marketplace

Okrem zrkadla a kľúča budú na proces upgradu potrebné nástroje tretích strán:

Klient SSH (v systéme Windows môžete použiť PuTTY)
Klient SCP (v systéme Windows možno použiť nástroje WinSCP alebo FileZilla)

Pomocou klienta SSH sa vzdialene pripojte k serveru.

Pomocou klienta SCP preneste súbory do vzdialeného počítača.

Príprava na inštaláciu¶

Konfigurácia siete¶

Dôrazne sa odporúča definovať pre server Edge Gateway statickú sieťovú adresu. Ak to chcete urobiť, najprv musíte zistiť názov sieťového rozhrania vášho počítača a jeho adresu MAC. Spustite nasledujúci príkaz ako root:

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

Tento príkaz zobrazí názov sieťového rozhrania, jeho stav, jeho adresu MAC a nastavenia rozhrania.

Príklad

Po vykonaní príkazu sa zobrazí nasledujúci výstup:

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

Názov sieťového rozhrania je ens192 a jeho adresa MAC je 00:50:56:a1:56:9f.

Po zistení názvu sieťového rozhrania a adresy MAC je teraz možné upraviť sieťovú konfiguráciu počítača.
Upravte súbor /etc/network/interfaces podľa nasledujúcej šablóny:

# 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

Kde:

INTERFACE_NAME je potrebné nahradiť názvom predtým zisteného sieťového rozhrania.
MAC_ADDRESS je potrebné nahradiť predtým zistenou adresou MAC.
IP_GW je potrebné nahradiť IP adresou servera.
NETMASK je potrebné nahradiť sieťovou maskou priradenou k IP adrese.
NETWORK_GATEWAY je potrebné nahradiť predvolenou sieťovou bránou.
IP_DNS je potrebné nahradiť IP adresou servera DNS. Ak je potrebné nakonfigurovať viacero serverov (najviac 3), oddeľte ich medzerou.
DNS_SUFFIX je potrebné nahradiť príponou DNS, ktorá sa má použiť. Ak nie je potrebné zadať žiadnu príponu, riadok odstráňte.

Príklad

# 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

Pred použitím konfigurácie zostávajú ešte tri kroky.

Prvým je inštalácia balíkov resolvconf a bridge-utils, aby bolo možné použiť konfiguráciu DNS zadanú v predchádzajúcom súbore a používať rozhranie br0:

apt install -y resolvconf bridge-utils

Druhým je kontrola konfigurácie súboru /etc/hosts vzhľadom na primárnu IP adresu počítača (IP_GW).
Ak to chcete urobiť, upravte súbor /etc/hosts a skontrolujte, či má druhý riadok nasledujúci formát:

2	`IP_GW FQDN MACHINE_NAME`

Príklad

Ak má počítač názov EDGE-GATEWAY, nepatrí do domény a jeho IP adresa IP_GW je 172.16.10.10, súbor by sa vyplnil takto:

2	`172.16.10.10 EDGE-GATEWAY`

Ak počítač patrí do domény DOMAIN.LOCAL, súbor by sa vyplnil takto:

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

Pozor!

Nesprávna konfigurácia súboru môže spôsobiť chybu pri inštalácii balíka collectd.

Zostáva už len reštartovať server:

reboot

Konfigurácia správcu balíkov APT¶

Pomocou klienta SCP nahrajte súbory stiahnuté zo Systancia Marketplace do adresára /tmp/ na serveri:

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

Prihláste sa na server ako root a potom spustite nasledujúce príkazy na rozbalenie úložiska Systancia, konfiguráciu jeho používania v APT a jeho overenie.

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

Dôrazne odporúčame zakázať inštaláciu nepotrebných balíkov pri spúšťaní príkazov apt. Ak to chcete urobiť, spustite nasledujúci príkaz:

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

Inštalácia servera Edge Gateway produktu CyberElements Bastion¶

Inštalácia základných komponentov¶

Spustite inštaláciu komponentov pomocou nasledujúceho príkazu ako root:

apt install -y ipdiva-base

Po stiahnutí všetkých závislostí sa otvorí okno s výzvou na výber typu servera. Vyberte gateway:

Čo robiť v prípade chyby?

Ak sú v zadaných informáciách chyby, pokračujte v inštalácii balíka ipdiva-base a potom server znova nakonfigurujte pomocou nasledujúceho príkazu:

1	`dpkg-reconfigure ipdiva-base`

Inštalácia komponentov Edge Gateway¶

Potom spustite inštaláciu komponentov špecifických pre Edge Gateway pomocou nasledujúceho príkazu:

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

Komponenty servera Edge Gateway sú teraz nainštalované. Zostáva už len reštartovať počítač, aby sa novo nainštalované komponenty mohli inicializovať:

reboot

Inštalácia komponentov HTML5 Gateway¶

Pomocou nasledujúceho príkazu spustite inštaláciu komponentov HTML5 Gateway na serveri Edge Gateway:

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

Pomocou nasledujúcich príkazových riadkov povoľte a nakonfigurujte funkcie prenosu súborov a virtuálnej tlačiarne:

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

Konfigurácia¶

Konfigurácie pred pripojením HTML5 Gateway¶

Aby aplikácie HTML5 fungovali, je potrebné nakonfigurovať ďalšie nastavenia na serveri Mediation Controller. Prihláste sa na server Mediation Controller ako root.

Vytvorte alebo upravte súbor /etc/ipdiva/httpd/commonParameters.extra.conf a pridajte blok ekvivalentný nasledujúcemu:

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

Kde:

URL_HTML5 treba nahradiť obsahom poľa URL komponentu HTML5 Gateway nakonfigurovaného v konzole na správu pri generovaní tokenu pairingu.
GW_NAME je potrebné nahradiť názvom komponentu Edge Gateway, ktorý sa nachádza na rovnakom serveri ako komponent HTML5 Gateway. Znak | na konci riadka musí zostať zachovaný.
ORGANIZATION_NAME je potrebné nahradiť názvom organizácie, ku ktorej sa predchádzajúci komponent Edge Gateway pripája.

Príklad

Pre platformu s nasledujúcimi nastaveniami:

Názov organizácie: my-organization-name
Deklarácia komponentu HTML5 Gateway v konzole na správu:
- Názov: html5-gateway
- URL: HTML5
- Protocol: WebSocket
Server Edge Gateway má:
- Službu Edge Gateway s názvom edge-gateway
- Službu HTML5 Gateway s názvom html5-gateway

Vytvorený konfiguračný súbor /etc/ipdiva/httpd/commonParameters.extra.conf sa nastaví takto:

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

Pred použitím nových nastavení musíte skontrolovať, či nová konfigurácia nespôsobuje žiadne blokujúce chyby webového servera Apache2.
Ak to chcete urobiť, spustite nasledujúci príkaz:

1	`apache2ctl configtest`

Ak je odpoveď Syntax OK, zmeny je možné použiť príkazom nižšie. V opačnom prípade skontrolujte svoju konfiguráciu v súbore /etc/ipdiva/httpd/commonParameters.extra.conf.

1	`systemctl reload apache2`

Pripojenie Edge Gateway a HTML5 Gateway¶

Pozor!

Ak pre komponent SSL Router používate certifikáty vydané inou certifikačnou autoritou (CA) než autoritou Systancia, musíte pridať koreňovú CA medzi dôveryhodné CA komponentu Edge Gateway: pridajte koreňovú CA komponentu SSL Router medzi dôveryhodné CA pre pripojenie Edge Gateway alebo HTML5 Gateway.

Ak chcete nakonfigurovať inštancie Edge Gateway a HTML5 Gateway na serveri, postupujte podľa informácií v nasledujúcej dokumentácii: Pairing servera