> Source: https://docs.cyberelements.io/bastion/4.6/pl/Installation/Cluster/FromScratch/InstallMediationController/

# Instalacja serwerów Mediation Controller

> **Uwaga**
>
> Przypomnienie: przejście na `root` na maszynach Debian musi odbywać się za pomocą następującego polecenia:
>
> ```
> 1
> ```

Instrukcje podane na tej stronie należy wykonać na obu serwerach Mediation Controller, zaczynając od serwera `MASTER`.
Gdy między serwerami `MASTER` i `SLAVE` występują różnice, zostaną one wyróżnione. Jeśli nie ma o tym wzmianki, instrukcje dotyczą zarówno serwera `MASTER`, jak i serwera `SLAVE`.

## Pobieranie mirrora i niezbędnych narzędzi

Mirror CyberElements Cleanroom 4.6 oraz klucz podpisu repozytorium Systancia można pobrać z tego odnośnika (wymaga utworzenia konta klienta): [Systancia Marketplace](https://www.systancia.com/my-systancia/marketplace/systancia-cleanroom/telechargements-cleanroom/)

Poza mirrorem i kluczem do procesu aktualizacji będą potrzebne narzędzia innych producentów:

- Klient SSH (w systemie Windows możesz użyć [PuTTY](https://putty.org/))
- Klient SCP (w systemie Windows można użyć narzędzi [WinSCP](https://winscp.net/eng/index.php) lub [FileZilla](https://filezilla-project.org/))

Użyj klienta SSH, aby połączyć się zdalnie ze swoim serwerem.

Użyj klienta SCP, aby przenieść pliki na maszynę zdalną.

## Przygotowanie do instalacji

### Konfiguracja sieci

Zainstaluj pakiet `resolvconf`, aby można było zastosować konfigurację DNS podaną w pliku konfiguracyjnym, który zostanie zmodyfikowany za chwilę:

```
1
```

**Serwer Mediation Controller MASTER**

> Skonfigurowanie statycznego adresu sieciowego dla Mediation Controller jest bezwzględnie konieczne. Aby to zrobić, najpierw trzeba ustalić nazwę interfejsu sieciowego twojej maszyny. Wykonaj następujące polecenie jako `root`:
>
> ```
> 1
> ```
>
> To polecenie wyświetla nazwę interfejsu sieciowego, jego status oraz adresy IP przypisane do interfejsu.
>
> > **Przykład**
> >
> > Po wykonaniu polecenia wyświetlany jest następujący wynik:
> >
> > ```
> > 1
> > ```
> >
> > Nazwa interfejsu sieciowego to `ens192`.
>
> Po ustaleniu nazwy interfejsu sieciowego można teraz edytować konfigurację sieciową maszyny.
> Edytuj plik `/etc/network/interfaces`, aby zmodyfikować go według następującego szablonu:
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> 18
> 19
> 20
> 21
> 22
> 23
> ```
>
> Gdzie:
>
> - `INTERFACE_NAME` należy zastąpić nazwą wcześniej ustalonego interfejsu sieciowego.
> - `RIP_MED_WEB_MASTER` należy zastąpić głównym rzeczywistym adresem IP serwera; pod tym adresem IP będą dostępne konsole webowe.
> - `NETMASK` należy zastąpić maską sieci powiązaną z adresem IP.
> - `NETWORK_GATEWAY` należy zastąpić domyślną bramą sieciową.
> - `IP_DNS` należy zastąpić adresem IP serwera DNS. Jeśli trzeba skonfigurować kilka serwerów (maksymalnie 3), rozdziel je spacją.
> - `DNS_SUFFIX` należy zastąpić sufiksem DNS, który ma być używany. Jeśli nie trzeba podawać żadnego sufiksu, usuń tę linię.
> - `RIP_MED_SSL_MASTER` należy zastąpić dodatkowym rzeczywistym adresem IP serwera. Pod tym adresem IP będzie dostępny SSL Router.
>
> > **Przykład**
> >
> > ```
> >  1
> >  2
> >  3
> >  4
> >  5
> >  6
> >  7
> >  8
> >  9
> > 10
> > 11
> > 12
> > 13
> > 14
> > 15
> > 16
> > 17
> > 18
> > 19
> > 20
> > 21
> > 22
> > 23
> > ```
>
> Na koniec pozostaje tylko ponownie uruchomić usługę `networking`, aby wczytać nową konfigurację sieciową:
>
> ```
> 1
> ```

**Serwer Mediation Controller SLAVE**

> Skonfigurowanie statycznego adresu sieciowego dla Mediation Controller jest bezwzględnie konieczne. Aby to zrobić, najpierw trzeba ustalić nazwę interfejsu sieciowego twojej maszyny. Wykonaj następujące polecenie jako `root`:
>
> ```
> 1
> ```
>
> To polecenie wyświetla nazwę interfejsu sieciowego, jego status oraz adresy IP przypisane do interfejsu.
>
> > **Przykład**
> >
> > Po wykonaniu polecenia wyświetlany jest następujący wynik:
> >
> > ```
> > 1
> > ```
> >
> > Nazwa interfejsu sieciowego to `ens192`.
>
> Po ustaleniu nazwy interfejsu sieciowego można teraz edytować konfigurację sieciową maszyny.
> Edytuj plik `/etc/network/interfaces`, aby zmodyfikować go według następującego szablonu:
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> 18
> 19
> 20
> 21
> 22
> 23
> ```
>
> Gdzie:
>
> - `INTERFACE_NAME` należy zastąpić nazwą wcześniej ustalonego interfejsu sieciowego.
> - `RIP_MED_WEB_SLAVE` należy zastąpić głównym rzeczywistym adresem IP serwera; pod tym adresem IP będą dostępne konsole webowe.
> - `NETMASK` należy zastąpić maską sieci powiązaną z adresem IP.
> - `NETWORK_GATEWAY` należy zastąpić domyślną bramą sieciową.
> - `IP_DNS` należy zastąpić adresem IP serwera DNS. Jeśli trzeba skonfigurować kilka serwerów (maksymalnie 3), rozdziel je spacją.
> - `DNS_SUFFIX` należy zastąpić sufiksem DNS, który ma być używany. Jeśli nie trzeba podawać żadnego sufiksu, usuń tę linię.
> - `RIP_MED_SSL_SLAVE` należy zastąpić dodatkowym rzeczywistym adresem IP serwera. Pod tym adresem IP będzie dostępny SSL Router.
>
> > **Przykład**
> >
> > ```
> >  1
> >  2
> >  3
> >  4
> >  5
> >  6
> >  7
> >  8
> >  9
> > 10
> > 11
> > 12
> > 13
> > 14
> > 15
> > 16
> > 17
> > 18
> > 19
> > 20
> > 21
> > 22
> > 23
> > ```
>
> Na koniec pozostaje tylko ponownie uruchomić usługę `networking`, aby wczytać nową konfigurację sieciową:
>
> ```
> 1
> ```

Pozostaje jeden ostatni krok: zmodyfikować wewnętrzne rozwiązywanie nazw maszyny tak, aby rozwiązywało jej rzeczywisty główny adres IP (odpowiadający `RIP_MED_WEB_MASTER` lub `RIP_MED_WEB_SLAVE`).
Aby to zrobić, edytuj plik `/etc/hosts` i zastąp `127.0.1.1` przez `RIP_MED_WEB_MASTER` lub `RIP_MED_WEB_SLAVE`, zależnie od serwera Mediation Controller.

> **Przykład**
>
> Dla serwera Mediation Controller, którego rzeczywisty webowy adres IP to `10.0.10.10`, a nazwa to `mediation-controller.domain.local`, plik `/etc/hosts` będzie mieć następującą wartość:
>
> ```
> 1
> 2
> ```

> **Uwaga!**
>
> Nieprawidłowa konfiguracja pliku może spowodować błąd przy instalacji pakietu `collectd`.

### Konfiguracja menedżera pakietów APT

Prześlij pliki pobrane z Systancia Marketplace do katalogu `/tmp/` na serwerze za pomocą klienta SCP:

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

Zaloguj się na serwerze jako `root`, a następnie wykonaj poniższe polecenia, aby rozpakować repozytorium Systancia, skonfigurować jego użycie w APT i je uwierzytelnić.

```
1
2
3
4
5
```

Stanowczo zalecamy wyłączenie instalacji niepotrzebnych pakietów przy wykonywaniu poleceń `apt`. Aby to zrobić, wykonaj następujące polecenie:

```
1
```

### Sprawdzenie obecności ustawień regionalnych `en_US.utf8`

Instalacja serwera Mediation Controller wymaga wygenerowania ustawień regionalnych `en_US.utf8`.
Aby sprawdzić, czy zostały już wygenerowane na serwerze, wykonaj następujące polecenie jako `root`:

```
1
```

Jeśli odpowiedź polecenia zawiera `en_US.utf8`, [przejdź do następnego kroku, czyli konfiguracji GRUB](#configuring-the-grub-boot-program).
W przeciwnym razie wykonaj poniższe polecenia, aby dodać te ustawienia regionalne do maszyny:

```
1
2
```

### Konfiguracja programu rozruchowego GRUB

Po wykonaniu tych poleceń musisz ponownie uruchomić maszynę, po wprowadzeniu ustawienia w programie rozruchowym GRUB:

```
1
2
3
```

## Instalacja serwera Mediation Controller CyberElements Bastion

### Instalacja komponentów podstawowych

Rozpocznij instalację komponentów za pomocą następującego polecenia jako `root`:

```
1
```

Po pobraniu wszystkich zależności otworzy się okno z prośbą o wybór typu serwera. Wybierz `mediation`:

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

**Serwer Mediation Controller MASTER**

> Następnie wybierz tryb instalacji `lbMaster`:
>
> ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/InstallCLRScratchCluster-ModeInstallMaster.png)

**Serwer Mediation Controller SLAVE**

> Następnie wybierz tryb instalacji `lbSlave`:
>
> ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/InstallCLRScratchCluster-ModeInstallSlave.png)

Następnie trzeba będzie podać port, na którym będzie nasłuchiwał SSL Router. Ten port nasłuchu jest zwykle ustawiony na `443`, ale można też użyć portu `8443`, jeśli Mediation Controller używa tylko jednego adresu IP:

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

Następnie ustaw tryb Cluster na `loadbalancing`, aby obciążenie użytkownikami było rozłożone na oba serwery Mediation Controller:

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

Podaj wirtualny webowy adres IP klastra, `VIP_MED_WEB`:

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

Podaj wirtualny adres IP SSL klastra, `VIP_MED_SSL`:

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

Podaj wirtualny adres IP bazy danych konfiguracji klastra, `VIP_MED_ZEO`:

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

Podaj rzeczywisty webowy adres IP Mediation Controller `MASTER`, `RIP_MED_WEB_MASTER`:

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

Podaj rzeczywisty adres IP SSL Mediation Controller `MASTER`, `RIP_MED_SSL_MASTER`:

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

Podaj rzeczywisty webowy adres IP Mediation Controller `SLAVE`, `RIP_MED_WEB_SLAVE`:

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

Na koniec podaj rzeczywisty adres IP SSL Mediation Controller `SLAVE`, `RIP_MED_SSL_SLAVE`:

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

> **Co zrobić w razie błędu?**
>
> Jeśli we wprowadzonych informacjach jest błąd, kontynuuj instalację pakietu `ipdiva-base`, a następnie użyj poniższego polecenia, aby ponownie skonfigurować serwer:
>
> ```
> 1
> ```

### Instalacja komponentów Cluster

Po zainstalowaniu komponentów podstawowych trzeba zainstalować komponenty Cluster na serwerach Mediation Controller:

```
1
```

Po zainstalowaniu komponentów wymagane jest ponowne uruchomienie:

```
1
```

### Konfiguracja klastra

#### Zmiana hasła konsoli `/mediation/system` CyberElements Gate

Na tym etapie instalacji dostępny jest nowy interfejs administracyjny: [Zmień hasło](https://docs.cyberelements.io/bastion/4.6/pl/Usage/Configuration/SystemConsole/ChangePassword/#modification-on-the-cyberelements-gate-system-console)

#### Zastosowanie licencji i certyfikatów

Nadal w konsoli `/mediation/system` musisz wprowadzić certyfikaty i licencje serwera Mediation Controller.

> **Uwaga!**
>
> Licencja i certyfikat SSL Router są specyficzne dla serwera Mediation Controller `MASTER` lub `SLAVE`.
> Skonfigurowanie niewłaściwej licencji lub niewłaściwego certyfikatu spowoduje później nieprawidłowe działanie.

Zastosuj licencję i certyfikat komponentu SSL Router: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/CLR_GateSystem_ApplyCertAndLicForSSLRouter.png)

1. Kliknij kartę `Settings`.
2. Wybierz z menu `SSL Connections`.
3. Wyszukaj certyfikat dla SSL Router.
4. Wprowadź hasło certyfikatu SSL Router.
5. Kliknij `Apply`, aby zastosować certyfikat do SSL Router.
6. Wybierz plik licencji serwera.
7. Kliknij `Modify`, aby zastosować licencję serwera.

Następnie wprowadź informacje o certyfikacie klienta CyberElements Bastion: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/CLR_GateSystem_ApplyPluginCert.png)

1. Wybierz kartę `Plugin`.
2. Wyszukaj certyfikat klienta CyberElements Bastion.
3. Wprowadź hasło certyfikatu.
4. Kliknij `Apply`, aby zastosować certyfikat.

Pozostaje jeszcze wprowadzić informacje o certyfikacie Watchdog: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/CLR_GateSystem_ApplyWatchdogCert.png)

1. Wybierz kartę `Watchdog`
2. Wyszukaj certyfikat Watchdog.
3. Wprowadź hasło certyfikatu.
4. Kliknij `Apply`, aby zastosować certyfikat.

Aby te zmiany zaczęły obowiązywać, musisz ponownie uruchomić SSL Router i Watchdog: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/CLR_GateSystem_RestartServices.png)

#### Pairing serwerów Mediation Controller

> **Uwaga!**
>
> W tym momencie oba serwery Mediation Controller muszą być skonfigurowane aż do [zastosowania licencji i certyfikatów](#applying-licenses-and-certificates).
> Jeśli serwer Mediation Controller `SLAVE` nie jest jeszcze skonfigurowany, zrób to, zaczynając [od początku tej dokumentacji](#installation-of-mediation-controller-servers).

Krok pairingu serwerów Mediation Controller ustanawia relację zaufania między tymi dwoma serwerami i inicjalizuje pracę klastra.

**Na serwerze Mediation Controller `SLAVE`**

Wykonaj następujące polecenie jako `root`, aby wysłać żądanie pairingu do serwera Mediation Controller `MASTER`:

```
1
```

Zastąp `RIP_MED_WEB_MASTER` odpowiednim adresem IP.

> **Przykład**
>
> Jeśli `RIP_MED_WEB_MASTER` jest równe `10.0.10.10`, polecenie do wprowadzenia jest następujące:
>
> ```
> 1
> ```

**Na serwerze Mediation Controller `MASTER`**

Wykonaj następujące polecenie jako `root`, aby wyświetlić oczekujące żądania pairingu i pobrać identyfikator żądania:

```
1
```

Następnie wykonaj poniższe polecenie, aby zaakceptować żądanie pairingu, zastępując `ID` identyfikatorem pobranym poprzednim poleceniem:

```
1
```

> **Przykład**
>
> Jeśli wynik polecenia `hostManagerCtl getPendingRequests` jest następujący:
>
> ```
> 1
> 2
> 3
> ```
>
> Wówczas polecenie akceptujące żądanie pairingu jest następujące:
>
> ```
> 1
> ```

Aby zweryfikować powiązanie, użyj poniższego polecenia na serwerze Mediation Controller (`MASTER` albo `SLAVE`):

```
1
```

Wynik różni się w zależności od serwera, na którym polecenie jest wykonywane:

**Serwer Mediation Controller MASTER**

> Oczekiwany wynik na serwerze Mediation Controller `MASTER` jest następujący:
>
> ```
> 1
> ```
>
> > **Przykład**
> >
> > ```
> > 1
> > ```

**Serwer Mediation Controller SLAVE**

> Oczekiwany wynik na serwerze Mediation Controller `SLAVE` jest następujący:
>
> ```
> 1
> ```
>
> > **Przykład**
> >
> > ```
> > 1
> > ```

**Na serwerze Mediation Controller `SLAVE`**

Status bootstrapu możesz sprawdzić z serwera `SLAVE` za pomocą następującego polecenia:

```
1
```

Klaster, który nie ma problemów z synchronizacją, zwraca wartość `0`.

Potrzebna jest ostatnia seria poleceń, ponownie na serwerze `SLAVE`, aby zsynchronizować sekret dzielony między oboma Mediation Controller:

```
1
2
```

#### Włączenie połączenia międzyserwerowego

> **Do czego służy połączenie międzyserwerowe?**
>
> Jest to szczególne połączenie pracy klastra, które umożliwia serwerowi Mediation Controller przekierowanie ruchu do innego serwera Mediation Controller, gdy docelowy Edge Gateway nie jest połączony z pierwszym serwerem, lecz tylko z drugim.
>
> Na przykład jeśli serwer Mediation Controller `MASTER` nie jest już połączony z Edge Gateway, może wykorzystać połączenie międzyserwerowe, aby dotrzeć do Edge Gateway przez serwer Mediation Controller `SLAVE`.
>
> ```mermaid
> flowchart LR
>     MASTER(Mediation Controller<br/>MASTER) --x |Utracone połączenie| GW(Edge Gateway)
>     MASTER --> |Połączenie między serwerami| SLAVE(Mediation Controller<br/>SLAVE) --> GW
> ```

**Na serwerze Mediation Controller `MASTER`**

Edytuj plik `/etc/ipdiva/server/remoteServers.xml`, aby wskazać CN certyfikatu międzyserwerowego:

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

Zastąp `SLAVECN` przez CN certyfikatu przeznaczonego do połączenia międzyserwerowego.
Jeśli nie znasz CN certyfikatu międzyserwerowego, możesz wprowadzić znak `*` (zalecane w razie wątpliwości):

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

> **Przykład**
>
> Uwzględniając następujące informacje:
>
> - CN certyfikatu międzyserwerowego: `my-interserver-cert`
>
> Plik `/etc/ipdiva/server/remoteServers.xml` na serwerze Mediation Controller `MASTER` należy uzupełnić następująco:
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> 8
> 9
> ```
>
> > **Kompletny plik**
> >
> > ```
> >  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
> > ```

**Na serwerze Mediation Controller `SLAVE`**

Wyślij certyfikat międzyserwerowy do Mediation Controller `SLAVE`, do katalogu `/tmp/`.
Następnie wykonaj poniższe polecenia jako `root`, aby przenieść go do katalogu docelowego z odpowiednimi uprawnieniami:

```
1
2
3
```

Następnie edytuj plik `/etc/ipdiva/server/remoteServers.xml`, aby dodać do tagu `<remoteConfig>` następującą treść (stary tag `<localCluster>` można całkowicie usunąć):

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

Zamień:

- `MASTERCN`: wskaż CN certyfikatu SSL Router Mediation Controller `MASTER`; zwykle jest to `RIP_MED_SSL_MASTER`.
- `RIP_MED_SSL_MASTER`: odpowiada dodatkowemu adresowi IP Mediation Controller `MASTER`.
- `PORT_RIP_MED_SSL_MASTER`: to port, na którym nasłuchuje SSL Router Mediation Controller `MASTER`; zwykle jest to `443`.
- `INTERSERVER.P12`: nazwa certyfikatu przeznaczonego do połączenia międzyserwerowego.
- `PASSWORD`: hasło certyfikatu międzyserwerowego.

> **Przykład**
>
> Uwzględniając następujące informacje:
>
> - Nazwa certyfikatu międzyserwerowego: `my-interserver-cert.p12`
> - Hasło certyfikatu międzyserwerowego: `MySecurePassword`
> - RIP SSL Mediation Controller `MASTER`: `10.0.10.11`
> - Port na RIP SSL Mediation Controller `MASTER`: `443`
> - CN certyfikatu Mediation Controller `MASTER`: `10.0.10.11`
>
> Plik `/etc/ipdiva/server/remoteServers.xml` na serwerze Mediation Controller `SLAVE` należy uzupełnić następująco:
>
> ```
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> ```
>
> > **Kompletny plik**
> >
> > ```
> >  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
> > ```

Zmień konfigurację SSL Router `SLAVE`, wykonując następujące polecenie:

```
1
```

**Na serwerach Mediation Controller `MASTER` i `SLAVE`**

Uruchom ponownie SSL Router, aby zastosować konfigurację połączenia międzyserwerowego:

```
1
```

Aby potwierdzić, że połączenie międzyserwerowe działa poprawnie, poniższe polecenie musi zwrócić wynik:

```
1
```

Poprzednie polecenie musi wygenerować log o następującej treści: `TRACE Router.floodWithLocalInfos sent 0 peer(s), 0 foreignPeers, and 0 multicast group(s)`.
Jeśli taki log nie jest wyświetlany, sprawdź konfigurację wprowadzoną [w tym rozdziale](#activation-of-the-interserver-link).

**W konsoli webowej `/mediation/system` Mediation Controller `MASTER`**

Włącz połączenie międzyserwerowe między oboma Mediation Controller, edytując wirtualny host SSL `default`: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/CLR_GateSystem_EditDefaultVHostSSL.png)

Wypełnij poszczególne pola zgodnie z poniższymi wskazaniami i włącz funkcję połączenia międzyserwerowego, zaznaczając pole wyboru `Is cross-server linking configured?`: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/CLR_GateSystem_EditDefaultVHostSSL_Configuration.png)

- `Public address for plugin connections`: odpowiada `VIP_MED_SSL`, po którym następuje jego port nasłuchu (zwykle `443`).
- `Actual public IP addresses for web connections`: odpowiada parze rzeczywistych webowych adresów IP (`RIP_MED_WEB_MASTER` i `RIP_MED_WEB_SLAVE`) z odpowiednimi portami, po jednej linii na parę adresu IP i portu.
- `Actual public IP addresses for SSL connections`: odpowiada parze rzeczywistych adresów IP SSL (`RIP_MED_SSL_MASTER` i `RIP_MED_SSL_SLAVE`) z odpowiednimi portami, po jednej linii na parę adresu IP i portu.

### Instalacja komponentów specyficznych dla CyberElements Bastion

Rozpocznij instalację komponentów CyberElements Bastion na serwerach Mediation Controller za pomocą następującego polecenia:

```
1
```

Aby zakończyć instalację, serwery muszą zostać ponownie uruchomione:

```
1
```

### Połączenie z bazą danych PostgreSQL

Do działania CyberElements Bastion wymaga zewnętrznej bazy danych PostgreSQL (BD), aby przechowywać swoją konfigurację i różne logi konsoli `/system`.
Jeśli BD jest bezpośrednio osiągalna z serwerów Mediation Controller, przejdź od razu do [kroku inicjalizacji BD](#initializing-the-database).

#### Połączenie z bazą danych w sieci LAN

Aby umożliwić połączenie z bazą danych znajdującą się w sieci LAN bez otwierania przepływu z DMZ do LAN, przepływ bazy danych zostanie przekierowany przez tunel TLS między Edge Gateway a Mediation Controller.
W tym celu trzeba skonfigurować jeden Edge Gateway (lub dwa Edge Gateway) przy użyciu leżącej u podstaw technologii CyberElements Gate.

##### Deklaracja Edge Gateway CyberElements Gate

Aby to zrobić, zaloguj się najpierw do konsoli `/mediation/system` w CyberElements Gate.

Następnie otwórz menu „Organizations” i kliknij „Add”: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/CLR_GateSystem_AddOrganization.png)

Wprowadź nazwę organizacji, która musi być inna niż nazwa przypisana dla CyberElements Bastion (na przykład `tunnel`), i podaj co najmniej jedną licencję sesji użytkownika oraz hasło konta `admin`: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/CLR_GateSystem_AddOrganization_Configuration.png)

Zaloguj się do interfejsu administracyjnego utworzonej wcześniej organizacji za pomocą konta `admin`, przechodząc do `/gate/admin`: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/CLR_GateAdmin_Authentication.png)

Następnie zadeklaruj oba Edge Gateway, które zostaną użyte do zbudowania tunelu.
Po lewej stronie najedź na `Infrastructure`, kliknij `Gateways`, a następnie kliknij przycisk `Add`: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/CLR_GateAdmin_AddGateway.png)

Wprowadź nazwę pierwszego Edge Gateway i zatwierdź wpis: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/CLR_GateAdmin_AddGateway_Configuration.png)

> **Informacja**
>
> Przypomnienie: nazwa Edge Gateway jest powiązana z certyfikatem, którego użyje on do uwierzytelnienia się względem SSL Router serwera Mediation Controller.
> Ta nazwa ma następującą postać `<GW_NAME>@<ORGANIZATION_NAME>`, gdzie `<GW_NAME>` odpowiada nazwie Edge Gateway, a `<ORGANIZATION_NAME>` odpowiada nazwie organizacji utworzonej w konsoli systemowej CyberElements Gate.

Powtórz krok deklaracji dla drugiego Edge Gateway.

##### Połączenia i konfiguracja tunelu na Edge Gateway

> **Informacja**
>
> Poniższe kroki można wykonać na obu Edge Gateway używanych do tunelu dostępu do bazy danych.

> **Wymagania wstępne**
>
> Aby ukończyć tę część, musisz skorzystać z jednej z dwóch możliwości:
>
> - [Wirtualna appliance Edge Gateway](https://docs.cyberelements.io/bastion/4.6/pl/Installation/Cluster/FromAppliances/InstallEdgeGateway/#initial-system-settings), na której wykonano wyłącznie inicjalizację systemu.
> - [Edge Gateway zainstalowany od zera](https://docs.cyberelements.io/bastion/4.6/pl/Installation/Cluster/FromScratch/InstallEdgeGateway/) z zainstalowanymi komponentami Edge Gateway.

Najpierw użyj narzędzia takiego jak [WinSCP](https://winscp.net/eng/index.php) lub [FileZilla](https://filezilla-project.org/), aby przenieść przez SCP certyfikat wymagany do połączenia do katalogu `/tmp/` na Edge Gateway.

Następnie połącz się przez SSH i przejdź na `root`.

Aby połączyć Edge Gateway z oboma Mediation Controller, musisz utworzyć dwie nowe instancje Edge Gateway: jedna połączy się z Mediation Controller `MASTER`, a druga z Mediation Controller `SLAVE`.
Aby je utworzyć, wykonaj następujące polecenia:

```
1
2
```

Skopiuj plik certyfikatu do katalogów `/etc/ipdiva/gateway-tunnel-master/ssl/` i `/etc/ipdiva/gateway-tunnel-slave/ssl/`:

```
1
2
```

Zastąp `<CERT_NAME>` nazwą certyfikatu, którego Edge Gateway musi użyć, aby połączyć się z Mediation Controller.

Skonfiguruj instancje Edge Gateway tak, aby mogły łączyć się z Mediation Controller.
Konfiguracje różnią się w zależności od Mediation Controller, z którym trzeba się połączyć. Wykonaj obie konfiguracje:

**Połączenie z Mediation Controller MASTER**

> Edytuj plik `/etc/ipdiva/gateway-tunnel-master/gateway.xml` i uzupełnij go następującymi informacjami (kilka sekcji zostało pominiętych i oznaczonych jako `[…]`):
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> ```
>
> Zastąp następujące elementy:
>
> - `@SERVER@`: należy zastąpić adresem `RIP_MED_SSL_MASTER`
> - `@SERVERPORT@`: należy zastąpić portem nasłuchu SSL Router, zwykle ustawionym na `443`
> - `keyfile.pem`: należy zastąpić nazwą pliku certyfikatu
> - `PASSWORD`: należy zastąpić hasłem certyfikatu
> - `@RPC_PORT@`: należy zastąpić portem, na którym maszyna obecnie nie nasłuchuje; można użyć portu `9082`
>
> > **Przykład**
> >
> > Uwzględniając następujące informacje:
> >
> > - `RIP_MED_SSL_MASTER` jest równe: `10.0.10.11`
> > - Port nasłuchu SSL Router: `443`
> > - Nazwa pliku certyfikatu: `gate-tunnel.p12`
> > - Hasło certyfikatu: `Str0ngP@ssw0rd`
> >
> > Plik `/etc/ipdiva/gateway-tunnel-master/gateway.xml` należy skonfigurować następująco:
> >
> > ```
> >  1
> >  2
> >  3
> >  4
> >  5
> >  6
> >  7
> >  8
> >  9
> > 10
> > 11
> > 12
> > ```
> >
> > > **Kompletny plik**
> > >
> > > ```
> > >  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
> > > ```

**Połączenie z Mediation Controller SLAVE**

> Edytuj plik `/etc/ipdiva/gateway-tunnel-slave/gateway.xml` i uzupełnij go następującymi informacjami (kilka sekcji zostało pominiętych i oznaczonych jako `[…]`):
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> ```
>
> Zastąp następujące elementy:
>
> - `@SERVER@`: należy zastąpić adresem `RIP_MED_SSL_SLAVE`
> - `@SERVERPORT@`: należy zastąpić portem nasłuchu SSL Router, zwykle ustawionym na `443`
> - `keyfile.pem`: należy zastąpić nazwą pliku certyfikatu
> - `PASSWORD`: należy zastąpić hasłem certyfikatu
> - `@RPC_PORT@`: należy zastąpić portem, który obecnie nie jest używany na maszynie; można użyć portu `9083`
>
> > **Przykład**
> >
> > Uwzględniając następujące informacje:
> >
> > - `RIP_MED_SSL_SLAVE` jest równe: `10.0.10.13`
> > - Port nasłuchu SSL Router: `443`
> > - Nazwa pliku certyfikatu: `gate-tunnel.p12`
> > - Hasło certyfikatu: `Str0ngP@ssw0rd`
> >
> > Plik `/etc/ipdiva/gateway-tunnel-slave/gateway.xml` należy skonfigurować następująco:
> >
> > ```
> >  1
> >  2
> >  3
> >  4
> >  5
> >  6
> >  7
> >  8
> >  9
> > 10
> > 11
> > 12
> > ```
> >
> > > **Kompletny plik**
> > >
> > > ```
> > >  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
> > > ```

Teraz, gdy instancje są skonfigurowane do łączenia się z Mediation Controller, trzeba je jeszcze skonfigurować tak, aby przekierowywały połączenie Mediation Controller do bazy danych.
Aby to zrobić, edytuj plik `/etc/ipdiva/gateway-tunnel-master/services.xml` i zmodyfikuj go następująco:

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

Zastąp `DB_SERVER` nazwą DNS lub adresem IP używanym do połączenia z bazą danych, a `DB_PORT` portem nasłuchu instancji bazy danych.
Powtórz tę konfigurację dla instancji łączącej się z serwerem Mediation Controller `SLAVE`, kopiując plik:

```
1
```

Na koniec uruchom instancje Edge Gateway, aby ustanowiły połączenie z Mediation Controller:

```
1
2
```

##### Konfiguracja tunelu na Mediation Controller

Aby tunel mógł być używany przez Mediation Controller, trzeba jeszcze zadeklarować jego istnienie.
Aby to zrobić, zaloguj się jako `root` na Mediation Controller i edytuj plik `/etc/ipdiva/server/services.xml`, aby dodać następującą sekcję (kilka sekcji zostało pominiętych i oznaczonych jako `[…]`):

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

Zastąp następujące elementy:

- `GW1_NAME` nazwą pierwszego Edge Gateway
- `GW2_NAME` nazwą drugiego Edge Gateway
- `ORGANIZATION_NAME` nazwą utworzonej wcześniej organizacji CyberElements Gate

> **Przykład**
>
> Uwzględniając następujące informacje:
>
> - Nazwa Edge Gateway 1: `gate-tunnel-1`
> - Nazwa Edge Gateway 2: `gate-tunnel-2`
> - Nazwa organizacji CyberElements Gate: `tunnel`
>
> Plik `/etc/ipdiva/server/services.xml` należy uzupełnić następująco:
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> ```
>
> > **Kompletny plik**
> >
> > ```
> >  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
> > ```

Aby zastosować nową konfigurację, uruchom ponownie SSL Router następującym poleceniem:

```
1
```

#### Inicjalizacja bazy danych

> **Uwaga!**
>
> Musisz utworzyć bazę danych `default`, zanim CyberElements Bastion ją zainicjalizuje (nie jest tworzona automatycznie).

Aby zainicjalizować bazę danych PostgreSQL konfiguracji systemowej, musisz najpierw skonfigurować parametry połączenia na Mediation Controller.
Aby to zrobić, edytuj plik `/etc/ipdiva/care/databasesettings.ini` na obu serwerach i dodaj następujące wpisy:

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

Zastąp następujące elementy:

- `DB_USERNAME` nazwą użytkownika używaną do połączenia z bazą danych.
- `DB_PWD` hasłem użytkownika, który się łączy.
- `DB_HOST` adresem IP lub nazwą DNS używaną do połączenia z bazą danych; jeśli wykorzystywane jest połączenie przez Edge Gateway, trzeba podać `127.0.0.1`.
- `DB_PORT` portem używanym do połączenia z instancją bazy danych; jeśli wykorzystywane jest połączenie przez Edge Gateway, trzeba podać `1432`.

Inicjalizację bazy danych można uruchomić następującymi poleceniami, **wykonywanymi tylko na jednym Mediation Controller**:

```
1
2
```

Następnie pozostaje tylko ponownie uruchomić usługę apache2 **na obu Mediation Controller**, aby zastosować inicjalizację systemowej bazy danych:

```
1
```

## Instalacja sterowników do połączenia z bazami danych Microsoft SQL

Jeśli chcesz połączyć się z zewnętrzną bazą danych i jest nią Microsoft SQL Server, musisz zainstalować dodatkowe sterowniki ODBC.

Dostępne są dwie wersje: wersja 17 i wersja 18.

> **Połączenie TLS wymagane dla sterowników w wersji 18**
>
> Korzystanie ze sterowników ODBC 18 wymaga, aby połączenie było szyfrowane za pomocą TLS. W tym celu musisz [skonfigurować MS SQL Server do szyfrowania połączeń](https://learn.microsoft.com/en-us/sql/database-engine/configure-windows/configure-sql-server-encryption?view=sql-server-ver16).

Przed rozpoczęciem instalacji sterowników ODBC musisz zainstalować pakiety niezbędne do przygotowania, a następnie przygotować repozytorium Microsoft do instalacji pakietów:

```
1
2
3
4
```

Następnie zainstaluj sterowniki odpowiednio do wybranej wersji i skonfiguruj system do używania polecenia `sqlcmd`:

**Sterowniki ODBC w wersji 17**

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

**Sterowniki ODBC w wersji 18**

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

Sterowniki ODBC są teraz poprawnie zainstalowane.
Jeśli serwer Mediation Controller ma dostęp do serwera MS SQL, poniższe polecenie powinno umożliwić połączenie ze zdalnym serwerem:

```
1
```

Gdzie:

- `SERVER` należy zastąpić nazwą DNS lub adresem IP serwera MS SQL.
- `INSTANCE_NAME` należy zastąpić nazwą instancji, z którą trzeba się połączyć; jeśli nie jest to konieczne, usuń również znak `\`.
- `PORT` należy zastąpić portem połączenia z instancją bazy danych MS SQL.
- `USER` należy zastąpić nazwą użytkownika, za pomocą której ustanawiane jest połączenie.

> **Przykłady**
>
> Jeśli serwer Mediation Controller ma dostęp do serwera bazy danych MS SQL pod adresem IP `10.0.10.100`, instancja, do której trzeba uzyskać dostęp, nasłuchuje na porcie `1433`, a kontem dostępu jest `sql-user`. Wówczas polecenie połączenia jest następujące:
>
> ```
> 1
> ```
>
> Gdyby trzeba było wskazać instancję połączenia o nazwie `MSSQLINSTANCE`, polecenie należałoby zmienić następująco:
>
> ```
> 1
> ```

## Konfiguracja serwera czasu NTP

Zaleca się skonfigurowanie serwera czasu, aby zegar systemowy pozostawał aktualny. Niezbędne kroki są opisane [na stronie konfiguracji NTP](https://docs.cyberelements.io/bastion/4.6/pl/Usage/Configuration/MediationController/ConfigureAnNTPServer/).

## Początkowe konfiguracje w CyberElements Bastion

### Uprawnienie do dostępu do interfejsów webowych za pomocą wirtualnego adresu IP

Domyślnie łączenie się z interfejsami webowymi produktu CyberElements Bastion przy użyciu wirtualnego adresu IP `VIP_MED_WEB` nie jest dozwolone.
Aby dodać uprawnienie, wykonaj jako `root` następujące polecenia na Mediation Controller:

```
1
2
```

Zastąp `IP` adresem IP odpowiadającym `VIP_MED_WEB`.

### Początkowe konfiguracje

Na tym etapie serwery Mediation Controller są zainstalowane, ale trzeba jeszcze wykonać kilka działań:

- (1) Zmień domyślne hasła

  ---

  Zmień domyślne hasła konsol systemowych.

  [→ Zmień](https://docs.cyberelements.io/bastion/4.6/pl/Usage/Configuration/SystemConsole/ChangePassword/)
- (2) Zainstaluj certyfikaty i licencje

  ---

  Mediation Controller wymaga różnych certyfikatów oraz licencji, aby był gotowy do pracy.
  Tylko certyfikat klienta CyberElements Bastion trzeba zadeklarować ponownie na obu Mediation Controller (użyj RIP `RIP_MED_WEB_MASTER` i `RIP_MED_WEB_SLAVE`).

  [→ Zainstaluj certyfikaty i licencję](https://docs.cyberelements.io/bastion/4.6/pl/Usage/Configuration/SystemConsole/ApplyCertificatesAndLicence/)
- (3) Skonfiguruj certyfikat webowy

  ---

  Skonfiguruj certyfikat webowy używany do łączenia się z interfejsami webowymi

  [→ Skonfiguruj](https://docs.cyberelements.io/bastion/4.6/pl/Usage/Configuration/SystemConsole/ApplyWebCertificate/)
- (4) Zadeklaruj nazwę DNS

  ---

  Dodaj nazwę DNS uprawnioną do łączenia się z interfejsami webowymi.

  [→ Dodaj](https://docs.cyberelements.io/bastion/4.6/pl/Usage/Configuration/SystemConsole/AddAllowedDNSName/)
- (5) Skonfiguruj organizację

  ---

  Skonfiguruj organizację CyberElements Bastion.

  [→ Skonfiguruj z bezpośrednim dostępem do bazy danych](https://docs.cyberelements.io/bastion/4.6/pl/Usage/Configuration/SystemConsole/AddOrganization/#__tabbed_1_2)

  [→ Skonfiguruj z dostępem do bazy danych przez tunel Edge Gateway](https://docs.cyberelements.io/bastion/4.6/pl/Usage/Configuration/SystemConsole/AddOrganization/#__tabbed_1_3)
- (6) Zadeklaruj Edge Gateway

  ---

  Zadeklaruj Edge Gateway lub HTML5 Gateway, które mają zostać zainstalowane.

  [→ Utwórz Edge Gateway](https://docs.cyberelements.io/bastion/4.6/pl/Usage/Configuration/AdminConsole/CreateEdgeGateway/)
- (7) Utwórz site logiczny

  ---

  Utwórz i skonfiguruj site logiczny, który grupuje Edge Gateway i HTML5 Gateway mogące uzyskać dostęp do zasobów lokalnych.

  [→ Utwórz site](https://docs.cyberelements.io/bastion/4.6/pl/Usage/Configuration/AdminConsole/CreateSite/)
- (8) Zainstaluj Edge Gateway

  ---

  Zainstaluj i skonfiguruj nowy Edge Gateway z nowo zainstalowanymi serwerami Mediation Controller.
  Zostanie też skonfigurowana instancja HTML5 Gateway.

  [→ Zainstaluj](https://docs.cyberelements.io/bastion/4.6/pl/Installation/Cluster/FromScratch/InstallEdgeGateway/)
