How to migrate data to a new RabbitMQ service instance

In this tutorial you will learn how to migrate your queue definitions from existing RabbitMQ service instance to a new created.

Requirements

cat
openssl
gunzip
nodejs (min. v. 6.11.0)
python (min. v. 2.7.9)
restore_queues.js
rabbitmqadmin

Migration steps

Order and configure a new target service instance

Order a new service instance with the same plan and configuration as your existing service. Create credential key for it.

Trigger manual backup of your source service instance

Open Service Dashboard to manually trigger a backup of your source service instance. Please make sure you set an encryption password. Instructions can be found here.

Download and prepare backup

Download the latest backup of source service instance from Service Dashboard and store it on your local machine.

Use following commands to decrypt and decompress the backup file:

cat <downloaded_backup_filename> | openssl enc -aes256 -md md5 -d -pass 'pass:<your_backup_encryption_password>' | gunzip -c > backup_settings.json

Example:
cat 4332fced-9984-4ffa-8f63-0c872d518109-1655429318631 | openssl enc -aes256 -md md5 -d -pass 'pass:mypassword' | gunzip -c > backup_settings.json

Download and prepare required scripts

Get backup script restore_queues.js and make sure it is executable.

Login to RabbitMQ Management Dashboard and download 'rabbitmqadmin' tool adding '/cli' to your Management Dashboard URL:

https://<hostname>:<port>/cli

Restore backup to target instance

Required parameters can be retrieved from credential key.

./restore_queues.js $(which python) ~/Downloads/rabbitmqadmin <target_host> <target_port> <target_user> <target_password> ./backup_settings.json
 
Example:
./restore_queues.js $(which python3) ./rabbitmqadmin.py rad741cc2-1.data.eu01.onstackit.cloud 49374 a9s-brk-usr-73c13bd10f7a593e40d40351502b0e3b5191112d a9sb99f0aad4f580691fd0667013ce5634afd3ef261 ./backup_settings.json

Verify restored data

Connect to RabbitMQ Management Dashboard and check restored queue definitions.

Please find additional information here.

Knowledgebase