> 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/system-administration/updating-vergeos-system.md).

# Das VergeOS-System aktualisieren

## Überblick

{% hint style="info" %}
**Wichtige Punkte**

* Systemupdates sollten während eines Wartungsfensters durchgeführt werden
* Updates können ohne Ausfallzeit durchgeführt werden, wenn ausreichende Ressourcen verfügbar sind
* Systemupdates werden nur vom Host-System (oberste übergeordnete Ebene) ausgeführt
* Mandantensysteme werden automatisch von ihrem Host-System aktualisiert
* Updates können geplant oder bei Bedarf durchgeführt werden
* Das System verarbeitet während Updates automatisch die Workload-Migration
  {% endhint %}

Dieser Leitfaden enthält detaillierte Anweisungen zum Durchführen von Systemupdates in VergeOS, entweder bei Bedarf oder geplant.

## Voraussetzungen

* Administrativer Zugriff auf das VergeOS Cloud-Dashboard
* Ausreichende Systemressourcen, um die Workload-Migration während Updates zu ermöglichen
* Ein Wartungsfenster (empfohlen, obwohl nicht erforderlich aufgrund der Fähigkeit ohne Ausfallzeit)

## Durchführung von Updates bei Bedarf

### 1. Nach Updates suchen

1. Navigieren Sie zu **System** > **Updates** im Cloud-Dashboard
2. Klicken Sie **Nach Updates suchen** im linken Menü
3. Klicken Sie **Ja** zur Bestätigung
   * Der Bereich „Pakete“ zeigt verfügbare Updates an
   * Ein Cloud-Symbol kennzeichnet herunterladbare Pakete
   * Versionsinformationen zeigen die aktuelle und verfügbare Version an

### 2. Updates herunterladen

1. Klicken Sie **Herunterladen** im linken Menü
2. Klicken Sie **Ja** zur Bestätigung
3. Warten Sie, bis der Download abgeschlossen ist

### 3. Updates installieren

1. Klicken Sie **Installieren** im linken Menü
2. Klicken Sie **Ja** zur Bestätigung
3. Warten Sie, bis die Installation abgeschlossen ist
   * Der Status zeigt „Leerlauf - Neustart erforderlich“ an, wenn bereit
   * Die Option „Neustart“ wird aktiviert

{% hint style="info" %}
Updates, die keine VergeOS-Paketänderungen enthalten, erfordern keine vollständigen Neustarts der Knoten, benötigen aber dennoch die Option „Neustart“, um Änderungen anzuwenden.
{% endhint %}

### 4. Updates anwenden

1. Klicken Sie **Starten Sie** im linken Menü
2. Klicken Sie **Ja** zur Bestätigung
   * Das System verarbeitet jeweils einen Knoten:
     * Knoten wechselt in den Wartungsmodus
     * Workloads werden auf andere Knoten migriert
     * Anwendungsneustarts/Knoten-Neustarts
     * Knoten verlässt den Wartungsmodus
   * Der Fortschritt wird im Feld „Status“ angezeigt
   * Der Status „Aktualisierte Knoten“ verfolgt den Abschluss

{% hint style="success" %}
Verwenden Sie **Neustart abbrechen** um automatische Neustarts bei Bedarf zu stoppen (z. B. für die Neuverteilung von Workloads)
{% endhint %}

## Planung von Updates

### 1. Aktualisierungsaufgabe erstellen

1. Navigieren Sie zu **System** > **Updates** > **Aufgaben**
2. Klicken Sie **Neu** im linken Menü

### 2. Zeitplan konfigurieren

1. Wählen Sie die Planungsoption:
   * **Einmalig**: Standardmäßig „Wird nicht wiederholt“ beibehalten
   * **Wiederkehrend**: Häufigkeit auswählen (wöchentlich, zweiwöchentlich, monatlich)
2. Setzen Sie **Startdatum** und Uhrzeit
3. Für wiederkehrende Aufgaben optional ein Enddatum festlegen

### 3. Aufgabendetails konfigurieren

1. Erforderliche eingeben **Name**
2. Optionale hinzufügen **Beschreibung**
3. Wählen Sie **Aufgabentyp**:
   * Wählen Sie „Herunterladen, installieren und neu starten“ für ein vollständiges Update
4. Optional: Aktivieren **Nach Ausführung löschen**
5. Klicken Sie **Absenden** um zu speichern

## Bewährte Verfahren

* Planen Sie Updates während Zeiten mit geringer Auslastung und während Wartungsfenstern
* Stellen Sie ausreichende Systemressourcen für die Workload-Migration sicher
* Überwachen Sie das System während des Updatevorgangs
* Halten Sie vor größeren Updates regelmäßige Backups bereit
* Überprüfen Sie verfügbare Updates vor der Anwendung

## Fehlerbehebung

{% hint style="warning" %}
**Häufige Probleme**

* **Problem:** Workloads können nicht migriert werden
  * **Lösung:** Überprüfen Sie die ausreichenden Ressourcen auf den Zielknoten
* **Problem:** Der Aktualisierungsvorgang hängt
  * **Lösung:** Überprüfen Sie die Systemprotokolle und wenden Sie sich bei Bedarf an den Support
* **Problem:** Knoten tritt nach dem Neustart nicht wieder bei
  * **Lösung:** Überprüfen Sie die Protokolle und die Netzwerkverbindung
    {% endhint %}

## Feedback

{% hint style="info" %}
**Brauchen Sie Hilfe?**

Wenn Sie während des Updatevorgangs auf Probleme stoßen oder Fragen haben, wenden Sie sich bitte an unser Support-Team.
{% endhint %}

***

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

* Zuletzt aktualisiert: 2024-12-19
* VergeOS-Version: Alle
  {% 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/system-administration/updating-vergeos-system.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.
