Unbereinigt heruntergefahrene Systeme

An unclean shutdown happens when Unraid detects that the array was not properly stopped before the system powered off. This situation can trigger an automatic parity check during the next boot to ensure data integrity.

Recommendations um unsaubere Abschaltungen zu verhindern

Durch einige proaktive Maßnahmen können Sie unbereinigte Herunterfahrten vermeiden oder erkennen:

• Verwenden Sie eine USV: Halten Sie Ihren Server mit einer unterbrechungsfreien Stromversorgung (USV) verbunden und richten Sie diese ein, um einen kontrollierten Shutdown einzuleiten, wenn der Batteriestrom niedrig wird.
• Versuchen Sie ein geordnetes Herunterfahren: Wenn Ihr Server nicht reagiert, drücken Sie kurz den Netzschalter, um ein sicheres Herunterfahren zu initiieren. Halten Sie den Knopf nicht gedrückt, da dies ein hartes Ausschalten erzwingt und zu einem nicht ordnungsgemäßen Herunterfahren führt.
• Aktivieren Sie persistente Protokollierung: Gehen Sie zu Settings → Syslog Server, um die Protokollierung zu aktivieren, die nach einem Neustart bestehen bleibt. Weitere Details finden Sie unter Persistente Protokolle (Syslog-Server).
• Diagnosen für den Support anhängen: Wenn ein unsauberer Shutdown auftritt, versucht Unraid, Diagnosen unter /log/diagnostics.zip auf Ihrem Flash-Gerät zu speichern. Hängen Sie diese Datei an Forumsbeiträge an, wenn Sie Unterstützung suchen.

UPS beste Konfigurationspraktiken

Eine gut konfigurierte USV ist Ihre beste Verteidigung gegen unbereinigte Herunterfahrten, die durch Stromausfall verursacht werden.

• Verbinden Sie die USV über USB mit Ihrem Unraid-Server.
• Aktivieren Sie die USV-Unterstützung unter Einstellungen → USV-Einstellungen.
• Configure shutdown timeouts: Set the UPS to trigger a controlled shutdown before the battery runs low. Adjust the "Battery runtime left" or "Battery charge level" thresholds to provide enough time for Unraid to stop the array and power down safely.
• Testen Sie Ihre Konfiguration: Simulieren Sie einen Stromausfall, um sicherzustellen, dass die USV und Unraid korrekt reagieren.

Schauen Sie sich das NUT Plugin für eine bessere Kompatibilität mit fortschrittlicheren USV-Modellen oder nicht unterstützter Hardware an.

Ereignisse, die unbereinigte Herunterfahrten verursachen

Das Verständnis der Hauptauslöser für nicht ordnungsgemäßes Herunterfahren hilft Ihnen, diese zu verhindern. Erkunden Sie die untenstehenden Tabs für Details zu jedem Szenario.

Unerwarteter Stromausfall

Stromausfälle sind einer der Hauptgründe für unsaubere Abschaltungen. Schützen Sie Ihr System mit einer richtig konfigurierten USV, die Unraid automatisch herunterfahren kann, bevor der Akku leer ist.

notiz

Unraid supports most UPS units using the apcupsd Protocol protocol (APC and CyberPower are usually compatible). If your UPS isn't supported, consider using the Network UPS Tools (NUT) plugin from Community Applications.

Fehler des Flash-Laufwerks

Der Status des array wird auf Ihrem USB-Flash-Laufwerk gespeichert. Wenn das Flash-Laufwerk nicht verfügbar oder schreibgeschützt wird, kann Unraid den Herunterfahrstatus nicht aktualisieren, selbst wenn das array korrekt stoppt. Dies führt dazu, dass beim nächsten Start ein unsauberes Herunterfahren erkannt wird.

Terminalsitzungen öffnen

Unraid wartet während des Herunterfahrens auf alle offenen Terminal- oder SSH-Sitzungen. Wenn diese Sitzungen aktiv bleiben und der Shutdown-Timer abläuft, erfolgt ein erzwungenes Herunterfahren.

Hinweis

Das Dynamix Stop Shell Plugin kann automatisch lange offene Bash- oder SSH-Sitzungen schließen und so für ein reibungsloses Herunterfahren sorgen. Seien Sie jedoch vorsichtig, wenn noch Schreibvorgänge auf das array ausgeführt werden.

---

Konfigurierung der Shutdown-Timeouts

Properly configuring shutdown timeouts is essential to ensure your Unraid server can stop all services effectively, preventing unclean shutdowns, particularly during power loss or maintenance. Each component of your system - VMs, Docker containers, and the overall array - has its own timeout setting that can be adjusted.

Empfohlene Timeout-Einstellungen

Einstellung	Standard	Empfohlene Mindestdauer	Wo einstellen
VM Herunterfahren-Zeitüberschreitung	60s	300s (5 Min)	Einstellungen → VM-Manager → VM-Shutdown (Erweitert)
Docker-Container-Stop-Timeout	10s	30–60s	Einstellungen → Docker (Erweitert)
Allgemeiner Shutdown-Timeout	90s	3 × VM Zeitüberschreitung + Docker-Zeitüberschreitung + 15–30 s	Einstellungen → Laufwerkseinstellungen → Shutdown-Timeout

Timeout für virtuelle Maschinen

Klicken zum Erweitern/Reduzieren

Unraid fährt zuerst alle konfigurierten virtuellen Maschinen (VMs) herunter, bevor es Docker-Container oder das array selbst stoppt. Die VM-Shutdown-Zeitüberschreitung bestimmt, wie lange Unraid auf das ordnungsgemäße Herunterfahren jeder VM wartet.

Wo festlegen

• Einstellungen → VM-Manager → VM-Shutdown (erweiterte Ansicht aktivieren)

Betrachten

• Windows-VMs können mehr Zeit zum Herunterfahren benötigen, insbesondere wenn Updates anstehen oder die VM im Schlaf-/Ruhezustand ist.
• Wenn das Timeout zu kurz ist, werden VMs zwangsweise gestoppt, was zu Datenverlust oder Beschädigung führen kann.

Best Practice

Stellen Sie die Zeitüberschreitung auf mindestens 300 Sekunden (5 Minuten) für Windows-VMs. Planen Sie Updates so, dass sie beim Start und nicht beim Herunterfahren ausgeführt werden, um Verzögerungen zu vermeiden.

Docker-Container-Timeout

Klicken zum Erweitern/Reduzieren

Nach den VMs stoppt Unraid alle laufenden Docker-Container. Der Docker-Container-Stop-Timeout steuert, wie lange Unraid auf das ordnungsgemäße Beenden jedes Containers wartet.

Wo festlegen

• Einstellungen → Docker (erweiterte Ansicht aktivieren)

Betrachten

• Container werden parallel gestoppt.
• Komplexe Container oder solche mit großen Datenbanken benötigen möglicherweise mehr als die voreingestellten 10 Sekunden, um sicher herunterzufahren.
• Wenn der Timer abläuft, werden Container erzwungenermaßen gestoppt.

Best Practice

Erhöhen Sie das Timeout auf 30–60 Sekunden, wenn Sie Docker-Container betreiben, die zusätzliche Shutdown-Zeit benötigen.

Allgemeiner Shutdown-Timer

Klicken zum Erweitern/Reduzieren

Der allgemeine Herunterfahr-Timeout ist die maximale Zeit, die Unraid für alle Herunterfahrprozesse - VMs, Docker und Festplattenvorgänge - gewährt, bevor ein erzwungenes Herunterfahren durchgeführt wird.

Wo festlegen

• Einstellungen → Laufwerkseinstellungen → Shutdown-Timeout

Wie berechnen

Addieren Sie Ihre %%VM-%% und Docker-Timeouts, dann 15–30 Sekunden für das Unmounten von Laufwerken und andere Prozesse.

• Beispiel: 3 × ***VM-Shutdown-Timeout*** + ***Docker-Stop-Timeout*** + 15–30 Sekunden

Beste Praxis

Stellen Sie diesen Timer hoch genug ein, um Ihr langsamstes Herunterszenario abzudecken, insbesondere wenn Sie viele Laufwerke oder ein großes array haben.

USV-Batterielebensdauer

Klicken zum Erweitern/Reduzieren

Ihre USV muss genügend Laufzeit bieten, um alle Shutdown-Timer ablaufen zu lassen, bevor der Server keinen Strom mehr hat.

Wo festlegen

• Einstellungen → USV-Einstellungen (siehe Verbleibende Laufzeit mit allen Laufwerken im Betrieb)

Betrachten

• Die USV sollte einen Shutdown früh genug auslösen, um die vollständige Shutdown-Abfolge abzuschließen.
• Wenn der Akku leer ist, bevor der Shutdown abgeschlossen ist, besteht das Risiko eines unbereinigten Herunterfahrens und möglicher Datenverluste.

Best Practice

Testen Sie Ihre USV, indem Sie einen Stromausfall simulieren und bestätigen, dass Unraid mit genügend Zeit sauber herunterfährt.