> Source: https://docs.cyberelements.io/bastion/4.6/mt/Upgrade/HotVersionUpgrade/MediationController/

# Titjib tal-verżjoni waqt it-tħaddim tal-komponent Mediation Controller

> **Importanti**
>
> Id-dokumentazzjoni għat-titjib tal-verżjoni waqt it-tħaddim tal-komponent Mediation Controller hija maħsuba għal kwalunkwe komponent Mediation Controller li jaħdem b’Debian 11. Il-verżjoni ta’ Debian tista’ tiġi vverifikata permezz tal-kmand li ġej (li għandu jitħaddem f’aċċess SSH jew mill-konsol):
>
> ```
> 1
> ```

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

## Ippjanar u preparazzjoni

### Ftuħ tal-flussi

Waqt it-titjib tal-verżjoni tal-prodott, ħafna pakketti jridu jitniżżlu mir-repożitorji ta’ Debian minħabba t-tranżizzjoni mill-verżjoni 11 għall-verżjoni 12 ta’ Debian. L-aċċess `TCP 80` irid jinfetaħ lejn `security.debian.org` u `ftp.fr.debian.org`.

Biex tittestja l-ftuħ tal-flussi fuq il-kompjuter, tista’ tniedi sinkronizzazzjoni tar-repożitorji ta’ Debian. Jekk jidhru messaġġi ta’ żball dwar l-aċċess għar-repożitorji ta’ Debian, il-fluss tan-netwerk mhuwiex miftuħ, probabbilment għax huwa mblukkat mill-firewall korporattiv. Is-sinkronizzazzjoni tar-repożitorji tista’ tinbeda bil-kmand li ġej:

```
1
```

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

