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

# Mediation Controller serveri töö ajal tehtav versiooniuuendus

> **Oluline**
>
> Mediation Controller serveri töö ajal tehtava versiooniuuenduse dokumentatsioon on mõeldud kõigile Debian 11 operatsioonisüsteemiga töötavatele Mediation Controller serveritele. Debiani versiooni saab kontrollida järgmise käsuga (käivitatakse SSH- või konsoolijuurdepääsu kaudu):
>
> ```
> 1
> ```

> **Teave**
>
> Meeldetuletuseks: Debiani arvutites tuleb kasutajale `root` lülituda järgmise käsuga:
>
> ```
> 1
> ```

## Planeerimine ja ettevalmistus

### Võrguvoogude avamine

Toote versiooniuuendusel tuleb Debiani hoidlatest alla laadida palju pakette, kuna toimub üleminek Debiani versioonilt 11 versioonile 12. Aadressidele `security.debian.org` ja `ftp.fr.debian.org` tuleb avada juurdepääs `TCP 80` kaudu.

Voogude avatust saab arvutis testida, käivitades Debiani hoidlate sünkroonimise. Kui kuvatakse tõrketeateid Debiani hoidlatele juurdepääsu kohta, ei ole võrguvoog avatud ja tõenäoliselt blokeerib seda ettevõtte tulemüür. Hoidlate sünkroonimise saab käivitada järgmise käsuga:

```
1
```

### Peegli ja vajalike tööriistade allalaadimine

