Some of the content 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 Solace connection 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 Solace Manager Connection

1. Select the Solace node, then from the Selected menu, click Manage Connections.
   
2. The Remote Solace Manager Connections dialog opens.
   – Hover over a Remote Solace manager to view its attributes on the right side of the dialog.
   – You can sort columns in the remote Solace manager table alphabetically by clicking the column headers.
   
3. Click the Add Remote Manager Connection button to create a new remote Solace manager connection.
4. The Add Solace Manager Connection dialog opens. 
5. Enter the configurations for the new Solace connection manager on the General, Key, and JCSMP tabs. For meshIQ Cloud users, in the Trust Store Path field on the Key tab, enter the path to the uploaded certificate file, as shown on the Certificates tab of your meshIQ Cloud subscription page.
   To learn more about the fields, see Remote Solace Manager Field Descriptions.
6. 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 Solace node, then from the Selected menu, click Manage Connections.
2. The Remote Solace Manager Connections dialog opens.
3. Select the remote connection that you want to modify.
4. From the Selected menu, click Modify.
   
5. The Change Solace 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 Solace node, then from the Selected menu, click Manage Connections.
2. The Remote Solace 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 Solace 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 Solace node, then from the Selected menu, click Manage Connections.
2. The Remote Solace 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 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 covers how to create a remote Solace connection 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 Solace manager connection:

1. Select a workgroup server within the Workgroup Server viewlet. 
2. From the pop-up menu, select Create > Remote Solace Managers. The Remote Solace Manager Connections window opens where you can add a new Solace connection manager.
   
3. Click the Add button.  The Add Solace Manager Connection window opens.
   
4. Enter the configurations for the new Solace connection manager on the General, Key, and JCSMP tabs. For meshIQ Cloud users, in the Trust Store Path field on the Key tab, enter the path to the uploaded certificate file, as shown on the Certificates tab of your meshIQ Cloud subscription page.
5. Click Ok when finished.

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 Solace Managers. The Remote Solace 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 Solace Managers. The Remote Solace 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 Solace Managers. The Remote Solace 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.