During troubleshooting connectivity issues between Web Agent and Policy Server, the documentation mentions the AgentWaitTime parameter (1).
It specifies the number of seconds the Web Agent is allowed to wait for the Low-Level Agent Worker process (LLAWP) to become available. When the interval expires the Web Agent tries to connect to the Policy Server. Setting this parameter may help resolve agent start-up errors related to slower network connectivity or slow Web Server initialization.
As this setting is related to Agent initialization, it still has not contacted Policy Server and loaded the ACO from the Policy Store. This parameter must be configured locally in the WebAgent.conf file.
NOTE --> please make sure that this parameter is set in WebAgent.conf ONLY as Indicated. Setting it in both WebAgent.conf and ACO can cause Initialization Errors.
There is no maximum value.
The following formula could be used as a guide for calculating the optimum value for AgentWaitTime:
The_number_of_Policy_Servers x 30) + 10 = value of the AgentWaitTime parameter (in seconds).
For example, if there are 5 Policy Servers, then set the value of the AgentWaitTime parameter to 160. [(5x30) + 10 = 160] (seconds).
Here, the Policy Servers used are the only bootstrap Policy Servers as specified in the SmHost.conf file. The idea is to allow at least 30 seconds interval for initialization of each bootstrap Policy Server.
However, that said, this is just guidance. Choose any higher value that is necessary.
If the network is good and the LLAWP takes only a few seconds to connect to Policy Server and perform initialization, then even having a specified higher value for AgentWaitTime that will not matter.
For E.g. configured AgentWaitTime is 200 seconds.
But as the network is in a good state and it took Web Agent only 5 seconds to initialize, then it will only spend 5 seconds in initialization, it won’t wait for the complete 200 seconds to expire.
In that sense, there is NO disadvantage to setting AgentWaitTime to a high value.
Moreover, AgentWaitTime plays a role only during initialization/startup, it does not have any impact whatsoever on the normal communication of the Agent to the Policy Server, e.g isProtected, isAuthroized calls, etc.
Default value: 5
For more information, see Accommodate Network Latency section in
Basic Agent Setup and Policy Server Connections.