Salesforce

What is the purpose of the killAgentAfterTimeout property

« Go Back

Information

 
TitleWhat is the purpose of the killAgentAfterTimeout property
URL NameWhat-is-the-purpose-of-the-killAgentAfterTimeout-property
Article Number000184721
EnvironmentProduct: OpenEdge Application Server
Version: OE 11.6 and later
OS: All supported platforms
Other: WebSpeed
Question/Problem Description
What is the purpose of the killAgentAfterTimeout property?
What does the killAgentAfterTimeout property do when enabled?
Where must the killAgentAfterTimeout property be configured in the ubroker.properties file?
Steps to Reproduce
Clarifying Information
Error Message
Defect NumberDefect PSC00350380/ADAS-14377
Enhancement Number
Cause
Resolution
KillAgentAfterTimeout was introduced for WebSpeed in OpenEdge 11.6. This parameter is documented in the 11.6 and later ubroker.properties.README file
     
killAgentAfterTimeOut=false
Setting this property to true will kill the WebSpeed Agent when the connectingTimeout elapses

OpenEdge 11.6:

The killAgentAfterTimeout property is found under both the UBroker parent section: [UBroker] and [UBroker.WS] and defaults to true.

When the parameter is set to true at the UBroker parent section:
  • AppServers will start without error when started with OpenEdge 11.6
  • AppServers fail to start, if the AppServer is started with a version prior to OpenEdge 11.6 (where the killAgentAfterTimeout property name is invalid because it does not exist): 
Unable to start <appserver name> due to Invalid property name: "killAgentAfterTimeout". (PRPMsg009)

Note: AppServer logs are not even generated or written to when the error above occurs.

 
The killAgentAfterTimeout property is only applicable for WebSpeed, since OpenEdge 11.6.
  • Manually edit the ubroker.properties file and remove this entry under the [UBroker] Section.
  • Only set the killAgentAfterTimeout property for WebSpeed Brokers started with OpenEdge 11.6.

OpenEdge 11.7:

The killAgentAfterTimeout property is removed from [UBroker] Section. It is added only under the [UBroker.WS] section and defaults to false (disabled).

If the killAgentAfterTimeout property is manually added or erroneously added with mergeprop to the [UBroker] Section, it is an invalid property for anything but a WS and the AppServer will fail to start. The error is recorded in the cmdplugin.log:
Unable to start <appserver name> due to Invalid property name: "killAgentAfterTimeout". (PRPMsg009)

Mergeprop incorrectly sets the property killAgentAfterTimeout=true under the [UBroker.WS] section. If the enabled behavior is not required, manually edit the ubroker.properties file and set the property to false under the [UBroker.WS] or specific WebSpeed Broker Sections. This information is detailed in the 11.7.1 Release Note: PSC00350380
Workaround
Notes
Keyword Phrase
Last Modified Date1/15/2020 9:08 PM

Powered by