Contents

All the commands in this runbook were tested against a VM with Canonical, Ubuntu, 20.04 LTS, amd64 as root.

Document Details

...

Prepared By

...

Reviewed By

...

Date

...

Document Version

...

Software Version

...

Christopher Oliver

...

Artem Kalaitan

...

11-July-2022

...

V 1

...

V 2.8

Introduction

Installation

1. Install K3s and wait for the pods to become ready:

   Code Block
   language bash
   $ curl -sfL https://get.k3s.io | INSTALL_K3S_VERSION="v1.23.9+k3s1" K3S_KUBECONFIG_MODE="644" sh -s - server --node-name=local-01 $ kubectl get deploy -n kube-system --output name | xargs -n1 -t kubectl rollout status -n kube-system

2. Install Helm 3:

   Code Block
   language bash
   $ wget --quiet https://raw.githubusercontent.com/helm/helm/master/scripts/get -O /tmp/get_helm.sh \ && chmod 0755 /tmp/get_helm.sh \ && /tmp/get_helm.sh -v v3.8.2

3. Configure GetVisibility private Docker image registry (replace $USERNAME and $PASSWORD with the Docker credentials provided):

   Code Block
   language bash
   $ kubectl create secret docker-registry gv-docker-registry \ --docker-server=https://images.master.k3s.getvisibility.com \ --docker-username=$USERNAME \ --docker-password=$PASSWORD \ --docker-email=no@email.com

4. Configure GetVisibility private Helm repository (replace $USERNAME and $PASSWORD with the Helm credentials provided):

   Code Block
   language bash
   $ helm repo add gv_stable https://charts.master.k3s.getvisibility.com/stable --username $USERNAME --password $PASSWORD $ helm repo update

5. Install chart GetVisibility Essentials and wait for the pods to become ready:

   Code Block
   language bash
   $ helm upgrade --install gv-essentials gv_stable/gv-essentials --wait \ --kubeconfig /etc/rancher/k3s/k3s.yaml $ kubectl get deploy --output name | xargs -n1 -t kubectl rollout status

6. Depending on the theme you want to use, run one of the commands below to install the chart GV Platform:

   1. GetVisibility theme:

      Code Block
      language bash
      $ helm upgrade --install gv-platform gv_stable/gv-platform --wait \ --kubeconfig /etc/rancher/k3s/k3s.yaml \ --set-string clusterLabels.environment=prod \ --set-string clusterLabels.cluster_reseller=getvisibility \ --set-string clusterLabels.cluster_name=mycluster \ --set-string clusterLabels.product=synergy

   2. Forcepoint theme:

      Code Block
      language bash
      $ helm upgrade --install gv-platform gv_stable/gv-platform --wait \ --kubeconfig /etc/rancher/k3s/k3s.yaml \ --set-string clusterLabels.environment=prod \ --set-string clusterLabels.cluster_reseller=forcepoint \ --set-string clusterLabels.cluster_name=mycluster \ --set-string clusterLabels.product=synergy \ --set-string dashboard.imageSuffix=-forcepoint \ --set-string gvKeycloak.imageSuffix=-forcepoint

...

To access Prometheus dashboard run the command kubectl port-forward svc/rancher-monitoring-prometheus -n cattle-monitoring-system 3001:9090 --address='0.0.0.0' and in your browser type the address http://$SERVER_IP:3001.

...