How do I configure workgroup server connection definitions?

Some of the content described in this article is available in meshIQ Manage versions 11 and greater. See meshIQ Highlights v11 for an overview of feature changes.

Add or modify connections

You will be presented with a list of existing connections.

To add a new connection, click Add. To edit an existing connection, select its checkbox and click Modify.

• The primary setting is the Connection Name.
• The Server(s) field contains the list of servers by host or IP address where it runs. (See also the Failover section below.)
• The port number will always be the same for all instances.

Failover

Multiple servers can be listed for failover, such as grid or other failover techniques. If you enter more than one server, you must separate entries using commas, as shown below. The user session will connect to the first active workgroup server. Should that workgroup server failover to another one in the list, the user will need to reconnect in order to continue. 

Reassign Viewlets

You can also manage viewlet to workgroup server mappings if you need to reconfigure workgroup server definitions. To reassign viewlets from one workgroup server connection to another:

1. Click Re-Assign Viewlets. The Viewlet Reassignment Location Picker opens.
2. Select the connection that you want to reassign viewlets from using the Connection From list.
3. Select the connection that you want to reassign viewlets to using the Connection To list.
   
4. Click Next.
5. Locate the viewlets you want to reassign using the filter text box (under Viewlets:) and the viewlet type list to the right.
   
6. Select the viewlet you want to reassign and click the Assign > button. Or to move all viewlets listed on the left, click Assign All >>.
   
7. Click OK.

Create connection groups

1. Click Connection Groups. The WGS Connection Group Properties window opens.
   
2. Enter a Connection Group Name for the new group.
3. Locate the connections you want to add to a group using the Filter By: text box.
4. Select the connection you want to add and click the Assign > button. Or to move all connections listed on the left, click Assign All >>.
5. Click Save. The new group is added.
   
6. Click Close to return to the Work Group Server Connections dialog.

Verify connections

1. Select the workgroup server connection you want to verify.
2. Click Verify connection. The Enter Password dialog is displayed.
   
3. Enter your Password and click OK. The Verify connection button changes to indicate that the application is attempting to connect.
   

If the connection is successful, a "Connection successful" message is displayed: