Démarrage et échecs de charge
Lorsque votre serveur Unraid ne démarre pas correctement, il peut être difficile d'identifier la cause sans une compréhension claire du processus de démarrage. Suivre ce guide vous permet de diagnostiquer rapidement et de résoudre la plupart des problèmes de démarrage, assurant que votre array, votre WebGUI et vos services soient opérationnels avec un minimum de temps d'arrêt.
Préparation du support de démarrage
Ce sujet est couvert en détail dans la section Préparer votre périphérique USB.
Toujours sauvegarder votre périphérique de démarrage avant d'effectuer des modifications. Tous les paramètres spécifiques à l'utilisateur, y compris votre clé de licence, sont stockés dans le dossier config. Restaurer ce dossier après avoir recréé votre périphérique de démarrage aidera à préserver votre configuration actuelle.
Activation du démarrage UEFI
Les systèmes modernes nécessitent généralement le mode de démarrage UEFI pour une sécurité accrue et des temps de démarrage plus rapides.
Pour configurer le démarrage UEFI dans les paramètres BIOS/UEFI de votre système :
- Entrez dans la configuration BIOS/UEFI de votre carte mère au démarrage (généralement en appuyant sur F2, DEL ou ESC)
- Localiser les options de démarrage ou les paramètres de mode de démarrage
- Définissez le mode de démarrage sur UEFI ou UEFI avec CSM désactivé
- Assurez-vous que le périphérique de démarrage Unraid est sélectionné comme cible de démarrage UEFI
- Enregistrez vos modifications et quittez
Comprendre la séquence de démarrage
La séquence de démarrage Unraid comporte plusieurs étapes :
3. Noyau Linux - Cliquez pour développer/réduire
Le noyau Linux s'initialise et commence la détection du matériel. C'est ici que le système d'exploitation prend le contrôle du chargeur de démarrage.
- Le BIOS de la carte mère reconnaît le périphérique de démarrage Unraid (généralement une clé USB).
- La définition du périphérique de démarrage comme cible de démarrage par défaut varie selon votre BIOS ; consultez le manuel de votre carte mère pour obtenir des conseils.
- Le volume de démarrage prend en charge les modes de démarrage legacy (CSM) et UEFI.
- Pour le démarrage UEFI, assurez-vous que le dossier
EFIsur le volume de démarrage ne se termine pas par un trait d'union (-).
4. Services dépendants du flash - Cliquez pour développer/réduire
Le périphérique flash devient accessible et des services essentiels commencent à se charger. Cette étape est cruciale pour la configuration et l'accès au réseau.
- Les entrées du menu de démarrage sont définies dans le fichier
syslinux/syslinux.cfgsur le volume de démarrage. - Vous pouvez modifier ce fichier via le WebGUI sous Main → Configuration de Syslinux.
- Memtest86+, qui est inclus avec les versions actuelles d'Unraid, fonctionne en modes legacy et UEFI. Pour les anciennes versions d'Unraid, obtenez une version compatible sur le site officiel de Memtest pour UEFI.
- Le dispositif flash doit être étiqueté UNRAID (en majuscules) pour un montage correct.
5. Plugins - Cliquez pour développer/réduire
Les extensions tierces et personnalisations sont chargées pour améliorer la fonctionnalité du système. Des problèmes de plugin peuvent empêcher un démarrage réussi.
- Syslinux charge le cœur Linux depuis le volume de démarrage dans la RAM.
- Les options de démarrage en mode sans échec peuvent supprimer le chargement des plugins si nécessaire.
- Les erreurs à cette étape indiquent souvent des problèmes avec le périphérique de démarrage.
- Linux détecte le matériel lors du démarrage.
4. Services dépendants du volume de démarrage - Cliquez pour développer/réduire
Le volume de démarrage devient accessible et les services essentiels commencent à se charger. Cette étape est critique pour la configuration et l'accès réseau.
- Le volume de démarrage est monté sur
/boot. - Le fichier
config/gosur le dispositif flash peut exécuter des commandes utilisateur avant ou après le démarrage du WebGUI. - Utilisez la commande
dfpour vérifier si/bootest monté. - Le volume de démarrage doit être étiqueté UNRAID (en majuscules) pour un montage correct.
- Des pilotes et firmwares additionnels seront disponibles à cette étape.
- La configuration est chargée dans la RAM.
- Les services Linux standard, y compris la mise en réseau et WireGuard VPN (si activé), démarrent ici.
7. Array - Cliquez pour développer/réduire
Les périphériques de stockage sont montés et rendus disponibles, complétant ainsi le processus de démarrage. C'est ici que vos données deviennent accessibles.
- Si l'auto-démarrage est activé, le array démarre ici ; sinon, un démarrage manuel sera requis.
- Les disques seront montés en tant que
/dev/diskXet/mnt/cache(si présent).
6. WebGUI - Cliquez pour développer/réduire
7. Array - Cliquez pour développer/réduire
Les périphériques de stockage sont montés et rendus disponibles, complétant ainsi le processus de démarrage. C'est ici que vos données deviennent accessibles.
- Si l'auto-démarrage est activé, le array démarre ici ; sinon, un démarrage manuel sera requis.
- Les disques seront montés en tant que
/dev/diskXet/mnt/cache(si présent). - Les partages deviennent disponibles sur le réseau en tant que
/mnt/user/sharename. - Les conteneurs Docker démarreront dans l'ordre spécifié sur l'onglet Docker, avec des délais personnalisables.
- Les machines virtuelles (VMs) à démarrage automatique seront également lancées.
À ce stade, le serveur Unraid est pleinement opérationnel.
Échec du démarrage
Quand votre serveur ne démarre pas, un dépannage systématique aide à identifier et résoudre rapidement la cause profonde. Suivez ces étapes dans l'ordre pour éviter de manquer des problèmes critiques ou de faire des changements inutiles. Chaque étape s'appuie sur la précédente, alors ne sautez pas même si une étape semble non liée à votre problème spécifique.
- Utilisez un port USB 2.0 pour le périphérique de démarrage si possible (lors d'un démarrage depuis USB). Il est généralement plus fiable et moins sujet aux problèmes que l'USB 3.0.
- Vérifiez vos paramètres BIOS/UEFI pour vous assurer que le périphérique de démarrage Unraid est défini comme cible de démarrage principale.
- Inspectez le périphérique de démarrage pour détecter toute erreur physique ou logique sur un ordinateur Windows ou macOS.
- Réextrayez les fichiers bz* de la version Unraid sur le volume de démarrage pour éviter toute corruption potentielle.
- Reconstruisez le support de démarrage en partant d'une copie propre de Unraid, puis restaurez votre dossier
config. - Essayez le démarrage en mode sécurisé pour vérifier tout problème lié aux plugins.
- Testez avec un nouveau support de démarrage et effectuez une installation propre de Unraid. Cela aide à déterminer s'il y a des problèmes avec le matériel du serveur.
- Si nécessaire, transférez votre licence vers un nouveau périphérique de démarrage.
Récupération d'une disquette perdue et de lecteurs de parité inconnus
Si votre disque de démarrage Unraid échoue et que vous n'avez pas de sauvegarde récente ou de connaissance des disques qui sont en parité, vous pouvez récupérer votre système en utilisant la capacité d'Unraid à reconnaître les disques de données par leurs systèmes de fichiers. Les parity-drives n'ont pas de système de fichiers valide, ce qui permet de les différencier.
- Ne démarrez pas l'array tant que vous n'êtes pas sûr des affectations de disques
- Documentez quels disques étaient précédemment des disques de parité versus des disques de données
- Envisagez de demander de l'aide sur les forums Unraid si vous n'êtes pas sûr
Si vous avez des sauvegardes récentes ou une documentation de votre configuration d'array, examinez-les en premier.
Si votre disque de démarrage Unraid échoue et que vous n'avez pas de sauvegarde récente ou de connaissance des disques qui sont en parité, vous pouvez récupérer votre système en utilisant la capacité d'Unraid à reconnaître les disques de données par leurs systèmes de fichiers. Les parity-drives n'ont pas de système de fichiers valide, ce qui permet de les différencier.
Unraid identifie les disques de données en détectant les systèmes de fichiers valides existants. Les Parity drives, qui n'ont pas de système de fichiers, apparaissent comme non montables. Cette caractéristique vous permet de distinguer les parity drives des disques de données après avoir démarré avec un nouveau support de démarrage.
Procédure de récupération
Cette procédure vous aide à restaurer la configuration de votre array lorsque vous avez perdu votre disque de démarrage et que vous ne vous souvenez pas des disques qui étaient en parité vs. données. Suivez chaque étape avec soin pour éviter toute perte de données.
- Créez un nouveau support de démarrage Unraid.
- Démarrez le serveur depuis ce nouveau périphérique (n'affectez encore aucun disque).
- Activez une licence, en utilisant soit un essai soit en transférant une existante.
- Identifiez les parity drives en utilisant l'une des méthodes mentionnées ci-dessous.
- Utilisez Outils → Nouvelle configuration pour réinitialiser l'array tout en conservant les affectations précédentes si possible.
- Corrigez les attributions de disques dans l'onglet Principal, en veillant à distinguer entre parity et disques de données.
- Démarrez l'array pour valider les affectations de disques.
- Si la parity est valide, cochez la case pour Paraité déjà valide. Sinon, laissez la parity se reconstruire.
Si vous avez plusieurs parity-drives et que vous avez dû les identifier en fonction des disques qui n'étaient pas montables, ne pas utiliser l'option Parité est déjà valide. Il y a une chance sur deux de se tromper dans les affectations, et si vous le faites, votre array peut sembler protégé mais en réalité ne l'est pas. Autorisez toujours la reconstruction de la parité dans ce scénario pour assurer une protection adéquate.
- Révisez et ajustez tout inclusion/exclusion de partage utilisateur basé sur les nouvelles affectations.
- Effectuez un parity check pour vérifier l'intégrité, surtout si la parity n'a pas été reconstruite.
Identification des disques de parité
Utilisation de la capacité intégrée d'Unraid (méthode préférée) - Cliquez pour développer/réduire
Cette méthode ne nécessite pas de plugins, mais elle invalidera la parity, nécessitant une reconstruction.
Pour utiliser cette méthode :
- Affectez tous les disques comme disques de données et démarrez-le.
- Les parity drives apparaîtront comme non montables car ils manquent d'un système de fichiers valide.
- Confirmez que le nombre de disques non montables correspond à votre nombre de parity.
- Prenez note des numéros de série de ces disques.
- Le cas échéant, vous pouvez vérifier les disques de données montés pour confirmer leur ordre.
Utilisation du plugin Unassigned Devices - Cliquez pour développer/réduire
Cette méthode basée sur un plugin préserve la validité de la parity en montant les disques en mode lecture seule.
Pour utiliser cette méthode :
- Installez le plugin Unassigned Devices depuis l'onglet Apps.
- Montez chaque disque en lecture seule, un à la fois.
- Les disques qui échouent à se monter sont probablement des parity drives (vous ne pouvez pas faire la différence entre parité1 et parité2).
- Inspectez les disques de données montés pour identifier leur ordre, si nécessaire.
Pour plus d'informations, consultez le fil des discussions du plugin Unassigned Devices dans les forums Unraid.
* "WireGuard" et le logo "WireGuard" sont des marques déposées de Jason A. Donenfeld.