> 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/learn-the-platform/de/modul-3-installation/03-adding-nodes.md). # Knoten hinzufügen ## Überblick Sobald Ihr Controller-Cluster mit zwei Knoten betriebsbereit ist, unterstützt VergeOS drei Methoden zur Kapazitätserweiterung: **Scale-out-Knoten** (fügt einem bestehenden HCI-Cluster sowohl Rechenleistung als auch Speicher hinzu), **Nur-Speicher-Knoten** (dedizierte Speichererweiterung) und **Nur-Rechen-Knoten** (dedizierte Rechenerweiterung). Jeder Knotentyp folgt einem optimierten USB-Installer-Workflow, der das vorhandene System im Core Fabric automatisch erkennt. Diese Seite behandelt die Voraussetzungen, Installationsschritte und Verifizierungsverfahren für alle drei Knotentypen. ## Voraussetzungen Bevor Sie einen Knoten zu Ihrem VergeOS-System hinzufügen, stellen Sie sicher, dass die folgenden Bedingungen erfüllt sind: | Anforderung | Details | | ----------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Funktionierendes Cluster mit 2 Knoten** | Die primären und sekundären Controller-Knoten aus dem [Installationshandbuch](/learn-the-platform/de/modul-3-installation/02-controller-installation.md) müssen vollständig installiert und fehlerfrei sein | | **Netzwerkbereitschaft** | VLANs, physische NIC-Zuweisungen und die Verkabelung des Core Fabric müssen der bei der Ersteinrichtung dokumentierten Konfiguration entsprechen | | **Passende Hardware** | Scale-out- und Nur-Speicher-Knoten sollten identische Hardwarespezifikationen (CPU, Speicher, NICs, RAM) wie die vorhandenen Knoten im Zielcluster haben | | **USB-Installer** | VergeOS-Installationsmedium, das zur Version Ihres vorhandenen Clusters passt | | **Cluster in der UI erstellt** | Wenn Sie zum ersten Mal einen **neuen Clustertyp** (Nur-Speicher oder Nur-Rechen) hinzufügen, erstellen Sie den Cluster zuerst in der VergeOS-UI **vor dem** Starten des Installers | {% hint style="warning" %} **Cluster vor der Installation von Knoten erstellen** Wenn dies Ihr erster Nur-Speicher- oder Nur-Rechen-Knoten ist, den Sie hinzufügen, **müssen Sie** den entsprechenden Cluster zuerst in der VergeOS-UI erstellen: 1. Navigieren Sie zu **System → Cluster** 2. Klicken Sie auf **Neuer Cluster** 3. Setzen Sie die Rolle des Clusters mit den unabhängigen **Rechenleistung** und **Speicher** Schaltern — dies ist keine einzelne Entweder-oder-Auswahl. Aktivieren Sie **Speicher** nur (Rechenleistung aus) für einen Nur-Speicher-Cluster oder **Rechenleistung** nur (Speicher aus) für einen Nur-Rechen-Cluster. (Ein HCI-Cluster hat *beide* aktiviert.) 4. Speichern Sie die Clusterkonfiguration Der Installer kann keinen Knoten zu einem Cluster hinzufügen, der noch nicht existiert. {% endhint %} ## Vergleich der Knotentypen Das Verständnis der Unterschiede zwischen den Knotentypen hilft Ihnen, die richtige Erweiterungsstrategie zu wählen: ```mermaid flowchart TD A["Müssen Sie die Kapazität erweitern?"] --> B{"Welche Ressource\nist der Engpass?"} B -->|"Sowohl Rechenleistung\nals auch Speicher"| C["Scale-out-Knoten\n(HCI-Erweiterung)"] B -->|"Nur Speicher"| D["Nur-Speicher-Knoten\n(dedizierter Speicher)"] B -->|"Nur Rechenleistung"| E["Nur-Rechen-Knoten\n(dedizierte Rechenleistung)"] C --> F["Installer-Typ: Scale-Out\nvSAN: Ja\nFührt VMs aus: Ja"] D --> G["Installer-Typ: Scale-Out\nvSAN: Ja\nFührt VMs aus: Nein"] E --> H["Installer-Typ: Nur Rechenleistung\nvSAN: Nein\nFührt VMs aus: Ja"] style C fill:#e3f2fd,stroke:#1565c0 style D fill:#e8f5e9,stroke:#2e7d32 style E fill:#fff3e0,stroke:#e65100 ``` | Merkmal | Scale-Out | Nur-Speicher | Nur-Rechen | | ----------------------------------------- | ------------------------------------------------------- | ------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- | | **Auswahl des Installers** | "Scale-Out" | "Scale-Out" | "Nur Rechenleistung" | | **vSAN-Beteiligung** | Ja — Laufwerke werden zu vorhandenen Ebenen hinzugefügt | Ja — Laufwerke werden zu vorhandenen Ebenen hinzugefügt | Nein — Installation ohne Konfiguration des lokalen Speichers (per PXE gestartete Nur-Rechen-Knoten benötigen kein lokales Boot-Laufwerk) | | **Führt VM-Workloads aus** | Ja | Nein | Ja | | **Erfordert vorherige Clustererstellung** | Nein (tritt einem vorhandenen HCI-Cluster bei) | Ja (wenn erster Speicherknoten) | Ja (wenn erster Rechenknoten) | | **Typischer Anwendungsfall** | Ausgewogenes HCI-Wachstum | UCI-Speichererweiterung | GPU-/ML-/VDI-Rechenerweiterung | ## Installation des Scale-out-Knotens Scale-out-Knoten sind der einfachste Weg, ein HCI-Cluster zu erweitern. Sie fügen sowohl Rechen- als auch Speicherkapazität proportional hinzu, unter Verwendung von Hardware, die den vorhandenen Controller-Knoten identisch ist. ### Installationsschritte 1. **Vom VergeOS-USB-Installer booten** * Stecken Sie den USB-Installer in den Server, der als Scale-out-Knoten vorgesehen ist * Starten Sie neu und wählen Sie das USB-Laufwerk im BIOS-/UEFI-Bootmenü als Boot-Gerät aus 2. **Knotentyp auswählen → "Scale-Out"** * Wenn der Installer das Knotentyp-Menü anzeigt, wählen Sie **Scale-Out** * Dies weist den Installer an, einem vorhandenen Cluster mit sowohl Rechen- als auch Speicherrolle beizutreten 3. **Admin-Anmeldedaten eingeben** * Geben Sie den Admin-Benutzernamen und das Passwort an, die während der Installation des primären Controllers erstellt wurden * Diese Anmeldedaten authentifizieren den neuen Knoten gegenüber dem vorhandenen System 4. **Automatische Netzwerkerkennung** * Der Installer erkennt die Core-Fabric-Konfiguration automatisch, indem er auf UDP-Pakete von vorhandenen Knoten lauscht * Überprüfen Sie, dass die erkannten NICs Ihrer dokumentierten Kabelzuordnung entsprechen > **Tipp:** Der Installer fordert Sie möglicherweise auf anzugeben, welche NIC für das **Externe** Netzwerk verwendet wird, wenn keine automatische Erkennung möglich ist. Halten Sie Ihre Dokumentation zur NIC-zu-Port-Zuordnung bereit. 5. **Clusterauswahl** (wenn mehrere Cluster vorhanden sind) * Wenn Ihr System mehr als einen Cluster hat, fordert der Installer Sie auf auszuwählen, welchem Cluster dieser Knoten beitreten soll * Wählen Sie im Zielcluster den Knoten aus, dem dieser neue Knoten in der Hardware am ehesten entspricht 6. **vSAN-Festplattenkonfiguration** * Der Installer zeigt die erkannten Laufwerke und ihre vorgeschlagenen Ebenenzuweisungen an * Bestätigen Sie, dass die Speicherebenen der vorhandenen Clusterkonfiguration entsprechen — **Gleichmäßigkeit ist entscheidend** * Überprüfen und finalisieren Sie die Laufwerksauswahl 7. **Installation abschließen** * Der Installer formatiert die Laufwerke, installiert VergeOS und integriert den Knoten in den Cluster * Der Knoten startet nach Abschluss der Installation automatisch neu * Entfernen Sie das USB-Installationsmedium, wenn Sie dazu aufgefordert werden 8. **In der UI verifizieren** * Melden Sie sich in der VergeOS-Web-UI an * Navigieren Sie zu **Infrastruktur → Knoten** und bestätigen Sie, dass der neue Knoten mit einem betriebsbereiten Status erscheint * Prüfen Sie **System → vSAN** um zu überprüfen, dass neue Laufwerke integriert sind und die Ebenen fehlerfrei sind {% hint style="info" %} Nachdem der Knoten beitritt, verteilt das vSAN die Daten neu, um die neuen Laufwerke einzubeziehen. Der Ebenenstatus kann **gelb** während der Wiederaufbauphase anzeigen — das ist normal. Warten Sie, bis alle Ebenen wieder **grün** sind, bevor Sie einen weiteren Knoten hinzufügen oder Wartungsarbeiten durchführen. {% endhint %} ## Installation des Nur-Speicher-Knotens Nur-Speicher-Knoten erweitern die vSAN-Kapazität, ohne Rechenressourcen hinzuzufügen. Sie werden in UCI-(Unified Compute Infrastructure)-Architekturen verwendet, in denen Speicher und Rechenleistung unabhängig skaliert werden. ### Vor der Installation: Speicher-Cluster erstellen Wenn dies Ihr **erster** Nur-Speicher-Knoten ist, erstellen Sie den Speicher-Cluster in der UI: 1. Navigieren Sie zu **System → Cluster** 2. Klicken Sie auf **Neuer Cluster** 3. Aktivieren Sie den **Speicher** Schalter und lassen Sie **Rechenleistung** aus 4. Speichern Sie die Konfiguration ### Installationsschritte Die Installation des Nur-Speicher-Knotens verwendet die **gleiche Installer-Option "Scale-Out"** wie ein regulärer Scale-out-Knoten. Der entscheidende Unterschied besteht darin, dass der Knoten einem Nur-Speicher-Cluster statt einem HCI-Cluster beitritt. 1. **Vom USB-Installer booten** — gleich wie bei Scale-out 2. **Knotentyp auswählen → "Scale-Out"** — der Installer verwendet "Scale-Out" sowohl für HCI- als auch für Nur-Speicher-Knoten 3. **Admin-Anmeldedaten eingeben** — gegenüber dem vorhandenen System authentifizieren 4. **Automatische Netzwerkerkennung** — NIC-Zuweisungen überprüfen 5. **Clusterauswahl** — wählen Sie den **Speicher-Cluster** aus, den Sie in der UI erstellt haben; wählen Sie den Knoten aus, dem dieser neue Knoten am ehesten entspricht 6. **vSAN-Festplattenkonfiguration** — bestätigen Sie, dass die Ebenenzuweisungen der vorgesehenen Konfiguration des Speicher-Clusters entsprechen 7. **Installation abschließen** — Laufwerke werden formatiert, VergeOS wird installiert und der Knoten startet neu 8. **In der UI verifizieren** — bestätigen Sie, dass der Knoten auf der Seite „Knoten“ unter dem richtigen Speicher-Cluster erscheint {% hint style="success" %} Da Nur-Speicher-Knoten die Installer-Option "Scale-Out" verwenden, ist der Unterscheidungsfaktor der **Cluster, den Sie auswählen** in Schritt 5. Der Clustertyp (Nur-Speicher) bestimmt die Rolle des Knotens im System. {% endhint %} ## Installation des Nur-Rechen-Knotens Nur-Rechen-Knoten bieten zusätzliche CPU-, RAM- und optional GPU-Ressourcen, ohne an vSAN-Speicher teilzunehmen. Sie sind ideal für Workloads, die hohe Rechenleistung benötigen — maschinelles Lernen, Rendering, VDI oder Datenanalyse. ### Vor der Installation: Rechen-Cluster erstellen Wenn dies Ihr **erster** Nur-Rechen-Knoten, erstellen Sie den Rechen-Cluster in der UI: 1. Navigieren Sie zu **System → Cluster** 2. Klicken Sie auf **Neuer Cluster** 3. Aktivieren Sie den **Rechenleistung** Schalter und lassen Sie **Speicher** aus 4. Speichern Sie die Konfiguration ### Installationsschritte 1. **Vom USB-Installer booten** — gleich wie bei anderen Knotentypen 2. **Knotentyp auswählen → "Nur Rechenleistung"** — dies ist eine separate Installer-Option, anders als "Scale-Out" 3. **Admin-Anmeldedaten eingeben** — gegenüber dem vorhandenen System authentifizieren 4. **Automatische Netzwerkerkennung** — NIC-Zuweisungen überprüfen 5. **Clusterauswahl** (optional) — wenn Sie dazu aufgefordert werden, wählen Sie den **Rechen-Cluster** und den Knoten aus, dem dieser neue Knoten am ehesten entspricht 6. **Installation abschließen** — der Installer konfiguriert die Netzwerkeinstellungen und **installiert ohne Konfiguration des lokalen Speichers**. Nur-Rechen-Knoten können auch per PXE gebootet werden; in diesem Fall ist kein lokales Boot-Laufwerk erforderlich. Der Knoten startet automatisch neu. 7. **In der UI verifizieren** — bestätigen Sie, dass der Knoten auf der Seite „Knoten“ unter dem richtigen Rechen-Cluster erscheint {% hint style="info" %} Nur-Rechen-Knoten haben **keinen vSAN-Festplattenkonfigurationsschritt**. Sie greifen über das Core Fabric auf Speicher von Knoten in HCI- oder Nur-Speicher-Clustern zu. Dies ist der wesentliche Unterschied zu Scale-out- und Nur-Speicher-Installationen. {% endhint %} ## Bewährte Vorgehensweisen für die Installationsreihenfolge Beim Bereitstellen eines Multi-Cluster-Systems (UCI-Architektur) befolgen Sie diese empfohlene Reihenfolge: ```mermaid flowchart LR A["1. Controller-Knoten\n(Cluster 1)"] --> B["2. Speicher-Knoten\n(Cluster 2)"] B --> C["3. Rechen-Knoten\n(Cluster 3)"] style A fill:#e3f2fd,stroke:#1565c0 style B fill:#e8f5e9,stroke:#2e7d32 style C fill:#fff3e0,stroke:#e65100 ``` 1. **Installieren Sie zuerst die Controller-Knoten** — sie bilden den Grundcluster mit Tier-0-Metadatenspeicher 2. **Fügen Sie die Speicher-Knoten als Zweites hinzu** — stellt sicher, dass vSAN-Speicherkapazität verfügbar ist, bevor Rechenknoten sie benötigen 3. **Fügen Sie die Rechenknoten zuletzt hinzu** — sie können sofort über das Core Fabric auf Speicher zugreifen Innerhalb eines Clusters, **fügen Sie Knoten nacheinander hinzu** — warten Sie, bis jeder Knoten die Installation abgeschlossen hat und in der UI fehlerfrei erscheint, bevor Sie den nächsten starten. Dadurch werden überlappende vSAN-Umverteilungs-/Wiederaufbauvorgänge vermieden, wenn jeder neue Knoten beitritt. ## Problembehandlung Wenn bei einer Knoteninstallation Probleme auftreten: | Aktion | Befehl | Beschreibung | | ----------------------------- | ---------------------- | ------------------------------------------------------------------ | | **Installer abbrechen** | Drücken Sie `Esc` | Wechselt zu einer Eingabeaufforderung | | **Installation fortsetzen** | `yb-install` | Setzt dort fort, wo der Installer aufgehört hat | | **Von Grund auf neu starten** | `yb-install --restart` | Setzt den gesamten Installationsprozess zurück und startet ihn neu | ### Häufige Probleme **Knoten erscheint nach dem Neustart nicht in der UI:** * Überprüfen Sie die Netzwerkkonnektivität — stellen Sie sicher, dass die NICs des Core Fabric korrekt verkabelt sind * Prüfen Sie, ob die Version des USB-Installers mit der auf den Controllern laufenden VergeOS-Version übereinstimmt * Prüfen Sie die Installationsprotokolle des Knotens über die Konsole **vSAN-Ebene bleibt über längere Zeit gelb:** * Dies ist während der Datenumverteilung normal — überwachen Sie den Fortschritt in **System → vSAN** * Stellen Sie sicher, dass zwischen den Knoten im Core Fabric ausreichend Bandbreite vorhanden ist * Wenden Sie sich an den VergeOS-Support, wenn der Wiederaufbau über die erwarteten Zeiträume hinaus stagniert **Installer kann das Netzwerk nicht automatisch erkennen:** * Überprüfen Sie, ob die Switch-Ports des Core Fabric korrekt konfiguriert sind (Jumbo Frames, STP deaktiviert) * Prüfen Sie, ob die physische Verkabelung der dokumentierten NIC-zu-Port-Zuordnung entspricht * Versuchen Sie eine manuelle Netzwerkkonfiguration, wenn die automatische Erkennung wiederholt fehlschlägt **„Keine Cluster verfügbar“ bei der Clusterauswahl:** * Stellen Sie sicher, dass Sie den Ziel-Cluster (Storage oder Compute) in der UI erstellt haben, bevor Sie den Installer booten * Überprüfen Sie, ob der Clustertyp mit dem Knotentyp des Installers übereinstimmt ## Verifizierungsliste Nachdem Sie einen Knoten hinzugefügt haben, bestätigen Sie Folgendes: * [ ] Knoten erscheint auf der **Infrastruktur → Knoten** Seite mit einem betriebsbereiten Status * [ ] Knoten zeigt die korrekte Clusterzuweisung * [ ] Für Scale-out-/Speicherknoten: **System → vSAN** zeigt alle neuen Laufwerke mit korrekten Ebenenzuweisungen * [ ] Für Scale-out-/Speicherknoten: vSAN-Ebenen kehren zurück zu **grün** (fehlerfreiem) Status nach Abschluss des Wiederaufbaus * [ ] Core-Fabric-Konnektivität bestätigt: **Knotendiagnose → Fabric-Konfiguration** meldet `bestätigt: wahr` für alle Pfade * [ ] Keine Fehlerereignisse im Systemprotokoll im Zusammenhang mit dem neuen Knoten {% hint style="info" %} **VMware-Übergang** Kommen Sie von VMware? VergeOS verwendet einen USB-Installer, der das Core Fabric automatisch erkennt und sich mit Admin-Anmeldedaten authentifiziert — Controller-, Scale-out-, Nur-Speicher- und Nur-Rechen-Rollen sind alles Menüauswahlen, ohne einen hostbezogenen Vor-Konfigurationsschritt auf der VergeOS-Seite. {% endhint %} {% hint style="info" %} **Nutanix-Übergang** Kommen Sie von Nutanix? VergeOS hat kein CVM — der Speicherdienst ist ein integrierter OS-Daemon — und Scale-out-, Nur-Speicher- und Nur-Rechen-Rollen sind erstklassige Knotenrollen, ausgewählt über Installer-Option und Zielcluster; ein USB-Installer deckt alle drei ab. {% endhint %} ## Wesentliche Erkenntnisse | Konzept | Zusammenfassung | | ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- | | **Drei Knotentypen** | Scale-out (HCI), Nur-Speicher und Nur-Rechen — jeder mit einer spezifischen Rolle | | **Einzelner Installer** | Ein USB-Installationsmedium verarbeitet alle Knotentypen per Menüauswahl | | **Automatische Erkennung** | Knoten erkennen das System im Core Fabric automatisch | | **Vorherige Clustererstellung** | Speicher- und Rechen-Cluster müssen in der UI erstellt werden, bevor der erste Knoten dieses Typs hinzugefügt wird | | **Sequentielle Installation** | Fügen Sie Knoten innerhalb eines Clusters nacheinander hinzu, um sich überschneidende vSAN-Umverteilungs-/Wiederaufbauvorgänge zu vermeiden | | **Speicher vor Rechenleistung** | In UCI-Bereitstellungen fügen Sie Speicher-Knoten vor Rechenknoten hinzu | | **vSAN-Wiederaufbau** | Nachdem Sie Knoten hinzugefügt haben, die Speicher bereitstellen, warten Sie, bis die vSAN-Ebenen wieder grün sind, bevor Sie fortfahren | ## Nächste Schritte Nachdem Ihre Knoten hinzugefügt und verifiziert wurden, fahren Sie mit der Nachinstallationsverifizierung fort, um den allgemeinen Systemzustand zu bestätigen: [**Verifizierung nach der Installation →**](/learn-the-platform/de/modul-3-installation/04-post-install-verification.md) --- # 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/learn-the-platform/de/modul-3-installation/03-adding-nodes.md?ask=&goal= ``` `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.