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

# Edge Gateway versijos atnaujinimas veikimo metu

> **Svarbu**
>
> Edge Gateway versijos atnaujinimo veikimo metu dokumentacija skirta bet kuriam Edge Gateway, veikiančiam su Debian 11. Debian versiją galima patikrinti šia komanda (vykdyti 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.

## 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ą.

### 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 Edge Gateway serverio per SSH ir pereikite į `root`, tada atidarykite screen seansą, [kaip nurodyta aukščiau](#installing-and-using-the-screen-tool).

Atnaujinant Edge Gateway 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/snmp/snmpd.conf | Norėdami pritaikyti pakeitimus, atsakykite `Y` |
| /etc/ssh/sshd_config | Norėdami palikti, atsakykite `Keep the local version currently installed` |
| /etc/pam.d/su | Norėdami palikti, atsakykite `N` |
| /etc/sysctl.conf | Norėdami palikti, atsakykite `N` |
| /etc/audit/rules.d/audit.rules | Norėdami palikti, atsakykite `N` |
| /etc/ssh/ssh_config | Norėdami pritaikyti pakeitimus, atsakykite `Y` |
| /usr/share/tomcat10/logrotate.template | Norėdami pritaikyti pakeitimus, atsakykite `Install the package maintainer's version` |

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

## Patikra

Atlikus versijos atnaujinimą, prieš grįžtant į gamybinę aplinką būtinas patikros etapas, kuriuo įsitikinama, kad CyberElements Bastion infrastruktūra veikia tinkamai. Jei patikra nepavyksta, reikėtų apsvarstyti grąžinimą į ankstesnę būseną atkuriant CyberElements Bastion serverių atsargines kopijas.

Atidarykite administratoriaus sąsają, tada Edge Gateway valdymo meniu.

Atnaujinti Edge Gateway serveriai turėtų rodyti 8.9 versiją, jei jie sėkmingai vėl prisijungė prie Mediation Controller serverio.

Jei visų serverių versija atnaujinta, galima atlikti visus funkcinius testus ir patikrinti visą priėmimo kontrolinį sąrašą.
