Monitoring policy settings

Use this page to view or change settings that control how the node agent monitors and restarts a process.

To view this administrative console page, click Servers > Application Servers > server_name. Then, under Server Infrastructure, click Java and Process Management > Monitoring Policy.

Configuration tab

Maximum Startup Attempts

Specifies the maximum number of times to attempt to start the application server before giving up.

Data type Integer
Default

3

Ping Interval

Specifies, in seconds the frequency of communication attempts between the parent process, such as the node agent, and the process it has spawned, such as an application server. Adjust this value based on your requirements for restarting failed servers. Decreasing the value detects failures sooner; increasing the value reduces the frequency of pings, reducing system overhead.

Data type Integer
Range Set the value greater than or equal to 0 (zero) and less than 2147483. If you specify a value greater than 2147483, the application server acts as though you set the value to 0. When you specify a value of 0, no checking is performed.
Default

60

[z/OS] In a z/OS environment, the Ping Interval setting for a deployment manager or a node agent is ignored. However, the Ping Interval setting for an application server is used by the node agent to control the native z/OS operating system PidWaiter monitoring function. PidWaiter monitoring is similar in functionality to the pinging function that is used in a distributed platform environment. Both of these monitoring functions determine whether an application server is still running. The only difference between the two monitoring functions is that PidWaiter monitoring does not send any of the TCP/IP messages that Ping Interval monitoring sends.

Avoid trouble Avoid trouble: [Updated in October 2010]
  • If you set this property to 0. which indicates that no checking is performed, certain threads, such as PidWaiter, might terminate before the threads return their status to the initiating thread. In these situations, the deployment manager might not notifying the node agents of certain events, which could negatively impact stopServer.sh processing.
  • If you set this property to a value greater than 0 but less than or equal to 5, the actual value used for the Ping Interval is 5.
[Updated in October 2010]
oct2010
gotcha
[z/OS] You can also set the following two properties to considerably reduce the number of DNS lookups that might occur because of this monitoring activity:
  1. You can add the JVM custom property com.ibm.websphere.management.monitoring.pingInterval for the controller for each process. The default value for this property is 60 seconds. It is not recommended that you change this default value unless you need to minimize the number of DNS lookups that occur. If you need to minimize the number of DNS lookups that occur, set this property to a time interval that is more appropriate for your system.

    When this property is set for the deployment manager, it regulates how frequently the deployment manager checks to see if the node agent is still running. When it is set for the node agent, it regulates how frequently the node agent checks to see if the deployment manager is still running. When it is set for an application server, it regulates how frequently the application server checks to see if the node agent is still running.

  2. You can add the environment variable protocol_iiop_resolve_foreign_hostname at the cell level, and set to 0. Setting this variable to 0 disables the IIOP resolve foreign hostname function, thereby eliminating the DNS lookups this function performs.

[z/OS] Adding these two properties does not completely eliminate DNS lookups from within WebSphere Application Server processes.

Ping Timeout

When a parent process is spawning a child process, such as when a process manager spawns a server, the parent process pings the child process to see whether the child was spawned successfully. This value specifies the number of seconds that the parent process should wait (after pinging the child process) before assuming that the child process failed.

Data type Integer
Units Seconds
Range Set the value greater than or equal to 0 (zero) and less than 2147483647. If you specify a value greater than 2147483647, the application server acts as though you set the value to 0.
Default

300

Automatic Restart

Specifies whether the process should restart automatically if it fails.

If you change the value specified for this field, you must restart the application server and the node agent before the new setting takes effect.

This setting does not affect what you specified for the Node Restart State setting. The two settings are mutually exclusive.

Data type Boolean
Default

[AIX HP-UX Linux Solaris Windows] [iSeries] true for the Distributed and i5/OS platforms

[z/OS] false for the z/OS platform

Node Restart State

The setting only displays for the Network Deployment product. It specifies the desired behavior of the servers after the node completely shuts down and restarts.

If a server is already running when the node agent stops, that server is still running after the node agent restarts. If a server is stopped when the node agent restarts, whether the node agent starts the server depends on the setting for this property:
  • If this property is set to STOPPED, node agent does not start the server.
  • If this property is set to RUNNING, the node agent always starts the server.
  • If this property is set to PREVIOUS, the node agent starts the server only if the server was running when the node agent stopped.
Note: Changes you make to the node restart state become effective after the node is synchronized. At the next NodeAgent restart (after the synch), the node restart state will be honored.

This setting does not affect what you specified for the Automatic Restart setting. The two settings are mutually exclusive.

Data type String
Default STOPPED
Range Valid values are STOPPED, RUNNING, or PREVIOUS. If you want the process to return to its current state after the node restarts, use PREVIOUS.



Related tasks
Defining application server processes
Reference topic    

Terms of Use | Feedback

Last updated: Feb 19, 2011 5:25:36 AM CST
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=v610web&product=was-nd-mp&topic=urun_rmonitorpol
File name: urun_rmonitorpol.html