Portuguese English Spanish
Portuguese English Spanish
Breadcrumbs

Instalar o agente DCA and Cloud Connector no Linux (demais distribuições)

A instalação do agente DCA and Cloud Connector é essencial para iniciar o monitoramento de seus dispositivos.

Aviso

Se o gateway for utilizado para comunicação entre o agente e o portal, siga estes passos antes de instalar o agente DCA and Cloud Connector:

  1. Instale o Gateway Connector no Windows

  2. Transfira o certificado do gateway do Windows para o Linux

Instruções

Informação

No momento, o agente para Linux contempla apenas o monitoramento de contadores, suprimentos e eventos de impressoras de rede (serviço NDD - Printer Monitor) e impressoras USB (serviço NDD - Printer Monitor USB).

Para impressoras USB (serviço NDD - Printer Monitor USB), consulte os modelos compatíveis em Configurar o agente DCA and Cloud Connector no Linux.

Observação

Este passo a passo foi homologado na distribuição Fedora, mas é compatível com outras distribuições Linux.

Para a instalação em distribuições baseadas no Ubuntu, consulte a documentação específica: Instalar o agente DCA and Cloud Connector no Linux (Ubuntu e distribuições baseadas no Ubuntu).

  1. Crie os clientes onde os agentes serão instalados

  2. Verifique os pré-requisitos de instalação

  3. Verifique se o computador está conectado com a internet

  4. Prepare o ambiente

  5. Abra o terminal

Instalar manualmente
Passo 1: instalar a biblioteca libusb1

Observação

Esta instalação é necessária apenas para o monitoramento de impressoras USB.

  1. Execute o comando abaixo no terminal para instalar a biblioteca:

    Bash
    sudo dnf install libusb1-devel
Passo 2: baixar o arquivo ndd-package.sig

  1. Execute o comando abaixo no terminal para baixar o arquivo:

    Bash
    sudo wget https://packages-orbix.ndd.tech/generic-linux/ndd-package.sig
Passo 3: baixar e importar a chave de assinatura

  1. Execute o comando abaixo no terminal para baixar a chave:

    Bash
    sudo wget -O /usr/share/keyrings/ndd.public https://packages-orbix.ndd.tech/generic-linux/ndd.public

  1. Execute o comando abaixo no terminal para importar a chave:

    Bash
    sudo gpg --import /usr/share/keyrings/ndd.public

Com a importação concluída, verifique se o arquivo ndd-package.sig é de propriedade da NDD, executando o comando abaixo:

Bash
sudo gpg --output ndd-package.sh --decrypt ndd-package.sig

Ao executar o comando, deverá retornar a resposta abaixo entre as demais informações:

Good signature from "NDD Print <print@ndd.tech>"

Passo 4: conceder a permissão de execução do arquivo

  1. Execute o comando abaixo no terminal para verificar se os arquivos estão na pasta de instalação:

    Bash
    ls -l

Ao executar o comando, os arquivos abaixo deverão ser listados:

ndd-package.sh
ndd-package.sig

  1. Execute o comando abaixo no terminal para conceder a permissão de execução:

    Bash
    sudo chmod +x ndd-package.sh
Passo 5: instalar o agente

  1. Execute o comando abaixo no terminal para instalar o agente:

    Bash
    sudo ./ndd-package.sh install ndd-dca-and-cloud-connector

  1. Insira o Tenant (nome do provedor) e pressione Enter

Dica

Como localizar a informação no portal:

  • Nome do provedor: no canto superior direito, abaixo do seu nome:

image-20250528-175600.png

  1. Insira o Organization ID (chave de identificação do cliente) e pressione Enter

Dica

Como localizar a informação no portal:

  • Chave de identificação do cliente: nas propriedades do cliente:

  1. Acesse o menu Administração > Clientes

  2. Clique no nome do cliente desejado para abrir suas propriedades

  3. Na aba Cadastro, copie a Chave de identificação

image-20250528-180030.png

O agente e o serviço serão instalados no computador.

Passo 6: configurar a comunicação do agente

Comunicação direta

Nenhuma ação é necessária.


Comunicação por proxy

Para estabelecer o tipo de comunicação entre o agente e o portal por proxy:

  1. Execute o comando abaixo no terminal para configurar o proxy:

    Bash
    sudo ndd-proxy-config

  2. Em Insert proxy address, insira o endereço IP ou hostname do proxy e pressione Enter

  3. Em Insert proxy port, insira a porta do proxy e pressione Enter

  4. Em Use authentication?, digite y se desejar utilizar autenticação ou n se não deseja, e pressione Enter

    1. Se desejar utilizar autenticação:

      1. Em Insert proxy user, insira o usuário de autenticação do proxy e pressione Enter

      2. Em Insert proxy password, insira a senha de autenticação do proxy e pressione Enter

    2. Se não desejar utilizar autenticação, apenas pressione Enter em ambos os campos

  5. Execute o comando abaixo no terminal para habilitar o proxy:

    Bash
    sudo ndd-proxy-config --enable

  6. Execute o comando abaixo no terminal para reiniciar o serviço NDD - DCA and Cloud Connector:

    Bash
    sudo systemctl restart NDDDCAandCloudConnector

  7. Execute o comando abaixo no terminal para reiniciar o serviço NDD - Printer Monitor:

    Bash
    sudo systemctl restart NDDPrinterMonitor

  8. Execute o comando abaixo no terminal para reiniciar o serviço NDD - Printer Monitor USB:

    Bash
    sudo systemctl restart NDDPrinterUsbMonitor


Comunicação por gateway

Para estabelecer o tipo de comunicação entre o agente e o portal por gateway:

  1. Execute o comando abaixo no terminal para configurar o gateway:

    Bash
    sudo ndd-gateway-config

  2. Em Insert Gateway Connector host, insira o endereço IP ou hostname do computador/servidor onde o Gateway Connector foi instalado, e pressione Enter

  3. Em Insert Gateway Connector port, insira a porta do gateway e pressione Enter
    A porta padrão do gateway é a 9635, mas é possível inserir outra porta, se desejar.

  4. Execute o comando abaixo no terminal para habilitar o gateway:

    Bash
    sudo ndd-gateway-config --enable

  5. Execute o comando abaixo no terminal para reiniciar o serviço NDD - DCA and Cloud Connector:

    Bash
    sudo systemctl restart NDDDCAandCloudConnector

  6. Execute o comando abaixo no terminal para reiniciar o serviço NDD - Printer Monitor:

    Bash
    sudo systemctl restart NDDPrinterMonitor

  7. Execute o comando abaixo no terminal para reiniciar o serviço NDD - Printer Monitor USB:

    Bash
    sudo systemctl restart NDDPrinterUsbMonitor
Instalar silenciosamente

O script ndd-package.sh não faz perguntas no terminal. Porém, na primeira instalação, o postinst do pacote ndd-dca-and-cloud-connector solicita o TENANT e o ORGANIZATION_ID se o arquivo /etc/orbix/agent/appsettings.json ainda não existir e essas informações não tiverem sido definidas.

Para manter a instalação silenciosa, informe TENANT e ORGANIZATION_ID no comando. Passe as variáveis junto ao sudo; um export executado antes do sudo não chega ao instalador.

Parâmetros da instalação silenciosa do DCA and Cloud Connector no Linux

Parâmetro

Descrição

Obrigatoriedade

Padrão

Aplicação

TENANT

Nome do provedor

Sim, na primeira instalação

Se não informado, será solicitado no terminal

DCA and Cloud Connector e serviços

ORGANIZATION_ID

Chave de identificação do cliente

Sim, na primeira instalação

Se não informado, será solicitado no terminal

DCA and Cloud Connector e serviços

N.N.N

Versão do agente DCA and Cloud Connector a instalar

Não

Se não informada, a versão current é instalada

DCA and Cloud Connector

GATEWAY_HOST

Endereço IP ou hostname do computador/servidor onde o Gateway Connector foi instalado

Não

127.0.0.1

DCA and Cloud Connector

GATEWAY_PORT

Porta do Gateway Connector

Não

9635

DCA and Cloud Connector

PACKAGE_SOURCE

Endereço de origem dos pacotes

Não

https://packages-orbix.ndd.tech/generic-linux

Todos os pacotes genéricos

TENANT e ORGANIZATION_ID também são aplicados aos serviços se estiverem definidos no momento da instalação deles. Eles não solicitam essas informações no terminal.

Escolha uma das opções abaixo para instalar o agente DCA and Cloud Connector:

Instalar o agente DCA and Cloud Connector com comunicação direta

  1. Copie o comando abaixo:

    Bash
    sudo TENANT="tenant-name" \
     ORGANIZATION_ID="client-id" \
     ./ndd-package.sh install ndd-dca-and-cloud-connector 1.2.3

  2. Cole no terminal

  3. Substitua tenant-name pelo nome do provedor

Dica

Como localizar a informação no portal:

  • Nome do provedor: no canto superior direito, abaixo do seu nome:

Unknown Attachment

  1. Substitua client-id pela chave de identificação do cliente

Dica

Como localizar a informação no portal:

  • Chave de identificação do cliente: nas propriedades do cliente:

  1. Acesse o menu Administração > Clientes

  2. Clique no nome do cliente desejado para abrir suas propriedades

  3. Na aba Cadastro, copie a Chave de identificação

Unknown Attachment

  1. Substitua 1.2.3 pela versão específica do agente ou remova 1.2.3 para instalar a versão mais recente

  2. Se desejar reinstalar a mesma versão, substitua o comando ./ndd-package.sh install ndd-dca-and-cloud-connector 1.2.3 por ./ndd-package.sh force-install ndd-dca-and-cloud-connector

  3. Execute o comando ajustado para instalar o agente

Instalar o agente DCA and Cloud Connector com comunicação por gateway

  1. Copie o comando abaixo:

    Bash
    sudo TENANT="tenant-name" \
     ORGANIZATION_ID="client-id" \
     GATEWAY_HOST="127.0.0.1" \
     GATEWAY_PORT="9635" \
     ./ndd-package.sh install ndd-dca-and-cloud-connector 1.2.3

  2. Cole no terminal

  3. Substitua tenant-name pelo nome do provedor

Dica

Como localizar a informação no portal:

  • Nome do provedor: no canto superior direito, abaixo do seu nome:

Unknown Attachment

  1. Substitua client-id pela chave de identificação do cliente

Dica

Como localizar a informação no portal:

  • Chave de identificação do cliente: nas propriedades do cliente:

  1. Acesse o menu Administração > Clientes

  2. Clique no nome do cliente desejado para abrir suas propriedades

  3. Na aba Cadastro, copie a Chave de identificação

image-20250528-180030.png

  1. Se desejar, substitua 127.0.0.1 pelo endereço IP ou hostname do computador/servidor onde o Gateway Connector foi instalado

  2. Se desejar, substitua 9635 pela porta do Gateway Connector

  3. Substitua 1.2.3 pela versão específica do agente ou remova 1.2.3 para instalar a versão mais recente

  4. Se desejar reinstalar a mesma versão, substitua o comando ./ndd-package.sh install ndd-dca-and-cloud-connector 1.2.3 por ./ndd-package.sh force-install ndd-dca-and-cloud-connector

  5. Execute o comando ajustado para instalar o agente

Remover o agente DCA and Cloud Connector

  1. Execute o comando abaixo no terminal para desinstalar o agente:

    Bash
    sudo ./ndd-package.sh remove ndd-dca-and-cloud-connector

Instale o serviço de monitoramento de impressoras de rede e/ou de impressoras USB:

Instalar o serviço de monitoramento de impressoras de rede

Siga os passos abaixo para instalar o serviço NDD - Printer Monitor:

  1. Copie o comando abaixo:

    Bash
    sudo TENANT="tenant-name" \
     ORGANIZATION_ID="client-id" \
     ./ndd-package.sh install ndd-dca-printer-network-agent

  2. Cole no terminal

  3. Substitua tenant-name pelo nome do provedor

Dica

Como localizar a informação no portal:

  • Nome do provedor: no canto superior direito, abaixo do seu nome:

image-20250528-175600.png

  1. Substitua client-id pela chave de identificação do cliente

Dica

Como localizar a informação no portal:

  • Chave de identificação do cliente: nas propriedades do cliente:

  1. Acesse o menu Administração > Clientes

  2. Clique no nome do cliente desejado para abrir suas propriedades

  3. Na aba Cadastro, copie a Chave de identificação

image-20250528-180030.png

  1. Execute o comando ajustado para instalar o serviço

Instalar o serviço de monitoramento de impressoras USB

Siga os passos abaixo para instalar o serviço NDD - Printer Monitor USB:

  1. Copie o comando abaixo:

    Bash
    sudo TENANT="tenant-name" \
     ORGANIZATION_ID="client-id" \
     ./ndd-package.sh install ndd-dca-printer-monitor-usb-agent

  2. Cole no terminal

  3. Substitua tenant-name pelo nome do provedor

Dica

Como localizar a informação no portal:

  • Nome do provedor: no canto superior direito, abaixo do seu nome:

image-20250528-175600.png

  1. Substitua client-id pela chave de identificação do cliente

Dica

Como localizar a informação no portal:

  • Chave de identificação do cliente: nas propriedades do cliente:

  1. Acesse o menu Administração > Clientes

  2. Clique no nome do cliente desejado para abrir suas propriedades

  3. Na aba Cadastro, copie a Chave de identificação

image-20250528-180030.png

  1. Execute o comando ajustado para instalar o serviço

Last updated: