Aller au contenu principal

Dépannage

Commencez par ce que voit l'agent lui-même :

jodaprint-agent status

La commande affiche l'état du service, l'activation, le port local, la file d'attente et chaque imprimante avec son état et son problème éventuel. Les journaux se trouvent dans :

SystèmeJournaux
WindowsC:\ProgramData\JodaPrint\logs
macOS/Library/Application Support/JodaPrint/logs
Linux/var/lib/jodaprint/logs

Depuis l'icône de la zone de notification, Envoyer les journaux au support les téléverse dans votre tableau de bord (Appareils → appareil → Journaux), où le support peut les lire.

Avertissements de certificat​

L'erreur SDK AGENT_CERT_UNTRUSTED signifie que l'agent tourne, mais que le navigateur ne fait pas confiance à son certificat local.

  1. Ouvrez https://localhost:8182/v1 dans le même navigateur. Un avertissement de certificat confirme le problème.
  2. Réinstallez la confiance : jodaprint-agent cert install en administrateur ou en root (le programme d'installation l'exécute aussi).
  3. Redémarrez complètement le navigateur.

jodaprint-agent cert status affiche l'autorité de certification, le certificat et sa date d'expiration. Le certificat se renouvelle tout seul 30 jours avant son expiration.

Firefox​

Firefox utilise son propre magasin de certificats. Sous Windows et macOS, activez security.enterprise_roots.enabled dans about:config (ou par stratégie, Certificates → ImportEnterpriseRoots), puis redémarrez Firefox.

Chrome et Firefox sous Linux lisent la base NSS de l'utilisateur, pas le magasin du système. Importez-y l'autorité de certification de l'agent, ou utilisez une stratégie pour lui faire confiance.

Invite « Accès au réseau local » de Chrome​

Les versions récentes de Chrome demandent à l'utilisateur si un site web peut se connecter aux appareils du réseau local, y compris localhost. Cliquez sur Autoriser. Les administrateurs peuvent autoriser vos origines à l'avance avec la stratégie Chrome LocalNetworkAccessAllowedForUrls.

L'agent est introuvable​

AGENT_NOT_FOUND : aucun agent ne répond, sur aucun port.

  • Vérifiez que le service tourne : jodaprint-agent status, ou Services → JodaPrint sous Windows.
  • L'agent Android n'a pas de wss://localhost ; utilisez le shell WebView.
  • Un autre programme utilise peut-être les ports : voir Ports.

Ports​

L'agent écoute sur le premier port libre parmi 8182, 8283, 8384, 8485, uniquement sur 127.0.0.1 et ::1. Le SDK les essaie dans le même ordre. Si les quatre sont pris, modifiez local.ports dans la configuration et passez la même liste au SDK.

Sous Windows, netstat -ano | findstr 8182 indique quel processus utilise un port.

Antivirus et pare-feu​

  • Autorisez jodaprint-agent.exe (Windows) dans votre antivirus. Certains produits bloquent les programmes qui écoutent sur un port local ou qui installent un certificat.
  • L'agent n'a besoin que de HTTPS sortant (port 443) vers le cloud. Derrière un proxy, définissez HTTPS_PROXY pour le service.
  • Les imprimantes réseau ont besoin du port 9100 ouvert entre l'ordinateur et l'imprimante.

Imprimante hors ligne​

Le travail échoue avec PRINTER_OFFLINE (nouvelle tentative automatique, jusqu'à 5 essais).

  • USB : vérifiez le câble et l'alimentation, puis jodaprint-agent status.
  • Réseau : faites un ping vers l'IP de l'imprimante. Donnez aux imprimantes une IP fixe (réservation DHCP), car une nouvelle adresse change l'identité de l'imprimante.
  • Imprimantes du spouleur Windows : l'état vient du spouleur ; supprimez les travaux bloqués dans la file d'attente d'impression de Windows.
  • Bluetooth : associez d'abord l'imprimante dans le système d'exploitation, et gardez-la à portée.

PAPER_OUT et COVER_OPEN font aussi l'objet de nouvelles tentatives : le ticket s'imprime dès que le problème est réglé.

Les accents s'impriment avec de mauvais caractères​

Les imprimantes thermiques utilisent des pages de code, pas l'UTF-8.

  1. Utilisez un travail ticket ou text : l'agent convertit le texte. Les travaux raw et ESC/POS sont envoyés sans modification.
  2. Réglez codepage sur CP858 (français, créole et symbole de l'euro) dans le document, les options du travail ou printers.defaults.
  3. Les imprimantes clones numérotent parfois leurs tables de pages de code différemment. Essayez CP850, puis CP1252. Imprimez la page d'autotest de l'imprimante (maintenez le bouton d'avance papier en l'allumant) pour voir ses tables.

Les travaux s'impriment deux fois, ou pas du tout​

  • Envoyez toujours une idempotencyKey (par exemple le numéro de commande). La même clé dans les 24 heures renvoie le premier travail et n'imprime rien.
  • Un travail cloud destiné à un appareil hors ligne attend jusqu'à la fin de sa durée de vie (TTL, 24 heures par défaut), puis échoue avec TIMEOUT.
  • Avec le forfait gratuit, la limite mensuelle de travaux renvoie LICENSE_LIMIT.

Toujours bloqué ?​

Envoyez les journaux depuis l'icône de la zone de notification et contactez le support avec l'identifiant du travail ou le requestId de l'erreur.