HmmControllerProcs.jacl script

Using 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 retrieve values for other health management settings.

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

Purpose

You can use the HmmControllerProcs.jacl file to complete the following actions.

Enable or disable the health controller.
Enable or disable automated restarts for the server.
Set or retrieve values for other health management settings.

The HmmControllerProcs.jacl script only modifies the runtime configuration.

Location

The HmmControllerProcs.jacl script is in the app_server_root/bin directory.

Usage

Run 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.

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"