A remediation action runs a local script in a node. The script executes on the machine from which it was invoked or on the node specified by the remediation action configuration. You can use this type of action to automate your runbook procedures. You can optionally configure the remediation action to require human approval before the script is started. See Actions Requiring Approval.
A remediation script is run on the machines that you specify in the remediation script configuration. You can run the script from the machine affected by the violation that triggered the action or from a central management server. It is not necessary for an app agent to be running on the machine on which the script executes, just a machine agent.
The following remediation action, named increasePool, executes a local script named runbook.sh, which increases the size of the connection pool on the JVM.
A policy named ConnectionPoolPolicy triggers this action when the Resource Pool Limit Event fires:
After entering a name for the action, in the field that terminates the Relative path to script entry enter the rest of the path to the executable script.
Remediation scripts must be stored in a sub-directory of the machine agent installation. The sub-directory must be named "local-scripts". The following paths are all valid:
When you bind the action to a policy, you specify the nodes on which the script should execute. You can configure the number of nodes or the percentage of nodes or you can configure a specific node. This flexibility allows you to configure scripts to run from a central management server, not just the node on which the violation occurred.
In the Configure Action window of the policy's actions to execute, either:
Select Execute Action on Affected Nodes and the percentage of the nodes or the number of nodes on which to run the script.
To designate the specific node on which to run the script, select Execute Action on Specified Node, and select the node on which the script should run from the popup node browser. You can either save the configuration or change it to designate a different node.
In the Events list, locate the row for the event that triggered the action for which you want to see the results.
In the Actions column of the selected row, click the remediation script icon.
In the script results list, select the script output that you want and click Download Local Script Result.
When a remediation action is triggered by a backend discovery event, if the backend is not resolved quickly the policy will not start the local script.
For full-screen viewing, click Run Remedian Scripts for Policy Actions.