Zum Hauptinhalt springen

Unraid aktualisieren

Das Aktualisieren von Unraid OS stellt sicher, dass Sie die neuesten Funktionen, Sicherheitsupdates und Hardwareunterstützung erhalten. Diese Seite beschreibt den standardmäßigen Aktualisierungsprozess sowie Problemlösungs-Tipps und manuelle Upgrade-Optionen.

Voraussetzungen

Bevor Sie mit der Aktualisierung beginnen, sichern Sie unbedingt eine vollständige Sicherung Ihres USB-Flash-Geräts. Weitere Einzelheiten finden Sie unter Sicherung Ihres Flash-Geräts.

Bewährte Praktiken vor dem Upgrade
  1. Erstellen Sie ein Backup Ihres Flash-Laufwerks und aller wichtigen Daten.
  2. Lesen Sie die Versionshinweise für die Version, die Sie installieren möchten.
  3. Aktualisieren Sie alle Plugins auf die neuesten Versionen.
  4. Stoppen Sie optional das Array, bevor Sie fortfahren.
  5. Aktualisieren Sie Unraid OS über die Seite Tools → Update OS.
  6. Starten Sie Ihren Server neu, um das Upgrade abzuschließen.

Standard-Aktualisierungsprozess​

Das Aktualisieren von Unraid erfolgt mit dem neuen Update OS-Tool mit einer benutzerfreundlichen Oberfläche:

  1. Im WebGUI, klicken Sie auf das Dropdown-Menü oben rechts und wählen Nach Updates suchen oder navigieren Sie zu Tools → Update OS.
  2. Überprüfen Sie das für den aktuellen Release-Zweig Ihres Servers angezeigte Update.
  3. Klicken Sie auf Changelog anzeigen, um das Update zu starten. Das Changelog wird Ihnen angezeigt, damit Sie es überprüfen können, bevor Sie auf Fortfahren klicken.
  4. Klicken Sie auf Bestätigen und Update starten, um das ausgewählte Release anzuwenden.
  5. Wenn Sie dazu aufgefordert werden, starten Sie Ihren Server neu, um das Upgrade abzuschließen.
notiz

Um zwischen den Release-Zweigen Stable und Next zu wechseln, öffnen Sie das Konto-Menü oben rechts und wählen Sie Unraid.net-Konto verwalten. Die Release-Zweige werden in der Unraid-Konto-App verwaltet, nicht direkt im Betriebssystem.

ZFS Pool-Upgrade-Warnungen

Beim Upgrade auf Unraid 7.x können während des Bootvorgangs oder im WebGUI Warnungen zu ZFS Pool-Feature-Upgrades angezeigt werden. Diese Warnungen sind kein Anzeichen für ein Problem; sie weisen lediglich darauf hin, dass Ihr ZFS-Pool Funktionen einer älteren Version von ZFS verwendet.

Das Upgrade Ihres Pools ist nicht dringend erforderlich, aber wenn Sie sich entscheiden, es durchzuführen, sollten Sie beachten, dass es möglicherweise nicht mit früheren Versionen von Unraid funktioniert. Dies bedeutet, dass Sie nach dem Upgrade möglicherweise nicht zu einer vorherigen Unraid-Version zurückkehren können.

Denken Sie wie immer daran, Ihre Daten zu sichern, bevor Sie Ihre ZFS-Pools aktualisieren.

Probleme beim Upgrade beheben​

Wenn nach dem Upgrade Probleme auftreten, lesen Sie den passenden Abschnitt unten.

Array oder Docker-Container starten nach dem Upgrade langsam​

Nach bestimmten Upgrades kann eine einmalige Migration für Docker-Container erforderlich sein. Dieser Vorgang kann dauern, insbesondere wenn Sie viele Images haben. Warten Sie den Vorgang ab; nach dem ersten Start sollte die Leistung wieder normal sein.

Docker-Container funktionieren nach dem Upgrade nicht richtig​

Wenn Fehler wie "layers from manifest don't match image configuration" auftreten, müssen Sie möglicherweise die Docker-Image-Datei neu erstellen:

  1. Gehen Sie zu Einstellungen → Docker und stoppen Sie den Docker-Dienst.
  2. Aktivieren Sie das Kontrollkästchen zum Löschen des Docker-Images und klicken Sie auf die Schaltfläche zum Löschen.
  3. Starten Sie Docker neu, damit das Image neu erstellt wird.
  4. Öffnen Sie den Tab Apps, dann Vorherige Apps, markieren Sie die neu zu installierenden Apps und klicken Sie auf "xx Anwendungen installieren".

VMs zeigen "cannot get interface MTU" oder Netzwerkfehler​

