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.

Prérequis

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.

Bonnes 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 à jour d'Unraid se fait grâce au nouvel outil de mise à jour de l'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. Vérifiez la mise à jour affichée pour la branche de version actuelle de votre serveur.
  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 version sélectionnée.
  5. Lorsque vous y êtes invité, redémarrez votre serveur pour compléter la mise à niveau.
note

Pour passer entre les branches de publication Stable et Next, ouvrez le menu du compte en haut à droite et choisissez Gérer le compte Unraid.net. Les branches de publication sont gérées dans l'application de compte Unraid, et non directement dans l'OS.

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.

L'array ou les conteneurs Docker démarrent lentement après la mise à niveau​

Une migration ponctuelle peut être nécessaire pour les conteneurs Docker après certaines mises à niveau. Ce processus peut prendre du temps, surtout si vous avez beaucoup d'images. Patientez pendant cette opération ; les performances devraient redevenir normales après le premier démarrage.

Les conteneurs Docker ne fonctionnent pas correctement après une mise à niveau​

Si vous rencontrez des erreurs du type "layers from manifest don't match image configuration", vous devrez peut-être reconstruire votre fichier image Docker :

  1. Allez dans Paramètres → Docker et arrêtez le service Docker.
  2. Cochez la case pour supprimer l'image Docker et cliquez sur le bouton de suppression.
  3. Redémarrez Docker pour recréer l'image.
  4. Ouvrez l'onglet Apps, puis Previous Apps, cochez les applications à réinstaller et cliquez sur "Install xx Applications".

Les VMs affichent "cannot get interface MTU" ou des erreurs réseau​

Si vous avez utilisé un nom de pont personnalisé pour le réseau des VMs, mettez toutes les VMs à jour pour utiliser le pont par défaut br0 :

  1. Ouvrez l'onglet VMs et modifiez chaque VM (assurez-vous d'activer la Vue avancée).
  2. Réglez le pont réseau sur br0 et cliquez sur Appliquer.
  3. Ouvrez Paramètres → Gestionnaire de VM (en Vue avancée) et définissez le pont par défaut sur br0.

L'accès VNC aux VMs ne fonctionne pas ou est lent​

Pour les anciennes VMs, vous devrez peut-être mettre à jour le pilote vidéo VNC :

  1. Modifiez la VM depuis l'onglet VMs (sélectionnez Vue avancée).
  2. Réglez le pilote vidéo VNC sur QXL (recommandé). Essayez Cirrus ou vmvga si QXL fonctionne mal.
  3. Cliquez sur Appliquer pour enregistrer les modifications.

La VM ne démarre pas (un shell EFI apparaît)​

Si vous avez créé des VMs basées sur OVMF dans d'anciennes versions d'Unraid, un shell EFI peut apparaître. Vous pouvez démarrer la VM avec ces commandes :

  1. Tapez fs0:.
  2. Tapez ensuite cd efi/boot.
  3. Tapez enfin bootx64.efi.

Si fs0: ne fonctionne pas, essayez fs1:. Si les problèmes persistent, consultez les forums Unraid.

Le démarrage de ma VM affiche l'erreur "Invalid machine type"​

Pour résoudre ce problème, modifiez la VM dans le WebGUI et cliquez sur Appliquer sans effectuer de changement. Cette action mettra le type de machine à jour vers la dernière version prise en charge.

Faibles performances de la VM après la mise à niveau​

Si votre VM est lente après une mise à niveau, ouvrez les paramètres de la VM (en Vue avancée) et mettez la version du type Machine à jour vers la dernière révision (par exemple de i440fx-2.5 à i440fx-2.7). Ne changez pas le préfixe ; par exemple, ne passez pas de i440fx à Q35.

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 réseau flash (votre volume de démarrage ; le nom du partage peut toujours être flash même lorsque l’interface utilisateur indique Périphérique de démarrage) ou connectez le périphérique de démarrage 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 du lecteur de démarrage.
  7. Redémarrez votre serveur.