Quand quelque chose ne va pas : par où commencer

16 min · 12 rubriques

Ce guide est classé selon ce que tu vois, pas selon ce qui tombe en panne. Cherche le symptôme, et de là tu sauras quoi regarder et dans quel ordre.

Une règle avant tout : le panneau dit ce qu’il sait et ne devine pas. Si un écran te donne une raison, cette raison a été vérifiée ; s’il te dit « impossible de vérifier », c’est qu’il n’a vraiment pas pu, et c’est là que ce guide entre en jeu.

1. Je n’arrive pas à ouvrir le panneau

La première chose est de séparer deux cas très différents : le NAS ne répond pas ou ton navigateur ne veut pas entrer. On les distingue en dix secondes.

1.1 Est-il toujours à cette adresse ?

La cause numéro un du « ça ne s’ouvre pas » n’est pas une panne : c’est que l’IP a changé. Ça arrive quand le routeur redémarre et redistribue les adresses.

Avec un écran et un clavier branchés au NAS, ou par SSH :

lgm

Ça affiche la version, le nom du dispositif et l’adresse du panneau. Si elle est différente de celle que tu avais enregistrée, c’était ça le problème, et la vraie solution est de lui donner une adresse fixe : Panneau de configuration → Réseau, ou depuis la console lgm set-ip.

1.2 Le service tourne-t-il ?

systemctl status nas-backend nas-helper

Ce sont les deux qui comptent : nas-backend est le panneau et nas-helper est le processus avec les autorisations qui fait le travail du système. Si l’un des deux est arrêté :

sudo systemctl restart nas-backend
lgm log

lgm log affiche le journal du panneau, et c’est là que se trouvera la raison.

⚠️ Si tu viens de faire une mise à jour et que le panneau ne revient pas, regarde la partie 6.

1.3 « Le serveur NAS ne répond pas pour le moment (en cours de redémarrage ?) »

Ce message apparaît à l’intérieur du panneau : la page s’est chargée, donc le navigateur a bien atteint le NAS à un moment. Deux cas :

• Tu viens de mettre à jour ou de redémarrer. C’est normal pendant quelques secondes ; le panneau réessaie tout seul et revient.
• Il apparaît dès l’ouverture et ne s’en va pas. La page que tu vois vient alors de la copie enregistrée dans le navigateur, pas du NAS. C’est en général le certificat : le navigateur refuse la connexion et n’arrive jamais à te montrer son propre avertissement, qui est le seul écran depuis lequel on peut l’accepter. Dans le message lui-même, tu as le bouton **« Entrer sans la copie enregistrée »**, qui efface cette copie et recharge ; l’avertissement de certificat habituel apparaît alors.

2. J’entre, mais une application dit que je n’y ai pas accès

Ce n’est pas une panne : c’est la répartition des applications. Chaque compte a les siennes, avec un niveau — regarder, ou regarder et modifier —, et celui qui décide, c’est le NAS, pas l’icône.

La personne qui administre le change dans Panneau de configuration → Utilisateurs et groupes → le compte → Applications. Tout est expliqué dans Utilisateurs, autorisations et ce que voit chacun.

Deux choses qui déroutent :

• L’icône n’est plus là. Quand on retire une application, elle disparaît aussi du bureau et de la recherche de ce compte. Elle n’a pas été désinstallée : elle n’est pas à lui.
• Je peux le voir mais pas le modifier. C’est le niveau « voir ». Les boutons qui modifient n’apparaissent pas. Dans Caméras, Sauvegardes et Stockage, c’est le maximum qu’on peut donner à un compte qui n’administre pas.

3. Je ne vois pas le NAS depuis Windows, Mac ou mon téléphone

Dans l’ordre, du plus courant au moins courant :

1. Ce compte a-t-il accès au dossier ? Partager un dossier et donner accès à quelqu’un, ce sont deux choses différentes : `Panneau de configuration → Dossiers de la maison → le dossier → Autorisations`.
2. Le protocole est-il activé ? SMB, NFS et WebDAV s’activent séparément dans Panneau de configuration → Services de fichiers, et il faut en plus le cocher **dans chaque dossier**.
3. Le mot de passe SMB n’est pas celui du panneau si tu ne l’as jamais défini. À la création du compte, les deux sont définis en même temps, mais changer l’un ne change pas l’autre.
4. Tape l’adresse à la main au lieu d’attendre qu’elle apparaisse toute seule : sous Windows \\192.168.1.50, sur Mac smb://192.168.1.50. La découverte automatique du réseau est la première chose qui lâche, et ça ne veut rien dire.
5. Il ne manque que « Mon disque » ? Il a sa propre ligne dans `Panneau de configuration → Dossiers de la maison` : s’il est désactivé, ou sans le protocole que tu utilises, il n’apparaît pas. En NFS, en plus, seuls les dispositifs de sa liste peuvent le monter.

Tous les détails, dispositif par dispositif, dans Connecter tes dispositifs au NAS.

4. C’est lent

Avant de toucher à quoi que ce soit, regarde qui est en train de travailler : Moniteur affiche le processeur, la mémoire, le réseau et les disques en direct. Avec ça, trois cas :

• Les disques à 100 % et tout le reste calme. C’est presque toujours un scrub, une sauvegarde ou l’indexation des photos. Ça se termine et ça passe ; dans Stockage et dans Sauvegardes, on voit ce qui est en cours.
• Le réseau au maximum. Quelqu’un est en train de copier quelque chose, ou un torrent est en train d’envoyer. Les limites de vitesse des téléchargements sont dans leur propre app.
• Tout est calme et c’est quand même lent. Si c’est un torrent, regarde l’alerte du port dans l’app Téléchargements : avec le port fermé, tu ne télécharges que depuis les pairs que tu contactes toi-même, et c’est une fraction de la vitesse. Si c’est du SMB, essaie de copier un gros fichier plutôt que beaucoup de petits : mille fichiers de 10 Ko, ce sont mille conversations, et c’est lent sur n’importe quel NAS.

5. Un disque renvoie des erreurs

Ne le débranche pas tout de suite. Avec du RAID, retirer le mauvais disque transforme un problème en perte.

1. Stockage → Protection → Santé et chiffrement dit de quel disque il s’agit et ce qu’il a (SMART). Note son numéro de série, c’est la seule chose qui ne bouge pas ; la lettre (sda, sdb) peut changer au redémarrage.
2. Si le volume fonctionne encore, fais une sauvegarde maintenant, avant de toucher à quoi que ce soit. Un disque qui commence à lâcher tient en général quelques heures.
3. Le remplacement se fait depuis le panneau et il est expliqué pas à pas dans [Reprise après sinistre](disaster-recovery.md).

6. J’ai fait une mise à jour et quelque chose ne va pas

lgm log et lgm progress racontent ce qui s’est passé pendant la dernière mise à jour.

• Le panneau ne revient pas. L’outil de mise à jour garde une copie des unités avant d’y toucher, justement pour ça. systemctl status nas-backend dira s’il ne démarre pas, et lgm log en donnera la raison.
• Une tâche critique à moitié faite. Si une restauration ou une sauvegarde est en cours, la mise à jour refuse de commencer. C’est voulu.

Revenir à la version précédente

Si une nouvelle version te casse quelque chose et que tu ne peux pas attendre la correction, dans Panneau de configuration → Mettre à jour LGM-OS il y a un bouton « Revenir à la X » avec la version d’avant la dernière mise à jour. Il ramène le panneau à cette version en une minute ; tes données et tes réglages restent tels quels et les applications continuent de tourner. La version retirée ne se réinstalle pas toute seule : quand tu le voudras, « Installer quand même ». Le bouton n’apparaît pas si la mise à jour a changé la forme des réglages (la version précédente ne les comprendrait pas) ; le panneau le dit.

7. Le disque est plein

La première chose est de savoir de quel disque on parle : celui du système et celui des données sont différents et se règlent différemment.

• Le volume de données. Panneau de configuration → Rapport d’espace montre où part l’espace du disque, ainsi que les doublons. Attention aux instantanés : ce que tu supprimes continue d’occuper de la place tant qu’un instantané s’en souvient.
• Le disque système. Il se remplit de journaux, d’images Docker et de téléchargements mal placés. Le bouton Faire de la place du Centre de paquets — qui supprime les images et les volumes que plus personne n’utilise — et la corbeille sont les deux premiers endroits où regarder.

8. Comment demander de l’aide avec des données

Dans Panneau de configuration → Vérification du système, il y a un bouton, Télécharger le rapport pour l’assistance, qui télécharge un fichier avec tout ce qu’il faut pour comprendre ce qui arrive au dispositif : la version, le déroulement de la dernière mise à jour, la vérification des services, les disques, le réseau, les applications Docker, les alertes et les dernières lignes du journal du panneau (5 000 au maximum, de la dernière journée). Le préparer peut prendre une minute. Envoie-le tel quel à la personne qui t’aide ; c’est ce qui évite les dix questions-réponses. Il ne contient pas de mots de passe : ni ceux des comptes du NAS, ni ceux des caméras, ni ceux des clouds. Les champs qui les contiennent apparaissent sous la forme [oculto].

Si tu préfères regarder toi-même depuis la console :

lgm info      # version, dispositif et adresse
lgm log       # le journal du panneau
systemctl status nas-backend nas-helper

Et la partie Tests réseau de la Vérification propose les tests réseau — résoudre un nom, sortir sur internet, voir si un port répond — sans quitter le navigateur.

⚠️ Avant de coller un journal où que ce soit, lis-le. Le panneau efface les mots de passe des messages qu’il affiche, mais un journal du système appartient au système et peut contenir des adresses internes ou les noms de tes dossiers.

9. « Le réglage … était endommagé »

Les réglages du panneau vivent dans des fichiers de /var/nas/state, un par thème : users.json pour les comptes, shared_folders.json pour les dossiers de la maison, et ainsi de suite. Si l’un d’eux ne peut pas être lu, le panneau ne plante pas : il le met de côté sous le nom <nom>.json.corrupt, continue avec les valeurs par défaut pour cette partie et te prévient avec « Le réglage « … » était endommagé ». Ce que tu remarques dépend duquel il s’agit :

⚠️ Tant que tu ne l’as pas récupéré, ne crée et ne modifie rien dans cette partie du panneau : tu enregistrerais les valeurs par défaut par-dessus. Avec shared_folders mis de côté, créer un dossier ne publierait plus que celui-là.

Presque toujours, le fichier est en bon état. Jusqu’à la 2.0.4, une lecture ratée mettait de côté des fichiers qui étaient parfaits sur le disque. Depuis la 2.0.4, ça n’arrive plus, et au démarrage le panneau remet tout seul ceux qui se lisent correctement : tu verras « Le réglage « … » s’est rétabli tout seul ».

9.1 Le récupérer

Par SSH, ou avec un écran et un clavier branchés au NAS :

1. Avec une version antérieure à la 2.0.4, mets à jour. Au démarrage de la nouvelle version, il est remis en place tout seul, et il n’y a rien d’autre à faire :

sudo lgm update

1. Si tu as déjà la 2.0.4 ou une version ultérieure, redémarre le panneau ; au démarrage, il examine les fichiers mis de côté :

sudo systemctl restart nas-backend

1. À la main, sans mettre à jour ni redémarrer. Colle tout ceci. Ça remet en place chaque fichier mis de côté qui est un réglage valide, n’écrase pas un réglage qui a déjà été réenregistré et ne touche pas à ceux qui sont vraiment cassés :

sudo python3 - <<'EOF'
import glob, json, os
d = "/var/nas/state"
for apartado in sorted(glob.glob(d + "/*.json.corrupt")):
    nombre = os.path.basename(apartado)[:-len(".json.corrupt")]
    destino = f"{d}/{nombre}.json"
    if os.path.exists(destino):
        print(f"- {nombre}: ya hay uno nuevo, no se toca"); continue
    try:
        doc = json.loads(open(apartado, "rb").read().decode("utf-8"))
    except Exception as e:
        print(f"- {nombre}: roto de verdad, se deja ({e})"); continue
    if not isinstance(doc, dict):
        print(f"- {nombre}: no tiene forma de ajuste, se deja"); continue
    st = os.stat(apartado)
    tmp = destino + ".reponiendo"
    with open(tmp, "wb") as f:
        f.write(json.dumps(doc, indent=2, ensure_ascii=False).encode("utf-8")); f.flush(); os.fsync(f.fileno())
    os.chown(tmp, st.st_uid, st.st_gid); os.chmod(tmp, 0o600); os.replace(tmp, destino)
    print(f"+ {nombre}: repuesto")
