Installing DKube¶
Detailed instructions on installing Helm are available at Installing Helm
Note
It may be ncessary to append “sudo” to the commands
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 | sudo bash -c 'cat - > 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 express installation is:
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 |
Field |
Value |
---|---|
provider |
eks |
version |
Version of DKube to install |
username |
User-chosen initial login username |
password |
User-chosen initial login password |
optional.storage.node |
EKS host name |
registry.username |
Docker registry username - will be provided |
registry.password |
Docker registry password - will be provided |
Field |
Value |
---|---|
provider |
tanzu |
version |
Version of DKube to install |
username |
User-chosen initial login username |
password |
User-chosen initial login password |
optional.storage.node |
Tanzu host name |
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:
Note
Upgrading, uninstalling, and reinstalling DKube are covered in the sections Upgrading DKube, Uninstalling DKube, and Reinstalling DKube
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:
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:
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 DKube User Guide