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, you must 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 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"
- 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"