Passer au contenu principal

Mise à niveau d'Unraid

La mise à niveau d'Unraid OS garantit que vous disposez des fonctionnalités, des mises à jour de sécurité et du support matériel les plus récents. Cette page décrit le processus de mise à niveau standard, ainsi que des conseils de dépannage et des options de mise à niveau manuelle.

:::note[Prerequisites]

Avant de commencer la mise à niveau, assurez-vous de créer une sauvegarde complète de votre périphérique USB. Pour plus de détails, consultez Sauvegarder votre périphérique.

:::

Best pratiques avant la mise à niveau
  1. Faites une sauvegarde de votre clé USB et de toutes données importantes.
  2. Lisez les notes de version de la version que vous prévoyez d'installer.
  3. Mettez à jour tous les plugins vers leurs dernières versions.
  4. Optionnellement, arrêtez le réseau avant de procéder.
  5. Mettez à jour Unraid OS en utilisant la page Outils → Mise à jour de l'OS.
  6. Redémarrez votre serveur pour finaliser la mise à jour.

Processus de mise à niveau standard​

La mise à niveau d'Unraid se fait grâce au nouvel outil de mise à jour d'OS avec une interface conviviale :

  1. Dans le WebGUI, cliquez sur le menu déroulant en haut à droite et sélectionnez Vérifier les mises à jour ou accédez à Outils → Mise à jour de l'OS.
  2. Choisissez le canal Stable pour les versions stables ou le canal Next pour les bêtas et RCs.
  3. Cliquez sur Voir le journal des modifications pour démarrer la mise à jour. Le journal des modifications apparaîtra pour que vous puissiez le revoir avant d'appuyer sur Continuer.
  4. Cliquez sur Confirmer et démarrer la mise à jour pour appliquer la dernière version stable.
  5. Lorsque vous y êtes invité, redémarrez votre serveur pour compléter la mise à niveau.
note

Vous pourriez avoir besoin de vous connecter à votre compte Unraid pour accéder aux mises à jour, en particulier pour les versions "Next".

ZFS avertissements de mise à niveau du pool

Lors de la mise à niveau vers Unraid 7.x, vous pouvez voir des avertissements concernant les mises à jour des fonctionnalités du pool ZFS durant le démarrage ou dans le WebGUI. Ces avertissements ne sont pas un signe de problème; ils indiquent simplement que votre pool ZFS utilise des fonctionnalités d'une ancienne version de ZFS.

Mettre à niveau votre pool n'est pas urgent, mais si vous décidez de le faire, gardez à l'esprit que cela peut ne pas fonctionner avec les versions précédentes d'Unraid. Cela signifie que vous ne pourrez peut-être pas revenir à une version antérieure d'Unraid après avoir effectué la mise à niveau.

Comme toujours, n'oubliez pas de sauvegarder vos données avant de mettre à niveau vos pools ZFS.

Dépannage des problèmes de mise à niveau​

Si vous rencontrez des problèmes après la mise à niveau, consultez la section correspondante ci-dessous pour obtenir de l'aide.

Les conteneurs Docker ne fonctionnent pas correctement après une mise à niveau - Cliquez pour développer/réduire

Si vous rencontrez des erreurs du type "les couches du manifeste ne correspondent pas à la configuration de l'image," il peut être nécessaire de reconstruire votre fichier d'image Docker. Voici comment :

Les VMs affichent "impossible d'obtenir l'interface MTU" ou des erreurs réseau - Cliquez pour développer/réduire

If you have OVMF-based VMs created in older Unraid versions, you might encounter an EFI shell. You can boot the VM by entering the following commands:

  1. Tapez fs0:.
  2. Ensuite, tapez cd efi/boot.
  3. Enfin, tapez bootx64.efi.
  4. Naviguez vers l'onglet Applications, Applications Précédentes, cochez ce que vous souhaitez réinstaller, puis cliquez sur "Installer xx Applications".
L'accès VNC aux VMs ne fonctionne pas ou est lent - Cliquez pour développer/réduire

Pour résoudre ce problème, modifiez le VM dans le WebGUI et cliquez sur Appliquer sans apporter de modifications. Cette action mettra à jour le type de machine vers la version la plus récente supportée.

  1. Allez à l'onglet VMs et modifiez chaque VM (assurez-vous d'activer Vue avancée).
  2. Réglez le pont réseau sur br0 et cliquez sur Appliquer.
  3. Allez à Paramètres → Gestionnaire de VM (en Vue avancée) et réglez le pont par défaut sur br0.
La VM ne démarre pas (shell EFI apparaît) - Cliquez pour développer/réduire

If you have OVMF-based VMs created in older Unraid versions, you might encounter an EFI shell. You can boot the VM by entering the following commands:

  1. Modifiez la VM de l'onglet VMs (sélectionnez Vue avancée).
  2. Réglez le Pilote Vidéo VNC sur QXL (recommandé). Essayez Cirrus ou vmvga si vous avez un succès limité avec QXL.
  3. Cliquez sur Appliquer pour enregistrer les modifications.
Les VMs affichent "impossible d'obtenir l'interface MTU" ou des erreurs réseau - Cliquez pour développer/réduire

If you have OVMF-based VMs created in older Unraid versions, you might encounter an EFI shell. You can boot the VM by entering the following commands:

  1. Tapez fs0:.
  2. Ensuite, tapez cd efi/boot.
  3. Enfin, tapez bootx64.efi.

Si fs0: ne fonctionne pas, vous pouvez essayer fs1: à la place. Si vous continuez à avoir des problèmes, veuillez visiter les forums Unraid pour obtenir de l'aide.

L'accès VNC aux VMs ne fonctionne pas ou est lent - Cliquez pour développer/réduire

Pour résoudre ce problème, modifiez le VM dans le WebGUI et cliquez sur Appliquer sans apporter de modifications. Cette action mettra à jour le type de machine vers la version la plus récente supportée.

La VM ne démarre pas (shell EFI apparaît) - Cliquez pour développer/réduire

If you have OVMF-based VMs created in older Unraid versions, you might encounter an EFI shell. You can boot the VM by entering the following commands:

Rétrograder Unraid​

Avant de rétrograder, assurez-vous de lire les notes de version de la version que vous rétrogradez. Cherchez la section intitulée « Retour en arrière », car elle contient toutes les étapes importantes que vous devez suivre.

Si vous avez accès au WebGUI, vous pouvez aller dans Outils → Rétrograder le système d'exploitation. Cette option vous permet de revenir à votre version précédemment installée sans télécharger un fichier zip depuis la page d'historique des versions.

Si vous ne voyez pas l'option de rétrogradation sous Outils → Rétrograder le système d'exploitation, utilisez la méthode manuelle décrite ci-dessous. Cela signifie généralement que les fichiers pour la version précédente ne sont pas sur votre clé USB.

Rétrogradation manuelle​

Les rétrogradations manuelles ne sont nécessaires que si vous ne pouvez pas accéder au WebGUI ou si l'option de rétrogradation n'est pas disponible. Avant de continuer, il est important de sauvegarder votre périphérique USB. Pour plus de détails, voir Sauvegarder votre périphérique USB.

  1. Téléchargez le fichier ZIP de la version Unraid depuis Historique des versions.
  2. Décompressez le fichier sur votre ordinateur.
  3. Accédez au partage flash ou connectez le dispositif USB à votre ordinateur.
  4. Créez un répertoire previous s'il n'existe pas déjà.
  5. Déplacez tous les fichiers bz* et changes.txt dans le répertoire previous.
  6. Copiez les nouveaux fichiers bz* et changes.txt à la racine de la clé USB.
  7. Redémarrez votre serveur.