Preskočiť na obsah

Inštalácia servera Mediation Controller

Poznámka

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

1
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

Pre server Mediation Controller je nevyhnutné nakonfigurovať statickú sieťovú adresu. Ak to chcete urobiť, najprv musíte zistiť názov sieťového rozhrania vášho počítača. Spustite nasledujúci príkaz ako root:

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

Tento príkaz zobrazí názov sieťového rozhrania, jeho stav a IP adresy priradené k rozhraniu.

Príklad

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

1
ens192           UP             10.0.10.10/24

Názov sieťového rozhrania je ens192.

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

 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

Kde:

  • INTERFACE_NAME je potrebné nahradiť názvom predtým zisteného sieťového rozhrania.
  • IP_MED_WEB je potrebné nahradiť hlavnou IP adresou servera, cez ktorú budú dostupné webové konzoly.
  • 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.
  • IP_MED_SSL je potrebné nahradiť sekundárnou IP adresou servera. Cez túto IP adresu bude dostupný komponent SSL Router.
Príklad 
 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

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

Prvým je inštalácia balíka resolvconf, aby bolo možné použiť konfiguráciu DNS zadanú v predchádzajúcom súbore:

1
apt install -y resolvconf

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

2
IP_MED_WEB  FQDN    MACHINE_NAME
Príklad

Ak má počítač názov MEDIATION-CONTROLLER, nepatrí do domény a jeho IP adresa IP_MED_WEB je 10.0.10.10, súbor by sa vyplnil takto:

2
10.0.10.10  MEDIATION-CONTROLLER

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

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

Pozor!

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

Nakoniec zostáva už len reštartovať službu networking, aby sa načítala nová sieťová konfigurácia: 

1
systemctl restart networking

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.

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

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:

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

Kontrola prítomnosti miestneho nastavenia en_US.utf8

Inštalácia servera Mediation Controller vyžaduje vygenerovanie miestnych nastavení en_US.utf8.
Ak chcete skontrolovať, či už boli na serveri vygenerované, spustite ako root nasledujúci príkaz: 

1
locale -a  | grep en_US.utf8

Ak odpoveď príkazu zobrazí en_US.utf8, prejdite na ďalší krok, konfiguráciu zavádzača GRUB.
V opačnom prípade spustite nasledujúce príkazy, ktorými toto miestne nastavenie pridáte do počítača:

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

Konfigurácia zavádzacieho programu GRUB

Po vykonaní týchto príkazov musíte po použití nastavenia v zavádzacom programe GRUB reštartovať počítač:

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

Inštalácia servera Mediation Controller produktu CyberElements Bastion

Inštalácia základných komponentov

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

1
apt install -y ipdiva-base

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

Potom vyberte režim inštalácie standalone:

Potom budete musieť zadať port, na ktorom bude načúvať SSL Router. Tento port načúvania je zvyčajne nastavený na 443, ale ak server Mediation Controller používa len jednu adresu IP, možno použiť aj port 8443:

Potom zadajte adresu webového prístupu k serveru Mediation Controller (zodpovedá IP_MED_WEB v konfigurácii siete):

Nakoniec zadajte IP adresu komponentu SSL Router (zodpovedá IP_MED_SSL v konfigurácii siete):

Č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 špecifických komponentov

Spustite inštaláciu komponentov špecifických pre server Mediation Controller nasledujúcim príkazom:

1
apt install -y ipdiva-safe-server

Na dokončenie inštalácie je potrebné server reštartovať (použite príkaz reboot).

Inštalácia ovládačov na pripojenie k databázam Microsoft SQL Server

Ak sa chcete pripojiť k externej databáze a ide o Microsoft SQL Server, je potrebné nainštalovať ďalšie ovládače ODBC.

K dispozícii sú dve verzie: verzia 17 a verzia 18.

Pre ovládače vo verzii 18 sa vyžaduje pripojenie TLS

Používanie ovládačov ODBC 18 vyžaduje, aby bolo pripojenie šifrované pomocou TLS. Ak to chcete urobiť, musíte nakonfigurovať MS SQL Server na šifrovanie pripojenia.

