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

# Az Edge Gateway üzem közbeni verziófrissítése

> **Fontos**
>
> Az Edge Gateway üzem közbeni verziófrissítéséről szóló dokumentáció minden Debian 11 rendszeren futó Edge Gateway komponensre vonatkozik. A Debian-verzió a következő paranccsal ellenőrizhető (SSH-n vagy konzolos hozzáféréssel futtatandó):
>
> ```
> 1
> ```

> **Információ**
>
> Emlékeztetőül: a Debian rendszerű számítógépeken a `root` felhasználóra való váltást a következő paranccsal kell végrehajtani:
>
> ```
> 1
> ```

## Tervezés és előkészítés

### Hálózati folyamok megnyitása

A termék verziófrissítésekor a Debian 11-ről a Debian 12-re való átállás miatt számos csomagot kell letölteni a Debian-tárházakból. A `TCP 80` hozzáférést meg kell nyitni a `security.debian.org` és az `ftp.fr.debian.org` címek felé.

A hálózati folyamok megnyitásának teszteléséhez elindítható a Debian-tárházak szinkronizálása a számítógépen. Ha a Debian-tárházak elérésével kapcsolatos hibaüzenetek jelennek meg, akkor a hálózati folyam nincs megnyitva, valószínűleg a vállalati tűzfal blokkolja. A tárházak szinkronizálása a következő paranccsal indítható el:

```
1
```

### A tükör és a szükséges eszközök letöltése

