> Source: https://docs.cyberelements.io/bastion/4.6/nl/Installation/Cluster/FromAppliances/InstallMediationController/

# Installatie van de Mediation Controller-servers

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

De instructies op deze pagina moeten op beide Mediation Controller-servers worden uitgevoerd, te beginnen met de server `MASTER`.
Wanneer er verschillen bestaan tussen de servers `MASTER` en `SLAVE`, worden die aangegeven. Als er niets wordt vermeld, gelden de instructies zowel voor de server `MASTER` als voor de server `SLAVE`.

## Systeeminstellingen

### Verbinding met de machine

Op de virtuele appliances bestaan er standaard twee accounts: een gebruikersaccount en een superuseraccount.

- **Gebruikersaccount**
    - Login: `systancia`
    - Wachtwoord: `systnci`
- **Superuseraccount**
    - Login: `root`
    - Wachtwoord: `systnci`

Maak in consolemodus verbinding met de machine.

> **Opmerking**
>
> De standaardtoetsenbordindeling is QWERTY.

### De toetsenbordindeling wijzigen

U kunt de toetsenbordindeling wijzigen met de volgende opdrachtregel:

```
1
```

Er verschijnt een menu waarin u een andere toetsenbordindeling kunt kiezen.

Gebruik vervolgens de volgende opdrachtregel om de instellingen toe te passen en op te slaan:

```
1
```

De instellingen worden onmiddellijk na het uitvoeren van deze opdracht van kracht.

### Configuratie van het netwerk

**Mediation Controller-server MASTER**

> 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.
> - `RIP_MED_WEB_MASTER` moet worden vervangen door het reële 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.
> - `RIP_MED_SSL_MASTER` moet worden vervangen door het reële 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
> > ```
>
> Ten slotte hoeft alleen nog de service `networking` opnieuw te worden gestart om de nieuwe netwerkconfiguratie te laden:
>
> ```
> 1
> ```

**Mediation Controller-server SLAVE**

> 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.
> - `RIP_MED_WEB_SLAVE` moet worden vervangen door het reële 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.
> - `RIP_MED_SSL_SLAVE` moet worden vervangen door het reële 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
> > ```
>
> Ten slotte hoeft alleen nog de service `networking` opnieuw te worden gestart om de nieuwe netwerkconfiguratie te laden:
>
> ```
> 1
> ```

> **Tip**
>
> Nu de netwerkconfiguratie is toegepast, is de server via SSH bereikbaar.

### De wachtwoorden van de lokale accounts wijzigen

CyberElements raadt sterk aan het wachtwoord van deze accounts te wijzigen zodra de virtuele appliance is geïmplementeerd.

Gebruik de volgende opdracht en voer het nieuwe wachtwoord voor het standaardaccount `systancia` in:

```
1
```

Herhaal de bewerking vervolgens voor het superuseraccount `root`:

```
1
```

### De naam van de machine configureren

U kunt de naam van de server wijzigen door de bestanden hostname en hosts van de server te configureren.

Bewerk het bestand `/etc/hostname` om de naam van de machine op te geven.
Het product heeft de nieuwe naam op een andere plaats nodig; daarom moet met de volgende opdracht een kopie van het vorige bestand worden gemaakt:

```
1
```

**Mediation Controller-server MASTER**

> De configuratie van het bestand `/etc/hosts` moet worden overgenomen in verhouding tot het werkelijke primaire IP-adres van de machine (`RIP_MED_WEB_MASTER`).
> Bewerk daarvoor het bestand `/etc/hosts` en controleer of de tweede regel de volgende indeling heeft:
>
> ```
> 2
> ```
>
> > **Voorbeeld**
> >
> > Als de machine `MEDIATION-CONTROLLER-MASTER` heet zonder tot een domein te behoren en haar werkelijke IP-adres `RIP_MED_WEB_MASTER` `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
> > ```

**Mediation Controller-server SLAVE**

