Upgrading Connectware to 2.0.1 (Kubernetes)

How to upgrade Connectware to version 2.0.1 on Kubernetes.

Connectware 2.0.1 introduces enhancements to the Data Explorer. If you are running services that are configured with CYBUS_MQTT_ROOT, this upgrade requires you to run a migration script to populate missing database entries.

Disclaimer

When upgrading your Connectware instance, follow the upgrade path based on your current version:

• If you are on version 1.4.1 or below

  • Upgrade sequentially: 1.5.0 → 1.7.0 → 2.0.0 → 2.0.1

• If you are between version 1.5.0 and 1.6.2

  • Upgrade sequentially: 1.7.0 → 2.0.0 → 2.0.1

• If you are on version 1.7.0 or newer (but below 2.0.0)

  • Upgrade sequentially: 2.0.0 → 2.0.1

• If you are on version 2.0.0

  • Upgrade directly to 2.0.1

Detailed instructions on each upgrade step

• Upgrading Connectware to 2.0.0 (Kubernetes)

• Upgrading Connectware to 1.7.0 (Kubernetes)

• Upgrading from Connectware 1.x to 1.5.0 (Kubernetes)

Hardware Requirements

Connectware 2.0.1 adds a new microservice for MQTT topic exploration. As a result, Connectware requires the following additional resources:

• 400m CPU (0.4 CPU)

• 1500 MiB of memory

On Kubernetes, this service runs with two replicas by default, effectively doubling the resource usage compared to Docker, but providing redundancy. Ensure your cluster has sufficient spare capacity before upgrading.

As with any deployment, we recommend monitoring system performance and adjusting resources as needed.

Upgrading Procedure

If your installation is older than 2.0.0, first complete the upgrade to 2.0.0 before upgrading to 2.0.1.

1. Update your Helm chart values and deploy Connectware 2.0.1. For more information, see Upgrading Connectware (Kubernetes).

2. Run the migration script. This is required if you have services using CYBUS_MQTT_ROOT.

CONNECTWARE_NAMESPACE=your-connectware-namespace
kubectl exec -n ${CONNECTWARE_NAMESPACE} -it postgresql-0 -- /app/scripts/migrate_to_2.0.1.sh

Result: The script completes the database migration by filling in missing values for new columns. Reinstalling services is not necessary.