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

# Mediation Controller -palvelimen versiopäivitys käytön aikana

> **Tärkeää**
>
> Dokumentaatio Mediation Controller -palvelimen versiopäivityksestä käytön aikana on tarkoitettu kaikille Mediation Controller -palvelimille, jotka toimivat Debian 11 -käyttöjärjestelmällä. Debian-version voi tarkistaa seuraavalla komennolla (suoritetaan SSH- tai konsoliyhteydessä):
>
> ```
> 1
> ```

> **Tietoa**
>
> Muistutus: siirtyminen käyttäjäksi `root` Debian-koneilla on tehtävä seuraavalla komennolla:
>
> ```
> 1
> ```

## Suunnittelu ja valmistelu

### Verkkoliikenteen avaaminen

Tuotteen päivityksen yhteydessä on ladattava useita paketteja Debian-repositoryista, koska Debian-versiosta 11 siirrytään versioon 12. Pääsy portin `TCP 80` kautta osoitteisiin `security.debian.org` ja `ftp.fr.debian.org` on avattava.

Koneen liikenteen avautumisen testaamiseksi voidaan käynnistää Debian-repositoryjen synkronointi. Jos Debian-repositoryihin pääsyä koskevia virheilmoituksia näytetään, verkkoliikenne ei ole avattu, todennäköisesti yrityksen palomuurin estämänä. Repositoryjen synkronointi voidaan käynnistää seuraavalla komennolla:

```
1
```

### Peilipalvelimen ja tarvittavien työkalujen lataaminen

