WebSphere Extended Deployment, Version 6.0.x
             Operating Systems: AIX, HP-UX, Linux, Solaris, Windows, z/OS


Change the health management controller runtime configuration with scripting

You can modify your health management runtime configuration to enable or disable the health management controller and automated restarts for the server, and set or get values for other health management settings with the following Jacl script.

Purpose

To change runtime settings, you must have operator or administrator administrative privileges.:

With the HmmControllerProcs.jacl file, you can:
  • Enable or disable the health management controller.
  • Enable or disable automated restarts for the server.
  • Set or get values for other health management settings.

The HmmControllerProcs.jacl script only modifies the runtime configuration.

Location

The HmmControllerProcs.jacl script is located in the bin directory.

Usage

To run the HmmControllerProcs.jacl script with the wsadmin tool, use the following command:
wsadmin -profile HmmControllerProcs.jacl -c "insert_procedure_parameters"
Replace the insert_procedure_parameters variable with the name of the procedure and the proper variable values to complete your changes. You might have to modify the wsadmin command to wsadmin.sh or wsadmin.bat, depending on your operating environment.
You might be more comfortable with launching the scripting client first. See Getting started with scripting for more information. In the wsadmin tool, type:
wsadmin> source HmmControllerProcs.jacl
wsadmin> procedure variables
Replace the procedure variable with the procedure that you want to invoke. Replace the variables variable with specific variables that support your procedure.

Procedures

To see a list of all available procedures, use the following command:
wsadmin -profile HmmControllerProcs.jacl -c "help"
Table 1. Procedures for the HmmControllerProcs.jacl script
Procedure name Function
enable Enables the health management controller.
disable Disables the health management controller.
isEnabled Verifies that the health management controller is enabled.
enableServer nodename servername Enables automated restarts for the server on the specified node.
disableServer nodename servername Disables automated restarts for the server on the specified node.
isServerEnabled nodename servername Verifies if automated restarts are enabled for the server on the specified node.
isNodeMaintenance nodename Verifies if the health management controller acknowledges that the specified node is in maintenance mode.
getMaxConsecutiveRestarts Returns the number of attempts to revive an application server after a restart is performed. If the maximum value is exceeded, the server is declared failed and server restarts are disabled.
setMaxConsecutiveRestarts number Sets the number of attempts to revive an application server after a restart is performed.
getControlCycleLength Returns the length of time, in minutes, between health policy checks on the application server instances to determine if breaches occurred.
setControlCycleLength time_in_minutes Sets the length of time, in minutes, between health policy checks on the application server instances to determine if breaches occurred.
getMinRestartInterval Returns the length of time that must pass between application server instance restarts.
setMinRestartInterval time_in_minutes Sets the length of time that must pass between application server instance restarts.
getRestartTimeout Returns the length of time that the controller uses to wait for start and stop events during a restart before polling the server status.
setRestartTimeout time_in_minutes Sets the length of time that the controller uses to wait for start and stop events during a restart before polling the server status.



Related concepts
Health management
Related tasks
Configuring health management
Enabling and disabling health management
Monitoring and tuning health management
Related reference
Administrative roles and privileges
Reference topic    

Terms of Use | Feedback

Last updated: Nov 30, 2007 4:05:14 PM EST
http://publib.boulder.ibm.com/infocenter/wxdinfo/v6r0/index.jsp?topic=/com.ibm.websphere.xd.doc/info/reference/todhmmscripts.html