Creating an external script actions job
External script actions are external programs (located in the endorsed directory), that can be executed as job actions (as discussed in Creating a job). Some external operations that can be executed as external script actions are the following:
- Archiving device trusted configuration files into a CVS system
- Updating a device database with configuration elements
- Resetting the password for all devices based on a dynamically generated password
- Adding a device record after a new module or virtual device context is provisioned
The product does not ship with external script actions. They are used only when they are imported by using the Admin > Device Adapters from the web-based GUI. For detailed information about how to create new external script actions, see Developing an external script action adapter.
The following figure shows an external script action created from one of the examples mentioned in Developing an external script action adapter. This script archives device trusted configuration files into a CVS system.
To configure a script action, you must enter information in the following fields:
(Optional) Annotation assigned to the action.
Select a realm, group, multiple devices, or a single device for the external script action. When the Network Span is Realm or Group, you can use Filter Devices to select which devices to include in the action. If the external script needs to be executed for all the device in the span, the execution is performed serially in the order of the device names.
When the action is defined to use an ad-hoc template, this control appears to allow you to create and edit the template contents. The contents can include device, agent, and global substitution parameters. When the action runs, the parameters are resolved, and the resolved contents are written to a temporary file for the external script to use.
The dialog box displays various additional runtime parameters that are declared in the external script definition (as for custom actions).
On Error Skip Remaining Devices
Defines the execution behavior of the script when it is executed for all the devices in the selected span.