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

# A Mediation Controller üzem közbeni verziófrissítése

> **Fontos**
>
> A Mediation Controller üzem közbeni verziófrissítéséről szóló dokumentáció minden Debian 11 rendszeren futó Mediation Controller komponensre vonatkozik. A Debian verziója a következő paranccsal ellenőrizhető (SSH-n vagy konzolhozzáférésen keresztül 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.

### Lemezterület bővítése virtuális berendezéseken

A Systancia Cleanroom 4.4-es vagy 4.5-ös virtuális berendezéseken 4 GB-os lemezbővítést kell hozzáadni a `/usr` partícióhoz. Erre a műveletre azért van szükség, hogy elegendő lemezterület álljon rendelkezésre a verziófrissítéshez, és a művelet ne akadjon el.

Amikor SSH-n vagy konzolmódban csatlakozik a Mediation Controller komponenshez, egy üdvözlő üzenet tájékoztatja arról, hogy Systancia-számítógéphez csatlakozott. Egy további sor az appliance verzióját jelzi.

> **Példa**
>
> A 4.5-ös verziót futtató Mediation Controller virtuális berendezés a következő eredményt adja:
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> ```

Ha a számítógép nem a 4.4-es vagy 4.5-ös verzióval szállított virtuális berendezés, ez a fejezet kihagyható, és közvetlenül [a verziófrissítéssel](#upgrade) lehet folytatni.

> **Biztonsági mentés erősen ajánlott**
>
> A következő lépések módosítják a Mediation Controller kiszolgáló lemezének particionálását. Ha korábban kézi módosításokat végeztek, előfordulhat, hogy az alábbi utasítások nem megfelelőek, és a számítógép blokkolt állapotba kerül.
>
> A folytatás előtt készítsen biztonsági mentést a számítógépről, vagy szükség esetén duplikálja a virtuális gépet. Pillanatképek nem használhatók, mert – különösen VMware esetén – megakadályozzák a lemez bővítését.

Bővítse a virtuális gép lemezterületét további 4 GB-tal a hipervizor szintjén. Ha a lemez nem bővíthető, ellenőrizze, hogy nincsenek-e pillanatképek, és ha nincsenek, állítsa le a virtuális gépet, amennyiben az üzem közbeni bővítés nem támogatott.

Miután a virtuális gép szintjén megtörtént a lemezterület bővítése, a `/usr` partíció bővítéséhez a következő, `root` felhasználóként futtatandó parancsokra van szükség:

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

## 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 Microsoft SQL Server illesztőprogramjainak előkészítése

További lépésekre van szükség, ha a Microsoft SQL Server illesztőprogramjai telepítve vannak (ez a helyzet a CyberElements által szállított virtuális berendezéseken).
Annak ellenőrzéséhez, hogy jelen vannak-e a kiszolgálón, a következő parancs futtatható `root` felhasználóként:

```
1
```

Ha nem jelenik meg válasz, az illesztőprogramok nincsenek telepítve, és folytathatja [a tükör előkészítésének lépésével](#preparing-the-cyberelements-cleanroom-46-mirror).
Ellenkező esetben, ha az illesztőprogramok telepítve vannak, két csomagnak kell megjelennie a listában: `msodbcsql17` és `mssql-tools`. Kövesse az ebben a fejezetben leírt utasításokat.

> **Példák**
>
> Egy olyan kiszolgálón, amelyen az illesztőprogramok nincsenek telepítve, az előző parancs a következő eredményt adná:
>
> ```
> 1
> ```
>
> Egy olyan kiszolgálón, amelyen az illesztőprogramok telepítve vannak, az eredmény ehhez hasonló lesz (a csomagok verziói eltérhetnek):
>
> ```
> 1
> 2
> 3
> ```

A sikeres verziófrissítés biztosításához a következő parancsokkal a csomagok egy adott verzióját kell telepíteni:

```
1
```

A verziófrissítés előkészítéséhez konfigurálja a Debian 12-höz igazított Microsoft-tárházat:

```
1
```

### 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 a Mediation Controller kiszolgálóhoz, váltson `root` felhasználóra, majd nyisson meg egy screen munkamenetet [a fentiekben leírtak szerint](#installing-and-using-the-screen-tool).

Először frissítsen bizonyos csomagokat, hogy a verziófrissítés elvégezhető legyen. Az első parancs végrehajtásakor hibaüzenet várható, de a második parancs kijavítja a hibát:

```
1
2
```

Egy Mediation Controller kiszolgáló Debian 11-ről Debian 12-re történő verziófrissítésekor a `collectd` csomag frissül, és nem lesz kompatibilis a CyberElements Bastion által generált 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/shibboleth/shibboleth2.xml | Megtartás, válasz: `N` |
| /etc/shibboleth/shibd.logger | Módosítások alkalmazása, válasz: `Y` |
| /etc/default/ntpsec | Módosítások alkalmazása, válasz: `Y` |
| /etc/snmp/snmpd.conf | Módosítások alkalmazása, válasz: `Y` |
| /etc/logrotate.d/IPdivaServer | Módosítások alkalmazása, válasz: `Y` |
| /etc/ssh/sshd_config | Megtartás, válasz: `Keep the local version currently installed` |
| /etc/ssh/ssh_config | Módosítások alkalmazása, válasz: `Y` |
| /etc/apache2/ports.conf | Megtartás, válasz: `N` |
| /etc/init.d/apache2 | Megtartás, válasz: `N` |
| /etc/modsecurity/modsecurity.conf-recommended | Módosítások alkalmazása, válasz: `Y` |
| /etc/ipdiva/httpd/commonParameters.conf | Módosítások alkalmazása, válasz: `Y` |
| /etc/ipdiva/care/djangosettings.ini | Módosítások alkalmazása, válasz: `Y` |
| /etc/crontab | Módosítások alkalmazása, válasz: `Y` |
| /etc/openssl.cnf | Módosítások alkalmazása, válasz: `Y` |
| /etc/audit/rules.d/audit.rules | Megtartás, válasz: `N` |
| /etc/pam.d/su | Megtartás, válasz: `N` |
| /etc/sysctl.conf | Megtartás, válasz: `N` |

Fogadja el a glibc csomag konfigurációs üzenetét: ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYE_MediationControllerUpgrade_glibc.png)

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

### A Mediation Controller fürtre vonatkozó műveletek

A `SLAVE` Mediation Controller kiszolgálón futtassa a következő parancsokat a `MASTER` Mediation Controller és a `SLAVE` közötti közös titkos kód újraszinkronizálásához:

```
1
2
```

### A PostgreSQL-adatbázispéldány verziófrissítése

A Mediation Controller kiszolgálón frissítse a PostgreSQL-adatbázispéldányt a 13-as verzióról a 15-ös verzióra. Ehhez hajtsa végre a következő utasításokat a megfelelő `root` jogokkal.

A migrálás előtt ellenőrizze a PostgreSQL-példányok állapotát:

```
1
```

Futtassa a következő parancsokat az adatbázispéldány PostgreSQL 15-ös verzióra való frissítéséhez:

```
1
2
3
4
```

Ellenőrizze, hogy az adatbázispéldány verziófrissítése sikeres volt-e. Két példánynak kell megjelennie: egy 13-as és egy 15-ös verziójúnak, amely az egyetlen aktív. Az ellenőrzés a következő paranccsal történik:

```
1
```

Ha a verziófrissítés sikeres volt, a 13-as verziójú adatbázispéldány törölhető:

```
1
```

Elindítható a 13-as verziójú PostgreSQL-csomagok törlése:

```
1
```

### A CyberElements Bastion adatbázis migrálása

A termék konfigurációját az adatbázis tárolja, amelyet migrálni kell, hogy tartalmazhassa az új verzió által bevezetett változások konfigurációit. A műveletet a Mediation Controller kiszolgálón kell elvégezni `root` felhasználóként.

> **Cluster architektúra**
>
> Cluster architektúra esetén a műveletet csak egyetlen Mediation Controller kiszolgálóról kell elvégezni, mindegy, melyikről.
>
> Ezenkívül a következő parancsot is futtatni kell:
>
> ```
> 1
> ```

Az adatmigrálás egy ehhez hasonló paranccsal indítható:

```
1
```

Itt a `<org_clr>` helyére a migrálandó szervezet nevét kell írni. Felhívjuk figyelmét, hogy ha a Mediation Controller több szervezetet kezel (multi-tenant), a parancsot annyiszor kell futtatnia, ahány szervezetet migrálni kell.

> **Példa**
>
> A `systancia` és a `systancia-test` szervezettel rendelkező CyberElements Bastion platform esetében a következő parancsokat kell futtatnia:
>
> ```
> 1
> 2
> ```

Az adatbázis migrálása után újra kell indítani az Apache2 szolgáltatást:

```
1
```

### Konfigurációk visszaállítása

Egyes konfigurációk felülíródtak a verziófrissítési folyamat során, ezért vissza kell állítani őket.

**commonParameters.conf fájl:**

Helyezze át a HTML5 Gateway komponensekre vonatkozó `<Location>` címkéket, amelyek általában a fájl végén találhatók, a `/etc/ipdiva/httpd/commonParameters.conf.dpkg-old` fájlból a `/etc/ipdiva/httpd/commonParameters.extra.conf` fájlba (hozza létre a fájlt, ha nem létezik). Ha nincsenek `<Location>` címkék, a következő példák másolhatók.

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

**djangosettings.ini fájl:**

Másolja át a `/etc/ipdiva/care/djangosettings.ini.dpkg-old` fájl 2. sorában található „allowed_hosts” információt a `/etc/ipdiva/care/djangosettings.ini` fájlba. Ez a következő paranccsal automatizálható `root` felhasználóként:

```
1
```

**A visszaállítások alkalmazása:**

A visszaállítások alkalmazásához újra kell indítani az Apache2 szolgáltatást `root` felhasználóként:

```
1
```

## Validálás

A verziófrissítés befejezése után, az éles üzembe való visszatérés előtt validálni kell a CyberElements Bastion infrastruktúrát, hogy megbizonyosodjon a megfelelő működéséről. Ha a validálás sikertelen, fontolja meg a visszagörgetést a CyberElements Bastion kiszolgálók biztonsági mentéseinek visszaállításával.

Nyissa meg egy szervezet rendszergazdai felületét, majd a vezérlősáv „About” menüjét, és ellenőrizze, hogy a Mediation Controller verziója sikeresen 4.6-ra frissült.

Megkezdhetők a platform működésének első tesztjei, de a CyberElements Bastion alkalmazások optimális teljesítménye érdekében az Edge Gateway 4.6-os verziójának használatát javasoljuk.
