Connection groups

This topic describes how to group connections and configure a connection group.

Group connections

You can group connections into logical groups, for example, by data source. By default, all connections are assigned to the Default Group.

To assign a connection to a group:

  1. To change a connection's group, open the connection for editing by clicking on the gear icon and choosing Edit.

  2. In the Connection Wizard's Data Source page, locate the Connection Group Settings section.

  3. Select a connection group or click + Add to create a new group. Click Save.

  4. In the dashboard, the Connections tab shows a list of the connections by group. You can expand and hide the contents of each group.

  5. To change the name of a group, click the Edit button adjacent to the group name in the Connection group view and enter a new name. You can also use a script to rename a connection. For details, see Connection management scripts.
  6. To change a connection's group, open the connection for editing and choose the group name. For details, see Connection groups.

Tip: You can also back up your connection groups through an export, as you would export standalone connections. We recommend that you back up your groups before performing an upgrade, as groups are not preserved when you upgrade your installation. For details, see Import, export, and back up data.

Back to top

Configure a connection group

Configure a connection group to restrict how many connections in the group can start and run synchronizations at the same time.

When a connection in a group tries to start or run a synchronization, the group workload is evaluated, including the amount of tasks currently running in the group and their statuses. If the workload does not exceed the limit, the current execution is allowed. If the workload exceeds the limit, the current execution will be retried later.

To configure a connection group:

  1. Next to the connection group name, click the Edit button , and select Edit.

  2. In the Connection Group Configuration dialog box, configure the following options.

    Configuration Option Description
    Maximum concurrent initializations

    Restricts how many connections can start synchronizations at the same time. An initialization is indicated by the Starting status.

    Recommendation: 2 or higher. This avoids the situation where a connection is stuck and other connections have to wait until the malfunctioned connection completes.

    Default value: empty, meaning only one connection in the group can start a synchronization at the same time.

    Valid value: Any positive integer

    Example:

    Suppose group contains 3 connections and the concurrent initialization limit is set to 1.

    If you start all connections in the group, only one connection is allowed to start the synchronization at the same time. Other connections have to wait in queue.
    Maximum concurrent iterations

    Restricts how many connections can synchronize at the same time. An iteration is indicated by the Running status.

    If you want to limit concurrent iterations for a group that contains both long-running connections and fast-running connections, OpenText recommends that you increase the limit. Otherwise, the fast-running ones may have to wait for long to start or run a synchronization.

    Default value: empty, meaning all connections in the group can run synchronizations at the same time.

    Valid value: Any positive integer

    Example:

    Suppose group contains 3 connections, the concurrent initialization limit is set to 3, and the current iteration limit is set to 1.

    If you start all connections in the group, all connections are allowed to start the synchronizations at the same time, while only one connection is allowed to synchronize. Other connections have to wait in queue.

  3. Click Save.

Back to top