ChristofSchwarz / qseok_on_minikube

Qlik Sense on Minikube deployment

*** Breaking News August 2020: Qlik no longer gives Qlik Sense Enterprise on Kubernetes to customers ***

Qlik Sense Enterprise on Minikube

Status: 22-Nov-2019

Note: This is a newer version of my repo qs_on_Kubernetes. I made a separate video showing how to install this https://youtu.be/_QfyxV4gpeM

• It automatically installs and sets a local Keycloak installation as your identity provider for Qlik Sense
• Keycloak console at http://192.168.56.234:32080/auth), login with admin / admin
• It waits for qlik sense deployment to finish (all pods are ready), will connect via API and even set the site license

How to provision

We will install an Ubuntu 16 Linux. For that you will need

• A license from Qlik that is enabled for Multi-Cloud
• Oracle VirtualBox 5.2 or later from https://www.virtualbox.org/ or an alternative hypervisor
• Vagrant 2.2 or later from https://www.vagrantup.com/
  (Note if prompted where to install leave the default C:\HarshiCorp\Vagrant to avoid issues later !)

After you downloaded this git into a new folder (using git clone or download as .zip and unzip)

• open a Command Prompt and
• navigate to the folder where you placed this git
• put your Qlik Sense site license (JWT key) into the text file ./api/sitelicense.txt (file in the relative folder)
• start the provisioning with this command

vagrant up

This takes up to 2 hours to finish. It starts and completely configures an Ubuntu Linux. All the shell scripts found in /sh will be executed. It deploys docker, minikube, keycloak and waits for the qliksense deployment to finish, even the license will be set.

To bash into your new Ubuntu box you simply can use

vagrant ssh

however, I recommend to use Putty

If you want to stop and remove the VM properly (also before you want to restart the provisioning process), run

vagrant destroy

Configuration

Here you can see the settings for this virtual machine. It uses

• Ubuntu 16.04
• 8 GB RAM
• 2 processors
• sets root user to vagrant password vagrant

using Keycloak as IDP for QSEoK

Info: Keycloak is an open source software product to allow single sign-on with Identity Management and Access Management, maintained by JBoss community project and under the stewardship of Red Hat. The tool's intent is to make it easy to secure applications and services with little to no coding.

Go to keycloak folder for more ...

Troubleshooting

Qlik Sense errors from any pod

Collect all logs of qlik (release name in this example is "qlik") into one large file getlogs.sh: (if you used a namespace, add the -n argument)

kubectl get pods --selector release=qlik -o jsonpath="{range .items[*]}{'CURRPOD='}{@.metadata.name}{'\n'}{range ..containers[*]}{'echo kubectl logs $'}{'CURRPOD -c '}{@.name}{'\n'}{'kubectl logs $'}{'CURRPOD -c '}{@.name}{' -n $'}{'1\n'}{end}{end}" >getlogs.sh
cat getlogs.sh

A shell file has been created that will collect all logs from all pods and all containers (some pods have up to 4 containers). This shell script needs one argument: the namespace. If you haven't used one, put default. To execute it run this:

sh -v getlogs.sh default >alllogs.txt 
cat alllogs.txt|grep 'rror\|ERROR'   

This log file will have at least 6 MB uncompressed text.

lost internet connection

Sometimes the Ubuntu Virtual Box loses access to internet - I guess this is a Oracle VirtualBox issue which occurs when my host computer changes its Wifi connection. The result is, no helm install command will work and after some days your Sense license will be invalid. You can restart the Network Adapter 1 like this

sudo ifdown eth1
sudo ifup eth1

Check the success by pinging a public address like: ping www.orf.at