Naar de inhoud
Documentatie
Inhoud van de handleiding

📦 Agent op QNAP

In 30 seconden

  • Beta. De agent voor QNAP is een nieuw pakket en we leren nog van de eerste werkplaatsen die hem gebruiken.
  • Je downloadt hem in BolloPrint (Instellingen → Printers → Lokale agent → Nieuwe agent → QNAP) en installeert hem handmatig in het App Center van QTS.
  • Je opent hem vanuit het App Center en klikt op Koppelen met BolloPrint. Geen codes, geen sjablonen en geen poorten openzetten.
  • Om hem bij te werken, installeer je het nieuwe pakket over het pakket heen dat je al hebt.

Hoe je de lokale agent zonder Docker op een NAS van QNAP zet, als gewone app uit het App Center. Gebruik je liever Container Station (Docker), volg dan Agent in Docker: dat werkt net zo goed.

🧪 Dit is een bèta

We hebben hem van begin tot eind getest op QTS 5.2 met een Intel-processor. De pakketten voor ARM-processors zijn gepubliceerd, maar we hebben ze nog niet op een echte QNAP zien werken. Heb je er een, dan helpt het ons enorm als je vertelt hoe het ging, goed of slecht.

Voordat je begint

  • Een NAS van QNAP met QTS 4.5 of later, die altijd aan staat en in hetzelfde netwerk als de printers zit.
  • Een QTS-account van een beheerder: die heb je nodig om te installeren en om de pagina van de agent te openen.
  • Eigenaar zijn van de werkplaats in BolloPrint. Alleen de eigenaar kan agents toevoegen.
  • Weten welke processor je QNAP heeft. Dat zie je in de specificaties van je model op de website van QNAP, of in QTS, onder Configuratiescherm → Systeem → Systeemstatus.
Processor van je QNAPDownload
Intel of AMD (de meeste modellen)Intel of AMD (64-bit)
64-bit ARM (bijvoorbeeld de series TS-x33, TS-x28A, TS-x32X)ARM (64-bit)
32-bit ARM (bijvoorbeeld de series TS-x31P, TS-x31X)ARM (32-bit)

De agent is licht: hij heeft geen krachtig apparaat nodig.

Downloaden

  1. Ga in BolloPrint naar Instellingen → Printers en open het tabblad Lokale agent.
  2. Klik op Nieuwe agent en kies de kaart QNAP.
  3. Download het pakket voor de processor van je QNAP. Het is een bestand dat eindigt op .qpkg.

Op dezelfde plek staan de stappen ook in het kort. Hier wordt nog niets aangemaakt: de agent verschijnt in je lijst zodra je hem koppelt.

Installeren op de QNAP

Omdat de agent nog niet in de winkel van QNAP staat, installeer je hem handmatig. Het zijn vijf stappen:

  1. Log in op QTS met je beheerdersaccount en open het App Center.
  2. Open de instellingen (het pictogram ⚙ rechtsboven) en zet Installatie van applicaties zonder geldige digitale handtekening toestaan aan. Sla op.
  3. Klik op het pictogram voor handmatige installatie: een paar doosjes met een +, rechtsboven, direct links van het ⚙. Het heeft geen tekst; ga er met de muis overheen om de naam te zien. Kies het gedownloade .qpkg-bestand en klik op Installeren.
  4. QTS waarschuwt je dat de app geen digitale handtekening heeft. Accepteer dat: dat is normaal zolang de agent niet in de winkel van QNAP staat.
  5. Als het klaar is, verschijnt BolloPrint Agent tussen je apps. Klik op Openen.

💡 Over de waarschuwing voor de handtekening

QNAP ondertekent de apps in zijn eigen winkel. Die van ons wacht daar nog op publicatie, dus voorlopig komt hij zonder die handtekening en waarschuwt QTS daarvoor. Je downloadt het pakket vanuit je BolloPrint-account, en dat is de enige plek waar je het vandaan moet halen.

Wil je de optie uit stap 2 liever niet aan laten staan, dan kun je hem uitzetten zodra de installatie klaar is. Voor de volgende update moet je hem dan weer aanzetten.

Koppelen met je werkplaats

Als je op Openen klikt, brengt QTS je naar de pagina van de agent. Die pagina ziet alleen een ingelogde QTS-beheerder; iedereen anders wordt gevraagd om in te loggen op QTS.

  1. De pagina meldt dat de agent nog bij geen enkele werkplaats hoort en toont een korte code. Klik op Koppelen met BolloPrint.
  2. BolloPrint gaat open. Was je niet ingelogd, log dan in met je account.
  3. Ben je eigenaar van meer dan één werkplaats, kies dan aan welke je hem toevoegt. Je ziet alleen werkplaatsen waarvan je eigenaar bent.
  4. Controleer of de code in BolloPrint dezelfde is als op de pagina van de agent en klik op Toevoegen aan werkplaats.
  5. Je komt terug op de pagina van de agent, waar nu Gekoppeld aan staat met de naam van je werkplaats.

