HiveMQ 4.33.x to 4.34.x Migration Guide
This is a minor HiveMQ upgrade. HiveMQ 4.34 is a drop in replacement for HiveMQ 4.33.x.
You can learn more about all the new features HiveMQ 4.34 introduces in our release blogpost.
HiveMQ is prepackaged with all HiveMQ Enterprise Extensions (disabled), HiveMQ Data Hub, the open-source MQTT CLI tool, and the HiveMQ Swarm load-testing tool (MQTT CLI and HiveMQ Swarm are located in the tools
folder of your HiveMQ installation).
HiveMQ 4.28 is the current HiveMQ LTS release.
If you have not already done so, we recommend upgrading to HiveMQ version 4.28 or above. To upgrade from the previous 4.9 LTS to HiveMQ 4.29 and above, you must first upgrade to the new 4.28 LTS version. For more information, see the HiveMQ 4.9 to 4.28 Migration Guide, HiveMQ Rolling Upgrade Policy, and our Introducing Flexible MQTT Platform Upgrades with HiveMQ blog post. |
When you migrate from one HiveMQ version to another, we recommend that you review the upgrade information for each version between your current HiveMQ version and the target HiveMQ version. Note changes that are relevant to your use case and adjust your configuration as needed. |
Upgrade a HiveMQ Cluster
Rolling upgrades are supported, and it is possible to run HiveMQ version 4.33 and version 4.34 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.
Upgrade a Single-node HiveMQ Instance
-
Create a backup of the entire HiveMQ 4.33.x installation folder from which you want to migrate.
-
Install HiveMQ 4.34 as described in the HiveMQ Installation Guide.
-
Migrate the content of the
config.xml
andlicense
files from your old HiveMQ 4.33.x installation. -
To migrate your persistent data, copy everything from the
data
folder of your backup to thedata
folder of the new HiveMQ 4.34 installation.
HiveMQ Configuration File Changes
HiveMQ prevents the startup if your configuration file contains invalid values. For more information, see Configuration Validation. |
HiveMQ Persistent Data Migration
When you migrate, HiveMQ 4.34 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.33.x installation to the data folder of your new HiveMQ 4.34 installation.
cp -r /opt/hivemq-4.33.0/data/* /opt/hivemq-4.34.0/data/
The first time you start HiveMQ 4.34, the file storage formats of the persistent data from your previous installation are automatically updated in the new persistent storage.
Heightened HiveMQ Control Center and REST API Security
The HiveMQ Platform 4.34 release introduces heightened security measures to ensure that authentication details such as passwords are not visible in any Control Center views even for privileged permissions. The new default behavior further enhances the overall security of HiveMQ deployments that use the Control Center. This change in the default security settings affects the Control Center Client View and Trace Recordings.
HiveMQ Enterprise Security Extension
To change the new default setting back to the previous behavior when using the Enterprise Security Extension,
the attribute clear-client-password-on-connection
can be changed to either true
(default) or false
(previous behavior).
<enterprise-security-extension>
<pipelines>
<listener-pipeline listener="listener-other" clear-client-password-on-connection="true"/>
</pipelines>
</enterprise-security-extension>