HmmControllerProcs.jacl script
Use the HmmControllerProcs.jacl script, we can modify the 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.
We 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 the changes. We might have to modify wsadmin to wsadmin.sh or wsadmin.bat, depending on the 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 server_name
- Enables automated restarts for the server on the specified node.
- disableServer node server_name
- Disables automated restarts for the server on the specified node.
- isServerEnabled node server_name
- Verifies if automated restarts are enabled for the server on the specified node.
- isNodeMaintenance node
- 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 Enable health management Monitor and tune health management
Intelligent Management: administrative roles and privileges