> De configuratie van het bestand `/etc/hosts` moet worden overgenomen in verhouding tot het werkelijke primaire IP-adres van de machine (`RIP_MED_WEB_SLAVE`).
> Bewerk daarvoor het bestand `/etc/hosts` en controleer of de tweede regel de volgende indeling heeft:
>
> ```
> 2
> ```
>
> > **Voorbeeld**
> >
> > Als de machine `MEDIATION-CONTROLLER-SLAVE` heet zonder tot een domein te behoren en haar werkelijke IP-adres `RIP_MED_WEB_SLAVE` `10.0.10.12` 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
> > ```

Start de server opnieuw op om de nieuwe configuratie toe te passen:

```
1
```

### Wijziging van de tijdzone

De virtuele appliance is standaard ingesteld op de tijdzone `Europe/Paris`.

Haal, om deze tijdzone te wijzigen, eerst met de volgende opdracht de schrijfwijze van de beschikbare tijdzones op:

```
1
```

Gebruik vervolgens de volgende opdrachtregel:

```
1
```

> **Voorbeeld**
>
> Om de tijdzone op Londen in te stellen, moet de volgende opdracht worden uitgevoerd:
>
> ```
> 1
> ```

Controleer de tijdzone van de server met de volgende opdrachtregel:

```
1
```

## De Mediation Controller-server initialiseren

### De Mediation Controller-server initialiseren

De Mediation Controller-server wordt geïnitialiseerd met een configuratiescript. Dit script configureert de IP-adressen van de cluster opnieuw in de verschillende services van het product en configureert de instellingen die nodig zijn voor de werking van een HTML5 Gateway vooraf.
Voer het uit met de volgende opdrachtregel als `root`:

```
1
```

Het script vraagt u de volgende informatie in te voeren:

- `IP VIP HTTPS`: virtueel web-IP-adres van de cluster, dat wil zeggen `VIP_MED_WEB`.
- `IP VIP SSL`: virtueel SSL-IP-adres van de cluster, dat wil zeggen `VIP_MED_SSL`.
- `IP VIP ZIO`: virtueel IP-adres voor de verbinding van de Mediation Controller-server `SLAVE` met de interne configuratiedatabase van de server `MASTER`, dat wil zeggen `VIP_MED_ZEO`.
- `IP Master HTTPS`: het werkelijke web-IP-adres van de Mediation Controller-server `MASTER`, dat wil zeggen `RIP_MED_WEB_MASTER`.
- `IP Master SSL`: het werkelijke IP-adres van de SSL Router van de Mediation Controller-server `MASTER`, dat wil zeggen `RIP_MED_SSL_MASTER`.
- `IP Slave HTTPS`: het werkelijke web-IP-adres van de Mediation Controller-server `SLAVE`, dat wil zeggen `RIP_MED_WEB_SLAVE`.
- `IP Slave SSL`: het werkelijke IP-adres van de SSL Router van de Mediation Controller-server `SLAVE`, dat wil zeggen `RIP_MED_SSL_SLAVE`.
- `HTML5 port`: lokale luisterpoort voor het omleiden van de toegang tot de HTML5 Gateway-service; wij raden aan poort `1234` op te geven.
- `Gateway`: naam van de Edge Gateway; geef de naam van de eerste Edge Gateway op.
- `Organization`: naam van de organisatie waarmee de Edge Gateways en HTML5 Gateways verbinding maken.

Start de server opnieuw op nadat de initialisatie is voltooid:

```
1
```

### Het wachtwoord van de console `/mediation/system` van CyberElements Gate wijzigen

In deze fase van de installatie is een nieuwe beheerinterface beschikbaar: [Wachtwoord wijzigen](https://docs.cyberelements.io/bastion/4.6/nl/Usage/Configuration/SystemConsole/ChangePassword/#modification-on-the-cyberelements-gate-system-console)

### De licenties en certificaten toepassen

Nog steeds in de console `/mediation/system` moet u de certificaten en licenties van de Mediation Controller-server invoeren.

> **Waarschuwing!**
>
> De licentie en het certificaat van de SSL Router zijn specifiek voor de Mediation Controller-server `MASTER` of `SLAVE`.
> Het configureren van een verkeerde licentie of een verkeerd certificaat veroorzaakt later storingen.

Pas de licentie en het certificaat van de component SSL Router toe: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/CLR_GateSystem_ApplyCertAndLicForSSLRouter.png)

1. Klik op het tabblad `Settings`.
2. Selecteer `SSL Connections` in het menu.
3. Zoek het certificaat van de SSL Router.
4. Voer het wachtwoord van het certificaat van de SSL Router in.
5. Klik op `Apply` om het certificaat op de SSL Router toe te passen.
6. Selecteer het licentiebestand van de server.
7. Klik op `Modify` om de licentie van de server toe te passen.

Voer vervolgens de informatie van het certificaat van de CyberElements Bastion-client in: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/CLR_GateSystem_ApplyPluginCert.png)

1. Selecteer het tabblad `Plugin`.
2. Zoek het certificaat van de CyberElements Bastion-client.
3. Voer het wachtwoord van het certificaat in.
4. Klik op `Apply` om het certificaat toe te passen.

Nu moet nog de informatie van het Watchdog-certificaat worden ingevoerd: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/CLR_GateSystem_ApplyWatchdogCert.png)

1. Selecteer het tabblad `Watchdog`
2. Zoek het Watchdog-certificaat.
3. Voer het wachtwoord van het certificaat in.
4. Klik op `Apply` om het certificaat toe te passen.

Om deze wijzigingen van kracht te laten worden, moet u de SSL Router en de Watchdog opnieuw starten: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/CLR_GateSystem_RestartServices.png)

### Pairing van de Mediation Controller-servers

> **Waarschuwing!**
>
> Op dit punt moeten beide Mediation Controller-servers zijn geconfigureerd tot en met het [toepassen van de licenties en de certificaten](#applying-licenses-and-certificates).
> Als de Mediation Controller-server `SLAVE` nog niet is geconfigureerd, doe dat dan door [aan het begin van deze documentatie](#installation-of-mediation-controller-servers) te beginnen.

De stap van de pairing van de Mediation Controller-servers zorgt voor een vertrouwensrelatie tussen de twee servers en initialiseert de werking in Cluster.

**Op de Mediation Controller-server `SLAVE`**

Voer de volgende opdracht uit als `root` om een pairing-aanvraag naar de Mediation Controller-server `MASTER` te sturen:

```
1
```

Vervang `RIP_MED_WEB_MASTER` door het overeenkomstige IP-adres.

> **Voorbeeld**
>
> Als `RIP_MED_WEB_MASTER` gelijk is aan `10.0.10.10`, luidt de in te voeren opdracht als volgt:
>
> ```
> 1
> ```

**Op de Mediation Controller-server `MASTER`**

Voer de volgende opdracht uit als `root` om de openstaande pairing-aanvragen te bekijken en de identificatie van de aanvraag op te halen:

```
1
```

Voer vervolgens de volgende opdracht uit om de pairing-aanvraag te aanvaarden en vervang daarbij `ID` door de met de vorige opdracht opgehaalde identificatie:

```
1
```

> **Voorbeeld**
>
> Als het resultaat van de opdracht `hostManagerCtl getPendingRequests` als volgt luidt:
>
> ```
> 1
> 2
> 3
> ```
>
> Dan luidt de opdracht om de pairing-aanvraag te aanvaarden als volgt:
>
> ```
> 1
> ```

Gebruik de volgende opdracht op de Mediation Controller-server (`MASTER` of `SLAVE`) om de koppeling te controleren:

```
1
```

Het resultaat verschilt naargelang de server waarop de opdracht wordt uitgevoerd:

**Mediation Controller-server MASTER**

> Het verwachte resultaat op de Mediation Controller-server `MASTER` luidt als volgt:
>
> ```
> 1
> ```
>
> > **Voorbeeld**
> >
> > ```
> > 1
> > ```

**Mediation Controller-server SLAVE**

> Het verwachte resultaat op de Mediation Controller-server `SLAVE` luidt als volgt:
>
> ```
> 1
> ```
>
> > **Voorbeeld**
> >
> > ```
> > 1
> > ```

**Op de Mediation Controller-server `SLAVE`**

U kunt de status van de bootstrap vanaf de server `SLAVE` met de volgende opdracht controleren:

```
1
```

Een Cluster zonder synchronisatieproblemen geeft de waarde `0` terug.

Er is nog een laatste reeks opdrachten nodig, opnieuw op de server `SLAVE`, om een tussen beide Mediation Controllers gedeeld geheim te synchroniseren:

```
1
2
```

### Activering van de interserververbinding

> **Waarvoor dient de interserververbinding?**
>
> Het gaat om een bijzondere verbinding van de werking in Cluster, waarmee een Mediation Controller-server het verkeer naar een andere Mediation Controller-server kan routeren wanneer de doel-Edge Gateway niet met de eerste server, maar alleen met de tweede is verbonden.
>
> Als de Mediation Controller-server `MASTER` bijvoorbeeld niet langer met de Edge Gateway is verbonden, kan hij de interserververbinding gebruiken om haar via de Mediation Controller-server `SLAVE` te bereiken.
>
> ```mermaid
> flowchart LR
>     MASTER(Mediation Controller<br/>MASTER) --x |Verbinding verbroken| GW(Edge Gateway)
>     MASTER --> |Verbinding tussen servers| SLAVE(Mediation Controller<br/>SLAVE) --> GW
> ```

**Op de Mediation Controller-server `MASTER`**

Bewerk het bestand `/etc/ipdiva/server/remoteServers.xml` om de CN van het interservercertificaat op te geven:

```
1
2
3
4
5
6
7
8
9
```

Vervang `SLAVECN` door de CN van het certificaat dat voor de interserververbinding is bestemd.
Als u de CN van het interservercertificaat niet kent, kan het teken `*` worden ingevoerd (aanbevolen in geval van twijfel):

```
1
2
3
4
5
6
7
8
9
```

> **Voorbeeld**
>
> Rekening houdend met de volgende informatie:
>
> - CN van het interservercertificaat: `my-interserver-cert`
>
> Het bestand `/etc/ipdiva/server/remoteServers.xml` van de Mediation Controller-server `MASTER` moet als volgt worden aangevuld:
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> 8
> 9
> ```
>
> > **Volledig bestand**
> >
> > ```
> >  1
> >  2
> >  3
> >  4
> >  5
> >  6
> >  7
> >  8
> >  9
> > 10
> > 11
> > 12
> > 13
> > 14
> > 15
> > 16
> > 17
> > 18
> > 19
> > 20
> > 21
> > 22
> > 23
> > 24
> > 25
> > 26
> > 27
> > 28
> > 29
> > 30
> > 31
> > 32
> > 33
> > 34
> > 35
> > 36
> > 37
> > 38
> > 39
> > 40
> > 41
> > 42
> > 43
> > 44
> > 45
> > 46
> > 47
> > 48
> > 49
> > 50
> > 51
> > 52
> > 53
> > 54
> > 55
> > 56
> > 57
> > 58
> > 59
> > 60
> > 61
> > ```

