Discussion:CUPS : Différence entre versions
De Asso Val Libre
(Page créée avec « == Déboguer le fonctionnement de CUPS sous Debian 12 == Pour diagnostiquer et corriger les problèmes liés à CUPS (Common UNIX Printing System) sur Debian 12, suivez l... ») |
|||
| (6 révisions intermédiaires par le même utilisateur non affichées) | |||
| Ligne 1 : | Ligne 1 : | ||
| − | == Déboguer le fonctionnement de CUPS sous Debian 12 == | + | == Déboguer le fonctionnement de CUPS sous Debian 12 (perplexity) == |
Pour diagnostiquer et corriger les problèmes liés à CUPS (Common UNIX Printing System) sur Debian 12, suivez les étapes ci-dessous. | Pour diagnostiquer et corriger les problèmes liés à CUPS (Common UNIX Printing System) sur Debian 12, suivez les étapes ci-dessous. | ||
| − | === | + | === Consulter le fichier de log principal de CUPS === |
Le fichier principal de log se trouve ici : | Le fichier principal de log se trouve ici : | ||
| Ligne 10 : | Ligne 10 : | ||
Ce fichier enregistre toutes les opérations, erreurs et avertissements de CUPS, y compris les problèmes de filtres et de communication avec l’imprimante. | Ce fichier enregistre toutes les opérations, erreurs et avertissements de CUPS, y compris les problèmes de filtres et de communication avec l’imprimante. | ||
| − | === | + | === Activer le mode debug pour plus d’informations === |
Par défaut, le niveau de log est souvent réglé sur warn. Pour obtenir plus de détails, activez le mode debug : | Par défaut, le niveau de log est souvent réglé sur warn. Pour obtenir plus de détails, activez le mode debug : | ||
| Ligne 16 : | Ligne 16 : | ||
* Pour activer le debug logging : | * Pour activer le debug logging : | ||
| − | sudo cupsctl --debug-logging | + | sudo cupsctl --debug-logging |
* Pour un niveau de détail maximal : | * Pour un niveau de détail maximal : | ||
| − | sudo cupsctl LogLevel=debug2 | + | sudo cupsctl LogLevel=debug2 |
* Pour revenir au niveau par défaut : | * Pour revenir au niveau par défaut : | ||
| − | sudo cupsctl --no-debug-logging | + | sudo cupsctl --no-debug-logging |
CUPS redémarre automatiquement après ces commandes. | CUPS redémarre automatiquement après ces commandes. | ||
| − | === | + | === Modifier manuellement le niveau de log dans cupsd.conf === |
Vous pouvez aussi éditer le fichier /etc/cups/cupsd.conf et modifier la ligne : | Vous pouvez aussi éditer le fichier /etc/cups/cupsd.conf et modifier la ligne : | ||
| − | LogLevel warn | + | LogLevel warn |
| − | + | ||
par | par | ||
| − | LogLevel debug | + | LogLevel debug |
ou | ou | ||
| − | LogLevel debug2 | + | LogLevel debug2 |
Après modification, redémarrez CUPS : | Après modification, redémarrez CUPS : | ||
| − | sudo systemctl restart cups | + | sudo systemctl restart cups |
| + | sudo systemctl restart cups-browsed | ||
| − | + | === Analyser le fichier error_log === | |
| − | === | ||
Ouvrez et analysez /var/log/cups/error_log. Recherchez les mots-clés tels que : error, failed, filter, JobCompleted, JobProgress. | Ouvrez et analysez /var/log/cups/error_log. Recherchez les mots-clés tels que : error, failed, filter, JobCompleted, JobProgress. | ||
| − | === | + | === Tester la communication avec l’imprimante === |
Pour vérifier si le problème vient du backend ou de la connexion, envoyez un fichier prêt à être imprimé directement à l’imprimante : | Pour vérifier si le problème vient du backend ou de la connexion, envoyez un fichier prêt à être imprimé directement à l’imprimante : | ||
| − | lp -d -o raw | + | lp -d -o raw |
Cela permet de contourner la chaîne de filtres et d’isoler le problème. | Cela permet de contourner la chaîne de filtres et d’isoler le problème. | ||
| − | === | + | === Vérifier la détection des périphériques === |
Pour lister les périphériques détectés par CUPS : | Pour lister les périphériques détectés par CUPS : | ||
| − | /usr/sbin/lpinfo -v | + | /usr/sbin/lpinfo -v |
Cela permet de vérifier si l’imprimante est bien détectée par le système et par CUPS. | Cela permet de vérifier si l’imprimante est bien détectée par le système et par CUPS. | ||
| − | === | + | === Problèmes de permissions ou de drivers === |
Si l’imprimante n’apparaît pas ou ne fonctionne pas, vérifiez les permissions sur les périphériques USB et le choix du driver (PPD). Pour certains modèles HP, privilégiez le driver hpcups plutôt que hpijs. | Si l’imprimante n’apparaît pas ou ne fonctionne pas, vérifiez les permissions sur les périphériques USB et le choix du driver (PPD). Pour certains modèles HP, privilégiez le driver hpcups plutôt que hpijs. | ||
| Ligne 96 : | Ligne 96 : | ||
* Désactiver le mode debug après le diagnostic pour éviter des fichiers logs trop volumineux. | * Désactiver le mode debug après le diagnostic pour éviter des fichiers logs trop volumineux. | ||
* Si le log ne donne pas d’indication claire, vérifier la configuration réseau, les permissions, et la compatibilité du driver utilisé. | * Si le log ne donne pas d’indication claire, vérifier la configuration réseau, les permissions, et la compatibilité du driver utilisé. | ||
| + | |||
| + | {{Mémo}} | ||
Version actuelle en date du 9 juin 2025 à 10:23
Sommaire
- 1 Déboguer le fonctionnement de CUPS sous Debian 12 (perplexity)
- 1.1 Consulter le fichier de log principal de CUPS
- 1.2 Activer le mode debug pour plus d’informations
- 1.3 Modifier manuellement le niveau de log dans cupsd.conf
- 1.4 Analyser le fichier error_log
- 1.5 Tester la communication avec l’imprimante
- 1.6 Vérifier la détection des périphériques
- 1.7 Problèmes de permissions ou de drivers
- 1.8 Résumé des commandes utiles
- 1.9 Bonnes pratiques
Déboguer le fonctionnement de CUPS sous Debian 12 (perplexity)
Pour diagnostiquer et corriger les problèmes liés à CUPS (Common UNIX Printing System) sur Debian 12, suivez les étapes ci-dessous.
Consulter le fichier de log principal de CUPS
Le fichier principal de log se trouve ici : /var/log/cups/error_log
Ce fichier enregistre toutes les opérations, erreurs et avertissements de CUPS, y compris les problèmes de filtres et de communication avec l’imprimante.
Activer le mode debug pour plus d’informations
Par défaut, le niveau de log est souvent réglé sur warn. Pour obtenir plus de détails, activez le mode debug :
- Pour activer le debug logging :
sudo cupsctl --debug-logging
- Pour un niveau de détail maximal :
sudo cupsctl LogLevel=debug2
- Pour revenir au niveau par défaut :
sudo cupsctl --no-debug-logging
CUPS redémarre automatiquement après ces commandes.
Modifier manuellement le niveau de log dans cupsd.conf
Vous pouvez aussi éditer le fichier /etc/cups/cupsd.conf et modifier la ligne :
LogLevel warn
par
LogLevel debug
ou
LogLevel debug2
Après modification, redémarrez CUPS :
sudo systemctl restart cups sudo systemctl restart cups-browsed
Analyser le fichier error_log
Ouvrez et analysez /var/log/cups/error_log. Recherchez les mots-clés tels que : error, failed, filter, JobCompleted, JobProgress.
Tester la communication avec l’imprimante
Pour vérifier si le problème vient du backend ou de la connexion, envoyez un fichier prêt à être imprimé directement à l’imprimante :
lp -d -o raw
Cela permet de contourner la chaîne de filtres et d’isoler le problème.
Vérifier la détection des périphériques
Pour lister les périphériques détectés par CUPS :
/usr/sbin/lpinfo -v
Cela permet de vérifier si l’imprimante est bien détectée par le système et par CUPS.
Problèmes de permissions ou de drivers
Si l’imprimante n’apparaît pas ou ne fonctionne pas, vérifiez les permissions sur les périphériques USB et le choix du driver (PPD). Pour certains modèles HP, privilégiez le driver hpcups plutôt que hpijs.
Résumé des commandes utiles
| Action | Commande |
|---|---|
| Activer debug logging | sudo cupsctl --debug-logging |
| Activer debug2 logging | sudo cupsctl LogLevel=debug2 |
| Désactiver debug logging | sudo cupsctl --no-debug-logging |
| Redémarrer CUPS | sudo systemctl restart cups |
| Voir les logs | sudo less /var/log/cups/error_log |
| Lister les périphériques | sudo /usr/sbin/lpinfo -v |
| Tester impression brute | lp -d <queue> -o raw <fichier_prêt_impression> |
Bonnes pratiques
- Toujours reproduire le problème après avoir activé le mode debug pour obtenir des logs pertinents.
- Désactiver le mode debug après le diagnostic pour éviter des fichiers logs trop volumineux.
- Si le log ne donne pas d’indication claire, vérifier la configuration réseau, les permissions, et la compatibilité du driver utilisé.
