Important

   

Starting version 8.9.03, BMC Network Automation is renamed to TrueSight Network Automation. This space contains information about BMC Network Automation 8.9.02 and previous versions. For TrueSight Network Automation 8.9.03 and later releases, see the TrueSight Network Automation documentation.

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:

Field

Description

Annotation

(Optional) Annotation assigned to the action.

Network Span

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.

Ad-Hoc Template

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.

Runtime parameters

The dialog box displays various additional runtime parameters that are declared in the external script definition (as for custom actions).

Options

On Error Skip Remaining Devices

Defines the execution behavior of the script when it is executed for all the devices in the selected span.

  • If selected, stop execution of script on other devices in the span, if it fails for any of the devices in the span.
  • If not selected, continue execution of script on other devices in the span, even if it fails for one or more devices in the span.
Was this page helpful? Yes No Submitting... Thank you

Comments