**Op de Mediation Controller-server `SLAVE`**

Stuur het interservercertificaat naar de Mediation Controller `SLAVE`, in de map `/tmp/`.
Voer vervolgens de volgende opdrachten uit als `root` om het met de juiste machtigingen naar de doelmap te verplaatsen:

```
1
2
3
```

Bewerk vervolgens het bestand `/etc/ipdiva/server/remoteServers.xml` om de volgende inhoud aan de tag `<remoteConfig>` toe te voegen (de oude tag `<localCluster>` kan volledig worden verwijderd):

```
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
```

Vervang:

- `MASTERCN`: geef de CN op van het certificaat van de SSL Router van de Mediation Controller `MASTER`; dat is doorgaans `RIP_MED_SSL_MASTER`.
- `RIP_MED_SSL_MASTER`: komt overeen met het secundaire IP-adres van de Mediation Controller `MASTER`.
- `PORT_RIP_MED_SSL_MASTER`: dit is de poort waarop de SSL Router van de Mediation Controller `MASTER` luistert; doorgaans is dat `443`.
- `INTERSERVER.P12`: naam van het certificaat dat voor de interserver is bestemd.
- `PASSWORD`: wachtwoord van het interservercertificaat.

> **Voorbeeld**
>
> Rekening houdend met de volgende informatie:
>
> - Naam van het interservercertificaat: `my-interserver-cert.p12`
> - Wachtwoord van het interservercertificaat: `MySecurePassword`
> - RIP SSL van de Mediation Controller `MASTER`: `10.0.10.11`
> - Poort op de RIP SSL van de Mediation Controller `MASTER`: `443`
> - CN van het certificaat van de Mediation Controller `MASTER`: `10.0.10.11`
>
> Het bestand `/etc/ipdiva/server/remoteServers.xml` van de Mediation Controller-server `SLAVE` moet als volgt worden aangevuld:
>
> ```
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> ```
>
> > **Volledig bestand**
> >
> > ```
> >  1
> >  2
> >  3
> >  4
> >  5
> >  6
> >  7
> >  8
> >  9
> > 10
> > 11
> > 12
> > 13
> > 14
> > 15
> > 16
> > 17
> > 18
> > 19
> > 20
> > 21
> > 22
> > 23
> > 24
> > 25
> > 26
> > 27
> > 28
> > 29
> > 30
> > 31
> > 32
> > 33
> > 34
> > 35
> > 36
> > 37
> > 38
> > 39
> > 40
> > 41
> > 42
> > 43
> > 44
> > 45
> > 46
> > 47
> > 48
> > 49
> > 50
> > ```

