> Source: https://docs.cyberelements.io/bastion/4.6/nl/Installation/Standalone/FromScratch/InstallMediationController/

# Installatie van de Mediation Controller-server

> **Opmerking**
>
> Ter herinnering: het overschakelen naar `root` moet op Debian-machines met de volgende opdracht gebeuren:
>
> ```
> 1
> ```

## 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](https://www.systancia.com/my-systancia/marketplace/systancia-cleanroom/telechargements-cleanroom/)

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

- Een SSH-client (op Windows kunt u [PuTTY](https://putty.org/) gebruiken)
- Een SCP-client (op Windows kunnen de hulpmiddelen [WinSCP](https://winscp.net/eng/index.php) of [FileZilla](https://filezilla-project.org/) 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
```

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

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

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

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

> **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
> ```
>
> Als de machine tot het domein `DOMAIN.LOCAL` behoort, moet het bestand als volgt worden aangevuld:
>
> ```
> 2
> ```

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

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

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

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

Als het antwoord van de opdracht `en_US.utf8` weergeeft, [gaat u naar de volgende stap, de configuratie van GRUB](#configuring-the-grub-boot-program).
Voer anders de volgende opdrachten uit om deze locale aan de machine toe te voegen:

```
1
2
```

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

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

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

![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/InstallCLRScratchStandalone-TypeServeur.png)

Selecteer vervolgens de installatiemodus `standalone`:

![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/InstallCLRScratchStandalone-ModeInstall.png)

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:

![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/InstallCLRScratchStandalone-PortSSL.png)

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

![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/InstallCLRScratchStandalone-AdresseHTTPS.png)

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

![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/InstallCLRScratchStandalone-AdresseSSL.png)

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

### Installatie van de specifieke componenten

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

```
1
```

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](https://learn.microsoft.com/en-us/sql/database-engine/configure-windows/configure-sql-server-encryption?view=sql-server-ver16).

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

Installeer vervolgens de stuurprogramma's volgens de gekozen versie en configureer het systeem voor het gebruik van de opdracht `sqlcmd`:

**ODBC-stuurprogramma's versie 17**

> ```
> 1
> 2
> 3
> ```

**ODBC-stuurprogramma's versie 18**

> ```
> 1
> 2
> 3
> ```

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

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
> ```
>
> Als de verbindingsinstantie met de naam `MSSQLINSTANCE` moest worden opgegeven, zou de opdracht als volgt worden gewijzigd:
>
> ```
> 1
> ```

## 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](https://docs.cyberelements.io/bastion/4.6/nl/Usage/Configuration/MediationController/ConfigureAnNTPServer/).

## Eerste configuraties in CyberElements Bastion

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

- (1) De standaardwachtwoorden wijzigen

  ---

  Wijzig de standaardwachtwoorden van de systeemconsoles.

  [→ Wijzigen](https://docs.cyberelements.io/bastion/4.6/nl/Usage/Configuration/SystemConsole/ChangePassword/)
- (2) 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](https://docs.cyberelements.io/bastion/4.6/nl/Usage/Configuration/SystemConsole/ApplyCertificatesAndLicence/)
- (3) 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](https://docs.cyberelements.io/bastion/4.6/nl/Usage/Configuration/SystemConsole/AddANewTrustedCA/)
- (4) Het webcertificaat configureren

  ---

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

  [→ Configureren](https://docs.cyberelements.io/bastion/4.6/nl/Usage/Configuration/SystemConsole/ApplyWebCertificate/)
- (5) Een DNS-naam declareren

  ---

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

  [→ Toevoegen](https://docs.cyberelements.io/bastion/4.6/nl/Usage/Configuration/SystemConsole/AddAllowedDNSName/)
- (6) 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](https://docs.cyberelements.io/bastion/4.6/nl/Usage/Configuration/SystemConsole/ConfigureVirtualhostSSL/)
- (7) De organisatie configureren

  ---

  Configuratie van de organisatie van CyberElements Bastion.

  [→ Configureren](https://docs.cyberelements.io/bastion/4.6/nl/Usage/Configuration/SystemConsole/AddOrganization/)
- (8) De Edge Gateways declareren

  ---

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

  [→ Pairing-tokens aanmaken](https://docs.cyberelements.io/bastion/4.6/nl/Usage/Configuration/AdminConsole/CreatePairingTokenForEdgeGateway/)
- (9) 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](https://docs.cyberelements.io/bastion/4.6/nl/Usage/Configuration/AdminConsole/CreateSite/)
- (10) 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](https://docs.cyberelements.io/bastion/4.6/nl/Installation/Standalone/FromScratch/InstallEdgeGateway/)
