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. Mettre à jour Unraid OS en utilisant la page Outils → Mise à jour OS.
6. Redémarrez votre serveur pour finaliser la mise à jour.

Processus de mise à niveau standard

Unraid 7.x et plus

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

Unraid 6.11 à 6.12

Pour les versions Unraid 6.11 et 6.12, suivez cette méthode de mise à jour traditionnelle :

1. Dans le WebGUI, allez à Outils → Mise à jour de l'OS.
2. Cliquez sur Vérifier les mises à jour.
3. Si une nouvelle version est disponible, cliquez sur Mettre à jour.
4. Redémarrez votre serveur lorsque vous y êtes invité.

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

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

1. Allez dans Paramètres → Docker et arrêtez le service Docker.
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. Accédez à Paramètres → Gestionnaire de VM (en Vue avancée) et définissez 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étrogradation manuelle

Les rétrogradations manuelles sont rarement nécessaires mais peuvent l'être si vous ne pouvez pas accéder au WebGUI ou si vous devez revenir à une version antérieure. Avant de continuer, il est important de sauvegarder votre dispositif flash USB, les détails peuvent être trouvés dans Sauvegarder votre dispositif flash.

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

Méthode la plus simple

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.

Méthode en ligne de commande

précaution

Cette méthode ne doit être utilisée que si vous êtes à l'aise avec la ligne de commande Linux, car des erreurs pourraient rendre votre système non démarrable.

1. Copiez l'URL du fichier ZIP de la version d'Unraid souhaitée depuis Historique des versions.

2. Connectez-vous via SSH ou console.

3. Exécutez les commandes suivantes une par une (remplacez <URL> par le lien copié) :

   cd /tmp
   rm -f unraid.zip
   rm -rf unraid_install
   wget -O unraid.zip <URL>
   [[ -s unraid.zip ]] && echo "OK to continue" || echo "STOP: the file was not downloaded"
   unzip -d unraid_install unraid.zip
   [[ -s unraid_install/bzroot ]] && echo "OK to continue" || echo "STOP: the file was not extracted properly"
   [[ ! -d /boot/previous ]] && mkdir /boot/previous
   mv /boot/bz* /boot/previous
   mv /boot/changes.txt /boot/previous
   cp unraid_install/bz* /boot
   cp unraid_install/changes.txt /boot
   sync -f /boot
   sleep 5
   reboot

What se produit pendant le processus de rétrogradation

Lors de l'utilisation de l'outil de rétrogradation OS (WebGUI), l'outil gérera automatiquement les actions suivantes :

1. Validation du système : Vérifie que la rétrogradation est sûre à effectuer.
2. Sauvegarde des fichiers : Une sauvegarde de vos fichiers système actuels sera créée.
3. Vérification de la version : L'outil s'assure que les fichiers de la version cible sont valides et complets.
4. Remplacement des fichiers : Il remplace les fichiers actuels de l'OS par ceux de la version précédente.
5. Préservation de la configuration : Vos paramètres actuels seront conservés.
6. Préparation du système : Le système sera préparé pour la version précédente.
7. Planification du redémarrage : Un redémarrage sera programmé pour terminer la rétrogradation.

Vérification post-rétrogradation

Après la rétrogradation et le redémarrage de votre serveur :

1. Vérifiez la version : Assurez-vous que vous exécutez la version d'Unraid que vous attendez.
2. Testez les fonctionnalités essentielles : Assurez-vous que les services array, Docker, et VM fonctionnent correctement.
3. Vérifiez les plugins : Vérifiez que vos plugins installés sont compatibles et fonctionnent comme prévu.
4. Testez les conteneurs Docker : Démarrez vos conteneurs Docker et confirmez leur bon fonctionnement.
5. Vérifiez les VMs : Si vous avez des machines virtuelles (VMs), assurez-vous qu'elles démarrent et fonctionnent correctement. Voir Configuration de VM pour des conseils de configuration.
6. Surveillez les journaux du système : Surveillez les journaux du système pour tout message d'erreur. Utilisez les outils de diagnostic pour capturer des informations détaillées sur le système.

Dépannage des problèmes de rétrogradation

Option de rétrogradation non disponible - Cliquez pour développer/réduire

Si vous ne voyez pas d'option pour rétrograder :

• Vérifiez l'historique du système : Assurez-vous que vous avez précédemment mis à jour à partir d'une version compatible.
• Vérifiez l'intégrité des fichiers : Les fichiers de la version précédente peuvent être corrompus ou manquants.
• Vérifiez la compatibilité : Il se peut que la version antérieure ne soit pas compatible avec votre matériel actuel.
• Méthode manuelle : Si nécessaire, suivez les méthodes de rétrogradation manuelle décrites sur cette page.

Échec de la rétrogradation pendant le processus - Cliquez pour développer/réduire

Si le processus de rétrogradation ne se passe pas comme prévu :

1. Ne paniquez pas : Votre système devrait toujours fonctionner avec la version actuelle.
2. Vérifiez les journaux : Examinez les journaux du système pour trouver des messages d'erreur spécifiques. Utilisez les outils de diagnostic pour une analyse complète des journaux.
3. Vérifiez les fichiers : Assurez-vous que tous les fichiers requis pour la version cible sont disponibles.
4. Essayez la méthode manuelle : Si l'outil ne fonctionne pas, envisagez d'utiliser les méthodes de rétrogradation manuelle.
5. Contactez le support : Si les problèmes persistent, contactez le support Unraid avec vos diagnostics.

Le système ne démarre pas après la rétrogradation - Cliquez pour développer/réduire

Si votre système ne démarre pas après la rétrogradation :

1. Démarrez à partir de l'USB : Utilisez un autre ordinateur pour accéder à votre dispositif flash USB. Voir dépannage du démarrage pour des étapes de récupération détaillées.
2. Restaurer à partir de la sauvegarde : Copiez vos fichiers de sauvegarde sur le dispositif USB.
3. Vérifiez l'intégrité des fichiers : Assurez-vous que tous les fichiers système sont présents et non endommagés.
4. Essayez le mode sans échec : Démarrez en mode sans échec pour un dépannage plus approfondi.
5. Récupération manuelle : Si nécessaire, utilisez les méthodes de récupération manuelle.

Plugins ou conteneurs Docker ne fonctionnent pas - Cliquez pour développer/réduire

Après une rétrogradation, certains plugins ou conteneurs peuvent ne pas fonctionner correctement :

• Mettez à jour les plugins : Cherchez des mises à jour de plugins compatible avec la version rétrogradée. Consulter Applications Communautaires pour des versions compatibles.
• Reconstruisez Docker : Supprimez et recréez votre fichier d'image Docker. Voir Dépannage Docker pour des étapes détaillées.
  • Vérifiez les dépendances : Assurez-vous que toutes les dépendances nécessaires sont disponibles.
  • Compatibilité des plugins : Certains plugins peuvent ne pas prendre en charge les versions antérieures d'Unraid.
  • Plugins dépendants des fonctionnalités UI/WebGUI : Les plugins reposant sur des fonctionnalités plus récentes de WebGUI peuvent ne pas fonctionner correctement sur des versions plus anciennes.
  • Plugins de thèmes : Les plugins de personnalisation visuelle peuvent nécessiter des mises à jour ou la suppression s'ils sont incompatibles.