🗄️ Agente su Synology

Se hai un Synology in laboratorio, hai già dove mettere l'agente locale: è acceso tutto il giorno e sta nella stessa rete delle tue stampanti. L'agente si installa come qualsiasi altra applicazione di DSM e compare nel suo menu principale.

Questa pagina spiega come installarlo, collegarlo al tuo laboratorio, aggiornarlo, spostarlo e toglierlo. Cos'è l'agente e quali stampanti collega lo trovi in L'agente locale.

---

Prima di cominciare

Cosa ti serve	Come lo verifichi
DSM 7 o successivo	In DSM, Pannello di controllo → Centro informazioni. Con DSM 6 non funziona.
Sapere che processore ha il tuo NAS	Nello stesso Centro informazioni trovi il modello di CPU. Intel o AMD sono a 64 bit; se è ARM, la scheda del tuo modello sul sito di Synology dice se è a 64 o a 32 bit.
Entrare in DSM con un utente amministratore	Solo gli amministratori possono installare pacchetti e aprire la pagina dell'agente.
Essere proprietario del laboratorio in BolloPrint	Al momento di collegarlo compaiono solo i laboratori di cui sei proprietario.
Che il NAS e le stampanti siano nella stessa rete	Se sono in reti separate l'agente funziona lo stesso, ma dovrai aggiungere le stampanti per IP.
Che il NAS esca su internet	Nient'altro: non serve aprire porte né avere un IP fisso.

---

1. Scarica il pacchetto

In BolloPrint, vai in Impostazioni → Stampanti → Agente locale → Nuovo agente e scegli Synology.

Vedrai un pulsante di download per ogni tipo di processore: Intel o AMD (64 bit), ARM (64 bit) e ARM (32 bit). Premi quello del tuo NAS. Si scarica un file che finisce in .spk: è il pacchetto di DSM.

In questa stessa schermata non devi creare nulla né copiare nessun codice. L'agente nasce quando lo colleghi, al passo 3.

---

2. Installalo in DSM

1. Entra in DSM e apri il Centro pacchetti.
2. In alto a destra, premi Installazione manuale.
3. Premi Sfoglia, scegli il file .spk che hai appena scaricato e premi Avanti.
4. DSM ti avvisa che il pacchetto non è pubblicato da Synology. Accetta per andare avanti.
5. La procedura guidata ti mostra la porta della pagina dell'agente, con 8257 già inserita. Lasciala così, a meno che DSM non ti dica che è occupata; in quel caso metti 8364.
6. Premi Avanti e, nel riepilogo, Fatto.

In un minuto il pacchetto risulta In esecuzione e BolloPrint Agent si aggiunge al menu principale di DSM.

---

3. Collegalo al tuo laboratorio

1. In DSM, apri il menu principale (l'icona in alto a sinistra) e premi BolloPrint Agent. Si apre in una nuova scheda.
2. La pagina dice «Questo agente non appartiene ancora a nessun laboratorio» e mostra un codice di otto caratteri, come 6E7B-9DEF. Premi Collega a BolloPrint.
3. Si apre BolloPrint. Se non hai effettuato l'accesso, accedi. Scegli il laboratorio a cui lo aggiungi.
4. BolloPrint ti mostra il dispositivo (il nome del tuo NAS e «Synology») e il codice. Verifica che sia lo stesso che compariva nella pagina dell'agente e premi Aggiungi al laboratorio.
5. Torni alla pagina dell'agente, che ora dice Collegato a e il nome del tuo laboratorio.

Fatto. In Impostazioni → Stampanti → Agente locale vedrai l'agente con il nome del tuo NAS e il logo di Synology, Online.

---

4. Dagli le stampanti

L'agente comincia a cercare stampanti nella tua rete appena viene collegato. Quello che trova compare in Stampanti in rete locale, sotto l'elenco degli agenti, e da lì le registri. Quelle che non compaiono da sole, con Aggiungi per IP.

Come farlo con ogni marca lo trovi in Stampanti in rete locale.

---

Aggiornarlo

Non devi quasi mai fare nulla: l'agente si aggiorna da solo. Quando esce una versione nuova, la scarica, verifica che sia nostra e si riavvia con quella.

Solo se BolloPrint ti avvisa che il tuo agente ha bisogno di un aggiornamento manuale, si tratta di installare il pacchetto nuovo sopra quello che hai:

1. Scarica il pacchetto nuovo dalla stessa schermata di BolloPrint (Agente locale → Nuovo agente → Synology), quello del tuo processore.
2. Nel Centro pacchetti, Installazione manuale, scegli il file e vai avanti. DSM vede che è già installato e lo aggiorna: non ti chiede di nuovo la porta.

L'agente resta collegato allo stesso laboratorio, con le stesse stampanti e il loro storico. Non c'è da collegare niente di nuovo.

Quando il pacchetto sarà nel catalogo di Synology, sarà il Centro pacchetti stesso ad avvisarti e basterà premere Aggiorna.

---

Spostarlo su un altro NAS o reinstallarlo

Un agente nuovo è un agente nuovo: non c'è modo di «trasferirne» uno. Quelle che si spostano sono le stampanti, e si spostano con tutto il loro storico.

1. Installa il pacchetto sul NAS nuovo e collegalo (passi da 1 a 3). Comparirà come un secondo agente.
2. In Impostazioni → Stampanti, apri ogni stampante con Modifica nel suo menu ⋮ e passala all'agente nuovo nel menu a tendina.
3. Quando quello vecchio non ha più stampanti, eliminalo dal menu ⋮ della sua riga.

Se reinstalli sullo stesso NAS, l'ordine è lo stesso: prima collega il nuovo e passagli le stampanti, poi elimina il vecchio.

---

Disinstallarlo

1. In DSM, apri il Centro pacchetti, entra in BolloPrint Agent e premi Azione → Disinstalla. Si cancellano il pacchetto e tutto quello che conservava, compresa la sua identità.
2. In BolloPrint, Impostazioni → Stampanti → Agente locale, elimina l'agente dal menu ⋮ della sua riga.

Eliminandolo, le stampanti che arrivavano solo tramite quell'agente spariscono dall'elenco e smettono di contare per il tuo piano. Non si perde nulla: se ne aggiungi di nuovo una, torna con il suo numero e il suo storico.

---

Quando qualcosa non va

La prima cosa è controllare se il pacchetto è In esecuzione nel Centro pacchetti. Dalla sua scheda puoi anche vedere il suo registro: Azione → Visualizza registro.

Quello che vedi	Cosa fare
La procedura guidata dice che la porta 8257 è occupata	La usa un'altra applicazione del NAS. Metti 8364 e vai avanti.
DSM dice che il pacchetto non è compatibile con il tuo modello	Hai scaricato quello di un altro processore. Scarica quello giusto.
Aprendo BolloPrint Agent ti chiede di accedere a DSM	Aprilo dal menu di DSM con l'accesso già effettuato, e con un utente amministratore. Se continua, chiudi quella scheda e riaprilo dal menu.
La pagina dice che l'agente non risponde	Il pacchetto è fermo o si sta avviando. Nel Centro pacchetti, apri BolloPrint Agent, premi Azione → Esegui e aspetta qualche secondo.
Al momento di collegarlo non compare il tuo laboratorio	Compaiono solo i laboratori di cui sei proprietario. Chiedi al proprietario di collegarlo lui.
«Questa richiesta di collegamento non è valida» oppure è scaduta	Torna alla pagina dell'agente e premi di nuovo Collega a BolloPrint.
Dopo aver riavviato il NAS l'agente ci mette un po' a risultare Online	Aspetta qualche minuto: si avvia con DSM e riprova da solo finché il NAS non ha internet.
Non trova nessuna stampante	Il NAS e le stampanti sono nella stessa rete? Se no, aggiungile per IP. Se ne hai appena accesa una, premi Cerca ora. Se hai attivato il firewall di DSM, consenti le porte di BolloPrint Agent (compare nell'elenco delle applicazioni quando crei una regola).
L'agente risulta Nessun segnale recente	Il NAS è spento, senza internet o il pacchetto è fermo.

---

Domande frequenti

Mi serve Docker o Container Manager? No. Il pacchetto non usa container. Se preferisci l'agente in un container, si può fare anche così: lo trovi in Agente su Docker.

Devo aprire porte sul router? No. L'agente chiama BolloPrint verso l'esterno, come quando apri una pagina web. La porta 8257 serve solo per la sua pagina dentro il NAS stesso: non si apre alla tua rete.

Chi può aprire la pagina dell'agente? Solo gli amministratori di DSM, dal suo menu principale. Chi condivide soltanto la tua rete non può aprirla.

Posso cambiare la porta dopo? La procedura guidata la chiede solo durante l'installazione. Per cambiarla bisogna disinstallare e installare di nuovo, e quello è un agente nuovo (vedi «Spostarlo su un altro NAS o reinstallarlo», più in alto).

E se spengo o riavvio il NAS? Non succede nulla. L'agente si avvia da solo con DSM e si ricollega senza chiederti niente.