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 de l'array ou de Docker sont lents à démarrer après la mise à niveau - Cliquez pour développer/réduire

Une migration unique peut être nécessaire pour les conteneurs Docker après certaines mises à jour. Ce processus peut prendre du temps, surtout si vous avez de nombreuses images. Soyez patient pendant ce processus ; les performances devraient se normaliser après le démarrage initial.

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 :

  1. Allez à Paramètres → Docker et arrêtez le service Docker.
  2. Cochez la case pour supprimer l'image Docker et cliquez sur le bouton supprimer.
  3. Redémarrez Docker pour recréer l'image.
  4. Naviguez vers l'onglet Applications, Applications Précédentes, cochez ce que vous souhaitez réinstaller, puis cliquez sur "Installer xx Applications".
Les conteneurs de l'array ou de Docker sont lents à démarrer après la mise à niveau - Cliquez pour développer/réduire

Une migration unique peut être nécessaire pour les conteneurs Docker après certaines mises à jour. Ce processus peut prendre du temps, surtout si vous avez de nombreuses images. Soyez patient pendant ce processus ; les performances devraient se normaliser après le démarrage initial.

  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.
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 :

  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:

Mise à niveau ou rétrogradation manuelle​

Les mises à niveau manuelles sont rarement nécessaires mais peuvent être requises si vous ne pouvez pas accéder au WebGUI ou avez besoin de revenir à une version antérieure. Avant de procéder, il est important de sauvegarder votre périphérique flash USB, dont les détails se trouvent dans Sauvegarder votre périphérique flash.

Utiliser l'outil de rétrogradation du système d'exploitation (si WebGUI est accessible)​

Si vous pouvez accéder au WebGUI :

  1. Connectez-vous au WebGUI.
  2. Allez à Outils → Rétrograder OS.
  3. Votre version précédente sera listée comme option de rétrogradation disponible.
  4. Cliquez sur Rétrograder et suivez les instructions.
  5. Redémarrez votre serveur lorsque vous y êtes invité.
précaution

Gardez à l'esprit que la rétrogradation peut entraîner des problèmes de compatibilité avec les plugins ou les conteneurs Docker. Sauvegardez toujours votre périphérique flash USB et toutes les données importantes au préalable.

Méthodes manuelles (si WebGUI est inaccessible)​

Utilisez ces méthodes uniquement si vous ne pouvez pas accéder au WebGUI :

  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.