Wenn Sie für VM-Netzwerke einen benutzerdefinierten Bridge-Namen verwendet haben, stellen Sie alle VMs auf die Standard-Bridge br0 um:

  1. Öffnen Sie den Tab VMs und bearbeiten Sie jede VM (aktivieren Sie Erweiterte Ansicht).
  2. Setzen Sie die Netzwerk-Bridge auf br0 und klicken Sie auf Anwenden.
  3. Öffnen Sie Einstellungen → VM-Manager (in Erweiterter Ansicht) und setzen Sie die Standard-Bridge auf br0.

VNC-Zugriff auf VMs funktioniert nicht oder ist langsam​

Bei älteren VMs müssen Sie eventuell den VNC-Videotreiber aktualisieren:

  1. Bearbeiten Sie die VM im Tab VMs (wählen Sie Erweiterte Ansicht).
  2. Setzen Sie den VNC-Videotreiber auf QXL (empfohlen). Versuchen Sie Cirrus oder vmvga, wenn QXL nicht gut funktioniert.
  3. Klicken Sie auf Anwenden, um die Änderungen zu speichern.

VM startet nicht (EFI-Shell wird angezeigt)​

Wenn Sie OVMF-basierte VMs in älteren Unraid-Versionen erstellt haben, kann eine EFI-Shell angezeigt werden. Sie können die VM mit diesen Befehlen starten:

  1. Geben Sie fs0: ein.
  2. Geben Sie anschließend cd efi/boot ein.
  3. Geben Sie zuletzt bootx64.efi ein.

Wenn fs0: nicht funktioniert, versuchen Sie stattdessen fs1:. Wenn weiterhin Probleme auftreten, besuchen Sie bitte die Unraid-Foren.

Beim Starten meiner VM erscheint der Fehler "Invalid machine type"​

Bearbeiten Sie zur Behebung die VM im WebGUI und klicken Sie ohne Änderungen auf Anwenden. Dadurch wird der Maschinentyp auf die neueste unterstützte Version aktualisiert.

Schlechte VM-Leistung nach dem Upgrade​

Wenn Ihre VM nach einem Upgrade langsam ist, öffnen Sie die VM-Einstellungen (in Erweiterter Ansicht) und aktualisieren Sie die Version des Machine-Typs auf die neueste Revision (z. B. von i440fx-2.5 auf i440fx-2.7). Ändern Sie dabei nicht das Präfix, also wechseln Sie zum Beispiel nicht von i440fx zu Q35.

Unraid herabstufen​

Bevor Sie herabstufen, sollten Sie die Versionshinweise für die Version lesen, die Sie herunterstufen möchten. Suchen Sie nach dem Abschnitt "Zurücksetzen", da er wichtige Schritte enthält, die Sie beachten müssen.

Wenn Sie Zugang zur WebGUI haben, können Sie zu Werkzeuge → Betriebssystem herabstufen gehen. Diese Option ermöglicht es Ihnen, die zuvor installierte Version herabzustufen, ohne eine Zip-Datei von der Versionshistorie-Seite herunterzuladen.

Wenn Sie die Option zum Herabstufen unter Werkzeuge → Betriebssystem herabstufen nicht sehen, verwenden Sie die unten beschriebene manuelle Methode. Dies bedeutet normalerweise, dass die Dateien der vorherigen Version nicht auf Ihrem USB-Stick sind.

Manuelles Downgrade​

Manuelle Herabstufungen sind nur erforderlich, wenn Sie nicht auf die WebGUI zugreifen können oder wenn die Herabstufungsoption nicht verfügbar ist. Bevor Sie fortfahren, ist es wichtig, Ihr USB-Flash-Gerät zu sichern. Weitere Informationen finden Sie unter Sicherung Ihres Flash-Geräts.

  1. Laden Sie die Unraid-Version-ZIP-Datei aus der Versionsgeschichte herunter.
  2. Entpacken Sie die Datei auf Ihrem Computer.
  3. Greifen Sie auf die Netzwerkfreigabe flash zu (Ihr Boot-Laufwerk; der Freigabename kann weiterhin flash sein, auch wenn die Benutzeroberfläche Boot-Gerät anzeigt) oder verbinden Sie das USB-Boot-Gerät mit Ihrem Computer.
  4. Erstellen Sie ein previous-Verzeichnis, wenn es noch nicht existiert.
  5. Verschieben Sie alle bz*- und changes.txt-Dateien in das previous-Verzeichnis.
  6. Kopieren Sie die neuen bz*- und changes.txt-Dateien in das Stammverzeichnis des Boot-Laufwerks.
  7. Starten Sie Ihren Server neu.