Инсталиране на сървъра Edge Gateway¶

Забележка

Напомняме, че превключването към root на компютри с Debian трябва да се извършва със следната команда:

su -

Изтегляне на огледалото и необходимите инструменти¶

Огледалното хранилище (mirror) на CyberElements Cleanroom 4.6 и ключът за подпис на хранилището на Systancia могат да бъдат изтеглени от тази връзка (изисква създаване на клиентски акаунт): Systancia Marketplace

Освен огледалното хранилище и ключа, за процеса на надграждане ще са необходими и инструменти на трети страни:

SSH клиент (в Windows можете да използвате PuTTY)
SCP клиент (в Windows могат да се използват инструментите WinSCP или FileZilla)

Използвайте SSH клиента, за да се свържете отдалечено със своя сървър.

Използвайте SCP клиента, за да прехвърлите файлове към отдалечения компютър.

Подготовка за инсталирането¶

Конфигуриране на мрежата¶

Силно се препоръчва да зададете статичен мрежов адрес за сървъра Edge Gateway. За да направите това, първо трябва да получите името на мрежовия интерфейс на компютъра и неговия MAC адрес. Изпълнете следната команда като root:

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

Тази команда показва името на мрежовия интерфейс, неговото състояние, неговия MAC адрес и настройките на интерфейса.

Пример

След изпълнението на командата се показва следният резултат:

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

Името на мрежовия интерфейс е ens192, а неговият MAC адрес е 00:50:56:a1:56:9f.

След като името на мрежовия интерфейс и MAC адресът са получени, вече можете да редактирате мрежовата конфигурация на компютъра.
Редактирайте файла /etc/network/interfaces, за да го промените по следния шаблон:

# 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

Където:

INTERFACE_NAME трябва да бъде заменено с името на получения преди това мрежов интерфейс.
MAC_ADDRESS трябва да бъде заменено с получения преди това MAC адрес.
IP_GW трябва да бъде заменено с IP адреса на сървъра.
NETMASK трябва да бъде заменено с мрежовата маска, свързана с IP адреса.
NETWORK_GATEWAY трябва да бъде заменено с мрежовия шлюз по подразбиране.
IP_DNS трябва да бъде заменено с IP адреса на DNS сървъра. Ако трябва да се конфигурират няколко сървъра (най-много 3), разделете ги с интервал.
DNS_SUFFIX трябва да бъде заменено с DNS суфикса, който да се използва. Ако не е необходимо да се въвежда суфикс, изтрийте реда.

Пример

# 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

Преди да приложите конфигурацията, трябва да изпълните още три стъпки.

Първата е да инсталирате пакетите resolvconf и bridge-utils, за да може да се приложи DNS конфигурацията, зададена в предишния файл, и да се използва интерфейсът br0:

apt install -y resolvconf bridge-utils

Втората е да проверите конфигурацията на файла /etc/hosts по отношение на основния IP адрес на компютъра (IP_GW).
За да направите това, редактирайте файла /etc/hosts и проверете дали вторият ред е в следния формат:

2	`IP_GW FQDN MACHINE_NAME`

Пример

Ако компютърът се казва EDGE-GATEWAY, без да е член на домейн, а IP адресът му IP_GW е 172.16.10.10, файлът ще бъде попълнен по следния начин:

2	`172.16.10.10 EDGE-GATEWAY`

Ако компютърът е член на домейна DOMAIN.LOCAL, файлът ще бъде попълнен по следния начин:

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

Внимание!

Неправилна конфигурация на файла може да доведе до грешка при инсталирането на пакета collectd.

Остава само да рестартирате сървъра:

reboot

Конфигуриране на мениджъра на пакети APT¶

Качете файловете, изтеглени от Systancia Marketplace, в директорията /tmp/ на сървъра с помощта на SCP клиент:

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

Влезте в сървъра като root, след което изпълнете следните команди, за да разархивирате хранилището на Systancia, да конфигурирате използването му в APT и да го удостоверите.

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

Силно препоръчваме да деактивирате инсталирането на ненужни пакети при изпълнение на командите apt. За целта изпълнете следната команда:

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

Инсталиране на сървъра Edge Gateway на CyberElements Bastion¶

Инсталиране на основните компоненти¶

Започнете инсталирането на компонентите със следната команда като root:

apt install -y ipdiva-base

След изтеглянето на всички зависимости ще се отвори прозорец, в който трябва да изберете типа на сървъра. Изберете gateway:

Какво да направя, ако възникне грешка?

Ако във въведената информация има грешка, продължете инсталирането на пакета ipdiva-base и след това използвайте следната команда, за да конфигурирате отново сървъра:

1	`dpkg-reconfigure ipdiva-base`

Инсталиране на компонентите на Edge Gateway¶

След това стартирайте инсталирането на специфичните за Edge Gateway компоненти със следната команда:

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

Компонентите на сървъра Edge Gateway вече са инсталирани. Остава само да рестартирате компютъра, за да могат новоинсталираните компоненти да се инициализират:

reboot

Инсталиране на компонентите на HTML5 Gateway¶

Използвайте следната команда, за да започнете инсталирането на компонентите на HTML5 Gateway на сървъра Edge Gateway:

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

Използвайте следните командни редове, за да активирате и конфигурирате функциите за прехвърляне на файлове и виртуален принтер:

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

Конфигурация¶

Конфигурации преди свързване на HTML5 Gateway¶

За да работят HTML5 приложенията, трябва да се конфигурират допълнителни настройки на сървъра Mediation Controller. Влезте в сървъра Mediation Controller като root.

Създайте или променете файла /etc/ipdiva/httpd/commonParameters.extra.conf, за да добавите секция, еквивалентна на следната:

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

Където:

URL_HTML5 трябва да бъде заменен със съдържанието на полето URL на HTML5 Gateway, конфигуриран в административната конзола при генерирането на маркера за сдвояване.
GW_NAME трябва да бъде заменено с името на компонент Edge Gateway, разположен на същия сървър като HTML5 Gateway. Символът | в края на реда трябва да бъде запазен.
ORGANIZATION_NAME трябва да бъде заменено с името на организацията, с която се свързва горепосоченият компонент Edge Gateway.

Пример

За платформа със следните настройки:

Име на организацията: my-organization-name
Деклариране на HTML5 Gateway в административната конзола:
- Име: html5-gateway
- URL: HTML5
- Protocol: WebSocket
Сървър Edge Gateway има:
- Услуга Edge Gateway с име edge-gateway
- Услуга HTML5 Gateway с име html5-gateway

Създаденият конфигурационен файл /etc/ipdiva/httpd/commonParameters.extra.conf ще бъде настроен по следния начин:

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

Преди да приложите новите настройки, трябва да проверите дали новата конфигурация не предизвиква блокиращи грешки за уеб сървъра Apache2.
За да направите това, изпълнете следната команда:

1	`apache2ctl configtest`

Ако отговорът е Syntax OK, промените могат да бъдат приложени с командата по-долу. В противен случай проверете конфигурацията си във файла /etc/ipdiva/httpd/commonParameters.extra.conf.

1	`systemctl reload apache2`

Свързване на Edge Gateway и HTML5 Gateway¶

Внимание!

Ако за компонента SSL Router използвате сертификати, издадени от сертифициращ орган (CA), различен от този на Systancia, трябва да добавите главния CA към доверените CA на Edge Gateway: добавете главния CA на SSL Router към доверените CA за връзката на Edge Gateway или HTML5 Gateway.

За да конфигурирате екземплярите на Edge Gateway и HTML5 Gateway на сървъра, следвайте информацията, предоставена в следната документация: Сдвояване на сървъра