Uninstalling Connectware

Uninstall Connectware on Docker or Kubernetes.

This page explains how to completely remove Connectware from your Docker or Kubernetes environment.

Make sure to back up any important data before proceeding with the uninstallation, as this process will permanently remove all Connectware-related data from your system.

Kubernetes

Prerequisites

• Helm version 4 is installed on your system.

• kubectl is installed on your system.

• You know the name and namespace of your Connectware installation (see Obtaining the Name, Namespace, and Version of your Connectware Installation).

Uninstalling Connectware

To uninstall Connectware, use the helm uninstall command on your Connectware on Kubernetes installation:

helm uninstall -n ${NAMESPACE} ${INSTALLATION_NAME}

Replace ${NAMESPACE} with the namespace of your Connectware installation and ${INSTALLATION_NAME} with the name of your Connectware installation.

Cleaning up Leftover Resources

Some resources will intentionally not be removed, like some PersistentVolumeClaims, and potentially ConfigMaps and secrets manually created for mTLS.

If you want to completely clean up, for example for a fresh install, use this command to identify the resources:

kubectl -n ${NAMESPACE} get all,cm,secret,pvc

Keep in mind that some resources are part of a standard Kubernetes namespace, for example configmap/kube-root-ca.crt or service/kubernetes. After identifying the resources for cleanup, use this command to remove them:

kubectl -n ${NAMESPACE} delete <resource-1> <resource-2> <resource-n>

Example

kubectl -n ${NAMESPACE} delete persistentvolumeclaim/brokerdata-broker-0
persistentvolumeclaim/brokerdata-broker-1 configmap/cw-mtls-ca-cert
secret/cw-mtls-welder-robots
persistentvolumeclaim/postgresql-postgresql-0
persistentvolumeclaim/certs

If you plan a fresh installation in the same location, make sure to remove persistentvolumeclaim/postgresql-postgresql-0 and persistentvolumeclaim/certs.

Docker

1. Switch to the root user and navigate to your installation directory:

sudo -i
cd <installation-directory>

1. Stop and remove all Docker containers, networks, and volumes associated with Connectware:

docker compose down -v

1. Navigate up one directory level and delete the installation directory:

cd ..
rm -R <installation-directory>

If you have installed Connectware via systemd, proceed with the next steps.

1. systemd installations only: Disable the Connectware service.

systemctl disable connectware

1. Remove the service file:

rm /etc/systemd/system/connectware.service