thingsHub 5 to thingsHub 6 Migration Guides

thingsHub is powered by lots of tools and technologies other than the thingsHub itself. That means, these tools and technologies maintain their own legacy and versioning methods independently. That’s why it’s extremely important to upgrade them regularly to the appropriate versions alongside with thingsHub upgrade.

But, certain upgrade needs careful observations so that nothing will be broken during or after the upgrade. In order to prevent that, certain things need to be migrated properly.

In order to upgrade thingsHub 5 to 6 smoothly, we need to have some migrations in place. We have identified some aspects that need migration to take place.

We divided them broadly into 3 categories:

1. Pre-Upgrade: thingsHub 6 expects certain updated feature to be available during the upgrade process. The operator or the tenant admin must do this steps before upgrading to thingsHub 6 in order to avoid complexities.

2. During Upgrade (automatic): thingsHub manages it’s own migrations through two different methods 1) SQL based GORP migration 2) Code Level migration. During the upgrade process and in every startup, thingsHub checks for these migrations and takes necessary actions upon them. Since these migrations are automatically taken care of by thingsHub itself, that’s why these migfrations are called automatic migrations. No manual actions required

3. Post Upgrade: There are certain things that will wait for to be upgraded, and doesn’t cause any breaking changes during the upgrade. That’s why these migrations can be safely done after the upgrades as well. The operator or the tenant admin can do these by following the guide.

Below are the list of all the migration guides we would require for that:

Pre Upgrade:

1. Old Data Table Out Node to New Data Table Out Node Migration: Data Table Out Node Migration and Transition Guide

During Upgrade (automatic):

1. Grafana Internals Tables Migration to Visualizer Schema: Migration Guide: Grafana’s Internal Tables to the visualizer Schema in ThingsHub 6

Post Upgrade:

1. Legacy Grafana Alerts to Unified Grafana Alerts Migration: Migration Guide: Legacy Alerts to Unified Alerting in Visualizer (Grafana)

2. Grafana Deprecated Angular Plugin Migration Guide: Breaking Changes in thingsHub 6.0 | Breaking-Changes-from-Visualizer-Upgrade-to-Grafana-10.4

3. Legacy Data Table to Extended Data Table Migration: Migration Guide: Transitioning from Legacy Data Tables to Extended Data Tables

4. Device Data In Message Format Selection Migration: Device Data In Node Migration and Transition Guide