Índice do manual

📦 Agente no QNAP

Em 30 segundos

Beta. O agente para QNAP é um pacote novo e ainda estamos a aprender com as primeiras oficinas que o usam.
Descarregas-o a partir do BolloPrint (Configurações → Impressoras → Agente local → Novo agente → QNAP) e instalas-o à mão no App Center do QTS.
Abres-o a partir do App Center e carregas em Ligar ao BolloPrint. Sem códigos, sem manifestos e sem abrir portas.
Para o atualizar, instalas o pacote novo por cima do que tens.

Como pôr o agente local num NAS da QNAP sem Docker, como mais uma aplicação do App Center. Se preferires usar o Container Station (Docker), segue Agente no Docker: funciona igualmente bem.

🧪 Isto é uma beta

Testámo-lo do princípio ao fim no QTS 5.2 com processador Intel. Os pacotes para processadores ARM estão publicados, mas ainda não os vimos a funcionar num QNAP a sério. Se tiveres um, ajuda-nos muito que nos contes como correu, quer tenha corrido bem, quer mal.

Antes de começar

Um NAS da QNAP com QTS 4.5 ou posterior, sempre ligado e na mesma rede que as impressoras.
Uma conta de administrador do QTS: é precisa para instalar e para abrir a página do agente.
Ser o proprietário da oficina no BolloPrint. Só o proprietário pode adicionar agentes.
Saber que processador tem o teu QNAP. Vês isso na ficha do teu modelo no site da QNAP, ou no QTS, em Painel de controlo → Sistema → Estado do sistema.

Processador do teu QNAP	Transferência
Intel ou AMD (a maioria dos modelos)	Intel ou AMD (64 bits)
ARM de 64 bits (por exemplo, séries TS-x33, TS-x28A, TS-x32X)	ARM (64 bits)
ARM de 32 bits (por exemplo, séries TS-x31P, TS-x31X)	ARM (32 bits)

O agente é leve: não precisa de um equipamento potente.

Descarregá-lo

No BolloPrint, vai a Configurações → Impressoras e abre o separador Agente local.
Carrega em Novo agente e escolhe o cartão QNAP.
Descarrega o pacote do processador do teu QNAP. É um ficheiro que termina em .qpkg.

Aí mesmo tens os passos resumidos. Aqui ainda não se cria nada: o agente aparece na tua lista quando o ligares.

Instalá-lo no QNAP

Como o agente ainda não está na loja da QNAP, instala-se à mão. São cinco passos:

Entra no QTS com a tua conta de administrador e abre o App Center.
Abre as suas definições (o ícone ⚙ no canto superior direito) e ativa Permitir a instalação de aplicações sem uma assinatura digital válida. Guarda.
Carrega no ícone de instalação manual: umas caixinhas com um +, no canto superior direito, mesmo à esquerda do ⚙. Não tem texto; passa o rato por cima para ver o nome. Escolhe o ficheiro .qpkg que descarregaste e carrega em Instalar.
O QTS avisa-te de que a aplicação não tem assinatura digital. Aceita: é o esperado enquanto o agente não estiver publicado na loja da QNAP.
Quando terminar, o BolloPrint Agent aparece entre as tuas aplicações. Carrega em Abrir.

💡 Sobre o aviso da assinatura

A QNAP assina as aplicações da sua loja. A nossa está à espera de ser publicada lá, por isso, por agora, chega sem essa assinatura e o QTS avisa. O pacote descarrega-lo a partir da tua conta do BolloPrint, que é o único sítio de onde o deves obter.

Se preferires não deixar ativada a opção do passo 2, podes desativá-la assim que a instalação terminar. Vais ter de a voltar a ativar para a próxima atualização.

Ligá-lo à tua oficina

Ao carregares em Abrir, o QTS leva-te à página do agente. Essa página só é vista por um administrador do QTS com sessão iniciada; a qualquer outra pessoa pede que entre no QTS.

A página diz que o agente ainda não pertence a nenhuma oficina e mostra um código curto. Carrega em Ligar ao BolloPrint.
Abre-se o BolloPrint. Se não tinhas a sessão iniciada, entra com a tua conta.
Se és proprietário de mais de uma oficina, escolhe a qual o adicionas. Só aparecem as oficinas de que és proprietário.
Confirma que o código que o BolloPrint mostra é o mesmo que o da página do agente e carrega em Adicionar à oficina.
Voltas à página do agente, que agora diz Ligado a e o nome da tua oficina.

