Ga naar inhoud

Installatie van de Mediation Controller-server

Opmerking

Ter herinnering: het overschakelen naar root moet op Debian-machines met de volgende opdracht gebeuren:

1
su -

De mirror en de nodige hulpmiddelen downloaden

De mirror van CyberElements Cleanroom 4.6 en de ondertekeningssleutel van het Systancia-repository kunnen via deze link worden gedownload (vereist het aanmaken van een klantaccount): Systancia Marketplace

Naast de mirror en de sleutel zijn er voor de upgrade hulpmiddelen van derden nodig:

  • Een SSH-client (op Windows kunt u PuTTY gebruiken)
  • Een SCP-client (op Windows kunnen de hulpmiddelen WinSCP of FileZilla worden gebruikt)

Gebruik de SSH-client om op afstand verbinding te maken met uw server.

Gebruik de SCP-client om bestanden naar uw externe machine over te brengen.

De installatie voorbereiden

Configuratie van het netwerk

Het is noodzakelijk een statisch netwerkadres voor de Mediation Controller te configureren. Daarvoor moet eerst de naam van de netwerkinterface van uw machine worden opgehaald. Voer de volgende opdracht uit als root:

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

Deze opdracht geeft de naam van de netwerkinterface, de status ervan en de aan de interface toegewezen IP-adressen weer.

Voorbeeld

Na de uitvoering van de opdracht wordt de volgende uitvoer weergegeven:

1
ens192           UP             10.0.10.10/24

De naam van de netwerkinterface is ens192.

Zodra de naam van de netwerkinterface is verkregen, is het nu mogelijk de netwerkconfiguratie van de machine te bewerken.
Bewerk het bestand /etc/network/interfaces om het volgens het volgende model te wijzigen:

 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

Hierbij geldt:

  • INTERFACE_NAME moet worden vervangen door de eerder opgehaalde naam van de netwerkinterface.
  • IP_MED_WEB moet worden vervangen door het hoofd-IP-adres van de server; dat is het IP-adres waarmee de webconsoles bereikbaar zijn.
  • NETMASK moet worden vervangen door het netwerkmasker dat bij het IP-adres hoort.
  • NETWORK_GATEWAY moet worden vervangen door de standaardgateway van het netwerk.
  • IP_DNS moet worden vervangen door het IP-adres van de DNS-server. Als er meerdere servers moeten worden geconfigureerd (maximaal 3), scheidt u ze met een spatie.
  • DNS_SUFFIX moet worden vervangen door het te gebruiken DNS-suffix. Als er geen suffix hoeft te worden opgegeven, verwijdert u de regel.
  • IP_MED_SSL moet worden vervangen door het secundaire IP-adres van de server. Dat is het IP-adres waarmee de SSL Router bereikbaar is.
Voorbeeld 
 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

Voordat de configuratie wordt toegepast, moeten er nog drie stappen worden afgerond.

De eerste bestaat erin het pakket resolvconf te installeren zodat de in het vorige bestand opgegeven DNS-configuratie kan worden toegepast:

1
apt install -y resolvconf

De tweede bestaat erin de configuratie van het bestand /etc/hosts te controleren wat betreft het hoofd-IP-adres van de machine (IP_MED_WEB).
Bewerk daarvoor het bestand /etc/hosts en controleer of de tweede regel de volgende indeling heeft:

2
IP_MED_WEB  FQDN    MACHINE_NAME
Voorbeeld

Als de machine MEDIATION-CONTROLLER heet zonder tot een domein te behoren en haar IP-adres IP_MED_WEB 10.0.10.10 is, moet het bestand als volgt worden aangevuld:

2
10.0.10.10  MEDIATION-CONTROLLER

Als de machine tot het domein DOMAIN.LOCAL behoort, moet het bestand als volgt worden aangevuld:

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

Waarschuwing!

Een onjuiste configuratie van het bestand kan een fout veroorzaken bij de installatie van het pakket collectd.

Ten slotte hoeft alleen nog de service networking opnieuw te worden gestart om de nieuwe netwerkconfiguratie te laden: 

1
systemctl restart networking

De pakketbeheerder APT configureren

Upload de van de Systancia Marketplace gedownloade bestanden met een SCP-client naar de map /tmp/ van de server:

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

Meld u als root aan op de server en voer vervolgens de volgende opdrachten uit om het Systancia-repository uit te pakken, het gebruik ervan in APT te configureren en het te authenticeren.

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

Wij raden sterk aan de installatie van onnodige pakketten uit te schakelen bij het uitvoeren van apt-opdrachten. Voer daarvoor de volgende opdracht uit:

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

Controleren of de locale en_US.utf8 aanwezig is

Voor de installatie van de Mediation Controller-server moeten de locales en_US.utf8 worden gegenereerd.
Voer de volgende opdracht uit als root om te controleren of ze al op de server zijn gegenereerd: 

1
locale -a  | grep en_US.utf8

Als het antwoord van de opdracht en_US.utf8 weergeeft, gaat u naar de volgende stap, de configuratie van GRUB.
Voer anders de volgende opdrachten uit om deze locale aan de machine toe te voegen:

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

Configuratie van het opstartprogramma GRUB

Zodra deze opdrachten zijn uitgevoerd, moet u de machine opnieuw starten nadat u een instelling in het opstartprogramma GRUB hebt toegepast:

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

Installatie van de Mediation Controller-server van CyberElements Bastion

Installatie van de basiscomponenten

Start de installatie van de componenten met de volgende opdracht als root:

1
apt install -y ipdiva-base

Nadat alle afhankelijkheden zijn gedownload, wordt er een venster geopend waarin u het type server moet selecteren. Selecteer mediation:

Selecteer vervolgens de installatiemodus standalone:

Vervolgens moet u de poort opgeven waarop de SSL Router luistert. Die luisterpoort is doorgaans 443, maar poort 8443 kan ook worden gebruikt als de Mediation Controller slechts één IP-adres gebruikt:

Voer vervolgens het webtoegangsadres van de Mediation Controller-server in (komt overeen met IP_MED_WEB in de netwerkconfiguratie):

Voer tot slot het IP-adres van de SSL Router in (komt overeen met IP_MED_SSL in de netwerkconfiguratie):

Wat te doen bij een fout?

Als er een fout in de ingevoerde informatie is gemaakt, zet u de installatie van het pakket ipdiva-base voort en gebruikt u vervolgens de volgende opdracht om de server opnieuw te configureren:

1
dpkg-reconfigure ipdiva-base

Installatie van de specifieke componenten

Start de installatie van de componenten die specifiek zijn voor de Mediation Controller-server met de volgende opdracht:

1
apt install -y ipdiva-safe-server

De server moet opnieuw worden gestart om de installatie te voltooien (gebruik de opdracht reboot).

Installatie van de stuurprogramma's voor de verbinding met Microsoft SQL Server-databases

Als u verbinding wilt maken met een externe database en dit een Microsoft SQL Server is, moeten er aanvullende ODBC-stuurprogramma's worden geïnstalleerd.

Er zijn twee versies beschikbaar: versie 17 en versie 18.

TLS-verbinding vereist voor de stuurprogramma's in versie 18

Voor het gebruik van de ODBC 18-stuurprogramma's moet de verbinding met TLS zijn versleuteld. Daarvoor moet u MS SQL Server configureren voor de versleuteling van de verbindingen.

Voordat u met de installatie van de ODBC-stuurprogramma's begint, moet u de voor de voorbereiding benodigde pakketten installeren en vervolgens het Microsoft-repository voor de installatie van de pakketten voorbereiden:

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

Installeer vervolgens de stuurprogramma's volgens de gekozen versie en configureer het systeem voor het gebruik van de opdracht 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

De ODBC-stuurprogramma's zijn nu correct geïnstalleerd.
Als de Mediation Controller-server toegang heeft tot een MS SQL-server, moet de volgende opdracht de verbinding met de externe server mogelijk maken: 

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

Hierbij geldt:

  • SERVER moet worden vervangen door de DNS-naam of het IP-adres van de MS SQL-server.
  • INSTANCE_NAME moet worden vervangen door de naam van de instantie waarmee verbinding moet worden gemaakt; als dat niet nodig is, verwijdert u ook het teken \.
  • PORT moet worden vervangen door de verbindingspoort naar de MS SQL-database-instantie.
  • USER moet worden vervangen door de gebruikersnaam waarmee de verbinding tot stand wordt gebracht.
Voorbeelden

Als de Mediation Controller-server via het IP-adres 10.0.10.100 toegang heeft tot een MS SQL-databaseserver, de betreffende instantie op de poort 1433 luistert en het toegangsaccount sql-user is. Dan luidt de verbindingsopdracht als volgt:

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

Als de verbindingsinstantie met de naam MSSQLINSTANCE moest worden opgegeven, zou de opdracht als volgt worden gewijzigd:

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

Een NTP-tijdserver configureren

Het is raadzaam een tijdserver in te stellen om de systeemklok actueel te houden. De vereiste stappen worden beschreven op de pagina over de NTP-configuratie.

Eerste configuraties in CyberElements Bastion

De componenten van de Mediation Controller-server zijn geïnstalleerd. Nu moet de Mediation Controller worden geconfigureerd.

  • De standaardwachtwoorden wijzigen

    Wijzig de standaardwachtwoorden van de systeemconsoles.

    Wijzigen

  • Installatie van de certificaten en licenties

    De Mediation Controller heeft verschillende certificaten en een licentie nodig om operationeel te zijn.

    De certificaten en de licentie installeren

  • Configuratie van de certificeringsinstanties

    Voeg de certificeringsinstantie of -instanties (CA) toe die niet tot Systancia behoren en die zullen worden gebruikt voor de certificaten van de Edge Gateways en HTML5 Gateways.

    Vertrouwde CA's configureren

  • Het webcertificaat configureren

    Configureer het webcertificaat dat wordt gebruikt om verbinding te maken met de webinterfaces

    Configureren

  • Een DNS-naam declareren

    Voeg een DNS-naam toe die gemachtigd is om verbinding te maken met de webinterfaces.

    Toevoegen

  • De virtuele SSL-host configureren

    Configuratie van de virtuele SSL-host van CyberElements Bastion, waarmee het verbindingsadres naar de SSL Router voor de clients en voor het pairing-mechanisme van de Edge Gateways kan worden opgegeven.

    Configureren

  • De organisatie configureren

    Configuratie van de organisatie van CyberElements Bastion.

    Configureren

  • De Edge Gateways declareren

    Declareer de Edge Gateways of HTML5 Gateways die moeten worden geïnstalleerd en genereer een pairing-token.

    Pairing-tokens aanmaken

  • Een logische site aanmaken

    Maak een logische site aan die de Edge Gateways en HTML5 Gateways samenbrengt die toegang hebben tot de lokale resources, en configureer die.

    Een site aanmaken

  • Een Edge Gateway installeren

    Installeer en configureer een nieuwe Edge Gateway met de nieuw geïnstalleerde Mediation Controller-server.
    Er wordt ook een HTML5 Gateway-instantie geconfigureerd.

    Installeren