> Source: https://docs.cyberelements.io/bastion/4.6/sl/Upgrade/HotVersionUpgrade/EdgeGateway/

# Nadgradnja komponente Edge Gateway med delovanjem

> **Pomembno**
>
> Dokumentacija za nadgradnjo komponente Edge Gateway med delovanjem je namenjena vsem komponentam Edge Gateway, ki se izvajajo v sistemu Debian 11. Različico sistema Debian lahko preverite z naslednjim ukazom (izvedite ga prek SSH ali dostopa do konzole):
>
> ```
> 1
> ```

> **Informacije**
>
> Opomnimo, da je treba na računalnikih Debian preklop na `root` izvesti z naslednjim ukazom:
>
> ```
> 1
> ```

## Načrtovanje in priprava

### Odpiranje omrežnih tokov

Pri nadgradnji izdelka je treba zaradi prehoda z različice Debian 11 na 12 prenesti številne pakete iz skladišč sistema Debian. Odprt mora biti dostop `TCP 80` do `security.debian.org` in `ftp.fr.debian.org`.

Če želite preizkusiti, ali so tokovi v računalniku odprti, lahko zaženete sinhronizacijo skladišč sistema Debian. Če se prikažejo sporočila o napakah pri dostopu do skladišč sistema Debian, omrežni tok ni odprt in ga verjetno blokira požarni zid podjetja. Sinhronizacijo skladišč lahko zaženete z naslednjim ukazom:

```
1
```

### Prenos zrcala in potrebnih orodij

