> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/knowledge-base/de/troubleshooting/vergeos-update-instructions.md).

# VergeOS-Aktualisierungsanweisungen

{% hint style="danger" %}
**WARNUNG: KEINE HAUPTVERSIONEN ÜBERSPRINGEN**

Wenn Sie beispielsweise Version 4.8 verwenden, aktualisieren Sie bitte zuerst auf Version 4.9, bevor Sie auf 4.10 aktualisieren. **Das Überspringen von Versionen kann zu erheblichen Datenbank- und Konfigurationsproblemen führen.**
{% endhint %}

Die VergeOS-Plattform unterstützt Aktualisierungen mit „Null Ausfallzeit“. Das bedeutet, dass während eines routinemäßigen Aktualisierungsvorgangs Gast-Workloads (VMs und Tenant-Umgebungen) eingeschaltet bleiben und wie gewohnt weiterlaufen können.

> Weitere Informationen zum Aktualisierungsvorgang finden Sie in unserem [Produkthandbuch](/run-the-platform/system-administration/licensing-and-updates.md).

Die für den Abschluss einer Aktualisierung benötigte Zeit variiert je nach Faktoren wie:

* Anzahl der Knoten im System
* Auf dem vSAN verbrauchter Speicher
* Von Workloads während der Aktualisierung erzeugte Datenänderungsrate
* Hardwareleistung (Prozessorgeschwindigkeit, Datenträgertyp, Netzwerkgeschwindigkeit)

{% hint style="warning" %}
**Während der Aktualisierung können Sie sehen, dass sich Ebenen und Laufwerke abwechselnd in den Status Online, Verifying oder Repairing befinden. Das ist normal, da das System die Datenintegrität überprüft.**
{% endhint %}

{% hint style="warning" %}
**Stellen Sie vor der Durchführung einer Aktualisierung sicher, dass die Speicherauslastung Ihres Systems innerhalb der Grenzwerte liegt. In einer Konfiguration mit zwei Knoten sollte die gesamte Systemspeichernutzung beispielsweise unter 50 % liegen, damit der verbleibende Knoten 100 % der Workloads übernehmen kann.**
{% endhint %}

{% hint style="warning" %}
**Stellen Sie sicher, dass sich vor dem Fortfahren mit der Aktualisierung keine Knoten im Wartungsmodus befinden.**
{% endhint %}

## Aktualisierungsvorgang

1. Melden Sie sich in der VergeOS-Benutzeroberfläche an.
2. Navigieren Sie zu **System > Updates**, und wählen Sie dann **Nach Updates suchen** im linken Menü.
   * Ein Popup fordert Sie zu Ja oder Nein auf, wählen Sie **Ja**.
   * Wenn ein Banner erscheint mit der Meldung „Eine neue Nebenversion ist in einem anderen Zweig verfügbar“, folgen Sie der Aufforderung, den Zweig zu wechseln, indem Sie **Zweig wechseln** im linken Menü auswählen. Bestätigen Sie mit **Ja**. ![VergeOSupgrade-new-img2.png](/files/bf48a4212f3defbc8a4c00a6571de2f070d90a19)
3. Die herunterzuladenden Pakete werden nun hervorgehoben. ![VergeOSupgrade-new-img3.png](/files/9282a7de2e1fef03e83238445462e6d22311ad99)
   * Wählen Sie **Herunterladen** im linken Menü.
   * Ein Popup fordert Sie zu Ja oder Nein auf, wählen Sie **Ja**.
   * Der Downloadvorgang wird im Dashboard in der **Aktueller Update-Server** Kachel angezeigt.
4. Sobald der Download abgeschlossen ist, wird die **Installieren** Aktion verfügbar sein.
   * Wählen Sie **Installieren** wenn Sie bereit sind.
   * Bestätigen Sie mit **Ja** um mit der Installation zu beginnen.
5. Nach der Installation erfolgt eine Aufforderung zum Neustart des Systems.
   * Wählen Sie **Starten Sie** im linken Menü, um einen gestaffelten Neustart über alle Knoten zu initiieren.

{% hint style="info" %}
**Hinweis**

Die Aktualisierung beginnt mit **Knoten 1**, wodurch er in den Wartungsmodus versetzt und Workloads auf einen anderen Knoten migriert werden. Bei Änderungen der Nebenversion kann der Zugriff auf die Benutzeroberfläche kurzzeitig verloren gehen, wenn sie auf Knoten 1 zurückfällt. Das ist normal und sollte nicht länger als ein oder zwei Minuten dauern. Für die Workloads sollten keine Netzwerkprobleme auftreten.
{% endhint %}

## Schritte zur Fehlerbehebung

### Nicht migrierbare Workloads

* Dieser Fehler ist normalerweise auf unzureichende Ressourcen (RAM) im Cluster zurückzuführen. Versuchen Sie, andere Workloads zu migrieren, oder passen Sie die RAM-Nutzung an. Weitere Ursachen und Lösungen werden ausführlich beschrieben [hier](/knowledge-base/de/virtual-machines/workloads-failing-to-migrate.md).

### vSAN braucht lange für die Überprüfung

* Der Überprüfungsvorgang hängt von Faktoren wie Netzwerkgeschwindigkeit, Datenträgertyp und verbrauchten Daten ab. HDDs benötigen länger als NVMe- oder SSD-Laufwerke. Bei VergeOS-Versionen 4.9.0 und höher überprüfen Sie den **Vollständiger Walk-Fortschritt** im Ebenen-Dashboard, um eine Anzeige zu erhalten, wie weit die Überprüfung fortgeschritten ist.

  ![walk-percentage.png](/files/ddf4ffe48899bd7023cba560c6616ded17fba1e0)

{% hint style="danger" %}
**WARNUNG**

Dieser Vorgang muss abgeschlossen sein, bevor weitere Knoten neu gestartet werden. Andernfalls kann es zu einem **doppelten Ausfall**, wodurch Workloads abstürzen.
{% endhint %}

### Verbindung zum Update-Server nicht möglich

* Stellen Sie sicher, dass das System auf seinem externen (UI-)Netzwerk über einen funktionierenden DNS-Server verfügt:
  1. Navigieren Sie zum Dashboard des externen Netzwerks.
  2. Wählen Sie **Diagnose** im linken Menü.
  3. Abfrage auf **DNS-Abfrage** und wählen Sie **Senden**.
  4. Wenn DNS korrekt konfiguriert ist, zeigt die Antwort die IP-Adresse von Verge.io an. Andernfalls prüfen Sie die DNS-Einstellungen und wiederholen Sie die Abfrage.
* Abgelaufene Update-Server-Zugangsdaten können dieses Problem ebenfalls verursachen. Diese sind mit der Lizenz des Systems verknüpft und sollten über Ihren VergeOS-Vertriebsmitarbeiter erneuert werden.

***

{% hint style="info" %}
**Dokumentinformationen**

* Zuletzt aktualisiert: 2024-09-03
* VergeOS-Version: 4.12.6
  {% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.verge.io/knowledge-base/de/troubleshooting/vergeos-update-instructions.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
