Overview

OpsRamp’s collector bootstrap is a small and flexible tool designed to simplify and automate day-0 onboarding of all OpsRamp’s collector technologies - agent, gateway into myriad of IT environments - bare-metal, virtualized, containerized and cloud-native environments on various host Linux OS be it either on-prem or in the public cloud.

Once you download the right binary from the cloud platform into your target operating system - Linux, you can instruct the tool via its command line interface (CLI) to kickstart the collector installation. In a single command, the tool not only verifies the host environment that will eventually house the collector but also automates what are currently manual steps around authentication and registration of the collector with the cloud platform. The tool can be optionally instructed, in the same command, to start infrastructure discovery automatically without requiring any additional configuration on the cloud side.

How to Download the Collector Bootstrap Tool?

While the collector bootstrap tool can be downloaded into any machine (into your laptop, for example), the tool is expected to be executed from the same host as you will eventually run the collector. So, please transfer a copy of the binary into the target host if you are downloading this temporarily into your local machine.

Download the bootstrap tool binary

You can download the bootstarp tool either using the binary link or the wget command in that gateway.

Use the below NextGen gateway binary download link for Linux operating system and run it into your environment to download the collector bootstrap tool.

Using wget command

Follow the below steps to download the bootstrap tool using wget command:

  • Run the following command based on the architecture to download the bootstrap tool.

    • Linux:
      • amd64:
        wget  https://storage.googleapis.com/opsramp_cluster_gateway_asserts/collector-cli/linux/amd64/opsramp-collector-start
      • arm64:
        wget  https://storage.googleapis.com/opsramp_cluster_gateway_asserts/collector-cli/linux/arm64/opsramp-collector-start
        bootstrap
    • Windows:
      • amd64:
        https://storage.googleapis.com/opsramp_cluster_gateway_asserts/collector-cli/windows/amd64/opsramp-collector-start.exe
    • MAC:
      • amd64:
        wget  https://storage.googleapis.com/opsramp_cluster_gateway_asserts/collector-cli/mac/amd64/opsramp-collector-start
      • arm64:
        wget  https://storage.googleapis.com/opsramp_cluster_gateway_asserts/collector-cli/mac/arm64/opsramp-collector-start
  • Use the following command to check the bootstrap tool version.
    opsramp-collector-start --version
    bootstrap

Available Commands

CommandsDescription
installDownload and register the collector (agent, gateway)
uninstallUnregister and delete the collector
setupSetup kubernetes and high availability

Available Flag

FlagsDescription
--version (-v)It is used to check the collector version

How to use Bootstrap Tool to Install the NextGen Gateway?

This section describes how to install and uninstall the NextGen gateway using the bootstrap tool.

Step-1: Available flags for installing nextgen gateway

Use the following command to see the available flags. The collector bootstrap needs sudo privileges.

opsramp-collector-start install --help

Flags for installation commands

FlagsDescription
--environment (-e)Environment to install OpsRamp gateway
--url (-u)It is used to specify OpsRamp url
--key (k)Gateway unique authentication token
--skip-prechecksSkip prechecks while gateway registration (true/false)
--gateway-name (-N)Gateway name to show in management profile
--helmchart-version (-V)Helm chart version to deploy in k8s environment
--namespace (-n)Namespace to deploy gateway in k8s environment
--proxy-protocol (-r)Proxy server communication protocol
--proxy-ip (i)Used to get the proxy server ip address
--proxy-port (-p)Used to get the proxy server port
--proxy-username (-u)Used to get the proxy server username
--proxy-password (p)Used to get the proxy server password
--squid-proxy (-S)Enable squid proxy service (enable/disable)
--third-party-app (-t)Enable or disable third party app integration
--config (-c)Initial discovery configuration
--repository (-R)Pull helm charts and images from custom repository (default "us-docker.pkg.dev")
--repo-user (-a)It is used to get repository username
--repo-password (-s)It is used to get repository password
--read-repopass-from-file (-f)It is used to read the repository password from a file
--registration-config (-F)It is used to read the registration configuration data from a yaml file
--storage-class (-C)Storage class name for dynamic provisioning of persistent volumes

Step-2: Get the activation token

To find the activation token and API server url, navigate to Setup > Resources > Management Profile and click on the name of your newly created profile.

Activation auth token: 55c803a1-2e2f-4c07-be95-479dc8fdf7ff

bootstrap

Cloud url API server: gatewaytest.api.opsramp.net

bootstrap

Step-3: Registering the nextgen gateway

Option 1: Registering the nextgen gateway without proxy

opsramp-collector-start install --environment k8s --url {OpsRamp Server URL} --key {Gateway unique authentication token}

Installing gateway in a kubernetes environment:

bootstrap
Pod status:
bootstrap

Option 2: Registering nextgen gateway through proxy

Often customers will not be allowed to connect to their network directly for security reasons, customers will install proxy in their environment and will allow the third party users to connect to their network through proxy.

OpsRamp Gateways are deployed in customer environments, so in order to connect to an outside network from Gateway it needs to pass through a proxy.

The customers who have proxies installed in their environment, need to use the below gateway installation command for registration.

The examples below show how to register the gateway through proxy method. The collector will try to register the gateway, once it’s installed, through the proxy. The tool supports registration with or without credentials as shown below:

  • Register through proxy with credentials.
    opsramp-collector-start install --environment {Environment} --url {OpsRamp Server URL} --key {Gateway unique authentication token} --proxy-protocol {Proxy Protocol http/https} --proxy-ip {Proxy IP Address} --proxy-port {Proxy Port} --proxy-username {Proxy Username} --proxy-password {Proxy Password}
  • Register through proxy without credentials.
    opsramp-collector-start install --environment {Environment} --url {OpsRamp Server URL} --key {Gateway unique authentication token} --proxy-protocol {Proxy Protocol http/https} --proxy-ip {Proxy IP Address} --proxy-port {Proxy Port}

Option 3: Registering nextgen gateway by using yaml config file

Users can register the NextGen gateway by using registration flags within a YAML file.
To complete the registration process, follow these steps:

  1. Generate a YAML file based on the provided sample YAML below and make the required modifications:

Sample YAML

config:
squid-proxy: disable
third-party-app: disable
 
proxy:
  proxy-protocol:
  proxy-ip:
  proxy-port:
  proxy-username:
  proxy-password:
 
helmchart-version: 1.6.0
 
repo:
  repository:
  repo-user:
  repo-password:
  read-repopass-from-file:
 
gateway-name:
storage-class:

#Pass the snmp_v3 credentials in below format. Put 2 spaces under the "snmp_trap_v3_credentials" and pass the keys after those spaces (spaces are for yaml intonations)
#snmp_trap_v3_credentials: |-
#  key1
#  key2
#  key3
# Refer https://docs.opsramp.com/platform-features/feature-guides/monitoring-using-snmp-traps/#configure-snmp-v3-traps for more details on configuring SNMP credentials.
 
snmp_trap_v3_credentials: |-
 
vprobe:
  resources:
    limits:
      memory: "5096Mi"
 
nativebridge:
  resources:
    limits:
      memory: "500Mi"
 
squid:
  resources:
    limits:
      memory: "500Mi"
       
postgres:
  resources:
    limits:
      memory: "1024Mi"
2. A YAML file has been successfully created with named “discoveryConfig.yaml”. 3. Specify the location of the “discoveryConfig.yaml” file in the following command to complete the gateway registration.
opsramp-collector-start install --url uat.opsramp.net --key 2e245f6b-0056-4ad3-84e7-1553f42af1be --registration-config /home/e0421@opsramp-corp.com/git/nextgenConfig.yaml

Step-4: Check for successful gateway registration

Once the CLI returns successfully, navigate to Setup > Resource > Management Profile to check if the gateway registered successfully.

Gateway connection status:

bootstrap

How to use Bootstrap Tool to Uninstall the NextGen Gateway?

Use the following commands to uninstall the NextGen gateway using bootstrap tool.

sudo opsramp-collector-start uninstall -e {Environment}

Available Flags

FlagsDescription
--environment (-e)It is used to specify on which environment nextgen gateways is available
--namespace (-n)k8s namespace (This is used only in kubernetes environments)

Uninstallation of kubernetes.

bootstrap

Once the CLI returns successfully, navigate to Setup > Resource > Management Profile to check if the gateway is de-registered successfully.

Gateway connection status:

bootstrap

Troubleshooting

Following are the errors if any CLI failures.

  • If you are providing the incorrect cloud api server url:
    bootstrap
  • If you are trying to re-registering gateway:
    bootstrap
  • If the Kubernetes server is not reachable:
    bootstrap