# SUSE Rancher Prime

gopaddle lite is a life-time free single-node, single-user evaluation edition that can be installed on [Rancher Prime by SUSE](https://www.rancher.com/products/rancher)

## Pre-requisites <a href="#h_3ab485cdaa" id="h_3ab485cdaa"></a>

### Rancher Prime Cluster Node requirements <a href="#h_0c841476fc" id="h_0c841476fc"></a>

1. Ubuntu 18.04
2. RAM 32GB
3. CPU 8vCPU
4. Disk 50GB

### Prometheus tool server requirements <a href="#h_61806dbc18" id="h_61806dbc18"></a>

Increase the open file descriptor in the nodes

1. Edit the file as root /etc/sysctl.conf
2. Add these lines to the file

   ```sh
   fs.file-max = 500000
   fs.inotify.max_user_watches=100000
   fs.inotify.max_user_instances=100000
   ```
3. Reload the configuration

   ```sh
   sysctl -p
   ```
4. check if the file systems limit is set

   ```sh
   cat /proc/sys/fs/file-max
   ```

### Connect to the Rancher Prime cluster <a href="#h_16e6efedc8" id="h_16e6efedc8"></a>

The Rancher Prime cluster configuration file is usually available @ /etc/rancher/rke2/rke2.yaml in the master node.

```sh
export KUBECONFIG=/etc/rancher/rke2/rke2.yaml
```

### Configure Default Storage Class <a href="#h_b1285d94c0" id="h_b1285d94c0"></a>

gopaddle requires a default storage class to install its dependent stateful services like mongodb, influxdb etc. The below steps can be ignored, if the cluster already has a default storage class configured. Otherwise, install the CSI driver based on the Rancher Prime environment.

***

#### Example - AWS EBS CSI Driver <a href="#h_e372c8d5c8" id="h_e372c8d5c8"></a>

For instance, if you are running Rancher Prime on AWS, enable the AWS EBS CSI driver. For more information on the AWS EBS CSI Driver - \[<https://github.com/kubernetes-sigs/aws-ebs-csi-driver#kubernetes-version-compatibility-matrix> ]

```
export AWS_KEYID=<aws-access-key>
export AWS_ACCESSKEY=<aws-secret-key>
```

```
kubectl create secret generic aws-secret --namespace kube-system --from-literal "key_id=$AWS_KEYID" --from-literal "access_key=$AWS_ACCESSKEY" kubectl apply -k "github.com/kubernetes-sigs/aws-ebs-csi-driver/deploy/kubernetes/overlays/stable/?ref=release-1.13"
```

Patch the node labels topology.kubernetes.io & topology.kubernetes.io/zone, so that the AWS EBS CSI driver schedules the persistent volumes on the selected region and the availability zone.

```
export REGION='us-east-1'
export ZONE='us-east-1a'
apt install jq -y node=$(kubectl get nodes -o json | jq -r '.items[0].metadata.annotations["rke2.io/hostname"]') kubectl patch node $node -p '{"metadata": {"labels":{"topology.kubernetes.io/region": "$REGION"}}}' kubectl patch node $node -p '{"metadata": {"labels":{"topology.kubernetes.io/zone":"$ZONE"}}}'
```

***

#### Create Standard storageClass <a href="#h_02391e56eb" id="h_02391e56eb"></a>

a) From the Rancher Prime UI, create a new storage class named - standard and choose the provisioner.

<figure><img src="https://downloads.intercomcdn.com/i/o/669520002/451c6b3ff1c0ab8e77bf56fd/AWS-EBS.png" alt=""><figcaption></figcaption></figure>

b) Patch the standard storage class and set it as the default storage class.

```sh
kubectl patch storageclass standard -p '{"metadata": {"annotations":{"storageclass.kubernetes.io/is-default-class":"true"}}}'
```

## Install gopaddle-lite from marketplace <a href="#h_ce5bb26f1e" id="h_ce5bb26f1e"></a>

In the Rancher Prime dashboard, in the Charts section, search for the gopaddle chart and install.

<figure><img src="https://downloads.intercomcdn.com/i/o/669517753/b502d8fbd3e477bca35440f9/Screen+Shot+2023-01-10+at+1.45.58+PM.png" alt=""><figcaption></figcaption></figure>

This will install all the gopaddle services. Wait for the gopaddle services to move to ready state.

<figure><img src="https://downloads.intercomcdn.com/i/o/669516584/4ccacddd4f306d64f8fb7059/Screen+Shot+2022-12-14+at+10.59.08+PM.png" alt=""><figcaption></figcaption></figure>

## Accessing gopaddle dashboard <a href="#h_9670a03a65" id="h_9670a03a65"></a>

Once the installation is complete, open the firewall ports 30000-30006 and 32000 in the Rancher Prime nodes.

gopaddle dashboard can be accessed @ `http://<NODE_IP>:30003`

NODE\_IP can be obtained by listing the nodes in the cluster.

```sh
kubectl get nodes -o wide
```

NOTE: If the cluster is installed on cloud based VMs, then the NODE\_IP can be the public IP of the node.

Subscribe to gopaddle using your email ID. gopaddle will then send an initial password to the registered email ID. You can now login to the gopaddle dashboard using the email ID and the initial password.&#x20;


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.gopaddle.io/overview/installing-community-edition/suse-rancher-prime.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.