Към съдържанието

Инсталиране на сървъра Mediation Controller

Забележка

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

1
su -

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

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

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

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

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

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

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

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

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

1
ip -br a | grep -ve "^lo"

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

Пример

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

1
ens192           UP             10.0.10.10/24

Името на мрежовия интерфейс е ens192.

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

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
# 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 INTERFACE_NAME
iface INTERFACE_NAME inet static
    address IP_MED_WEB
    netmask NETMASK
    gateway NETWORK_GATEWAY
    dns-nameservers IP_DNS_1 IP_DNS_2
    dns-search DNS_SUFFIX

# The secondary network interface
auto INTERFACE_NAME:1
iface INTERFACE_NAME:1 inet static
    address IP_MED_SSL
    netmask NETMASK

Където:

  • INTERFACE_NAME трябва да бъде заменено с името на получения преди това мрежов интерфейс.
  • IP_MED_WEB трябва да бъде заменено с основния IP адрес на сървъра, чрез който ще бъдат достъпни уеб конзолите.
  • NETMASK трябва да бъде заменено с мрежовата маска, свързана с IP адреса.
  • NETWORK_GATEWAY трябва да бъде заменено с мрежовия шлюз по подразбиране.
  • IP_DNS трябва да бъде заменено с IP адреса на DNS сървъра. Ако трябва да се конфигурират няколко сървъра (най-много 3), разделете ги с интервал.
  • DNS_SUFFIX трябва да бъде заменено с DNS суфикса, който да се използва. Ако не е необходимо да се въвежда суфикс, изтрийте реда.
  • IP_MED_SSL трябва да бъде заменено с вторичния IP адрес на сървъра. Това ще бъде IP адресът, чрез който ще бъде достъпен компонентът SSL Router.
Пример 
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
# 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 eth0
iface eth0 inet static
    address 10.0.10.10
    netmask 255.255.255.0
    gateway 10.0.10.254
    dns-nameservers 10.0.10.100 10.0.10.101
    dns-search domain.local

# The secondary network interface
auto eth0:1
iface eth0:1 inet static
    address 10.0.10.11
    netmask 255.255.255.0

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

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

1
apt install -y resolvconf

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

2
IP_MED_WEB  FQDN    MACHINE_NAME
Пример

Ако компютърът се казва MEDIATION-CONTROLLER, без да е член на домейн, а IP адресът му IP_MED_WEB е 10.0.10.10, файлът ще бъде попълнен по следния начин:

2
10.0.10.10  MEDIATION-CONTROLLER

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

2
10.0.10.10  MEDIATION-CONTROLLER.DOMAIN.LOCAL   MEDIATION-CONTROLLER

Внимание!

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

Накрая остава само да рестартирате услугата networking, за да се зареди новата мрежова конфигурация: 

1
systemctl restart networking

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

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

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

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

1
2
3
4
5
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. За целта изпълнете следната команда:

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

Проверка за наличие на локала en_US.utf8

Инсталирането на сървъра Mediation Controller изисква генериране на локалите en_US.utf8.
За да проверите дали те вече са генерирани на сървъра, изпълнете следната команда като root: 

1
locale -a  | grep en_US.utf8

Ако отговорът на командата показва en_US.utf8, преминете към следващата стъпка от конфигурирането на GRUB.
В противен случай изпълнете следните команди, за да добавите този локал към компютъра:

1
2
sed -i "s/# en_US.UTF-8 UTF-8/en_US.UTF-8 UTF-8/" /etc/locale.gen
locale-gen

Конфигуриране на програмата за начално зареждане GRUB

След като тези команди бъдат изпълнени, трябва да рестартирате компютъра, след като приложите настройка в програмата за начално зареждане GRUB:

1
2
3
sed '9s/quiet/quiet vsyscall=emulate/' -i /etc/default/grub
update-grub
reboot

Инсталиране на сървъра Mediation Controller на CyberElements Bastion

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

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

1
apt install -y ipdiva-base

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

След това изберете режима на инсталиране standalone:

След това ще трябва да въведете порта, на който ще слуша компонентът SSL Router. Този порт за слушане обикновено е 443, но може да се използва и портът 8443, ако сървърът Mediation използва само един IP адрес:

След това въведете адреса за уеб достъп до сървъра Mediation Controller (съответства на IP_MED_WEB в мрежовата конфигурация):

Накрая въведете IP адреса на SSL рутера (съответства на IP_MED_SSL в мрежовата конфигурация):

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

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

1
dpkg-reconfigure ipdiva-base

Инсталиране на специфични компоненти

Започнете инсталирането на компонентите, специфични за сървъра Mediation Controller, със следната команда:

1
apt install -y ipdiva-safe-server

Сървърът трябва да бъде рестартиран, за да завърши инсталирането (използвайте командата reboot).

Инсталиране на драйвери за свързване с бази данни на Microsoft SQL Server