CyberElements Cleanroom 4.6 -peilipalvelin voidaan ladata tästä linkistä (edellyttää asiakastilin luomista): [Systancia Marketplace](https://www.systancia.com/en/my-systancia/marketplace/systancia-cleanroom/downloads-cleanroom/)

Myös `systancia.gpg`-avain, joka todentaa CyberElements Bastion -repository'n, on ladattava Systancia Marketplace -palvelusta.

Peilipalvelimen lisäksi päivitysprosessia varten tarvitaan kolmannen osapuolen työkaluja:

- SSH-asiakasohjelma (Windowsissa voidaan käyttää työkalua [PuTTY](https://putty.org/))
- SCP-asiakasohjelma (Windowsissa voidaan käyttää työkaluja [WinSCP](https://winscp.net/eng/index.php) tai [FileZilla](https://filezilla-project.org/))

### Työkalun screen asennus ja käyttö

Työkalulla `screen` voit avata useita shell-päätteitä yhdessä konsolissa. Tätä työkalua on ehdottomasti käytettävä CyberElements Bastion -versiopäivityksen tekemiseen, jotta riippuvuus verkkoyhteyden vakaudesta poistuu. Ilman screen-työkalua asennus nimittäin keskeytyisi, jos SSH-yhteys CyberElements Bastion -palvelimiin katkeaisi.

Työkalua `screen` käyttämällä voidaan CyberElements Bastion -laitteiden komentotulkkikonsoliin uudelleen kirjauduttaessa palata siihen päätteeseen, jossa päivitysprosessi suoritettiin.

Screen-paketti tulisi asentaa seuraavalla komentorivillä:

```
1
```

Uuden `screen`-päätteen avaamiseksi on suoritettava seuraava komento:

```
1
```

Korvaa `<ID>` nimellä, joka yksilöi istunnon.

> **Esimerkki**
>
> CyberElements-versiopäivityksissä tunniste `cye-upgrade` on helposti tunnistettavissa. Komento olisi siis seuraava:
>
> ```
> 1
> ```

Työkalulla `screen` avatun päätteen palauttamiseksi riittää suorittaa seuraava komento:

```
1
```

Korvaa `<ID>` istunnon avaamisen yhteydessä määritetyllä nimellä.

> **Esimerkki**
>
> Aiemmin tunnisteella `cye-upgrade` avattu pääte voidaan palauttaa seuraavalla komennolla:
>
> ```
> 1
> ```

Sulkeaksesi päätteen päivityksen valmistuttua kirjoita päätteeseen komento `exit` tai käytä näppäinyhdistelmää ctrl+d.

Näin palaat konsoliin. Ilmoitus ”screen is terminating” vahvistaa, että pääte on suljettu.

### Virtuaalisten appliance-laitteiden levytilan laajennus

Systancia Cleanroom 4.4- tai 4.5 -virtuaalisissa appliance-laitteissa `/usr`-osioon on lisättävä 4 GB:n levylaajennus. Tämä toimenpide on tarpeen, jotta versiopäivitykseen on riittävästi levytilaa eikä toimenpide jää jumiin.

Kun muodostat yhteyden Mediation Controller -palvelimeen joko SSH:n kautta tai konsolitilassa, tervetuloviesti kertoo, että olet yhteydessä Systancia-koneeseen. Lisärivi ilmoittaa appliance-laitteen version.

> **Esimerkki**
>
> Version 4.5 Mediation Controller -virtuaaliappliance antaa seuraavan tuloksen:
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> ```

Jos kone ei ole version 4.4 tai 4.5 mukana toimitettu virtuaalinen appliance, tämän luvun voi ohittaa ja siirtyä suoraan [versiopäivitykseen](#upgrade).

> **Backup erittäin suositeltava**
>
> Seuraavat vaiheet muuttavat Mediation Controller -palvelimen levyn osiointia. Jos manuaalisia muutoksia on tehty, nämä ohjeet eivät ehkä sovellu ja kone voi jäädä jumiin.
>
> Ota koneesta backup ennen jatkamista tai monista tarvittaessa virtuaalikone. Snapshoteja ei voi käyttää, koska ne estävät erityisesti VMwaressa levyn laajentamisen.

Laajenna hypervisorissa virtuaalikoneen levytilaa 4 GB:llä. Jos levyn laajentaminen ei ole mahdollista, tarkista, ettei snapshoteja ole, ja sammuta muussa tapauksessa virtuaalikone, jos laajennusta käytön aikana ei tueta.

Kun levytila on laajennettu virtuaalikoneen tasolla, `/usr`-osion laajentaminen edellyttää seuraavia komentoja, jotka suoritetaan `root`-käyttäjänä:

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

## Versiopäivitys

### Debian-pakettien päivittäminen

Koska CyberElements Bastion -versiopäivitys edellyttää Debianin versiopäivitystä, on suositeltavaa päivittää Debian 11 -paketit asianmukaisesti ennen siirtymistä Debian 12:een. Suorita tätä varten seuraavat komennot käyttäjänä `root` (järjestelmän päivitys ja sen jälkeen tarpeettomien pakettien poisto):

```
1
2
3
```

Voi ilmestyä ilmoituksia, joissa sinua pyydetään muuttamaan useiden määritystiedostojen määrityksiä. Valitse näissä tapauksissa vaihtoehto, joka säilyttää nykyisen määrityksen.

### Microsoft SQL Server -ajurien valmistelu

Lisätoimenpiteitä tarvitaan, jos Microsoft SQL Server -ajurit on asennettu (näin on CyberElementsin tarjoamissa virtuaalisissa appliance-laitteissa).
Sen tarkistamiseksi, ovatko ne palvelimella, voi suorittaa seuraavan komennon `root`-käyttäjänä:

```
1
```

Jos vastausta ei tule, ajureita ei ole asennettu ja voit siirtyä [peilin valmisteluvaiheeseen](#preparing-the-cyberelements-cleanroom-46-mirror).
Muussa tapauksessa, jos ajurit on asennettu, luettelossa pitäisi olla kaksi pakettia: `msodbcsql17` ja `mssql-tools`. Noudata tämän osion ohjeita.

> **Esimerkkejä**
>
> Palvelin, jolle ajureita ei ole asennettu, antaisi edellisellä komennolla seuraavan tuloksen:
>
> ```
> 1
> ```
>
> Palvelin, jolle ajurit on asennettu, antaa tämän kaltaisen tuloksen (pakettien versiot voivat poiketa):
>
> ```
> 1
> 2
> 3
> ```

Seuraavat komennot tarvitaan tietyn pakettiversion asentamiseen, jotta versiopäivitys onnistuu:

```
1
```

Määritä Debian 12:lle sopiva Microsoftin repository versiopäivityksen valmistelemiseksi:

```
1
```

### CyberElements Cleanroom 4.6 -peilipalvelimen valmistelu

Valmisteluvaiheessa haettu peilipalvelin (tiedosto, jonka tunniste on tgz) on lähetettävä palvelimelle SCP:n avulla. Se on sijoitettava hakemistoon `/tmp/`.

Valmistele sen jälkeen peilipalvelin suorittamalla seuraavat komennot käyttäjänä `root` (aiemman versiopäivityksen jäljelle jääneet tiedostot poistetaan):

```
1
2
3
```

### APT:n määritys

APT-paketinhallinta on määritetty hakemaan Debian 11 -paketit; se on määritettävä uudelleen hakemaan Debian 12 -paketit. Lisäksi viittaus paikalliseen CyberElements Bastion -peiliin on päivitettävä. Suorita tätä varten seuraavat komennot käyttäjänä `root`:

```
1
2
```

Paikallinen peilipalvelin todennetaan valmisteluvaiheessa ladatulla `systancia.gpg`-avaimella. Lähetä avain palvelimelle SCP:llä hakemistoon `/tmp/` ja asenna se sitten seuraavalla komennolla `root`-käyttäjänä:

```
1
```

Uusien repositoryjen määrityksen lisäksi suosittelemme vahvasti soveltamaan seuraavaa asetusta, jolla APT ohjeistetaan olemaan asentamatta suositeltuja riippuvuuksia, jotka eivät ole ehdottoman tarpeellisia, jotta asennettujen komponenttien määrä pienenee. Seuraava komento soveltaa tätä asetusta käyttäjänä `root`:

```
1
```

Lopuksi on päivitettävä repositoryjen pakettiluettelo seuraavalla komennolla:

```
1
```

### Versiopäivityksen käynnistäminen

Ota SSH-yhteys Mediation Controller -palvelimeen, siirry `root`-käyttäjäksi ja avaa sen jälkeen screen [edellä kuvatulla tavalla](#installing-and-using-the-screen-tool).

Aloita päivittämällä tietyt paketit, jotta versiopäivitys voidaan tehdä. Ensimmäisen komennon suorituksessa on odotettavissa virheilmoitus, mutta toinen komento korjaa virheen:

```
1
2
```

Kun Mediation Controller -palvelin päivitetään Debian 11:stä Debian 12:een, `collectd`-paketti päivitetään, minkä jälkeen se ei ole enää yhteensopiva CyberElements Bastion -tuotteen luoman määritystiedoston (`/etc/collectd/collectd.conf`) kanssa. Tämä voi aiheuttaa virheen päivityksen aikana.

Poista collectd käytöstä tämän välttämiseksi:

```
1
2
```

Sen jälkeen versiopäivityksen voi käynnistää seuraavalla komennolla:

```
1
```

Versiopäivityksen aikana sinulta kysytään useita kysymyksiä siitä, säilytetäänkö määritystiedostot ja päivitetäänkö ne Debian 12:n vakiomäärityksen mukaisiksi vai säilytetäänkö nykyinen erityinen määritys. Alla suosituksemme useimmista tiedostoista, joita voit kohdata:

| Määritystiedosto | Suositeltu toimenpide |
|---|---|
| /etc/issue | Säilytä, vastaa `N` |
| /etc/issue.net | Säilytä, vastaa `N` |
| /etc/security/limits.conf | Säilytä, vastaa `N` |
| /etc/login.defs | Säilytä, vastaa `N` |
| /etc/shibboleth/shibboleth2.xml | Säilytä, vastaa `N` |
| /etc/shibboleth/shibd.logger | Ota muutokset käyttöön, vastaa `Y` |
| /etc/default/ntpsec | Ota muutokset käyttöön, vastaa `Y` |
| /etc/snmp/snmpd.conf | Ota muutokset käyttöön, vastaa `Y` |
| /etc/logrotate.d/IPdivaServer | Ota muutokset käyttöön, vastaa `Y` |
| /etc/ssh/sshd_config | Säilytä, vastaa `Keep the local version currently installed` |
| /etc/ssh/ssh_config | Ota muutokset käyttöön, vastaa `Y` |
| /etc/apache2/ports.conf | Säilytä, vastaa `N` |
| /etc/init.d/apache2 | Säilytä, vastaa `N` |
| /etc/modsecurity/modsecurity.conf-recommended | Ota muutokset käyttöön, vastaa `Y` |
| /etc/ipdiva/httpd/commonParameters.conf | Ota muutokset käyttöön, vastaa `Y` |
| /etc/ipdiva/care/djangosettings.ini | Ota muutokset käyttöön, vastaa `Y` |
| /etc/crontab | Ota muutokset käyttöön, vastaa `Y` |
| /etc/openssl.cnf | Ota muutokset käyttöön, vastaa `Y` |
| /etc/audit/rules.d/audit.rules | Säilytä, vastaa `N` |
| /etc/pam.d/su | Säilytä, vastaa `N` |
| /etc/sysctl.conf | Säilytä, vastaa `N` |

Hyväksy glibc-paketin määritysilmoitus: ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYE_MediationControllerUpgrade_glibc.png)

Hyväksy palvelujen automaattinen uudelleenkäynnistys: ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYE_MediationControllerUpgrade_RestartServices.png)

Kun versiopäivitys on valmis, suorita seuraavat komennot, jotta `collectd` otetaan uudelleen käyttöön, tarpeettomat paketit poistetaan ja kone käynnistetään uudelleen:

```
1
2
3
4
```

### Cluster-tilan Mediation Controller -palvelimien erityistoimet

Suorita `SLAVE`-Mediation Controller -palvelimella seuraavat komennot, jotta `MASTER`-Mediation Controller -palvelimen ja `SLAVE`-palvelimen yhteinen salaisuus synkronoidaan uudelleen:

```
1
2
```

### PostgreSQL-tietokantainstanssin versiopäivitys

Päivitä Mediation Controller -palvelimella PostgreSQL-tietokantainstanssi versiosta 13 versioon 15. Suorita tätä varten seuraavat ohjeet sopivin `root`-oikeuksin.

Tarkista PostgreSQL-instanssien tila ennen migraatiota:

```
1
```

Suorita seuraavat komennot tietokantainstanssin päivittämiseksi PostgreSQL-versioon 15:

```
1
2
3
4
```

Tarkista, että tietokantainstanssi on päivitetty oikein. Näkyviin pitäisi tulla kaksi instanssia, toinen versiossa 13 ja toinen versiossa 15, joka on ainoa aktiivinen. Tarkistus tehdään seuraavalla komennolla:

```
1
```

Jos versiopäivitys onnistui, version 13 tietokantainstanssin voi poistaa:

```
1
```

Version 13 PostgreSQL-pakettien poiston voi käynnistää:

```
1
```

### CyberElements Bastion -tietokannan migraatio

Tuotteen määritys tallennetaan tietokantaan, joka on migroitava, jotta se voi sisältää uuden version tuomien muutosten asetukset. Toimenpide tehdään Mediation Controller -palvelimella `root`-käyttäjänä.

> **Cluster-arkkitehtuuri**
>
> Cluster-arkkitehtuurissa toimenpide on tehtävä vain yhdeltä Mediation Controller -palvelimelta, riippumatta siitä, mikä se on.
>
> Lisäksi on suoritettava seuraava komento:
>
> ```
> 1
> ```

Tietojen migraatio käynnistetään tätä vastaavalla komennolla:

```
1
```

Tässä `<org_clr>` on korvattava migroitavan organisaation nimellä. Huomaa: jos Mediation Controller -palvelimella on useita organisaatioita (multi-tenant), komento on suoritettava niin monta kertaa kuin on migroitavia organisaatioita.

> **Esimerkki**
>
> Jos CyberElements Bastion -alustalla on organisaatiot `systancia` ja `systancia-test`, on suoritettava seuraavat komennot:
>
> ```
> 1
> 2
> ```

Tietokannan migraation jälkeen Apache2-palvelu on käynnistettävä uudelleen:

```
1
```

### Määritysten palauttaminen

Jotkin määritykset korvattiin versiopäivityksen aikana, ja ne on palautettava.

**commonParameters.conf-tiedosto:**

Siirrä HTML5 Gateway -palvelimiin liittyvät `<Location>`-tunnisteet, jotka ovat yleensä tiedoston lopussa, tiedostosta `/etc/ipdiva/httpd/commonParameters.conf.dpkg-old` tiedostoon `/etc/ipdiva/httpd/commonParameters.extra.conf` (luo tiedosto, jos sitä ei ole). Jos `<Location>`-tunnisteita ei ole, seuraavat esimerkit voi kopioida.

**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-tiedosto:**

Kopioi tiedoston `/etc/ipdiva/care/djangosettings.ini.dpkg-old` rivin 2 ”allowed_hosts” tiedot tiedostoon `/etc/ipdiva/care/djangosettings.ini`. Tämän voi automatisoida seuraavalla komennolla `root`-käyttäjänä:

```
1
```

**Palautusten käyttöön ottaminen:**

Palautusten käyttöön ottaminen edellyttää Apache2-palvelun uudelleenkäynnistystä `root`-käyttäjänä:

```
1
```

## Validointi

Kun versiopäivitys on valmis, CyberElements Bastion -infrastruktuuri on validoitava sen oikean toiminnan varmistamiseksi ennen tuotantoon palaamista. Jos validointi epäonnistuu, harkitse paluuta edelliseen tilaan CyberElements Bastion -palvelimien backupien palautuksella.

Siirry organisaation järjestelmänvalvojan liittymään ja sen jälkeen hallintapalkin ”About”-valikkoon tarkistaaksesi, että Mediation Controller -palvelimen versio on päivitetty oikein versioon 4.6.

Alustan toiminnan ensimmäiset testit voi käynnistää, mutta suosittelemme Edge Gateway -palvelimen versiota 4.6, jotta CyberElements Bastion -sovellusten suorituskyky on paras mahdollinen.
