The functionality described in this article is available in meshIQ Manage versions 12.1 and greater.
For a quick overview of what's new or changed, visit the meshIQ Highlights page for a version-by-version breakdown.  

Jump to Section:
Version 12.x and Later
Version 11.3 and Earlier

Version 12.x and Later

Remote connections can now only be created for the node(s) you have currently selected. This change ensures that connections are accurately scoped and helps prevent cross-node misconfigurations.

This article contains instructions for managing a remote RabbitMQ manager manually. To learn how to import and export remote manager definitions, see Importing and Exporting Remote Managers.

The Undo button in the Remote Manager Connections dialog becomes available immediately after you add, modify, copy, delete, or import a connection. You can undo only the most recent action.

Creating a Remote RabbitMQ Manager Connection

1. Select the RabbitMQ node, then from the Selected menu, click Manage Connections.
   
2. The Remote RabbitMQ Manager Connections dialog opens.
   – Hover over a Remote RabbitMQ manager to view its attributes on the right side of the dialog.
   – You can sort columns in the remote RabbitMQ manager table alphabetically by clicking the column headers.
   
3. Click the Add New RabbitMQ Manager Connection button to create a new remote RabbitMQ manager connection.
4. The Add RabbitMQ Manager Connection dialog opens. 
   
5. Enter the configurations for the new Rabbit MQ connection manager.

The URL field supports multiple comma-separated URLs. If the connection between the connection manager and the remote connection is lost, the connection manager will automatically attempt to reconnect using the primary (first) followed by the subsequent URLs if multiple servers are added.

The General Connection is intended for administration tasks. The AMQP Connection is intended for message management. When message management is not required, the AMQP connection can be ignored.

6. On the SSL tab, configure SSL security (Trust Store and Key Store paths and passwords). For meshIQ Cloud users, in the Trust Store Path field on the SSL tab, enter the path to the uploaded certificate file, as shown on the Certificates tab of your meshIQ Cloud subscription page.
   

7. On the AMQP tab, click the Add AMQP button to configure AMQP protocol settings. The Add AMQP dialog opens with two tabs: General and SSL.

   • General Tab
     In the General tab, you can define AMQP connection settings in one of the two modes:

     • Full Definition (selected by default)

     • URL Mode

   • SSL Tab
     In the SSL tab, you can optionally configure secure communication settings.

   

   

   
   

8. Once finished, click Ok to create connection immediately, or click Schedule to create the connection at a later time (see Scheduling for details).

Verify a Manager Connection

See Verify a remote manager connection.

Modify a Manager Connection

1. Select the RabbitMQ node, then from the Selected menu, click Manage Connections.
2. The Remote RabbitMQ Manager Connections dialog opens.
3. Select the remote connection that you want to modify.
4. From the Selected menu, click Modify.
   
5. The Change RabbitMQ Manager Connection dialog opens. Make the necessary changes.
   
6. Click Ok to save all changes immediately, or click Schedule to apply the changes at a later time (see Scheduling for details).

Copy a Manager Connection

The Copy As command is used to copy the definition of an existing connection manager to a new one based on it.

1. Select the RabbitMQ node, then from the Selected menu, click Manage Connections.
2. The Remote RabbitMQ Manager Connections dialog opens.
3. Select the remote connection that you want to copy.
4. From the Selected menu, click Copy As.
   
5. The Add RabbitMQ Manager Connection dialog opens.
6. Modify the copied connection details as needed.
7. Click Ok to save all changes immediately, or click Schedule to create the new connection at a later time (see Scheduling for details).

Delete a Manager Connection

1. Select the RabbitMQ node, then from the Selected menu, click Manage Connections.
2. The Remote RabbitMQ Manager Connections dialog opens.
3. Select the remote connection that you want to delete.
4. From the Selected menu, click Delete.
5. In the confirmation dialog, choose one of the following:
   – Click Yes, Delete to delete the connection immediately.
   – Click No, Keep to cancel the deletion.
   – Or click Schedule to delete the connection at a later time (see Scheduling for details).
   

_____________________________________________________________________________________________________________

Version 11.3 and Earlier

This article contains instructions for managing a remote RabbitMQ manager manually. To learn how to import and export remote manager definitions, see Importing and Exporting Remote Managers.

The Undo button may be available in the Remote Manager Connections window immediately after you add, modify, copy, delete, or import a connection. Only the most recent action can be undone.

To create a remote Rabbit MQ manager connection:

1. Select a workgroup server within the Workgroup Server viewlet. 
   
2. From the pop-up menu, select Create > Remote Rabbit MQ Managers. The Remote Rabbit MQ Manager Connections window opens where you can add a new Rabbit MQ connection manager.
   

3. Click the Add button. The Add Rabbit MQ Manager Connection dialog opens.

   

4. Enter the configurations for the new Rabbit MQ connection manager.

In version 11 and onwards, the URL field supports multiple comma-separated URLs. If the connection between the connection manager and the remote connection is lost, the connection manager will automatically attempt to reconnect using the primary (first) followed by the subsequent URLs if multiple servers are added.

The General Connection is intended for administration tasks. The AMQP Connection is intended for message management. When message management is not required, the AMQP connection can be ignored.

5. On the SSL tab, configure SSL security (Trust Store and Key Store paths and passwords). For meshIQ Cloud users, in the Trust Store Path field on the SSL tab, enter the path to the uploaded certificate file, as shown on the Certificates tab of your meshIQ Cloud subscription page.
   
6. On the AMQP tab, you can add AMQP protocol configurations by clicking Add. The Add AMQP dialog then opens.From version 11.2.4 onwards, when you click Add, the Add AMQP dialog opens with two tabs: General and SSL.

• General Tab
  In the General tab, you can define AMQP connection settings in one of the two modes:

  • Full Definition (selected by default)

  • URL Mode

• SSL Tab
  In the SSL tab, you can optionally configure secure communication settings.
  

7. Once finished, click Ok to create connection immediately, or click Schedule to create the connection at a later time (see Scheduling for details).

Verify a manager connection

See Verify a remote manager connection.

Edit a manager connection

1. Select a workgroup server within the Workgroup Server viewlet.
2. From the pop-up menu, select Create > Remote Rabbit MQ Managers. The Remote Rabbit MQ Manager Connections window opens.
3. Select the remote connection that you want to modify.
4. Click Modify.
5. Make your changes and click OK.

Copy a manager connection

The Copy as command is used to copy the definition of an existing connection manager to a new one.

1. Select a workgroup server within the Workgroup Server viewlet. 
2. From the pop-up menu, select Create > Remote Rabbit MQ Managers. The Remote Rabbit MQ Manager Connections window opens.
3. Select the remote connection that you want to use as a basis for a new connection.
4. Click Copy as.
5. Make your changes and click OK.

Delete a manager connection

1. Select a workgroup server within the Workgroup Server viewlet. 
2. From the pop-up menu, select Create > Remote Rabbit MQ Managers. The Remote Rabbit MQ Manager Connections window opens.
3. Select the remote connection that you want to delete.
4. Click Delete.
5. At the confirmation message, click Yes to confirm the deletion, No to cancel it, or Schedule to specify a future date and time to delete the object.