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

# Nadogradnja tijekom rada usluge Mediation Controller

> **Važno**
>
> Dokumentacija za nadogradnju tijekom rada usluge Mediation Controller namijenjena je svakom poslužitelju Mediation Controller koji radi na sustavu Debian 11. Verzija sustava Debian može se provjeriti sljedećom naredbom (koju treba izvršiti putem protokola SSH ili pristupa konzoli):
>
> ```
> 1
> ```

> **Informacije**
>
> Podsjetnik: prebacivanje na `root` na računalima sa sustavom Debian mora se izvršiti sljedećom naredbom:
>
> ```
> 1
> ```

## Planiranje i priprema

### Otvaranje mrežnih tokova

Pri nadogradnji proizvoda mnogo se paketa mora preuzeti iz repozitorija sustava Debian zbog prijelaza s verzije Debian 11 na verziju 12. Pristup putem `TCP 80` mora biti otvoren prema `security.debian.org` i `ftp.fr.debian.org`.

Da biste testirali otvorenost tokova na računalu, možete pokrenuti sinkronizaciju repozitorija sustava Debian. Ako se prikažu poruke o pogreškama u vezi s pristupom repozitorijima sustava Debian, mrežni tok nije otvoren, a vjerojatno ga blokira vatrozid tvrtke. Sinkronizaciju repozitorija možete pokrenuti sljedećom naredbom:

```
1
```

### Preuzimanje zrcala i potrebnih alata

