Introduction

This guide describes the steps to set up the NPM Collector using an OpsRamp ISO/OVA-based deployment.

Prerequisites

Before you begin, ensure that the following requirements are met:

• A virtual machine (VM) deployed using the OpsRamp ISO or OVA image.
• SSH access to the VM.
• Network connectivity from the VM to the OpsRamp cloud.
• An OpsRamp tenant account with administrative access.

Step 1: Get the activation token

1. Log in to the OpsRamp portal.
2. Navigate to Setup > Account > Collector Profiles.
3. Click + Add.
4. Enter a profile name.
5. Copy the activation token displayed on the page.

Step 2: Install and register the gateway

1. SSH into the VM.
2. Run the following command:

sudo opsramp-collector-start install \
  -u url.net \
  -k <YOUR_ACTIVATION_TOKEN> \
  -R us-central1-docker.pkg.dev \
  -V 21.0.0 \
  -t enable

3. Wait for 3 to 5 minutes for all pods to initialize.

Step 3: Verify gateway status

1. On the VM, run:

sudo k3s kubectl get pods

2. Verify that the following pods are in the Running state:

3. In the portal, navigate to Setup > Account > Collector Profiles.
4. Confirm that the gateway status is displayed as CONNECTED.

Step 4: Install NPM Collector integration

1. In the portal, navigate to Setup > Account > Integrations.
2. Click + Add on the Installed Integrations page.
3. Search for NPM Collector and click Add.
4. In the Configuration tab, click + Add.
5. Provide the configuration details:

6. Click Add to save the configuration.
7. Click Next to proceed to the Installation tab.
8. Select the gateway with status CONNECTED.
9. Click Finish.

Step 5: Verify NPM Collector deployment

1. On the VM, run:

sudo k3s kubectl get pods | grep npm

2. Verify that the npm-collector-* pod is in the Running state with 2/2 containers ready.