Installation of NextGen Gateway on Ubuntu VM

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

Note

If you are using an ISO/OVA that is not provided by OpsRamp, please be aware that OpsRamp cannot assist with the setup of Kubernetes or address any security-related issues associated with Kubernetes.

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.25.x or higher
8 GB Memory
50 GB Disk
4 Core of CPU
Ubuntu 22.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.
To whitelist NextGen Gateway IPs, refer to the documentation.

Installation of k3s

To install the k3s the follow the below steps:

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 -
```

Add following lines to /etc/environment.

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

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:

From All Clients, select a client.
Go to Setup > Account > Collector Profile.
Click + ADD on the COLLECTOR PROFILES page.

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

Click NEXT.
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.

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.