Zrcalo CyberElements Cleanroom 4.6 možete preuzeti s ove poveznice (potrebno je stvoriti račun klijenta): [Systancia Marketplace](https://www.systancia.com/en/my-systancia/marketplace/systancia-cleanroom/downloads-cleanroom/)

Ključ `systancia.gpg`, koji služi za provjeru autentičnosti repozitorija CyberElements Bastion, također se mora preuzeti sa servisa Systancia Marketplace.

Uz zrcalo, za postupak nadogradnje bit će potrebni alati trećih strana:

- SSH klijent (u sustavu Windows možete upotrijebiti alat [PuTTY](https://putty.org/))
- SCP klijent (u sustavu Windows možete upotrijebiti alate [WinSCP](https://winscp.net/eng/index.php) ili [FileZilla](https://filezilla-project.org/))

### Instalacija i korištenje alata screen

Alat `screen` omogućuje otvaranje više terminala ljuske u jednoj konzoli. Taj je alat nužno upotrijebiti za nadogradnju verzije rješenja CyberElements Bastion kako bi se uklonila ovisnost o stabilnosti mrežne povezivosti. Naime, bez alata screen instalacija bi se prekinula u slučaju prekida SSH povezivosti s poslužiteljima CyberElements Bastion.

Zahvaljujući alatu `screen`, pri ponovnom povezivanju s konzolom ljuske opreme CyberElements Bastion može se vratiti terminal u kojem se izvršavao postupak ažuriranja.

Paket screen treba instalirati sljedećim naredbenim retkom:

```
1
```

Da biste otvorili novi terminal `screen`, morate izvršiti sljedeću naredbu:

```
1
```

Zamijenite `<ID>` nazivom koji identificira sesiju.

> **Primjer**
>
> Za nadogradnje verzije proizvoda CyberElements identifikator `cye-upgrade` lako je prepoznatljiv. Naredba bi stoga bila sljedeća:
>
> ```
> 1
> ```

Da biste vratili terminal otvoren pomoću alata `screen`, dovoljno je izvršiti sljedeću naredbu:

```
1
```

Zamijenite `<ID>` nazivom definiranim pri otvaranju sesije.

> **Primjer**
>
> Terminal prethodno otvoren s identifikatorom `cye-upgrade` može se vratiti sljedećom naredbom:
>
> ```
> 1
> ```

Da biste zatvorili terminal nakon dovršetka nadogradnje, u terminal unesite naredbu `exit` ili tipkovnički prečac ctrl+d.

Time ćete se vratiti u konzolu. Poruka „screen is terminating“ potvrđuje da je terminal zatvoren.

### Proširenje prostora na disku za virtualne uređaje

Virtualni uređaji Systancia Cleanroom 4.4 ili 4.5 zahtijevaju dodavanje proširenja diska od 4 GB particiji `/usr`. Ova je operacija potrebna kako bi bilo dovoljno prostora na disku za nadogradnju i kako bi se izbjeglo zastajanje tijekom operacije.

Prilikom povezivanja s poslužiteljem Mediation Controller, bilo putem protokola SSH ili u načinu konzole, poruka dobrodošlice obavijestit će vas da ste povezani s računalom tvrtke Systancia. Dodatni redak navodi verziju appliance.

> **Primjer**
>
> Virtualni uređaj Mediation Controller s verzijom 4.5 dat će sljedeći rezultat:
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> ```

Ako računalo nije virtualni uređaj isporučen s verzijom 4.4 ili 4.5, ovo se poglavlje može preskočiti i prijeći [na nadogradnju](#upgrade).

> **Izričito se preporučuje sigurnosna kopija**
>
> Sljedeći koraci izmijenit će particioniranje diska poslužitelja Mediation Controller. Ako su napravljene ručne promjene, sljedeće upute možda neće biti prikladne, što može dovesti do blokiranja računala.
>
> Prije nastavka napravite sigurnosnu kopiju računala ili, ako je potrebno, duplicirajte virtualno računalo. Snimke stanja ne mogu se koristiti jer, osobito kod platforme VMware, onemogućuju proširenje diska.

Na razini hipervizora proširite prostor na disku virtualnog računala za dodatnih 4 GB. Ako proširenje diska nije moguće, provjerite da nema snimki stanja, a ako ih nema, isključite virtualno računalo ako proširenje tijekom rada nije podržano.

Nakon što je prostor na disku proširen na razini virtualnog računala, za proširenje particije `/usr` potrebne su sljedeće naredbe koje treba izvršiti kao `root`:

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

## Nadogradnja

### Ažuriranje paketa sustava Debian

Budući da nadogradnja rješenja CyberElements Bastion zahtijeva nadogradnju sustava Debian, preporučuje se da prije prelaska na Debian 12 ispravno ažurirate pakete sustava Debian 11. Da biste to učinili, pokrenite sljedeće naredbe kao `root` (ažuriranje sustava, a zatim uklanjanje nepotrebnih paketa):

```
1
2
3
```

Mogu se pojaviti poruke koje od vas traže da izmijenite konfiguraciju nekoliko konfiguracijskih datoteka. U tim slučajevima odaberite mogućnost zadržavanja trenutačne konfiguracije.

### Priprema upravljačkih programa za Microsoft SQL Server

Dodatni koraci potrebni su ako su instalirani upravljački programi za Microsoft SQL Server (to je slučaj na virtualnim uređajima koje isporučuje CyberElements).
Da biste provjerili jesu li prisutni na poslužitelju, kao `root` možete izvršiti sljedeću naredbu:

```
1
```

Ako se ne pojavi nikakav odgovor, upravljački programi nisu instalirani i možete prijeći na [korak pripreme zrcala](#preparing-the-cyberelements-cleanroom-46-mirror).
U suprotnom, ako su upravljački programi instalirani, trebala bi biti navedena dva paketa: `msodbcsql17` i `mssql-tools`. Slijedite upute u ovom poglavlju.

> **Primjeri**
>
> Poslužitelj na kojem upravljački programi nisu instalirani dao bi sljedeći rezultat prethodne naredbe:
>
> ```
> 1
> ```
>
> Poslužitelj na kojem su upravljački programi instalirani dat će rezultat sličan ovome (verzije paketa mogu se razlikovati):
>
> ```
> 1
> 2
> 3
> ```

Sljedeće naredbe potrebne su za instalaciju određene verzije paketa kako bi nadogradnja bila uspješna:

```
1
```

Konfigurirajte repozitorij tvrtke Microsoft prilagođen sustavu Debian 12 radi pripreme nadogradnje:

```
1
```

### Priprema zrcala CyberElements Cleanroom 4.6

Zrcalo preuzeto tijekom faze pripreme (datoteka s nastavkom tgz) mora se poslati na poslužitelj protokolom SCP. Treba ga smjestiti u direktorij `/tmp/`.

Zatim pripremite zrcalo izvršavanjem sljedećih naredbi kao `root` (preostale datoteke iz neke starije nadogradnje verzije bit će izbrisane):

```
1
2
3
```

### Konfiguracija alata APT

Upravitelj paketa APT konfiguriran je za dohvaćanje paketa sustava Debian 11; mora se ponovno konfigurirati za dohvaćanje paketa sustava Debian 12. Također je potrebno ažurirati referencu na lokalno zrcalo rješenja CyberElements Bastion. Da biste to učinili, pokrenite sljedeće naredbe kao `root`:

```
1
2
```

Autentičnost lokalnog zrcala provjerava se ključem `systancia.gpg` preuzetim tijekom faze pripreme. Pošaljite ga na poslužitelj protokolom SCP, u direktorij `/tmp/`, a zatim ga instalirajte sljedećom naredbom kao `root`:

```
1
```

Uz konfiguraciju novih repozitorija, toplo preporučujemo da primijenite sljedeću postavku kojom se alatu APT nalaže da ne instalira preporučene ovisnosti koje nisu nužno potrebne, kako bi se smanjio broj instaliranih komponenti. Sljedeća naredba primjenjuje tu postavku kao `root`:

```
1
```

Na kraju je potrebno ažurirati popis paketa u repozitorijima sljedećom naredbom:

```
1
```

### Pokretanje nadogradnje verzije

Pristupite poslužitelju Mediation Controller putem protokola SSH i prijeđite na korisnika `root`, a zatim otvorite sesiju alata screen [kako je navedeno gore](#installing-and-using-the-screen-tool).

Započnite ažuriranjem određenih paketa kako bi se nadogradnja verzije mogla provesti. Pri izvršavanju prve naredbe očekuje se poruka o pogrešci, ali pogreška će se ispraviti drugom naredbom:

```
1
2
```

Pri nadogradnji poslužitelja Mediation Controller sa sustava Debian 11 na Debian 12 paket `collectd` se ažurira i postaje nekompatibilan s konfiguracijskom datotekom koju generira CyberElements Bastion (`/etc/collectd/collectd.conf`). To može uzrokovati pogrešku tijekom ažuriranja.

Da biste to izbjegli, onemogućite collectd:

```
1
2
```

Nakon toga nadogradnja se može pokrenuti sljedećom naredbom:

```
1
```

Tijekom nadogradnje bit će vam postavljeno nekoliko pitanja o tome želite li zadržati konfiguracijske datoteke i ažurirati ih prema standardnoj konfiguraciji sustava Debian 12 ili zadržati postojeću specifičnu konfiguraciju. Evo naših preporuka za većinu datoteka na koje možete naići:

| Konfiguracijska datoteka | Preporučena radnja |
|---|---|
| /etc/issue | Za zadržavanje odgovorite `N` |
| /etc/issue.net | Za zadržavanje odgovorite `N` |
| /etc/security/limits.conf | Za zadržavanje odgovorite `N` |
| /etc/login.defs | Za zadržavanje odgovorite `N` |
| /etc/shibboleth/shibboleth2.xml | Za zadržavanje odgovorite `N` |
| /etc/shibboleth/shibd.logger | Primijenite promjene, odgovorite `Y` |
| /etc/default/ntpsec | Primijenite promjene, odgovorite `Y` |
| /etc/snmp/snmpd.conf | Primijenite promjene, odgovorite `Y` |
| /etc/logrotate.d/IPdivaServer | Primijenite promjene, odgovorite `Y` |
| /etc/ssh/sshd_config | Za zadržavanje odgovorite `Keep the local version currently installed` |
| /etc/ssh/ssh_config | Primijenite promjene, odgovorite `Y` |
| /etc/apache2/ports.conf | Za zadržavanje odgovorite `N` |
| /etc/init.d/apache2 | Za zadržavanje odgovorite `N` |
| /etc/modsecurity/modsecurity.conf-recommended | Primijenite promjene, odgovorite `Y` |
| /etc/ipdiva/httpd/commonParameters.conf | Primijenite promjene, odgovorite `Y` |
| /etc/ipdiva/care/djangosettings.ini | Primijenite promjene, odgovorite `Y` |
| /etc/crontab | Primijenite promjene, odgovorite `Y` |
| /etc/openssl.cnf | Primijenite promjene, odgovorite `Y` |
| /etc/audit/rules.d/audit.rules | Za zadržavanje odgovorite `N` |
| /etc/pam.d/su | Za zadržavanje odgovorite `N` |
| /etc/sysctl.conf | Za zadržavanje odgovorite `N` |

Prihvatite konfiguracijsku poruku paketa glibc: ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYE_MediationControllerUpgrade_glibc.png)

Prihvatite automatsko ponovno pokretanje usluga: ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYE_MediationControllerUpgrade_RestartServices.png)

Kada je nadogradnja dovršena, pokrenite sljedeće naredbe da biste ponovno aktivirali `collectd`, uklonili nepotrebne pakete i ponovno pokrenuli računalo:

```
1
2
3
4
```

### Radnje specifične za poslužitelje Mediation Controller u arhitekturi Cluster

Na poslužitelju Mediation Controller `SLAVE` pokrenite sljedeće naredbe kako biste ponovno sinkronizirali zajedničku tajnu između poslužitelja Mediation Controller `MASTER` i `SLAVE`:

```
1
2
```

### Nadogradnja instance baze podataka PostgreSQL

Na poslužitelju Mediation Controller ažurirajte instancu baze podataka PostgreSQL s verzije 13 na verziju 15. Da biste to učinili, izvršite sljedeće upute s odgovarajućim pravima `root`.

Prije migracije provjerite stanje instanci baze podataka PostgreSQL:

```
1
```

Pokrenite sljedeće naredbe kako biste ažurirali instancu baze podataka na PostgreSQL verzije 15:

```
1
2
3
4
```

Provjerite je li instanca baze podataka uspješno nadograđena. Trebale bi se pojaviti dvije instance, jedna u verziji 13, a druga u verziji 15, koja je jedina aktivna. Provjera se izvodi sljedećom naredbom:

```
1
```

Ako je nadogradnja bila uspješna, instanca baze podataka verzije 13 može se izbrisati:

```
1
```

Može se pokrenuti brisanje paketa PostgreSQL verzije 13:

```
1
```

### Migracija baze podataka CyberElements Bastion

Konfiguracija proizvoda pohranjena je u bazi podataka koju je potrebno migrirati kako bi mogla sadržavati konfiguracije promjena koje donosi nova verzija. Operacija se izvodi na poslužitelju Mediation Controller kao `root`.

> **Arhitektura Cluster**
>
> Za arhitekturu Cluster operaciju je potrebno izvesti samo s jednog poslužitelja Mediation Controller, bez obzira na to s kojeg.
>
> Također je potrebno pokrenuti sljedeću naredbu:
>
> ```
> 1
> ```

Migracija podataka pokreće se naredbom ekvivalentnom ovoj:

```
1
```

Pri čemu `<org_clr>` treba zamijeniti nazivom organizacije koja se migrira. Imajte na umu da, ako poslužitelj Mediation Controller ima više organizacija (više tenanta), naredbu ćete morati pokrenuti onoliko puta koliko je organizacija za migraciju.

> **Primjer**
>
> Za platformu CyberElements Bastion koja ima organizacije `systancia` i `systancia-test` morat ćete pokrenuti sljedeće naredbe:
>
> ```
> 1
> 2
> ```

Nakon migracije baze podataka potrebno je ponovno pokrenuti uslugu Apache2:

```
1
```

### Vraćanje konfiguracija

Neke su konfiguracije prebrisane tijekom postupka nadogradnje i potrebno ih je vratiti.

**Datoteka commonParameters.conf:**

Premjestite oznake `<Location>` koje se odnose na poslužitelje HTML5 Gateway, a obično se nalaze na kraju datoteke, iz datoteke `/etc/ipdiva/httpd/commonParameters.conf.dpkg-old` u `/etc/ipdiva/httpd/commonParameters.extra.conf` (stvorite datoteku ako ne postoji). Ako nema oznaka `<Location>`, mogu se kopirati sljedeći primjeri.

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

**Datoteka djangosettings.ini:**

Kopirajte podatke iz retka 2 „allowed_hosts“ datoteke `/etc/ipdiva/care/djangosettings.ini.dpkg-old` u datoteku `/etc/ipdiva/care/djangosettings.ini`. To se može automatizirati sljedećom naredbom kao `root`:

```
1
```

**Primjena vraćanja:**

Za primjenu vraćanja potrebno je ponovno pokretanje usluge Apache2 kao `root`:

```
1
```

## Provjera valjanosti

Nakon dovršetka nadogradnje potrebno je provjeriti valjanost infrastrukture CyberElements Bastion kako bi se osiguralo da ispravno radi prije povratka u produkciju. Ako provjera valjanosti ne uspije, razmotrite vraćanje na prethodno stanje vraćanjem sigurnosnih kopija poslužitelja CyberElements Bastion.

Pristupite administratorskom sučelju organizacije, a zatim idite na izbornik „About“ na upravljačkoj traci kako biste provjerili je li verzija usluge Mediation Controller uspješno nadograđena na 4.6.

Mogu se pokrenuti prvi testovi funkcionalnosti platforme, ali preporučujemo korištenje verzije 4.6 komponente Edge Gateway kako bi se osigurale optimalne performanse aplikacija CyberElements Bastion.
