Configure agent connectivity settings

When agents are connected to a server, every request goes to an actor pool. All requests are spread evenly between actors in a pool.

You can configure:

  • How many actors are available for processing agent requests.
  • When a server should stop checking agent connectivity status due to a large number of requests. For details, see Configure agent connectivity status checks.

To configure agent connectivity settings:

  1. Navigate to the Common Tomcat da\WEB-INF\classes directory, for example:

    C:\Program Files\Micro Focus\common\tomcat\8.5\webapps\da\WEB-INF\classes

  2. Open the da_config.xml file. This file contains your agent connectivity settings.

    Note: Deployment Automation contains two da_config.xml files, one in the web application and one in the user profile. Every DA server upgrade restores the web application's da_config.xml settings to default. To make your changes permanent, copy the settings from the web application to the DA user profile and configure them there.

  3. Copy the <agentActorManager> settings from the da_config.xml file:

    <agentActorManager>

    ...

    </agentActorManager>

  4. Navigate to the DA user profile directory where the DA server configuration is stored, for example:

    C:\Users\<username>\.microfocus\da\conf\server

  5. Open the da_config.xml file in the user profile directory and paste the copied <agentActorManager> settings there.

  6. Edit the <agentActorManager> settings in the da_config.xml file. The following table provides descriptions of the settings:

    Setting Description
    threadPoolSizeMultiplicationCoefficient Specifies a multiplication coefficient for an actor pool. The number of logical CPUs is multiplied by this coefficient to calculate the number of actors in the actor pool. For example, if the coefficient is 0.75 and the server has 4 logical CPUs, the actor pool size is 3.
    The default value is 0.75.
    busyWhenQueueSizeIsHigherThan Specifies the maximum average number of connectivity tasks that can be processed during a verification period. If there are more connectivity tasks than specified, the agent manager is considered to be busy and agent status checks are not performed.
    The default value is 100.
    For details, see Configure agent connectivity status checks.
    busyWhenConnectedMoreThan Specifies the maximum average number of connectivity tasks that can be processed during a verification period. If there are more connectivity tasks than specified, the agent manager is considered to be busy and agent status checks are not performed.
    The default value is 500.
    For details, see Configure agent connectivity status checks.

    Use this example of agent connectivity settings:

    <agentActorManager>
       <threadPoolSizeMultiplicationCoefficient>0.75</threadPoolSizeMultiplicationCoefficient>
       <busyWhenQueueSizeIsHigherThan>100</busyWhenQueueSizeIsHigherThan>
       <busyWhenConnectedMoreThan>500</busyWhenConnectedMoreThan>
    </agentActorManager>
  7. Save your changes.
  8. Restart Common Tomcat.

Back to top

See also: