Operating Systems: AIX, HP-UX, Linux, Solaris, Windows, z/OS
HmmControllerProcs.jacl
With the HmmControllerProcs.jacl script, you can modify your health management runtime configuration to enable or disable the health controller and automated restarts for the server, and set or get values for other health management settings.
Purpose
To change runtime settings, have operator or administrator administrative privileges.: With the HmmControllerProcs.jacl file, you can:
- Enable or disable the health 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 variablesReplace the procedure variable with the procedure 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"
- enable
- Enables the health controller.
- disable
- Disables the health controller.
- isEnabled
- Verifies that the health controller is enabled.
- enableServer node_name server_name
- Enables automated restarts for the server on the specified node.
- disableServer node_name server_name
- Disables automated restarts for the server on the specified node.
- isServerEnabled node_name server_name
- Verifies if automated restarts are enabled for the server on the specified node.
- isNodeMaintenance node_name
- Verifies if the health 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_of_consecutive_restarts
- 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.
Example
The following command enables automatic restarts on the server_1 server, which runs on the node_1 node:wsadmin.sh -profile HmmControllerProcs.jacl -c "enableServer node_1 server_1"
Related concepts
Health management
Related tasks
Configure health management
Enabling and disabling health management
Monitor and tuning health management
Related reference
Administrative roles and privileges