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

# Installation der Mediation-Controller-Server

> **Hinweis**
>
> Zur Erinnerung: Der Wechsel zu `root` muss auf Debian-Maschinen mit dem folgenden Befehl erfolgen:
>
> ```
> 1
> ```

Die Anweisungen auf dieser Seite sind auf beiden Mediation-Controller-Servern auszuführen, beginnend mit dem Server `MASTER`.
Wenn es Unterschiede zwischen den Servern `MASTER` und `SLAVE` gibt, werden diese hervorgehoben. Wird nichts erwähnt, gelten die Anweisungen sowohl für den Server `MASTER` als auch für den Server `SLAVE`.

## Systemkonfiguration

### Verbindung mit der Maschine

Auf den virtuellen Appliances gibt es standardmäßig zwei Konten: ein Benutzerkonto und ein Superuser-Konto.

- **Benutzerkonto**
    - Anmeldung: `systancia`
    - Passwort: `systnci`
- **Superuser-Konto**
    - Anmeldung: `root`
    - Passwort: `systnci`

Verbinden Sie sich im Konsolenmodus mit der Maschine.

> **Hinweis**
>
> Die Standard-Tastaturbelegung ist QWERTY.

### Ändern der Tastaturbelegung

Sie können die Tastaturbelegung mit der folgenden Befehlszeile ändern:

```
1
```

Es erscheint ein Menü, in dem Sie eine andere Tastaturbelegung auswählen können.

Verwenden Sie anschließend die folgende Befehlszeile, um die Einstellungen anzuwenden und zu speichern:

```
1
```

Die Einstellungen werden unmittelbar nach der Ausführung dieses Befehls wirksam.

### Konfiguration des Netzwerks

**Mediation-Controller-Server MASTER**

> Es ist unbedingt erforderlich, für den Mediation Controller eine statische Netzwerkadresse zu konfigurieren. Dazu muss zunächst der Name der Netzwerkschnittstelle Ihrer Maschine ermittelt werden. Führen Sie den folgenden Befehl als `root` aus:
>
> ```
> 1
> ```
>
> Dieser Befehl zeigt den Namen der Netzwerkschnittstelle, ihren Status und die der Schnittstelle zugewiesenen IP-Adressen an.
>
> > **Beispiel**
> >
> > Nach der Ausführung des Befehls wird die folgende Ausgabe angezeigt:
> >
> > ```
> > 1
> > ```
> >
> > Der Name der Netzwerkschnittstelle ist `ens192`.
>
> Sobald der Name der Netzwerkschnittstelle ermittelt ist, kann die Netzwerkkonfiguration der Maschine bearbeitet werden.
> Bearbeiten Sie die Datei `/etc/network/interfaces`, um sie nach der folgenden Vorlage zu ändern:
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> 18
> 19
> 20
> 21
> 22
> 23
> ```
>
> Dabei gilt:
>
> - `INTERFACE_NAME` muss durch den zuvor ermittelten Namen der Netzwerkschnittstelle ersetzt werden.
> - `RIP_MED_WEB_MASTER` muss durch die reale Haupt-IP-Adresse des Servers ersetzt werden; über diese IP-Adresse sind die Webkonsolen erreichbar.
> - `NETMASK` muss durch die zur IP-Adresse gehörende Netzmaske ersetzt werden.
> - `NETWORK_GATEWAY` muss durch das Standard-Gateway des Netzwerks ersetzt werden.
> - `IP_DNS` muss durch die IP-Adresse des DNS-Servers ersetzt werden. Wenn mehrere Server konfiguriert werden müssen (maximal 3), trennen Sie sie durch ein Leerzeichen.
> - `DNS_SUFFIX` muss durch das zu verwendende DNS-Suffix ersetzt werden. Wenn kein Suffix angegeben werden muss, löschen Sie die Zeile.
> - `RIP_MED_SSL_MASTER` muss durch die reale sekundäre IP-Adresse des Servers ersetzt werden. Über diese IP-Adresse ist der SSL Router erreichbar.
>
> > **Beispiel**
> >
> > ```
> >  1
> >  2
> >  3
> >  4
> >  5
> >  6
> >  7
> >  8
> >  9
> > 10
> > 11
> > 12
> > 13
> > 14
> > 15
> > 16
> > 17
> > 18
> > 19
> > 20
> > 21
> > 22
> > 23
> > ```
>
> Schließlich muss nur noch der Dienst `networking` neu gestartet werden, damit die neue Netzwerkkonfiguration geladen wird:
>
> ```
> 1
> ```

**Mediation-Controller-Server SLAVE**

> Es ist unbedingt erforderlich, für den Mediation Controller eine statische Netzwerkadresse zu konfigurieren. Dazu muss zunächst der Name der Netzwerkschnittstelle Ihrer Maschine ermittelt werden. Führen Sie den folgenden Befehl als `root` aus:
>
> ```
> 1
> ```
>
> Dieser Befehl zeigt den Namen der Netzwerkschnittstelle, ihren Status und die der Schnittstelle zugewiesenen IP-Adressen an.
>
> > **Beispiel**
> >
> > Nach der Ausführung des Befehls wird die folgende Ausgabe angezeigt:
> >
> > ```
> > 1
> > ```
> >
> > Der Name der Netzwerkschnittstelle ist `ens192`.
>
> Sobald der Name der Netzwerkschnittstelle ermittelt ist, kann die Netzwerkkonfiguration der Maschine bearbeitet werden.
> Bearbeiten Sie die Datei `/etc/network/interfaces`, um sie nach der folgenden Vorlage zu ändern:
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> 18
> 19
> 20
> 21
> 22
> 23
> ```
>
> Dabei gilt:
>
> - `INTERFACE_NAME` muss durch den zuvor ermittelten Namen der Netzwerkschnittstelle ersetzt werden.
> - `RIP_MED_WEB_SLAVE` muss durch die reale Haupt-IP-Adresse des Servers ersetzt werden; über diese IP-Adresse sind die Webkonsolen erreichbar.
> - `NETMASK` muss durch die zur IP-Adresse gehörende Netzmaske ersetzt werden.
> - `NETWORK_GATEWAY` muss durch das Standard-Gateway des Netzwerks ersetzt werden.
> - `IP_DNS` muss durch die IP-Adresse des DNS-Servers ersetzt werden. Wenn mehrere Server konfiguriert werden müssen (maximal 3), trennen Sie sie durch ein Leerzeichen.
> - `DNS_SUFFIX` muss durch das zu verwendende DNS-Suffix ersetzt werden. Wenn kein Suffix angegeben werden muss, löschen Sie die Zeile.
> - `RIP_MED_SSL_SLAVE` muss durch die reale sekundäre IP-Adresse des Servers ersetzt werden. Über diese IP-Adresse ist der SSL Router erreichbar.
>
> > **Beispiel**
> >
> > ```
> >  1
> >  2
> >  3
> >  4
> >  5
> >  6
> >  7
> >  8
> >  9
> > 10
> > 11
> > 12
> > 13
> > 14
> > 15
> > 16
> > 17
> > 18
> > 19
> > 20
> > 21
> > 22
> > 23
> > ```
>
> Schließlich muss nur noch der Dienst `networking` neu gestartet werden, damit die neue Netzwerkkonfiguration geladen wird:
>
> ```
> 1
> ```

