Controller-Installation

Schritt-für-Schritt-Durchgang zur Installation des primären Controllers (Knoten 1) und des sekundären Controllers (Knoten 2), um ein redundantes VergeOS-System zu bilden.

Die Installation der beiden Controller-Knoten ist der Kern jeder VergeOS-Bereitstellung. Knoten 1 initialisiert ein brandneues System -- dabei werden der Systemname, das Administratorkonto, das Netzwerk, die Lizenzierung, die Verschlüsselung und die Speicher-Tiers festgelegt. Knoten 2 tritt dem vorhandenen System bei und spiegelt diese Einstellungen, wodurch Sie sofort einen redundanten Cluster erhalten. Diese Seite führt Sie detailliert durch beide Installationen.

Übersicht des Installationsablaufs

---

Knoten 1: Installation des primären Controllers

Knoten 1 erstellt das VergeOS-System. Jede Konfigurationsentscheidung, die Sie hier treffen, bildet die Basis, der Knoten 2 und alle nachfolgenden Knoten folgen werden.

Destruktiver Vorgang

VergeOS wird auf jedem Knoten als vollständiges Betriebssystem installiert. Die ausgewählten Laufwerke werden formatiert und alle vorhandenen Daten auf diesen Laufwerken gehen verloren. Überprüfen Sie die Laufwerksauswahl vor dem Bestätigen sorgfältig.

Phase 1: Start und Installationstyp

1. Von USB booten -- Legen Sie das VergeOS-Installationsmedium ein und booten Sie den Server. Der vollständige Installer wird in den Arbeitsspeicher geladen; die Ladezeit hängt von der Geschwindigkeit des Mediums ab.
2. Wählen Sie "Install (Standard)" -- Dies ist die Standardeinstellung. Nicht standardmäßige Optionen sollten nur in direkter Zusammenarbeit mit dem VergeOS-Support verwendet werden.
3. Wählen Sie "Controller" -- Die ersten beiden Knoten in jedem System müssen Controller-Knoten sein.
4. Wählen Sie "Ja" um zu bestätigen, dass dies eine Neuinstallation (neues vSAN) ist.

Phase 2: Zeit und Identität

1. Zeitzone -- Wählen Sie die Zeitzone des Systems aus (den geografischen Standort der Server).
2. NTP-Konfiguration -- Geben Sie eine durch Leerzeichen getrennte Liste von NTP-Servern ein (z. B. pool.ntp.org time.google.com), oder übernehmen Sie die Standardwerte.
3. Datum und Uhrzeit -- Bestätigen Sie das aktuelle Datum und die aktuelle Uhrzeit sorgfältig. Knoten 1 steuert nach der Installation NTP für das gesamte System, daher ist die Genauigkeit hier entscheidend.

   Zeit ist wichtig: Ein falsches Datum oder eine falsche Uhrzeit kann zu vSAN-Betriebsproblemen führen. Überprüfen Sie beides sorgfältig -- insbesondere das Datum, das leicht übersehen wird.

4. Systemname -- Geben Sie einen aussagekräftigen Namen für Ihr VergeOS-System ein (z. B. "Produktions-HCI-Cluster"). Dieser Name erscheint im Dashboard, in Warnmeldungen, Berichten und Site-Sync-Konfigurationen. Er kann nach der Installation in den Systemeinstellungen geändert werden.

Phase 3: Admin-Konto

1. Administrator-Benutzername -- Übernehmen Sie die Standardeinstellung (admin) oder geben Sie einen benutzerdefinierten Benutzernamen ein.
2. Passwort -- Geben Sie ein starkes Passwort ein (mindestens 8 Zeichen). Speichern Sie es sofort in Ihrem Passwort-Repository.
3. E-Mail-Adresse -- Geben Sie die Admin-E-Mail-Adresse ein. Diese wird für Passwortzurücksetzungen und den Empfang von Abonnementwarnungen verwendet. Während der Installation ist eine E-Mail-Adresse erforderlich.

