> Source: https://docs.cyberelements.io/bastion/4.6/cs/Installation/Standalone/FromScratch/InstallEdgeGateway/

# Instalace serveru Edge Gateway

> **Poznámka**
>
> Připomínáme, že přepnutí na `root` je na počítačích s Debianem nutné provést následujícím příkazem:
>
> ```
> 1
> ```

## Stažení zrcadla a potřebných nástrojů

Zrcadlo CyberElements Cleanroom 4.6 a podpisový klíč úložiště Systancia lze stáhnout z tohoto odkazu (vyžaduje vytvoření zákaznického účtu): [Systancia Marketplace](https://www.systancia.com/my-systancia/marketplace/systancia-cleanroom/telechargements-cleanroom/)

Kromě zrcadla a klíče budou pro proces upgradu potřeba nástroje třetích stran:

- Klient SSH (ve Windows můžete použít [PuTTY](https://putty.org/))
- Klient SCP (ve Windows lze použít nástroje [WinSCP](https://winscp.net/eng/index.php) nebo [FileZilla](https://filezilla-project.org/))

Pomocí klienta SSH se vzdáleně připojte ke svému serveru.

Pomocí klienta SCP přeneste soubory na vzdálený počítač.

## Příprava instalace

### Konfigurace sítě

Důrazně se doporučuje definovat pro server Edge Gateway statickou síťovou adresu. Za tímto účelem nejprve zjistěte název síťového rozhraní svého počítače a jeho adresu MAC. Spusťte následující příkaz jako `root`:

```
1
```

Tento příkaz zobrazí název síťového rozhraní, jeho stav, jeho adresu MAC a nastavení rozhraní.

> **Příklad**
>
> Po provedení příkazu se zobrazí následující výstup:
>
> ```
> 1
> ```
>
> Název síťového rozhraní je `ens192` a jeho adresa MAC je `00:50:56:a1:56:9f`.

Po zjištění názvu síťového rozhraní a adresy MAC je nyní možné upravit síťovou konfiguraci počítače.
Upravte soubor `/etc/network/interfaces` podle následující šablony:

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

Kde:

- `INTERFACE_NAME` je nutné nahradit dříve zjištěným názvem síťového rozhraní.
- `MAC_ADDRESS` je nutné nahradit dříve zjištěnou adresou MAC.
- `IP_GW` je nutné nahradit IP adresou serveru.
- `NETMASK` je nutné nahradit maskou sítě přidruženou k IP adrese.
- `NETWORK_GATEWAY` je nutné nahradit výchozí síťovou bránou.
- `IP_DNS` je nutné nahradit IP adresou serveru DNS. Pokud je třeba nakonfigurovat více serverů (maximálně 3), oddělte je mezerou.
- `DNS_SUFFIX` je nutné nahradit příponou DNS, která se má použít. Pokud není třeba zadávat žádnou příponu, odstraňte tento řádek.

> **Příklad**
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> 18
> 19
> 20
> 21
> 22
> ```

Před použitím konfigurace zbývá provést ještě tři kroky.

Prvním je instalace balíčků `resolvconf` a `bridge-utils`, aby bylo možné použít konfiguraci DNS zadanou v předchozím souboru a používat rozhraní `br0`:

```
1
```

Druhým je kontrola konfigurace souboru `/etc/hosts` s ohledem na primární IP adresu počítače (`IP_GW`).
Za tímto účelem upravte soubor `/etc/hosts` a ověřte, že druhý řádek má následující formát:

```
2
```

> **Příklad**
>
> Pokud se počítač jmenuje `EDGE-GATEWAY`, nepatří do žádné domény a jeho IP adresa `IP_GW` je `172.16.10.10`, soubor se doplní takto:
>
> ```
> 2
> ```
>
> Pokud počítač patří do domény `DOMAIN.LOCAL`, soubor se doplní takto:
>
> ```
> 2
> ```

> **Pozor!**
>
> Nesprávná konfigurace souboru může způsobit chybu při instalaci balíčku `collectd`.

Zbývá jen restartovat server:

```
1
```

### Konfigurace správce balíčků APT

Pomocí klienta SCP nahrajte soubory stažené ze Systancia Marketplace do adresáře `/tmp/` na serveru:

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

Přihlaste se k serveru jako `root` a poté spusťte následující příkazy, které rozbalí úložiště Systancia, nakonfigurují jeho použití v APT a ověří ho.

```
1
2
3
4
5
```

Důrazně doporučujeme zakázat instalaci nepotřebných balíčků při spouštění příkazů `apt`. Za tímto účelem spusťte následující příkaz:

```
1
```

## Instalace serveru Edge Gateway pro CyberElements Bastion

### Instalace základních komponent

Spusťte instalaci komponent následujícím příkazem jako `root`:

```
1
```

Po stažení všech závislostí se otevře okno s výzvou k výběru typu serveru. Vyberte `gateway`:

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

> **Co dělat v případě chyby?**
>
> Pokud jsou v zadaných údajích chyby, pokračujte v instalaci balíčku `ipdiva-base` a poté server znovu nakonfigurujte následujícím příkazem:
>
> ```
> 1
> ```

### Instalace komponent Edge Gateway

Poté spusťte instalaci komponent specifických pro Edge Gateway následujícím příkazem:

```
1
```

Komponenty serveru Edge Gateway jsou nyní nainstalovány. Zbývá jen restartovat počítač, aby se nově nainstalované komponenty mohly inicializovat:

```
1
```

### Instalace komponent HTML5 Gateway

Následujícím příkazem spusťte instalaci komponent HTML5 Gateway na serveru Edge Gateway:

```
1
```

Následujícími příkazovými řádky povolte a nakonfigurujte funkce přenosu souborů a virtuální tiskárny:

```
1
2
3
```

## Konfigurace

### Konfigurace před připojením komponenty HTML5 Gateway

Aby aplikace HTML5 fungovaly, je nutné nakonfigurovat další nastavení **na serveru Mediation Controller**. Přihlaste se k serveru **Mediation Controller** jako `root`.

Vytvořte nebo upravte soubor `/etc/ipdiva/httpd/commonParameters.extra.conf` a přidejte do něj část odpovídající následující ukázce:

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

Kde:

- Hodnotu `URL_HTML5` je nutné nahradit obsahem pole `URL` komponenty HTML5 Gateway nakonfigurované v konzole pro správu při [generování tokenu pairingu](https://docs.cyberelements.io/bastion/4.6/cs/Usage/Configuration/AdminConsole/CreatePairingTokenForEdgeGateway/#__tabbed_1_2).
- `GW_NAME` je nutné nahradit názvem komponenty Edge Gateway umístěné na stejném serveru jako HTML5 Gateway. Znak `|` na konci řádku **musí zůstat zachován**.
- `ORGANIZATION_NAME` je nutné nahradit názvem organizace, ke které se předchozí komponenta Edge Gateway připojuje.

> **Příklad**
>
> Pro platformu s následujícím nastavením:
>
> - Název organizace: `my-organization-name`
> - Deklarace komponenty HTML5 Gateway v konzole pro správu:
>     - Název: `html5-gateway`
>     - URL: `HTML5`
>     - Protocol: `WebSocket`
> - Server Edge Gateway má:
>     - Službu Edge Gateway s názvem `edge-gateway`
>     - Službu HTML5 Gateway s názvem `html5-gateway`
>
> Vytvořený konfigurační soubor `/etc/ipdiva/httpd/commonParameters.extra.conf` bude nastaven takto:
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> 18
> 19
> 20
> 21
> ```

Před použitím nového nastavení musíte ověřit, že nová konfigurace nezpůsobuje žádné blokující chyby webového serveru Apache2.
Za tímto účelem spusťte následující příkaz:

```
1
```

Pokud je odpověď `Syntax OK`, lze změny použít níže uvedeným příkazem. V opačném případě zkontrolujte svou konfiguraci v souboru `/etc/ipdiva/httpd/commonParameters.extra.conf`.

```
1
```

### Připojení komponent Edge Gateway a HTML5 Gateway

> **Pozor!**
>
> Pokud pro komponentu SSL Router používáte certifikáty vydané jinou certifikační autoritou (CA) než Systancia, musíte kořenovou CA přidat do důvěryhodných CA komponenty Edge Gateway: [přidejte kořenovou CA komponenty SSL Router do důvěryhodných CA pro připojení Edge Gateway nebo HTML5 Gateway](https://docs.cyberelements.io/bastion/4.6/cs/Usage/Configuration/EdgeGateway/AddANewTrustedCertificationAuthority/#global-addition-to-debian).

Chcete-li nakonfigurovat instance Edge Gateway a HTML5 Gateway na serveru, postupujte podle informací uvedených v následující dokumentaci: [Pairing serveru](https://docs.cyberelements.io/bastion/4.6/cs/Usage/Configuration/EdgeGateway/ConnectAnEdgeGatewayWithPairingToken/)
