> 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/sop-scale-out.md).

# VergeOS vSAN Scale-Out-Leitfaden

Dieser Leitfaden bietet Best Practices für das sichere Scale-out eines VergeOS-Systems durch das Hinzufügen eines neuen Knotens. Er konzentriert sich auf Datensicherheit und Systemresilienz durch einen methodischen Ansatz.

{% hint style="info" %}
**Übersicht**

Das Scale-out eines VergeOS-Systems erfordert sorgfältige Planung und Ausführung, um minimale Beeinträchtigungen Ihrer Dienste sicherzustellen. Dieser Leitfaden gliedert den Prozess in Hauptphasen:

1. **Vorbereitung** - Schritte, die vor Ihrem geplanten Wartungsfenster zu unternehmen sind
2. **Verifizierung vor dem Scale-out** - Abschließende Prüfungen unmittelbar vor Beginn des Scale-outs
3. **Durchführung des Scale-outs** - Der Prozess des Hinzufügens eines neuen Knotens
4. **Verifizierung nach dem Scale-out** - Sicherstellen, dass das Scale-out erfolgreich war
   {% endhint %}

{% hint style="info" %}
**Umgebungsspezifische Anforderungen**

Dieser Leitfaden behandelt allgemeine Best Practices. Möglicherweise müssen Sie diese Schritte an Ihre spezifische Umgebung und Ihre Anforderungen anpassen.
{% endhint %}

## Voraussetzungen

* Administrativer Zugriff auf das VergeOS-System
* IPMI-Zugriff auf alle Knoten im Cluster
* Neue Knotenhardware ordnungsgemäß im Rack montiert und angeschlossen
* Netzwerkkonnektivität für den neuen Knoten verifiziert
* USB-Laufwerk mit passender VergeOS-Installer-Version
* **Geschätzte Zeit:** 2–4 Stunden, abhängig vom Daten-Neuaufbau und der Clustergröße

{% hint style="warning" %}
**Wichtig**

Stellen Sie sicher, dass Sie ein Wartungsfenster haben, das die mögliche Zeit für den Neuaufbau berücksichtigt. Die vSAN-Datenumverteilung kann je nach Datenmenge und Speicherleistung mehrere Stunden dauern.
{% endhint %}

## Vorbereitungsphase

Führen Sie diese Schritte rechtzeitig vor Ihrem geplanten Wartungsfenster durch:

### Systembereitschaft

* [ ] Stellen Sie sicher, dass die Aufbewahrung von Systemsnapshots für ein mögliches Rollback ausreichend ist
* [ ] Legen Sie spezifische Erfolgs- und Verifizierungskriterien für Ihre Workloads fest
* [ ] Identifizieren Sie Gruppen von VMs, Diensten usw., die für Ihren spezifischen Anwendungsfall erforderlich sind

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

VDI kann mehrere unterschiedliche Images oder Ressourcengruppen haben. VPS kann sich stärker auf Netzwerkfunktionalität und Konnektivität konzentrieren.
{% endhint %}

* [ ] Kartieren Sie zeitkritische System- und Gastereignisse, die weiterhin funktionieren müssen

### Hardware-Vorbereitung

* [ ] IPMI-Zugriff auf alle vorhandenen Hosts bestätigen
  * Über eine Methode, die im Notfall möglicherweise Konsolenzugriff ermöglicht
* [ ] Den hinzuzufügenden neuen Knoten in diese Wartungsplanung einbeziehen
* [ ] Verifizieren, dass VergeOS eine derzeit unterstützte Version ist
  * VergeOS läuft in der neuesten Version
* [ ] USB-Laufwerk mit passender Installer-Version vorbereitet

### Dokumentation und Planung

* [ ] Plattformdokumentation aktualisieren (Ports, IPs, VLANs usw.)
* [ ] Aktuelle Clusterkonfiguration als Referenz für ein Rollback dokumentieren
* [ ] Planen Sie den Kommunikationszeitplan für betroffene Benutzer

