Installation av Edge Gateway-servern¶

Obs

Som påminnelse: byte till root på Debian-maskiner måste göras med följande kommando:

su -

Ladda ner spegeln och de nödvändiga verktygen¶

Spegeln CyberElements Cleanroom 4.6 och signaturnyckeln för Systancia-repositoryt kan laddas ner via den här länken (kräver att ett kundkonto skapas): Systancia Marketplace

Utöver spegeln och nyckeln krävs verktyg från tredje part för uppgraderingsprocessen:

En SSH-klient (i Windows kan du använda PuTTY)
En SCP-klient (i Windows kan verktygen WinSCP eller FileZilla användas)

Använd SSH-klienten för att ansluta till servern på distans.

Använd SCP-klienten för att överföra filer till din fjärrmaskin.

Förbereda installationen¶

Konfiguration av nätverket¶

Det rekommenderas starkt att en statisk nätverksadress definieras för Edge Gateway-servern. För att göra det måste du först hämta namnet på maskinens nätverksgränssnitt och dess MAC-adress. Kör följande kommando som root:

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

Kommandot visar namnet på nätverksgränssnittet, dess status, dess MAC-adress och gränssnittets inställningar.

Exempel

När kommandot har körts visas följande utdata:

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

Nätverksgränssnittets namn är ens192 och dess MAC-adress är 00:50:56:a1:56:9f.

När namnet på nätverksgränssnittet och MAC-adressen har hämtats är det nu möjligt att redigera maskinens nätverkskonfiguration.
Redigera filen /etc/network/interfaces för att ändra den enligt följande mall:

# 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

Där:

INTERFACE_NAME ska ersättas med namnet på det nätverksgränssnitt som hämtades tidigare.
MAC_ADDRESS ska ersättas med den MAC-adress som hämtades tidigare.
IP_GW ska ersättas med serverns IP-adress.
NETMASK ska ersättas med den nätmask som hör till IP-adressen.
NETWORK_GATEWAY ska ersättas med nätverkets standardgateway.
IP_DNS ska ersättas med DNS-serverns IP-adress. Om flera servrar måste konfigureras (högst 3) separerar du dem med ett blanksteg.
DNS_SUFFIX ska ersättas med det DNS-suffix som ska användas. Om inget suffix behöver anges tar du bort raden.

Exempel

# 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

Innan konfigurationen tillämpas återstår tre steg att slutföra.

Det första är att installera paketen resolvconf och bridge-utils så att den DNS-konfiguration som angetts i den föregående filen kan tillämpas och gränssnittet br0 kan användas:

apt install -y resolvconf bridge-utils

Det andra är att kontrollera konfigurationen av filen /etc/hosts med avseende på maskinens huvudsakliga IP-adress (IP_GW).
Redigera då filen /etc/hosts och kontrollera att den andra raden har följande format:

2	`IP_GW FQDN MACHINE_NAME`

Exempel

Om maskinen heter EDGE-GATEWAY utan att tillhöra en domän och dess IP-adress IP_GW är 172.16.10.10, ska filen fyllas i på följande sätt:

2	`172.16.10.10 EDGE-GATEWAY`

Om maskinen tillhör domänen DOMAIN.LOCAL ska filen fyllas i på följande sätt:

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

Observera!

En felaktig konfiguration av filen kan orsaka ett fel vid installationen av paketet collectd.

Nu återstår bara att starta om servern:

reboot

Konfigurera pakethanteraren APT¶

Ladda upp de filer som laddats ner från Systancia Marketplace till katalogen /tmp/ på servern med en SCP-klient:

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

Logga in på servern som root och kör sedan följande kommandon för att packa upp Systancia-repositoryt, konfigurera dess användning i APT och autentisera det.

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

Vi rekommenderar starkt att du inaktiverar installationen av onödiga paket när apt-kommandon körs. Kör följande kommando för att göra det:

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

Installation av Edge Gateway-servern i CyberElements Bastion¶

Installation av baskomponenterna¶

Starta installationen av komponenterna med följande kommando som root:

apt install -y ipdiva-base

När alla beroenden har laddats ner öppnas ett fönster där du ska välja servertyp. Välj gateway:

Vad gör jag om det uppstår ett fel?

Om det har blivit ett fel i den information du angav fortsätter du installationen av paketet ipdiva-base och använder sedan följande kommando för att konfigurera om servern:

1	`dpkg-reconfigure ipdiva-base`

Installation av Edge Gateway-komponenterna¶

Starta därefter installationen av de komponenter som är specifika för Edge Gateway med följande kommando:

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

Komponenterna för Edge Gateway-servern är nu installerade. Nu återstår bara att starta om maskinen så att de nyinstallerade komponenterna kan initieras:

reboot

Installation av HTML5 Gateway-komponenterna¶

Använd följande kommando för att starta installationen av HTML5 Gateway-komponenterna på Edge Gateway-servern:

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

Använd följande kommandorader för att aktivera och konfigurera funktionerna för filöverföring och virtuell skrivare:

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

Konfiguration¶

Konfigurationer före anslutningen av HTML5 Gateway¶

För att HTML5-applikationerna ska fungera måste ytterligare inställningar konfigureras på Mediation Controller-servern. Logga in som root på servern Mediation Controller.

Skapa eller ändra filen /etc/ipdiva/httpd/commonParameters.extra.conf för att lägga till ett avsnitt som motsvarar följande:

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

Där:

URL_HTML5 måste ersättas med innehållet i fältet URL för den HTML5 Gateway som konfigurerades i administrationskonsolen vid genereringen av pairing token.
GW_NAME ska ersättas med namnet på en Edge Gateway som finns på samma server som HTML5 Gateway. Tecknet | i slutet av raden måste behållas.
ORGANIZATION_NAME ska ersättas med namnet på den organisation som den föregående Edge Gateway ansluter till.

Exempel

För en plattform med följande konfiguration:

Namn på organisationen: my-organization-name
Deklaration av HTML5 Gateway i administrationskonsolen:
- Name: html5-gateway
- URL: HTML5
- Protocol: WebSocket
En Edge Gateway-server har:
- En Edge Gateway-tjänst med namnet edge-gateway
- En HTML5 Gateway-tjänst med namnet html5-gateway

Den konfigurationsfil /etc/ipdiva/httpd/commonParameters.extra.conf som skapas ska konfigureras på följande sätt:

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

Innan du tillämpar de nya inställningarna måste du kontrollera att den nya konfigurationen inte orsakar något blockerande fel för webbservern Apache2.
Kör följande kommando för att göra det:

1	`apache2ctl configtest`

Om svaret är Syntax OK kan ändringarna tillämpas med kommandot nedan. Kontrollera annars din konfiguration i filen /etc/ipdiva/httpd/commonParameters.extra.conf.

1	`systemctl reload apache2`

Ansluta Edge Gateway och HTML5 Gateway¶

Observera!

Om du för komponenten SSL Router använder certifikat som utfärdats av en annan certifikatutfärdare (CA) än Systancias måste du lägga till rot-CA:n bland de betrodda CA:erna för Edge Gateway: lägg till rot-CA:n för SSL Router bland de betrodda CA:erna för anslutningen av Edge Gateway eller HTML5 Gateway.

För att konfigurera instanserna av Edge Gateway och HTML5 Gateway på servern följer du informationen i följande dokumentation: Pairing av servern