Dépannage et debugging

1. Le service a échoué

Problème rencontré

Lors de l’administration de votre serveur, vous avez peut-être constaté l’échec de l’un de vos services, soit en consultant la liste des services démarrés, soit en remarquant qu’une tâche planifiée ne s’exécute pas ou plus.

Illustrons cette situation par un exemple réel de service personnalisé en échec.

Situation dans laquelle cela se produit

Un service personnalisé chargé de la rotation des archives ne s’exécute pas. Un nombre important d’archives (542) est en effet visible dans leur répertoire de stockage, ce qui occupe également un espace disque non négligeable :

alex@mysrv:~$ ls -lh /home/alex/backup/old/ | wc -l 
542 
alex@mysrv:~$ ls -lh backup/old/ 
total 182M 
[...]  

Sans intervention rapide, plusieurs gigaoctets d’espace disque pourraient être occupés inutilement au bout de quelques mois.

Si nous ne nous souvenons pas du nom du service concerné, il suffit de répertorier l’ensemble des services, quel que soit leur état :

alex@mysrv:~$ systemctl list-units --type=service --all  

Nous trouvons alors le service qui nous intéresse, à condition de lui avoir attribué un nom et une description explicites :

UNIT                         LOAD    ACTIVE  SUB       
custom_backup_rotation.service   loaded  failed  failed  

Examinons-le plus en détail :

alex@mysrv:~$ systemctl status custom_backup_rotation.service 
× custom_backup_rotation.service 
     Loaded: loaded (/etc/systemd/system/custom_backup_rotation.service; static) 
     Active: failed (Result: exit-code) since Tue 2025-09-16 21:10:03 CEST; 22h ago 
   Duration: 6ms 
TriggeredBy: ● custom_backup_rotation.timer 
   Main PID: 2445464 (code=exited, status=127) 
        CPU: 4ms  

Consultons le fichier qui définit ce service :

alex@mysrv:~$ sudo systemctl cat custom_backup_rotation.service ...

1. PHP

Problème rencontré

L’un de nos sites s’affiche avec des erreurs ou présente du contenu manquant.

Situation dans laquelle cela se produit

Le problème est visible dans le navigateur du client. Le serveur peut également renvoyer un code HTTP 500.

Signification

Nous savons que le site concerné, qui utilise PHP, est relativement ancien. Il a initialement été développé avec PHP 7.3, tandis que le serveur utilise PHP 8.2. Il est donc probable que certaines fonctions employées ne soient plus compatibles avec cette version.

Le détail des erreurs peut être consulté dans les fichiers journaux du site :

tail -3 /var/www/site1/logs/error.log 
[...] 
PHP Warning:  preg_match_all(): Compilation failed: invalid range in character class at offset 4 in /var/www/site1/html/contents/simple_html_dom.php on line 690, 
[...] 

Résolution

Plusieurs solutions sont possibles. Elles sont présentées ci-dessous par ordre de préférence :

Adapter le code afin qu’il fonctionne avec PHP 8.2. Si la quantité de code source à modifier est limitée, cette solution est à privilégier.

Remplacer PHP 8.2 par PHP 7.3, au risque de rendre incompatibles les autres sites, plus récents.

Installer PHP 7.3 en parallèle de PHP 8.2. Cette solution, plus simple à mettre en œuvre à court terme, n’est pas détaillée dans cet ouvrage.

Déplacer le site concerné vers un serveur dédié à cet usage. Cette solution implique toutefois de maintenir un deuxième serveur.

2. Apache - 1

Problème...

1. Cas 1

Problème rencontré

SSH n’accepte pas notre clé publique.

Situation dans laquelle cela se produit

Même après avoir copié la clé publique sur le serveur, celui-ci ne l’accepte pas. Nous devons alors nous authentifier avec le mot de passe du compte distant :

alex@y510p:~$ ssh alex@srvtest 
alex@srvtest's password:  

Sur le serveur, suivons en temps réel le journal du service SSH, puis tentons simultanément une nouvelle connexion depuis le client :

alex@srvtest:~$ sudo journalctl -u ssh.service --since today -f 
[...] 
Oct 03 19:00:32 srvtest sshd[1308]: Authentication refused: 
bad ownership or modes for directory /home/alex  

Signification

Le message indique que l’authentification est refusée en raison d’un problème sur les droits d’accès au répertoire personnel de l’utilisateur alex.

Vérifions les droits d’accès sur ce répertoire :

alex@srvtest:~$ ls -lhd 
drwxrwx--- 4 alex sambashare 4.0K Oct  3 18:59 .  

On remarque que le groupe propriétaire n’est pas le groupe principal de alex comme le montre la commande suivante et que les droits du groupe sont peut-être un peu trop élevés :

alex@srvtest:~$ groups 
alex cdrom floppy sudo audio dip video plugdev users netdev 
bluetooth sambashare  

Résolution

Méthode 1 :

Attribuer...

1. Erreur lors de la création ou du renouvellement du certificat TLS

Problème rencontré

Certbot ne parvient pas à créer ou à renouveler un certificat TLS.

Situation dans laquelle cela se produit

Vous utilisez certbot pour obtenir un certificat TLS, mais la commande renvoie une erreur :

Signification

Le nom d’hôte www.test2.fosslab.fr ne semble pas être résolu par le DNS.

Dans le navigateur, saisissons www.test2.fosslab.fr. Une erreur s’affiche à la place du site :

En revanche, l’accès au site avec le nom d’hôte test2.fosslab.fr fonctionne correctement.

Le problème concerne donc uniquement le nom d’hôte www.test2.fosslab.fr.

Résolution

Si ce nom d’hôte ne doit pas être utilisé, retirez www.test2.fosslab.fr de la configuration de l’hôte virtuel (VHOST) et de la demande de certificat. S’il doit être conservé, créez auparavant l’enregistrement DNS correspondant et vérifiez qu’il pointe vers le serveur.

Après cette correction, certbot ne renvoie plus d’erreur :

2. Erreur lors du renouvellement automatique

Problème rencontré

Le renouvellement automatique d’un certificat TLS échoue.

Situation dans laquelle cela se produit

Le service chargé du renouvellement automatique des certificats est en échec...

1. Préalable

Branchez au serveur un second disque disposant d’un espace libre au moins égal à la taille totale du disque contenant les données perdues. Ce second support accueillera l’image du disque à analyser.

Travaillez de préférence à froid : n’amorcez pas le système installé sur le disque à récupérer. Utilisez un système live démarré depuis une clé USB ou connectez le disque concerné à une autre machine disposant de la capacité de stockage nécessaire ou reliée au second disque.

Dans la suite de la procédure, le disque contenant les données à récupérer est appelé disque 1 ; le support destiné à recevoir son image est appelé disque 2.

2. Création d’une image du disque à récupérer

Nous allons créer sur le disque 2 une copie du disque 1. Cette image, enregistrée dans un fichier, reproduira l’ensemble du disque source. Pour réaliser cette opération, nous utiliserons la commande dd, déjà présentée dans cet ouvrage.

Cette copie permet d’effectuer les opérations de récupération sur l’image plutôt que directement sur le disque 1. Nous limitons ainsi les accès...