https://github.com/hivemq/mosquitto2hivemq

A smart migration tool to migrate your configuration and persistent connections from Mosquitto to the HiveMQ Enterprise MQTT Broker.
https://github.com/hivemq/mosquitto2hivemq

hivemq migration-tool mosquitto mqtt mqtt-broker mqtt-server mqtt-service

Last synced: about 2 months ago
JSON representation

A smart migration tool to migrate your configuration and persistent connections from Mosquitto to the HiveMQ Enterprise MQTT Broker.

• Host: GitHub
• URL: https://github.com/hivemq/mosquitto2hivemq
• Owner: hivemq
• License: apache-2.0
• Created: 2019-10-15T14:59:58.000Z (about 5 years ago)
• Default Branch: develop
• Last Pushed: 2023-07-28T05:02:09.000Z (over 1 year ago)
• Last Synced: 2024-04-17T19:14:18.395Z (9 months ago)
• Topics: hivemq, migration-tool, mosquitto, mqtt, mqtt-broker, mqtt-server, mqtt-service
• Language: Java
• Homepage:
• Size: 4.35 MB
• Stars: 6
• Watchers: 13
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

        
# Mosquitto to HiveMQ Migration Tool

MQTT 5.0 and 3.1.1 compatible migration tool to migrate your persistent connections from Mosquitto to the HiveMQ Enterprise Broker.

## Features

- **All MQTT 3.1.1 and MQTT 5.0 features** are supported (except shared subscriptions, which are not directly persisted in Mosquitto)

- latest Mosquitto support (1.6.7) as well as all 1.6.* releases

- easy to use

### Prerequisites

The tool was created using Java 11.

### Quickstart

#### Download

There is a package prepared as release of the repository that can be  

downloaded. See [packages/1.0.0/mosquitto2hivemq-1.0.0.zip](Zip file of the current package) 

The Zip file contains a jar and the README.

After downloading the package can be unzipped and migration can start.

The simplest way to start the migration tool is typing:

```$ java -jar mosquitto2hivemq-1.0.0.jar -i ```

See also ``java -jar mosquitto2hivemq-1.0.0.jar --help``.

A timestamped folder will be created, which contains a handy backup file. You can then import this file via the HiveMQ Control Center under the Admin/Backup section.

### Building from source

To do a clean build, issue the following command:

`$ ./gradlew build`

This creates the **migration-tool.jar** which can then be executed.

#### Command Attributes

|Attribute                                         |Explanation                                                            |

|------------------------------------------------|-------------------------------------------------------------------------|

| ``-i`` | Enter the input Mosquitto database file which is needed for the migration.

| ``-o`` | Add a path to specify the output folder of the HiveMQ migration Folder.

| ``-k`` | Keep the XML Files created by the migration tool for further investigation.

| ``-v`` | Enable verbose mode to get more details during the migration.

See also ``java -jar mosquitto2hivemq-1.0.0.jar --help``

## License

See [LICENSE](LICENSE)