A CyberElements Cleanroom 4.6 tükör erről a hivatkozásról tölthető le (ügyfélfiók létrehozása szükséges): [Systancia Marketplace](https://www.systancia.com/en/my-systancia/marketplace/systancia-cleanroom/downloads-cleanroom/)

A CyberElements Bastion tárházát hitelesítő `systancia.gpg` kulcsot szintén a Systancia Marketplace-ről kell letölteni.

A tükör mellett a verziófrissítési folyamathoz harmadik féltől származó eszközökre is szükség lesz:

- Egy SSH-ügyfél (Windows rendszeren a [PuTTY](https://putty.org/) eszköz használható)
- Egy SCP-ügyfél (Windows rendszeren a [WinSCP](https://winscp.net/eng/index.php) vagy a [FileZilla](https://filezilla-project.org/) eszköz használható)

### A screen eszköz telepítése és használata

A `screen` eszközzel több rendszerhéj-terminált nyithat meg egyetlen konzolon. A CyberElements Bastion verziófrissítéséhez elengedhetetlen ennek az eszköznek a használata, hogy a folyamat ne függjön a hálózati kapcsolat stabilitásától. A screen eszköz használata nélkül ugyanis a telepítés leállna, ha megszakad az SSH-kapcsolat a CyberElements Bastion kiszolgálókkal.

A `screen` eszköz használatával a CyberElements Bastion eszközeinek rendszerhéj-konzoljához való újracsatlakozáskor visszakereshető az a terminál, amelyben a frissítési folyamat futott.

A screen csomagot a következő parancssorral kell telepíteni:

```
1
```

Új `screen` terminál megnyitásához a következő parancsot kell végrehajtani:

```
1
```

Cserélje le az `<ID>` helyőrzőt a munkamenetet azonosító névre.

> **Példa**
>
> A CyberElements verziófrissítései esetén a `cye-upgrade` azonosító könnyen felismerhető. A parancs tehát a következő:
>
> ```
> 1
> ```

Egy `screen` használatával megnyitott terminál újbóli eléréséhez egyszerűen hajtsa végre a következő parancsot:

```
1
```

Cserélje le az `<ID>` helyőrzőt a munkamenet megnyitásakor megadott névre.

> **Példa**
>
> A korábban a `cye-upgrade` azonosítóval megnyitott terminál a következő paranccsal érhető el újra:
>
> ```
> 1
> ```

A terminál bezárásához a verziófrissítés befejeztével írja be a terminálba az `exit` parancsot, vagy használja a ctrl+d billentyűparancsot.

Ezzel visszatér a konzolhoz. A „screen is terminating” üzenet megerősíti, hogy a terminál bezárult.

## Verziófrissítés

### A Debian-csomagok frissítése

Mivel a CyberElements Bastion verziófrissítése a Debian verziófrissítését is megköveteli, ajánlott a Debian 11 csomagjait megfelelően frissíteni, mielőtt átvált a Debian 12-re. Ehhez futtassa a következő parancsokat `root` felhasználóként (rendszerfrissítés, majd a szükségtelen csomagok eltávolítása):

```
1
2
3
```

Megjelenhetnek olyan üzenetek, amelyek több konfigurációs fájl konfigurációjának módosítását kérik. Ilyen esetben válassza a jelenlegi konfiguráció megtartását.

### A CyberElements Cleanroom 4.6 tükör előkészítése

Az előkészítési fázisban letöltött tükröt (tgz kiterjesztésű fájl) SCP-n keresztül kell a kiszolgálóra másolni. A `/tmp/` könyvtárba kell elhelyezni.

Ezután készítse elő a tükröt a következő parancsok `root` felhasználóként való végrehajtásával (a korábbi verziófrissítésekből visszamaradt fájlok törlődnek):

```
1
2
3
```

### Az APT konfigurálása

Az APT csomagkezelő a Debian 11 csomagjainak lekérésére van konfigurálva; újra kell konfigurálni, hogy a Debian 12 csomagjait kérje le. Frissíteni kell a CyberElements Bastion helyi tükörtárházára mutató hivatkozást is. Ehhez futtassa a következő parancsokat `root` felhasználóként:

```
1
2
```

A helyi tükörtárházat az előkészítési fázisban letöltött `systancia.gpg` kulcs hitelesíti. Küldje el SCP-n keresztül a kiszolgáló `/tmp/` könyvtárába, majd telepítse a következő paranccsal `root` felhasználóként:

```
1
```

Az új tárházak konfigurálásán túl kifejezetten ajánlott a következő beállítás alkalmazása, amely arra utasítja az APT-t, hogy ne telepítse a nem feltétlenül szükséges ajánlott függőségeket, így csökkentve a telepített összetevők számát. A következő parancs `root` felhasználóként alkalmazza ezt a beállítást:

```
1
```

Végül frissíteni kell a tárházakban lévő csomagok listáját a következő paranccsal:

```
1
```

### A verziófrissítés elindítása

Csatlakozzon SSH-n keresztül az Edge Gateway kiszolgálóhoz, váltson `root` felhasználóra, majd nyisson meg egy screen munkamenetet [a fentiek szerint](#installing-and-using-the-screen-tool).

Amikor egy Edge Gateway komponenst Debian 11-ről Debian 12-re frissít, a `collectd` csomag frissül, és nem lesz kompatibilis a CyberElements Bastion által létrehozott konfigurációs fájllal (`/etc/collectd/collectd.conf`). Ez hibát okozhat a frissítés során.

Ennek elkerülése érdekében kapcsolja ki a collectd szolgáltatást:

```
1
2
```

Ezt követően a verziófrissítés a következő paranccsal indítható el:

```
1
```

A verziófrissítés során a rendszer több kérdést is feltesz arról, hogy megtartsa-e a konfigurációs fájlokat és frissítse-e őket a Debian 12 szabványos konfigurációja szerint, vagy a meglévő egyedi konfigurációt hagyja érvényben. Íme az ajánlásaink a legtöbb olyan fájlhoz, amellyel találkozhat:

| Konfigurációs fájl | Javasolt művelet |
|---|---|
| /etc/issue | A megtartáshoz adja meg az `N` választ |
| /etc/issue.net | A megtartáshoz adja meg az `N` választ |
| /etc/security/limits.conf | A megtartáshoz adja meg az `N` választ |
| /etc/login.defs | A megtartáshoz adja meg az `N` választ |
| /etc/snmp/snmpd.conf | Módosítások alkalmazása, válasz: `Y` |
| /etc/ssh/sshd_config | Megtartás, válasz: `Keep the local version currently installed` |
| /etc/pam.d/su | Megtartás, válasz: `N` |
| /etc/sysctl.conf | Megtartás, válasz: `N` |
| /etc/audit/rules.d/audit.rules | Megtartás, válasz: `N` |
| /etc/ssh/ssh_config | Módosítások alkalmazása, válasz: `Y` |
| /usr/share/tomcat10/logrotate.template | Módosítások alkalmazása, válasz: `Install the package maintainer's version` |

Fogadja el a szolgáltatások automatikus újraindítását: ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYE_MediationControllerUpgrade_RestartServices.png)

A verziófrissítés befejezése után futtassa a következő parancsokat a `collectd` újraaktiválásához, a szükségtelen csomagok eltávolításához és a számítógép újraindításához:

```
1
2
3
4
```

## Validálás

A verziófrissítési művelet befejezése után, az éles üzembe való visszatérés előtt validálási fázisra van szükség, amely igazolja, hogy a CyberElements Bastion infrastruktúra megfelelően működik. Ha a validálás sikertelen, mérlegelni kell a visszagörgetést a CyberElements Bastion kiszolgálók biztonsági mentéseinek visszaállításával.

Nyissa meg a rendszergazdai felületet, majd az Edge Gateway komponensek kezelésére szolgáló menüt.

A frissített Edge Gateway komponenseknek a 8.9-es verziót kell jelezniük, ha sikeresen újracsatlakoztak a Mediation Controller komponenshez.

Ha az összes kiszolgáló verziófrissítése megtörtént, elvégezhető az összes funkcionális teszt a teljes átvételi ellenőrzőlista validálásához.