> **Tipp**
>
> Nun, da die Netzwerkkonfiguration angewendet ist, kann auf den Server per SSH zugegriffen werden.

### Ändern der Kennwörter der lokalen Konten

CyberElements empfiehlt dringend, das Passwort dieser Konten nach der Bereitstellung der virtuellen Appliance zu ändern.

Verwenden Sie den folgenden Befehl und geben Sie das neue Passwort für das Standardkonto `systancia` ein:

```
1
```

Wiederholen Sie den Vorgang anschließend für das Superuser-Konto `root`:

```
1
```

### Konfiguration des Maschinennamens

Der Name des Servers kann geändert werden, indem die Dateien hostname und hosts des Servers konfiguriert werden.

Bearbeiten Sie die Datei `/etc/hostname`, um den Namen der Maschine anzugeben.
Das Produkt benötigt den neuen Namen an einer anderen Stelle; daher muss mit dem folgenden Befehl eine Kopie der vorherigen Datei erstellt werden:

```
1
```

**Mediation-Controller-Server MASTER**

> Die Konfiguration der Datei `/etc/hosts` muss in Bezug auf die reale Haupt-IP-Adresse der Maschine (`RIP_MED_WEB_MASTER`) übernommen werden.
> Bearbeiten Sie dazu die Datei `/etc/hosts` und prüfen Sie, ob die zweite Zeile das folgende Format hat:
>
> ```
> 2
> ```
>
> > **Beispiel**
> >
> > Wenn die Maschine `MEDIATION-CONTROLLER-MASTER` heißt, ohne einer Domäne anzugehören, und ihre reale IP-Adresse `RIP_MED_WEB_MASTER` `10.0.10.10` ist, wäre die Datei wie folgt zu vervollständigen:
> >
> > ```
> > 2
> > ```
> >
> > Wenn die Maschine der Domäne `DOMAIN.LOCAL` angehört, wäre die Datei wie folgt zu vervollständigen:
> >
> > ```
> > 2
> > ```

**Mediation-Controller-Server SLAVE**

> Die Konfiguration der Datei `/etc/hosts` muss in Bezug auf die reale Haupt-IP-Adresse der Maschine (`RIP_MED_WEB_SLAVE`) übernommen werden.
> Bearbeiten Sie dazu die Datei `/etc/hosts` und prüfen Sie, ob die zweite Zeile das folgende Format hat:
>
> ```
> 2
> ```
>
> > **Beispiel**
> >
> > Wenn die Maschine `MEDIATION-CONTROLLER-SLAVE` heißt, ohne einer Domäne anzugehören, und ihre reale IP-Adresse `RIP_MED_WEB_SLAVE` `10.0.10.12` ist, wäre die Datei wie folgt zu vervollständigen:
> >
> > ```
> > 2
> > ```
> >
> > Wenn die Maschine der Domäne `DOMAIN.LOCAL` angehört, wäre die Datei wie folgt zu vervollständigen:
> >
> > ```
> > 2
> > ```

Um die neue Konfiguration anzuwenden, starten Sie den Server neu:

```
1
```

### Änderung der Zeitzone

Die virtuelle Appliance ist standardmäßig auf die Zeitzone `Europe/Paris` eingestellt.

Um diese Zeitzone zu ändern, rufen Sie zunächst mit dem folgenden Befehl die Schreibweise der verfügbaren Zeitzonen ab:

