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

# Installazzjoni tas-server Mediation Controller

> **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 essenzjali li tikkonfigura indirizz tan-netwerk statiku għall-komponent Mediation Controller. Biex tagħmel dan, l-ewwel trid tikseb l-isem tal-interfaċċa tan-netwerk tal-kompjuter tiegħek. Ħaddem il-kmand li ġej bħala `root`:

```
1
```

Dan il-kmand juri l-isem tal-interfaċċa tan-netwerk, l-istatus tagħha, u l-indirizzi IP assenjati lill-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`.

Ladarba jkun inkiseb l-isem tal-interfaċċa tan-netwerk, 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
23
```

Fejn:

- `INTERFACE_NAME` għandu jiġi sostitwit bl-isem tal-interfaċċa tan-netwerk miksub qabel.
- `IP_MED_WEB` għandu jiġi sostitwit bl-indirizz IP prinċipali tas-server, li se jkun l-indirizz IP li permezz tiegħu jkunu aċċessibbli l-konsols web.
- `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.
- `IP_MED_SSL` għandu jiġi sostitwit bl-indirizz IP sekondarju tas-server. Dan se jkun l-indirizz IP li permezz tiegħu se jkun aċċessibbli l-komponent SSL Router.

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

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

L-ewwel wieħed huwa li tinstalla l-pakkett `resolvconf` sabiex il-konfigurazzjoni DNS speċifikata fil-fajl preċedenti tkun tista’ tiġi applikata:

```
1
```

It-tieni wieħed huwa li tiċċekkja l-konfigurazzjoni tal-fajl `/etc/hosts` fir-rigward tal-indirizz IP primarju tal-kompjuter (`IP_MED_WEB`).
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 `MEDIATION-CONTROLLER` mingħajr ma jappartjeni għal dominju u l-indirizz IP tiegħu `IP_MED_WEB` huwa `10.0.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`.

Fl-aħħar, ma jibqa’ xejn ħlief li terġa’ tibda s-servizz `networking` sabiex titgħabba l-konfigurazzjoni l-ġdida tan-netwerk:

```
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
```

### Verifika tal-preżenza tal-locale `en_US.utf8`

L-installazzjoni tas-server Mediation Controller teħtieġ il-ġenerazzjoni tal-locales `en_US.utf8`.
Biex tivverifika jekk diġà ġewx ġenerati fuq is-server, ħaddem il-kmand li ġej bħala `root`:

```
1
```

Jekk ir-riżultat tal-kmand juri `en_US.utf8`, [mur għall-pass li jmiss tal-konfigurazzjoni ta’ GRUB](#configuring-the-grub-boot-program).
Inkella, ħaddem il-kmandi li ġejjin biex iżżid dan il-locale mal-kompjuter:

```
1
2
```

### Konfigurazzjoni tal-programm tal-ibbutjar GRUB

Ladarba jkunu ġew eżegwiti dawn il-kmandi, trid terġa’ tibda l-kompjuter wara li tapplika setting fil-programm tal-ibbutjar GRUB:

```
1
2
3
```

## Installazzjoni tas-server Mediation Controller 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 `mediation`:

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

Imbagħad agħżel il-modalità tal-installazzjoni `standalone`:

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

Imbagħad ikollok iddaħħal il-port li fuqu se jisma’ l-komponent SSL Router. Dan il-port tas-smigħ normalment ikun issettjat għal `443`, iżda jista’ jintuża wkoll il-port `8443` jekk is-server Mediation Controller juża IP wieħed biss:

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

Imbagħad daħħal l-indirizz tal-aċċess web għas-server Mediation Controller (jikkorrispondi għal `IP_MED_WEB` fil-konfigurazzjoni tan-netwerk):

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

Fl-aħħar, daħħal l-indirizz IP tal-komponent SSL Router (jikkorrispondi għal `IP_MED_SSL` fil-konfigurazzjoni tan-netwerk):

![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/InstallCLRScratchStandalone-AdresseSSL.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 speċifiċi

Ibda l-installazzjoni tal-komponenti speċifiċi għas-server Mediation Controller bil-kmand li ġej:

```
1
```

Is-server irid jerġa’ jinbeda biex titlesta l-installazzjoni (uża l-kmand `reboot`).

## Installazzjoni tad-drivers għall-konnessjoni mad-databases Microsoft SQL Server

Jekk trid tikkonnettja ma’ database esterna u din hija Microsoft SQL Server, allura jridu jiġu installati drivers ODBC addizzjonali.

Hemm żewġ verżjonijiet disponibbli: il-verżjoni 17 u l-verżjoni 18.

> **Konnessjoni TLS meħtieġa għad-drivers fil-verżjoni 18**
>
> L-użu tad-drivers ODBC 18 jeħtieġ li l-konnessjoni tkun kriptata bl-użu ta’ TLS. Biex tagħmel dan, trid [tikkonfigura MS SQL Server għall-kriptaġġ tal-konnessjoni](https://learn.microsoft.com/en-us/sql/database-engine/configure-windows/configure-sql-server-encryption?view=sql-server-ver16).

Qabel ma tibda l-installazzjoni tad-drivers ODBC, trid tinstalla l-pakketti meħtieġa għat-tħejjija, imbagħad tħejji r-repożitorju ta’ Microsoft għall-installazzjoni tal-pakketti:

```
1
2
3
4
```

Imbagħad, installa d-drivers skont il-verżjoni magħżula u kkonfigura s-sistema biex tuża l-kmand `sqlcmd`:

**Drivers ODBC verżjoni 17**

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

**Drivers ODBC verżjoni 18**

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

Id-drivers ODBC issa huma installati b’mod korrett.
Jekk is-server Mediation Controller għandu aċċess għal server MS SQL, il-kmand li ġej għandu jippermetti l-konnessjoni mas-server remot:

```
1
```

Fejn:

- `SERVER` għandu jiġi sostitwit bl-isem DNS jew bl-indirizz IP tas-server MS SQL.
- `INSTANCE_NAME` għandu jiġi sostitwit bl-isem tal-istanza li magħha trid tikkonnettja; jekk mhux meħtieġ, neħħi wkoll il-karattru `\`.
- `PORT` għandu jiġi sostitwit bil-port tal-konnessjoni mal-istanza tad-database MS SQL.
- `USER` għandu jiġi sostitwit bl-isem tal-utent biex tiġi stabbilita l-konnessjoni.

> **Eżempji**
>
> Jekk is-server Mediation Controller għandu aċċess għal server tad-database MS SQL permezz tal-indirizz IP `10.0.10.100`, l-istanza li għandha tiġi aċċessata qed tisma’ fuq il-port `1433`, u l-kont tal-aċċess huwa `sql-user`. Allura l-kmand tal-konnessjoni huwa kif ġej:
>
> ```
> 1
> ```
>
> Kieku kellha tiġi speċifikata l-istanza tal-konnessjoni bl-isem `MSSQLINSTANCE`, il-kmand jiġi mmodifikat kif ġej:
>
> ```
> 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/MediationController/ConfigureAnNTPServer/).

## Konfigurazzjonijiet inizjali fuq CyberElements Bastion

Il-komponenti tas-server Mediation Controller huma installati. Issa trid tikkonfigura s-servizz Mediation Controller.

- (1) Ibdel il-passwords default

  ---

  Ibdel il-passwords default tal-konsols tas-sistema.

  [→ Ibdel](https://docs.cyberelements.io/bastion/4.6/mt/Usage/Configuration/SystemConsole/ChangePassword/)
- (2) Installazzjoni taċ-ċertifikati u tal-liċenzji

  ---

  Il-komponent Mediation Controller jeħtieġ diversi ċertifikati u liċenzja biex ikun operattiv.

  [→ Installa ċ-ċertifikati u l-liċenzja](https://docs.cyberelements.io/bastion/4.6/mt/Usage/Configuration/SystemConsole/ApplyCertificatesAndLicence/)
- (3) Konfigurazzjoni tal-awtoritajiet taċ-ċertifikazzjoni

  ---

  Żid l-awtorità jew l-awtoritajiet taċ-ċertifikazzjoni (CA) li ma jappartjenux lil Systancia u li se jintużaw għaċ-ċertifikati tal-komponenti Edge Gateway u HTML5 Gateway.

  [→ Ikkonfigura l-awtoritajiet taċ-ċertifikazzjoni affidabbli](https://docs.cyberelements.io/bastion/4.6/mt/Usage/Configuration/SystemConsole/AddANewTrustedCA/)
- (4) Ikkonfigura ċ-ċertifikat web

  ---

  Ikkonfigura ċ-ċertifikat web użat għall-konnessjoni mal-interfaċċi web

  [→ Ikkonfigura](https://docs.cyberelements.io/bastion/4.6/mt/Usage/Configuration/SystemConsole/ApplyWebCertificate/)
- (5) Iddikjara isem DNS

  ---

  Żid isem DNS awtorizzat biex jikkonnettja mal-interfaċċi web.

  [→ Żid](https://docs.cyberelements.io/bastion/4.6/mt/Usage/Configuration/SystemConsole/AddAllowedDNSName/)
- (6) Ikkonfigura l-ospitant virtwali SSL

  ---

  Konfigurazzjoni tal-ospitant virtwali SSL ta’ CyberElements Bastion, li permezz tiegħu tispeċifika l-indirizz tal-konnessjoni mal-komponent SSL Router għall-klijenti u għall-mekkaniżmu tal-pairing tal-komponenti Edge Gateway.

  [→ Ikkonfigura](https://docs.cyberelements.io/bastion/4.6/mt/Usage/Configuration/SystemConsole/ConfigureVirtualhostSSL/)
- (7) Ikkonfigura l-organizzazzjoni

  ---

  Konfigurazzjoni tal-organizzazzjoni ta’ CyberElements Bastion.

  [→ Ikkonfigura](https://docs.cyberelements.io/bastion/4.6/mt/Usage/Configuration/SystemConsole/AddOrganization/)
- (8) Iddikjara l-komponenti Edge Gateway

  ---

  Iddikjara l-komponenti Edge Gateway jew HTML5 Gateway li għandhom jiġu installati u iġġenera token tal-pairing.

  [→ Oħloq tokens tal-pairing](https://docs.cyberelements.io/bastion/4.6/mt/Usage/Configuration/AdminConsole/CreatePairingTokenForEdgeGateway/)
- (9) Oħloq sit loġiku

  ---

  Oħloq u kkonfigura sit loġiku li jiġbor flimkien il-komponenti Edge Gateway u HTML5 Gateway li jistgħu jaċċessaw ir-riżorsi lokali.

  [→ Oħloq sit](https://docs.cyberelements.io/bastion/4.6/mt/Usage/Configuration/AdminConsole/CreateSite/)
- (10) Installa komponent Edge Gateway

  ---

  Installa u kkonfigura komponent Edge Gateway ġdid mas-server Mediation Controller li għadu kif ġie installat.
  Tiġi kkonfigurata wkoll istanza HTML5 Gateway.

  [→ Installa](https://docs.cyberelements.io/bastion/4.6/mt/Installation/Standalone/FromScratch/InstallEdgeGateway/)