Zrcalo CyberElements Cleanroom 4.6 lahko prenesete s te povezave (zahteva ustvarjanje računa stranke): [Systancia Marketplace](https://www.systancia.com/en/my-systancia/marketplace/systancia-cleanroom/downloads-cleanroom/)

Ključ `systancia.gpg`, s katerim se preverja pristnost skladišča CyberElements Bastion, je treba prav tako prenesti s Systancia Marketplace.

Poleg zrcala boste za postopek nadgradnje potrebovali orodja drugih ponudnikov:

- Odjemalec SSH (v sistemu Windows lahko uporabite orodje [PuTTY](https://putty.org/))
- Odjemalec SCP (v sistemu Windows lahko uporabite orodji [WinSCP](https://winscp.net/eng/index.php) ali [FileZilla](https://filezilla-project.org/))

### Namestitev in uporaba orodja screen

Orodje `screen` omogoča odpiranje več terminalov lupine v eni konzoli. To orodje je nujno uporabiti pri nadgradnji različice CyberElements Bastion, da odpravite odvisnost od stabilnosti omrežne povezljivosti. Brez orodja screen bi se namestitev namreč ustavila ob prekinitvi povezljivosti SSH s strežniki CyberElements Bastion.

Z orodjem `screen` lahko ob ponovni povezavi s konzolo lupine opreme CyberElements Bastion znova pridobite terminal, v katerem se je izvajal postopek posodobitve.

Paket screen namestite z naslednjo ukazno vrstico:

```
1
```

Če želite odpreti nov terminal `screen`, izvedite naslednji ukaz:

```
1
```

Zamenjajte `<ID>` z imenom, ki identificira sejo.

> **Primer**
>
> Pri nadgradnjah različice CyberElements je identifikator `cye-upgrade` lahko prepoznaven. Ukaz bi bil torej naslednji:
>
> ```
> 1
> ```

Če želite znova pridobiti terminal, ki ga je odprlo orodje `screen`, preprosto izvedite naslednji ukaz:

```
1
```

Zamenjajte `<ID>` z imenom, določenim ob odpiranju seje.

> **Primer**
>
> Terminal, ki je bil prej odprt z identifikatorjem `cye-upgrade`, lahko znova pridobite z naslednjim ukazom:
>
> ```
> 1
> ```

Če želite terminal zapreti po končani nadgradnji, v terminalu vnesite ukaz `exit` ali uporabite bližnjico na tipkovnici ctrl+d.

S tem se vrnete v konzolo. Sporočilo „screen is terminating“ potrjuje, da je bil terminal zaprt.

## Nadgradnja

### Posodabljanje paketov sistema Debian

Ker nadgradnja CyberElements Bastion zahteva nadgradnjo sistema Debian, je priporočljivo, da pred prehodom na Debian 12 ustrezno posodobite pakete Debian 11. To storite tako, da kot `root` zaženete naslednje ukaze (posodobitev sistema in nato odstranitev nepotrebnih paketov):

```
1
2
3
```

Prikažejo se lahko sporočila, ki vas pozivajo k spremembi konfiguracije več konfiguracijskih datotek. V teh primerih izberite možnost, da ohranite trenutno konfiguracijo.

### Priprava zrcala CyberElements Cleanroom 4.6

Zrcalo, pridobljeno v fazi priprave (datoteka s pripono tgz), je treba poslati na strežnik prek SCP. Postaviti ga je treba v imenik `/tmp/`.

Nato pripravite zrcalo tako, da kot `root` izvedete naslednje ukaze (preostale datoteke iz prejšnje nadgradnje različice bodo izbrisane):

```
1
2
3
```

### Konfiguracija APT

Upravitelj paketov APT je konfiguriran za pridobivanje paketov Debian 11; znova ga je treba konfigurirati za pridobivanje paketov Debian 12. Posodobiti je treba tudi sklic na lokalno zrcalo CyberElements Bastion. To storite tako, da kot `root` zaženete naslednje ukaze:

```
1
2
```

Pristnost lokalnega zrcala se preverja s ključem `systancia.gpg`, prenesenim v fazi priprave. Prek protokola SCP ga pošljite na strežnik v imenik `/tmp/` in ga nato kot `root` namestite z naslednjim ukazom:

```
1
```

Poleg konfiguracije novih skladišč močno priporočamo, da uporabite naslednjo nastavitev, s katero upravitelju APT naročite, naj ne namešča priporočenih odvisnosti, ki niso nujno potrebne, in tako zmanjšate število nameščenih komponent. Naslednji ukaz uporabi to nastavitev kot `root`:

```
1
```

Na koncu je treba posodobiti seznam paketov v skladiščih z naslednjim ukazom:

```
1
```

### Sprožitev nadgradnje različice

Prek SSH dostopite do strežnika Edge Gateway in preklopite na `root`, nato odprite sejo screen, [kot je navedeno zgoraj](#installing-and-using-the-screen-tool).

Pri nadgradnji komponente Edge Gateway s sistema Debian 11 na Debian 12 se paket `collectd` posodobi in postane nezdružljiv s konfiguracijsko datoteko, ki jo ustvari CyberElements Bastion (`/etc/collectd/collectd.conf`). To lahko med posodobitvijo povzroči napako.

Da se temu izognete, onemogočite collectd:

```
1
2
```

Nato lahko nadgradnjo zaženete z naslednjim ukazom:

```
1
```

Med nadgradnjo boste dobili več vprašanj o tem, ali želite konfiguracijske datoteke ohraniti in jih posodobiti v skladu s standardno konfiguracijo sistema Debian 12 ali ohraniti obstoječo specifično konfiguracijo. Tukaj so naša priporočila za večino datotek, na katere lahko naletite:

| Konfiguracijska datoteka | Priporočeno dejanje |
|---|---|
| /etc/issue | Za ohranitev odgovorite `N` |
| /etc/issue.net | Za ohranitev odgovorite `N` |
| /etc/security/limits.conf | Za ohranitev odgovorite `N` |
| /etc/login.defs | Za ohranitev odgovorite `N` |
| /etc/snmp/snmpd.conf | Uveljavite spremembe, odgovorite `Y` |
| /etc/ssh/sshd_config | Ohranite, odgovorite `Keep the local version currently installed` |
| /etc/pam.d/su | Ohranite, odgovorite `N` |
| /etc/sysctl.conf | Ohranite, odgovorite `N` |
| /etc/audit/rules.d/audit.rules | Ohranite, odgovorite `N` |
| /etc/ssh/ssh_config | Uveljavite spremembe, odgovorite `Y` |
| /usr/share/tomcat10/logrotate.template | Uveljavite spremembe, odgovorite `Install the package maintainer's version` |

Sprejmite samodejni ponovni zagon storitev: ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYE_MediationControllerUpgrade_RestartServices.png)

Ko je nadgradnja končana, zaženite naslednje ukaze, da znova aktivirate `collectd`, odstranite nepotrebne pakete in znova zaženete računalnik:

```
1
2
3
4
```

## Preverjanje veljavnosti

Ko je nadgradnja končana, je pred vrnitvijo v produkcijo potrebna faza preverjanja veljavnosti, ki zagotovi, da infrastruktura CyberElements Bastion pravilno deluje. Če preverjanje ne uspe, razmislite o povrnitvi prejšnjega stanja z obnovitvijo varnostnih kopij strežnikov CyberElements Bastion.

Odprite skrbniški vmesnik in nato meni za upravljanje strežnikov Edge Gateway.

Posodobljeni strežniki Edge Gateway bi morali poročati različico 8.9, če so se uspešno znova povezali s storitvijo Mediation Controller.

Če so bili nadgrajeni vsi strežniki, lahko izvedete vse funkcionalne preizkuse, da potrdite celoten kontrolni seznam za prevzem.
