Install the agent on Linux (Ubuntu and derivatives)

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 Ubuntu distribution, but is compatible with derivative distributions.

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: register in the NDD installer repository

1. Run the command below in the terminal:

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

2. Run the command below in the terminal:

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

3. Run the command below in the terminal:

sudo apt-get update

After running all the commands, the agent package will be available for installation.

Step 2: install the agent

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

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

2. When requested to confirm, type y and press Enter to proceed with the installation

Step 3: configure the agent

During installation, another screen will open for you to enter the agent's settings:

1. Enter the Tenant name (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.

2. 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

3. To establish the type of communication between the agent and the portal (by proxy, gateway or direct):

   1. Direct: in Do you want to use a proxy? and Do you want to use the Gateway Connector?, select No

   2. Proxy: in Do you want to use a proxy?, select Yes

      1. Enter the Proxy host (IP address or hostname of the proxy) and press Enter

      2. Enter the Proxy port and press Enter

      3. Enter the Proxy user (proxy authentication user), if any, and press Enter

      4. Enter the Proxy password, if any, and press Enter

   3. Gateway: in Do you want to use a proxy?, select No, and in Do you want to use the Gateway Connector?, select Yes

      1. Enter the Gateway Connector host (IP address or hostname of the computer/server where the Gateway Connector was installed)

      2. Enter the Gateway Connector port
         The default gateway port is 9635, but you can enter another port if you wish.

4. When requested to confirm, type y and press Enter to proceed with the installation

The agent and service will be installed on the computer.

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

{{component-feedback-article}}