Inhoud van de handleiding

🗄️ Agent op Synology

In 30 seconden

Op een Synology installeer je de agent als gewoon een extra DSM-pakket, vanuit het Pakketcentrum. Je hebt geen Docker of Container Manager nodig.
Je hoeft geen code te kopiëren: je opent hem vanuit het menu van DSM, klikt op Koppelen met BolloPrint en bevestigt het in je werkplaats.
Bijwerken is het nieuwe pakket installeren over het pakket dat je al hebt. Je verliest niets.
Je hoeft geen poorten in de router open te zetten.

Bèta

Het pakket voor Synology is in bèta: het werkt, maar er kan nog een stap veranderen. Klopt iets niet met wat je op je scherm ziet, laat het ons dan weten.

Heb je een Synology in de werkplaats, dan heb je al een plek voor de lokale agent: de NAS staat de hele dag aan en zit op hetzelfde netwerk als je printers. De agent installeer je zoals elke andere DSM-toepassing, en hij verschijnt in het hoofdmenu.

Op deze pagina lees je hoe je hem installeert, aan je werkplaats koppelt, bijwerkt, verhuist en weer verwijdert. Wat de agent is en welke printers hij koppelt, lees je in De lokale agent.

Voordat je begint

Wat je nodig hebt	Hoe je het controleert
DSM 7 of hoger	In DSM, Configuratiescherm → Infocentrum. Met DSM 6 werkt het niet.
Weten welke processor je NAS heeft	In hetzelfde Infocentrum staat het CPU-model. Intel of AMD is altijd 64-bit; is het ARM, dan staat op de pagina van je model op de website van Synology of het 64- of 32-bit is.
Inloggen op DSM als beheerder	Alleen beheerders kunnen pakketten installeren en de pagina van de agent openen.
Eigenaar zijn van de werkplaats in BolloPrint	Bij het koppelen zie je alleen de werkplaatsen waarvan je eigenaar bent.
De NAS en de printers zitten op hetzelfde netwerk	Zitten ze op gescheiden netwerken, dan werkt de agent net zo goed, maar moet je de printers via hun IP-adres toevoegen.
De NAS kan het internet op	Meer niet: je hoeft geen poorten open te zetten en geen vast IP-adres te hebben.

1. Download het pakket

Ga in BolloPrint naar Instellingen → Printers → Lokale agent → Nieuwe agent en kies Synology.

Je ziet een downloadknop voor elk type processor: Intel of AMD (64-bit), ARM (64-bit) en ARM (32-bit). Klik op die van je NAS. Je downloadt een bestand dat eindigt op .spk: dat is het DSM-pakket.

Op datzelfde scherm hoef je niets aan te maken en geen code te kopiëren. De agent ontstaat pas als je hem koppelt, in stap 3.

Zodra het pakket in de catalogus van het Pakketcentrum van Synology staat, kun je deze stap overslaan: dan zoek je gewoon BolloPrint Agent op en installeer je het van daaruit.

2. Installeer het in DSM

Log in op DSM en open het Pakketcentrum.
Klik rechtsboven op Handmatige installatie.
Klik op Bladeren, kies het .spk-bestand dat je net hebt gedownload en klik op Volgende.
DSM waarschuwt je dat het pakket niet door Synology is gepubliceerd. Accepteer dat om verder te gaan.
De wizard toont de poort van de agentpagina, met 8257 al ingevuld. Laat die zo staan, tenzij DSM zegt dat hij al in gebruik is; vul dan 8364 in.
Klik op Volgende en, in het overzicht, op Klaar.

Binnen een minuut staat het pakket op Actief en verschijnt BolloPrint Agent in het hoofdmenu van DSM.

Als je het verkeerde bestand kiest

Past de processor niet, dan laat DSM je het pakket niet installeren en meldt het dat het niet compatibel is met je model. Ga terug naar BolloPrint en download het andere.

3. Koppel hem aan je werkplaats

Open in DSM het hoofdmenu (het pictogram linksboven) en klik op BolloPrint Agent. Hij opent in een nieuw tabblad.
Op de pagina staat ‘Deze agent hoort nog bij geen enkele werkplaats’, met een code van acht tekens, zoals 6E7B-9DEF. Klik op Koppelen met BolloPrint.
BolloPrint gaat open. Ben je niet ingelogd, log dan in. Kies de werkplaats waaraan je hem toevoegt.
BolloPrint toont het apparaat (de naam van je NAS en ‘Synology’) en de code. Controleer dat het dezelfde code is als op de pagina van de agent en klik op Toevoegen aan werkplaats.
Je komt terug op de pagina van de agent, waar nu Gekoppeld aan je werkplaats staat.

Klaar. In Instellingen → Printers → Lokale agent zie je de agent met de naam van je NAS en het logo van Synology, Online.

Bevestig alleen wat je zelf net hebt aangeklikt

Krijg je ooit een link om ‘een agent toe te voegen’ waar je niet om hebt gevraagd, sluit hem dan. Een agent wordt alleen vanaf zijn eigen pagina gekoppeld, en die pagina kan alleen een beheerder van je NAS openen.

4. Geef hem de printers

De agent begint naar printers in je netwerk te zoeken zodra hij gekoppeld is. Wat hij vindt, verschijnt in Printers op het lokale netwerk, onder de lijst met agents, en van daaruit voeg je ze toe. Printers die niet vanzelf verschijnen, voeg je toe met Toevoegen via IP.

Hoe je dat per merk doet, lees je in Printers via het lokale netwerk.

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 installeren over het pakket dat je al hebt:

Download het nieuwe pakket vanaf hetzelfde scherm in BolloPrint (Lokale agent → Nieuwe agent → Synology), het pakket voor jouw processor.
Kies in het Pakketcentrum, bij Handmatige installatie, het bestand en ga verder. DSM ziet dat het al geïnstalleerd is en werkt het bij: het vraagt niet opnieuw naar de poort.

De agent blijft gekoppeld aan dezelfde werkplaats, met dezelfde printers en hun geschiedenis. Je hoeft niets opnieuw te koppelen.

Zodra het pakket in de catalogus van Synology staat, laat het Pakketcentrum je dat zelf weten en hoef je alleen op Bijwerken te klikken.

Niet de-installeren om bij te werken

De-installeren wist de identiteit van de agent. De-installeer je hem en installeer je hem opnieuw, dan is het een nieuwe agent die je opnieuw moet koppelen. Om bij te werken installeer je altijd over het bestaande pakket heen.

Naar een andere NAS verhuizen of opnieuw installeren

Een nieuwe agent is een nieuwe agent: je kunt een agent niet ‘verhuizen’. Wat je verhuist, zijn de printers, en die gaan mee met hun hele geschiedenis.

Installeer het pakket op de nieuwe NAS en koppel hem (stap 1 tot en met 3). Hij verschijnt als tweede agent.
Open in Instellingen → Printers elke printer met Bewerken in zijn menu ⋮ en kies in de keuzelijst de nieuwe agent.
Heeft de oude agent geen printers meer, verwijder hem dan via het menu ⋮ van zijn regel.

Installeer je opnieuw op dezelfde NAS, dan is de volgorde hetzelfde: eerst de nieuwe koppelen en de printers overzetten, en daarna de oude verwijderen.

De-installeren

Open in DSM het Pakketcentrum, ga naar BolloPrint Agent en klik op Actie → Verwijderen. Het pakket en alles wat het bewaarde worden gewist, ook de identiteit van de agent.
Verwijder in BolloPrint, bij Instellingen → Printers → Lokale agent, de agent via het menu ⋮ van zijn regel.

Als je hem verwijdert, verdwijnen de printers die alleen via die agent binnenkwamen uit de lijst en tellen ze niet meer mee voor je abonnement. Er gaat niets verloren: voeg je er een opnieuw toe, dan komt hij terug met zijn nummer en zijn geschiedenis.

Doe je het andersom — eerst verwijderen in BolloPrint —, dan merkt de agent dat, vergeet hij zijn koppeling en biedt zijn pagina weer Koppelen met BolloPrint aan. Daarna kun je het pakket de-installeren.

Als er iets niet werkt

Kijk eerst of het pakket in het Pakketcentrum op Actief staat. Vanaf de pagina van het pakket kun je ook het logboek bekijken: Actie → Logboek weergeven.

Wat je ziet	Wat je doet
De wizard zegt dat poort 8257 al in gebruik is	Een andere toepassing op de NAS gebruikt hem. Vul 8364 in en ga verder.
DSM zegt dat het pakket niet compatibel is met je model	Je hebt het pakket voor een andere processor gedownload. Download het juiste.
Bij het openen van BolloPrint Agent wordt gevraagd om in te loggen op DSM	Open hem vanuit het menu van DSM terwijl je ingelogd bent, en als beheerder. Blijft het gebeuren, sluit dat tabblad dan en open hem opnieuw vanuit het menu.
Op de pagina staat dat de agent niet reageert	Het pakket staat stil of is aan het opstarten. Open in het Pakketcentrum BolloPrint Agent, klik op Actie → Uitvoeren en wacht een paar seconden.
Bij het koppelen staat je werkplaats er niet bij	Je ziet alleen de werkplaatsen waarvan je eigenaar bent. Vraag de eigenaar om de agent zelf te koppelen.
‘Dit koppelverzoek is ongeldig’ of hij is verlopen	Ga terug naar de pagina van de agent en klik opnieuw op Koppelen met BolloPrint.
Na een herstart van de NAS duurt het even voordat de agent op Online staat	Wacht een paar minuten: hij start op met DSM en probeert het zelf opnieuw tot de NAS internet heeft.
Hij vindt geen enkele printer	Zitten de NAS en de printers op hetzelfde netwerk? Zo niet, voeg ze dan via IP toe. Heb je er net een aangezet, klik dan op Nu zoeken. Staat de firewall van DSM aan, sta dan de poorten van BolloPrint Agent toe (hij staat in de lijst met toepassingen als je een regel aanmaakt).
De agent staat op Geen recent signaal	De NAS staat uit, heeft geen internet of het pakket staat stil.

Veelgestelde vragen

Heb ik Docker of Container Manager nodig? Nee. Het pakket gebruikt geen containers. Heb je de agent liever in een container, dan kan dat ook: zie Agent in Docker.

Moet ik poorten in de router openzetten? Nee. De agent belt BolloPrint naar buiten, zoals wanneer je een webpagina opent. Poort 8257 is alleen voor zijn pagina binnen de NAS zelf: die wordt niet opengezet voor je netwerk.

Wie kan de pagina van de agent openen? Alleen DSM-beheerders, vanuit het hoofdmenu. Iemand die alleen je netwerk deelt, kan hem niet openen.

Kan ik de poort later nog veranderen? De wizard vraagt er alleen naar bij de installatie. Om hem te veranderen moet je de-installeren en opnieuw installeren, en dan is het een nieuwe agent (zie ‘Naar een andere NAS verhuizen of opnieuw installeren’, hierboven).

En als ik de NAS uitzet of herstart? Er gebeurt niets. De agent start vanzelf op met DSM en maakt weer verbinding zonder iets te vragen.