Inhalt des Handbuchs

📦 Agent auf QNAP

In 30 Sekunden

Beta. Der Agent für QNAP ist ein neues Paket, und wir lernen noch von den ersten Werkstätten, die ihn nutzen.
Du lädst ihn in BolloPrint herunter (Einstellungen → Drucker → Lokaler Agent → Neuer Agent → QNAP) und installierst ihn von Hand im App Center von QTS.
Du öffnest ihn im App Center und drückst auf Mit BolloPrint verknüpfen. Ohne Code, ohne Manifest und ohne Ports zu öffnen.
Zum Aktualisieren installierst du das neue Paket über das vorhandene.

Wie du den lokalen Agenten ohne Docker auf ein QNAP-NAS bringst, als ganz normale App aus dem App Center. Wenn du lieber Container Station (Docker) nutzt, folge Agent in Docker: Das funktioniert genauso gut.

🧪 Das ist eine Beta

Wir haben es von Anfang bis Ende unter QTS 5.2 mit einem Intel-Prozessor getestet. Die Pakete für ARM-Prozessoren sind veröffentlicht, aber wir haben sie noch auf keinem echten QNAP laufen sehen. Wenn du so eines hast, hilft es uns sehr, wenn du uns erzählst, wie es gelaufen ist, egal ob gut oder schlecht.

Bevor du anfängst

Ein QNAP-NAS mit QTS 4.5 oder neuer, immer eingeschaltet und im selben Netzwerk wie die Drucker.
Ein Administratorkonto für QTS: Du brauchst es zum Installieren und um die Seite des Agenten zu öffnen.
Du musst Inhaber der Werkstatt in BolloPrint sein. Nur der Inhaber kann Agenten hinzufügen.
Du solltest wissen, welchen Prozessor dein QNAP hat. Das steht im Datenblatt deines Modells auf der QNAP-Website oder in QTS unter Systemsteuerung → System → Systemstatus.

Prozessor deines QNAP	Download
Intel oder AMD (die meisten Modelle)	Intel oder AMD (64 Bit)
ARM mit 64 Bit (zum Beispiel die Serien TS-x33, TS-x28A, TS-x32X)	ARM (64 Bit)
ARM mit 32 Bit (zum Beispiel die Serien TS-x31P, TS-x31X)	ARM (32 Bit)

Der Agent ist schlank: Er braucht kein leistungsstarkes Gerät.

Herunterladen

Geh in BolloPrint zu Einstellungen → Drucker und öffne den Tab Lokaler Agent.
Drück auf Neuer Agent und wähl die Karte QNAP.
Lade das Paket für den Prozessor deines QNAP herunter. Es ist eine Datei, die auf .qpkg endet.

Dort findest du auch die Schritte in Kurzform. Angelegt wird hier noch nichts: Der Agent erscheint in deiner Liste, sobald du ihn verknüpfst.

Auf dem QNAP installieren

Da der Agent noch nicht im QNAP-Store ist, wird er von Hand installiert. Das sind fünf Schritte:

Melde dich mit deinem Administratorkonto bei QTS an und öffne das App Center.
Öffne seine Einstellungen (das ⚙-Symbol oben rechts) und aktiviere Installation von Anwendungen ohne gültige digitale Signatur zulassen. Speichere.
Drück auf das Symbol für die manuelle Installation: kleine Kästchen mit einem +, oben rechts, direkt links neben dem ⚙. Es hat keinen Text; fahr mit der Maus darüber, um den Namen zu sehen. Wähl die heruntergeladene .qpkg-Datei und drück auf Installieren.
QTS warnt dich, dass die Anwendung keine digitale Signatur hat. Bestätige das: Das ist normal, solange der Agent nicht im QNAP-Store veröffentlicht ist.
Wenn die Installation fertig ist, erscheint BolloPrint Agent bei deinen Anwendungen. Drück auf Öffnen.

💡 Zur Warnung wegen der Signatur

QNAP signiert die Anwendungen in seinem Store. Unsere wartet dort noch auf die Veröffentlichung, deshalb kommt sie vorerst ohne diese Signatur, und QTS weist darauf hin. Das Paket lädst du aus deinem BolloPrint-Konto herunter, und das ist der einzige Ort, von dem du es holen solltest.

Wenn du die Option aus Schritt 2 nicht aktiviert lassen willst, kannst du sie gleich nach der Installation wieder ausschalten. Für das nächste Update musst du sie dann wieder einschalten.

Mit deiner Werkstatt verknüpfen

Wenn du auf Öffnen drückst, bringt dich QTS zur Seite des Agenten. Diese Seite sieht nur ein angemeldeter QTS-Administrator; alle anderen werden aufgefordert, sich bei QTS anzumelden.

Die Seite zeigt an, dass der Agent noch zu keiner Werkstatt gehört, und zeigt einen kurzen Code. Drück auf Mit BolloPrint verknüpfen.
BolloPrint öffnet sich. Wenn du nicht angemeldet warst, melde dich mit deinem Konto an.
Bist du Inhaber mehrerer Werkstätten, wähl aus, zu welcher du ihn hinzufügst. Es erscheinen nur die Werkstätten, deren Inhaber du bist.
Prüfe, ob der Code, den BolloPrint zeigt, derselbe ist wie auf der Seite des Agenten, und drück auf Zur Werkstatt hinzufügen.
Du kommst zurück zur Seite des Agenten, auf der jetzt Verknüpft mit und der Name deiner Werkstatt steht.

In weniger als einer Minute siehst du ihn als Online unter Einstellungen → Drucker → Lokaler Agent, mit dem QNAP-Logo. Ab da ist alles wie bei jedem anderen Agenten: Die Drucker in deinem Netzwerk erscheinen von selbst, damit du sie hinzufügen kannst, oder du fügst sie über ihre IP hinzu. Mehr dazu in Der lokale Agent.

🔐 Verknüpfe nur, was du gerade installiert hast

Mach in BolloPrint nur weiter, wenn du gerade auf deinem eigenen QNAP auf Mit BolloPrint verknüpfen gedrückt hast. Wenn dir jemand einen Link schickt, um „einen Agenten zu verknüpfen“, schließe ihn.

Aktualisieren

Du musst fast nie etwas tun: Der Agent aktualisiert sich von allein. Wenn eine neue Version erscheint, lädt er sie herunter, prüft, dass sie von uns ist, und startet mit ihr neu.

Nur wenn dich BolloPrint darauf hinweist, dass dein Agent eine manuelle Aktualisierung braucht, heißt Aktualisieren, das neue Paket über das vorhandene zu installieren:

Lade die neue Version unter Einstellungen → Drucker → Lokaler Agent → Neuer Agent → QNAP herunter, für denselben Prozessor.
Prüfe im App Center, ob die Option Installation von Anwendungen ohne gültige digitale Signatur zulassen noch aktiviert ist.
Drück auf das Symbol für die manuelle Installation (die Kästchen mit einem +, neben dem ⚙), wähl die neue Datei, drück auf Installieren und bestätige die Warnung zur Signatur.

QTS ersetzt das Programm und lässt seine Daten unangetastet: Der Agent bleibt mit deiner Werkstatt verknüpft, mit seinen Druckern und seinem Verlauf. Du musst ihn nicht neu verknüpfen. Sollte dir seine Seite nach dem Update wieder Mit BolloPrint verknüpfen anbieten, verknüpfe ihn und lösche in BolloPrint den alten Agenten, der dann getrennt geblieben ist.

Umziehen, neu installieren oder entfernen

Ihn neu zu installieren oder auf ein anderes NAS umzuziehen heißt, einen neuen zu verknüpfen: Installiere ihn auf dem neuen Gerät und verknüpfe ihn wie beim ersten Mal. Er erscheint als neuer Agent in deiner Liste. Die Drucker wechseln mit ihrem ganzen Verlauf zu ihm, sobald du sie hinzufügst. Lösche danach den alten über das Menü ⋮ seiner Zeile.

Um ihn ganz zu entfernen:

Lösche den Agenten in BolloPrint über das Menü ⋮ seiner Zeile unter Einstellungen → Drucker → Lokaler Agent. Er verbindet sich sofort nicht mehr, und die Drucker, die nur über ihn kamen, verschwinden aus der Liste (fügst du sie wieder hinzu, kommen sie mit ihrem Verlauf zurück).
Öffne im App Center von QTS BolloPrint Agent und drück auf Entfernen. Er wird mit seinen Daten gelöscht.

Machst du nur Schritt 1, bleibt der Agent installiert, aber ohne Werkstatt: Seine Seite bietet nach ein paar Sekunden wieder Mit BolloPrint verknüpfen an.

Wenn etwas nicht klappt

Symptom	Was zu prüfen ist
QTS lässt die Datei nicht installieren	Ist Installation von Anwendungen ohne gültige digitale Signatur zulassen aktiviert? Meldet QTS, dass sie nicht kompatibel ist, hast du das Paket für einen anderen Prozessor heruntergeladen: Lade das richtige herunter. Ist dein QTS älter als 4.5, aktualisiere es zuerst.
Beim Drücken auf Öffnen wirst du aufgefordert, dich bei QTS anzumelden	Die Seite des Agenten öffnet sich nur für Administratoren. Melde dich mit einem Administratorkonto bei QTS an und drück im App Center erneut auf Öffnen.
Öffnen zeigt einen Fehler oder eine leere Seite	Prüfe im App Center, ob BolloPrint Agent läuft, und starte ihn sonst. Bleibt es so, schau ins Systemprotokoll von QTS (in QTS 5 im QuLog Center) und such nach „BolloPrint Agent“: Steht dort, dass sein Port belegt ist, nutzt eine andere Anwendung 8257 und 8364. Schreib uns, und wir helfen dir, das zu ändern.
Beim Verknüpfen heißt es, BolloPrint sei nicht erreichbar	Das QNAP braucht Zugang zum Internet. Prüfe seine Verbindung und seinen DNS unter Systemsteuerung → Netzwerk.
BolloPrint sagt, dass du Inhaber keiner Werkstatt bist	Nur der Inhaber der Werkstatt kann Agenten hinzufügen. Bitte ihn, den Agenten selbst zu verknüpfen.
Der Agent erscheint nicht als Online	Warte eine Minute. Erscheint er dann immer noch nicht, prüfe im App Center, ob er läuft und ob das QNAP ins Internet kommt.
Er erkennt keinen Drucker	Sind das QNAP und die Drucker im selben Netzwerk? Wenn nicht (VLAN, Gastnetzwerk), füg sie von Hand über ihre IP hinzu, dann funktionieren sie genauso. Sind sie im selben Netzwerk und erscheinen trotzdem nicht, füg sie per IP hinzu und erzähl es uns: Das hilft uns, die Beta zu verbessern.

Du musst weder im Router noch in der Firewall des QNAP Ports öffnen: Die Verbindung zu BolloPrint geht von deinem Netzwerk nach außen, und die Seite des Agenten läuft über QTS selbst.