Previous Topic: Add One or More Agents to an Existing TouchpointNext Topic: Associate a Touchpoint with a Different Agent


Add Touchpoints for Agents in Bulk

You can add touchpoints to new agents in bulk by specifying patterns for agent host names or IP addresses. Every agent with a host name or IP address that matches a specified pattern is automatically configured with a touchpoint. The touchpoint name is the same as the agent display name. An auto-admit pattern is a host name pattern expressed as a regular expression or an IP address subnet expressed in CIDR notation.

You can configure different auto-admit patterns for each environment or you can configure the same or overlapping auto-admit patterns across environments. Touchpoints are environment-specific. Agents are not environment-specific.

Follow these steps:

  1. Click the Configuration tab.
  2. Expand Domain in the Configuration Browser.
  3. Right-click the environment you want to configure, and click Lock.
  4. Click the Auto-Admit tab.
  5. For each IP address pattern, take the following steps. Then use the up and down arrows to order the search list.
    1. Click Add in the IP Address Patterns area.

      An entry field appears.

    2. Enter an IPv4 subnet using CIDR notation.

      Note: CA Process Automation uses CIDR pattern matching for auto admit requirements. For example, the CIDR pattern 155.32.45.0/24 matches IP addresses in the range 155.32.45.0 through 155.32.45.255.

  6. For each host name pattern, take the following steps. Then use the up and down arrows to order the search list.
    1. Click Add in the Host Name Patterns area.
    2. Enter a host name pattern.

      Note: The host name of the Orchestrator/agent is compared to the regular expressions specified. For example, if the pattern specified is ca\.com$, then all agents/Orchestrators whose host names end with ca.com are added.

  7. Right-click the environment, and click Unlock.
  8. Repeat this procedure for each environment.

    The Domain searches for a new Orchestrator and new agents with IP addresses or host names that match the auto-admit patterns for one or more environments.

    When the Domain discovers such new agents, the Domain creates a touchpoint for each match and automatically adds it to each environment. The name of the touchpoint is the display name of the agent.

    When the Domain discovers such an Orchestrator, the Domain creates one touchpoint for that Orchestrator and adds it to the first matching environment. An Orchestrator has only one touchpoint.

Example of touchpoints added to environments based on agent auto-admit patterns

In the following example, overlapping auto-admit patterns are defined for two environments. Two agents are installed, where the IP address of one matches the auto-admit pattern in one environment and the IP address of the other matches the auto-admit patterns in both environments. The result is that three touchpoints are automatically added.

The following touchpoints are automatically added based on the auto-admit patterns: