Delete KUMA

To remove KUMA, use the Ansible tool and the inventory file that you have prepared.

To remove KUMA:

1. On the control machine, go to the installer directory:

   cd kuma-ansible-installer

2. Run the following command:

   sudo ./uninstall.sh <inventory file>

KUMA and all of its data is removed from the server.

The databases that were used by KUMA (for example, the ClickHouse storage database) and the data therein must be deleted separately.

Special considerations for removing KUMA in a high availability configuration

Which components need to be removed depends on the value of the deploy_to_k8s parameter in the inventory file that you are using to remove KUMA:

• If the setting is true, the Kubernetes cluster created during the KUMA installation is deleted.
• If the setting is false, all KUMA components except for the Core are removed from the Kubernetes cluster. The cluster itself is not deleted.

In addition to the KUMA components installed outside the cluster, the following directories and files are deleted on the cluster nodes:

• /usr/bin/k0s
• /etc/k0s/
• /var/lib/k0s/
• /usr/libexec/k0s/
• ~/k0s/ (for the ansible_user)
• /opt/longhorn/
• /opt/cni/
• /opt/containerd

While the cluster is being deleted, error messages may be displayed; however, this does not abort the installer.

• You can ignore such messages for the Delete KUMA transfer job and Delete KUMA pod tasks.
• For the Reset k0s task (if an error message contains the following text: "To ensure a full reset, a node reboot is recommended.") and the Delete k0s Directories and files task (if an error message contains the following text: "I/O error: '/var/lib/k0s/kubelet/plugins/kubernetes.io/csi/driver.longhorn.io/"), we recommend restarting the relevant host and trying to remove KUMA again with the same inventory file.

After removing KUMA, restart the hosts on which the KUMA components or Kubernetes were installed.

Page top