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

# Titjib tal-verżjoni waqt it-tħaddim tal-komponent Edge Gateway

> **Importanti**
>
> Id-dokumentazzjoni għat-titjib tal-verżjoni waqt it-tħaddim tal-komponent Edge Gateway hija maħsuba għal kull komponent Edge Gateway li jaħdem fuq Debian 11. Il-verżjoni ta’ Debian tista’ tiġi vverifikata bil-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.

## 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 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 Edge Gateway permezz ta’ SSH u aqleb għal `root`, imbagħad iftaħ sessjoni screen [kif indikat hawn fuq](#installing-and-using-the-screen-tool).

Meta jsir titjib tal-verżjoni ta’ komponent Edge Gateway 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/snmp/snmpd.conf | Applika l-bidliet, wieġeb `Y` |
| /etc/ssh/sshd_config | Biex iżżomm il-fajl, wieġeb `Keep the local version currently installed` |
| /etc/pam.d/su | Biex iżżomm il-fajl, wieġeb `N` |
| /etc/sysctl.conf | Biex iżżomm il-fajl, wieġeb `N` |
| /etc/audit/rules.d/audit.rules | Biex iżżomm il-fajl, wieġeb `N` |
| /etc/ssh/ssh_config | Applika l-bidliet, wieġeb `Y` |
| /usr/share/tomcat10/logrotate.template | Applika l-bidliet, wieġeb `Install the package maintainer's version` |

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

## Validazzjoni

Meta titlesta l-operazzjoni tat-titjib tal-verżjoni, qabel ma terġa’ lura għall-produzzjoni hija meħtieġa fażi ta’ validazzjoni biex jiġi żgurat li l-infrastruttura CyberElements Bastion qed taħdem sew. Jekk il-validazzjoni tfalli, għandu jiġi kkunsidrat ritorn għall-istat preċedenti permezz tar-restawr tal-kopji ta’ riżerva tas-servers CyberElements Bastion.

Aċċessa l-interfaċċja tal-amministratur, imbagħad il-menu tal-ġestjoni tal-komponenti Edge Gateway.

Il-komponenti Edge Gateway aġġornati għandhom juru l-verżjoni 8.9 jekk ikkonnettjaw mill-ġdid b’suċċess mal-komponent Mediation Controller.

Jekk is-servers kollha għaddew minn titjib tal-verżjoni, tista’ twettaq it-testijiet funzjonali kollha biex tivvalida l-lista ta’ kontroll tal-aċċettazzjoni kollha.
