> 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-update.md). # VergeOS-Version-Aktualisierungsleitfaden Dieser Leitfaden bietet Best Practices für das sichere Aktualisieren eines VergeOS-Systems auf eine neue Point-Release-Version. Er konzentriert sich auf Datensicherheit und Systemresilienz durch einen methodischen Ansatz. {% hint style="info" %} **Übersicht** Die Aktualisierung Ihres VergeOS-Systems erfordert sorgfältige Planung und Ausführung, um die Beeinträchtigung Ihrer Dienste so gering wie möglich zu halten. Dieser Leitfaden gliedert den Prozess in Hauptphasen: 1. **Vorbereitung** - Schritte, die vor Ihrem geplanten Wartungsfenster zu unternehmen sind 2. **Vorabprüfung vor dem Update** - Abschließende Prüfungen unmittelbar vor Beginn des Updates 3. **Ausführung des Updates** - Der Prozess der Installation des Updates 4. **Nachprüfung nach dem Update** - Sicherstellen, dass das Update 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 * Netzwerkkonnektivität für Update-Downloads * **Geschätzte Zeit:** 1–2 Stunden, abhängig von Clustergröße und Komplexität des Updates ## 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 ### Dokumentation und Planung * [ ] Aktualisieren Sie die Plattformdokumentation mit dem geplanten Wartungsfenster * [ ] Überprüfen Sie alle synergetischen Updates/Upgrades, die möglicherweise ausgeführt werden müssen * Vermeiden Sie das Kombinieren unnötiger Updates * [ ] Prüfen Sie die Versionshinweise der Release-Version und planen Sie eventuelle spezifische Auswirkungen ein * [ ] Dokumentieren Sie die aktuelle Systemkonfiguration als Referenz für ein Rollback * [ ] 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 * Auf jedem Knoten: Knoten-Diagnose -> Fabric-Konfiguration (alle Pfade auf allen Knoten sollten "confirmed:true" sein) * [ ] Wenn die Netzwerk-Redundanz in letzter Zeit nicht getestet wurde, planen Sie vor dem Update einen Test ein * [ ] Bestätigen Sie den IPMI-Zugriff auf alle Hosts über eine Methode, die im Notfall Konsolenzugriff ermöglicht ### Update-Staging 1. Navigieren Sie in VergeOS zu **System > Updates** 2. Klicken Sie **Nach Updates suchen** 3. Laden Sie das Update herunter (es beginnt erst, wenn "Install" angeklickt wird) 4. Notieren Sie die aktuelle Version und die Zielversion für die Dokumentation ## Vorabprüfung vor dem Update Führen Sie diese Prüfungen am Tag der geplanten Wartung vor Beginn des Updates durch: ### Überprüfung des aktuellen Zustands * [ ] Bestätigen Sie, dass die laufende Version die erwartete Version ist * [ ] Prüfen Sie die Protokolle auf aktuelle Fehler * Notieren Sie alle nicht kritischen Probleme * Abbrechen, wenn kritische Fehler gefunden werden * [ ] Überprüfen Sie, ob die Ressourcenverfügbarkeit den N+1-Anforderungen entspricht * Bestätigen Sie, dass die RAM-Auslastung es ermöglicht, Workloads mit einem offline geschalteten Knoten auszuführen * [ ] Überprüfen Sie, ob die System-Snapshots aktuell und verfügbar sind * Setzen Sie den aktuellsten Snapshot so, dass er einige Tage in der Zukunft abläuft, um die Aufbewahrung zu verlängern * [ ] Bestätigen Sie, dass das Multi-Site-Synchronisieren funktioniert und auf dem neuesten Stand ist * [ ] Überprüfen Sie, ob alle vSAN-Ebenen in einem gesunden Zustand sind (grüner Status) * [ ] Bestätigen Sie, dass keine Knoten einen Neustart ausstehen haben * [ ] Dokumentieren Sie die Leistungs-Baseline des Systems für den Vergleich nach dem Update ### Update-Verifizierung * [ ] Bestätigen Sie Ihr bereitgestelltes Update in **System > Updates** * [ ] Erneut nach Updates suchen * Wenn es ein weiteres Update gibt, sorgfältig prüfen, bevor Sie fortfahren * [ ] Stellen Sie ausreichend freien Speicherplatz für den Update-Prozess sicher * [ ] Bestätigen Sie, dass alle Knoten erreichbar und reaktionsfähig sind ## Ausführungsphase ### Installation des Updates Der eigentliche Update-Prozess: 1. Navigieren Sie zu **System > Updates** 2. Klicken Sie **Installieren** um den Update-Prozess zu beginnen 3. **Überwachen Sie Knoten 1** während er automatisch: * sich in den Wartungsmodus versetzt * neu startet und das Update anwendet * wieder in den Dienst zurückkehrt 4. **Beobachten Sie die nachfolgenden Knoten** während das System weiterhin Knoten aktualisiert und neu startet 5. **Überwachen Sie die Workloads** und die Systemressourcennutzung während des gesamten Prozesses 6. **Verfolgen Sie den Fortschritt** - jeder Knoten wird nacheinander aktualisiert, um die Dienstverfügbarkeit aufrechtzuerhalten {% hint style="success" %} **Update-Überwachung** Während des Update-Prozesses können Sie den Fortschritt im Bereich System > Updates überwachen. Jeder Knoten zeigt seinen aktuellen Status und den Fortschritt durch die Update-Stufen an. {% endhint %} {% hint style="warning" %} **Nicht unterbrechen** Schalten Sie Knoten nicht aus und unterbrechen Sie den Update-Prozess nicht, sobald er begonnen hat. Lassen Sie jeden Knoten seinen Update-Zyklus auf natürliche Weise abschließen. {% endhint %} ## Nachprüfung nach dem Update Nachdem das Update abgeschlossen ist, überprüfen Sie, ob das System ordnungsgemäß funktioniert: ### Versionsbestätigung * [ ] Bestätigen Sie die erwartete Version in **System > Updates** * Überprüfen Sie, ob die folgenden Pakete die erwartete Version haben: * **osm** (Open-Street-Maps-Daten) * **yb** (Verge.io-Cloud-Software-Stack) * **yb-help** (Integrierte Hilfe und Dokumentation) * **ybos** (Verge.io-Betriebssystem) ### Systemzustandsprüfungen * [ ] Bestätigen Sie die Kachel "Nodes Updated" in **System > Updates** ist grün und alle Knoten sind fertig * [ ] Stellen Sie sicher, dass alle vSAN-Tiers einen grünen Status anzeigen * [ ] Überprüfen Sie, dass alle Knoten den grünen Status "Running" anzeigen * Bestätigen Sie, dass keine Knoten ausstehende Neustarts haben * [ ] Testen/bestätigen Sie Gastsysteme wie in Ihren Erfolgskriterien erforderlich * [ ] Erstellen Sie einen manuellen Snapshot mit einer Aufbewahrung von mehreren Tagen * [ ] Überprüfen Sie die Protokolle auf neue oder unerwartete Ereignisse * [ ] Überprüfen Sie alle in Ihren Vorbereitungsschritten festgelegten Erfolgskriterien * [ ] Bestätigen Sie, dass die Systemleistung der Baseline entspricht oder sie übertrifft ### Funktionstests * [ ] Testen Sie kritische VM-Operationen (Starten, Stoppen, Migrieren) * [ ] Überprüfen Sie Netzwerkkonnektivität und Leistung * [ ] Bestätigen Sie, dass Sicherungs- und Snapshot-Operationen funktionieren * [ ] Testen Sie alle benutzerdefinierten Integrationen oder Automatisierungen ## Problembehebung ### Häufige Probleme **Update-Prozess bleibt auf einem Knoten hängen** * Prüfen Sie die Erreichbarkeit des Knotens über IPMI * Überprüfen Sie die Systemprotokolle auf Fehlermeldungen * Überprüfen Sie die Netzwerkkonnektivität zum hängengebliebenen Knoten * Kontaktieren Sie den Support, wenn der Knoten nicht reagiert **Versionsabweichung nach dem Update** * Gewähren Sie zusätzliche Zeit, damit sich alle Komponenten synchronisieren können * Prüfen Sie, ob Paketinstallationen fehlgeschlagen sind * Netzwerkkonnektivität zwischen den Knoten prüfen * Überprüfen Sie die Update-Protokolle auf spezifische Fehler **Leistungsverschlechterung nach dem Update** * Vergleichen Sie mit der Baseline vor dem Update * Prüfen Sie auf neue Ressourcenengpässe * Überprüfen Sie den Zustand und die Leistung der vSAN-Tiers * Überwachen Sie 24–48 Stunden lang, um eine neue Baseline zu etablieren **VMs starten nach dem Update nicht** * Prüfen Sie die Kompatibilität der VM-Konfiguration * Überprüfen Sie die Zugänglichkeit der Speicherebene * Überprüfen Sie VM-spezifische Protokolle auf Fehler * Testen Sie VM-Operationen einzeln ## 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 erneut fortzufahren. VergeOS-Updates sind so konzipiert, dass sie vorwärtskompatibel sind, und ein Rollback ist möglicherweise nicht immer möglich. {% endhint %} ### Wenn Probleme auftreten 1. **Dokumentieren Sie das Problem** gründlich mit Screenshots und Protokollen 2. **Isolieren Sie das Problem** - bestimmen Sie, ob es alle Knoten oder bestimmte Komponenten betrifft 3. **Support kontaktieren** bevor Sie irgendwelche Rollback-Verfahren versuchen 4. **Bewahren Sie den Systemzustand auf** für die Fehleranalyse 5. **Befolgen Sie die Support-Anweisungen** für Lösungs- oder Rollback-Verfahren ## Nächste Schritte Nach erfolgreichem Abschluss des Updates: * [ ] Aktualisieren Sie die Systemdokumentation mit den Informationen zur neuen Version * [ ] Planen Sie eine regelmäßige Überwachung, um die Stabilität sicherzustellen * [ ] Überprüfen Sie alle neuen Funktionen oder Änderungen, die im Update eingeführt wurden * [ ] Planen Sie zukünftige Updates anhand der Release-Zeitpläne * [ ] Aktualisieren Sie bei Bedarf die Verfahren für Backup und Disaster Recovery {% hint style="danger" %} **Notfallunterstützung** Sollten Sie Probleme mit Ihrem VergeOS-Software-Update haben, kontaktieren Sie bitte [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-update.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.