Portuguese English Spanish
Portuguese English Spanish
Breadcrumbs

Instalar el agente DCA and Cloud Connector en Linux (Ubuntu y distribuciones basadas en Ubuntu)

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

La instalación también es compatible con dispositivos Raspberry Pi que cumplan los requisitos previos mínimos.

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 Ubuntu y las distribuciones Debian y Mint basadas en Ubuntu.

Otras distribuciones basadas en Ubuntu no han sido homologadas, pero es probable que funcionen. Si tiene cualquier duda o incidencia, póngase en contacto con nuestro equipo de soporte.

  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: registrarse en el repositorio de instaladores de NDD

  1. Ejecute el siguiente comando en el terminal:

sudo wget -O /usr/share/keyrings/ndd.public packages-orbix.ndd.tech/apt-repo/ndd.public

  1. Ejecute el siguiente comando en el terminal:

Bash
echo "deb [arch=amd64 signed-by=/usr/share/keyrings/ndd.public] https://packages-orbix.ndd.tech/apt-repo/  stable main" | sudo tee /etc/apt/sources.list.d/ndd.list

Aviso

Si la instalación se realiza en un dispositivo Raspberry Pi, sustituya el comando anterior por el siguiente:

Bash
echo "deb [arch=arm64 signed-by=/usr/share/keyrings/ndd.public] https://packages-orbix.ndd.tech/apt-repo/  stable main" | sudo tee /etc/apt/sources.list.d/ndd.list

  1. Ejecute el siguiente comando en el terminal:

sudo apt-get update

En las versiones más recientes de algunas distribuciones, el comando sudo apt-get update puede devolver el siguiente error:

image-20260813-140819.png

Esto se debe a que las versiones modernas de apt pueden no aceptar archivos en formato ASCII-armored y exigen una clave en formato .gpg.

Para solucionar el problema, convierte la clave al formato .gpg y actualiza la configuración del repositorio, tal y como se indica a continuación:

  1. Ejecute el siguiente comando en el terminal para comprobar si la clave se encuentra en el archivo:

    Bash
    gpg --show-keys /usr/share/keyrings/ndd.public.

  2. Si es así, ejecute el siguiente comando en el terminal para convertir la clave al formato .gpg:

    Bash
    sudo gpg --dearmor -o /usr/share/keyrings/ndd.gpg /usr/share/keyrings/ndd.public

  3. Ejecute el siguiente comando en el terminal para actualizar la configuración del repositorio:

    Bash
    sudo sed -i 's|signed-by=/usr/share/keyrings/ndd.public|signed-by=/usr/share/keyrings/ndd.gpg|' /etc/apt/sources.list.d/ndd.list 

  4. Ejecute el siguiente comando en el terminal:

    Bash
    sudo apt-get update


Una vez ejecutados todos los comandos, el paquete del agente estará disponible para su instalación.

Paso 2: instalar el agente

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

sudo apt install ndd-dca-and-cloud-connector

  1. Al solicitar confirmación, introduzca y y pulse Enter para continuar con la instalación

Paso 3: configurar el agente

Durante la instalación, se abrirá otra pantalla para que introduzcas las configuraciones del agente:

  1. Introduzca el Tenant name (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

  1. Para establecer el tipo de comunicación entre el agente y el portal (por proxy, gateway o directa):

    1. Directa: en Do you want to use a proxy? y Do you want to use the Gateway Connector?, seleccione No

    2. Proxy: en Do you want to use a proxy?, seleccione Yes

      1. Introduzca el Proxy host (dirección IP o hostname del proxy) y pulse Enter

      2. Introduzca el Proxy port (puerto del proxy) y pulse Enter

      3. Introduzca el Proxy user (usuario de autenticación del proxy), si lo hay, y pulse Enter

      4. Introduzca el Proxy password (contraseña de autenticación del proxy), si lo hay, y pulse Enter

    3. Gateway: en Do you want to use a proxy?, seleccione No, y en Do you want to use the Gateway Connector?, seleccione Yes

      1. Introduzca el Gateway Connector host (dirección IP o hostname del ordenador/servidor donde se instaló el Gateway Connector)

      2. Introduzca el Gateway Connector port (puerto del gateway)
        El puerto por defecto del gateway es 9635, pero puedes introducir otro puerto si lo deseas.

  2. Al solicitar confirmación, introduzca y y pulse Enter para continuar con la instalación

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

Instalación silenciosa

Las variables de entorno no configuran el paquete .deb. El paquete ndd-dca-and-cloud-connector lee la configuración de debconf. Para que la instalación sea silenciosa, guarda las respuestas antes de ejecutar apt y utiliza DEBIAN_FRONTEND=noninteractive en el comando de instalación.

Os serviços não solicitam tenant nem organization_id e dependem do pacote ndd-dca-and-cloud-connector.

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

Parámetro

Descripción

Obligatorio

Estándar

Aplicación

orbix/tenant string

Nombre del distribuidor

Sí, en la primera instalación

-

DCA and Cloud Connector

orbix/organization_id string

Clave de identificación del cliente

Sí, en la primera instalación

-

DCA and Cloud Connector

orbix/configure_proxy select

Habilita o deshabilita el uso del proxy

No

Yes o No

DCA and Cloud Connector

orbix/proxy_host string

Dirección del servidor proxy

Sí, en caso orbix/configure_proxy select Yes

-

DCA and Cloud Connector

orbix/proxy_port string

Puerto del servidor proxy

Sí, en caso orbix/configure_proxy select Yes

-

DCA and Cloud Connector

orbix/proxy_user string

Usuario de autenticación del proxy

No

-

DCA and Cloud Connector

orbix/proxy_pass password

Contraseña de autenticación del proxy

No

-

DCA and Cloud Connector

orbix/configure_gateway select

Habilita o deshabilita el uso del Gateway Connector

No

Yes o No

DCA and Cloud Connector

orbix/gateway_host string

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

Sí, en caso orbix/configure_gateway select Yes

127.0.0.1

DCA and Cloud Connector

orbix/gateway_port string

Puerto del Gateway Connector

Sí, en caso orbix/configure_gateway select Yes

9635

DCA and Cloud Connector

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 debconf-set-selections <<'EOF'
ndd-dca-and-cloud-connector orbix/tenant string TENANT-NAME
ndd-dca-and-cloud-connector orbix/organization_id string CLIENT-ID
ndd-dca-and-cloud-connector orbix/configure_proxy select No
ndd-dca-and-cloud-connector orbix/configure_gateway select No
EOF

sudo DEBIAN_FRONTEND=noninteractive apt-get install -y ndd-dca-and-cloud-connector

  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 agente DCA and Cloud Connector con comunicación mediante proxy

  1. Copia el siguiente comando:

    Bash
    sudo debconf-set-selections <<'EOF'
ndd-dca-and-cloud-connector orbix/tenant string TENANT-NAME
ndd-dca-and-cloud-connector orbix/organization_id string CLIENT-ID
ndd-dca-and-cloud-connector orbix/configure_proxy select Yes
ndd-dca-and-cloud-connector orbix/proxy_host string 127.0.0.1
ndd-dca-and-cloud-connector orbix/proxy_port string 1234
ndd-dca-and-cloud-connector orbix/proxy_user string USER
ndd-dca-and-cloud-connector orbix/proxy_pass password PASSWORD
EOF

sudo DEBIAN_FRONTEND=noninteractive apt-get install -y ndd-dca-and-cloud-connector

  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. Sustituye 127.0.0.1 por la dirección IP del servidor proxy

  2. Sustituye 1234 por el puerto del servidor proxy

  3. Si hay autenticación, sustituye USER y PASSWORD por el nombre de usuario y la contraseña de autenticación del proxy

  4. Si no hay autenticación, elimina estas dos líneas del comando:
    ndd-dca-and-cloud-connector orbix/proxy_user string USER
    ndd-dca-and-cloud-connector orbix/proxy_pass password PASSWORD

  5. 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 debconf-set-selections <<'EOF'
ndd-dca-and-cloud-connector orbix/tenant string TENANT-NAME
ndd-dca-and-cloud-connector orbix/organization_id string CLIENT-ID
ndd-dca-and-cloud-connector orbix/configure_proxy select No
ndd-dca-and-cloud-connector orbix/configure_gateway select Yes
ndd-dca-and-cloud-connector orbix/gateway_host string 127.0.0.1
ndd-dca-and-cloud-connector orbix/gateway_port string 9635
EOF

sudo DEBIAN_FRONTEND=noninteractive apt-get install -y ndd-dca-and-cloud-connector

  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. Ejecuta el comando adaptado para instalar el agente

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. Ejecuta el siguiente comando en el terminal para instalar el servicio:

    Bash
    sudo DEBIAN_FRONTEND=noninteractive apt-get install -y ndd-dca-printer-network-agent
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. Ejecuta el siguiente comando en el terminal para instalar el servicio:

    Bash
    sudo DEBIAN_FRONTEND=noninteractive apt-get install -y ndd-dca-printer-monitor-usb-agent

Last updated: