📦 Agente su QNAP

Come mettere l'agente locale su un NAS QNAP senza Docker, come un'applicazione qualsiasi dell'App Center. Se preferisci usare Container Station (Docker), segui Agente su Docker: funziona altrettanto bene.

---

Prima di iniziare

• Un NAS QNAP con QTS 4.5 o successivo, sempre acceso e nella stessa rete delle stampanti.
• Un account amministratore di QTS: serve per installare e per aprire la pagina dell'agente.
• Essere il proprietario del laboratorio in BolloPrint. Solo il proprietario può aggiungere agenti.
• Sapere che processore ha il tuo QNAP. Lo trovi nella scheda del tuo modello sul sito di QNAP, oppure in QTS, in Pannello di controllo → Sistema → Stato del sistema.

Processore del tuo QNAP	Download
Intel o AMD (la maggior parte dei modelli)	Intel o AMD (64 bit)
ARM a 64 bit (per esempio, serie TS-x33, TS-x28A, TS-x32X)	ARM (64 bit)
ARM a 32 bit (per esempio, serie TS-x31P, TS-x31X)	ARM (32 bit)

L'agente è leggero: non ha bisogno di un dispositivo potente.

---

Scaricarlo

1. In BolloPrint, vai su Impostazioni → Stampanti e apri la scheda Agente locale.
2. Premi Nuovo agente e scegli la scheda QNAP.
3. Scarica il pacchetto per il processore del tuo QNAP. È un file che finisce in .qpkg.

Lì stesso trovi i passi riassunti. Qui non si crea ancora niente: l'agente comparirà nel tuo elenco quando lo colleghi.

---

Installarlo sul QNAP

Visto che l'agente non è ancora nello store di QNAP, si installa a mano. Sono cinque passi:

1. Entra in QTS con il tuo account amministratore e apri l'App Center.
2. Apri le sue impostazioni (l'icona ⚙ in alto a destra) e attiva Consenti l'installazione di applicazioni senza una firma digitale valida. Salva.
3. Premi l'icona di installazione manuale: delle scatoline con un +, in alto a destra, subito a sinistra dell'⚙. Non ha testo; passaci sopra col mouse per vederne il nome. Scegli il file .qpkg che hai scaricato e premi Installa.
4. QTS ti avvisa che l'applicazione non ha una firma digitale. Accetta: è normale finché l'agente non è pubblicato nello store di QNAP.
5. Quando ha finito, BolloPrint Agent compare tra le tue applicazioni. Premi Apri.

Se preferisci non lasciare attiva l'opzione del passo 2, puoi disattivarla appena finisce l'installazione. Dovrai riattivarla per il prossimo aggiornamento.

---

Collegarlo al tuo laboratorio

Quando premi Apri, QTS ti porta alla pagina dell'agente. Quella pagina la vede solo un amministratore di QTS con la sessione aperta; a chiunque altro chiede di accedere a QTS.

1. La pagina dice che l'agente non appartiene ancora a nessun laboratorio e mostra un codice breve. Premi Collega a BolloPrint.
2. Si apre BolloPrint. Se non avevi la sessione aperta, accedi con il tuo account.
3. Se sei proprietario di più laboratori, scegli a quale aggiungerlo. Compaiono solo i laboratori di cui sei proprietario.
4. Controlla che il codice mostrato da BolloPrint sia lo stesso della 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.

In meno di un minuto lo vedrai Online in Impostazioni → Stampanti → Agente locale, con il logo di QNAP. Da lì in poi è tutto uguale a qualsiasi altro agente: le stampanti della tua rete compaiono da sole perché tu le aggiunga, oppure le aggiungi per IP. Lo spiega L'agente 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 già:

1. Scarica la versione nuova da Impostazioni → Stampanti → Agente locale → Nuovo agente → QNAP, quella per lo stesso processore.
2. Nell'App Center, controlla che sia ancora attiva l'opzione Consenti l'installazione di applicazioni senza una firma digitale valida.
3. Premi l'icona di installazione manuale (le scatoline con un +, accanto all'⚙), scegli il file nuovo, premi Installa e accetta l'avviso sulla firma.

QTS sostituisce il programma e lascia intatti i suoi dati: l'agente resta collegato al tuo laboratorio, con le sue stampanti e il suo storico. Non serve collegarlo di nuovo. Se dopo l'aggiornamento la sua pagina ti proponesse di nuovo Collega a BolloPrint, collegalo ed elimina in BolloPrint l'agente vecchio, che sarà rimasto scollegato.

---

Spostarlo, reinstallarlo o toglierlo

Reinstallarlo o spostarlo su un altro NAS significa collegarne uno nuovo: installalo sul nuovo dispositivo e collegalo come la prima volta. Sarà un nuovo agente nel tuo elenco. Le stampanti passano a lui, con tutto il loro storico, appena le aggiungi. Poi elimina quello vecchio dal menu ⋮ della sua riga.

Per toglierlo del tutto:

1. In BolloPrint, elimina l'agente dal menu ⋮ della sua riga in Impostazioni → Stampanti → Agente locale. Smette di collegarsi all'istante, e le stampanti che arrivavano solo tramite lui spariscono dall'elenco (se le aggiungi di nuovo, tornano con il loro storico).
2. Nell'App Center di QTS, apri BolloPrint Agent e premi Rimuovi. Si cancella insieme ai suoi dati.

Se fai solo il passo 1, l'agente resta installato e senza laboratorio: in pochi secondi la sua pagina torna a proporre Collega a BolloPrint.

---

Quando qualcosa non va

Sintomo	Cosa guardare
QTS non lascia installare il file	È attiva Consenti l'installazione di applicazioni senza una firma digitale valida? Se dice che non è compatibile, hai scaricato il pacchetto per un altro processore: scarica di nuovo quello giusto. Se il tuo QTS è precedente alla 4.5, aggiornalo prima.
Quando premi Apri ti chiede di accedere a QTS	La pagina dell'agente si apre solo a un amministratore. Entra in QTS con un account amministratore e premi di nuovo Apri dall'App Center.
Apri dà errore o una pagina bianca	Controlla nell'App Center che BolloPrint Agent sia in esecuzione e, se non lo è, avvialo. Se non cambia nulla, guarda il registro di sistema di QTS (in QTS 5, QuLog Center) e cerca «BolloPrint Agent»: se dice che la sua porta è occupata, un'altra applicazione usa la 8257 e la 8364. Scrivici e ti aiutiamo a cambiarla.
Durante il collegamento dice che non è riuscito a contattare BolloPrint	Il QNAP ha bisogno di uscire su internet. Controlla la sua connessione e il suo DNS in Pannello di controllo → Rete.
BolloPrint dice che non sei proprietario di nessun laboratorio	Solo il proprietario del laboratorio può aggiungere agenti. Chiedigli di collegarlo lui.
L'agente non risulta Online	Aspetta un minuto. Se non compare, controlla nell'App Center che sia in esecuzione e che il QNAP arrivi a internet.
Non rileva nessuna stampante	Il QNAP e le stampanti sono nella stessa rete? Se non lo sono (VLAN, rete ospiti), aggiungile a mano per IP e funzioneranno lo stesso. Se sono nella stessa rete e comunque non compaiono, aggiungile per IP e raccontacelo: ci aiuta a migliorare la beta.

Non serve aprire porte sul router né sul firewall del QNAP: la connessione con BolloPrint esce dalla tua rete verso l'esterno, e la pagina dell'agente passa attraverso QTS stesso.