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.
Purpose
To change runtime settings, you must have operator or
administrator administrative privileges.
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"