Transferring queue managers to the new appliance

Follow this procedure to transfer a queue manager and associated data to your new appliance.

About this task

This procedure assumes that your queue managers are currently running on your original appliance, and are not part of a disaster recovery configuration.

You now use the disaster recovery capabilities of the IBM® MQ Appliance to create a secondary instance of a queue manager on the new appliance, before switching over the primary instance of the queue manager to the new appliance. At the end of the procedure, the queue manager runs on the new appliance.

Repeat this procedure for each queue manager on your original appliance.

Note: The queue manager is migrated to the firmware level of the new appliance during this procedure.

Procedure

Create a new DR configuration on the original appliance, with the queue manager running there as the primary. Complete the following steps on the original appliance:
1. Enter MQ administration mode by typing mqcli on the command line.
2. Stop the queue manager that you want to transfer:
```
endmqm <queue_manager_name>
```
3. Enter the following command:
```
crtdrprimary -m <queue_manager_name> -r <new_appliance_name> -i <new_appliance_IP> -p port
```
  On successful completion, the command outputs a crtdrsecondary command.
4. Restart the queue manager:
```
strmqm <queue_manager_name>
```
On the new appliance, complete the following steps:
1. Enter MQ administration mode by typing mqcli on the command line.
2. Enter the crtdrsecondary command, exactly as output in step 1c. Synchronization of the queue manager data from the old appliance to the new appliance begins.
Wait for synchronization to complete. On either appliance, check the progress of the synchronization by using the status command.
```
status <queue_manager_name>
```
When the synchronization is complete, stop the queue manager on the original appliance:
```
endmqm <queue_manager_name>
```
On the original appliance, enter the following command to specify that the queue manager is no longer the primary instance:
```
makedrsecondary -m <queue_manager_name>
```
On the new appliance enter the following command to specify that it is now the primary instance of the queue manager:
```
makedrprimary -m <queue_manager_name>
```
Start the queue manager on the new appliance, and verify that it starts successfully:
```
strmqm <queue_manager_name>
```
On the original appliance, delete the queue manager:
```
dltdrsecondary <queue_manager_name>
```
On the new appliance, stop the queue manager and remove it from DR control:
```
endmqm <queue_manager_name>
dltdrprimary <queue_manager_name>
```
The queue manager is now a stand-alone queue manager.
If you are upgrading a HA configuration, add the queue manager to the HA group on the new appliances. See Adding an existing queue manager to a high availability group.
Restart the queue manager:
```
strmqm <queue_manager_name>
```