Install the agent on Linux (other distributions)

To start monitoring your devices, it is essential to install the DCA and Cloud Connector agent.

If the gateway is used for communication between the agent and the portal, follow these steps before installing the DCA and Cloud Connector agent:

1. Install the Gateway Connector on Windows

2. Transfer the gateway certificate from Windows to Linux

For silent (mass) installation, consult the documentation available for the distribution.

Instructions

This step-by-step has been approved for the Fedora distribution, but is compatible with other Linux distributions.

For installation on Ubuntu-based distributions, consult the specific documentation: Install the agent on Linux (Ubuntu and derivatives).

1. Create the customers where the agents will be installed

2. Check the installation prerequisites

3. Check that the computer is connected to the internet

4. Prepare the environment

5. Open the terminal

Step 1: download the file ndd-package.sig

1. Run the command below in the terminal to download the file:

sudo wget https://packages-orbix.ndd.tech/generic-linux/ndd-package.sig

Step 2: download and import the signing key

1. Run the command below in the terminal to download the key:

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

2. Run the command below in the terminal to import the key:

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

Once the import is complete, check that the ndd-package.sig file is owned by NDD by running the command below:

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

When you run the command, it should return the answer below among the other information:

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

Step 3: grant the file execute permission

1. Run the command below in the terminal to check that the files are in the installation folder:

ls -l

When you run the command, the files below should be listed:

ndd-package.sh
ndd-package.sig

2. Run the command below in the terminal to grant execute permission:

sudo chmod +x ndd-package.sh

Step 4: install the agent

1. Run the command below in the terminal to install the agent:

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

2. Enter the Tenant (provider name) and press Enter

To find the provider name in the NDD Orbix portal, click above your name in the upper right corner. Under My Data, the provider name information will be displayed below your name.

3. Enter the Organization ID (customer identification key) and press Enter

To find the customer's identification key in the NDD Orbix portal:

1. Go to the Administration > Customers menu

2. Click on the name of the desired customer to open its properties

3. In the Info tab, copy the Identification key

The agent and service will be installed on the computer.

Next, enable and configure the network printer monitoring service rules.

Step 5: configure agent communication

Direct communication

No action is required.

Proxy communication

To establish the type of communication between the agent and the portal by proxy:

1. Run the command below in the terminal to configure the proxy:

sudo ndd-proxy-config

2. In Insert proxy address, enter the IP address or hostname of the proxy and press Enter

3. In Insert proxy port, enter the proxy port and press Enter

4. In Use authentication?, type y if you want to use authentication or n if you don't, and press Enter

   1. If you want to use authentication:

      1. In Insert proxy user, enter the proxy's authentication user and press Enter

      2. In Insert proxy password, enter the proxy's authentication password and press Enter

   2. If you don't want to use authentication, just press Enter in both fields

5. Run the command below in the terminal to enable the proxy:

sudo ndd-proxy-config --enable

6. Run the command below in the terminal to restart the NDD - DCA and Cloud Connector service:

sudo systemctl restart NDDDCAandCloudConnector

7. Run the command below in the terminal to restart the NDD - Printer Monitor service:

sudo systemctl restart NDDPrinterMonitor

Gateway communication

To establish the type of communication between the agent and the portal by gateway:

1. Run the command below in the terminal to configure the gateway:

sudo ndd-gateway-config

2. In Insert Gateway Connector host, enter the IP address or hostname of the computer/server where the Gateway Connector was installed, and press Enter

3. In Insert Gateway Connector port, enter the gateway port and press Enter
   The default gateway port is 9635, but you can enter another port if you wish.

4. Run the command below in the terminal to enable the gateway:

sudo ndd-gateway-config --enable

5. Run the command below in the terminal to restart the NDD - DCA and Cloud Connector service:

sudo systemctl restart NDDDCAandCloudConnector

6. Run the command below in the terminal to restart the NDD - Printer Monitor service:

sudo systemctl restart NDDPrinterMonitor

{{component-feedback-article}}