4.2.x to 4.3.x Migration Guide
This is a minor HiveMQ upgrade. HiveMQ 4.3 is a drop in replacement for HiveMQ 4.2.x
This HiveMQ version supports rolling upgrade, and it is possible to run HiveMQ version 4.2 and version 4.3 simultaneously in the same
cluster. By default, the HiveMQ cluster enables all new cluster features once all nodes are upgraded to the new version.
No manual intervention is required.
To ensure a seamless and successful rolling upgrade process, see HiveMQ Rolling Upgrades.
For more information, see HiveMQ Clusters.
Create a backup of the entire HiveMQ 4.2.x installation folder from which you want to migrate
Install HiveMQ 4.3 as described in the HiveMQ Installation Guide
Migrate the contents of the configuration file from your old HiveMQ 4.2.x installation
To migrate your persistent data, copy everything from the
datafolder of your backup to the data folder of the new HiveMQ 4.3 installation. The first time you start HiveMQ 4.3, the file storage formats of the persistent data from your previous installation are automatically updated in the new persistent storage.
|HiveMQ is specifically designed to deliver the highly-available ultra-scalable MQTT clusters that professional MQTT deployments require. To fully benefit from the advantages the HiveMQ Enterprise and Professional editions offer, we recommend running HiveMQ in a cluster environment. For more information, see HiveMQ Cluster.|
You can upgrade from HiveMQ 4.2.x to HiveMQ 4.3 without making changes to your configuration file.
When you migrate, HiveMQ 4.3 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.2.x installation to the data folder of your new HiveMQ 4.3 installation.
cp -r /opt/hivemq-4.2.2/data/* /opt/hivemq-4.3.0/data/
The first time you start HiveMQ 4.3, the file storage formats of the persistent data from your previous installation are automatically updated in the new persistent storage.
Since version 4.3, HiveMQ only allows MQTT clients to connect if a security extension is present.
For testing purposes, HiveMQ includes a
HiveMQ 4.3 uses less JVM heap than HiveMQ 4.2. However, the overall RAM usage of the HiveMQ 4.3 processes is roughly the same. We recommended that you configure the JVM heap with 50% of the RAM that is available on the system on which you run HiveMQ. More information on how to configure the heap is available here.
|HiveMQ 4.3 requires Glibc version 2.12 or higher.|
The HiveMQ 4.3 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.
Based on your individual use case, you can assign one or more of the following new permissions to the appropriate users or roles as desired:
Allows the user to view the retained message details.
Allows the user to see user properties of messages.
Lack of this permission hides the user properties on all pages.