Ако искате да се свържете с външна база данни и тя е Microsoft SQL Server, трябва да бъдат инсталирани допълнителни ODBC драйвери.

Налични са две версии: версия 17 и версия 18.

За драйверите във версия 18 е необходима TLS връзка

Използването на драйвери ODBC 18 изисква връзката да бъде шифрована с TLS. За да направите това, трябва да конфигурирате MS SQL Server за шифроване на връзките.

Преди да започнете инсталирането на ODBC драйверите, трябва да инсталирате необходимите пакети за подготовка и след това да подготвите хранилището на Microsoft за инсталирането на пакетите:

1
2
3
4
apt install -y curl apt-transport-https gpg
curl -fsSL https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor -o /usr/share/keyrings/microsoft-prod.gpg
curl https://packages.microsoft.com/config/debian/12/prod.list > /etc/apt/sources.list.d/mssql-release.list
apt update

След това инсталирайте драйверите според избраната версия и конфигурирайте системата да използва командата sqlcmd:

1
2
3
ACCEPT_EULA=Y apt install -y msodbcsql17 mssql-tools python3-pip
pip install mssql-scripter --break-system-packages
ln -sfn /opt/mssql-tools/bin/sqlcmd /usr/bin/sqlcmd

1
2
3
ACCEPT_EULA=Y apt install -y msodbcsql18 mssql-tools18 python3-pip
pip install mssql-scripter --break-system-packages
ln -sfn /opt/mssql-tools18/bin/sqlcmd /usr/bin/sqlcmd

ODBC драйверите вече са инсталирани правилно.
Ако сървърът Mediation Controller има достъп до MS SQL сървър, следната команда би трябвало да позволи свързването с отдалечения сървър: 

1
sqlcmd -S SERVER\INSTANCE_NAME,PORT -U USER

Където:

  • SERVER трябва да бъде заменено с DNS името или IP адреса на MS SQL сървъра.
  • INSTANCE_NAME трябва да бъде заменено с името на екземпляра, с който да се свържете; ако не е необходимо, премахнете и символа \.
  • PORT трябва да бъде заменено с порта за връзка с екземпляра на базата данни MS SQL.
  • USER трябва да бъде заменено с потребителското име за установяване на връзката.
Примери

Ако сървърът Mediation Controller има достъп до сървър за бази данни MS SQL чрез IP адреса 10.0.10.100, екземплярът, до който трябва да се осъществи достъп, слуша на порт 1433, а акаунтът за достъп е sql-user. Тогава командата за свързване е следната:

1
sqlcmd -S 10.0.10.100,1433 -U sql-user

Ако трябваше да се посочи екземплярът за връзка с име MSSQLINSTANCE, командата щеше да бъде променена по следния начин:

1
sqlcmd -S 10.0.10.100\MSSQLINSTANCE,1433 -U sql-user

Конфигуриране на NTP сървър за време

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

Първоначални конфигурации в CyberElements Bastion

Компонентите на сървъра Mediation Controller са инсталирани. Сега трябва да конфигурирате Mediation Controller.

  • Променете паролите по подразбиране

    Променете паролите по подразбиране за системните конзоли.

    Променете

  • Инсталиране на сертификати и лицензи

    Сървърът Mediation Controller изисква различни сертификати и лиценз, за да работи.

    Инсталирайте сертификатите и лиценза

  • Конфигуриране на сертифициращи органи

    Добавете сертифициращия орган (CA) или органите, които не принадлежат на Systancia и които ще се използват за сертификатите на Edge Gateway и HTML5 Gateway.

    Конфигурирайте доверените CA

  • Конфигурирайте уеб сертификата

    Конфигурирайте уеб сертификата, използван за свързване с уеб интерфейсите

    Конфигуриране

  • Декларирайте DNS име

    Добавете DNS име, на което е разрешено да се свързва с уеб интерфейсите.

    Добавяне

  • Конфигурирайте виртуалния SSL хост

    Конфигуриране на виртуалния SSL хост на CyberElements Bastion, което позволява да се зададе адресът за свързване към SSL рутера за клиентите и за механизма за сдвояване на Edge Gateway.

    Конфигурирайте

  • Конфигурирайте организацията

    Конфигуриране на организацията на CyberElements Bastion.

    Конфигурирайте

  • Декларирайте сървърите Edge Gateway

    Декларирайте сървърите Edge Gateway или HTML5 Gateway, които трябва да бъдат инсталирани, и генерирайте маркер за сдвояване.

    Създайте маркери за сдвояване

  • Създайте логически сайт

    Създайте и конфигурирайте логически сайт, който групира сървърите Edge Gateway и HTML5 Gateway с достъп до локалните ресурси.

    Създаване на сайт

  • Инсталирайте Edge Gateway

    Инсталирайте и конфигурирайте нов Edge Gateway с новоинсталирания сървър Mediation Controller.
    Ще бъде конфигуриран и екземпляр на HTML5 Gateway.

    Инсталирайте