Documentation forNetwork Configuration Manager

Execute a script on a node

This widget is available to users with the WebUploader, Engineer, or Administrator role.

The script you execute must be saved as a text file that can be uploaded from the client computer. For more information about creating command scripts, see Create an executable command script in NCM.

  1. Click My Dashboards > Network Configuration > Configuration Management.

    If you do not have administrator privileges you may not be able to see some nodes. Your account must at least have the WebDownloader role to download configs, and the WebUploader role to execute a script against nodes.

  2. Select one or more nodes.
  3. Click Execute Script.
  4. Select a script to execute or click Load Script from File, and locate it in the file system.

    You can specify a delay in seconds inside a script. A delay is the time NCM waits before sending the next command. The following is a sample script that includes a delay:

    {Command 1}
    ${Delay:20}
    {Command 2}

    This feature is useful, for example, when uploading a flash image. Some time is required for the formatting of the flash to complete before then performing the image upload.

  5. If you entered or updated the script and you want to save it to a file, select Save script and enter a file name.
  6. If you want NCM to put the device into configuration mode before executing the script, select Execute Script in Config Mode.

    For example, on Cisco devices when this option is selected, NCM sends the config t command to the device before executing the script on the device. On some devices, configuration mode is required to make changes on the device.

  7. Click Execute.

View the results

  1. Click My Dashboards > Network Configuration > Configuration Management.
  2. Click Transfer Status.
  3. In the Action column, locate the most recent entry labeled Execute Script.
  4. Click Show Script Results in the Status/Details column.

Troubleshoot script execution

If a script fails to execute on aNCM node, review the log for a possible cause. The log is located at C:\ProgramData\SolarWinds\NCM\Logging\NCMBusinessLayerPlugin.log.

Alternatively, execute the script by using Create and manage NCM jobs.