> 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/run-the-platform/de/betrieb/node-replacement.md).

# Einen Knoten mit dem ISO-Installer ersetzen

Dieser Leitfaden behandelt den Austausch eines physischen VergeOS-Knotens, indem Laufwerke vom ursprünglichen Server auf die Ersatzhardware verschoben und die **Knoten ersetzen** Option des VergeOS-ISO-Installers verwendet wird, um das neue Chassis erneut mit dem vorhandenen Cluster zu registrieren.

## Übersicht

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

* Dieses Verfahren ersetzt ein Knoten-Chassis, während **die ursprünglichen Knotenlaufwerke wiederverwendet werden** in der neuen Hardware
* Kann für den Austausch ausgefallener Knoten oder die proaktive Außerbetriebnahme von Hardware am Ende der Lebensdauer verwendet werden
* Erfordert den VergeOS-ISO-Installer, der mit der installierten Systemversion übereinstimmt
* Es sollte immer nur ein Knoten gleichzeitig ersetzt werden
  {% endhint %}

{% hint style="warning" %}
**Laufwerke müssen vom ursprünglichen Knoten übertragen werden**

Dieses Verfahren gilt nur, wenn die ursprünglichen Laufwerke auf den Ersatzknoten übertragen werden. Wenn Sie einen Knoten ersetzen müssen **und** seine Laufwerke, wenden Sie sich [VergeOS-Support](/overview/de/support-and-services.md) an
{% endhint %}

### Was Sie lernen werden

* So nehmen Sie einen Knoten sicher offline und bereiten die Ersatzhardware vor
* So verwenden Sie die **Knoten ersetzen** Option des VergeOS-ISO-Installers
* So überprüfen Sie, ob der Ersatzknoten fehlerfrei ist, und er dem Cluster wieder beitritt

### Was Sie benötigen

* Einen bestehenden, fehlerfreien VergeOS-Cluster (mit Ausnahme eines ausgefallenen Knotens, der ersetzt wird)
* Ersatzserver mit allen installierten Laufwerken (vom ursprünglichen Knoten übertragen)
  * Die Ersatzhardware muss mit den vorhandenen Clusterknoten kompatibel sein; ideal ist identische Hardware
* Bootfähiges Medium mit dem VergeOS-ISO-Installer, der mit der derzeit auf dem System installierten Version übereinstimmt
* Administrator-Anmeldedaten für das VergeOS-System

## Bevor Sie beginnen

* **Ersetzen Sie immer nur einen Knoten gleichzeitig.** Vergewissern Sie sich vor dem Start, dass sich keine anderen Knoten derzeit im Wartungsmodus befinden.
* **Überprüfen Sie den Systemzustand.** Stellen Sie sicher, dass sich der Cluster in einem fehlerfreien Zustand befindet (alle vSAN-Tiers grün, keine aktiven Alarme), bevor Sie fortfahren.
* **Planen Sie die Workload-Migration ein.** Wenn auf den verbleibenden Knoten ausreichende Rechenressourcen vorhanden sind, kann der Austausch ohne Ausfallzeit durchgeführt werden. Workloads können während des Verfahrens auf andere Knoten migriert werden.
* **Stellen Sie sicher, dass die Aufbewahrung von Systemschnappschüssen für eine mögliche Rückrollung ausreicht.** Erstellen Sie unmittelbar vor dem Austausch einen Systemschnappschuss oder vergewissern Sie sich, dass bei Bedarf ein aktueller Systemschnappschuss verfügbar ist.

## Austauschverfahren

### Schritt 1: Den ursprünglichen Knoten offline nehmen

Das Vorgehen hängt davon ab, ob der ursprüngliche Knoten noch funktionsfähig ist.

**Wenn der Knoten noch funktionsfähig ist:**

