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

# Инсталиране на сървъра Mediation Controller

> **Забележка**
>
> Напомняме, че превключването към `root` на компютри с Debian трябва да се извършва със следната команда:
>
> ```
> 1
> ```

## Изтегляне на огледалото и необходимите инструменти

Огледалното хранилище (mirror) на CyberElements Cleanroom 4.6 и ключът за подпис на хранилището на Systancia могат да бъдат изтеглени от тази връзка (изисква създаване на клиентски акаунт): [Systancia Marketplace](https://www.systancia.com/my-systancia/marketplace/systancia-cleanroom/telechargements-cleanroom/)

Освен огледалното хранилище и ключа, за процеса на надграждане ще са необходими и инструменти на трети страни:

- SSH клиент (в Windows можете да използвате [PuTTY](https://putty.org/))
- SCP клиент (в Windows могат да се използват инструментите [WinSCP](https://winscp.net/eng/index.php) или [FileZilla](https://filezilla-project.org/))

Използвайте SSH клиента, за да се свържете отдалечено със своя сървър.

Използвайте SCP клиента, за да прехвърлите файлове към отдалечения компютър.

## Подготовка за инсталирането

### Конфигуриране на мрежата

Задължително е да конфигурирате статичен мрежов адрес за компонента Mediation Controller. За да направите това, първо трябва да получите името на мрежовия интерфейс на компютъра. Изпълнете следната команда като `root`:

```
1
```

Тази команда показва името на мрежовия интерфейс, неговото състояние и IP адресите, присвоени на интерфейса.

> **Пример**
>
> След изпълнението на командата се показва следният резултат:
>
> ```
> 1
> ```
>
> Името на мрежовия интерфейс е `ens192`.

След като името на мрежовия интерфейс е получено, вече можете да редактирате мрежовата конфигурация на компютъра.
Редактирайте файла `/etc/network/interfaces`, за да го промените по следния шаблон:

```
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
```

Където:

- `INTERFACE_NAME` трябва да бъде заменено с името на получения преди това мрежов интерфейс.
- `IP_MED_WEB` трябва да бъде заменено с основния IP адрес на сървъра, чрез който ще бъдат достъпни уеб конзолите.
- `NETMASK` трябва да бъде заменено с мрежовата маска, свързана с IP адреса.
- `NETWORK_GATEWAY` трябва да бъде заменено с мрежовия шлюз по подразбиране.
- `IP_DNS` трябва да бъде заменено с IP адреса на DNS сървъра. Ако трябва да се конфигурират няколко сървъра (най-много 3), разделете ги с интервал.
- `DNS_SUFFIX` трябва да бъде заменено с DNS суфикса, който да се използва. Ако не е необходимо да се въвежда суфикс, изтрийте реда.
- `IP_MED_SSL` трябва да бъде заменено с вторичния IP адрес на сървъра. Това ще бъде IP адресът, чрез който ще бъде достъпен компонентът SSL Router.

> **Пример**
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> 18
> 19
> 20
> 21
> 22
> 23
> ```

Преди да приложите конфигурацията, трябва да изпълните още три стъпки.

Първата е да инсталирате пакета `resolvconf`, за да може да се приложи DNS конфигурацията, зададена в предишния файл:

```
1
```

Втората е да проверите конфигурацията на файла `/etc/hosts` по отношение на основния IP адрес на компютъра (`IP_MED_WEB`).
За да направите това, редактирайте файла `/etc/hosts` и проверете дали вторият ред е в следния формат:

```
2
```

> **Пример**
>
> Ако компютърът се казва `MEDIATION-CONTROLLER`, без да е член на домейн, а IP адресът му `IP_MED_WEB` е `10.0.10.10`, файлът ще бъде попълнен по следния начин:
>
> ```
> 2
> ```
>
> Ако компютърът е член на домейна `DOMAIN.LOCAL`, файлът ще бъде попълнен по следния начин:
>
> ```
> 2
> ```

> **Внимание!**
>
> Неправилна конфигурация на файла може да доведе до грешка при инсталирането на пакета `collectd`.

Накрая остава само да рестартирате услугата `networking`, за да се зареди новата мрежова конфигурация:

```
1
```

### Конфигуриране на мениджъра на пакети APT

Качете файловете, изтеглени от Systancia Marketplace, в директорията `/tmp/` на сървъра с помощта на SCP клиент:

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

Влезте в сървъра като `root`, след което изпълнете следните команди, за да разархивирате хранилището на Systancia, да конфигурирате използването му в APT и да го удостоверите.

```
1
2
3
4
5
```

Силно препоръчваме да деактивирате инсталирането на ненужни пакети при изпълнение на командите `apt`. За целта изпълнете следната команда:

```
1
```

### Проверка за наличие на локала `en_US.utf8`

Инсталирането на сървъра Mediation Controller изисква генериране на локалите `en_US.utf8`.
За да проверите дали те вече са генерирани на сървъра, изпълнете следната команда като `root`:

```
1
```

Ако отговорът на командата показва `en_US.utf8`, [преминете към следващата стъпка от конфигурирането на GRUB](#configuring-the-grub-boot-program).
В противен случай изпълнете следните команди, за да добавите този локал към компютъра:

```
1
2
```

### Конфигуриране на програмата за начално зареждане GRUB

След като тези команди бъдат изпълнени, трябва да рестартирате компютъра, след като приложите настройка в програмата за начално зареждане GRUB:

```
1
2
3
```

## Инсталиране на сървъра Mediation Controller на CyberElements Bastion

### Инсталиране на основните компоненти

Започнете инсталирането на компонентите със следната команда като `root`:

```
1
```

След изтеглянето на всички зависимости ще се отвори прозорец, в който трябва да изберете типа на сървъра. Изберете `mediation`:

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

След това изберете режима на инсталиране `standalone`:

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

След това ще трябва да въведете порта, на който ще слуша компонентът SSL Router. Този порт за слушане обикновено е `443`, но може да се използва и портът `8443`, ако сървърът Mediation използва само един IP адрес:

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

След това въведете адреса за уеб достъп до сървъра Mediation Controller (съответства на `IP_MED_WEB` в мрежовата конфигурация):

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

Накрая въведете IP адреса на SSL рутера (съответства на `IP_MED_SSL` в мрежовата конфигурация):

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

> **Какво да направя, ако възникне грешка?**
>
> Ако във въведената информация има грешка, продължете инсталирането на пакета `ipdiva-base` и след това използвайте следната команда, за да конфигурирате отново сървъра:
>
> ```
> 1
> ```

### Инсталиране на специфични компоненти

Започнете инсталирането на компонентите, специфични за сървъра Mediation Controller, със следната команда:

```
1
```

Сървърът трябва да бъде рестартиран, за да завърши инсталирането (използвайте командата `reboot`).

## Инсталиране на драйвери за свързване с бази данни на Microsoft SQL Server

Ако искате да се свържете с външна база данни и тя е Microsoft SQL Server, трябва да бъдат инсталирани допълнителни ODBC драйвери.

Налични са две версии: версия 17 и версия 18.

> **За драйверите във версия 18 е необходима TLS връзка**
>
> Използването на драйвери ODBC 18 изисква връзката да бъде шифрована с TLS. За да направите това, трябва да [конфигурирате MS SQL Server за шифроване на връзките](https://learn.microsoft.com/en-us/sql/database-engine/configure-windows/configure-sql-server-encryption?view=sql-server-ver16).

Преди да започнете инсталирането на ODBC драйверите, трябва да инсталирате необходимите пакети за подготовка и след това да подготвите хранилището на Microsoft за инсталирането на пакетите:

```
1
2
3
4
```

След това инсталирайте драйверите според избраната версия и конфигурирайте системата да използва командата `sqlcmd`:

**ODBC драйвери, версия 17**

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

**ODBC драйвери, версия 18**

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

ODBC драйверите вече са инсталирани правилно.
Ако сървърът Mediation Controller има достъп до MS SQL сървър, следната команда би трябвало да позволи свързването с отдалечения сървър:

```
1
```

Където:

- `SERVER` трябва да бъде заменено с DNS името или IP адреса на MS SQL сървъра.
- `INSTANCE_NAME` трябва да бъде заменено с името на екземпляра, с който да се свържете; ако не е необходимо, премахнете и символа `\`.
- `PORT` трябва да бъде заменено с порта за връзка с екземпляра на базата данни MS SQL.
- `USER` трябва да бъде заменено с потребителското име за установяване на връзката.

> **Примери**
>
> Ако сървърът Mediation Controller има достъп до сървър за бази данни MS SQL чрез IP адреса `10.0.10.100`, екземплярът, до който трябва да се осъществи достъп, слуша на порт `1433`, а акаунтът за достъп е `sql-user`. Тогава командата за свързване е следната:
>
> ```
> 1
> ```
>
> Ако трябваше да се посочи екземплярът за връзка с име `MSSQLINSTANCE`, командата щеше да бъде променена по следния начин:
>
> ```
> 1
> ```

## Конфигуриране на NTP сървър за време

Препоръчително е да настроите сървър за време, за да поддържате системния часовник актуален. Необходимите стъпки са описани [на страницата за конфигуриране на NTP](https://docs.cyberelements.io/bastion/4.6/bg/Usage/Configuration/MediationController/ConfigureAnNTPServer/).

## Първоначални конфигурации в CyberElements Bastion

Компонентите на сървъра Mediation Controller са инсталирани. Сега трябва да конфигурирате Mediation Controller.

- (1) Променете паролите по подразбиране

  ---

  Променете паролите по подразбиране за системните конзоли.

  [→ Променете](https://docs.cyberelements.io/bastion/4.6/bg/Usage/Configuration/SystemConsole/ChangePassword/)
- (2) Инсталиране на сертификати и лицензи

  ---

  Сървърът Mediation Controller изисква различни сертификати и лиценз, за да работи.

  [→ Инсталирайте сертификатите и лиценза](https://docs.cyberelements.io/bastion/4.6/bg/Usage/Configuration/SystemConsole/ApplyCertificatesAndLicence/)
- (3) Конфигуриране на сертифициращи органи

  ---

  Добавете сертифициращия орган (CA) или органите, които не принадлежат на Systancia и които ще се използват за сертификатите на Edge Gateway и HTML5 Gateway.

  [→ Конфигурирайте доверените CA](https://docs.cyberelements.io/bastion/4.6/bg/Usage/Configuration/SystemConsole/AddANewTrustedCA/)
- (4) Конфигурирайте уеб сертификата

  ---

  Конфигурирайте уеб сертификата, използван за свързване с уеб интерфейсите

  [→ Конфигуриране](https://docs.cyberelements.io/bastion/4.6/bg/Usage/Configuration/SystemConsole/ApplyWebCertificate/)
- (5) Декларирайте DNS име

  ---

  Добавете DNS име, на което е разрешено да се свързва с уеб интерфейсите.

  [→ Добавяне](https://docs.cyberelements.io/bastion/4.6/bg/Usage/Configuration/SystemConsole/AddAllowedDNSName/)
- (6) Конфигурирайте виртуалния SSL хост

  ---

  Конфигуриране на виртуалния SSL хост на CyberElements Bastion, което позволява да се зададе адресът за свързване към SSL рутера за клиентите и за механизма за сдвояване на Edge Gateway.

  [→ Конфигурирайте](https://docs.cyberelements.io/bastion/4.6/bg/Usage/Configuration/SystemConsole/ConfigureVirtualhostSSL/)
- (7) Конфигурирайте организацията

  ---

  Конфигуриране на организацията на CyberElements Bastion.

  [→ Конфигурирайте](https://docs.cyberelements.io/bastion/4.6/bg/Usage/Configuration/SystemConsole/AddOrganization/)
- (8) Декларирайте сървърите Edge Gateway

  ---

  Декларирайте сървърите Edge Gateway или HTML5 Gateway, които трябва да бъдат инсталирани, и генерирайте маркер за сдвояване.

  [→ Създайте маркери за сдвояване](https://docs.cyberelements.io/bastion/4.6/bg/Usage/Configuration/AdminConsole/CreatePairingTokenForEdgeGateway/)
- (9) Създайте логически сайт

  ---

  Създайте и конфигурирайте логически сайт, който групира сървърите Edge Gateway и HTML5 Gateway с достъп до локалните ресурси.

  [→ Създаване на сайт](https://docs.cyberelements.io/bastion/4.6/bg/Usage/Configuration/AdminConsole/CreateSite/)
- (10) Инсталирайте Edge Gateway

  ---

  Инсталирайте и конфигурирайте нов Edge Gateway с новоинсталирания сървър Mediation Controller.
  Ще бъде конфигуриран и екземпляр на HTML5 Gateway.

  [→ Инсталирайте](https://docs.cyberelements.io/bastion/4.6/bg/Installation/Standalone/FromScratch/InstallEdgeGateway/)
