tonikautto/qse-kubernetes-minikube

Deploy Qlik Sense for Kubernetes on local Minikube

ARCHIVED Qlik Sense for Kubernetes is no longer an available product offering from Qlik

This project simplifies the deployment of Qlik Sense Enterprise for Kubernetes (QSEoK) on local Minikube. This can be used for testing, but should not be applied in production environment.

This ReadMe focuses on deployment in Windows, for MacOS guideline see README-MacOS

values.yaml contains the deployment configuration for QSEoK. Depending on your custom configuration this file may contain secret details e.g. related to authentication setup. Caution is advised on shairng your custom configuration file to others.

Scripts and details are based on default deployment of Qlik Sense April 2019 as described in related Qlik Help pages.

• Qlik Sense Help
• Qlik Sense Enterprise on Kubernetes
• Prepare install
• Using Minikube
• Installing Qlik Sense Enterprise on Kubernetes

Pre-requisites

• Qlik Sense Enterprise signed license key
• Internet access

Before you begin

Check that virtualization is enabled on your client machine.

Run systeminfo command in Powershell to confirm if virtualization is enabled on your computer. If you see the following output, virtualization is supported on Windows. If you do not get below details, please enable virtualization (VT-x feature) in BIOS settings.

Hyper-V Requirements: VM Monitor Mode Extensions: Yes
                        Virtualization Enabled In Firmware: Yes
                        Second Level Address Translation: Yes
                        Data Execution Prevention Available: Yes

Install Tools

Tools only need to be installed once, and only if not already installed.

1. Open PowerShell terminal as Administrator
2. Install Chocolatey package manager
   Set-ExecutionPolicy Bypass -Scope Process -Force; iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))
3. Install required tools
   • Virtual box: choco install virtualbox --yes
   • Minikube: choco install minikube --yes
   • Kubectl: choco install kubernetes-cli --yes
   • Helm: choco install kubernetes-helm --version 2.13.1 --yes --force
     NOTE, forcing 2.13.1 due to https://support.qlik.com/articles/000075385

Deploy Qlik Sense on Kubernetes on Minikube

4. Open PowerShell terminal
5. Run ./1-Deploy-Minikube-Win.ps1
6. Get Minikube IP address
   minikube ip
7. Update local host file to enable resolving Minikube IP to elastic.example.
   
   Windows hostfile in C:\Windows\System32\drivers\etc to include row with IP from previous refering to elastic.example
   <IP ADDRESS> elastic.example

Access Qlik Sense

8. Browse to console https://elastic.example:32443/console/
9. Apply license
10. Browse to Hub https://elastic.example:32443
    User: harley@qlik.example
    Pwd: Password1!

Remove deployment

11. Terminated and remove minikube instance
    minikube delete

Troubleshooting

Error: validation failed: error validating "": error validating data: unknown object type "nil" in Secret.data.redis-password`

This error appears during Qlik package installation, when using Helm 2.14. Issue can be reoslve by downgrading to Helm 2.13.1.

choco install kubernetes-helm --version 2.13.1 --yes --force

License

This project is provided "AS IS", without any warranty, under the MIT License - see the LICENSE file for details