Pred spustením inštalácie ovládačov ODBC musíte nainštalovať balíky potrebné na prípravu a potom pripraviť úložisko Microsoft na inštaláciu balíkov:

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

Potom nainštalujte ovládače podľa zvolenej verzie a nakonfigurujte systém na používanie príkazu 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

Ovládače ODBC sú teraz správne nainštalované.
Ak má server Mediation Controller prístup k serveru MS SQL, nasledujúci príkaz by mal umožniť pripojenie k vzdialenému serveru: 

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

Kde:

  • SERVER je potrebné nahradiť názvom DNS alebo IP adresou servera MS SQL.
  • INSTANCE_NAME je potrebné nahradiť názvom inštancie, ku ktorej sa treba pripojiť; ak to nie je potrebné, odstráňte aj znak \.
  • PORT je potrebné nahradiť portom pripojenia k inštancii databázy MS SQL.
  • USER je potrebné nahradiť menom používateľa na nadviazanie pripojenia.
Príklady

Ak má server Mediation Controller prístup k databázovému serveru MS SQL cez IP adresu 10.0.10.100, inštancia, ku ktorej sa má pristupovať, počúva na porte 1433 a prístupový účet je sql-user. Potom je príkaz na pripojenie nasledujúci:

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

Ak by bolo potrebné zadať inštanciu pripojenia s názvom MSSQLINSTANCE, príkaz by sa upravil takto:

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

Konfigurácia časového servera NTP

Odporúča sa nastaviť časový server, aby boli systémové hodiny aktuálne. Potrebné kroky sú opísané na stránke konfigurácie NTP.

Počiatočné konfigurácie v CyberElements Bastion

Komponenty servera Mediation Controller sú nainštalované. Teraz je potrebné nakonfigurovať server Mediation Controller.

  • Zmeňte predvolené heslá

    Zmeňte predvolené heslá systémových konzol.

    Zmeniť

  • Inštalácia certifikátov a licencií

    Server Mediation Controller vyžaduje na prevádzku rôzne certifikáty a licenciu.

    Nainštalovať certifikáty a licenciu

  • Konfigurácia certifikačných autorít

    Pridajte certifikačnú autoritu (CA) alebo autority, ktoré nepatria spoločnosti Systancia a ktoré sa budú používať pre certifikáty komponentov Edge Gateway a HTML5 Gateway.

    Nakonfigurovať dôveryhodné CA

  • Nakonfigurujte webový certifikát

    Nakonfigurujte webový certifikát používaný na pripojenie k webovým rozhraniam

    Nakonfigurovať

  • Deklarujte názov DNS

    Pridajte názov DNS autorizovaný na pripojenie k webovým rozhraniam.

    Pridať

  • Nakonfigurujte virtuálneho hostiteľa SSL

    Konfigurácia virtuálneho hostiteľa SSL platformy CyberElements Bastion, ktorá umožňuje určiť adresu na pripojenie ku komponentu SSL Router pre klientov a pre mechanizmus pairingu komponentu Edge Gateway.

    Nakonfigurovať

  • Nakonfigurujte organizáciu

    Konfigurácia organizácie CyberElements Bastion.

    Nakonfigurovať

  • Deklarujte komponenty Edge Gateway

    Deklarujte komponenty Edge Gateway alebo HTML5 Gateway, ktoré sa majú nainštalovať, a vygenerujte token pairingu.

    Vytvoriť tokeny pairingu

  • Vytvorte logický site

    Vytvorte a nakonfigurujte logický site, ktorý zoskupuje komponenty Edge Gateway a HTML5 Gateway s prístupom k lokálnym prostriedkom.

    Vytvoriť site

  • Nainštalujte Edge Gateway

    Nainštalujte a nakonfigurujte nový komponent Edge Gateway s novo nainštalovaným serverom Mediation Controller.
    Nakonfiguruje sa aj inštancia HTML5 Gateway.

    Nainštalujte