EOF

Chaque ligne avec + est un réglage remis en place (le script le marque avec « repuesto »), et ça se voit tout de suite : avec users, on peut déjà se connecter.

9.2 S’il est vraiment cassé

Si l’étape 3 affiche « roto de verdad » (vraiment cassé), le contenu du fichier est inutilisable et il faut le reprendre de la sauvegarde de la configuration.

• Tu peux entrer dans le panneau (le fichier cassé n’est pas users) : Panneau de configuration → Sauvegarde de la configuration → « Restaurer depuis un fichier… ».
• Tu ne peux pas entrer (le fichier cassé est users) : on le reprend de la sauvegarde par SSH. D’abord, la plus récente :

sudo find /mnt /srv -name 'nas-config-*.tar.gz' -printf '%T+ %p\n' 2>/dev/null | sort | tail -3

Et de celle-ci, uniquement ce réglage (remplace le chemin par celui qui est apparu au-dessus) :

COPIA=/mnt/tank/backups/nas-config-XXXX.tar.gz
sudo tar -xzf "$COPIA" -C /tmp state/users.json
sudo install -o "$(stat -c %U /var/nas/state)" -g "$(stat -c %G /var/nas/state)" -m 600 \
  /tmp/state/users.json /var/nas/state/users.json
sudo rm -rf /tmp/state

• Sans sauvegarde des comptes : redémarre le panneau (sudo systemctl restart nas-backend). Sans comptes, l’assistant du premier démarrage revient ; il demande le code d’activation, qui ne s’affiche que sur l’écran du NAS lui-même ou avec sudo lgm alta. Crée l’administrateur et recrée les autres comptes. Tes fichiers et tes dossiers ne sont pas touchés.

10. Une alerte d’erreurs sur le bus PCIe

Le NAS surveille le bus PCIe, par où les disques NVMe, les contrôleurs de disques, les cartes réseau et la carte graphique parlent à la carte mère, et prévient dès que l’un d’eux commence à donner des erreurs, en disant lequel.

• « Erreurs corrigées sur le bus PCIe » : le système les a corrigées et pour l’instant rien ne se perd. Si l’alerte se répète et que le compte continue de grimper, c’est en général un contact desserré ou un appareil qui commence à lâcher : éteins le NAS et remets-le bien dans son emplacement.
• « Erreurs sur le bus PCIe » : des erreurs que le système n’a pas pu corriger. C’est en général un appareil mal enfoncé, qui chauffe ou qui commence à lâcher. Si c’est un disque, sauvegarde tout de suite ce qui compte ; ensuite éteins le NAS, remets bien l’appareil en place et vérifie qu’il reçoit de l’air.

11. Les clés du panneau et la puce TPM

Les clés que le panneau garde pour fonctionner — celle du VPN, du DNS dynamique, de l’onduleur et d’autres — sont enregistrées chiffrées avec la puce TPM 2.0 de la carte mère si l’appareil en a une. Il n’y a rien à activer, et sur un appareil sans puce elles sont enregistrées comme toujours.

Si un jour la puce ne les ouvre plus, le NAS démarre quand même et prévient avec « La puce de sécurité n’ouvre pas les secrets du panneau ». Ça arrive en général après un changement de carte mère ou un effacement du TPM dans le BIOS. En attendant, le VPN, le DNS dynamique et tout ce qui utilise ces clés ne fonctionne pas.

• Rien n’est perdu. Connecte-toi au panneau avec un compte administrateur en tapant son mot de passe, et les clés sont récupérées toutes seules. L’alerte « Secrets du panneau récupérés » le confirme.
• Si la puce fonctionne, elles sont de nouveau enregistrées avec elle ; si l’appareil n’a plus de puce qui fonctionne, elles sont enregistrées comme avant, sans elle.

Voir aussi

• Reprise après sinistre — quand quelque chose de grave est déjà arrivé.
• Utilisateurs, autorisations et ce que voit chacun — presque tout ce qui relève du « je ne peux pas voir ça ».
• Glossaire — ce que veut dire chaque mot bizarre qui apparaît ici.