Itential Tools Actions

The Itential Tools Package contains tools necessary for Itential Platform to interact with NSO. You can download the package from the Itential Software Repository.

Below are the actions provided by itential_tools, along with examples and information on how to test actions.

How to Test

All actions can be tested by utilizing the runAction task in Adapter NSO of workflows.

1. Go to Workflows in Automation Studio.
2. Create a new workflow and add the runAction task from NSO/NSOManager to the workflow canvas.
3. Input the parameters according to the action running.

Examples

Several examples of the actions in itential_tools are shown below. Sample input values are used to illustrate the reference variable you would enter for each Incoming Variable on the task dialog.

admin_down_device

Variable: params

{
    "params": {
        "device": "ios.1"
    },
    "path": "/itential_commands/admin_down_device"
}

admin_down_interfaces

Variable: params

{
    "params": {
        "device": "ios.0",
        "interfaces": "[\"GigabitEthernet{0}\",\"\"Ethernet{0/0/0}\"]"
    },
    "path": "/itential_commands/admin_down_interfaces"
}

admin_up_interfaces

Variable: params

{
    "params": {
        "device": "ios.0",
        "interfaces": "[\"GigabitEthernet{0}\"]"
    },
    "path": "/itential_commands/admin_up_interfaces"
}

getNamespaces

Variable: params

{
    "params": {
        "deviceName": "ios.0",
        "prefixes": "ncs"
    },
    "path": "/itential_commands/getNamespaces"
}

get_config

Variable: params

{
    "params": {
        "device": "ios.0",
        "format": "NATIVE"
    },
    "path": "/itential_commands/get_config"
}

load_config

Variable: params

{
    "params": {
        "device": "ios.0",
        "action": "MERGE",
        "config": "<config xmlns=\"http://tail-f.com/ns/config/1.0\"><devices xmlns=\"http://tail-f.com/ns/ncs\"><device><name>ios.0</name><config><tailfned xmlns=\"urn:ios\"><police>cirmode</police></tailfned><ip xmlns=\"urn:ios\"><source-route>true</source-route><gratuitous-arps-conf><gratuitous-arps>true</gratuitous-arps></gratuitous-arps-conf><http><server>true</server><secure-server>true</secure-server></http></ip></config></device></devices></config>"
    },
    "path": "/itential_commands/load_config"
}

native2Pronghorn

Variable: params

{
    "params": {
        "ned_id": "cisco-ios-cli-6.72",
        "commands": "hostname test"
    },
    "path": "/itential_commands/native2Pronghorn"
}

set_config

Variable: params

{
    "params": {
        "device": "ios.0",
        "config": "hostname test",
        "deviceType": "cisco-ios-cli-6.72",
        "dryRun": "cli"
    },
    "path": "/itential_commands/set_config"
}

set_config_transactions

Variable: params

{   "params": {
        "device": "ios.0",
        "deviceType": "cisco-ios-cli-6.72",
        "transactions": {
            "id": 1,
            "new": "hostname test",
            "old": "",
            "parents": ""
        }
    },
    "path": "/itential_commands/set_config_transactions"
}

stage_device

Variable: params

{
    "params": {
        "device_name": "ios.1",
        "ned_id": "cisco-ios-cli-6.72",
        "commands": "hostname test"
    },
    "path": "/itential_commands/stage_device"
}

translate_config

Variable: params

{
    "params": {
        "ned_id": "cisco-ios-cli-6.72",
        "commands": "hostname test",
        "strategy": "access_list"
    },
    "path": "/itential_commands/translate_config"
}

verify_config

Variable: params

{
    "params": {
        "ned_id": "cisco-ios-cli-6.72",
        "commands": "hostname test"
    },
    "path": "/itential_commands/verify_config"
}