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

Pre-requisites

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

Installation of helm

To install the helm the follow the below steps:

  1. Download helm binary with following command
    sudo wget https://storage.googleapis.com/opsramp_cluster_gateway_asserts/collector-cli/helm/latest/helm
  2. Change helm permissions to 755.
    sudo chmod 755 helm
  3. Move the helm binary to /usr/local/bin/ folder.
    sudo mv helm /usr/local/bin/

Download the OpsRamp Collector Start Binary

  1. Download opsramp-collector-start binary from downloadable links provided by opsramp team.
    sudo wget https://storage.googleapis.com/opsramp_cluster_gateway_asserts/collector-cli/linux/1.4/amd/opsramp-collector-start
  2. Change opsramp-collector-start permissions to 755.
    sudo chmod 755 opsramp-collector-start
  3. Move opsramp-collector-start binary to /usr/local/bin/ folder
    sudo mv opsramp-collector-start /usr/local/bin/

Advanced configuration

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