```
1
```

Verwenden Sie anschließend die folgende Befehlszeile:

```
1
```

> **Beispiel**
>
> Um die Zeitzone auf London einzustellen, ist der folgende Befehl auszuführen:
>
> ```
> 1
> ```

Prüfen Sie die Zeitzone des Servers mit der folgenden Befehlszeile:

```
1
```

## Initialisierung des Mediation-Controller-Servers

### Initialisierung des Mediation-Controller-Servers

Der Mediation-Controller-Server wird über ein Konfigurationsskript initialisiert. Dieses Skript konfiguriert die IP-Adressen des Clusters in den verschiedenen Diensten des Produkts neu und konfiguriert die für den Betrieb eines HTML5 Gateway erforderlichen Parameter vor.
Führen Sie es mit der folgenden Befehlszeile als `root` aus:

```
1
```

Das Skript fordert Sie auf, die folgenden Informationen einzugeben:

- `IP VIP HTTPS`: virtuelle Web-IP-Adresse des Clusters, also `VIP_MED_WEB`.
- `IP VIP SSL`: virtuelle SSL-IP-Adresse des Clusters, also `VIP_MED_SSL`.
- `IP VIP ZIO`: virtuelle IP-Adresse für die Verbindung des Mediation-Controller-Servers `SLAVE` mit der internen Konfigurationsdatenbank des Servers `MASTER`, also `VIP_MED_ZEO`.
- `IP Master HTTPS`: reale Web-IP-Adresse des Mediation-Controller-Servers `MASTER`, also `RIP_MED_WEB_MASTER`.
- `IP Master SSL`: reale IP-Adresse des SSL Router des Mediation-Controller-Servers `MASTER`, also `RIP_MED_SSL_MASTER`.
- `IP Slave HTTPS`: reale Web-IP-Adresse des Mediation-Controller-Servers `SLAVE`, also `RIP_MED_WEB_SLAVE`.
- `IP Slave SSL`: reale IP-Adresse des SSL Router des Mediation-Controller-Servers `SLAVE`, also `RIP_MED_SSL_SLAVE`.
- `HTML5 port`: lokaler Lauschport für die Umleitung des Zugriffs auf den HTML5-Gateway-Dienst; wir empfehlen, den Port `1234` anzugeben.
- `Gateway`: Name des Edge Gateway; geben Sie den Namen des ersten Edge Gateway an.
- `Organization`: Name der Organisation, mit der sich die Edge Gateways und HTML5 Gateways verbinden.

Starten Sie nach Abschluss der Initialisierung den Server neu:

```
1
```

### Ändern des Kennworts der Konsole `/mediation/system` von CyberElements Gate

In dieser Phase der Installation steht eine neue Administrationsoberfläche zur Verfügung: [Kennwort ändern](https://docs.cyberelements.io/bastion/4.6/de/Usage/Configuration/SystemConsole/ChangePassword/#modification-on-the-cyberelements-gate-system-console)

### Anwenden der Lizenzen und Zertifikate

Weiterhin in der Konsole `/mediation/system` müssen Sie die Zertifikate und Lizenzen des Mediation-Controller-Servers eingeben.

> **Achtung!**
>
> Lizenz und Zertifikat des SSL Router sind spezifisch für den Mediation-Controller-Server `MASTER` oder `SLAVE`.
> Das Konfigurieren einer falschen Lizenz oder eines falschen Zertifikats führt später zu Fehlfunktionen.

Wenden Sie die Lizenz und das Zertifikat der Komponente SSL Router an: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/CLR_GateSystem_ApplyCertAndLicForSSLRouter.png)

1. Klicken Sie auf die Registerkarte `Settings`.
2. Wählen Sie im Menü `SSL Connections` aus.
3. Suchen Sie das Zertifikat des SSL Router.
4. Geben Sie das Kennwort des SSL-Router-Zertifikats ein.
5. Klicken Sie auf `Apply`, um das Zertifikat auf den SSL Router anzuwenden.
6. Wählen Sie die Lizenzdatei des Servers aus.
7. Klicken Sie auf `Modify`, um die Lizenz des Servers anzuwenden.

Geben Sie anschließend die Informationen zum Zertifikat des CyberElements Bastion-Clients ein: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/CLR_GateSystem_ApplyPluginCert.png)

1. Wählen Sie die Registerkarte `Plugin` aus.
2. Suchen Sie das Zertifikat des CyberElements Bastion-Clients.
3. Geben Sie das Kennwort des Zertifikats ein.
4. Klicken Sie auf `Apply`, um das Zertifikat anzuwenden.

Es bleibt noch, die Informationen zum Watchdog-Zertifikat einzugeben: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/CLR_GateSystem_ApplyWatchdogCert.png)

1. Wählen Sie die Registerkarte `Watchdog` aus
2. Suchen Sie das Watchdog-Zertifikat.
3. Geben Sie das Kennwort des Zertifikats ein.
4. Klicken Sie auf `Apply`, um das Zertifikat anzuwenden.

Damit diese Änderungen wirksam werden, müssen Sie den SSL Router und den Watchdog neu starten: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/CLR_GateSystem_RestartServices.png)

### Pairing der Mediation-Controller-Server

