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\9.0\webapps\da\WEB-INF\classes

  2. Open the web application's da_config.xml file. This file contains your agent connectivity settings.

  3. Copy the <agentActorManager> section from the da_config.xml file.

    For example:

    Copy code
    <agentActorManager>
       <threadPoolSizeMultiplicationCoefficient>0.75</threadPoolSizeMultiplicationCoefficient>
       <busyWhenQueueSizeIsHigherThan>100</busyWhenQueueSizeIsHigherThan>
       <busyWhenConnectedMoreThan>500</busyWhenConnectedMoreThan>
    </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> section there.

    Note: Deployment Automation contains two da_config.xml files, one in the web application and one in the DA user profile. After the server upgrade, the web application's da_config.xml settings are restored to default. To make your modifications permanent, you need to store them in the da_config.xml file located in the DA user profile directory.

  6. In the <agentActorManager> section, modify the following settings as needed:

    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.

  7. Save your changes.
  8. Restart Common Tomcat.

Back to top

See also: