Installing DKube

Detailed instructions on installing Helm are available at https://helm.sh/docs/intro/install/

The installation should be performed from the $HOME/.dkube folder.

Getting the Helm Files

export KUBECONFIG=kubeconfig
kubectl get nodes
helm repo add dkube-helm https://oneconvergence.github.io/dkube-helm
helm repo update
helm show values dkube-helm/dkube-deployer > values.yaml

Important

If the kubectl command is not successful, do not continue with the installation. This must function properly for the installation to succeed.

Important

Helm expects that the kubeconfig has a permission of 0600. If Helm provides a security error message, you can eliminate it by using the “chmod 0600 kubeconfig” command.

Express Installation

This section describes a quick installation with a set of simple, pre-configured options. If these options are not right, go to the section on advanced installation options at Advanced Installation Options

The Helm command for the exress installation is:

helm install <Release Name> dkube-helm/dkube-deployer \ --set EULA=yes \ --set wipedata=yes \ --set provider=<Platform type> \ --set version=<DKube Version> \ --set username=<Username> \ --set password=<Password> \ --set optional.storage.node=<Node Name> \ --set registry.username=<Docker Username> \ --set registry.password=<Docker Password>

Important

The value wipedata=yes will remove all of the current DKube data from a previous installation. If this is a reinstallation, and you want to use your existing DKube data, follow the instructions in the section Advanced Installation Options

Field

Value

provider

dkube

version

Version of DKube to install

username

User-chosen initial login username

password

User-chosen initial login password

optional.storage.node

Node name as identified in the Rancher Server UI

registry.username

Docker registry username - will be provided

registry.password

Docker registry password - will be provided

The status of the installation can be viewed with the following command:

helm status <Release Name>

Installation Dashboard

The progress of the installation can be viewed from the installation dashboard. The link to the dashboard is based on the platform type.

The installation dashboard is accessible from the public IP address of the master node. The IP is of the form:

https://<Public Master IP Address>:32323/ui

Accessing DKube

After the DKube installation dashboard shows that the installation has completed, the DKube UI is shown as part of the dashboard. DKube can be accessed from the public IP address of the master node. The IP is of the form:

https://<Public Master IP Address>:32222

Initial Login

The initial login after installation is accomplished with the username and password entered in the command line for the express installation. Authorization based on a backend mechanism is explained in the User Guide in the section “Getting Started”.