Wijzig de configuratie van de SSL Router `SLAVE` door de volgende opdracht uit te voeren:

```
1
```

**Op de Mediation Controller-servers `MASTER` en `SLAVE`**

Start de SSL Router opnieuw om de configuratie van de interserververbinding toe te passen:

```
1
```

Om te bevestigen dat de interserververbinding correct werkt, moet de volgende opdracht een resultaat teruggeven:

```
1
```

De vorige opdracht moet een log opleveren die het volgende bevat: `TRACE Router.floodWithLocalInfos sent 0 peer(s), 0 foreignPeers, and 0 multicast group(s)`.
Als er geen dergelijke log wordt weergegeven, controleer dan de configuratie die [in dit hoofdstuk](#activation-of-the-interserver-link) is uitgevoerd.

**In de webconsole `/mediation/system` van de Mediation Controller `MASTER`**

Schakel de interserververbinding tussen de twee Mediation Controllers in door de virtuele SSL-host `default` te bewerken: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/CLR_GateSystem_EditDefaultVHostSSL.png)

Vul de verschillende velden in aan de hand van de onderstaande aanwijzingen en schakel de functie voor de interserververbinding in door het selectievakje `Is cross-server linking configured?` aan te vinken: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/CLR_GateSystem_EditDefaultVHostSSL_Configuration.png)

