4.3.x to 4.4.x Migration Guide
This is a minor HiveMQ upgrade. HiveMQ 4.4 is a drop in replacement for HiveMQ 4.3.x. Read about the new features and the release cadence in this Release Blogpost
|HiveMQ 4.4 comes prepacked with all Enterprise Extensions (which are disabled) and a tools folder that contains the MQTT CLI. Please consider this for your upgrade and adapt your deployment pipeline accordingly if necessary.
Create a backup of the entire HiveMQ 4.3.x installation folder from which you want to migrate
Install HiveMQ 4.4 as described in the HiveMQ Installation Guide
Migrate the contents of the configuration file from your old HiveMQ 4.3.x installation
To migrate your persistent data, copy everything from the
datafolder of your backup to the data folder of the new HiveMQ 4.4 installation. The first time you start HiveMQ 4.4, the file storage formats of the persistent data from your previous installation are automatically updated in the new persistent storage.
You can upgrade from HiveMQ 4.3.x to HiveMQ 4.4 without making changes to your configuration file.
When you migrate, HiveMQ 4.4 automatically updates the file storage formats of all the data that you copied into your new data folder.
To migrate the persistent data, you must copy everything in the data folder of the previous HiveMQ 4.3.x installation to the data folder of your new HiveMQ 4.4 installation.
cp -r /opt/hivemq-4.3.5/data/* /opt/hivemq-4.4.0/data/
The first time you start HiveMQ 4.4, the file storage formats of the persistent data from your previous installation are automatically updated in the new persistent storage.
Rolling upgrades are supported and it is possible to run HiveMQ version 4.3 and version 4.4 simultaneously in the same cluster. By default, the HiveMQ cluster enables all new cluster features when all nodes are upgraded to the new version. No manual intervention is required.
Please follow the instructions in our user guide to ensure a seamless and successful rolling upgrade.
For more information, see HiveMQ Clustering Documentation.
Since version 4.3, HiveMQ only allows MQTT clients to connect if a security extension is present.
For testing purposes, HiveMQ includes a
hivemq-allow-all-extension that authorizes all MQTT clients to connect to HiveMQ.
Before you use HiveMQ in production, you must add an appropriate security extension and remove the
You can download security extensions from the HiveMQ Marketplace
or develop your own security extension.
The HiveMQ 4.4 Control Center offers new insights into your MQTT deployment. If you use the HiveMQ Enterprise Security Extension to restrict access to your control center and you want privileged users to access the new control center features, you must grant new permissions to these users.
You can grant any or all of these new permissions to the appropriate users or roles as desired.
Allows the user to view the session attributes of clients.
Allows the user to view the event history of a client.
Allows the user to view the list of available shared subscriptions.
Allows the user to view the details of a shared subscription.