Portuguese English Spanish
Portuguese English Spanish
Breadcrumbs

Instalar el agente DCA and Cloud Connector en Linux (demás distribuciones)

Para comenzar la monitorización de tus dispositivos, es imprescindible instalar el agente de DCA and Cloud Connector.

Aviso

Si utiliza el gateway para comunicarse entre el agente y el portal, siga estos pasos antes de instalar el agente DCA and Cloud Connector:

  1. Instale el Gateway Connector en Windows

  2. Transfiera el certificado del gateway de Windows a Linux

Instrucciones

Información

Por el momento, el agente para Linux solo permite la monitorización de contadores, consumibles y eventos de impresoras de red (servicio NDD - Printer Monitor) e impresoras USB (servicio NDD - Printer Monitor USB).

Para impresoras USB (servicio NDD - Printer Monitor USB), consulte los modelos compatibles en Configurar el agente DCA and Cloud Connector en Linux.

Observación

Este paso a paso ha sido homologado para la distribución Fedora, pero es compatible con otras distribuciones Linux.

Para la instalación en distribuciones basadas en Ubuntu, consulte la documentación específica: Instalar el agente DCA and Cloud Connector en Linux (Ubuntu y distribuciones basadas en Ubuntu).

  1. Cree los clientes dónde se instalarán los agentes

  2. Compruebe los requisitos previos de instalación

  3. Compruebe que el ordenador está conectado a Internet

  4. Prepare el entorno

  5. Abra el terminal

Instalación manual
Paso 1: instalar la biblioteca libusb1

Observación

Esta instalación solo es necesaria para la monitorización de impresoras USB.

  1. Ejecute el siguiente comando en el terminal para instalar la biblioteca:

Bash
sudo dnf install libusb1-devel
Paso 2: descargar el archivo ndd-package.sig

  1. Ejecute el siguiente comando en el terminal para descargar el archivo:

sudo wget https://packages-orbix.ndd.tech/generic-linux/ndd-package.sig
Paso 3: descargar e importar la clave de firma

  1. Ejecute el siguiente comando en el terminal para descargar la clave:

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

  1. Ejecute el siguiente comando en el terminal para importar la clave:

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

Una vez completada la importación, verifique que el archivo ndd-package.sig pertenece a NDD ejecutando el siguiente comando:

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

Al ejecutar el comando, debe devolver la respuesta de abajo, entre otras informaciones:

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

Paso 4: conceder el permiso para ejecutar el archivo

  1. Ejecute el siguiente comando en el terminal para comprobar que los archivos se encuentran en la carpeta de instalación:

ls -l

Al ejecutar el comando, deben aparecer los siguientes archivos:

ndd-package.sh
ndd-package.sig

  1. Ejecute el siguiente comando en el terminal para conceder permiso de ejecución:

sudo chmod +x ndd-package.sh
Paso 5: instalar el agente

  1. Ejecute el siguiente comando en el terminal para instalar el agente:

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

  1. Introduzca el Tenant (nombre del distribuidor) y pulse Enter

Consejo

Cómo localizar la información en el portal:

  • Nombre del distribuidor: en la esquina superior derecha, debajo de su nombre:

image-20250528-181050.png

  1. Introduzca la Organization ID (clave de identificación del cliente) y pulse Enter

Consejo

Cómo localizar la información en el portal:

  • Llave de identificación del cliente: en las propiedades del cliente:

  1. Accede al menú Administración > Clientes

  2. Haga clic en el nombre del cliente deseado para abrir sus propiedades

  3. En la pestaña Registro, copie la Llave de identificación

image-20250528-181122.png

El agente y el servicio se instalarán en el ordenador.

Paso 6: configurar la comunicación con el agente

Comunicación directa

No se requiere ninguna acción.


Comunicación por proxy

Para establecer el tipo de comunicación entre el agente y el portal mediante proxy:

  1. Ejecute el siguiente comando en el terminal para configurar el proxy:

sudo ndd-proxy-config

  1. En Insert proxy address, introduzca la dirección IP o el hostname del proxy y pulse Enter

  2. En Insert proxy port, introduzca el puerto del proxy y pulse Enter

  3. En Use authentication?, introduzca y si desea utilizar la autenticación o n si no lo desea, y pulse Enter

    1. Si desea utilizar la autenticación:

      1. En Insert proxy user, introduzca el usuario de autenticación del proxy y pulse Enter

      2. En Insert proxy password, introduzca la contraseña de autenticación del proxy y pulse Enter

    2. Si no desea utilizar la autenticación, pulse Enter en ambos campos

  4. Ejecute el siguiente comando en el terminal para habilitar el proxy:

sudo ndd-proxy-config --enable

  1. Ejecute el siguiente comando en el terminal para reiniciar el servicio NDD - DCA and Cloud Connector:

sudo systemctl restart NDDDCAandCloudConnector

  1. Ejecute el siguiente comando en el terminal para reiniciar el servicio NDD - Printer Monitor:

sudo systemctl restart NDDPrinterMonitor

  1. Ejecute el siguiente comando en el terminal para reiniciar el servicio NDD - Printer Monitor USB:

sudo systemctl restart NDDPrinterUsbMonitor


Comunicación por gateway

Para establecer el tipo de comunicación entre el agente y el portal mediante gateway:

  1. Ejecute el siguiente comando en el terminal para configurar el gateway:

sudo ndd-gateway-config

  1. En Insert Gateway Connector host, introduzca la dirección IP o el hostname del ordenador/servidor donde se instaló el Gateway Connector, y pulse Enter

  2. En Insert Gateway Connector port, introduzca el puerto del gateway y pulse Enter
    El puerto por defecto del gateway es 9635, pero puedes introducir otro puerto si lo deseas.

  3. Ejecute el siguiente comando en el terminal para habilitar el gateway:

sudo ndd-gateway-config --enable

  1. Ejecute el siguiente comando en el terminal para reiniciar el servicio NDD - DCA and Cloud Connector:

sudo systemctl restart NDDDCAandCloudConnector

  1. Ejecute el siguiente comando en el terminal para reiniciar el servicio NDD - Printer Monitor:

sudo systemctl restart NDDPrinterMonitor

  1. Ejecute el siguiente comando en el terminal para reiniciar el servicio NDD - Printer Monitor USB:

sudo systemctl restart NDDPrinterUsbMonitor
Instalación silenciosa

El script ndd-package.sh no muestra mensajes en la terminal. Sin embargo, durante la primera instalación, el script postinst del paquete ndd-dca-and-cloud-connector solicita el TENANT y el ORGANIZATION_ID si el archivo /etc/orbix/agent/appsettings.json aún no existe y dicha información no se ha definido.

Para mantener la instalación silenciosa, especifica TENANT y ORGANIZATION_ID en el comando. Pasa las variables junto con sudo; un export ejecutado antes de sudo no llega al instalador.

Parámetros para la instalación silenciosa de DCA and Cloud Connector en Linux

Parámetro

Descripción

Obligatorio

Estándar

Aplicación

TENANT

Nombre del distribuidor

Sí, en la primera instalación

Si no se especifica, se solicitará en la terminal

DCA and Cloud Connector y servicios

ORGANIZATION_ID

Clave de identificación del cliente

Sí, en la primera instalación

Si no se especifica, se solicitará en la terminal

DCA and Cloud Connector y servicios

N.N.N

Versión del agente de DCA and Cloud Connector que se va a instalar

No

Si no se especifica, se instalará la versión current

DCA and Cloud Connector

GATEWAY_HOST

Dirección IP o hostname del ordenador/servidor donde se ha instalado el Gateway Connector

No

127.0.0.1

DCA and Cloud Connector

GATEWAY_PORT

Puerto del Gateway Connector

No

9635

DCA and Cloud Connector

PACKAGE_SOURCE

Dirección de origen de los paquetes

No

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

Todos los paquetes genéricos

TENANT y ORGANIZATION_ID también se aplican a los servicios si están definidos en el momento de su instalación. No solicitan esta información en el terminal.

Elige una de las siguientes opciones para instalar el agente de DCA and Cloud Connector:

Instalar el agente de DCA and Cloud Connector con comunicación directa

  1. Copia el siguiente comando:

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

  2. Pégalo en el terminal

  3. Sustituye tenant-name por el nombre del distribuidor

Consejo

Cómo localizar la información en el portal:

  • Nombre del distribuidor: en la esquina superior derecha, debajo de su nombre:

image-20250528-181050.png

  1. Sustituye client-id por la clave de identificación del cliente

Consejo

Cómo localizar la información en el portal:

  • Llave de identificación del cliente: en las propiedades del cliente:

image-20250528-181122.png

  1. Accede al menú Administración > Clientes

  2. Haga clic en el nombre del cliente deseado para abrir sus propiedades

  3. En la pestaña Registro, copie la Llave de identificación

  1. Sustituya 1.2.3 por la versión específica del agente o elimine 1.2.3 para instalar la versión más reciente

  2. Si desea reinstalar la misma versión, sustituya el 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. Ejecuta el comando adaptado para instalar el agente

Instalar el agente DCA and Cloud Connector con comunicación mediante gateway

  1. Copia el siguiente comando:

    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. Pégalo en el terminal

  3. Sustituye tenant-name por el nombre del distribuidor

Consejo

Cómo localizar la información en el portal:

  • Nombre del distribuidor: en la esquina superior derecha, debajo de su nombre:

image-20250528-181050.png

  1. Sustituye client-id por la clave de identificación del cliente

Consejo

Cómo localizar la información en el portal:

  • Llave de identificación del cliente: en las propiedades del cliente:

image-20250528-181122.png

  1. Accede al menú Administración > Clientes

  2. Haga clic en el nombre del cliente deseado para abrir sus propiedades

  3. En la pestaña Registro, copie la Llave de identificación

  1. Si deseas, sustituye 127.0.0.1 por la dirección IP o el hostname del ordenador o servidor en el que se ha instalado el Gateway Connector

  2. Si deseas, sustituye 9635 por el puerto del Gateway Connector

  3. Sustituya 1.2.3 por la versión específica del agente o elimine 1.2.3 para instalar la versión más reciente

  4. Si desea reinstalar la misma versión, sustituya el 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. Ejecuta el comando adaptado para instalar el agente

Eliminar el agente DCA and Cloud Connector

  1. Ejecuta el siguiente comando en el terminal para desinstalar el agente:

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

Instala el servicio de monitorización de impresoras en red y/o de impresoras USB:

Instalar el servicio de monitorización de impresoras en red

Sigue los pasos que se indican a continuación para instalar el servicio NDD - Printer Monitor:

  1. Copia el siguiente comando:

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

  2. Pégalo en el terminal

  3. Sustituye tenant-name por el nombre del distribuidor

Consejo

Cómo localizar la información en el portal:

  • Nombre del distribuidor: en la esquina superior derecha, debajo de su nombre:

image-20250528-181050.png

  1. Sustituye client-id por la clave de identificación del cliente

Consejo

Cómo localizar la información en el portal:

  • Llave de identificación del cliente: en las propiedades del cliente:

image-20250528-181122.png

  1. Accede al menú Administración > Clientes

  2. Haga clic en el nombre del cliente deseado para abrir sus propiedades

  3. En la pestaña Registro, copie la Llave de identificación

  1. Ejecuta el comando adaptado para instalar el agente

Instalar el servicio de monitorización de impresoras USB

Sigue los pasos que se indican a continuación para instalar el servicio NDD - Printer Monitor USB:

  1. Copia el siguiente comando:

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

  2. Pégalo en el terminal

  3. Sustituye tenant-name por el nombre del distribuidor

Consejo

Cómo localizar la información en el portal:

  • Nombre del distribuidor: en la esquina superior derecha, debajo de su nombre:

image-20250528-181050.png

  1. Sustituye client-id por la clave de identificación del cliente

Consejo

Cómo localizar la información en el portal:

  • Llave de identificación del cliente: en las propiedades del cliente:

image-20250528-181122.png

  1. Accede al menú Administración > Clientes

  2. Haga clic en el nombre del cliente deseado para abrir sus propiedades

  3. En la pestaña Registro, copie la Llave de identificación

  1. Ejecuta el comando adaptado para instalar el agente

Last updated: