Administer the CA Process Automation Domain › Configure the Contents of the Domain › Configure Domain Properties

Configure Domain Properties

The Domain is the root element in the CA Process Automation hierarchy. You can edit some Domain properties, such as the frequency with which agents notify the Domain Orchestrator that they are active. Changing the heartbeat value from 2 to 3, for example, can reduce the network traffic. The setting that you specify at the Domain level can be inherited or overridden at the environment level.

Note: See the User Interface Reference for field descriptions.

The Content administrators in the PAMAdmins group can lock the Domain and can edit Domain properties. The Domain_Admin permission in the CA EEM Domain policy grants authorization.

Follow these steps:

1. Click the Configuration tab.

   The Configuration Browser palette opens with the Domain node selected.

2. Click the Properties tab.
3. View the read-only fields, for example:
   1. View the Domain URL entry. This entry is the first part of the URL you use to browse to CA Process Automation. The Domain URL entry can identify either the Domain Orchestrator or the load balancer. The URL can indicate secure or basic communication.
   2. View the Host Name entry. This entry identifies the host where the Domain Orchestrator is installed.
   3. View the Orchestrator Name entry. At the Domain level, this entry is the Domain Orchestrator by default.
   4. View the Status entry. The Domain status can have values such as Active or Locked by user ID.
4. With the Domain node selected, click Lock.

   When you lock the Domain, only you can edit the Domain properties.

5. To edit the Heartbeat Interval (minutes) setting, select a new value from the spinner.

   Setting a new value changes how often agents send a heartbeat to the Domain Orchestrator. By default, agents send a heartbeat every 2 minutes. This configuration applies to all agents in the Domain, but you can override this inherited value for any specific agent. Increasing the value reduces network traffic; increasing the interval to every 1 minute lets you identify agent problems more quickly.

6. Consider leaving the default Touchpoint Security setting (Disabled) in place at the Domain level.

   The Enabled setting specifies to verify and enforce user rights on the targets in a given process. The user rights are configured in a custom CA EEM policy that uses the Touchpoint Security resource class. You can grant execute rights to a user or group for a specific environment or touchpoint.

   Note: See Approach to Configuring Touchpoint Security.

7. Configure the Host Group targets according to the following guidelines:
   • Disable the Match target in Host Groups only? property if the patterns configured for host groups sometimes match the IP addresses or host names of:
     • Hosts that have installed agents that are associated with touchpoints.
     • Remote hosts that are connected to agents associated with proxy touchpoints.

     Note: In this case, the product disables Lookup DNS when matching target in Host Groups? by default.

   • Enable the Match target in Host Groups only? property if the patterns configured for host groups rarely match the IP addresses or host names of:
     • Hosts that have installed agents that are associated with touchpoints.
     • Remote hosts that are connected to agents associated with proxy touchpoints.
   • Disable the Lookup DNS when matching target in Host Groups? property if content designers typically use the following conventions:
     • They use a host name when the pattern type used in the Host Group configuration is a host name pattern.
     • They use an IP address when the pattern type used in the Host Group configuration is a subnet, IP address range, or IP address list.
   • Enable the Lookup DNS when matching target in Host Groups? property if content designers are aware that Host Groups reference specific hosts in some way, but they do not necessarily know how. Enabling the property ensures that the operator can find a target host. For example, an operator that specifies the host as an IP address can find the target when the Host Group references it with a host name pattern.
8. Specify requirements for purging reporting data that was generated in this Domain. Alternatively, purge reporting data on demand where you specify the date range for when the reports were generated.
   1. Specify whether to purge reporting data daily in the Option to Purge Reporting Data field. If you select Purge Reporting Data Daily, specify the time of day to start the purge. For example, to start the purge at 6:30 PM, specify the military time equivalent, 18:30 in the Start Time to Purge Reporting Data Daily field.
   2. If you specified a purge schedule, indicate the number of days to retain reporting data before it is purged. For example, an entry of 14 in the Number of Days to Keep Reporting Data field specifies to purge all reporting data that is more than two weeks old.
   3. Click the Delete Reporting Data button, specify a date range for the reporting data to delete, and click OK.
9. To generate reporting for processes, select the Enable Process Reporting check box. To disable this capability, clear the Enable Process Reporting check box.
10. To generate reporting data for operators, select the Enable Operator Reporting check box. To disable this capability, clear the Enable Operator Reporting check box.
11. To allow the product to display process logs to content designers in the design environment, select the Enable Process Logs check box. To hide run-time process instance logs at the environment level for the production environment, clear the Enable Process Logs check box.
12. The Agent Configuration Update Interval (minutes) field lets you define the frequency at which the Domain orchestrator checks and, if appropriate, sends configuration updates to agents.
13. To automate the operator recovery, accept the default for the Enable Operator Recovery property.
14. Click Save.
15. Select Domain and click Unlock.

More information:

Lock the Domain

Approach to Configuring Touchpoint Security

Oasis Configuration Properties File