CyberElements Cleanroom 4.6 peegli saab alla laadida siit (nõuab kliendikonto loomist): [Systancia Marketplace](https://www.systancia.com/en/my-systancia/marketplace/systancia-cleanroom/downloads-cleanroom/)

Systancia Marketplace'ist tuleb alla laadida ka võti `systancia.gpg`, mis autendib toote CyberElements Bastion hoidla.

Lisaks peeglile on versiooniuuenduse protsessiks vaja kolmanda osapoole tööriistu:

- SSH-klient (Windowsis saab kasutada tööriista [PuTTY](https://putty.org/))
- SCP-klient (Windowsis saab kasutada tööriistu [WinSCP](https://winscp.net/eng/index.php) või [FileZilla](https://filezilla-project.org/))

### Tööriista screen installimine ja kasutamine

Tööriist `screen` võimaldab avada ühes konsoolis mitu kestaterminali. Selle tööriista kasutamine on toote CyberElements Bastion versiooniuuenduse tegemiseks hädavajalik, et kõrvaldada sõltuvus võrguühenduse stabiilsusest. Ilma tööriista screen kasutamata katkestataks installimine, kui SSH-ühendus toote CyberElements Bastion serveritega katkeb.

Tööriista `screen` kasutamisel saab toote CyberElements Bastion seadmete kestakonsooliga uuesti ühenduse loomisel taastada terminali, milles värskendusprotsess käivitati.

Pakett screen tuleks installida järgmise käsureaga:

```
1
```

Uue `screen`-terminali avamiseks tuleb käivitada järgmine käsk:

```
1
```

Asendage `<ID>` nimega, mis seansi tuvastab.

> **Näide**
>
> CyberElements versiooniuuenduste puhul on identifikaator `cye-upgrade` kergesti äratuntav. Käsk oleks seega järgmine:
>
> ```
> 1
> ```

Tööriistaga `screen` avatud terminali taastamiseks käivitage lihtsalt järgmine käsk:

```
1
```

Asendage `<ID>` seansi avamisel määratud nimega.

> **Näide**
>
> Varem identifikaatoriga `cye-upgrade` avatud terminali saab taastada järgmise käsuga:
>
> ```
> 1
> ```

Terminali sulgemiseks pärast versiooniuuenduse lõppu sisestage terminalis käsk `exit` või vajutage kiirklahvi ctrl+d.

See viib teid tagasi konsooli. Teade „screen is terminating“ kinnitab, et terminal on suletud.

### Virtuaalseadmete kettaruumi laiendamine

Systancia Cleanroom 4.4 või 4.5 virtuaalseadmetes tuleb `/usr` partitsioonile lisada 4 GB suurune kettalaiendus. See toiming on vajalik, et versiooniuuenduse jaoks oleks piisavalt kettaruumi ja toiming ei jääks pooleli.

Kui loote Mediation Controller serveriga ühenduse kas SSH kaudu või konsoolirežiimis, teavitab tervitusteade teid, et olete ühendatud Systancia arvutiga. Lisarida näitab appliance'i versiooni.

> **Näide**
>
> Versiooni 4.5 Mediation Controller virtuaalseade annab järgmise tulemuse:
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> ```

Kui arvuti ei ole versiooniga 4.4 või 4.5 tarnitud virtuaalseade, võib selle peatüki vahele jätta ja jätkata [versiooniuuendusega](#upgrade).

> **Varukoopia on tungivalt soovitatav**
>
> Järgmised sammud muudavad Mediation Controller serveri ketta partitsioonimist. Kui on tehtud käsitsi muudatusi, ei pruugi järgmised juhised sobida ja arvuti võib blokeeruda.
>
> Enne jätkamist tehke arvutist varukoopia või vajaduse korral dubleerige virtuaalmasin. Hetktõmmiseid ei saa kasutada, sest eriti VMware'i puhul blokeerivad need ketta laiendamise võimaluse.

Laiendage hüperviisori tasemel virtuaalmasina kettaruumi täiendava 4 GB võrra. Kui ketast ei ole võimalik laiendada, kontrollige, et hetktõmmiseid poleks, ja kui neid pole, sulgege virtuaalmasin, kui laiendamist töö ajal ei toetata.

Kui kettaruum on virtuaalmasina tasemel laiendatud, on `/usr` partitsiooni laiendamiseks vaja järgmisi käske, mis tuleb käivitada kasutajana `root`:

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

## Versiooniuuendus

### Debiani pakettide värskendamine

Kuna toote CyberElements Bastion versiooniuuendus nõuab Debiani versiooniuuendust, on soovitatav enne Debian 12-le üleminekut Debian 11 paketid korralikult värskendada. Selleks käivitage kasutajana `root` järgmised käsud (süsteemi värskendamine ja seejärel mittevajalike pakettide eemaldamine):

```
1
2
3
```

Võidakse kuvada teateid, mis paluvad teil muuta mitme konfiguratsioonifaili konfiguratsiooni. Sellisel juhul valige suvand, mis säilitab praeguse konfiguratsiooni.

### Microsoft SQL Server draiverite ettevalmistamine

Kui Microsoft SQL Server draiverid on installitud, on vaja lisatoiminguid (see kehtib virtuaalseadmete kohta, mille tarnib CyberElements).
Et kontrollida, kas need on serveris olemas, võib kasutajana `root` käivitada järgmise käsu:

```
1
```

Kui vastust ei kuvata, pole draivereid installitud ja võite jätkata [peegli ettevalmistamise etapiga](#preparing-the-cyberelements-cleanroom-46-mirror).
Kui aga draiverid on installitud, peaks loendis olema kaks paketti: `msodbcsql17` ja `mssql-tools`. Järgige selle peatüki juhiseid.

> **Näited**
>
> Server, kuhu draivereid pole installitud, annaks eelmise käsu korral järgmise tulemuse:
>
> ```
> 1
> ```
>
> Server, kuhu draiverid on installitud, annab sarnase tulemuse (pakettide versioonid võivad erineda):
>
> ```
> 1
> 2
> 3
> ```

Eduka versiooniuuenduse tagamiseks on pakettide kindla versiooni installimiseks vaja järgmisi käske:

```
1
```

Versiooniuuenduseks valmistumiseks konfigureerige Debian 12 jaoks kohandatud Microsofti hoidla:

```
1
```

### CyberElements Cleanroom 4.6 peegli ettevalmistamine

Ettevalmistusetapis hangitud peegel (tgz-laiendiga fail) tuleb saata serverisse SCP kaudu. See tuleks paigutada kataloogi `/tmp/`.

Seejärel valmistage peegel ette, käivitades kasutajana `root` järgmised käsud (varasemast versiooniuuendusest järelejäänud failid kustutatakse):

```
1
2
3
```

### APT konfigureerimine

Paketihaldur APT on konfigureeritud hankima Debian 11 pakette; see tuleb uuesti konfigureerida hankima Debian 12 pakette. Samuti tuleb värskendada viidet toote CyberElements Bastion kohalikule peeglile. Selleks käivitage kasutajana `root` järgmised käsud:

```
1
2
```

Kohalik peegel autenditakse ettevalmistusetapis alla laaditud võtmega `systancia.gpg`. Saatke see SCP kaudu serveri kataloogi `/tmp/` ja seejärel installige see kasutajana `root` järgmise käsuga:

```
1
```

Lisaks uute hoidlate konfigureerimisele soovitame tungivalt rakendada järgmist sätet, mis annab APT-le korralduse mitte installida soovitatud sõltuvusi, mis pole hädavajalikud, et vähendada installitavate komponentide arvu. Järgmine käsk rakendab selle sätte kasutajana `root`:

```
1
```

Lõpuks tuleb järgmise käsuga värskendada hoidlates olevate pakettide loendit:

```
1
```

### Versiooniuuenduse käivitamine

Looge SSH kaudu ühendus Mediation Controller serveriga ja lülituge kasutajale `root`, seejärel avage screen-seanss [nagu eespool kirjeldatud](#installing-and-using-the-screen-tool).

Alustage teatud konkreetsete pakettide värskendamisest, et versiooniuuendust saaks teha. Esimese käsu käivitamisel on veateade oodatav, kuid teine käsk parandab vea:

```
1
2
```

Mediation Controller serveri uuendamisel Debian 11-lt Debian 12-le värskendatakse paketti `collectd` ja see ei ühildu enam konfiguratsioonifailiga, mille CyberElements Bastion genereerib (`/etc/collectd/collectd.conf`). See võib põhjustada värskendamise ajal tõrke.

Selle vältimiseks lülitage collectd välja:

```
1
2
```

Pärast seda saab versiooniuuenduse algatada järgmise käsuga:

```
1
```

Versiooniuuenduse ajal esitatakse teile mitu küsimust selle kohta, kas säilitada konfiguratsioonifailid ja värskendada neid Debian 12 standardkonfiguratsiooni järgi või jätta kehtima spetsiifiline konfiguratsioon. Siin on meie soovitused enamiku failide kohta, millega võite kokku puutuda:

| Konfiguratsioonifail | Soovitatav toiming |
|---|---|
| /etc/issue | Säilitamiseks vastake `N` |
| /etc/issue.net | Säilitamiseks vastake `N` |
| /etc/security/limits.conf | Säilitamiseks vastake `N` |
| /etc/login.defs | Säilitamiseks vastake `N` |
| /etc/shibboleth/shibboleth2.xml | Säilitamiseks vastake `N` |
| /etc/shibboleth/shibd.logger | Rakendage muudatused, vastake `Y` |
| /etc/default/ntpsec | Rakendage muudatused, vastake `Y` |
| /etc/snmp/snmpd.conf | Rakendage muudatused, vastake `Y` |
| /etc/logrotate.d/IPdivaServer | Rakendage muudatused, vastake `Y` |
| /etc/ssh/sshd_config | Säilitamiseks vastake `Keep the local version currently installed` |
| /etc/ssh/ssh_config | Rakendage muudatused, vastake `Y` |
| /etc/apache2/ports.conf | Säilitamiseks vastake `N` |
| /etc/init.d/apache2 | Säilitamiseks vastake `N` |
| /etc/modsecurity/modsecurity.conf-recommended | Rakendage muudatused, vastake `Y` |
| /etc/ipdiva/httpd/commonParameters.conf | Rakendage muudatused, vastake `Y` |
| /etc/ipdiva/care/djangosettings.ini | Rakendage muudatused, vastake `Y` |
| /etc/crontab | Rakendage muudatused, vastake `Y` |
| /etc/openssl.cnf | Rakendage muudatused, vastake `Y` |
| /etc/audit/rules.d/audit.rules | Säilitamiseks vastake `N` |
| /etc/pam.d/su | Säilitamiseks vastake `N` |
| /etc/sysctl.conf | Säilitamiseks vastake `N` |

Nõustuge glibc-paketi konfiguratsiooniteatega: ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYE_MediationControllerUpgrade_glibc.png)

Nõustuge teenuste automaatse taaskäivitamisega: ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYE_MediationControllerUpgrade_RestartServices.png)

Kui versiooniuuendus on lõpule viidud, käivitage järgmised käsud, et `collectd` uuesti aktiveerida, mittevajalikud paketid eemaldada ja arvuti taaskäivitada:

```
1
2
3
4
```

### Mediation Controller serverite Cluster-arhitektuuri eritoimingud

Käivitage `SLAVE` Mediation Controller serveris järgmised käsud, et sünkroonida uuesti ühine saladus `MASTER` Mediation Controller serveri ja `SLAVE` serveri vahel:

```
1
2
```

### PostgreSQL-i andmebaasi eksemplari versiooniuuendus

Uuendage Mediation Controller serveris PostgreSQL-i andmebaasi eksemplar versioonilt 13 versioonile 15. Selleks täitke järgmised juhised sobivate `root`-õigustega.

Enne migreerimist kontrollige PostgreSQL-i eksemplaride olekut:

```
1
```

Käivitage järgmised käsud, et uuendada andmebaasi eksemplar PostgreSQL-i versioonile 15:

```
1
2
3
4
```

Kontrollige, kas andmebaasi eksemplari versioon on edukalt uuendatud. Kuvada peaks kaks eksemplari: üks versioonis 13 ja teine versioonis 15, mis on ainus aktiivne. Kontroll tehakse järgmise käsuga:

```
1
```

Kui versiooniuuendus õnnestus, võib versiooni 13 andmebaasi eksemplari kustutada:

```
1
```

Võib alustada versiooni 13 PostgreSQL-i pakettide kustutamist:

```
1
```

### CyberElements Bastion andmebaasi migreerimine

Toote konfiguratsioon on talletatud andmebaasis, mis tuleb migreerida, et see saaks sisaldada uue versiooniga tehtud muudatuste konfiguratsioone. Toiming tehakse Mediation Controller serveris kasutajana `root`.

> **Cluster-arhitektuur**
>
> Cluster-arhitektuuri korral tuleb toiming teha ainult ühest Mediation Controller serverist, olenemata sellest, millisest.
>
> Samuti tuleb käivitada järgmine käsk:
>
> ```
> 1
> ```

Andmete migreerimine käivitatakse sellega samaväärse käsuga:

```
1
```

Siin tuleb `<org_clr>` asendada migreeritava organisatsiooni nimega. Pange tähele, et kui Mediation Controller serveris on mitu organisatsiooni (multi-tenant), tuleb käsku käivitada nii mitu korda, kui on migreeritavaid organisatsioone.

> **Näide**
>
> CyberElements Bastion platvormi puhul, millel on organisatsioonid `systancia` ja `systancia-test`, tuleb käivitada järgmised käsud:
>
> ```
> 1
> 2
> ```

Pärast andmebaasi migreerimist tuleb teenus Apache2 taaskäivitada:

```
1
```

### Konfiguratsioonide taastamine

Mõned konfiguratsioonid kirjutati versiooniuuenduse käigus üle ja need tuleb taastada.

**Fail commonParameters.conf:**

Teisaldage HTML5 Gateway serveritega seotud sildid `<Location>`, mis asuvad tavaliselt faili lõpus, failist `/etc/ipdiva/httpd/commonParameters.conf.dpkg-old` faili `/etc/ipdiva/httpd/commonParameters.extra.conf` (looge fail, kui seda pole olemas). Kui silte `<Location>` pole, võib kopeerida järgmised näited.

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

**Fail djangosettings.ini:**

Kopeerige faili `/etc/ipdiva/care/djangosettings.ini.dpkg-old` teise rea „allowed_hosts“ teave faili `/etc/ipdiva/care/djangosettings.ini`. Seda saab automatiseerida järgmise käsuga kasutajana `root`:

```
1
```

**Taastamiste rakendamine:**

Taastamiste rakendamiseks tuleb kasutajana `root` taaskäivitada teenus Apache2:

```
1
```

## Valideerimine

Kui versiooniuuendus on lõpule viidud, tuleb CyberElements Bastion taristu enne tootmisse naasmist valideerida, et veenduda selle nõuetekohases toimimises. Kui valideerimine nurjub, kaaluge tagasipööramist CyberElements Bastion serverite varukoopiate taastamise teel.

Avage organisatsiooni administraatoriliides ja seejärel juhtriba menüü „About“, et kontrollida, kas Mediation Controller serveri versioon on edukalt uuendatud versioonile 4.6.

Platvormi funktsionaalsuse esmaseid teste võib alustada, kuid CyberElements Bastion rakenduste optimaalse jõudluse tagamiseks soovitame kasutada Edge Gateway serveri versiooni 4.6.