Il-mirror ta’ CyberElements Cleanroom 4.6 jista’ jitniżżel minn dan il-link (jeħtieġ il-ħolqien ta’ kont ta’ klijent): [Systancia Marketplace](https://www.systancia.com/en/my-systancia/marketplace/systancia-cleanroom/downloads-cleanroom/)

Iċ-ċavetta `systancia.gpg`, li tawtentika r-repożitorju ta’ CyberElements Bastion, għandha titniżżel ukoll minn Systancia Marketplace.

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

- Klijent SSH (fuq Windows, tista’ tintuża l-għodda [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/))

### Installazzjoni u użu tal-għodda screen

L-għodda `screen` tippermettilek tiftaħ diversi terminals shell f’konsol wieħed. Huwa essenzjali li tuża din l-għodda biex twettaq it-titjib tal-verżjoni ta’ CyberElements Bastion, sabiex tneħħi d-dipendenza fuq l-istabbiltà tal-konnettività tan-netwerk. Fil-fatt, mingħajr l-użu tal-għodda screen, l-installazzjoni titwaqqaf f’każ ta’ interruzzjoni fil-konnettività SSH mas-servers ta’ CyberElements Bastion.

Bl-użu tal-għodda `screen`, meta terġa’ tikkonnettja mal-konsol shell tat-tagħmir ta’ CyberElements Bastion, it-terminal li fih ġie eżegwit il-proċess tal-aġġornament jista’ jiġi rkuprat.

Il-pakkett screen għandu jiġi installat bil-linja tal-kmand li ġejja:

```
1
```

Biex tiftaħ terminal `screen` ġdid, irid jiġi eżegwit il-kmand li ġej:

```
1
```

Ibdel `<ID>` b’isem li jidentifika s-sessjoni.

> **Eżempju**
>
> Għat-titjib tal-verżjoni ta’ CyberElements, l-identifikatur `cye-upgrade` jingħaraf faċilment. Għalhekk il-kmand ikun dan li ġej:
>
> ```
> 1
> ```

Biex terġa’ tikseb terminal miftuħ minn `screen`, sempliċement mexxi l-kmand li ġej:

```
1
```

Ibdel `<ID>` bl-isem iddefinit meta nfetħet is-sessjoni.

> **Eżempju**
>
> It-terminal miftuħ qabel bl-identifikatur `cye-upgrade` jista’ jerġa’ jinkiseb bil-kmand li ġej:
>
> ```
> 1
> ```

Biex tagħlaq it-terminal ladarba jitlesta t-titjib tal-verżjoni, daħħal il-kmand `exit` jew ix-shortcut tat-tastiera ctrl+d fit-terminal.

Dan iġibek lura għall-konsol. Il-messaġġ “screen is terminating” jikkonferma li t-terminal ingħalaq.

### Estensjoni tal-ispazju fuq id-diska għall-apparati virtwali

L-apparati virtwali Systancia Cleanroom 4.4 jew 4.5 jeħtieġu estensjoni tad-diska ta’ 4 GB li għandha tiżdied mal-partizzjoni `/usr`. Din l-operazzjoni hija meħtieġa biex ikun hemm biżżejjed spazju fuq id-diska għat-titjib tal-verżjoni u biex l-operazzjoni ma teħilx f’nofsha.

Meta tikkonnettja mal-komponent Mediation Controller, kemm permezz ta’ SSH kif ukoll fil-modalità konsol, messaġġ ta’ merħba jinfurmak li int ikkonnettjat ma’ kompjuter ta’ Systancia. Linja addizzjonali tindika l-verżjoni tal-apparat.

> **Eżempju**
>
> Apparat virtwali Mediation Controller li jħaddem il-verżjoni 4.5 se jagħti r-riżultat li ġej:
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> ```

Jekk il-kompjuter mhuwiex apparat virtwali pprovdut bil-verżjoni 4.4 jew 4.5, dan il-kapitolu jista’ jinqabeż biex tgħaddi [għat-titjib tal-verżjoni](#upgrade).

> **Kopja ta’ riżerva rakkomandata ħafna**
>
> Il-passi li ġejjin se jagħmlu bidliet fil-partizzjonament tad-diska tal-komponent Mediation Controller. Jekk saru bidliet manwali, l-istruzzjonijiet li ġejjin jistgħu ma jkunux adattati, u l-kompjuter jista’ jiġi bblukkat.
>
> Qabel ma tkompli, agħmel kopja ta’ riżerva tal-kompjuter jew, jekk meħtieġ, idduplika l-magna virtwali. Ma jistgħux jintużaw snapshots għaliex, b’mod partikolari ma’ VMware, dawn jimblukkaw il-possibbiltà li tiġi estiża diska.

Fil-livell tal-ipervisur, estendi l-ispazju fuq id-diska tal-magna virtwali b’4 GB addizzjonali. Jekk ma jkunx possibbli li tiġi estiża d-diska, iċċekkja li ma hemmx snapshots, u jekk le, itfi l-magna virtwali jekk l-estensjoni waqt it-tħaddim mhijiex appoġġata.

Ladarba l-ispazju fuq id-diska jkun ġie estiż fil-livell tal-magna virtwali, il-kmandi li ġejjin, li għandhom jitħaddmu bħala `root`, huma meħtieġa biex tiġi estiża l-partizzjoni `/usr`:

```
1
2
3
4
5
6
```

## Titjib tal-verżjoni

### Aġġornament tal-pakketti ta’ Debian

Peress li t-titjib tal-verżjoni ta’ CyberElements Bastion jeħtieġ titjib tal-verżjoni ta’ Debian, huwa rrakkomandat li taġġorna sew il-pakketti ta’ Debian 11 qabel ma taqleb għal Debian 12. Biex tagħmel dan, ħaddem il-kmandi li ġejjin bħala `root` (aġġornament tas-sistema u mbagħad tneħħija tal-pakketti mhux meħtieġa):

```
1
2
3
```

Jistgħu jidhru messaġġi li jitolbuk timmodifika l-konfigurazzjoni ta’ diversi fajls tal-konfigurazzjoni. F’dawn il-każijiet, agħżel l-opzjoni li żżomm il-konfigurazzjoni attwali.

### Preparazzjoni tad-drivers ta’ Microsoft SQL Server

Huma meħtieġa passi addizzjonali jekk id-drivers ta’ Microsoft SQL Server huma installati (dan huwa l-każ fl-apparati virtwali pprovduti minn CyberElements).
Biex tiċċekkja jekk humiex preżenti fuq is-server, il-kmand li ġej jista’ jitħaddem bħala `root`:

```
1
```

Jekk ma tidher l-ebda risposta, id-drivers mhumiex installati u tista’ tgħaddi [għall-pass tal-preparazzjoni tal-mirror](#preparing-the-cyberelements-cleanroom-46-mirror).
Inkella, jekk id-drivers huma installati, għandhom jidhru elenkati żewġ pakketti: `msodbcsql17` u `mssql-tools`. Segwi l-istruzzjonijiet f’dan il-kapitolu.

> **Eżempji**
>
> Server li fih id-drivers mhumiex installati jkollu r-riżultat li ġej mill-kmand preċedenti:
>
> ```
> 1
> ```
>
> Server li fih id-drivers huma installati se jkollu riżultat simili għal dan (il-verżjonijiet tal-pakketti jistgħu jvarjaw):
>
> ```
> 1
> 2
> 3
> ```

Il-kmandi li ġejjin huma meħtieġa biex tiġi installata verżjoni speċifika tal-pakketti ħalli jiġi żgurat titjib tal-verżjoni b’suċċess:

```
1
```

Ikkonfigura r-repożitorju ta’ Microsoft adattat għal Debian 12 biex tipprepara għat-titjib tal-verżjoni:

```
1
```

### Preparazzjoni tal-mirror ta’ CyberElements Cleanroom 4.6

Il-mirror miksub matul il-fażi tal-preparazzjoni (fajl bl-estensjoni tgz) irid jintbagħat lis-server permezz ta’ SCP. Għandu jitqiegħed fid-direttorju `/tmp/`.

Imbagħad, ipprepara l-mirror billi tmexxi l-kmandi li ġejjin bħala `root` (il-fajls residwi ta’ titjib tal-verżjoni antik se jitħassru):

```
1
2
3
```

### Konfigurazzjoni ta’ APT

Il-maniġer tal-pakketti APT huwa kkonfigurat biex jikseb il-pakketti ta’ Debian 11; irid jiġi kkonfigurat mill-ġdid biex jikseb il-pakketti ta’ Debian 12. Huwa meħtieġ ukoll li tiġi aġġornata r-referenza għall-mirror lokali ta’ CyberElements Bastion. Biex tagħmel dan, eżegwixxi l-kmandi li ġejjin bħala `root`:

```
1
2
```

Il-mirror lokali huwa awtentikat biċ-ċavetta `systancia.gpg` imniżżla matul il-fażi tat-tħejjija. Ibgħatha lis-server permezz ta’ SCP, fid-direttorju `/tmp/`, imbagħad installaha bil-kmand li ġej bħala `root`:

```
1
```

Minbarra l-konfigurazzjoni tar-repożitorji l-ġodda, nirrakkomandaw bil-qawwa li tapplika s-setting li ġej biex tgħid lil APT biex ma jinstallax dipendenzi rakkomandati li mhumiex strettament meħtieġa, sabiex jitnaqqas l-għadd ta’ komponenti installati. Il-kmand li ġej japplika dan is-setting bħala `root`:

```
1
```

Fl-aħħar, huwa meħtieġ li taġġorna l-lista tal-pakketti fir-repożitorji bil-kmand li ġej:

```
1
```

### Tnedija tat-titjib tal-verżjoni

Aċċessa s-server Mediation Controller permezz ta’ SSH u aqleb għal `root`, imbagħad iftaħ sessjoni screen [kif indikat hawn fuq](#installing-and-using-the-screen-tool).

Ibda billi taġġorna ċerti pakketti speċifiċi sabiex ikun jista’ jsir it-titjib tal-verżjoni. Huwa mistenni messaġġ ta’ żball meta jitħaddem l-ewwel kmand, iżda l-iżball se jiġi kkoreġut bit-tieni kmand:

```
1
2
```

Meta jsir titjib tal-verżjoni ta’ komponent Mediation Controller minn Debian 11 għal Debian 12, il-pakkett `collectd` jiġi aġġornat u jsir inkompatibbli mal-fajl tal-konfigurazzjoni ġġenerat minn CyberElements Bastion (`/etc/collectd/collectd.conf`). Dan jista’ jiġġenera żball waqt l-aġġornament.

Biex tevita dan, iddiżattiva collectd:

```
1
2
```

Wara dan, it-titjib tal-verżjoni jista’ jinbeda bil-kmand li ġej:

```
1
```

Waqt it-titjib tal-verżjoni, se ssirlek diversi mistoqsijiet dwar jekk għandekx iżżomm il-fajls tal-konfigurazzjoni u taġġornahom skont il-konfigurazzjoni standard ta’ Debian 12, jew iżżomm il-konfigurazzjoni speċifika eżistenti. Hawn huma r-rakkomandazzjonijiet tagħna għall-biċċa l-kbira tal-fajls li tista’ tiltaqa’ magħhom:

| Fajl tal-konfigurazzjoni | Azzjoni rakkomandata |
|---|---|
| /etc/issue | Żommu, wieġeb `N` |
| /etc/issue.net | Żommu, wieġeb `N` |
| /etc/security/limits.conf | Żommu, wieġeb `N` |
| /etc/login.defs | Żommu, wieġeb `N` |
| /etc/shibboleth/shibboleth2.xml | Biex iżżomm il-fajl, wieġeb `N` |
| /etc/shibboleth/shibd.logger | Applika l-bidliet, wieġeb `Y` |
| /etc/default/ntpsec | Applika l-bidliet, wieġeb `Y` |
| /etc/snmp/snmpd.conf | Applika l-bidliet, wieġeb `Y` |
| /etc/logrotate.d/IPdivaServer | Applika l-bidliet, wieġeb `Y` |
| /etc/ssh/sshd_config | Biex iżżomm il-fajl, wieġeb `Keep the local version currently installed` |
| /etc/ssh/ssh_config | Applika l-bidliet, wieġeb `Y` |
| /etc/apache2/ports.conf | Biex iżżomm il-fajl, wieġeb `N` |
| /etc/init.d/apache2 | Biex iżżomm il-fajl, wieġeb `N` |
| /etc/modsecurity/modsecurity.conf-recommended | Applika l-bidliet, wieġeb `Y` |
| /etc/ipdiva/httpd/commonParameters.conf | Applika l-bidliet, wieġeb `Y` |
| /etc/ipdiva/care/djangosettings.ini | Applika l-bidliet, wieġeb `Y` |
| /etc/crontab | Applika l-bidliet, wieġeb `Y` |
| /etc/openssl.cnf | Applika l-bidliet, wieġeb `Y` |
| /etc/audit/rules.d/audit.rules | Biex iżżomm il-fajl, wieġeb `N` |
| /etc/pam.d/su | Biex iżżomm il-fajl, wieġeb `N` |
| /etc/sysctl.conf | Biex iżżomm il-fajl, wieġeb `N` |

Aċċetta l-messaġġ tal-konfigurazzjoni tal-pakkett glibc: ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYE_MediationControllerUpgrade_glibc.png)

Aċċetta l-bidu mill-ġdid awtomatiku tas-servizzi: ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYE_MediationControllerUpgrade_RestartServices.png)

Meta jitlesta t-titjib tal-verżjoni, ħaddem il-kmandi li ġejjin biex terġa’ tattiva `collectd`, tneħħi l-pakketti mhux meħtieġa u terġa’ tibda l-kompjuter:

```
1
2
3
4
```

### Azzjonijiet speċifiċi għall-komponenti Mediation Controller f’Cluster

Fuq is-server Mediation Controller `SLAVE`, ħaddem il-kmandi li ġejjin biex terġa’ tissinkronizza s-sigriet kondiviż bejn il-komponent Mediation Controller `MASTER` u s-server `SLAVE`:

```
1
2
```

### Titjib tal-verżjoni tal-istanza tad-database PostgreSQL

Fuq is-server Mediation Controller, aġġorna l-istanza tad-database PostgreSQL mill-verżjoni 13 għall-verżjoni 15. Biex tagħmel dan, eżegwixxi l-istruzzjonijiet li ġejjin bid-drittijiet `root` xierqa.

Iċċekkja l-istatus tal-istanzi PostgreSQL qabel il-migrazzjoni:

```
1
```

Ħaddem il-kmandi li ġejjin biex taġġorna l-istanza tad-database għall-verżjoni 15 ta’ PostgreSQL:

```
1
2
3
4
```

Iċċekkja li l-istanza tad-database għaddiet b’suċċess minn titjib tal-verżjoni. Għandhom jidhru żewġ istanzi, waħda fil-verżjoni 13 u l-oħra fil-verżjoni 15, li hija l-unika waħda attiva. Il-verifika ssir bil-kmand li ġej:

```
1
```

Jekk it-titjib tal-verżjoni rnexxa, l-istanza tad-database tal-verżjoni 13 tista’ titħassar:

```
1
```

Tista’ tibda t-tħassir tal-pakketti PostgreSQL tal-verżjoni 13:

```
1
```

### Migrazzjoni tad-database ta’ CyberElements Bastion

Il-konfigurazzjoni tal-prodott hija maħżuna fid-database, li trid tiġi migrata sabiex tkun tista’ tinkludi l-konfigurazzjonijiet tal-bidliet introdotti mill-verżjoni l-ġdida. L-operazzjoni ssir fuq il-komponent Mediation Controller bħala `root`.

> **Arkitettura Cluster**
>
> Għal arkitettura Cluster, huwa meħtieġ li l-operazzjoni ssir minn komponent Mediation Controller wieħed biss, ikun liema jkun.
>
> Huwa meħtieġ ukoll li tħaddem il-kmand li ġej:
>
> ```
> 1
> ```

Il-migrazzjoni tad-data titnieda b’kmand ekwivalenti għal dan:

```
1
```

Fejn `<org_clr>` għandu jiġi sostitwit bl-isem tal-organizzazzjoni li trid tiġi migrata. Innota li jekk il-komponent Mediation Controller għandu diversi organizzazzjonijiet (multi-tenants), ikollok tħaddem il-kmand daqs kemm hemm organizzazzjonijiet li jridu jiġu migrati.

> **Eżempju**
>
> Għal pjattaforma CyberElements Bastion li għandha l-organizzazzjonijiet `systancia` u `systancia-test`, ikollok tħaddem il-kmandi li ġejjin:
>
> ```
> 1
> 2
> ```

Wara l-migrazzjoni tad-database, is-servizz Apache2 irid jerġa’ jinbeda:

```
1
```

### Restawr tal-konfigurazzjonijiet

Xi konfigurazzjonijiet inkitbu fuqhom matul il-proċess tat-titjib tal-verżjoni u jridu jiġu restawrati.

**Fajl commonParameters.conf:**

Mexxi t-tikketti `<Location>` relatati mal-komponenti HTML5 Gateway, li normalment jinsabu fl-aħħar tal-fajl, mill-fajl `/etc/ipdiva/httpd/commonParameters.conf.dpkg-old` għal `/etc/ipdiva/httpd/commonParameters.extra.conf` (oħloq il-fajl jekk ma jeżistix). Jekk ma hemm l-ebda tikketta `<Location>`, l-eżempji li ġejjin jistgħu jiġu kkupjati.

**standalone**

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

**cluster**

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

**Fajl djangosettings.ini:**

Ikkopja l-informazzjoni mil-linja 2 “allowed_hosts” tal-fajl `/etc/ipdiva/care/djangosettings.ini.dpkg-old` għall-fajl `/etc/ipdiva/care/djangosettings.ini`. Dan jista’ jiġi awtomatizzat bil-kmand li ġej bħala `root`:

```
1
```

**Applikazzjoni tar-restawri:**

Biex jiġu applikati r-restawri, huwa meħtieġ bidu mill-ġdid tas-servizz Apache2 bħala `root`:

```
1
```

## Validazzjoni

Ladarba jitlesta t-titjib tal-verżjoni, l-infrastruttura CyberElements Bastion trid tiġi vvalidata biex jiġi żgurat li qed taħdem sew qabel ma terġa’ lura fil-produzzjoni. Jekk il-validazzjoni tfalli, ikkunsidra li terġa’ lura għall-istat preċedenti billi tirrestawra l-kopji ta’ riżerva tas-servers CyberElements Bastion.

Aċċessa l-interfaċċja tal-amministrazzjoni ta’ organizzazzjoni, imbagħad mur fil-menu “About” fl-istrixxa tal-kontroll biex tiċċekkja li l-verżjoni tal-komponent Mediation Controller għaddiet b’suċċess għal 4.6.

Jistgħu jinbdew l-ewwel testijiet tal-funzjonalità tal-pjattaforma, iżda nirrakkomandaw li tuża l-verżjoni 4.6 tal-komponent Edge Gateway biex tiżgura prestazzjoni ottimali tal-applikazzjonijiet CyberElements Bastion.