> **Achtung!**
>
> An diesem Punkt müssen beide Mediation-Controller-Server bis zum [Anwenden der Lizenzen und Zertifikate](#applying-licenses-and-certificates) konfiguriert worden sein.
> Wenn der Mediation-Controller-Server `SLAVE` noch nicht konfiguriert ist, tun Sie dies, indem Sie [am Anfang dieser Dokumentation](#installation-of-mediation-controller-servers) beginnen.

Der Pairing-Schritt der Mediation-Controller-Server stellt eine Vertrauensbeziehung zwischen den beiden Servern her und initialisiert den Cluster-Betrieb.

**Auf dem Mediation-Controller-Server `SLAVE`**

Führen Sie den folgenden Befehl als `root` aus, um eine Pairing-Anfrage an den Mediation-Controller-Server `MASTER` zu senden:

```
1
```

Ersetzen Sie `RIP_MED_WEB_MASTER` durch die entsprechende IP-Adresse.

> **Beispiel**
>
> Wenn `RIP_MED_WEB_MASTER` gleich `10.0.10.10` ist, lautet der einzugebende Befehl wie folgt:
>
> ```
> 1
> ```

**Auf dem Mediation-Controller-Server `MASTER`**

Führen Sie den folgenden Befehl als `root` aus, um die ausstehenden Pairing-Anfragen anzuzeigen und die Kennung der Anfrage abzurufen:

```
1
```

Führen Sie anschließend den folgenden Befehl aus, um die Pairing-Anfrage zu akzeptieren, und ersetzen Sie dabei `ID` durch die mit dem vorherigen Befehl abgerufene Kennung:

```
1
```

> **Beispiel**
>
> Wenn das Ergebnis des Befehls `hostManagerCtl getPendingRequests` wie folgt lautet:
>
> ```
> 1
> 2
> 3
> ```
>
> Dann lautet der Befehl zum Akzeptieren der Pairing-Anfrage wie folgt:
>
> ```
> 1
> ```

Um die Zuordnung zu überprüfen, verwenden Sie den folgenden Befehl auf dem Mediation-Controller-Server (entweder `MASTER` oder `SLAVE`):

```
1
```

Das Ergebnis unterscheidet sich je nach Server, auf dem der Befehl ausgeführt wird:

**Mediation-Controller-Server MASTER**

> Das erwartete Ergebnis auf dem Mediation-Controller-Server `MASTER` lautet wie folgt:
>
> ```
> 1
> ```
>
> > **Beispiel**
> >
> > ```
> > 1
> > ```

**Mediation-Controller-Server SLAVE**

> Das erwartete Ergebnis auf dem Mediation-Controller-Server `SLAVE` lautet wie folgt:
>
> ```
> 1
> ```
>
> > **Beispiel**
> >
> > ```
> > 1
> > ```

**Auf dem Mediation-Controller-Server `SLAVE`**

Sie können den Status des Bootstrap vom Server `SLAVE` aus mit dem folgenden Befehl prüfen:

```
1
```

Ein Cluster, der keine Synchronisierungsprobleme aufweist, gibt den Wert `0` zurück.

Eine letzte Reihe von Befehlen ist erforderlich, wiederum auf dem Server `SLAVE`, um ein zwischen beiden Mediation Controllern geteiltes Geheimnis zu synchronisieren:

```
1
2
```

### Aktivierung der Serververbindung

> **Wozu dient die Serververbindung?**
>
> Es handelt sich um eine besondere Verbindung des Cluster-Betriebs, die es einem Mediation-Controller-Server ermöglicht, den Datenverkehr an einen anderen Mediation-Controller-Server weiterzuleiten, wenn das Ziel-Edge-Gateway nicht mit dem ersten Server, sondern nur mit dem zweiten verbunden ist.
>
> Wenn zum Beispiel der Mediation-Controller-Server `MASTER` nicht mehr mit dem Edge Gateway verbunden ist, kann er die Serververbindung nutzen, um es über den Mediation-Controller-Server `SLAVE` zu erreichen.
>
> ```mermaid
> flowchart LR
>     MASTER(Mediation Controller<br/>MASTER) --x |Verbindung verloren| GW(Edge Gateway)
>     MASTER --> |Serverübergreifende Verbindung| SLAVE(Mediation Controller<br/>SLAVE) --> GW
> ```

**Auf dem Mediation-Controller-Server `MASTER`**

Bearbeiten Sie die Datei `/etc/ipdiva/server/remoteServers.xml`, um den CN des Serverzertifikats anzugeben:

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

Ersetzen Sie `SLAVECN` durch den CN des Zertifikats, das für die Serververbindung vorgesehen ist.
Wenn Sie den CN des Serverzertifikats nicht kennen, kann das Zeichen `*` eingegeben werden (im Zweifelsfall empfohlen):

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

> **Beispiel**
>
> Unter Berücksichtigung der folgenden Informationen:
>
> - CN des Serverzertifikats: `my-interserver-cert`
>
> Die Datei `/etc/ipdiva/server/remoteServers.xml` des Mediation-Controller-Servers `MASTER` wäre wie folgt zu vervollständigen:
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> 8
> 9
> ```
>
> > **Vollständige Datei**
> >
> > ```
> >  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
> > ```

**Auf dem Mediation-Controller-Server `SLAVE`**

Senden Sie das Serverzertifikat an den Mediation Controller `SLAVE`, in das Verzeichnis `/tmp/`.
Führen Sie anschließend die folgenden Befehle als `root` aus, um es mit den passenden Berechtigungen in das Zielverzeichnis zu verschieben:

```
1
2
3
```

Bearbeiten Sie anschließend die Datei `/etc/ipdiva/server/remoteServers.xml`, um dem Tag `<remoteConfig>` den folgenden Inhalt hinzuzufügen (das alte Tag `<localCluster>` kann vollständig gelöscht werden):

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

Ersetzen Sie:

- `MASTERCN`: Geben Sie den CN des SSL-Router-Zertifikats des Mediation Controller `MASTER` an; dieser ist in der Regel `RIP_MED_SSL_MASTER`.
- `RIP_MED_SSL_MASTER`: entspricht der sekundären IP-Adresse des Mediation Controller `MASTER`.
- `PORT_RIP_MED_SSL_MASTER`: Dies ist der Port, auf dem der SSL Router des Mediation Controller `MASTER` lauscht; in der Regel ist es `443`.
- `INTERSERVER.P12`: Name des Zertifikats, das für die Serververbindung vorgesehen ist.
- `PASSWORD`: Kennwort des Serverzertifikats.

> **Beispiel**
>
> Unter Berücksichtigung der folgenden Informationen:
>
> - Name des Serverzertifikats: `my-interserver-cert.p12`
> - Kennwort des Serverzertifikats: `MySecurePassword`
> - RIP SSL des Mediation Controller `MASTER`: `10.0.10.11`
> - Port auf der RIP SSL des Mediation Controller `MASTER`: `443`
> - CN des Zertifikats des Mediation Controller `MASTER`: `10.0.10.11`
>
> Die Datei `/etc/ipdiva/server/remoteServers.xml` des Mediation-Controller-Servers `SLAVE` wäre wie folgt zu vervollständigen:
>
> ```
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> ```
>
> > **Vollständige Datei**
> >
> > ```
> >  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
> > ```

Ändern Sie die Konfiguration des SSL Router `SLAVE`, indem Sie den folgenden Befehl ausführen:

```
1
```

**Auf den Mediation-Controller-Servern `MASTER` und `SLAVE`**

Starten Sie den SSL Router neu, um die Konfiguration der Serververbindung anzuwenden:

```
1
```

Um zu bestätigen, dass die Serververbindung korrekt funktioniert, muss der folgende Befehl ein Ergebnis zurückgeben:

```
1
```

Der vorherige Befehl muss ein Protokoll mit dem folgenden Inhalt erzeugen: `TRACE Router.floodWithLocalInfos sent 0 peer(s), 0 foreignPeers, and 0 multicast group(s)`.
Wenn kein solches Protokoll angezeigt wird, prüfen Sie die [in diesem Kapitel](#activation-of-the-interserver-link) vorgenommene Konfiguration.

**In der Webkonsole `/mediation/system` des Mediation Controller `MASTER`**

Aktivieren Sie die Serververbindung zwischen den beiden Mediation Controllern, indem Sie den virtuellen SSL-Host `default` bearbeiten: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/CLR_GateSystem_EditDefaultVHostSSL.png)

Füllen Sie die verschiedenen Felder anhand der nachstehenden Angaben aus und aktivieren Sie die Funktion der Serververbindung, indem Sie das Kontrollkästchen `Is cross-server linking configured?` markieren: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/CLR_GateSystem_EditDefaultVHostSSL_Configuration.png)

- `Public address for plugin connections`: entspricht `VIP_MED_SSL`, gefolgt von seinem Lauschport (in der Regel `443`).
- `Actual public IP addresses for web connections`: entspricht dem Paar der realen Web-IP-Adressen (`RIP_MED_WEB_MASTER` und `RIP_MED_WEB_SLAVE`) mit ihren jeweiligen Ports, eine Zeile pro Paar aus IP-Adresse und Port.
- `Actual public IP addresses for SSL connections`: entspricht dem Paar der realen SSL-IP-Adressen (`RIP_MED_SSL_MASTER` und `RIP_MED_SSL_SLAVE`) mit ihren jeweiligen Ports, eine Zeile pro Paar aus IP-Adresse und Port.

## Initialisierung von CyberElements Bastion

### Verbindung mit der PostgreSQL-Datenbank

Für seinen Betrieb benötigt CyberElements Bastion eine externe PostgreSQL-Datenbank (DB), um seine Konfiguration und die verschiedenen Protokolle der Konsole `/system` zu speichern.
Wenn die DB von den Mediation-Controller-Servern direkt erreichbar ist, gehen Sie direkt zum [Schritt der Initialisierung der DB](#initializing-the-database) über.

#### Verbindung mit einer Datenbank im LAN

Um die Verbindung mit einer im LAN befindlichen Datenbank zu ermöglichen, ohne einen Fluss von der DMZ zum LAN zu öffnen, wird der Fluss der Datenbank über einen TLS-Tunnel zwischen den Edge Gateways und den Mediation Controllern umgeleitet.
Dazu muss ein Edge Gateway (oder zwei Edge Gateways) mit der zugrunde liegenden Technologie CyberElements Gate konfiguriert werden.

##### Deklaration der Edge Gateways CyberElements Gate

Melden Sie sich dazu zunächst an der Konsole `/mediation/system` von CyberElements Gate an.

Öffnen Sie anschließend das Menü „Organizations“ und klicken Sie auf „Add“: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/CLR_GateSystem_AddOrganization.png)

Geben Sie den Namen der Organisation ein, der sich von dem für CyberElements Bastion vergebenen unterscheiden muss (zum Beispiel `tunnel`), und geben Sie mindestens eine Benutzersitzungslizenz sowie das Kennwort des Kontos `admin` an: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/CLR_GateSystem_AddOrganization_Configuration.png)

Melden Sie sich mit dem Konto `admin` an der Administrationsoberfläche der zuvor erstellten Organisation an, indem Sie `/gate/admin` aufrufen: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/CLR_GateAdmin_Authentication.png)

Deklarieren Sie anschließend die beiden Edge Gateways, die für den Aufbau des Tunnels verwendet werden.
Bewegen Sie den Zeiger links über `Infrastructure`, klicken Sie auf `Gateways` und anschließend auf die Schaltfläche `Add`: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/CLR_GateAdmin_AddGateway.png)

Geben Sie den Namen des ersten Edge Gateway ein und bestätigen Sie die Eingabe: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/CLR_GateAdmin_AddGateway_Configuration.png)

> **Hinweis**
>
> Zur Erinnerung: Der Name eines Edge Gateway ist mit dem Zertifikat verknüpft, das es verwendet, um sich gegenüber dem SSL Router des Mediation Controller zu authentifizieren.
> Dieser Name hat die folgende Form `<GW_NAME>@<ORGANIZATION_NAME>`, wobei `<GW_NAME>` dem Namen des Edge Gateway und `<ORGANIZATION_NAME>` dem Namen der in der Systemkonsole von CyberElements Gate erstellten Organisation entspricht.

Wiederholen Sie den Schritt der Deklaration für das zweite Edge Gateway.

##### Verbindungen und Konfiguration des Tunnels auf den Edge Gateways

> **Hinweis**
>
> Die folgenden Schritte können auf beiden Edge Gateways ausgeführt werden, die für den Tunnel zum Zugriff auf die Datenbank verwendet werden.

> **Voraussetzungen**
>
> Um diesen Teil abzuschließen, müssen Sie eine der beiden folgenden Möglichkeiten nutzen:
>
> - [Eine virtuelle Edge Gateway-Appliance](https://docs.cyberelements.io/bastion/4.6/de/Installation/Cluster/FromAppliances/InstallEdgeGateway/#initial-system-settings), auf der nur die Systeminitialisierung durchgeführt wurde.
> - [Ein von Grund auf installiertes Edge Gateway](https://docs.cyberelements.io/bastion/4.6/de/Installation/Cluster/FromScratch/InstallEdgeGateway/) mit installierten Edge-Gateway-Komponenten.

Verwenden Sie zunächst ein Werkzeug wie [WinSCP](https://winscp.net/eng/index.php) oder [FileZilla](https://filezilla-project.org/), um das für die Verbindung erforderliche Zertifikat per SCP in das Verzeichnis `/tmp/` des Edge Gateway zu übertragen.

Verbinden Sie sich anschließend per SSH und wechseln Sie zu `root`.

Um das Edge Gateway mit beiden Mediation Controllern zu verbinden, müssen zwei neue Edge-Gateway-Instanzen erstellt werden: eine verbindet sich mit dem Mediation Controller `MASTER`, die andere mit dem Mediation Controller `SLAVE`.
Führen Sie zum Erstellen die folgenden Befehle aus:

```
1
2
```

Kopieren Sie die Zertifikatsdatei in die Verzeichnisse `/etc/ipdiva/gateway-tunnel-master/ssl/` und `/etc/ipdiva/gateway-tunnel-slave/ssl/`:

```
1
2
```

Ersetzen Sie `<CERT_NAME>` durch den Namen des Zertifikats, das das Edge Gateway verwenden muss, um sich mit dem Mediation Controller zu verbinden.

Konfigurieren Sie die Edge-Gateway-Instanzen so, dass sie sich mit den Mediation Controllern verbinden können.
Die Konfigurationen unterscheiden sich je nach zu kontaktierendem Mediation Controller. Nehmen Sie beide Einstellungen vor:

**Verbindung mit dem Mediation Controller MASTER**

> Bearbeiten Sie die Datei `/etc/ipdiva/gateway-tunnel-master/gateway.xml` und vervollständigen Sie sie mit den folgenden Informationen (mehrere Abschnitte wurden ausgelassen und sind durch `[…]` gekennzeichnet):
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> ```
>
> Ersetzen Sie die folgenden Elemente:
>
> - `@SERVER@`: muss durch die Adresse `RIP_MED_SSL_MASTER` ersetzt werden
> - `@SERVERPORT@`: muss durch den Lauschport des SSL Router ersetzt werden, normalerweise `443`
> - `keyfile.pem`: muss durch den Namen der Zertifikatsdatei ersetzt werden
> - `PASSWORD`: muss durch das Kennwort des Zertifikats ersetzt werden
> - `@RPC_PORT@`: muss durch einen Port ersetzt werden, auf dem die Maschine derzeit nicht lauscht; der Port `9082` kann verwendet werden
>
> > **Beispiel**
> >
> > Unter Berücksichtigung der folgenden Informationen:
> >
> > - `RIP_MED_SSL_MASTER` ist gleich: `10.0.10.11`
> > - Lauschport des SSL Router: `443`
> > - Name der Zertifikatsdatei: `gate-tunnel.p12`
> > - Kennwort des Zertifikats: `Str0ngP@ssw0rd`
> >
> > Die Datei `/etc/ipdiva/gateway-tunnel-master/gateway.xml` wäre wie folgt zu konfigurieren:
> >
> > ```
> >  1
> >  2
> >  3
> >  4
> >  5
> >  6
> >  7
> >  8
> >  9
> > 10
> > 11
> > 12
> > ```
> >
> > > **Vollständige Datei**
> > >
> > > ```
> > >  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
> > > ```

**Verbindung mit dem Mediation Controller SLAVE**

> Bearbeiten Sie die Datei `/etc/ipdiva/gateway-tunnel-slave/gateway.xml` und vervollständigen Sie sie mit den folgenden Informationen (mehrere Abschnitte wurden ausgelassen und sind durch `[…]` gekennzeichnet):
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> ```
>
> Ersetzen Sie die folgenden Elemente:
>
> - `@SERVER@`: muss durch die Adresse `RIP_MED_SSL_SLAVE` ersetzt werden
> - `@SERVERPORT@`: muss durch den Lauschport des SSL Router ersetzt werden, normalerweise `443`
> - `keyfile.pem`: muss durch den Namen der Zertifikatsdatei ersetzt werden
> - `PASSWORD`: muss durch das Kennwort des Zertifikats ersetzt werden
> - `@RPC_PORT@`: muss durch einen Port ersetzt werden, der auf der Maschine derzeit nicht verwendet wird; der Port `9083` kann verwendet werden
>
> > **Beispiel**
> >
> > Unter Berücksichtigung der folgenden Informationen:
> >
> > - `RIP_MED_SSL_SLAVE` ist gleich: `10.0.10.13`
> > - Lauschport des SSL Router: `443`
> > - Name der Zertifikatsdatei: `gate-tunnel.p12`
> > - Kennwort des Zertifikats: `Str0ngP@ssw0rd`
> >
> > Die Datei `/etc/ipdiva/gateway-tunnel-slave/gateway.xml` wäre wie folgt zu konfigurieren:
> >
> > ```
> >  1
> >  2
> >  3
> >  4
> >  5
> >  6
> >  7
> >  8
> >  9
> > 10
> > 11
> > 12
> > ```
> >
> > > **Vollständige Datei**
> > >
> > > ```
> > >  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
> > > ```

Nun, da die Instanzen für die Verbindung mit den Mediation Controllern konfiguriert sind, müssen sie noch so konfiguriert werden, dass sie die Verbindung des Mediation Controller zur Datenbank umleiten.
Bearbeiten Sie dazu die Datei `/etc/ipdiva/gateway-tunnel-master/services.xml` und ändern Sie sie wie folgt:

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

Ersetzen Sie `DB_SERVER` durch den DNS-Namen oder die IP-Adresse, die für die Verbindung mit der Datenbank verwendet wird, und `DB_PORT` durch den Lauschport der Datenbankinstanz.
Übernehmen Sie diese Konfiguration für die Instanz, die sich mit dem Mediation-Controller-Server `SLAVE` verbindet, indem Sie die Datei kopieren:

```
1
```

Starten Sie schließlich die Edge-Gateway-Instanzen, damit sie die Verbindung mit den Mediation Controllern herstellen:

```
1
2
```

##### Konfiguration des Tunnels auf den Mediation Controllern

Damit der Tunnel von den Mediation Controllern genutzt werden kann, muss noch seine Existenz deklariert werden.
Melden Sie sich dazu als `root` an den Mediation Controllern an und bearbeiten Sie die Datei `/etc/ipdiva/server/services.xml`, um den folgenden Abschnitt hinzuzufügen (mehrere Abschnitte wurden ausgelassen und sind durch `[…]` gekennzeichnet):

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

Ersetzen Sie die folgenden Elemente:

- `GW1_NAME` durch den Namen des ersten Edge Gateway
- `GW2_NAME` durch den Namen des zweiten Edge Gateway
- `ORGANIZATION_NAME` durch den Namen der zuvor erstellten Organisation CyberElements Gate

> **Beispiel**
>
> Unter Berücksichtigung der folgenden Informationen:
>
> - Name des Edge Gateway 1: `gate-tunnel-1`
> - Name des Edge Gateway 2: `gate-tunnel-2`
> - Name der Organisation CyberElements Gate: `tunnel`
>
> Die Datei `/etc/ipdiva/server/services.xml` wäre wie folgt zu vervollständigen:
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> ```
>
> > **Vollständige Datei**
> >
> > ```
> >  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
> > ```

Um die neue Konfiguration anzuwenden, starten Sie den SSL Router mit dem folgenden Befehl neu:

```
1
```

#### Initialisierung der Datenbank

> **Achtung!**
>
> Sie müssen die Datenbank `default` erstellen, bevor CyberElements Bastion sie initialisiert (sie wird nicht automatisch erstellt).

Um die PostgreSQL-Datenbank der Systemkonfiguration zu initialisieren, müssen zunächst die Verbindungsparameter auf den Mediation Controllern konfiguriert werden.
Bearbeiten Sie dazu die Datei `/etc/ipdiva/care/databasesettings.ini` auf beiden Servern und fügen Sie die folgenden Einträge hinzu:

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

Ersetzen Sie die folgenden Elemente:

- `DB_USERNAME` durch den Benutzernamen, der für die Verbindung mit der Datenbank verwendet wird.
- `DB_PWD` durch das Kennwort des Benutzers, der sich verbindet.
- `DB_HOST` durch die IP-Adresse oder den DNS-Namen, der für die Verbindung mit der Datenbank verwendet wird; wird eine Verbindung über Edge Gateways genutzt, ist `127.0.0.1` anzugeben.
- `DB_PORT` durch den Port, der für die Verbindung mit der Datenbankinstanz verwendet wird; wird eine Verbindung über Edge Gateways genutzt, ist `1432` anzugeben.

Die Initialisierung der Datenbank kann mit den folgenden Befehlen gestartet werden, die **nur auf einem Mediation Controller auszuführen sind**:

```
1
2
```

Danach muss nur noch der Dienst apache2 **auf beiden Mediation Controllern** neu gestartet werden, um die Initialisierung der Systemdatenbank anzuwenden:

```
1
```

## Konfiguration eines NTP-Zeitservers

Es wird empfohlen, einen Zeitserver einzurichten, um die Systemuhr aktuell zu halten. Die erforderlichen Schritte sind auf [der Seite zur NTP-Konfiguration](https://docs.cyberelements.io/bastion/4.6/de/Usage/Configuration/MediationController/ConfigureAnNTPServer/) beschrieben.

## Initiale Konfigurationen von CyberElements Bastion

### Berechtigung für den Zugriff auf die Weboberflächen mit der virtuellen IP

Standardmäßig ist es nicht erlaubt, sich mit der virtuellen IP `VIP_MED_WEB` mit den Weboberflächen des Produkts CyberElements Bastion zu verbinden.
Um die Berechtigung hinzuzufügen, führen Sie als `root` die folgenden Befehle auf den Mediation Controllern aus:

```
1
2
```

Ersetzen Sie `IP` durch die IP-Adresse, die `VIP_MED_WEB` entspricht.

### Initiale Konfigurationen

In dieser Phase sind die Mediation-Controller-Server installiert, es sind jedoch noch mehrere Aktionen erforderlich:

- (1) Die Standardkennwörter ändern

  ---

  Ändern Sie die Standardkennwörter der Systemkonsolen.

  [→ Ändern](https://docs.cyberelements.io/bastion/4.6/de/Usage/Configuration/SystemConsole/ChangePassword/)
- (2) Die Zertifikate und Lizenzen installieren

  ---

  Der Mediation Controller benötigt verschiedene Zertifikate und eine Lizenz, um betriebsbereit zu sein.
  Nur das Zertifikat des Clients CyberElements Bastion muss auf beiden Mediation Controllern erneut deklariert werden (verwenden Sie die RIP `RIP_MED_WEB_MASTER` und `RIP_MED_WEB_SLAVE`).

  [→ Die Zertifikate und die Lizenz installieren](https://docs.cyberelements.io/bastion/4.6/de/Usage/Configuration/SystemConsole/ApplyCertificatesAndLicence/)
- (3) Das Webzertifikat konfigurieren

  ---

  Konfigurieren Sie das Webzertifikat, das für die Verbindung mit den Weboberflächen verwendet wird

  [→ Konfigurieren](https://docs.cyberelements.io/bastion/4.6/de/Usage/Configuration/SystemConsole/ApplyWebCertificate/)
- (4) Einen DNS-Namen deklarieren

  ---

  Fügen Sie einen DNS-Namen hinzu, der zur Verbindung mit den Weboberflächen berechtigt ist.

  [→ Hinzufügen](https://docs.cyberelements.io/bastion/4.6/de/Usage/Configuration/SystemConsole/AddAllowedDNSName/)

- (5) Die Organisation konfigurieren

  ---

  Konfigurieren Sie die Organisation von CyberElements Bastion.

  [→ Mit direktem Zugriff auf die Datenbank konfigurieren](https://docs.cyberelements.io/bastion/4.6/de/Usage/Configuration/SystemConsole/AddOrganization/#__tabbed_1_2)

  [→ Mit Zugriff auf die Datenbank über den Tunnel der Edge Gateways konfigurieren](https://docs.cyberelements.io/bastion/4.6/de/Usage/Configuration/SystemConsole/AddOrganization/#__tabbed_1_3)
- (6) Die Edge Gateways deklarieren

  ---

  Deklarieren Sie die zu installierenden Edge Gateways oder HTML5 Gateways.

  [→ Edge Gateways erstellen](https://docs.cyberelements.io/bastion/4.6/de/Usage/Configuration/AdminConsole/CreateEdgeGateway/)
- (7) Einen logischen Standort erstellen

  ---

  Erstellen und konfigurieren Sie einen logischen Standort, der die Edge Gateways und HTML5 Gateways zusammenfasst, die auf die lokalen Ressourcen zugreifen können.

  [→ Einen Standort erstellen](https://docs.cyberelements.io/bastion/4.6/de/Usage/Configuration/AdminConsole/CreateSite/)
- (8) Ein Edge Gateway installieren

  ---

  Installieren und konfigurieren Sie ein neues Edge Gateway mit den neu installierten Mediation-Controller-Servern.
  Es wird außerdem eine HTML5-Gateway-Instanz konfiguriert.

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