Binnen een minuut zie je hem op Online staan in Instellingen → Printers → Lokale agent, met het logo van QNAP. Vanaf dan werkt alles zoals bij elke andere agent: de printers in je netwerk verschijnen vanzelf zodat je ze kunt toevoegen, of je voegt ze toe via hun IP. Dat lees je in De lokale agent.

🔐 Koppel alleen wat je net hebt geïnstalleerd

Ga in BolloPrint alleen verder als je zojuist zelf op je eigen QNAP op Koppelen met BolloPrint hebt geklikt. Stuurt iemand je een link om “een agent te koppelen”, sluit hem dan.

Bijwerken

Je hoeft bijna nooit iets te doen: de agent werkt zichzelf bij. Als er een nieuwe versie uitkomt, downloadt hij die, controleert hij of die van ons is en herstart hij ermee.

Alleen als BolloPrint je laat weten dat je agent een handmatige update nodig heeft, is bijwerken het nieuwe pakket over het oude heen installeren:

  1. Download de nieuwe versie via Instellingen → Printers → Lokale agent → Nieuwe agent → QNAP, voor dezelfde processor.
  2. Controleer in het App Center of Installatie van applicaties zonder geldige digitale handtekening toestaan nog aan staat.
  3. Klik op het pictogram voor handmatige installatie (de doosjes met een +, naast het ⚙), kies het nieuwe bestand, klik op Installeren en accepteer de waarschuwing over de handtekening.

QTS vervangt het programma en laat de gegevens ongemoeid: de agent blijft gekoppeld aan je werkplaats, met zijn printers en zijn geschiedenis. Je hoeft hem niet opnieuw te koppelen. Biedt zijn pagina na de update toch weer Koppelen met BolloPrint aan, koppel hem dan en verwijder in BolloPrint de oude agent, die dan geen verbinding meer heeft.

Verhuizen, opnieuw installeren of verwijderen

Opnieuw installeren of naar een andere NAS verhuizen betekent een nieuwe agent koppelen: installeer hem op het nieuwe apparaat en koppel hem zoals de eerste keer. Het wordt een nieuwe agent in je lijst. De printers gaan met hun hele geschiedenis naar hem over zodra je ze toevoegt. Verwijder daarna de oude via het menu ⋮ in zijn regel.

Zo verwijder je hem helemaal:

  1. Verwijder de agent in BolloPrint via het menu ⋮ in zijn regel in Instellingen → Printers → Lokale agent. Hij maakt meteen geen verbinding meer, en de printers die alleen via hem binnenkwamen verdwijnen uit de lijst (voeg je ze opnieuw toe, dan komen ze terug met hun geschiedenis).
  2. Open in het App Center van QTS BolloPrint Agent en klik op Verwijderen. Hij wordt samen met zijn gegevens gewist.

Doe je alleen stap 1, dan blijft de agent geïnstalleerd, maar zonder werkplaats: binnen een paar seconden biedt zijn pagina weer Koppelen met BolloPrint aan.

Als er iets niet werkt

SymptoomWat je controleert
QTS wil het bestand niet installerenStaat Installatie van applicaties zonder geldige digitale handtekening toestaan aan? Zegt QTS dat het niet compatibel is, dan heb je het pakket voor een andere processor gedownload: download het juiste opnieuw. Is je QTS ouder dan 4.5, werk het dan eerst bij.
Na een klik op Openen wordt gevraagd om in te loggen op QTSDe pagina van de agent gaat alleen open voor een beheerder. Log in op QTS met een beheerdersaccount en klik opnieuw op Openen in het App Center.
Openen geeft een fout of een lege paginaControleer in het App Center of BolloPrint Agent draait en start hem als dat niet zo is. Blijft het zo, kijk dan in het systeemlogboek van QTS (in QTS 5 is dat QuLog Center) en zoek op “BolloPrint Agent”: staat er dat zijn poort bezet is, dan gebruikt een andere app 8257 en 8364. Stuur ons een bericht, dan helpen we je die te wijzigen.
Bij het koppelen staat er “We konden BolloPrint niet bereiken”De QNAP heeft toegang tot internet nodig. Controleer zijn verbinding en zijn DNS onder Configuratiescherm → Netwerk.
BolloPrint zegt “Je bent van geen enkele werkplaats eigenaar”Alleen de eigenaar van de werkplaats kan agents toevoegen. Vraag de eigenaar om hem zelf te koppelen.
De agent komt niet op OnlineWacht een minuut. Verschijnt hij nog steeds niet, kijk dan in het App Center of hij draait en of de QNAP bij internet kan.
Er wordt geen enkele printer gevondenZitten de QNAP en de printers in hetzelfde netwerk? Zo niet (VLAN, gastnetwerk), voeg ze dan handmatig toe via hun IP; ze werken precies hetzelfde. Zitten ze wel in hetzelfde netwerk en verschijnen ze toch niet, voeg ze dan toe via IP en laat het ons weten: zo help je ons de bèta te verbeteren.

Je hoeft geen poorten open te zetten in de router of in de firewall van de QNAP: de verbinding met BolloPrint gaat van je netwerk naar buiten, en de pagina van de agent loopt via QTS zelf.