PaperCut MF - Diagnostiquer un problème d'impression

Schéma de fonctionnement (virtuelle / find-me)

Premières vérification

Le Log PaperCut
Les travaux en attente
Le Print Provider
Pare-feu (Firewall) / Réseau

Protocoles de test

Tester l'accès au serveur depuis le poste utilisateur
Tester la file directe hors PaperCut (sur le serveur d'impression)
Tester la file directe avec PaperCut  (sur le serveur d'impression)
Tester la file virtuelle  (sur le serveur d'impression)
Tester avec le driver générique PaperCut.
Comment tester sans accès physique au périphérique ?

Vérifier la configuration de base

Configuration de la file directe (PaperCut)
Configuration de la file virtuelle (PaperCut)
Configuration du périphérique

Activer/Récupérer les logs

Serveur d'application PaperCut MF
PaperCut Print Provider (fournisseur d'impression) sur Windows
Logs Windows

Ressources PaperCut

Impression avec rétention / libération périphérique / file virtuelle / find-me (diagramme de séquence) :

Le Log PaperCut

Le Log PaperCut affiche un état des travaux, si une impression ne sort pas car elle a été refusée par PaperCut, le motif de suppression apparaîtra ici :

Les travaux en attente

Pour s'assurer qu'un travail ait bien été pris en compte par PaperCut, il peut être pertinent de vérifier les travaux en attente, depuis le menu Imprimantes → Travaux en attente :

Si les jobs n'apparaissent pas, il est probable que le poste utilisateur ne parvienne pas à contacter le serveur, ou que la file d'impression utilisée n'effectue pas de rétention. Voir config de la file virtuelle

Le Print Provider

Le service PaperCut Print Provider doit être installé sur le serveur hébergeant les files d'impression, celui-ci est nécessaire au monitoring des files, et aux interactions avec les travaux d'impression (Stopper, Rediriger, Libérer, ou Annuler) .

Le compte de service utilisé pour le PaperCut Print Provider doit avoir le droit d'imprimer sur le périphérique de destination. Pour l'impression inter-serveur, une relation d'approbation doit être mise en place pour ce compte de service.

Pare-feu (Firewall) / Réseau :

Le service PaperCut Print Provider (fournisseur d'impression) utilisé les ports TCP/IP autorisés par le Spouleur Windows. Les services d'impression Windows utilisent les ports dynamiques 49152 a 65535.

Redirection inter-serveurs (cross-server redirection) :

• 49152-65535 TCP
• 445 TCP (SMB)
• 135 TCP (RCP) (peut causer des erreurs  0×0000011b et 0×0000007c  quand bloqué)

Avec NetBios :

• 137/138 UDP, Name and Datagram Services
• 139 TCP, Session Services

Protocoles de test

Ces tests nécessitent un accès au serveur hébergeant la file d'impression à tester. Il est vivement recommandé de créer de nouvelles files de tests afin de limiter les impacts sur la production.

Tester l'accès au serveur depuis le poste utilisateur

Séquence :

Note : non applicable à Print Deploy / Mobility Print / PaperCut Hive

Comment reproduire ?

Un problème dans cette séquence s'observe lorsqu'un utilisateur soumet un job pour l'impression, s'authentifie sur le périphérique, mais qu'aucun document n'apparaît.

Comment tester ?

1. Mettre en pause la file directe au niveau du serveur : 

2 . Imprimer un document sur cette file depuis le poste utilisateur

3. Le job devrait arriver dans la file d'attente de l'imprimante et dans les travaux en attente.

→ Si le job n'arrive pas sur le serveur, vérifier la configuration de la file, du partage, du réseau, et les Logs Windows du poste utilisateur et du serveur.

→ Si le job arrive sur le serveur, retirer la mise en pause de la file, le job devrait disparaître. S'il ne disparaît pas, ou disparaît sans s'imprimer, passer au test de la file directe.

Tester la file directe hors PaperCut (sur le serveur d'impression)

Séquence :

Comment reproduire ?

Un problème à ce niveau est détectable quand l'utilisateur observe le job à libérer sur l'écran du périphérique, demande sa libération, mais rien ne s'imprime.

Comment tester ?

1. Arrêter le service PaperCut Print Provider (attention, cause une coupure de production PaperCut)

2. Mettre la file d'impression directe en pause

3. Imprimer un document depuis le serveur vers cette file (choisir un document ayant rencontré le problème).
4. S'assurer que le document apparaisse correctement dans la file.
5. Reprendre l'impression (retirer la pause de la file).
6. Le document devrait disparaître de la file.

→ Si le document s'imprime correctement, passer au test de la file avec PaperCut.
→ Si le document est apparu et a disparu de la file, mais ne s'imprime pas, passer au test du driver.
→ Si le document n'est pas apparu dans la file (étape 4), revérifier la configuration de la file, et passer au test du driver.

Tester la file directe avec PaperCut  (sur le serveur d'impression)

1. Démarrer le service PaperCut Print Provider (cela peut prendre quelques instants)
2. Mettre la file d'impression directe en pause
3. Imprimer un document depuis le serveur vers cette file (choisir un document ayant rencontré le problème)

4. S'assurer que le document apparaisse correctement dans la file
5. Reprendre l'impression (retirer la pause de la file)
6. Le document devrait disparaître de la file

→ Si le document s'imprime correctement, passer au test de la file virtuelle.
→ Si le document n'est pas apparu dans la file, vérifier la configuration de celle-ci.
→ Si le document est apparu puis a disparu de la file, mais ne s'imprime pas, passer au test du driver.

Tester la file virtuelle  (sur le serveur d'impression).

A ce stade, il est pertinent d'activer le mode debug du Serveur d'application, du Print Provider, et les logs d'impression opérationnels Windows : Activer/Récupérer les logs, et de relever :

• Date/heure a laquelle chaque étape est effectuée.
• Nom d'utilisateur ayant effectué les tests.
• Nom/IP du périphérique testé.
• Nom de la file virtuelle testée.
   

1. Mettre la file d'impression directe en pause.
2. Imprimer un document depuis le serveur vers la file virtuelle (choisir un document ayant rencontré le problème).
3. S'assurer que le document apparaisse sur la file virtuelle du serveur.
4. S'assurer que le document apparaisse dans le menu Imprimantes → Travaux en attente de PaperCut.
5. S'authentifier sur le périphérique, et vérifier si le document apparait bien dans la liste des jobs disponibles.
6. Demander la libération du document (celui-ci ne devrait pas s'imprimer).
7. S'assurer que le document ait disparu de la file virtuelle sur le serveur.
8. S'assurer que le document apparaisse sur la file directe du périphérique.
9. Reprendre l'impression (retirer la pause) sur la file directe.
10.  Le document devrait disparaître de la file.

→ Si le document s'imprime correctement, bonne nouvelle :)
→ Si le document n'apparaît pas sur la file virtuelle (étape 3 ou 4), récupérer les logs : Activer/Récupérer les logs
→ Si le job n'est pas visible (étape 5), s'assurer que le nom d'utilisateur authentifié sur le périphérique corresponde au propriétaire du job mentionné sur la file d'attente de l'imprimante. Vérifier également la configuration du périphérique.
→ Si le job n'a pas été transmis à la file directe du périphérique (étapes 7 et 8), récupérer les logs : Activer/Récupérer les logs
 

Tester avec le driver générique PaperCut.

PaperCut fourni un driver générique, présent par défaut dans le dossier d'installation : 

C:\Program Files\PaperCut MF\providers\print\drivers\global\win\PC-Global-Print-Driver

Il s'agit d'un driver PostScript offrant un support multi-constructeur, au sacrifice de quelques options de finitions, il est toutefois idéal pour réaliser des tests : si une file d'impression fonctionne avec le driver PaperCut mais pas avec le driver d'origine, alors il y a probablement un problème avec le driver d'origine (incompatible avec l'OS de l'utilisateur, le format de fichier imprimé, ou l'imprimante de destination).

Comment tester sans accès physique au périphérique ?

L'idéal pour tester une libération et une comptabilisation d'impression est d'avoir un utilisateur devant le périphérique, qui pourra demander la libération et voir si le document s'imprime correctement. Lorsque cela n'est pas possible, cette méthode permet d'effectuer cette vérification :

1. S'assurer que personne d'autre n'utilise le périphérique pendant le test

2. Imprimer un document.
3. Depuis la page web du périphérique ou à l'aide d'un outil de collecte SNMP (type KPAX), vérifier le compteur de la machine.

4. Depuis la console d'administration PaperCut, ouvrir le menu Imprimante → Travaux en attente → Imprimer puis sélectionner la file directe à utiliser.

5. Depuis l'Historique des travaux de PaperCut (celui de la file directe), voir si le job a été noté comme imprimé.

6. Depuis la page web du périphérique, revérifier le compteur, et noter si celui-ci a évolué.

Vérifier la configuration de base

Configuration de la file directe (PaperCut)

Au niveau de la file d'impression directe, vérifier les points suivants : 

1. L'imprimante n'affiche pas de status d'erreur.
2. Le serveur hôte est accessible et communique avec l'imprimante.
3. L'adresse de l'imprimante est correcte.
4. La file n'est pas désactivée.
5. La file pointe vers un équipement physique.
6. En cas d'impression sécurisée via une file virtuelle, l'impression sécurisée n'est pas activée sur la file directe.

7. L'imprimante n'est pas définie comme "non authentifiée". Si l'imprimante est "non authentifiée", s'assurer que les utilisateurs disposent du PCClient.

8. La vérification matérielle n'est pas activée, en cas d'activation, s'assurer que celle-ci soit correctement configurée.

9. Il n'y a pas de filtre sur la file.

10. Il n'y a pas de script sur la file.

Configuration de la file virtuelle (PaperCut)

Au niveau de la file virtuelle, s'assurer que :

1. La file n'est pas en erreur, est installée sur le bon serveur, et, en cas d'impression inter-serveur, le service PaperCut Print Provider est autorisé à imprimer sur tous les serveurs de destination.
2. Le nom du serveur est correct, le port est nul (Windows) ou null (CUPS).
3. L'imprimante est autorisée.
4. L'imprimante est une file d'attente virtuelle.

5. Les travaux peuvent être redirigés vers les imprimantes de destination.

6. L'impression sécurisée est activée.

7. L'imprimante n'est pas définie comme "non authentifiée". Si l'imprimante est "non authentifiée", s'assurer que les utilisateurs disposent du PCClient.

8. La vérification matérielle n'est pas activée, en cas d'activation, s'assurer que celle-ci soit correctement configurée.

9. Il n'y a pas de filtre sur la file.

10. Il n'y a pas de script sur la file.

Configuration du périphérique

Au niveau du périphérique, vérifier : 

1. L'adresse IP est correcte et accessible sur un navigateur web.
2. Le périphérique est rattaché au bon site en cas d'utilisation de serveurs de site PaperCut.
3. Le périphérique est autorisé.

4. La libération d'impression est activée.

5. Les files virtuelles à "écouter" sont sélectionnées.

6. Le support d'impression "Suivez-moi" est activé.

7. Les travaux sont redirigés vers "Ce périphérique".

8. La file de destination correspond à la file physique de ce périphérique (imprimante directe).

9. Le périphérique n'est pas en erreur.

Activer/Récupérer les logs

Serveur d'application PaperCut MF

1. Menu Options → Avancé → Activer le mode debug → Appliquer (1, 2, 3, 4 sur la capture)
2. Reproduire le problème.
3. Attendre 5 à 10 minutes (suivant la taille de l'infrastructure)
4. Menu Options → Avancé → Télécharger les fichiers de diagnostics (1, 2, 3, 5 sur la capture)

PaperCut Print Provider (fournisseur d'impression) sur Windows

1. Exécuter un programme Windows [Touche Windows] + [R]
2. Saisir cmd, puis [CTRL] + [↑ Maj] + [Entrée] pour ouvrir l'invite de commande en tant qu'administrateur.
3. Dans l'invite, saisir cd "C:\Program Files\PaperCut MF\providers\print\win" puis [Entrée].

4. Saisir debug-enable.bat puis [Entrée]

5. Saisir Y puis [Entrée]

6. Reproduire le problème
7. Attendre 5 à 10 minutes (suivant la taille de l'infrastructure)
8. Ouvrir le dossier C:\Program Files\PaperCut MF\providers\print\win puis récupérer tous les fichiers print-provider.log* et print-monitor.log*

Logs Windows

 Ressources PaperCut

• Dépannage de l'impression : https://www.papercut.com/kb/Main/MissingOrDisappearingPrintJobs/
• Impression avec file virtuelle : https://www.papercut.com/help/manuals/ng-mf/applicationserver/find-me-printing-troubleshooting/