### Ressourcenverifizierung

* [ ] Überprüfen Sie die Ressourcenauslastung des Clusters
  * Stellen Sie sicher, dass Ihr System über genügend freie Ressourcen verfügt, um Ihren größten Knoten zu verlieren
* [ ] Bestätigen Sie die Netzwerkpfade zwischen den Hosts
  * Von Node1: Node Diagnostics -> 'Fabric Configuration' meldet für alle vorhandenen Knoten die Pfade Core1 und Core2 mit 'confirmed:true'

## Verifizierung vor dem Scale-out

Führen Sie diese Prüfungen am Tag der geplanten Wartung durch, bevor Sie mit dem Scale-out beginnen:

### Überprüfung des aktuellen Zustands

* [ ] Ressourcenverfügbarkeit - Das System ist N+1
  * Verifizieren, dass die RAM-Auslastung ausreicht, um Workloads mit einem offline geschalteten Knoten auszuführen
* [ ] Systemsnapshots sind aktuell und verfügbar
  * Setzen Sie den neuesten Snapshot so, dass er erst in mehreren Tagen abläuft, um eine zusätzliche Aufbewahrung zu gewährleisten
* [ ] Bestätigen Sie, dass das Multi-Site-Synchronisieren funktioniert und auf dem neuesten Stand ist
* [ ] Verifizieren, dass alle vSAN-Tiers in einem gesunden Zustand sind
* [ ] Bestätigen Sie, dass keine Knoten einen Neustart ausstehen haben
* [ ] USB-Installer ist eingesteckt und wird auf dem neuen Knoten erkannt
* [ ] Verifizieren, dass die Diagnose 'Fabric Configuration' von Node1 die Pfade Core1 und Core2 für alle vorhandenen Knoten mit 'confirmed:true' meldet

## Ausführungsphase

### Hinzufügen des neuen Knotens

Detaillierte Schritt-für-Schritt-Anweisungen zur Durchführung des vSAN-Scale-outs finden Sie unter:

[Leitfaden zur Installation von Scale-out-Knoten](/plan-and-deploy/de/implementierungsleitfaden/scale-out-nodes.md)

### Überblick über den Hauptprozess

1. **Neuen Knoten booten** vom USB-Installer
2. **Netzwerk einrichten** auf dem neuen Knoten
3. **Knoten dem Cluster beitreten lassen** über die VergeOS-Benutzeroberfläche
4. **vSAN-Verteilung überwachen** - dies ist die längste Phase
5. **Auf Abschluss warten** - vSAN-Tiers müssen wieder den grünen Status erreichen

{% hint style="warning" %}
**Kritische Wartezeit**

Während des Scale-out-Prozesses zeigen die vSAN-Tiers während der Neuaufbauphase einen gelben Status an. Es ist unbedingt erforderlich, zu warten, bis der vSAN-Tier wieder einen gesunden "grünen" Status erreicht hat, bevor Sie mit anderen Operationen fortfahren oder das Scale-out als abgeschlossen betrachten.
{% endhint %}

{% hint style="success" %}
**Fortschritt überwachen**

Sie können den Fortschritt des vSAN-Neuaufbaus in der VergeOS-Oberfläche unter System -> vSAN überwachen. Der Neuaufbauprozess zeigt den prozentualen Abschluss und die geschätzte verbleibende Zeit an.
{% endhint %}

## Verifizierung nach dem Scale-out

Nachdem das Scale-out abgeschlossen ist, verifizieren Sie, dass das System korrekt arbeitet:

### Systemzustandsprüfungen

* [ ] Bestätigen, dass der neue Knoten in der VergeOS-WebUI erscheint
  * Keine knotenbezogenen Warnungen in seinen Protokollen
