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.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:
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 -
- To install latest version of k3s use the following command.
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.