- `Public address for plugin connections`: komt overeen met `VIP_MED_SSL`, gevolgd door de luisterpoort ervan (doorgaans `443`).
- `Actual public IP addresses for web connections`: komt overeen met het paar reële web-IP-adressen (`RIP_MED_WEB_MASTER` en `RIP_MED_WEB_SLAVE`) met de bijbehorende poorten, één regel per paar IP-adres en poort.
- `Actual public IP addresses for SSL connections`: komt overeen met het paar reële SSL-IP-adressen (`RIP_MED_SSL_MASTER` en `RIP_MED_SSL_SLAVE`) met de bijbehorende poorten, één regel per paar IP-adres en poort.

## CyberElements Bastion initialiseren

### Verbinding met de PostgreSQL-database

Om te functioneren heeft CyberElements Bastion een externe PostgreSQL-database (DB) nodig om de configuratie en de verschillende logs van de console `/system` op te slaan.
Als de DB direct bereikbaar is vanaf de Mediation Controller-servers, ga dan direct naar de [stap voor de initialisatie van de DB](#initializing-the-database).

#### Verbinding met een database in het LAN

Om verbinding met een database in het LAN mogelijk te maken zonder een stroom van de DMZ naar het LAN te openen, wordt de stroom van de database omgeleid via een TLS-tunnel tussen de Edge Gateways en de Mediation Controllers.
Daarvoor moet één Edge Gateway (of twee Edge Gateways) worden geconfigureerd met de onderliggende CyberElements Gate-technologie.

##### Declaratie van de CyberElements Gate Edge Gateways

Meld u daarvoor eerst aan bij de console `/mediation/system` van CyberElements Gate.

Ga vervolgens naar het menu ”Organizations” en klik op ”Add”: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/CLR_GateSystem_AddOrganization.png)

Voer de naam van de organisatie in, die moet verschillen van de naam die aan CyberElements Bastion is toegekend (bijvoorbeeld `tunnel`), en geef ten minste één gebruikerssessielicentie op, samen met het wachtwoord van het account `admin`: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/CLR_GateSystem_AddOrganization_Configuration.png)

Meld u met het account `admin` aan bij de beheerinterface van de eerder aangemaakte organisatie door naar `/gate/admin` te gaan: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/CLR_GateAdmin_Authentication.png)

Declareer vervolgens de twee Edge Gateways die voor het opzetten van de tunnel worden gebruikt.
Beweeg links de cursor over `Infrastructure`, klik op `Gateways` en vervolgens op de knop `Add`: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/CLR_GateAdmin_AddGateway.png)

Voer de naam van de eerste Edge Gateway in en bevestig de invoer: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/CLR_GateAdmin_AddGateway_Configuration.png)

> **Informatie**
>
> Ter herinnering: de naam van een Edge Gateway is verbonden met het certificaat dat zij gebruikt om zich bij de SSL Router van de Mediation Controller te authenticeren.
> Deze naam heeft de volgende vorm `<GW_NAME>@<ORGANIZATION_NAME>`, waarbij `<GW_NAME>` overeenkomt met de naam van de Edge Gateway en `<ORGANIZATION_NAME>` met de naam van de organisatie die in de systeemconsole van CyberElements Gate is aangemaakt.

Herhaal de stap van de declaratie van de Edge Gateway voor de tweede Edge Gateway.

##### Verbindingen en configuratie van de tunnel op de Edge Gateways

> **Informatie**
>
> De volgende stappen kunnen op beide Edge Gateways worden uitgevoerd die voor de tunnel naar de database worden gebruikt.

> **Voorwaarden**
>
> Om dit deel af te ronden, moet u een van de volgende twee mogelijkheden gebruiken:
>
> - [Een virtuele Edge Gateway-appliance](https://docs.cyberelements.io/bastion/4.6/nl/Installation/Cluster/FromAppliances/InstallEdgeGateway/#initial-system-settings) waarop alleen de initialisatie van het systeem is uitgevoerd.
> - [Een van de grond af geïnstalleerde Edge Gateway](https://docs.cyberelements.io/bastion/4.6/nl/Installation/Cluster/FromScratch/InstallEdgeGateway/) met de Edge Gateway-componenten geïnstalleerd.

Gebruik eerst een hulpmiddel zoals [WinSCP](https://winscp.net/eng/index.php) of [FileZilla](https://filezilla-project.org/) om het voor de verbinding vereiste certificaat via SCP naar de map `/tmp/` van de Edge Gateway over te brengen.

Maak vervolgens verbinding via SSH en schakel over naar `root`.

Om de Edge Gateway met beide Mediation Controllers te verbinden, moeten er twee nieuwe Edge Gateway-instanties worden aangemaakt: de ene maakt verbinding met de Mediation Controller `MASTER`, de andere met de Mediation Controller `SLAVE`.
Voer de volgende opdrachten uit om ze aan te maken:

```
1
2
```

Kopieer het certificaatbestand naar de mappen `/etc/ipdiva/gateway-tunnel-master/ssl/` en `/etc/ipdiva/gateway-tunnel-slave/ssl/`:

```
1
2
```

Vervang `<CERT_NAME>` door de naam van het certificaat dat de Edge Gateway moet gebruiken om verbinding te maken met de Mediation Controller.

Configureer de Edge Gateway-instanties zo dat zij verbinding kunnen maken met de Mediation Controllers.
De configuraties verschillen naargelang de Mediation Controller die moet worden gecontacteerd. Voer beide configuraties uit:

**Verbinding met de Mediation Controller MASTER**

> Bewerk het bestand `/etc/ipdiva/gateway-tunnel-master/gateway.xml` en vul het aan met de volgende informatie (verschillende secties zijn weggelaten en worden aangeduid met `[…]`):
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> ```
>
> Vervang de volgende elementen:
>
> - `@SERVER@`: moet worden vervangen door het adres `RIP_MED_SSL_MASTER`
> - `@SERVERPORT@`: moet worden vervangen door de luisterpoort van de SSL Router, normaal gezien `443`
> - `keyfile.pem`: moet worden vervangen door de naam van het certificaatbestand
> - `PASSWORD`: moet worden vervangen door het wachtwoord van het certificaat
> - `@RPC_PORT@`: moet worden vervangen door een poort waarop de machine momenteel niet luistert; de poort `9082` kan worden gebruikt
>
> > **Voorbeeld**
> >
> > Rekening houdend met de volgende informatie:
> >
> > - `RIP_MED_SSL_MASTER` is gelijk aan: `10.0.10.11`
> > - Luisterpoort van de SSL Router: `443`
> > - Naam van het certificaatbestand: `gate-tunnel.p12`
> > - Wachtwoord van het certificaat: `Str0ngP@ssw0rd`
> >
> > Het bestand `/etc/ipdiva/gateway-tunnel-master/gateway.xml` moet als volgt worden geconfigureerd:
> >
> > ```
> >  1
> >  2
> >  3
> >  4
> >  5
> >  6
> >  7
> >  8
> >  9
> > 10
> > 11
> > 12
> > ```
> >
> > > **Volledig bestand**
> > >
> > > ```
> > >  1
> > >  2
> > >  3
> > >  4
> > >  5
> > >  6
> > >  7
> > >  8
> > >  9
> > > 10
> > > 11
> > > 12
> > > 13
> > > 14
> > > 15
> > > 16
> > > 17
> > > 18
> > > 19
> > > 20
> > > 21
> > > 22
> > > 23
> > > 24
> > > 25
> > > 26
> > > 27
> > > 28
> > > 29
> > > 30
> > > 31
> > > 32
> > > 33
> > > 34
> > > 35
> > > 36
> > > 37
> > > 38
> > > 39
> > > 40
> > > 41
> > > 42
> > > 43
> > > 44
> > > 45
> > > 46
> > > 47
> > > 48
> > > 49
> > > 50
> > > 51
> > > 52
> > > 53
> > > 54
> > > 55
> > > 56
> > > 57
> > > 58
> > > 59
> > > 60
> > > 61
> > > 62
> > > 63
> > > 64
> > > 65
> > > 66
> > > 67
> > > 68
> > > 69
> > > 70
> > > 71
> > > 72
> > > 73
> > > 74
> > > 75
> > > 76
> > > 77
> > > 78
> > > 79
> > > 80
> > > 81
> > > ```

**Verbinding met de Mediation Controller SLAVE**

> Bewerk het bestand `/etc/ipdiva/gateway-tunnel-slave/gateway.xml` en vul het aan met de volgende informatie (verschillende secties zijn weggelaten en worden aangeduid met `[…]`):
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> ```
>
> Vervang de volgende elementen:
>
> - `@SERVER@`: moet worden vervangen door het adres `RIP_MED_SSL_SLAVE`
> - `@SERVERPORT@`: moet worden vervangen door de luisterpoort van de SSL Router, normaal gezien `443`
> - `keyfile.pem`: moet worden vervangen door de naam van het certificaatbestand
> - `PASSWORD`: moet worden vervangen door het wachtwoord van het certificaat
> - `@RPC_PORT@`: moet worden vervangen door een poort die momenteel niet op de machine in gebruik is; de poort `9083` kan worden gebruikt
>
> > **Voorbeeld**
> >
> > Rekening houdend met de volgende informatie:
> >
> > - `RIP_MED_SSL_SLAVE` is gelijk aan: `10.0.10.13`
> > - Luisterpoort van de SSL Router: `443`
> > - Naam van het certificaatbestand: `gate-tunnel.p12`
> > - Wachtwoord van het certificaat: `Str0ngP@ssw0rd`
> >
> > Het bestand `/etc/ipdiva/gateway-tunnel-slave/gateway.xml` moet als volgt worden geconfigureerd:
> >
> > ```
> >  1
> >  2
> >  3
> >  4
> >  5
> >  6
> >  7
> >  8
> >  9
> > 10
> > 11
> > 12
> > ```
> >
> > > **Volledig bestand**
> > >
> > > ```
> > >  1
> > >  2
> > >  3
> > >  4
> > >  5
> > >  6
> > >  7
> > >  8
> > >  9
> > > 10
> > > 11
> > > 12
> > > 13
> > > 14
> > > 15
> > > 16
> > > 17
> > > 18
> > > 19
> > > 20
> > > 21
> > > 22
> > > 23
> > > 24
> > > 25
> > > 26
> > > 27
> > > 28
> > > 29
> > > 30
> > > 31
> > > 32
> > > 33
> > > 34
> > > 35
> > > 36
> > > 37
> > > 38
> > > 39
> > > 40
> > > 41
> > > 42
> > > 43
> > > 44
> > > 45
> > > 46
> > > 47
> > > 48
> > > 49
> > > 50
> > > 51
> > > 52
> > > 53
> > > 54
> > > 55
> > > 56
> > > 57
> > > 58
> > > 59
> > > 60
> > > 61
> > > 62
> > > 63
> > > 64
> > > 65
> > > 66
> > > 67
> > > 68
> > > 69
> > > 70
> > > 71
> > > 72
> > > 73
> > > 74
> > > 75
> > > 76
> > > 77
> > > 78
> > > 79
> > > 80
> > > 81
> > > ```

Nu de instanties zijn geconfigureerd om verbinding te maken met de Mediation Controllers, moeten zij nog zo worden geconfigureerd dat zij de verbinding van de Mediation Controller naar de database omleiden.
Bewerk daarvoor het bestand `/etc/ipdiva/gateway-tunnel-master/services.xml` en wijzig het als volgt:

```
1
2
3
4
5
6
7
8
9
```

Vervang `DB_SERVER` door de DNS-naam of het IP-adres dat voor de verbinding met de database wordt gebruikt, en `DB_PORT` door de luisterpoort van de database-instantie.
Neem deze configuratie over voor de instantie die verbinding maakt met de Mediation Controller-server `SLAVE` door het bestand te kopiëren:

```
1
```

Start ten slotte de Edge Gateway-instanties zodat zij de verbinding met de Mediation Controllers tot stand brengen:

```
1
2
```

##### De tunnel op de Mediation Controllers configureren

Om de tunnel door de Mediation Controllers te laten gebruiken, moet het bestaan ervan nog worden gedeclareerd.
Meld u daarvoor als `root` aan bij de Mediation Controllers en bewerk het bestand `/etc/ipdiva/server/services.xml` om de volgende sectie toe te voegen (verschillende secties zijn weggelaten en worden aangeduid met `[…]`):

```
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
```

Vervang de volgende elementen:

- `GW1_NAME` door de naam van de eerste Edge Gateway
- `GW2_NAME` door de naam van de tweede Edge Gateway
- `ORGANIZATION_NAME` door de naam van de eerder aangemaakte organisatie CyberElements Gate

> **Voorbeeld**
>
> Rekening houdend met de volgende informatie:
>
> - Naam van Edge Gateway 1: `gate-tunnel-1`
> - Naam van Edge Gateway 2: `gate-tunnel-2`
> - Naam van de organisatie CyberElements Gate: `tunnel`
>
> Het bestand `/etc/ipdiva/server/services.xml` moet als volgt worden aangevuld:
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> ```
>
> > **Volledig bestand**
> >
> > ```
> >  1
> >  2
> >  3
> >  4
> >  5
> >  6
> >  7
> >  8
> >  9
> > 10
> > 11
> > 12
> > 13
> > 14
> > 15
> > 16
> > 17
> > 18
> > 19
> > 20
> > 21
> > 22
> > 23
> > 24
> > 25
> > 26
> > 27
> > 28
> > 29
> > 30
> > 31
> > 32
> > 33
> > 34
> > 35
> > 36
> > ```

Start de SSL Router met de volgende opdracht opnieuw om de nieuwe configuratie toe te passen:

```
1
```

#### De database initialiseren

> **Waarschuwing!**
>
> U moet de database `default` aanmaken voordat CyberElements Bastion deze initialiseert (zij wordt niet automatisch aangemaakt).

Om de PostgreSQL-database van de systeemconfiguratie te initialiseren, moeten eerst de verbindingsparameters op de Mediation Controllers worden geconfigureerd.
Bewerk daarvoor het bestand `/etc/ipdiva/care/databasesettings.ini` op beide servers en voeg de volgende vermeldingen toe:

```
2
3
4
5
6
7
8
9
```

Vervang de volgende elementen:

- `DB_USERNAME` door de gebruikersnaam die voor de verbinding met de database wordt gebruikt.
- `DB_PWD` door het wachtwoord van de gebruiker die verbinding maakt.
- `DB_HOST` door het IP-adres of de DNS-naam die voor de verbinding met de database wordt gebruikt; als er een verbinding via Edge Gateways wordt gebruikt, moet `127.0.0.1` worden ingevoerd.
- `DB_PORT` door de poort die voor de verbinding met de database-instantie wordt gebruikt; als er een verbinding via Edge Gateways wordt gebruikt, moet `1432` worden ingevoerd.

De initialisatie van de database kan met de volgende opdrachten worden gestart, **die op slechts één Mediation Controller mogen worden uitgevoerd**:

```
1
2
```

Daarna hoeft alleen nog de service apache2 **op beide Mediation Controllers** opnieuw te worden gestart om de initialisatie van de systeemdatabase toe te passen:

```
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 van CyberElements Bastion

### Toegang tot de webinterfaces met het virtuele IP-adres toestaan

Standaard is het niet toegestaan met het virtuele IP `VIP_MED_WEB` verbinding te maken met de webinterfaces van het product CyberElements Bastion.
Voer als `root` de volgende opdrachten uit op de Mediation Controllers om de autorisatie toe te voegen:

```
1
2
```

Vervang `IP` door het IP-adres dat overeenkomt met `VIP_MED_WEB`.

### Eerste configuraties

In deze fase zijn de Mediation Controller-servers geïnstalleerd, maar er moeten nog verschillende acties worden uitgevoerd:

- (1) De standaardwachtwoorden wijzigen

  ---

  Wijzig de standaardwachtwoorden van de systeemconsoles.

  [→ Wijzigen](https://docs.cyberelements.io/bastion/4.6/nl/Usage/Configuration/SystemConsole/ChangePassword/)
- (2) De certificaten en licenties installeren

  ---

  De Mediation Controller heeft verschillende certificaten en een licentie nodig om operationeel te zijn.
  Alleen het certificaat van de CyberElements Bastion-client moet op beide Mediation Controllers opnieuw worden gedeclareerd (gebruik de RIP `RIP_MED_WEB_MASTER` en `RIP_MED_WEB_SLAVE`).

  [→ De certificaten en de licentie installeren](https://docs.cyberelements.io/bastion/4.6/nl/Usage/Configuration/SystemConsole/ApplyCertificatesAndLicence/)
- (3) 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/)
- (4) 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/)

- (5) De organisatie configureren

  ---

  Configureer de organisatie van CyberElements Bastion.

  [→ Configureren met directe toegang tot de database](https://docs.cyberelements.io/bastion/4.6/nl/Usage/Configuration/SystemConsole/AddOrganization/#__tabbed_1_2)

  [→ Configureren met toegang tot de database via de tunnel van de Edge Gateways](https://docs.cyberelements.io/bastion/4.6/nl/Usage/Configuration/SystemConsole/AddOrganization/#__tabbed_1_3)
- (6) De Edge Gateways declareren

  ---

  Declareer de te installeren Edge Gateways of HTML5 Gateways.

  [→ Edge Gateways aanmaken](https://docs.cyberelements.io/bastion/4.6/nl/Usage/Configuration/AdminConsole/CreateEdgeGateway/)
- (7) 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/)
- (8) Een Edge Gateway installeren

  ---

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

  [→ Installeren](https://docs.cyberelements.io/bastion/4.6/nl/Installation/Cluster/FromAppliances/InstallEdgeGateway/)
