📦 Agent sur QNAP

Comment installer l'agent local sur un NAS QNAP sans Docker, comme n'importe quelle autre application de l'App Center. Si vous préférez utiliser Container Station (Docker), suivez Agent sur Docker : cela fonctionne tout aussi bien.

---

Avant de commencer

• Un NAS QNAP sous QTS 4.5 ou plus récent, toujours allumé et sur le même réseau que les imprimantes.
• Un compte administrateur QTS : il est nécessaire pour l'installer et pour ouvrir la page de l'agent.
• Être le propriétaire de l'atelier dans BolloPrint. Seul le propriétaire peut ajouter des agents.
• Savoir quel processeur a votre QNAP. Vous le trouvez dans la fiche de votre modèle sur le site de QNAP, ou dans QTS, sous Panneau de configuration → Système → État du système.

Processeur de votre QNAP	Téléchargement
Intel ou AMD (la plupart des modèles)	Intel ou AMD (64 bits)
ARM 64 bits (par exemple, séries TS-x33, TS-x28A, TS-x32X)	ARM (64 bits)
ARM 32 bits (par exemple, séries TS-x31P, TS-x31X)	ARM (32 bits)

L'agent est léger : il n'a pas besoin d'une machine puissante.

---

Le télécharger

1. Dans BolloPrint, allez dans Paramètres → Imprimantes et ouvrez l'onglet Agent local.
2. Appuyez sur Nouvel agent et choisissez la carte QNAP.
3. Téléchargez le paquet correspondant au processeur de votre QNAP. C'est un fichier qui se termine par .qpkg.

Les étapes résumées sont affichées au même endroit. Rien n'est encore créé à ce stade : l'agent apparaîtra dans votre liste quand vous l'aurez associé.

---

L'installer sur le QNAP

Comme l'agent n'est pas encore dans la boutique de QNAP, il s'installe à la main. Cela se fait en cinq étapes :

1. Connectez-vous à QTS avec votre compte administrateur et ouvrez l'App Center.
2. Ouvrez ses paramètres (l'icône ⚙ en haut à droite) et activez Autoriser l'installation d'applications sans signature numérique valide. Enregistrez.
3. Appuyez sur l'icône d'installation manuelle : de petites boîtes avec un +, en haut à droite, juste à gauche du ⚙. Elle n'a pas de texte ; survolez-la pour voir son nom. Choisissez le fichier .qpkg que vous avez téléchargé et appuyez sur Installer.
4. QTS vous avertit que l'application n'a pas de signature numérique. Acceptez : c'est normal tant que l'agent n'est pas publié dans la boutique de QNAP.
5. Une fois l'installation terminée, BolloPrint Agent apparaît parmi vos applications. Appuyez sur Ouvrir.

Si vous préférez ne pas laisser activée l'option de l'étape 2, vous pouvez la désactiver dès la fin de l'installation. Il faudra la réactiver pour la prochaine mise à jour.

---

L'associer à votre atelier

Quand vous appuyez sur Ouvrir, QTS vous amène à la page de l'agent. Seul un administrateur QTS connecté peut voir cette page ; à toute autre personne, elle demande de se connecter à QTS.

1. La page indique que l'agent n'appartient encore à aucun atelier et affiche un code court. Appuyez sur Associer à BolloPrint.
2. BolloPrint s'ouvre. Si vous n'étiez pas connecté, connectez-vous avec votre compte.
3. Si vous êtes propriétaire de plusieurs ateliers, choisissez celui auquel vous l'ajoutez. Seuls les ateliers dont vous êtes propriétaire apparaissent.
4. Vérifiez que le code affiché par BolloPrint est le même que celui de la page de l'agent et appuyez sur Ajouter à l'atelier.
5. Vous revenez sur la page de l'agent, qui indique maintenant Associé à suivi du nom de votre atelier.

En moins d'une minute, vous le verrez En ligne dans Paramètres → Imprimantes → Agent local, avec le logo QNAP. À partir de là, tout se passe comme avec n'importe quel agent : les imprimantes de votre réseau apparaissent toutes seules pour que vous les ajoutiez, ou vous les ajoutez par leur IP. Tout est expliqué dans L'agent local.

---

Le mettre à jour

Vous n'avez presque jamais rien à faire : l'agent se met à jour tout seul. Quand une nouvelle version sort, il la télécharge, vérifie qu'elle vient bien de nous et redémarre avec elle.

Ce n'est que si BolloPrint vous avertit que votre agent a besoin d'une mise à jour manuelle que vous devez le faire vous-même, en installant le nouveau paquet par-dessus celui que vous avez déjà :

1. Téléchargez la nouvelle version depuis Paramètres → Imprimantes → Agent local → Nouvel agent → QNAP, pour le même processeur.
2. Dans l'App Center, vérifiez que l'option Autoriser l'installation d'applications sans signature numérique valide est toujours activée.
3. Appuyez sur l'icône d'installation manuelle (les petites boîtes avec un +, à côté du ⚙), choisissez le nouveau fichier, appuyez sur Installer et acceptez l'avertissement de signature.

QTS remplace le programme et ne touche pas à ses données : l'agent reste associé à votre atelier, avec ses imprimantes et son historique. Pas besoin de l'associer à nouveau. Si, après la mise à jour, sa page vous proposait de nouveau Associer à BolloPrint, associez-le et supprimez dans BolloPrint l'ancien agent, qui sera resté déconnecté.

---

Le déplacer, le réinstaller ou le retirer

Le réinstaller ou le déplacer vers un autre NAS revient à en associer un nouveau : installez-le sur le nouvel appareil et associez-le comme la première fois. Ce sera un nouvel agent dans votre liste. Les imprimantes passent vers lui, avec tout leur historique, dès que vous les ajoutez. Supprimez ensuite l'ancien depuis le menu ⋮ de sa ligne.

Pour le retirer complètement :

1. Dans BolloPrint, supprimez l'agent depuis le menu ⋮ de sa ligne dans Paramètres → Imprimantes → Agent local. Il cesse de se connecter sur-le-champ, et les imprimantes qui n'arrivaient que par lui disparaissent de la liste (si vous les ajoutez à nouveau, elles reviennent avec leur historique).
2. Dans l'App Center de QTS, ouvrez BolloPrint Agent et appuyez sur Supprimer. Il est effacé avec ses données.

Si vous ne faites que l'étape 1, l'agent reste installé mais sans atelier : en quelques secondes, sa page propose de nouveau Associer à BolloPrint.

---

Quand quelque chose ne va pas

Symptôme	Que regarder
QTS refuse d'installer le fichier	L'option Autoriser l'installation d'applications sans signature numérique valide est-elle activée ? Si QTS indique qu'il n'est pas compatible, vous avez téléchargé le paquet d'un autre processeur : téléchargez le bon. Si votre QTS est antérieur à la version 4.5, mettez-le d'abord à jour.
En appuyant sur Ouvrir, il vous demande de vous connecter à QTS	La page de l'agent ne s'ouvre qu'à un administrateur. Connectez-vous à QTS avec un compte administrateur et appuyez de nouveau sur Ouvrir depuis l'App Center.
Ouvrir affiche une erreur ou une page blanche	Vérifiez dans l'App Center que BolloPrint Agent est en cours d'exécution et, sinon, démarrez-le. Si rien ne change, consultez le journal système de QTS (dans QTS 5, QuLog Center) et cherchez « BolloPrint Agent » : s'il indique que son port est occupé, une autre application utilise le 8257 et le 8364. Écrivez-nous et nous vous aiderons à le changer.
À l'association, il indique qu'il n'a pas pu joindre BolloPrint	Le QNAP doit avoir accès à internet. Vérifiez sa connexion et son DNS dans Panneau de configuration → Réseau.
BolloPrint indique que vous n'êtes propriétaire d'aucun atelier	Seul le propriétaire de l'atelier peut ajouter des agents. Demandez-lui de l'associer lui-même.
L'agent n'apparaît pas En ligne	Attendez une minute. S'il n'apparaît toujours pas, vérifiez dans l'App Center qu'il est en cours d'exécution et que le QNAP accède à internet.
Il ne détecte aucune imprimante	Le QNAP et les imprimantes sont-ils sur le même réseau ? Si ce n'est pas le cas (VLAN, réseau invité), ajoutez-les à la main par leur IP : elles fonctionneront pareil. S'ils sont sur le même réseau et qu'elles n'apparaissent toujours pas, ajoutez-les par IP et racontez-le-nous : cela nous aide à améliorer la bêta.

Il n'y a aucun port à ouvrir sur le routeur ni sur le pare-feu du QNAP : la connexion avec BolloPrint part de votre réseau vers l'extérieur, et la page de l'agent passe par QTS lui-même.