HP Operations Manager

Configure the number of retries for gethostbyname() and gethostbyaddr()


Independent of whether name server caching is enabled or disabled, the Windows API functions gethostbyname() and gethostbyaddr() will be used at some points. Under certain conditions (network problem, DNS problems) these calls might fail. This would then be interpreted as "node name could not be resolved". There is however a very low probability that a name or IP address could be successfully resolved if these calls would be retried more often.

By default, the maximum number of retries is 3. So if the first call fails, there is a maximum of 2 more retries. Such retries however have a significant impact on the time it takes to decide whether a node name is resolvable or not. If the assumption can be made that the network and DNS is reliable and is properly configured, then the number of retries can be set to the minimum value of 1. In case there are some doubts on the reliability of the network and DNS, the number should be set to 2 or 3.

The number of overall retries for the Windows API calls gethostbyname() and gethostbyaddr() is configured by the value Name resolution retries in the Node Cache Settings namespace in the Server Configuration dialog box. After you have changed a value, restart the OvEpMessageActionServer service for the change to take effect.

Value Value Range Effect
Name resolution retries 1-3 Specifies the maximum number of retries in case of unsuccessful gethostbyname() and gethostbyaddr() function calls.

Default value=3

Related Topics: