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

# Mediation Controller versijos atnaujinimas veikimo metu

> **Svarbu**
>
> Mediation Controller versijos atnaujinimo veikimo metu dokumentacija skirta visiems Mediation Controller serveriams, veikiantiems su Debian 11. Debian versiją galima patikrinti šia komanda (vykdoma per SSH arba konsolės prieigą):
>
> ```
> 1
> ```

> **Informacija**
>
> Primename, kad Debian kompiuteriuose pereiti į `root` reikia šia komanda:
>
> ```
> 1
> ```

## Planavimas ir pasirengimas

### Tinklo srautų atidarymas

Atnaujinant produkto versiją, dėl perėjimo nuo Debian 11 prie Debian 12 iš Debian saugyklų reikia atsisiųsti daug paketų. Turi būti atidaryta `TCP 80` prieiga prie `security.debian.org` ir `ftp.fr.debian.org`.

Norint patikrinti, ar kompiuteryje atidaryti srautai, galima paleisti Debian saugyklų sinchronizavimą. Jei rodomi klaidų pranešimai dėl prieigos prie Debian saugyklų, vadinasi, tinklo srautas neatidarytas – greičiausiai jį blokuoja įmonės užkarda. Saugyklų sinchronizavimą galima paleisti šia komanda:

```
1
```

### Veidrodžio ir reikiamų įrankių atsisiuntimas

CyberElements Cleanroom 4.6 veidrodį galima atsisiųsti šiuo saitu (reikia susikurti kliento paskyrą): [Systancia Marketplace](https://www.systancia.com/en/my-systancia/marketplace/systancia-cleanroom/downloads-cleanroom/)

Raktą `systancia.gpg`, kuriuo autentifikuojama CyberElements Bastion saugykla, taip pat reikia atsisiųsti iš Systancia Marketplace.

Be veidrodžio, versijos atnaujinimo procesui reikės trečiųjų šalių įrankių:

- SSH klientas (Windows sistemoje galima naudoti įrankį [PuTTY](https://putty.org/))
- SCP klientas (Windows sistemoje galima naudoti įrankius [WinSCP](https://winscp.net/eng/index.php) arba [FileZilla](https://filezilla-project.org/))

### Įrankio screen diegimas ir naudojimas

Įrankis `screen` leidžia vienoje konsolėje atidaryti kelis apvalkalo terminalus. Šį įrankį būtina naudoti atnaujinant CyberElements Bastion versiją, kad būtų pašalinta priklausomybė nuo tinklo ryšio stabilumo. Iš tiesų, nenaudojant įrankio screen, nutrūkus SSH ryšiui su CyberElements Bastion serveriais diegimas būtų sustabdytas.

Naudojant įrankį `screen`, iš naujo prisijungus prie CyberElements Bastion įrangos apvalkalo konsolės, galima atkurti terminalą, kuriame buvo vykdomas naujinimo procesas.

Paketą screen reikėtų įdiegti šia komandine eilute:

```
1
```

Norint atidaryti naują `screen` terminalą, reikia vykdyti šią komandą:

```
1
```

Pakeiskite `<ID>` pavadinimu, identifikuojančiu seansą.

> **Pavyzdys**
>
> Atnaujinant CyberElements versiją, identifikatorių `cye-upgrade` lengva atpažinti. Todėl komanda būtų tokia:
>
> ```
> 1
> ```

Norint atkurti `screen` atidarytą terminalą, tereikia vykdyti šią komandą:

```
1
```

Pakeiskite `<ID>` pavadinimu, nustatytu atidarant seansą.

> **Pavyzdys**
>
> Anksčiau su identifikatoriumi `cye-upgrade` atidarytą terminalą galima atkurti šia komanda:
>
> ```
> 1
> ```

Norėdami uždaryti terminalą, kai versijos atnaujinimas baigtas, terminale įveskite komandą `exit` arba paspauskite spartųjį klavišą ctrl+d.

Taip grįšite į konsolę. Pranešimas „screen is terminating“ patvirtina, kad terminalas uždarytas.

### Disko vietos išplėtimas virtualiesiems įrenginiams

Systancia Cleanroom 4.4 arba 4.5 virtualiesiems įrenginiams reikia prie `/usr` skaidinio pridėti 4 GB disko plėtinį. Šis veiksmas būtinas, kad versijos atnaujinimui pakaktų disko vietos ir operacija nestrigtų.

Jungiantis prie Mediation Controller per SSH arba konsolės režimu, pasveikinimo pranešimas informuos, kad esate prisijungę prie Systancia kompiuterio. Papildomoje eilutėje nurodoma appliance versija.

> **Pavyzdys**
>
> Mediation Controller virtualusis įrenginys, kurio versija 4.5, pateiks tokį rezultatą:
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> ```

Jei kompiuteris nėra virtualusis įrenginys, pateiktas su 4.4 arba 4.5 versija, šį skyrių galima praleisti ir pereiti [prie versijos atnaujinimo](#upgrade).

> **Primygtinai rekomenduojama sukurti atsarginę kopiją**
>
> Atlikus toliau nurodytus veiksmus, bus pakeistas Mediation Controller disko skaidymas. Jei buvo atlikta rankinių pakeitimų, toliau pateiktos instrukcijos gali netikti ir kompiuteris gali būti užblokuotas.
>
> Prieš tęsdami sukurkite kompiuterio atsarginę kopiją arba, jei reikia, dubliuokite virtualiąją mašiną. Momentinių kopijų naudoti negalima, nes, ypač naudojant VMware, jos neleidžia išplėsti disko.

Hipervizoriaus lygmeniu padidinkite virtualiosios mašinos disko vietą papildomais 4 GB. Jei disko išplėsti neįmanoma, patikrinkite, ar nėra momentinių kopijų, o jei jų nėra, išjunkite virtualiąją mašiną, jei išplėtimas jai veikiant nepalaikomas.

Išplėtus disko vietą virtualiosios mašinos lygmeniu, norint išplėsti `/usr` skaidinį, būtina vykdyti šias komandas kaip `root`:

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

## Versijos atnaujinimas

### Debian paketų naujinimas

Kadangi CyberElements Bastion versijos atnaujinimui reikia atnaujinti Debian versiją, prieš pereinant prie Debian 12 rekomenduojama tinkamai naujinti Debian 11 paketus. Norėdami tai padaryti, vykdykite šias komandas kaip `root` (sistemos naujinimas, tada nereikalingų paketų šalinimas):

```
1
2
3
```

Gali būti rodomi pranešimai, raginantys pakeisti kelių konfigūracijos failų konfigūraciją. Tokiais atvejais pasirinkite parinktį išlaikyti esamą konfigūraciją.

### Microsoft SQL Server tvarkyklių paruošimas

Jei įdiegtos Microsoft SQL Server tvarkyklės (taip yra CyberElements pateiktuose virtualiuosiuose įrenginiuose), reikia atlikti papildomų veiksmų.
Norėdami patikrinti, ar jos yra serveryje, galite vykdyti šią komandą kaip `root`:

```
1
```

Jei atsakymas nepasirodo, tvarkyklės neįdiegtos ir galite pereiti prie [veidrodžio paruošimo veiksmo](#preparing-the-cyberelements-cleanroom-46-mirror).
Kitu atveju, jei tvarkyklės įdiegtos, turėtų būti išvardyti du paketai: `msodbcsql17` ir `mssql-tools`. Vykdykite šio skyriaus instrukcijas.

> **Pavyzdžiai**
>
> Serveris, kuriame tvarkyklės neįdiegtos, vykdant ankstesnę komandą pateiktų tokį rezultatą:
>
> ```
> 1
> ```
>
> Serveris, kuriame tvarkyklės įdiegtos, pateiks panašų rezultatą (paketų versijos gali skirtis):
>
> ```
> 1
> 2
> 3
> ```

Norint įdiegti konkrečią paketų versiją ir užtikrinti sėkmingą versijos atnaujinimą, būtina vykdyti šias komandas:

```
1
```

Sukonfigūruokite Debian 12 pritaikytą Microsoft saugyklą, kad pasirengtumėte versijos atnaujinimui:

```
1
```

### CyberElements Cleanroom 4.6 veidrodžio paruošimas

Pasirengimo etape gautą veidrodį (failą su plėtiniu tgz) reikia nusiųsti į serverį per SCP. Jį reikėtų padėti kataloge `/tmp/`.

Tada paruoškite veidrodį vykdydami šias komandas kaip `root` (bus panaikinti likę ankstesnio versijos atnaujinimo failai):

```
1
2
3
```

### APT konfigūracija

Paketų tvarkytuvė APT sukonfigūruota gauti Debian 11 paketus; ją reikia iš naujo sukonfigūruoti, kad gautų Debian 12 paketus. Taip pat reikia atnaujinti nuorodą į vietinį CyberElements Bastion veidrodį. Norėdami tai padaryti, vykdykite šias komandas kaip `root`:

```
1
2
```

Vietinis veidrodis autentifikuojamas raktu `systancia.gpg`, atsisiųstu parengimo etape. Nusiųskite jį į serverį per SCP, į katalogą `/tmp/`, tada įdiekite jį šia komanda kaip `root`:

```
1
```

Be naujų saugyklų konfigūravimo, primygtinai rekomenduojame taikyti šį parametrą, kad APT nediegtų rekomenduojamų, bet nebūtinų priklausomybių – taip sumažės įdiegtų komponentų skaičius. Šis parametras taikomas kaip `root` vykdant šią komandą:

```
1
```

Galiausiai reikia atnaujinti saugyklų paketų sąrašą šia komanda:

```
1
```

### Versijos atnaujinimo paleidimas

Prisijunkite prie Mediation Controller serverio per SSH ir persijunkite į `root`, tada atidarykite screen seansą, [kaip nurodyta aukščiau](#installing-and-using-the-screen-tool).

Pirmiausia atnaujinkite tam tikrus konkrečius paketus, kad būtų galima atlikti versijos atnaujinimą. Vykdant pirmąją komandą tikėtinas klaidos pranešimas, tačiau klaidą ištaisys antroji komanda:

```
1
2
```

Atnaujinant Mediation Controller versiją iš Debian 11 į Debian 12, paketas `collectd` atnaujinamas ir tampa nesuderinamas su CyberElements Bastion sugeneruotu konfigūracijos failu (`/etc/collectd/collectd.conf`). Dėl to naujinimo metu gali įvykti klaida.

Kad to išvengtumėte, išjunkite collectd:

```
1
2
```

Po to versijos atnaujinimą galima paleisti šia komanda:

```
1
```

Versijos atnaujinimo metu jūsų bus kelis kartus paklausta, ar išlaikyti konfigūracijos failus ir juos atnaujinti pagal standartinę Debian 12 konfigūraciją, ar palikti esamą specifinę konfigūraciją. Štai mūsų rekomendacijos dėl daugumos failų, su kuriais galite susidurti:

| Konfigūracijos failas | Rekomenduojamas veiksmas |
|---|---|
| /etc/issue | Norėdami palikti, atsakykite `N` |
| /etc/issue.net | Norėdami palikti, atsakykite `N` |
| /etc/security/limits.conf | Norėdami palikti, atsakykite `N` |
| /etc/login.defs | Norėdami palikti, atsakykite `N` |
| /etc/shibboleth/shibboleth2.xml | Norėdami palikti, atsakykite `N` |
| /etc/shibboleth/shibd.logger | Norėdami pritaikyti pakeitimus, atsakykite `Y` |
| /etc/default/ntpsec | Norėdami pritaikyti pakeitimus, atsakykite `Y` |
| /etc/snmp/snmpd.conf | Norėdami pritaikyti pakeitimus, atsakykite `Y` |
| /etc/logrotate.d/IPdivaServer | Norėdami pritaikyti pakeitimus, atsakykite `Y` |
| /etc/ssh/sshd_config | Norėdami palikti, atsakykite `Keep the local version currently installed` |
| /etc/ssh/ssh_config | Norėdami pritaikyti pakeitimus, atsakykite `Y` |
| /etc/apache2/ports.conf | Norėdami palikti, atsakykite `N` |
| /etc/init.d/apache2 | Norėdami palikti, atsakykite `N` |
| /etc/modsecurity/modsecurity.conf-recommended | Norėdami pritaikyti pakeitimus, atsakykite `Y` |
| /etc/ipdiva/httpd/commonParameters.conf | Norėdami pritaikyti pakeitimus, atsakykite `Y` |
| /etc/ipdiva/care/djangosettings.ini | Norėdami pritaikyti pakeitimus, atsakykite `Y` |
| /etc/crontab | Norėdami pritaikyti pakeitimus, atsakykite `Y` |
| /etc/openssl.cnf | Norėdami pritaikyti pakeitimus, atsakykite `Y` |
| /etc/audit/rules.d/audit.rules | Norėdami palikti, atsakykite `N` |
| /etc/pam.d/su | Norėdami palikti, atsakykite `N` |
| /etc/sysctl.conf | Norėdami palikti, atsakykite `N` |

Sutikite su glibc paketo konfigūracijos pranešimu: ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYE_MediationControllerUpgrade_glibc.png)

Sutikite su automatiniu paslaugų paleidimu iš naujo: ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYE_MediationControllerUpgrade_RestartServices.png)

Baigę versijos atnaujinimą, vykdykite šias komandas, kad vėl suaktyvintumėte `collectd`, pašalintumėte nereikalingus paketus ir paleistumėte kompiuterį iš naujo:

```
1
2
3
4
```

### Veiksmai, būdingi Mediation Controller klasteriui

`SLAVE` Mediation Controller serveryje vykdykite šias komandas, kad iš naujo sinchronizuotumėte bendrą paslaptį tarp `MASTER` Mediation Controller ir `SLAVE`:

```
1
2
```

### PostgreSQL duomenų bazės egzemplioriaus versijos atnaujinimas

Mediation Controller serveryje atnaujinkite PostgreSQL duomenų bazės egzempliorių iš 13 versijos į 15 versiją. Tam vykdykite toliau pateiktas instrukcijas su atitinkamomis `root` teisėmis.

Prieš perkėlimą patikrinkite PostgreSQL egzempliorių būseną:

```
1
```

Vykdykite šias komandas, kad atnaujintumėte duomenų bazės egzempliorių iki PostgreSQL 15 versijos:

```
1
2
3
4
```

Patikrinkite, ar duomenų bazės egzemplioriaus versija sėkmingai atnaujinta. Turėtų būti rodomi du egzemplioriai: vienas 13 versijos, kitas 15 versijos, kuris yra vienintelis aktyvus. Patikra atliekama šia komanda:

```
1
```

Jei versijos atnaujinimas pavyko, 13 versijos duomenų bazės egzempliorių galima panaikinti:

```
1
```

Galima pradėti naikinti PostgreSQL 13 versijos paketus:

```
1
```

### CyberElements Bastion duomenų bazės perkėlimas

Produkto konfigūracija saugoma duomenų bazėje, kurią reikia perkelti, kad joje galėtų būti naujos versijos atliktų pakeitimų konfigūracijos. Operacija atliekama Mediation Controller serveryje kaip `root`.

> **Cluster architektūra**
>
> Cluster architektūroje operaciją reikia atlikti tik iš vieno Mediation Controller serverio, nesvarbu, kurio.
>
> Taip pat reikia vykdyti šią komandą:
>
> ```
> 1
> ```

Duomenų perkėlimas paleidžiamas komanda, lygiaverte šiai:

```
1
```

Čia `<org_clr>` reikia pakeisti perkeliamos organizacijos pavadinimu. Atkreipkite dėmesį: jei Mediation Controller turi kelias organizacijas (multi-tenant), komandą reikės vykdyti tiek kartų, kiek yra perkeliamų organizacijų.

> **Pavyzdys**
>
> CyberElements Bastion platformoje, kurioje yra organizacijos `systancia` ir `systancia-test`, reikės vykdyti šias komandas:
>
> ```
> 1
> 2
> ```

Po duomenų bazės perkėlimo būtina iš naujo paleisti Apache2 paslaugą:

```
1
```

### Konfigūracijų atkūrimas

Kai kurios konfigūracijos versijos atnaujinimo metu buvo perrašytos ir jas reikia atkurti.

**Failas commonParameters.conf:**

Perkelkite su HTML5 Gateway susijusias `<Location>` žymes, paprastai esančias failo pabaigoje, iš failo `/etc/ipdiva/httpd/commonParameters.conf.dpkg-old` į `/etc/ipdiva/httpd/commonParameters.extra.conf` (jei failo nėra, sukurkite jį). Jei `<Location>` žymių nėra, galima nukopijuoti toliau pateiktus pavyzdžius.

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

**Failas djangosettings.ini:**

Nukopijuokite informaciją iš failo `/etc/ipdiva/care/djangosettings.ini.dpkg-old` 2 eilutės „allowed_hosts“ į failą `/etc/ipdiva/care/djangosettings.ini`. Tai galima automatizuoti vykdant šią komandą kaip `root`:

```
1
```

**Atkūrimų taikymas:**

Norint pritaikyti atkūrimus, būtina kaip `root` iš naujo paleisti Apache2 paslaugą:

```
1
```

## Patikra

Baigus versijos atnaujinimą, prieš grįžtant į gamybinę aplinką būtina patikrinti CyberElements Bastion infrastruktūrą ir įsitikinti, kad ji veikia tinkamai. Jei patikra nepavyksta, apsvarstykite galimybę grąžinti ankstesnę būseną atkuriant CyberElements Bastion serverių atsargines kopijas.

Atidarykite organizacijos administratoriaus sąsają, tada valdymo juostoje eikite į meniu „About“ ir patikrinkite, ar Mediation Controller versija sėkmingai atnaujinta iki 4.6.

Galima pradėti pirmuosius platformos veikimo testus, tačiau, kad CyberElements Bastion taikomosios programos veiktų optimaliai, rekomenduojame naudoti Edge Gateway 4.6 versiją.
