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 anhängen, um Unterstützung zu erhalten: Bei einem nicht ordnungsgemäßen Herunterfahren versucht Unraid, Diagnosen in /log/diagnostics.zip auf Ihrem Flash-Gerät zu speichern. Fügen Sie diese Datei Forenbeiträgen hinzu, wenn Sie Hilfe 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 breitere 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.

Offene Terminal-Sitzungen

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

The Dynamix Stop Shell plugin can automatically close lingering bash or SSH sessions, helping ensure a graceful shutdown. However, be cautious if there are ongoing write operations to the array.

---

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	Empfohlenes Minimum	Wo konfiguriert man
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 Sie zum Erweitern/Einklappen

Unraid first shuts down all configured virtual machines (VMs) before stopping Docker containers or the array itself. The VM Shutdown Timeout determines how long Unraid waits for each VM to shut down gracefully.

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 das Timeout auf mindestens 300 Sekunden (5 Minuten) für Windows-VMs ein. Planen Sie Updates so, dass sie beim Start und nicht beim Herunterfahren ausgeführt werden, um Verzögerungen zu vermeiden.

Docker-Container-Timeout

Klicken Sie zum Erweitern/Einklappen

Nach den VMs stoppt Unraid alle laufenden Docker-Container. Das Stoppt-Timeout für Docker-Container steuert, wie lange Unraid wartet, bis jeder Container ordnungsgemäß beendet ist.

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 Sie zum Erweitern/Einklappen

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

Best practice

Set this timer high enough to cover your slowest shutdown scenario, especially if you have many drives or a large array.

USV-Batterielebensdauer

Klicken Sie zum Erweitern/Einklappen

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.