1. Navigieren Sie in der VergeOS-Benutzeroberfläche zu **Infrastruktur** > **Knoten**.
2. Doppelklicken Sie auf den Knoten, um sein Dashboard zu öffnen.
3. Klicken Sie **Wartung aktivieren** im linken Menü und bestätigen Sie.
4. Warten Sie, bis alle laufenden Workloads vom Knoten migriert wurden. Überwachen Sie den Abschnitt **Laufende Maschinen** bis er leer ist. Fahren Sie alle Workloads herunter, die nicht migriert werden können.
5. Sobald sich der Knoten im Wartungsmodus befindet und keine laufenden Workloads mehr hat, schalten Sie ihn aus.
6. Trennen Sie alle Netzwerkkabel vom ursprünglichen Knoten.

**Wenn der Knoten nicht mehr funktionsfähig ist (im System nicht erkannt wird):**

1. Schalten Sie den Knoten aus, falls er nicht bereits ausgeschaltet ist.
2. Trennen Sie alle Netzwerkkabel vom ursprünglichen Knoten.

### Schritt 2: Den Ersatzknoten vorbereiten

1. Notieren Sie die MAC-Adresse jeder NIC auf dem Ersatzserver und vermerken Sie, welcher physische Port welcher Netzwerkrolle entspricht (z. B. core1, core2, external). Diese Informationen benötigen Sie während des NIC-Bestätigungsschritts des Installers.
2. Bei ausgeschaltetem **Ersatzknoten**schließen Sie alle Netzwerkkabel an. Der neue Knoten muss mit denselben Netzwerken verbunden sein wie der ursprüngliche Knoten.

### Schritt 3: Vom VergeOS-ISO booten

1. Stellen Sie sicher, dass das Installationsmedium (z. B. USB-Laufwerk mit dem VergeOS-ISO) mit dem Ersatzknoten verbunden ist.
2. Schalten Sie den Knoten ein und booten Sie vom ISO.

   <div data-gb-custom-block data-tag="hint" data-style="success" class="hint hint-success"><p><strong>Boot-Menü</strong></p><p>Möglicherweise müssen Sie das einmalige Boot-Menü des Servers aufrufen (üblicherweise <strong>F11</strong> oder <strong>F12</strong> beim POST), um das USB-Gerät auszuwählen.</p></div>
3. Wenn das Installationsmenü erscheint, wählen Sie **Knoten ersetzen**.
4. Der zu ersetzende Knoten wird erkannt. Bestätigen Sie, dass der richtige Knoten ausgewählt ist, und drücken Sie **Geben Sie**.

### Schritt 4: Netzwerkverbindungen bestätigen

Der Installer scannt das Netzwerk und listet alle erkannten NICs auf. Prüfen Sie jeden Eintrag und vergewissern Sie sich, dass die angezeigte MAC-Adresse der richtigen Netzwerkrolle entspricht (core1, core2, external usw.).

{% hint style="success" %}
**NIC-Abweichung**

Wenn die NIC-Zuweisungen anscheinend nicht mit den richtigen Netzwerken verbunden sind, beenden Sie den Installer und prüfen Sie Ihre Verkabelung sowie die Switch-Konfigurationen erneut. Nachdem Sie alle Verbindungen korrigiert haben, booten Sie erneut vom Installationsmedium und starten Sie den Installer neu.
{% endhint %}

### Schritt 5: Die Installation abschließen

1. Ein Dialog fragt, ob Sie die Laufwerke des Knotens ersetzen. Wählen Sie **Nein** aus, um anzugeben, dass die ursprünglichen Laufwerke in dieses neue Chassis verschoben wurden.

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>Wenn Sie einen Knoten zusammen mit seinen Laufwerken ersetzen, wenden Sie sich</strong> <a href="/spaces/MJKNXfSglhUzFeFSsOYB/pages/39189b70f7966a9dbadc8b2ff7394f047a77351f"><strong>VergeOS-Support</strong></a><strong>.</strong></p></div>
2. Warten Sie, bis die Installation vollständig abgeschlossen ist. Der Installer schließt den Austausch des Knotens ab und registriert das neue Chassis beim vorhandenen Cluster. Eine Meldung zeigt an, wenn die Installation abgeschlossen ist, und der Knoten wird automatisch neu gestartet. Dieser Vorgang dauert normalerweise 5–15 Minuten.

## Schritte nach dem Austausch

### Überprüfung