Phase 4: Konfiguration der Netzwerkschnittstellen

Hier zahlt sich Ihre Dokumentation der NICs vor der Installation aus. Sie konfigurieren jede erkannte NIC auf dem Knoten.

Core-Netzwerkschnittstellen

1. Core1-NIC auswählen -- Wählen Sie die physische NIC aus, die mit Ihrem Core-Fabric-1-Switch verbunden ist.
2. Core1-Einstellungen konfigurieren:

   • Namen -- Ein aussagekräftiger Name (z. B. der Hostname des Switches oder Ihre Namenskonvention)
   • MTU -- Standard ist 9192 auf der NIC; die MTU des physischen Switch-Ports muss mindestens 9216 betragen, um die NIC-MTU plus VXLAN-Overhead aufzunehmen
   • Core -- Belassen Sie es auf "Ja"
   • VLAN -- Geben Sie die VLAN-ID für Core1 ein, oder lassen Sie das Feld leer/0 für PVID-Ports (untagged)
3. Core2-NIC auswählen -- Wählen Sie die physische NIC aus, die mit Ihrem Core-Fabric-2-Switch verbunden ist.
4. Core2-Einstellungen konfigurieren -- Dasselbe Muster wie bei Core1, aber mit der VLAN-ID von Core2.

Tastaturnavigation

Im Installer, [Tab] wechselt zwischen Aktionspunkten (Fertigstellen/Bearbeiten/Abbrechen), nicht zwischen Feldern. Drücken Sie [Enter] um den Bearbeitungsmodus für ein Feld umzuschalten. Wenn der Bearbeitungsmodus AUS ist, verwenden Sie die Pfeiltasten, um zwischen den Feldern zu wechseln.

Externe Netzwerkschnittstelle

1. Externe NIC(s) auswählen -- Wählen Sie die NIC(s), die mit Ihrem externen/Management-Switch verbunden sind. Port-Bonding (LACP) wird hier zur Redundanz unterstützt.
2. Externe Einstellungen konfigurieren:

   • Namen -- Aussagekräftiger Name für das externe Netzwerk
   • MTU -- Typischerweise 1500 (Standard-Ethernet)
   • Core -- Ändern in "Nein"
   • VLAN -- Geben Sie gegebenenfalls die Management-VLAN-ID ein (PVID bevorzugt)
   • IP-Adresse -- Statische Adresse im CIDR-Format (z. B., 10.0.0.2/24), oder geben Sie dhcp für DHCP ein (geeignet für Test-/Evaluierungs- oder reine Speichersysteme)
   • Gateway -- IP-Adresse des Standard-Gateways
   • DNS -- DNS-Server-Adressen
3. Übrige NICs konfigurieren -- Nicht genutzte oder abgesteckte NICs sollten während der Installation trotzdem einen Namen erhalten (z. B. "unused"). Wählen Sie [Fertig] wenn alle NICs konfiguriert sind.

Port-Bonding (LAG/LACP) sollte nicht für Core-Fabric-Netzwerke verwendet werden. VergeOS erreicht Redundanz über mehrere separate Core-Netzwerke auf separaten Switches. Bonding ist nur für externe Netzwerkschnittstellen geeignet.

Phase 5: Lizenzkonfiguration

1. Lizenzserver auswählen -- Wählen Sie zwischen einem Produktions- oder Test-/NFR-Server.
2. Zugangsdaten eingeben -- Geben Sie den Lizenz-Benutzernamen und das Passwort aus Ihrem VergeOS-Kontoteam an. Bewahren Sie diese sicher auf.

Phase 6: Speicherkonfiguration

vSAN-Verschlüsselung

1. Verschlüsselung aktivieren oder deaktivieren -- VergeOS unterstützt AES-256-Verschlüsselung im Ruhezustand für das vSAN.

   • Wenn Sie sie aktivieren, geben Sie eine Passphrase für den Verschlüsselungsschlüssel ein (8--64 Zeichen)
   • Speichern Sie den Verschlüsselungsschlüssel optional auf einem USB-Laufwerk (für den Produktiveinsatz sehr empfohlen)
   • Vergewissern Sie sich vor dem Bestätigen, dass das richtige USB-Gerät ausgewählt ist

Verschlüsselung ist dauerhaft

Die Auswahl der Verschlüsselung ist nicht umkehrbar nach der Installation. Der Wechsel von verschlüsselt zu unverschlüsselt (oder umgekehrt) erfordert eine vollständige Neuinstallation des Systems. Treffen Sie diese Entscheidung sorgfältig.

Laufwerkauswahl und Tier-Zuordnung

1. vSAN-Laufwerke auswählen -- Alle erkannten Laufwerke werden standardmäßig angezeigt und ausgewählt (mit einem Sternchen markiert). Heben Sie die Auswahl für alle Laufwerke auf, die ausgeschlossen werden sollen:

   • Wechselmedien (USB-Laufwerke)
   • Laufwerke, die ausschließlich zum Speichern eines Verschlüsselungsschlüssels dienen
   • Jedes Laufwerk, das nicht für die vSAN-Nutzung vorgesehen ist
2. Speicher-Tiers zuweisen -- Der Installer erkennt für jedes Laufwerk automatisch einen Tier. Wählen Sie "Ja" um die Tier-Zuordnungen zu prüfen und optional zu ändern:

   • Tier 0 -- Metadatenspeicher (NVMe, hohe Schreibausdauer empfohlen; planen Sie etwa 5 GB Minimum / 10 GB empfohlen pro 1 TB nutzbarem vSAN)
   • Tier 1 -- Hochleistungs-Workloads mit vielen Schreibzugriffen (NVMe mit hoher Ausdauer)
   • Tier 2 -- Gemischte Workloads, allgemeine VMs (SSD der Mittelklasse)
   • Tier 3 -- Schnelles HDD oder Hybridlaufwerk (konventionell; nicht zwingend erforderlich)
   • Tier 4 -- Standard-HDD / Kapazität (konventionell; nicht zwingend erforderlich)
   • Tier 5 -- Archiv / Kaltlagerung (Archiv-HDD)

Wählen Sie [Fertig] wenn die Tier-Zuordnungen korrekt sind.

Tier 0 ist nur für Metadaten

Tier 0 speichert die vSAN-Hashmap und den Dateisystemindex. Es ist kein Performance-Cache und speichert keine Workload-Daten. NVMe-Laufwerke mit hoher Schreibausdauer (3+ DWPD) werden empfohlen.

Swap-Konfiguration

1. Swap-Tier auswählen -- Wählen Sie den Speicher-Tier für den Swap-Speicher. Vermeiden Sie nach Möglichkeit Tier-0-Laufwerke; wählen Sie den nächstschnelleren Tier. Wählen Sie niemals HDD-Laufwerke für Swap aus, es sei denn, der Knoten enthält nur HDDs.
2. Swap pro Laufwerk eingeben -- Geben Sie den Swap in MB pro Laufwerk an (z. B., 2048 bei 8 Laufwerken = 16 GB insgesamt). Im Allgemeinen sollten nicht mehr als 16 GB Swap pro Knoten konfiguriert werden.
3. Bestätigen Sie die Swap-Zusammenfassung und wählen Sie "Ja".

Phase 7: Abschluss und Neustart

1. Der Installer formatiert jedes ausgewählte Laufwerk (große Laufwerke können mehrere Minuten dauern) und initialisiert das vSAN.
2. Wenn die Installation abgeschlossen ist, entfernen Sie das USB-Medium und drücken Sie [Enter] zum Neustart.

Überprüfung von Knoten 1

Überprüfen Sie nach dem Neustart, ob der primäre Controller fehlerfrei ist, bevor Sie mit Knoten 2 fortfahren:

Prüfen Sie	Erwartetes Ergebnis
Konsolenbildschirm	Das blaue VergeOS-Benutzermenü erscheint
UI-Zugriff	Navigieren Sie in einem Browser zur konfigurierten IP-Adresse; melden Sie sich mit den Admin-Zugangsdaten an
Statusanzeigen	Alle Anzeigen im Haupt-Dashboard grün
vSAN-Status	vSAN eingehängt und fehlerfrei (im Dashboard angezeigt)

Wenn der Knoten nicht korrekt bootet, drücken Sie Esc an der Konsole, um eine Eingabeaufforderung zu erhalten. Geben Sie yb-install ein, um fortzufahren, oder yb-install --restart um die Installation neu zu starten.

---

Knoten 2: Installation des sekundären Controllers

Knoten 2 tritt dem von Knoten 1 erstellten System bei. Der Installer erkennt die meisten Netzwerkkonfigurationen automatisch, wodurch dieser Prozess schneller ist als bei Knoten 1.

Der primäre Controller (Knoten 1) muss vollständig installiert und gebootet sein bevor Sie mit der Installation von Knoten 2 beginnen. Beginnen Sie mit Knoten 2 erst, wenn Sie überprüft haben, dass Knoten 1 fehlerfrei ist.

Installationsschritte

1. Von USB booten -- Legen Sie das VergeOS-Installationsmedium in den zweiten Server ein und booten Sie.
2. Wählen Sie "Standardinstallation" (Standard).
3. Wählen Sie "Controller" (Standard).
4. Wählen Sie "Nein" -- Dies ist KEINE Neuinstallation. Sie treten dem bereits auf Knoten 1 erstellten System bei.

   Achtung: Wenn Sie hier "Ja" auswählen, erstellt der Installer ein separates, unabhängiges System anstatt dem Cluster von Knoten 1 beizutreten. Dies ist der häufigste Installationsfehler bei Knoten 2.

5. Admin-Anmeldedaten eingeben -- Geben Sie den Administrator-Benutzernamen und das Passwort an, die während der Installation von Knoten 1 erstellt wurden.
6. Automatische Netzwerkerkennung -- Wählen Sie "Ja" um die Netzwerkkonfiguration automatisch zu erkennen. Der Installer erkennt beide Core-Netzwerke von Knoten 1. Dies ist der empfohlene Ansatz, da er eine manuelle Fehlkonfiguration des Netzwerks vermeidet.
7. Erkannte Netzwerke überprüfen -- Prüfen Sie für jedes erkannte Core-Netzwerk die angezeigte Konfiguration und drücken Sie [Enter] zum Bestätigen.
8. Verschlüsselung konfigurieren -- Verschlüsselungseinstellungen müssen mit Knoten 1 übereinstimmen. Wenn Knoten 1 Verschlüsselung verwendet, muss Knoten 2 ebenfalls Verschlüsselung mit derselben Passphrase verwenden.
9. vSAN-Laufwerke auswählen und Tiers zuweisen -- Laufwerks- und Tier-Auswahlen sollten dem auf Knoten 1 festgelegten Muster entsprechen (gleiche Tier-Zuordnungen für gleichwertige Laufwerkstypen).
10. Swap konfigurieren -- Stimmen Sie die Swap-Konfiguration mit Knoten 1 ab.
11. Wenn der Installer fertig ist, entfernen Sie das USB-Medium und drücken Sie [Enter] zum Neustart.

Überprüfung von Knoten 2

Prüfen Sie	Erwartetes Ergebnis
Konsolenbildschirm	Das blaue VergeOS-Benutzermenü erscheint
UI-Anmeldung	Greifen Sie auf dieselbe IP-Adresse wie bei Knoten 1 zu; beide Knoten sind im Dashboard sichtbar
Knotenstatus	Beide Knoten zeigen im Knoten-Dashboard einen fehlerfreien (grünen) Status
vSAN-Redundanz	vSAN zeigt einen redundanten Status (N+1), wobei beide Knoten Speicher bereitstellen

---

N+2-Redundanz (optional dritter Controller)

Zwei Controller-Knoten bieten standardmäßig N+1-Redundanz -- zwei Kopien jedes Datenblocks. Für Umgebungen mit höherem Ausfallschutz unterstützt VergeOS auch N+2-Redundanz mit drei Controller-Knoten, wobei drei Kopien jedes Datenblocks vorgehalten werden.

Zur Konfiguration von N+2:

1. Installieren Sie einen dritten Controller-Knoten nach demselben Knoten-2-Prozess (bestehendem System beitreten).
2. Während der Installation des dritten Controllers warnt der Installer, dass das System auf N+2-Redundanz umschaltet (3 Kopien der Daten, ~33 % nutzbarer Speicher) und verlangt, dass Sie N+2 zum Bestätigen.
3. Nachdem alle drei Controller-Knoten installiert sind, starten Sie alle drei Knoten neu um die N+2-Redundanz zu aktivieren.
4. Das Hinzufügen eines dritten Controller-Knotens zur Erreichung von N+2-Redundanz sollte in Abstimmung mit dem VergeOS-Support erfolgen.

Der Wechsel zwischen N+1 und N+2 auf einem bestehenden System erfordert einen vollständigen Daten-Rebalancing-Prozess, der erhebliche Ausfallzeiten, insbesondere auf Systemen mit großen Datenmengen, umfassen kann. Diese Änderung sollte nur in Abstimmung mit dem VergeOS-Support durchgeführt werden.

---

Zusammenfassung der Installationsentscheidungen

Nicht umkehrbare Entscheidungen

Verschlüsselung (Ja/Nein) kann nach der Installation ohne vollständige Neuinstallation nicht geändert werden. Entscheiden Sie vor dem Start.

Nach der Installation änderbar

Systemname, Admin-Zugangsdaten, E-Mail, Swap-Konfiguration und Netzwerknamen können nach der Installation alle über die UI geändert werden.

Muss auf allen Knoten übereinstimmen

Die Verschlüsselungseinstellungen und Muster der Tier-Zuordnung müssen zwischen Knoten 1 und Knoten 2 (und allen nachfolgenden Controller-Knoten) konsistent sein.

Problembehandlung

Drücken Sie Esc für eine Eingabeaufforderung. Verwenden Sie yb-install ein, um fortzufahren, oder yb-install --restart um die Installation neu zu starten.

---

Schnellreferenz: Installer-Navigation

Schritt	Auswahl für Knoten 1	Auswahl für Knoten 2
Installationstyp	Standardinstallation	Standardinstallation
Rolle	Controller	Controller
Neue Installation?	Ja (neues vSAN)	Nein (bestehendem beitreten)
Zeitzone / NTP	Manuell konfigurieren	Nicht abgefragt (von Knoten 1 übernommen)
Systemname	Namen eingeben	Nicht abgefragt (von Knoten 1 übernommen)
Admin-Konto	Neu erstellen	Vorhandene Zugangsdaten eingeben
Netzwerkkonfiguration	Manuell pro NIC	Automatische Erkennung empfohlen
Lizenz	Zugangsdaten eingeben	Nicht abgefragt (von Knoten 1 übernommen)
Verschlüsselung	Ja/Nein wählen	Muss mit Knoten 1 übereinstimmen
Laufwerks-/Tier-Auswahl	Vollständige Auswahl	Muss dem Muster von Knoten 1 entsprechen
Swap	Konfigurieren Sie	Konfigurieren (mit Knoten 1 abstimmen)

Nächste Schritte

Wenn beide Controller-Knoten installiert und überprüft sind, können Sie fortfahren, zusätzliche Kapazität hinzuzufügen:

• Knoten hinzufügen → -- Installation von Scale-out-, rein Compute- und rein Speicher-Knoten
• Verifizierung nach der Installation → -- Vollständige System-Gesundheitsprüfungen und Konfigurationsaufgaben