> Source: https://docs.cyberelements.io/bastion/4.6/mt/Installation/Cluster/FromScratch/InstallEdgeGateway/

# Installazzjoni tas-server Edge Gateway

> **Nota**
>
> Bħala tfakkira, il-qlib għal `root` fuq kompjuters Debian għandu jsir bil-kmand li ġej:
>
> ```
> 1
> ```

## Tniżżil tal-mirror u tal-għodod meħtieġa

Il-mirror ta’ CyberElements Cleanroom 4.6 u ċ-ċavetta tal-firma tar-repożitorju ta’ Systancia jistgħu jitniżżlu minn dan il-link (jeħtieġ il-ħolqien ta’ kont tal-klijent): [Systancia Marketplace](https://www.systancia.com/my-systancia/marketplace/systancia-cleanroom/telechargements-cleanroom/)

Minbarra l-mirror u ċ-ċavetta, se jkunu meħtieġa għodod ta’ partijiet terzi għall-proċess tat-titjib tal-verżjoni:

- Klijent SSH (fuq Windows, tista’ tuża [PuTTY](https://putty.org/))
- Klijent SCP (fuq Windows, jistgħu jintużaw l-għodod [WinSCP](https://winscp.net/eng/index.php) jew [FileZilla](https://filezilla-project.org/))

Uża l-klijent SSH biex tikkonnettja mill-bogħod mas-server tiegħek.

Uża l-klijent SCP biex tittrasferixxi fajls lejn il-kompjuter remot tiegħek.

## Tħejjija għall-installazzjoni

### Konfigurazzjoni tan-netwerk

Huwa rrakkomandat ħafna li tiddefinixxi indirizz tan-netwerk statiku għas-server Edge Gateway. Biex tagħmel dan, l-ewwel trid tikseb l-isem tal-interfaċċa tan-netwerk tal-kompjuter tiegħek u l-indirizz MAC tagħha. Ħaddem il-kmand li ġej bħala `root`:

```
1
```

Dan il-kmand juri l-isem tal-interfaċċa tan-netwerk, l-istatus tagħha, l-indirizz MAC tagħha, u s-settings tal-interfaċċa.

> **Eżempju**
>
> Wara li jiġi eżegwit il-kmand, jintwera l-output li ġej:
>
> ```
> 1
> ```
>
> L-isem tal-interfaċċa tan-netwerk huwa `ens192` u l-indirizz MAC tagħha huwa `00:50:56:a1:56:9f`.

Ladarba jkunu nkisbu l-isem tal-interfaċċa tan-netwerk u l-indirizz MAC, issa huwa possibbli li teditja l-konfigurazzjoni tan-netwerk tal-kompjuter.
Editja l-fajl `/etc/network/interfaces` biex timmodifikah billi tuża l-mudell li ġej:

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

Fejn:

- `INTERFACE_NAME` għandu jiġi sostitwit bl-isem tal-interfaċċa tan-netwerk miksub qabel.
- `MAC_ADDRESS` għandu jiġi sostitwit bl-indirizz MAC miksub qabel.
- `IP_GW` għandu jiġi sostitwit bl-indirizz IP tas-server.
- `NETMASK` għandu jiġi sostitwit bil-maskra tan-netwerk assoċjata mal-indirizz IP.
- `NETWORK_GATEWAY` għandu jiġi sostitwit bil-gateway default tan-netwerk.
- `IP_DNS` għandu jiġi sostitwit bl-indirizz IP tas-server DNS. Jekk ikunu jridu jiġu kkonfigurati diversi servers (massimu ta’ 3), isseparahom bi spazju.
- `DNS_SUFFIX` għandu jiġi sostitwit bis-suffiss DNS li għandu jintuża. Jekk ma jkun meħtieġ ebda suffiss, ħassar il-linja.

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

Qabel ma tapplika l-konfigurazzjoni, hemm tliet passi oħra x’tlesti.

L-ewwel wieħed huwa li tinstalla l-pakketti `resolvconf` u `bridge-utils` sabiex il-konfigurazzjoni DNS speċifikata fil-fajl preċedenti tkun tista’ tiġi applikata u l-interfaċċa `br0` tkun tista’ tintuża:

```
1
```

It-tieni wieħed huwa li tiċċekkja l-konfigurazzjoni tal-fajl `/etc/hosts` fir-rigward tal-indirizz IP primarju tal-kompjuter (`IP_GW`).
Biex tagħmel dan, editja l-fajl `/etc/hosts` u ċċekkja li t-tieni linja tkun fil-format li ġej:

```
2
```

> **Eżempju**
>
> Jekk il-kompjuter jismu `EDGE-GATEWAY` mingħajr ma jappartjeni għal dominju u l-indirizz IP tiegħu `IP_GW` huwa `172.16.10.10`, allura l-fajl jimtela kif ġej:
>
> ```
> 2
> ```
>
> Jekk il-kompjuter jappartjeni għad-dominju `DOMAIN.LOCAL`, allura l-fajl jimtela kif ġej:
>
> ```
> 2
> ```

> **Attenzjoni!**
>
> Konfigurazzjoni ħażina tal-fajl tista’ tikkawża żball meta jiġi installat il-pakkett `collectd`.

Ma jibqa’ xejn ħlief li terġa’ tibda s-server:

```
1
```

### Konfigurazzjoni tal-maniġer tal-pakketti APT

Tella’ l-fajls imniżżla minn Systancia Marketplace fid-direttorju `/tmp/` fuq is-server billi tuża klijent SCP:

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

Idħol fis-server bħala `root`, imbagħad ħaddem il-kmandi li ġejjin biex tiddekompressa r-repożitorju ta’ Systancia, tikkonfigura l-użu tiegħu f’APT, u tawtentikah.

```
1
2
3
4
5
```

Nirrakkomandaw bil-qawwa li tiddiżattiva l-installazzjoni ta’ pakketti mhux meħtieġa meta tħaddem il-kmandi `apt`. Biex tagħmel dan, ħaddem il-kmand li ġej:

```
1
```

## Installazzjoni tas-server Edge Gateway ta’ CyberElements Bastion

### Installazzjoni tal-komponenti bażiċi

Ibda l-installazzjoni tal-komponenti billi tuża l-kmand li ġej bħala `root`:

```
1
```

Wara li jitniżżlu d-dipendenzi kollha, se tinfetaħ tieqa li titolbok tagħżel it-tip ta’ server. Agħżel `gateway`:

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

> **X’għandi nagħmel jekk ikun hemm żball?**
>
> Jekk ikun hemm żball fl-informazzjoni li daħħalt, kompli bl-installazzjoni tal-pakkett `ipdiva-base` u mbagħad uża l-kmand li ġej biex terġa’ tikkonfigura s-server:
>
> ```
> 1
> ```

### Installazzjoni tal-komponenti Edge Gateway

Imbagħad, ibda l-installazzjoni tal-komponenti speċifiċi għall-komponent Edge Gateway billi tuża l-kmand li ġej:

```
1
```

Il-komponenti tas-server Edge Gateway issa huma installati. Ma jibqa’ xejn ħlief li terġa’ tibda l-kompjuter sabiex il-komponenti installati ġodda jkunu jistgħu jinizjalizzaw:

```
1
```

### Installazzjoni tal-komponenti HTML5 Gateway

Uża l-kmand li ġej biex tibda l-installazzjoni tal-komponenti HTML5 Gateway fuq is-server Edge Gateway:

```
1
```

Uża l-linji tal-kmand li ġejjin biex tattiva u tikkonfigura l-funzjonalitajiet tat-trasferiment tal-fajls u tal-istampatur virtwali:

```
1
2
3
```

## Settings speċifiċi għat-tħaddim ta’ CyberElements Bastion

Ladarba jkunu ġew applikati s-settings tan-netwerk, għad trid tikkonnettja l-istanzi ta’ Edge Gateway u ta’ HTML5 Gateway mal-komponenti Mediation Controller.
Biex tagħmel dan, l-ewwel istanzi ta’ Edge Gateway u ta’ HTML5 Gateway se jikkonnettjaw mal-komponent Mediation Controller `MASTER`, filwaqt li t-tieni istanzi se jikkonnettjaw mal-komponent Mediation Controller `SLAVE`.

> **Attenzjoni!**
>
> Jekk l-installazzjoni tal-komponent Edge Gateway ma tinsabx fil-LAN u għalhekk l-indirizzi `RIP_MED_SSL_MASTER` u `RIP_MED_SSL_SLAVE` mhumiex aċċessibbli (lanqas b’NAT).
> F’dak il-każ, ikollok bżonn tikkonfigura biss l-ewwel istanza ta’ Edge Gateway u ta’ HTML5 Gateway, li se tiġi kkonfigurata biex tikkonnettja ma’ `VIP_MED_SSL`.
>
> F’dan il-kuntest, jista’ jintuża l-apparat virtwali Standalone. L-apparat virtwali Cluster huwa kkonfigurat minn qabel b’żewġ istanzi, filwaqt li l-ekwivalenti Standalone tiegħu huwa kkonfigurat minn qabel b’istanza waħda.

Qabel ma tkompli bl-istruzzjonijiet li ġejjin, kun żgur li għandek l-elementi li ġejjin:

- Ċertifikat għall-istanzi ta’ Edge Gateway u ta’ HTML5 Gateway li għandhom jiġu kkonnettjati
- Ċertifikat għas-servizz tar-reġistrazzjoni
- Klijent SSH (fuq Windows, tista’ tuża [PuTTY](https://putty.org/))
- Klijent SCP (fuq Windows, jistgħu jintużaw l-għodod [WinSCP](https://winscp.net/eng/index.php) jew [FileZilla](https://filezilla-project.org/))

Ittrasferixxi ċ-ċertifikati lejn id-direttorju `/tmp/` tal-kompjuter.

### Ħolqien ta’ istanzi għall-konnessjoni mal-komponent Mediation Controller `SLAVE`

Ħaddem il-kmandi li ġejjin bħala `root` biex tiddikjara istanza ġdida ta’ Edge Gateway u HTML5 Gateway li se tintuża biex tikkonnettja mal-komponent Mediation Controller `SLAVE`:

```
1
2
```

### Konnessjoni tal-komponenti Edge Gateway

Ikkopja l-fajl taċ-ċertifikat tal-komponent Edge Gateway fid-direttorji `/etc/ipdiva/gateway/ssl/` u `/etc/ipdiva/gateway-slave/ssl/`. Tista’ tagħmel dan billi tħaddem bħala `root` kmandi simili għal dawn li ġejjin (issostitwixxi `<CERT_NAME>` bl-isem taċ-ċertifikat għall-komponent Edge Gateway):

```
1
2
```

Ikkonfigura l-istanzi ta’ Edge Gateway biex ikunu jistgħu jikkonnettjaw mal-komponenti Mediation Controller.
Il-konfigurazzjonijiet ivarjaw skont il-komponent Mediation Controller li għandu jiġi kkuntattjat. Applika ż-żewġ settings:

**Konnessjoni mal-komponent Mediation Controller MASTER**

> Editja l-fajl `/etc/ipdiva/gateway/gateway.xml` u imlieh billi tuża l-informazzjoni li ġejja (diversi partijiet tħallew barra u huma indikati b’`[…]`):
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> ```
>
> Issostitwixxi l-elementi li ġejjin:
>
> - `_FILL_ME_WITH_SERVER_ADDRESS_:`: għandu jiġi sostitwit bl-indirizz `RIP_MED_SSL_MASTER`, bil-karattru `:`, u bil-port tas-smigħ tal-komponent SSL Router, li normalment huwa ssettjat għal `443`
> - `keyfile.pem`: għandu jiġi sostitwit bl-isem tal-fajl taċ-ċertifikat
> - `PASSWORD`: għandu jiġi sostitwit bil-password taċ-ċertifikat
>
> > **Eżempju**
> >
> > B’kont meħud tal-informazzjoni li ġejja:
> >
> > - `RIP_MED_SSL_MASTER` huwa ugwali għal: `10.0.10.11`
> > - Port tas-smigħ tal-komponent SSL Router: `443`
> > - Isem il-fajl taċ-ċertifikat: `edge-gateway.p12`
> > - Password taċ-ċertifikat: `Str0ngP@ssw0rd`
> >
> > Il-fajl `/etc/ipdiva/gateway/gateway.xml` jiġi kkonfigurat kif ġej:
> >
> > ```
> >  1
> >  2
> >  3
> >  4
> >  5
> >  6
> >  7
> >  8
> >  9
> > 10
> > ```
> >
> > > **Fajl komplut**
> > >
> > > ```
> > >  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
> > > ```
>
> Fl-aħħar, ibda l-istanza ta’ Edge Gateway biex jitgħabbew is-settings il-ġodda u biex tikkonnettjaha mal-komponent Mediation Controller `MASTER`:
>
> ```
> 1
> ```

**Konnessjoni mal-komponent Mediation Controller SLAVE**

> Editja l-fajl `/etc/ipdiva/gateway-slave/gateway.xml` u kompletah billi tuża l-informazzjoni li ġejja (diversi partijiet tħallew barra u huma indikati b’`[…]`):
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> ```
>
> Issostitwixxi l-elementi li ġejjin:
>
> - `@SERVER@`: għandu jiġi sostitwit bl-indirizz `RIP_MED_SSL_SLAVE`
> - `@SERVERPORT@`: għandu jiġi sostitwit bil-port tas-smigħ tal-komponent SSL Router, normalment issettjat għal `443`
> - `keyfile.pem`: għandu jiġi sostitwit bl-isem tal-fajl taċ-ċertifikat
> - `PASSWORD`: għandu jiġi sostitwit bil-password taċ-ċertifikat
> - `@RPC_PORT@`: għandu jiġi sostitwit b’port TCP disponibbli fuq il-kompjuter; normalment jintuża l-port `9081`
>
> > **Eżempju**
> >
> > B’kont meħud tal-informazzjoni li ġejja:
> >
> > - `RIP_MED_SSL_SLAVE` huwa ugwali għal: `10.0.10.13`
> > - Port tas-smigħ tal-komponent SSL Router: `443`
> > - Isem il-fajl taċ-ċertifikat: `edge-gateway.p12`
> > - Password taċ-ċertifikat: `Str0ngP@ssw0rd`
> > - Port RPC disponibbli: `9081`
> >
> > Il-fajl `/etc/ipdiva/gateway-slave/gateway.xml` jiġi kkonfigurat kif ġej:
> >
> > ```
> >  1
> >  2
> >  3
> >  4
> >  5
> >  6
> >  7
> >  8
> >  9
> > 10
> > 11
> > 12
> > ```
> >
> > > **Fajl komplut**
> > >
> > > ```
> > >  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
> > > ```
>
> Fl-aħħar, ibda l-istanza ta’ Edge Gateway biex jitgħabbew is-settings il-ġodda u biex tikkonnettjaha mal-komponent Mediation Controller `SLAVE`:
>
> ```
> 1
> ```

### Konfigurazzjoni tas-servizz tar-reġistrazzjoni

Ċaqlaq iċ-ċertifikat għas-servizz tar-reġistrazzjoni lejn id-direttorju `/etc/ipdiva/careserver/` b’kmand simili għal dan (issostitwixxi `<CERT_NAME>` bl-isem taċ-ċertifikat previst):

```
1
```

Imbagħad, ikkonfigura s-servizz billi timmodifika l-fajl li ġej: `/etc/ipdiva/careserver/careserver.xml`. Il-konfigurazzjoni tal-fajl għandha tkun xi ħaġa bħal din (il-parti li ġejja tħalli barra ħafna linji tal-fajl, immarkati b’`[…]`):

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

Agħmel il-bidliet li ġejjin:

- Ibdel l-indirizz IP tas-smigħ tas-servizz tar-reġistrazzjoni għal `0.0.0.0` (jisma’ fuq l-indirizzi IP disponibbli kollha)
- Issostitwixxi `recording_service.p12` bl-isem taċ-ċertifikat għas-servizz tar-reġistrazzjoni
- Issostitwixxi `PASSWORD` bil-password taċ-ċertifikat tas-servizz tar-reġistrazzjoni
- Żid il-linja `<element>http://127.0.0.1:9081</element>`

> **Eżempju**
>
> B’kont meħud tal-informazzjoni li ġejja:
>
> - Isem il-fajl taċ-ċertifikat: `fqdn.edge-gateway.local.p12`
> - Password taċ-ċertifikat: `Str0ngP@ssw0rd`
>
> Il-fajl `/etc/ipdiva/careserver/careserver.xml` jiġi kkonfigurat kif ġej:
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> ```
>
> > **Fajl komplut**
> >
> > ```
> >  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
> > ```

Ivvalida s-settings il-ġodda billi terġa’ tibda s-servizz tar-reġistrazzjoni:

```
1
```

### Konnessjoni tal-istanzi HTML5 Gateway

Jekk l-istanza HTML5 Gateway teħtieġ tiġi kkonfigurata, ħaddem il-kmand li ġej fuq is-server Edge Gateway bħala `root` biex tattiva l-bidu awtomatiku tal-istanza:

```
1
```

Ikkopja l-fajl taċ-ċertifikat tal-komponent HTML5 Gateway fid-direttorji `/etc/ipdiva/html5gateway/ssl/` u `/etc/ipdiva/html5gateway-slave/ssl/`. Tista’ tagħmel dan billi tħaddem bħala `root` kmandi simili għal dawn li ġejjin (issostitwixxi `<CERT_NAME>` bl-isem taċ-ċertifikat għall-komponent HTML5 Gateway):

```
1
2
```

Ikkonfigura l-istanzi ta’ HTML5 Gateway biex ikunu jistgħu jikkonnettjaw mal-komponenti Mediation Controller.
Il-konfigurazzjonijiet ivarjaw skont il-komponent Mediation Controller li għandu jiġi kkuntattjat. Applika ż-żewġ settings:

**Konnessjoni mal-komponent Mediation Controller MASTER**

> Editja l-fajl `/etc/ipdiva/html5gateway/html5gateway.xml` u kompletah billi tuża l-informazzjoni li ġejja (diversi partijiet tħallew barra u huma indikati b’`[…]`):
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> ```
>
> Issostitwixxi l-elementi li ġejjin:
>
> - `_FILL_ME_WITH_SERVER_ADDRESS_:`: għandu jiġi sostitwit bl-indirizz `RIP_MED_SSL_MASTER`, bil-karattru `:`, u bil-port tas-smigħ tal-komponent SSL Router, li normalment huwa ssettjat għal `443`
> - `keyfile.pem`: għandu jiġi sostitwit bl-isem tal-fajl taċ-ċertifikat
> - `PASSWORD`: għandu jiġi sostitwit bil-password taċ-ċertifikat
>
> > **Eżempju**
> >
> > B’kont meħud tal-informazzjoni li ġejja:
> >
> > - `RIP_MED_SSL_MASTER` huwa ugwali għal: `10.0.10.11`
> > - Port tas-smigħ tal-komponent SSL Router: `443`
> > - Isem il-fajl taċ-ċertifikat: `html5-gateway.p12`
> > - Password taċ-ċertifikat: `Str0ngP@ssw0rd`
> >
> > Il-fajl `/etc/ipdiva/html5gateway/html5gateway.xml` jiġi kkonfigurat kif ġej:
> >
> > ```
> >  1
> >  2
> >  3
> >  4
> >  5
> >  6
> >  7
> >  8
> >  9
> > 10
> > ```
> >
> > > **Fajl komplut**
> > >
> > > ```
> > >  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
> > > ```
>
> Fl-aħħar, erġa’ ibda l-istanza ta’ HTML5 Gateway biex jitgħabbew is-settings il-ġodda u biex tikkonnettjaha mal-komponent Mediation Controller `MASTER`:
>
> ```
> 1
> ```

**Konnessjoni mal-komponent Mediation Controller SLAVE**

> Editja l-fajl `/etc/ipdiva/html5gateway-slave/html5gateway.xml` u kompletah billi tuża l-informazzjoni li ġejja (diversi partijiet tħallew barra u huma indikati b’`[…]`):
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> ```
>
> Issostitwixxi l-elementi li ġejjin:
>
> - `@SERVER@`: għandu jiġi sostitwit bl-indirizz `RIP_MED_SSL_SLAVE`
> - `@SERVERPORT@`: għandu jiġi sostitwit bil-port tas-smigħ tal-komponent SSL Router, normalment issettjat għal `443`
> - `keyfile.pem`: għandu jiġi sostitwit bl-isem tal-fajl taċ-ċertifikat
> - `PASSWORD`: għandu jiġi sostitwit bil-password taċ-ċertifikat
> - `@RPC_PORT@`: għandu jiġi sostitwit b’port TCP disponibbli fuq il-kompjuter; normalment jintuża l-port `9089`
>
> > **Eżempju**
> >
> > B’kont meħud tal-informazzjoni li ġejja:
> >
> > - `RIP_MED_SSL_SLAVE` huwa ugwali għal: `10.0.10.13`
> > - Port tas-smigħ tal-komponent SSL Router: `443`
> > - Isem il-fajl taċ-ċertifikat: `html5-gateway.p12`
> > - Password taċ-ċertifikat: `Str0ngP@ssw0rd`
> > - Port RPC disponibbli: `9089`
> >
> > Il-fajl `/etc/ipdiva/html5gateway-slave/html5gateway.xml` jiġi kkonfigurat kif ġej:
> >
> > ```
> >  1
> >  2
> >  3
> >  4
> >  5
> >  6
> >  7
> >  8
> >  9
> > 10
> > 11
> > 12
> > ```
> >
> > > **Fajl komplut**
> > >
> > > ```
> > >  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
> > > ```
>
> Fl-aħħar, erġa’ ibda l-istanza ta’ HTML5 Gateway biex jitgħabbew is-settings il-ġodda u biex tikkonnettjaha mal-komponent Mediation Controller `SLAVE`:
>
> ```
> 1
> ```

### Konfigurazzjonijiet qabel il-konnessjoni tal-komponenti HTML5 Gateway

Sabiex l-applikazzjonijiet HTML5 jaħdmu, iridu jiġu kkonfigurati settings addizzjonali **fuq is-servers Mediation Controller**. Idħol bħala `root` fis-servers **Mediation Controller** `MASTER` u `SLAVE`.

Oħloq jew editja l-fajl `/etc/ipdiva/httpd/commonParameters.extra.conf` biex iżżid, għall-komponent HTML5 Gateway, parti ekwivalenti għal dik li ġejja:

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

Fejn:

- `URL_HTML5` għandu jiġi sostitwit bil-kontenut tal-qasam `URL` għall-komponent HTML5 Gateway ikkonfigurat fil-konsol tal-amministrazzjoni waqt [id-dikjarazzjoni tal-komponent HTML5 Gateway](https://docs.cyberelements.io/bastion/4.6/mt/Usage/Configuration/AdminConsole/CreateEdgeGateway/#__tabbed_1_2) (għal cluster, normalment dan huwa `HTML5-1` u `HTML5-2`).
- `GW_NAME` għandu jiġi sostitwit bl-isem ta’ komponent Edge Gateway li jinsab fuq l-istess server tal-komponent HTML5 Gateway. Il-karattru `|` fl-aħħar tal-linja **għandu jinżamm**.
- `ORGANIZATION_NAME` għandu jiġi sostitwit bl-isem tal-organizzazzjoni li magħha jikkonnettja l-komponent Edge Gateway preċedenti.

> **Eżempju**
>
> Għal pjattaforma bis-settings li ġejjin:
>
> - Isem l-organizzazzjoni: `my-organization-name`
> - Dikjarazzjoni tal-ewwel komponent HTML5 Gateway fil-konsol tal-amministrazzjoni:
>     - Name: `html5-gateway-1`
>     - URL: `HTML5-1`
>     - Protocol: `WebSocket`
> - Dikjarazzjoni tat-tieni komponent HTML5 Gateway fil-konsol tal-amministrazzjoni:
>     - Name: `html5-gateway-2`
>     - URL: `HTML5-2`
>     - Protocol: `WebSocket`
> - Server Edge Gateway fuq l-ewwel komponent HTML5 Gateway għandu:
>     - Servizz Edge Gateway bl-isem `edge-gateway-1`
>     - Servizz HTML5 Gateway bl-isem `html5-gateway-1`
> - Server Edge Gateway fuq it-tieni komponent HTML5 Gateway għandu:
>     - Servizz Edge Gateway bl-isem `edge-gateway-2`
>     - Servizz HTML5 Gateway bl-isem `html5-gateway-2`
>
> Il-fajl tal-konfigurazzjoni `/etc/ipdiva/httpd/commonParameters.extra.conf` maħluq se jiġi kkonfigurat kif ġej:
>
> ```
>  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
> ```

Qabel ma tapplika s-settings il-ġodda, trid tiċċekkja li l-konfigurazzjoni l-ġdida ma tikkawża ebda żball li jimblokka s-server web Apache2.
Biex tagħmel dan, ħaddem il-kmand li ġej:

```
1
```

Jekk ir-risposta tkun `Syntax OK`, allura l-bidliet jistgħu jiġu applikati bil-kmand hawn taħt. Inkella, iċċekkja l-konfigurazzjoni tiegħek fil-fajl `/etc/ipdiva/httpd/commonParameters.extra.conf`.

```
1
```

## Konfigurazzjoni ta’ server tal-ħin NTP

Huwa rakkomandat li tikkonfigura server tal-ħin biex l-arloġġ tas-sistema jibqa’ aġġornat. Il-passi meħtieġa huma deskritti [fil-paġna tal-konfigurazzjoni NTP](https://docs.cyberelements.io/bastion/4.6/mt/Usage/Configuration/EdgeGateway/ConfigureAnNTPServer/).
