This section describes how to set up the nextgen gateway on Ubuntu VM.

Prerequisites

To deploy a NextGen cluster in your kubernetes environment, make sure your environment meets these requirements:

  • Helm 3.8.2 or higher
  • Kubernetes (K3S or K8S) - 1.20.x - 1.17.x or higher
  • 8 GB Memory
  • 50 GB Disk
  • 4 Core of CPU
  • Ubuntu 20.04 OS
  • AMD64/ARM64 Arch
  • Configure the default storage class and CSI plugin in the Kubernetes cluster.
    • When deploying in AWS EKS and using the EFS-based storage class, ensure that both UID and GID are set to 70.
  • If you have a multi-node Kubernetes cluster, use an external load balancer service like MetalLB to support multi-node cluster.
  • Download the OpsRamp Collector Bootstrap Tool.
    Refer to the article on how to download the OpsRamp Collector Bootstrap Tool.

Installation of k3s

To install the k3s the follow the below steps:

  1. Installing k3s with following command:

    • To install latest version of k3s use the following command.
      sudo curl -sfL https://get.k3s.io | INSTALL_K3S_EXEC="--cluster-init --disable traefik" sh -
    • To install a particular version of k3s use the following command (only replace the version with the required version below the command).
      curl -sfL https://get.k3s.io | INSTALL_K3S_EXEC="--cluster-init --disable traefik" INSTALL_K3S_VERSION="v1.23.5+k3s1" sh -
  2. Add following lines to /etc/environment.

    KUBECONFIG=/etc/rancher/k3s/k3s.yaml
    HELM_EXPERIMENTAL_OCI=1

  3. Run following command or re-login to shell to access the kubernetes.

    export KUBECONFIG=/etc/rancher/k3s/k3s.yaml

Download the Helm Binary

Download helm binary with following command:

sudo curl -fsSL -o get_helm.sh https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3 \
    && chmod 755 get_helm.sh \
    && ./get_helm.sh \
    && rm -rf get_helm.sh

Download the NextGen Gateway Collector

Follow these steps to download the nextgen gateway collector:

  1. From All Clients, select a client.

  2. Go to Setup > Account > Collector Profile.

  3. Click + ADD on the COLLECTOR PROFILES page.

ISO download
4. Provide the Profile Name and Description. Then, click on the CLOUD-NATIVE APPLICATION (INSTALLER) tile.

  1. Click NEXT.
  2. After clicking next, an instructions page appears as shown below. Follow the instructions to download the gateway:
    • Log in to the VM/host where you have pre-installed Kubernetes.
    • Copy the wget command to clipboard and paste it in the terminal window. Ensure that the bootstrap tool is successfully downloaded into your VM/host.
      Installation instructions

Once you have downloaded the gateway, proceed to step 2 to register the nextgen gateway.

Advanced configuration

For advanced configuration and instructions, refer Collector Bootstrap Tool documentation.