Em menos de um minuto vais vê-lo Online em Configurações → Impressoras → Agente local, com o logótipo da QNAP. A partir daí, tudo é igual a qualquer outro agente: as impressoras da tua rede aparecem sozinhas para as adicionares, ou adicionas-las pelo IP. Está explicado em O agente local.

🔐 Liga só o que acabaste de instalar

Continua no BolloPrint só se acabaste de carregar em Ligar ao BolloPrint no teu próprio QNAP. Se alguém te enviar um link para «ligar um agente», fecha-o.

Atualizá-lo

Quase nunca tens de fazer nada: o agente atualiza-se sozinho. Quando sai uma versão nova, descarrega-a, confirma que é nossa e reinicia com ela.

Só se o BolloPrint te avisar de que o teu agente precisa de uma atualização manual, é instalar o pacote novo por cima do que já tens:

Descarrega a versão nova em Configurações → Impressoras → Agente local → Novo agente → QNAP, a do mesmo processador.
No App Center, confirma que continua ativada a opção Permitir a instalação de aplicações sem uma assinatura digital válida.
Carrega no ícone de instalação manual (as caixinhas com um +, junto ao ⚙), escolhe o ficheiro novo, carrega em Instalar e aceita o aviso da assinatura.

O QTS substitui o programa e deixa os seus dados intactos: o agente continua ligado à tua oficina, com as suas impressoras e o seu histórico. Não é preciso voltar a ligá-lo. Se depois de atualizar a sua página te oferecer Ligar ao BolloPrint outra vez, liga-o e elimina no BolloPrint o agente antigo, que terá ficado desligado.

Mudá-lo, reinstalá-lo ou retirá-lo

Reinstalá-lo ou mudá-lo para outro NAS é ligar um novo: instala-o no equipamento novo e liga-o como da primeira vez. Será um agente novo na tua lista. As impressoras passam para ele, com todo o seu histórico, assim que as adicionares. Depois elimina o antigo a partir do menu ⋮ da sua linha.

Para o retirar de vez:

No BolloPrint, elimina o agente a partir do menu ⋮ da sua linha em Configurações → Impressoras → Agente local. Deixa de se ligar no momento, e as impressoras que só chegavam por ele desaparecem da lista (se as voltares a adicionar, voltam com o seu histórico).
No App Center do QTS, abre o BolloPrint Agent e carrega em Remover. Apaga-se com os seus dados.

Se fizeres só o passo 1, o agente fica instalado e sem oficina: a sua página volta a oferecer Ligar ao BolloPrint em poucos segundos.

Quando algo não funciona

Sintoma	O que ver
O QTS não deixa instalar o ficheiro	Está ativada a opção Permitir a instalação de aplicações sem uma assinatura digital válida? Se diz que não é compatível, descarregaste o pacote de outro processador: volta a descarregar o certo. Se o teu QTS é anterior à 4.5, atualiza-o primeiro.
Ao carregar em Abrir pede que inicies sessão no QTS	A página do agente só abre para um administrador. Entra no QTS com uma conta de administrador e volta a carregar em Abrir a partir do App Center.
Abrir dá erro ou uma página em branco	Confirma no App Center que o BolloPrint Agent está em execução e, se não estiver, arranca-o. Se continuar igual, vê o registo do sistema do QTS (no QTS 5, QuLog Center) e procura «BolloPrint Agent»: se disser que a sua porta está ocupada, outra aplicação usa a 8257 e a 8364. Escreve-nos e ajudamos-te a mudá-la.
Ao ligar diz que não conseguiu falar com o BolloPrint	O QNAP precisa de saída para a internet. Confirma a sua ligação e o seu DNS em Painel de controlo → Rede.
O BolloPrint diz que não és proprietário de nenhuma oficina	Só o proprietário da oficina pode adicionar agentes. Pede-lhe que seja ele a ligá-lo.
O agente não aparece Online	Espera um minuto. Se não aparecer, vê no App Center se está em execução e se o QNAP chega à internet.
Não deteta nenhuma impressora	O QNAP e as impressoras estão na mesma rede? Se não estiverem (VLAN, rede de convidados), adiciona-as à mão pelo IP e funcionam na mesma. Se estão na mesma rede e mesmo assim não aparecem, adiciona-as por IP e conta-nos: ajuda-nos a melhorar a beta.

Não é preciso abrir portas no router nem na firewall do QNAP: a ligação ao BolloPrint sai da tua rede para fora, e a página do agente passa pelo próprio QTS.