* [ ] Verifizieren, dass die vSAN-Reparaturen abgeschlossen sind und alle Tiers grün anzeigen
* [ ] Testen/bestätigen Sie Gastsysteme wie in Ihren Erfolgskriterien erforderlich
* [ ] Überprüfen Sie die Protokolle auf neue oder unerwartete Ereignisse
* [ ] Überprüfen Sie alle in Ihren Vorbereitungsschritten festgelegten Erfolgskriterien
* [ ] Bestätigen, dass die Verteilung der Clusterressourcen ausgeglichen ist
* [ ] VM-Migration zum/vom neuen Knoten testen

### Leistungsvalidierung

* [ ] Überwachen Sie die Systemleistung 24–48 Stunden nach dem Scale-out
* [ ] Verifizieren, dass die Speicherleistung den Erwartungen entspricht
* [ ] Bestätigen, dass der Netzwerkdurchsatz zum neuen Knoten optimal ist

## Problembehebung

### Häufige Probleme

**vSAN-Ebene bleibt nach längerer Zeit gelb**

* Netzwerkkonnektivität zwischen den Knoten prüfen
* Gesundheitszustand der Speichertiers unter System -> vSAN verifizieren
* Sicherstellen, dass zwischen den Knoten ausreichend Bandbreite vorhanden ist
* Wenden Sie sich an den Support, wenn der Neuaufbau länger als der erwartete Zeitraum stagniert

**Neuer Knoten wird nicht in der WebUI angezeigt**

* Netzwerkkonfiguration und Konnektivität überprüfen
* DHCP-/statische-IP-Zuweisung prüfen
* Bestätigen, dass die USB-Installer-Version mit der Cluster-Version übereinstimmt
* Installationsprotokolle des Knotens prüfen

**Leistungsabfall während des Neuaufbaus**

* Das ist während der vSAN-Verteilung normal
* Erwägen Sie, die Maßnahme in Zeiten geringer Auslastung zu planen
* Bei Bedarf überwachen und die Workload anpassen

**Probleme mit dem Netzwerk-Fabric**

* Netzwerkpfade Core1 und Core2 verifizieren
* Physische Netzwerkverbindungen prüfen
* Bestätigen, dass die VLAN-Konfiguration mit den vorhandenen Knoten übereinstimmt

## Rollback-Verfahren

{% hint style="warning" %}
**Überlegungen zum Rollback**

Wenn Probleme auftreten, ist der sicherste Ansatz, anzuhalten, das unerwartete Verhalten zu untersuchen und dann mit einem klaren Verständnis des Problems fortzufahren. Das vollständige Entfernen eines Knotens kann eine vSAN-Datenumverteilung erfordern.
{% endhint %}

### Wenn ein Rollback erforderlich ist

1. **Die Installation stoppen** falls sie noch läuft
2. **Den neuen Knoten herunterfahren** um Datenkorruption zu verhindern
3. **vSAN stabilisieren lassen** wenn Daten teilweise migriert wurden
4. **Knoten aus dem Cluster entfernen** über die VergeOS-UI, falls er erfolgreich hinzugefügt wurde
5. **Systemstabilität überwachen** bevor Sie das Scale-out neu planen

## Nächste Schritte

Nach erfolgreichem Abschluss des Scale-outs:

* [ ] Überwachungssysteme aktualisieren, um den neuen Knoten einzuschließen
* [ ] Dokumentation mit den Details des neuen Knotens aktualisieren
* [ ] Regelmäßige Wartung für den neuen Knoten planen
* [ ] Erwägen Sie, Sicherungs- und DR-Verfahren zu aktualisieren, um die erhöhte Kapazität zu berücksichtigen
* [ ] Planen Sie auf Grundlage der Wachstumsprognosen eventuell weiteren Scale-out-Bedarf ein

{% hint style="danger" %}
**Notfallunterstützung**

Sollten Sie Probleme mit Ihrem VergeOS-Scale-out haben, wenden Sie sich bitte an [unser Support-Team](/overview/de/support-and-services.md) für sofortige Unterstützung.
{% 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/sop-scale-out.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.
