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

# Versionsuppgradering av Edge Gateway i drift

> **Viktigt**
>
> Dokumentationen för versionsuppgradering av Edge Gateway i drift gäller varje Edge Gateway som körs på Debian 11. Debian-versionen kan kontrolleras med följande kommando (ska köras via SSH- eller konsolåtkomst):
>
> ```
> 1
> ```

> **Information**
>
> Som påminnelse: byte till `root` på Debian-maskiner måste göras med följande kommando:
>
> ```
> 1
> ```

## Planering och förberedelse

### Öppna nätverksflöden

Vid uppgraderingen av produkten måste många paket laddas ned från Debian-repositorierna, på grund av övergången från Debian 11 till 12. Åtkomst via `TCP 80` till `security.debian.org` och `ftp.fr.debian.org` måste vara öppen.

För att testa öppningen av flödena på maskinen kan en synkronisering av Debian-repositorierna startas. Om felmeddelanden om åtkomsten till Debian-repositorierna visas är nätverksflödet inte öppet, sannolikt blockerat av företagets brandvägg. Synkroniseringen av repositorierna kan startas med följande kommando:

```
1
```

### Ladda ned spegeln och de verktyg som behövs

Spegeln för CyberElements Cleanroom 4.6 kan laddas ned via den här länken (kräver att ett kundkonto skapas): [Systancia Marketplace](https://www.systancia.com/en/my-systancia/marketplace/systancia-cleanroom/downloads-cleanroom/)

Nyckeln `systancia.gpg`, som autentiserar CyberElements Bastion-repositoryt, måste också laddas ner från Systancia Marketplace.

Utöver spegeln krävs verktyg från tredje part för uppgraderingen:

- En SSH-klient (i Windows kan verktyget [PuTTY](https://putty.org/) användas)
- En SCP-klient (i Windows kan verktygen [WinSCP](https://winscp.net/eng/index.php) eller [FileZilla](https://filezilla-project.org/) användas)

### Installation och användning av verktyget screen

Verktyget `screen` gör det möjligt att öppna flera shell-terminaler i en enda konsol. Det är nödvändigt att använda verktyget för att utföra versionsuppgraderingen av CyberElements Bastion, för att ta bort beroendet av nätverksanslutningens stabilitet. Utan verktyget screen skulle installationen nämligen avbrytas om SSH-anslutningen till CyberElements Bastion-servrarna bröts.

Genom att använda verktyget `screen` kan den terminal där uppdateringsprocessen kördes hämtas tillbaka när du återansluter till shell-konsolen på CyberElements Bastion-utrustningen.

Paketet screen bör installeras med följande kommandorad:

```
1
```

För att öppna en ny terminal med `screen` måste följande kommando köras:

```
1
```

Byt ut `<ID>` mot ett namn som identifierar sessionen.

> **Exempel**
>
> Vid versionsuppgraderingar av CyberElements är identifieraren `cye-upgrade` lätt att känna igen. Kommandot blir därför följande:
>
> ```
> 1
> ```

För att återta en terminal som öppnats med `screen` räcker det att köra följande kommando:

```
1
```

Byt ut `<ID>` mot det namn som angavs när sessionen öppnades.

> **Exempel**
>
> Den terminal som tidigare öppnades med identifieraren `cye-upgrade` kan återtas med följande kommando:
>
> ```
> 1
> ```

För att stänga terminalen när uppgraderingen är klar, ange kommandot `exit` eller tangentbordsgenvägen ctrl+d i terminalen.

Detta tar dig tillbaka till konsolen. Meddelandet ”screen is terminating” bekräftar att terminalen har stängts.

## Versionsuppgradering

### Uppdatering av Debian-paketen

Eftersom uppgraderingen av CyberElements Bastion kräver en uppgradering av Debian rekommenderas att du uppdaterar Debian 11-paketen ordentligt innan du byter till Debian 12. Kör följande kommandon som `root` för att göra det (systemuppdatering och därefter borttagning av onödiga paket):

```
1
2
3
```

Meddelanden kan visas som ber dig att ändra konfigurationen i flera konfigurationsfiler. Välj i dessa fall alternativet att behålla den aktuella konfigurationen.

### Förbereda spegeln för CyberElements Cleanroom 4.6

Den spegel som hämtades under förberedelsefasen (filen med filändelsen tgz) måste skickas till servern via SCP. Den ska placeras i katalogen `/tmp/`.

Förbered därefter spegeln genom att köra följande kommandon som `root` (kvarvarande filer från en tidigare versionsuppgradering tas då bort):

```
1
2
3
```

### Konfiguration av APT

Pakethanteraren APT är konfigurerad för att hämta Debian 11-paketen; den måste konfigureras om för att hämta Debian 12-paketen. Det är också nödvändigt att uppdatera referensen till den lokala CyberElements Bastion-spegeln. Kör följande kommandon som `root` för att göra det:

```
1
2
```

Den lokala spegeln autentiseras med nyckeln `systancia.gpg` som laddades ner under förberedelsefasen. Skicka den till servern via SCP, till katalogen `/tmp/`, och installera den sedan med följande kommando som `root`:

```
1
```

Utöver konfigurationen av de nya repositorierna rekommenderar vi starkt att tillämpa följande inställning, så att APT inte installerar rekommenderade beroenden som inte är strikt nödvändiga, för att minska antalet installerade komponenter. Följande kommando tillämpar denna inställning som`root`:

```
1
```

Slutligen måste listan över paket i repositorierna uppdateras med följande kommando:

```
1
```

### Utlösa versionsuppgraderingen

Anslut till Edge Gateway-servern via SSH och växla till `root`, öppna sedan ett screen [enligt anvisningarna ovan](#installing-and-using-the-screen-tool).

När en Edge Gateway uppgraderas från Debian 11 till Debian 12 uppdateras paketet `collectd` och blir inkompatibelt med den konfigurationsfil som CyberElements Bastion har genererat (`/etc/collectd/collectd.conf`). Detta kan ge upphov till ett fel under uppdateringen.

Inaktivera collectd för att undvika detta:

```
1
2
```

Därefter kan uppgraderingen startas med följande kommando:

```
1
```

Under uppgraderingen får du flera frågor om huruvida konfigurationsfilerna ska behållas och uppdateras enligt standardkonfigurationen för Debian 12, eller om den befintliga specifika konfigurationen ska bevaras. Här är våra rekommendationer för de flesta av de filer du kan stöta på:

| Konfigurationsfil | Rekommenderad åtgärd |
|---|---|
| /etc/issue | Behåll, svara `N` |
| /etc/issue.net | Behåll, svara `N` |
| /etc/security/limits.conf | Behåll, svara `N` |
| /etc/login.defs | Behåll, svara `N` |
| /etc/snmp/snmpd.conf | Tillämpa ändringarna, svara `Y` |
| /etc/ssh/sshd_config | Behåll, svara `Keep the local version currently installed` |
| /etc/pam.d/su | Behåll, svara `N` |
| /etc/sysctl.conf | Behåll, svara `N` |
| /etc/audit/rules.d/audit.rules | Behåll, svara `N` |
| /etc/ssh/ssh_config | Tillämpa ändringarna, svara `Y` |
| /usr/share/tomcat10/logrotate.template | Tillämpa ändringarna, svara `Install the package maintainer's version` |

Godkänn den automatiska omstarten av tjänsterna: ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYE_MediationControllerUpgrade_RestartServices.png)

När uppgraderingen är klar kör du följande kommandon för att aktivera `collectd` igen, ta bort de paket som inte behövs och starta om maskinen:

```
1
2
3
4
```

## Validering

När versionsuppgraderingen har genomförts krävs en valideringsfas för att säkerställa att infrastrukturen CyberElements Bastion fungerar korrekt, innan produktionen återupptas. Om valideringen misslyckas bör en återgång via återställning av backuperna av CyberElements Bastion-servrarna övervägas.

Öppna administratörsgränssnittet och därefter menyn för hantering av Edge Gateways.

De uppdaterade Edge Gateways ska rapportera version 8.9 om de har återanslutit till Mediation Controller.

Om alla servrar har uppgraderats kan samtliga funktionstester utföras för att validera hela acceptanslistan.
