Discussion:CUPS - Historique des versions

Admin le 9 juin 2025 à 08:23

2025-06-09T08:23:39Z

Admin : /* Déboguer le fonctionnement de CUPS sous Debian 12 (perplexity) */

2025-06-09T08:20:51Z

‎Déboguer le fonctionnement de CUPS sous Debian 12 (perplexity)

Admin : /* 5. Tester la communication avec l’imprimante */

2025-06-09T08:19:49Z

‎5. Tester la communication avec l’imprimante

Admin le 9 juin 2025 à 08:19

2025-06-09T08:19:30Z

Admin : /* 3. Modifier manuellement le niveau de log dans cupsd.conf */

2025-06-09T08:19:17Z

‎3. Modifier manuellement le niveau de log dans cupsd.conf

Admin : /* 2. Activer le mode debug pour plus d’informations */

2025-06-09T08:18:45Z

‎2. Activer le mode debug pour plus d’informations

Admin le 9 juin 2025 à 08:18

2025-06-09T08:18:17Z

Admin : 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... »

2025-06-09T08:17:44Z

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

Nouvelle page

== 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 les étapes ci-dessous.

=== 1. 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.

=== 2. 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.

=== 3. 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

=== 4. 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.

=== 5. 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.

=== 6. 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.

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

{| class="wikitable"
! 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é.

← Version précédente		Version du 9 juin 2025 à 08:19
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.

← Version précédente		Version du 9 juin 2025 à 08:18
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}}

@@ Ligne 67 : / Ligne 67 : @@
 Cela permet de vérifier si l’imprimante est bien détectée par le système et par CUPS.
-=== 7. Problèmes de permissions ou de drivers ===
+=== 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.

@@ Ligne 3 : / Ligne 3 : @@
 Pour diagnostiquer et corriger les problèmes liés à CUPS (Common UNIX Printing System) sur Debian 12, suivez les étapes ci-dessous.
-=== 1. Consulter le fichier de log principal de CUPS ===
+=== Consulter le fichier de log principal de CUPS ===
 Le fichier principal de log se trouve ici&nbsp;:
@@ 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.
-=== 2. Activer le mode debug pour plus d’informations ===
+=== 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&nbsp;:
@@ Ligne 28 : / Ligne 28 : @@
 CUPS redémarre automatiquement après ces commandes.
-=== 3. Modifier manuellement le niveau de log dans cupsd.conf ===
+=== Modifier manuellement le niveau de log dans cupsd.conf ===
 Vous pouvez aussi éditer le fichier /etc/cups/cupsd.conf et modifier la ligne&nbsp;:
@@ Ligne 47 : / Ligne 47 : @@
    sudo systemctl restart cups-browsed
-=== 4. Analyser le fichier error_log ===
+=== Analyser le fichier error_log ===
 Ouvrez et analysez /var/log/cups/error_log. Recherchez les mots-clés tels que&nbsp;: error, failed, filter, JobCompleted, JobProgress.
@@ Ligne 59 : / Ligne 59 : @@
 Cela permet de contourner la chaîne de filtres et d’isoler le problème.
-=== 6. Vérifier la détection des périphériques ===
+=== Vérifier la détection des périphériques ===
 Pour lister les périphériques détectés par CUPS&nbsp;:
-/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.

@@ Ligne 51 : / Ligne 51 : @@
 Ouvrez et analysez /var/log/cups/error_log. Recherchez les mots-clés tels que&nbsp;: error, failed, filter, JobCompleted, JobProgress.
-=== 5. Tester la communication avec l’imprimante ===
+=== 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&nbsp;:
-lp -d  -o raw
+  lp -d  -o raw
 Cela permet de contourner la chaîne de filtres et d’isoler le problème.

@@ Ligne 32 : / Ligne 32 : @@
 Vous pouvez aussi éditer le fichier /etc/cups/cupsd.conf et modifier la ligne&nbsp;:
-LogLevel warn
+  LogLevel warn
-−
 par
-LogLevel debug
+  LogLevel debug
 ou
-LogLevel debug2
+  LogLevel debug2
 Après modification, redémarrez CUPS&nbsp;:
-sudo systemctl restart cups
+  sudo systemctl restart cups
+  sudo systemctl restart cups-browsed
 === 4. Analyser le fichier error_log ===

@@ Ligne 16 : / Ligne 16 : @@
 * Pour activer le debug logging&nbsp;:
-sudo cupsctl --debug-logging
+  sudo cupsctl --debug-logging
 * Pour un niveau de détail maximal&nbsp;:
-sudo cupsctl LogLevel=debug2
+  sudo cupsctl LogLevel=debug2
 * Pour revenir au niveau par défaut&nbsp;:
-sudo cupsctl --no-debug-logging
+  sudo cupsctl --no-debug-logging
 CUPS redémarre automatiquement après ces commandes.