> 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/knowledge-base/de/system-administration/proper-vergeos-system-shutdown-procedure.md). # Korrektes Verfahren zum Herunterfahren des VergeOS-Systems ## Überblick Dieses Dokument beschreibt die Schritt-für-Schritt-Vorgehensweise zum ordnungsgemäßen Herunterfahren eines VergeOS-Systems. Die Einhaltung der korrekten Herunterfahrreihenfolge ist entscheidend, um die Datenintegrität sicherzustellen, Beschädigungen zu verhindern und den Zustand Ihrer VergeOS-Umgebung zu erhalten. ## Voraussetzungen * Administrativer Zugriff auf die VergeOS-Benutzeroberfläche * Verständnis Ihrer Cluster-Topologie * Identifizierung aller laufenden Workloads und Mandanten * Kenntnis der Standorte der Controller-Knoten (Node1 & Node2) ## Herunterfahrreihenfolge ### Schritt 1: Laufende Workloads erfassen Bevor Sie mit dem Herunterfahren beginnen, müssen Sie alle aktiven Workloads in Ihrer Umgebung identifizieren. 1. Navigieren Sie auf jedem **Node Dashboard** in Ihrem Cluster 2. Prüfen Sie die **Laufende Maschinen** Abschnitt auf jedem Knoten 3. Dokumentieren Sie alle laufenden Workloads, einschließlich: * Virtuelle Maschinen (VMs) * Mandantenknoten * VMware-Backup-Dienste * NAS-Dienste * Alle anderen aktiven Dienste ### Schritt 2: Mandanten-Workloads herunterfahren Wenn auf einem oder mehreren Knoten in Ihrem Cluster Mandanten ausgeführt werden: 1. **Melden Sie sich bei jeder Mandantenumgebung an** die aktive Workloads hat 2. **Fahren Sie alle laufenden Workloads ordnungsgemäß herunter** innerhalb jedes Mandanten 3. **Überprüfen Sie den Abschluss des Herunterfahrens** bevor Sie mit dem nächsten Schritt fortfahren {% hint style="warning" %} **Wichtig** Stellen Sie sicher, dass alle Mandanten-Workloads ordnungsgemäß heruntergefahren sind, bevor Sie fortfahren. Andernfalls kann es zu Datenverlust oder Beschädigungen kommen. {% endhint %} ### Schritt 3: Host-Workloads ausschalten Nachdem alle Mandanten-Workloads heruntergefahren wurden, schalten Sie alle verbleibenden Workloads auf jedem Knoten aus: 1. **Virtuelle Maschinen (VMs)**: Verwenden Sie nach Möglichkeit die geordnete Herunterfahroption 2. **Mandantenknoten**: Stellen Sie sicher, dass diese erst nach ihren internen Workloads ausgeschaltet werden 3. **VMware-Backup-Dienste**: Stoppen Sie alle aktiven Sicherungsvorgänge 4. **NAS-Dienste**: Stoppen Sie alle NAS-bezogenen Dienste sicher 5. **Andere Dienste**: Schalten Sie alle verbleibenden aktiven Dienste aus {% hint style="info" %} **vNet-Container** vNet-Container müssen nicht manuell gestoppt werden. Sie werden während des Cluster-Herunterfahrens automatisch geordnet gestoppt. {% endhint %} ### Schritt 4: Einzelne Knoten herunterfahren Sobald alle Workloads gestoppt sind: 1. Navigieren Sie zum **Cluster Dashboard** für den Cluster, den Sie ausschalten möchten 2. Wählen Sie **Ausschalten** über das linke Menü 3. Das System beginnt damit, jeden Knoten im Cluster herunterzufahren 4. **Überwachen Sie den Herunterfahrfortschritt** über das Cluster-Dashboard ### Schritt 5: Den gesamten Cluster herunterfahren Nachdem die einzelnen Knoten heruntergefahren wurden: 1. Navigieren Sie zu **System → Cluster** 2. Wählen Sie den Cluster aus, den Sie herunterfahren möchten 3. Wählen Sie **Ausschalten** über das linke Menü 4. Bestätigen Sie das Herunterfahren, wenn Sie dazu aufgefordert werden ## Überlegungen für Umgebungen mit mehreren Clustern {% hint style="danger" %} **Kritische Warnung** Wenn Ihre Umgebung **mehrere Cluster**enthält, müssen Sie **IMMER** den Cluster herunterfahren, der die Controller-Nodes enthält (Node1 & Node2) **ALS LETZTES**. {% endhint %} ### Herunterfahrreihenfolge für Umgebungen mit mehreren Clustern: 1. Fahren Sie zuerst alle **Nicht-Controller-Cluster** herunter 2. Fahren Sie den **Controller-Cluster** (mit Node1 & Node2) zuletzt herunter Dadurch wird sichergestellt, dass Cluster-Koordinierungs- und Verwaltungsdienste verfügbar bleiben, bis alle anderen Cluster sicher heruntergefahren wurden. ## Alternative Methode: Herunterfahren per API Für fortgeschrittene Benutzer oder zu Automatisierungszwecken können Sie die VergeOS-API zum Herunterfahren von Clustern verwenden: ```json mit Body { "cluster": [cluster_id], "action": "shutdown", "params": "{}" } ``` ## Korrekte Einschaltreihenfolge Wenn Sie Ihr VergeOS-System wieder einschalten, befolgen Sie diese Reihenfolge: ### Einzelcluster-Umgebung: 1. **Schalten Sie Node1 ein** herunter 2. **Warten Sie, bis Node1 online ist** vollständig 3. **Schalten Sie Node2 ein** 4. **Schalten Sie die verbleibenden Knoten ein** einen nach dem anderen, mit einer Wartezeit von etwa 1 Minute zwischen jedem 5. **Überprüfen Sie den Systemstatus** im Haupt-Dashboard (sollte Grün und Online anzeigen) ### Umgebung mit mehreren Clustern: 1. **Schalten Sie zuerst den Controller-Cluster ein** (Node1, dann Node2, dann die verbleibenden Controller-Knoten) 2. **Warten Sie, bis der Controller-Cluster vollständig online ist** 3. **Schalten Sie andere Cluster ein** und folgen Sie dabei für jeden der Einzelcluster-Reihenfolge ## Überprüfung und Überwachung Nach Abschluss des Herunterfahr- oder Startvorgangs: 1. **Prüfen Sie das Haupt-Dashboard** auf Systemstatusanzeigen 2. **Überprüfen Sie alle Knoten** auf den entsprechenden Status (Offline beim Herunterfahren, Online beim Starten) 3. **Überwachen Sie die Systemprotokolle** auf Fehler oder Warnungen 4. **Testen Sie kritische Dienste** nach dem Start, um einen ordnungsgemäßen Betrieb sicherzustellen ## Fehlerbehebung ### Häufige Probleme während des Herunterfahrens: **Workloads werden nicht ordnungsgemäß heruntergefahren:** * Überprüfen Sie die ACPI-Einstellungen des Gastbetriebssystems * Verwenden Sie die Optionen "Hard Reset" oder "Kill Power" nur als letzten Ausweg * Überprüfen Sie die Energieverwaltungs-Einstellungen der VM **Knoten wechseln nicht in den Herunterfahrmodus:** * Stellen Sie sicher, dass alle Workloads gestoppt sind * Prüfen Sie auf hängende oder nicht reagierende VMs * Überprüfen Sie die Knotenprotokolle auf Fehlermeldungen **Cluster-Herunterfahren schlägt fehl:** * Stellen Sie sicher, dass die einzelnen Knoten zuerst ordnungsgemäß heruntergefahren wurden * Überprüfen Sie den Clusterstatus und die Konnektivität * Stellen Sie sicher, dass keine aktiven Migrationen oder Wartungsvorgänge laufen ### Hilfe erhalten: Wenn während des Herunterfahrens Probleme auftreten: 1. **Dokumentieren Sie die Fehlermeldungen** und den aktuellen Systemzustand 2. **Prüfen Sie die VergeOS-Protokolle** für detaillierte Fehlerinformationen 3. **Wenden Sie sich an den VergeOS-Support** mit konkreten Details zum Problem ## Bewährte Verfahren * **Planen Sie Herunterfahrfenster** während Zeiten mit geringer Auslastung * **Benachrichtigen Sie die Benutzer** bevor Sie mit den Herunterfahrvorgängen beginnen * **Dokumentieren Sie Ihre spezifische Umgebung** einschließlich Cluster-Topologie und kritischer Workloads * **Testen Sie den Herunterfahrprozess** zunächst in Nicht-Produktionsumgebungen * **Halten Sie aktuelle Backups bereit** bevor Sie Systemherunterfahrten durchführen * **Verwenden Sie den Wartungsmodus** für einzelne Knoten nach Möglichkeit statt vollständiger Herunterfahrten ## Zusammenfassung-Checkliste * [ ] Erfassen Sie alle laufenden Workloads auf allen Knoten * [ ] Fahren Sie Mandanten-Workloads geordnet herunter * [ ] Schalten Sie alle Host-Workloads aus (VMs, Dienste usw.) * [ ] Navigieren Sie zu Cluster Dashboard und wählen Sie Power Off * [ ] Navigieren Sie zu System → Clusters und fahren Sie den gesamten Cluster herunter * [ ] Bei mehreren Clustern: Fahren Sie den Controller-Cluster (Node1 & Node2) zuletzt herunter * [ ] Überprüfen Sie den Abschluss des Herunterfahrens über die Dashboard-Überwachung * [ ] Dokumentieren Sie alle aufgetretenen Probleme für zukünftige Referenz Die Befolgung dieses Verfahrens gewährleistet ein sicheres und kontrolliertes Herunterfahren Ihrer VergeOS-Umgebung bei gleichzeitiger Wahrung von Datenintegrität und Systemzustand. *** {% hint style="info" %} **Dokumentinformationen** * Dokumenttyp: Knowledge-Base-Artikel * Kategorie: Systemadministration * Tags: shutdown, power-off, cluster-management, system-maintenance * Gilt für: VergeOS 4.12.6 und spätere Versionen {% 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/knowledge-base/de/system-administration/proper-vergeos-system-shutdown-procedure.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.