1. **Knotenstatus bestätigen:** Navigieren Sie zu **Infrastruktur** > **Knoten** und vergewissern Sie sich, dass alle Knoten, einschließlich des Ersatzknotens, online mit einem fehlerfreien (grünen) Status angezeigt werden.

{% hint style="success" %}
**Wartungsmodus deaktivieren**

Wenn der ersetzte Knoten den Status ***Wartungsmodus*** anzeigt, wählen Sie den Knoten aus und klicken Sie auf **Wartung deaktivieren** im linken Menü.
{% endhint %}

2. **Auf Alarme prüfen:** Navigieren Sie zu **System** > **Alarme** und vergewissern Sie sich, dass keine neuen Alarme ausgelöst wurden.
3. **Netzwerkverbindungen überprüfen:** Öffnen Sie das Dashboard des Ersatzknotens (**Infrastruktur** > **Knoten** > Doppelklicken Sie auf den Knoten). Scrollen Sie zu **NICs** Abschnitts. **Bestätigen Sie:**
   * Core- und externe Netzwerkverbindungen zeigen einen Status von ***AKTIV***
   * Core-Netzwerkverbindungen zeigen einen Fabric-Status von ***Bestätigt***

### Workloads auf dem ersetzten Knoten starten

Nachdem der Austausch vollständig überprüft wurde, können Workloads bei Bedarf zurück auf den Ersatzknoten migriert oder dort neu gestartet werden.

## Zusammenfassung

Wir haben erfolgreich einen physischen Knoten ersetzt, indem wir die ursprünglichen Laufwerke in neue Hardware verschoben und die **Knoten ersetzen** Option des VergeOS-ISO-Installers verwendet haben. Der Ersatzknoten ist jetzt mit dem Cluster registriert und bereit, Workloads auszuführen.

## Problembehebung

### Kein geeigneter Knoten gefunden

**Symptome:**

* Fehler während der Installation, der darauf hinweist, dass kein geeigneter Knoten für den Austausch gefunden wurde

**Lösung:**

* Der ursprüngliche Knoten muss ausgeschaltet/getrennt sein. Ein Knoten, der lediglich in den Wartungsmodus versetzt wurde, kann nicht ersetzt werden.
* Vergewissern Sie sich, dass der ursprüngliche Knoten in der VergeOS-Benutzeroberfläche nicht als "Running" oder "Maintenance Mode" angezeigt wird, und booten Sie den neuen Knoten erneut mit dem VergeOS-Installations-ISO.

### Ersatzinstallation wird nicht wie erwartet abgeschlossen

**Symptome:**

* Der Vorgang bleibt nach der Anzeige von "Stopping the appserver" stehen und wird nicht abgeschlossen
* Die Installation wechselt zur Befehlszeile mit der Meldung: "vergeos install abgebrochen"
* Systemprotokolleinträge:

  ```
  ybsan: Fehler beim Schreiben des Root-Schlüssels auf Knoten 'node2': (5) Ein-/Ausgabefehler
  ```

**Lösung:**

* Diese Bedingungen können darauf hinweisen:
  * **Unzureichende Berechtigungen:** Vergewissern Sie sich, dass Sie Anmeldedaten mit Administratorrechten verwenden
  * **Netzwerkkonfigurationsfehler:** Bestätigen Sie, dass der Ersatzknoten korrekt mit den Kernnetzwerken und dem/den externen Netzwerk(en) verbunden ist.
* Nachdem Sie die erforderlichen Anpassungen vorgenommen haben, können Sie die Installation ohne Neustart erneut starten: `yb-install --restart`

## Zusätzliche Ressourcen

* [Wartungsmodus](/run-the-platform/de/betrieb/maintenance-mode.md)
* [Knotenübersicht](/run-the-platform/de/systemadministration/nodes-overview.md)
* [Bootfähiges Installationsmedium erstellen](/plan-and-deploy/de/implementierungsleitfaden/install-media.md)

{% hint style="info" %}
**Brauchst du Hilfe?**

Wenn Sie Probleme haben oder Fragen, wenden Sie sich an [VergeOS-Support](/overview/de/support-and-services.md).
{% 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/run-the-platform/de/betrieb/node-replacement.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.
