> 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-verge-install.md). # VergeOS-Installationshandbuch Dieser Leitfaden bietet standardisierte Verfahren und Best Practices für VergeOS-Ingenieure und -Administratoren, die eine Erstinstallation des Systems mithilfe der aktualisierten Installer-Oberfläche durchführen. {% hint style="info" %} **Übersicht** Die Installation Ihres VergeOS-Systems erfordert sorgfältige Planung und Ausführung, um eine erfolgreiche Bereitstellung sicherzustellen. Dieser Leitfaden gliedert den Prozess in Hauptphasen: 1. **Vorbereitung** - Schritte, die vor der Terminierung der Installation durchzuführen sind 2. **Vorinstallation** - Abschließende Prüfungen innerhalb von 24 Stunden vor der Installation 3. **Installation** - Der Prozess der Installation und Konfiguration des Systems 4. **Nach der Installation** - Bestätigung, dass die Installation 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. Schaffen Sie zusätzlichen Platz, um die Anzahl der Knoten, Netzwerkkonfigurationen und andere Anforderungen zu berücksichtigen. {% endhint %} ## Voraussetzungen * Physischer Zugriff auf die Hardwareknoten für die Installation * Netzwerkinfrastruktur konfiguriert und betriebsbereit * IPMI-/Remote-Management-Zugriff auf alle Knoten * VergeOS-Lizenzzugangsdaten * **Geschätzte Zeit:** 4–8 Stunden, abhängig von der Komplexität der Konfiguration ## Ziel Abschluss der Erstinstallation von Node1 und Node2+, dem Minimum, das für Systemredundanz und Unterstützung des Produktivsystems erforderlich ist. ## Vorbereitungsphase Führen Sie diese Schritte vor der Terminierung der Installation aus: ### Hardwareanforderungen * [ ] Bestätigen Sie, dass die Hardware die Mindestanforderungen erfüllt {% hint style="info" %} **Hardware-Dokumentation** Lesen Sie die [VergeOS-Größenbestimmungsdokumentation](/plan-and-deploy/de/implementierungsleitfaden/sizing.md) für aktuelle und detaillierte Anforderungen. \[ ] **CPU-Anforderungen:** * [ ] 64-Bit-CPU mit Unterstützung für Hardwarevirtualisierung \[ ] **Speicheranforderungen:** * [ ] 16 GB RAM pro vSAN-Knoten für das Betriebssystem verfügbar * [ ] +1 GB RAM pro 1 TB rohem vSAN-Speicher; z. B. 16 GB+4 GB = 20 GB RAM/Knoten für einen Knoten mit 4 TB rohem vSAN-Speicher \[ ] **IPMI/Remote-Management:** * [ ] IPMI; iDRAC, iLO oder ähnlich \[ ] **Festplattencontroller:** * [ ] HBA-Festplattencontroller (bevorzugt) * [ ] bei RAID-Controller: sicherstellen, dass JBOD-/IT-Modus unterstützt wird * [ ] Stellen Sie sicher, dass der Controller das Booten von NVMe unterstützt, wenn diese verwendet werden \[ ] **Netzwerkanforderungen:** * [ ] 1x physische Netzwerkschnittstelle/Knoten für die VergeOS-UI/'Externe'-Schnittstelle * [ ] Zweites gebondetes Paar desselben Typs *Sehr* Empfohlen für Redundanz * [ ] 1x 10-Gbps- oder schnellere Netzwerkschnittstelle/Knoten für das VergeOS-Kernnetzwerk-Fabric * [ ] Zweiter desselben Typs *Sehr* Empfohlen für Redundanz (nicht gebondet) \[ ] **Speicheranforderungen:** * [ ] Tier-0-Speicher (optional, empfohlen) * [ ] NVMe-basiert * [ ] Hohe Schreibausdauer (3+ Drive Writes Per Day (DWPD) empfohlen) * [ ] 5 GB/1 TB nutzbarer Festplatte in vSAN (10 GB/1 TB empfohlen) * [ ] Speicher-Tiers (1 erforderlich, > optional) * [ ] Mindestens ein per PCIe angebundener NVMe-Speicher-Tier *Sehr empfohlen* * [ ] Leistungsfähig entsprechend der Workload-Erwartung * [ ] Festplattenverschlüsselung im Ruhezustand * [ ] USB-Festplatte/Knoten für den vSAN-Entschlüsselungsschlüssel (falls gewünscht) {% endhint %} ### Installationsmedien und Dokumentation * [ ] Erstellen Sie Installationsmedien gemäß [der VergeOS-Dokumentation](/plan-and-deploy/de/implementierungsleitfaden/install-media.md) * [ ] Testen Sie das Bootmedium, um die Funktionalität zu verifizieren * [ ] Dokumentieren und erstellen Sie alle Netzwerkanforderungen {% hint style="info" %} **Netzwerkdokumentation** Lesen Sie die [VergeOS-Dokumentation zum Netzwerkdesign](/plan-and-deploy/de/implementierungsleitfaden/network-design.md) für aktuelle und detaillierte Netzwerkanforderungen. \[ ] **Kernnetzwerk-Konfiguration:** * [ ] Kernnetzwerk-VLAN1 erstellt und dokumentiert * [ ] Kernnetzwerk-VLAN2 erstellt und dokumentiert \[ ] **Externe Netzwerk-Konfiguration:** * [ ] Externes Netzwerk-VLAN1 erstellt und dokumentiert * [ ] Externes Netzwerk-VLAN2 erstellt und dokumentiert \[ ] **IP-Konfiguration:** * [ ] UI-/Management-IP-Adresse zugewiesen und dokumentiert * [ ] Gateway-Konfiguration dokumentiert * [ ] DNS-Server identifiziert und dokumentiert \[ ] **Dokumentation zum Netzwerkdesign/-aufbau** * [ ] A-B-Kabelplan erstellt und dokumentiert * [ ] Rack-Elevation dokumentiert * [ ] Dokument/Zeichnung zum Layer-2-Netzwerkdesign erstellt * [ ] Dokument/Zeichnung zum Layer-3-Netzwerkdesign erstellt {% endhint %} ### Systemzugriff und Konfiguration * [ ] IPMI-Zugriff auf alle Knoten verifizieren * [ ] Anforderungen an BIOS-Einstellungen überprüfen * [ ] Korrekte Boot-Methode ausgewählt (Legacy/Dual/UEFI) ***UEFI erforderlich, wenn alle Laufwerke NVMe sind*** * [ ] Hardware-unterstützte Virtualisierung aktiviert * [ ] Hyperthreading aktiviert * [ ] Alle Prozessorkerne aktiviert * [ ] Uhren korrekt eingestellt (alle Knoten innerhalb von Sekunden) ### Planungsentscheidungen * [ ] Den hier beschriebenen gesamten Ablauf überprüfen * [ ] Die zur Durchführung des gesamten Prozesses erforderlichen Informationen vorbereiten * [ ] RAM-Reservierungspräferenz festlegen: Mehr *nutzbarer Speicher* **ODER** Mehr *Durchsetzung von N+1-HA* * [ ] Installationszeitplan und Kommunikation an die Stakeholder planen ## Vorinstallationsphase Führen Sie diese Prüfungen innerhalb von 24 Stunden vor der geplanten Installation durch: ### Überprüfung des aktuellen Zustands * [ ] Aktuellen Zustand überprüfen * [ ] Alle Hardware physisch installiert und eingeschaltet * [ ] Alle Netzwerkkabel bestehen einen „Zugtest“ * [ ] Switch-Konfigurationen abgeschlossen und getestet * [ ] Aktuelle laufende Netzwerkkonfiguration geprüft und ein „write mem“ ausgeführt * [ ] IPMI auf allen Knoten erreichbar * [ ] Erforderliche IPs sind verfügbar und frei * [ ] Jumbo-Frames (MTU 9216+) auf den Switches konfiguriert ### Abschließende Hardwareprüfung * [ ] Alle Laufwerke werden im BIOS angezeigt * [ ] Alle NICs werden im BIOS angezeigt * [ ] MACs mit den Aufzeichnungen abgleichen * [ ] Uhrzeit und Datum im BIOS korrekt * [ ] Virtualisierungseinstellungen aktiviert ### Abschließende Netzwerkprüfung * [ ] Kernnetzwerk-Switches antworten * [ ] Externe Netzwerk-Switches antworten * [ ] Keine konfliktierenden DHCP-Server (falls DHCP verwendet wird) * [ ] Dokumentation zur Fehlerbehebung verfügbar ## Ausführungsphase ### Installation des primären Controllers Der eigentliche Installationsprozess gemäß der Installationsreihenfolge: * [ ] Vom USB-Installationsmedium booten * [ ] „Standard Install“ auswählen * [ ] „Controller“ auswählen * [ ] „New Install“ auswählen ### Systemkonfiguration **NTP-Konfiguration:** * [ ] Durch Leerzeichen getrennte Liste von NTP-Servern eingeben oder den Standardwert beibehalten **Datum-/Uhrzeit-Konfiguration:** * [ ] Das aktuelle Datum sorgfältig bestätigen * [ ] Die aktuelle Uhrzeit sehr sorgfältig bestätigen (Knoten 1 steuert NTP für das System) **Systemidentifikation:** * [ ] Geben Sie den Namen Ihres Systems ein. (Dieser kann nach der Installation geändert werden) ### Konfiguration des Administratorkontos * [ ] Geben Sie Ihren Administrator-Benutzernamen ein oder lassen Sie den Standardwert * [ ] Geben Sie das Passwort für Ihr Administratorkonto ein (es sollte generiert und sicher in Ihrem Passwort-Repository gespeichert werden) * [ ] Legen Sie die E-Mail-Adresse des Administratorkontos fest (optional, aber empfohlen) ### Konfiguration der Netzwerkschnittstelle **Kernnetzwerk-Schnittstellen:** * [ ] Kernnetzwerk-Schnittstelle Core1 auswählen * [ ] Schnittstellenname, MTU, Core (auf „Yes“ belassen) und VLAN für Core1 wie erforderlich konfigurieren * [ ] Kernnetzwerk-Schnittstelle Core2 auswählen * [ ] Schnittstellenname, MTU, Core (auf „Yes“ belassen) und VLAN für Core2 wie erforderlich konfigurieren **Externe Netzwerkschnittstelle:** * [ ] Externe Netzwerkschnittstelle auswählen * [ ] Externe Netzwerknamen, MTU (in der Regel 1500), Core (auf „No“ ändern) konfigurieren. * [ ] Externes VLAN konfigurieren (falls erforderlich) * [ ] Externen IP-Wert festlegen (CIDR-Format) * [ ] Externes Gateway festlegen * [ ] Externe DNS-Server festlegen ### Lizenzkonfiguration * [ ] Lizenzserver auswählen (Produktion oder Test/NFR) * [ ] Lizenz-Benutzerzugangsdaten eingeben * [ ] Lizenzpasswort eingeben (sicher im Passwort-Repository speichern) ### Speicherkonfiguration **vSAN-Verschlüsselung:** * [ ] vSAN-Verschlüsselungseinstellung wählen (Ja/Nein) * [ ] Verschlüsselungsschlüssel dokumentieren, falls aktiviert (sicher im Passwort-Repository speichern) * [ ] USB-Verschlüsselungsdatenträger erstellen (sehr empfohlen bei Verwendung von vSAN-Verschlüsselung) **vSAN-Laufwerksauswahl und Tier-Zuweisung:** * [ ] vSAN-Laufwerke für die Installation auswählen * [ ] Laufwerke den entsprechenden Speichertiers zuweisen (wie während der Installationsvorbereitung geplant) **Swap-Konfiguration:** * [ ] Swap-Zuweisung nach Bedarf konfigurieren * [ ] Nachdem der Installer fertig ist, entfernen Sie das USB-Medium * [ ] Neustart ### Überprüfung des primären Knotens * [ ] System bootet an der Konsole zum „blauen“ Bildschirm * [ ] UI unter der konfigurierten IP-Adresse erreichbar * [ ] Alle Statusanzeigen in der UI grün * [ ] vSAN eingehängt und fehlerfrei ## Installation des sekundären Controllers * [ ] Sekundären Knoten vom USB-Installationsmedium booten * [ ] „Controller“ auswählen * [ ] „No“ für Neuinstallation auswählen * [ ] Administrator-Zugangsdaten vom primären Controller eingeben * [ ] Automatische Netzwerkerkennung bestätigen (STOPPEN, wenn eine erkannte IP oder Schnittstelle nicht den Erwartungen entspricht!) * [ ] Verschlüsselungseinstellungen vom primären System übernehmen * [ ] Laufwerks-Tier-Zuweisungen vom primären System übernehmen ### Überprüfung des sekundären Knotens * [ ] System bootet an der Konsole zum „blauen“ Bildschirm * [ ] Node2 in der primären UI sichtbar * [ ] Alle Statusanzeigen grün * [ ] vSAN-Status auf beiden Knoten grün ## Überprüfung nach der Installation Nachdem die Installation abgeschlossen ist, verifizieren Sie, dass das System korrekt funktioniert: ### Systemzustandsprüfungen * [ ] Alle Dashboard-Anzeigen grün * [ ] Keine unerwarteten Warnungen oder Hinweise in den Dashboard-Logs * [ ] Alle Knoten zeigen die korrekte Version * [ ] Alle Knoten im Status „Running“ (jeden einzelnen Knoten prüfen) * [ ] Keine ausstehenden Neustarts von Knoten * [ ] vSAN-Gesundheit auf allen Tiers grün * [ ] Konnektivität des Core-Fabric verifiziert * [ ] Konnektivität des externen Netzwerks verifiziert ### Validierung der Systemkonfiguration * [ ] Standard-VM-Speicher-Tier festgelegt * [ ] Maximaler RAM-Prozentsatz des Cluster-Ziels konfiguriert * [ ] Site-Synchronisationen konfiguriert (falls erforderlich) * [ ] System aktiviert und auf dem aktuellen Stand * [ ] SMTP-Server eingerichtet (sehr empfohlen) * [ ] E-Mail-Benachrichtigungen für Administratoren konfiguriert ### Abschließende Tests * [ ] VM-Erstellung und grundlegende Vorgänge testen * [ ] Netzwerkkonnektivität von der Test-VM aus überprüfen * [ ] Snapshot-Funktionalität bestätigen * [ ] System-Backup/Wiederherstellung testen, falls zutreffend ## Problembehebung ### Häufige Probleme **Boot-Probleme:** * Prüfen, ob die BIOS-Boot-Einstellungen dem Typ des Installationsmediums entsprechen * USB-Medienfunktionalität auf einem bekanntermaßen funktionierenden System prüfen * Hardwarekompatibilität mit VergeOS bestätigen **Probleme bei der Netzwerkkonfiguration:** * Prüfen, ob die VLAN-Konfigurationen dem Netzwerkdesign entsprechen * Physische Kabelverbindungen und Switch-Konfigurationen prüfen * Sicherstellen, dass die IP-Adressierung keinen Konflikt mit der vorhandenen Infrastruktur verursacht **Probleme bei der Speicherkonfiguration:** * Prüfen, ob sich der Festplattencontroller im JBOD-/IT-Modus befindet * Laufwerkssichtbarkeit im BIOS prüfen * Bestätigen, dass die Speicher-Tier-Zuweisungen mit der Planungsdokumentation übereinstimmen **Probleme beim Beitritt des sekundären Knotens:** * Netzwerkkonnektivität zwischen den Knoten prüfen * Prüfen, ob die Administrator-Zugangsdaten korrekt sind * Bestätigen, dass der primäre Knoten vollständig betriebsbereit ist, bevor der sekundäre hinzugefügt wird ## Nächste Schritte Nach erfolgreichem Abschluss der Installation: * [ ] Erstes Systembackup planen * [ ] Überwachung und Alarmierung konfigurieren * [ ] Netzwerkdokumentation mit der endgültigen Konfiguration aktualisieren * [ ] Planen Sie die Erstellung von Mandanten und die Ressourcenzuweisung * [ ] Bei Bedarf Administratorenschulung planen * [ ] Endgültige Systemkonfiguration für das Betriebsteam dokumentieren {% hint style="danger" %} **Notfallunterstützung** Sollten Sie Probleme mit Ihrer VergeOS-Installation 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-verge-install.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.