NCM Configlets

NCM Configlets

Network Configuration Management

NCM Configlets

Create reusable configuration command sets and push them to one or many network devices in a single operation. Supports immediate execution and scheduled deployment, with a full execution history for every push.

Overview

NCM Configlets allow network administrators to define a set of configuration commands once and execute them across any number of devices without logging into each one individually. This is the right tool when you need to enforce a consistent configuration change at scale, such as updating NTP server addresses across all routers, pushing a revised ACL to every firewall, or enabling SNMPv3 on a group of switches.

Configlets are managed under Network → NCM → NCM Configlets. Each configlet can be executed immediately from the Configlet Table or scheduled to run on a recurring interval. All runs are logged in the Execution History tab with per-device output, giving you a complete audit trail of every configuration push. Before executing configlets, ensure SSH or Telnet credentials are configured for the target devices. Refer to Network Configuration Management for credential setup.

Creating a Configlet

Navigate to Network → NCM → NCM Configlets and click Add. Fill in the fields as follows:

FieldDescription
NameA descriptive name for the configlet, such as "Update NTP Servers" or "Enable SNMPv3 on Cisco Switches".
DescriptionAn optional description explaining what the configlet does and which devices it targets.
VendorThe device vendor this configlet is written for. Configlets are vendor-specific because command syntax differs between manufacturers such as Cisco IOS, Juniper JunOS, and Aruba. A configlet written for Cisco IOS will not work correctly on an Aruba device.
ExecutionChoose Basic for straightforward command sequences, or Advanced for configlets requiring conditional logic or variable substitution.
CommandThe configuration command or commands to push to the device. Click the + button to add multiple commands. For example, to replace an NTP server on a Cisco device: ntp server 10.0.0.1 followed by no ntp server 10.0.0.2.

Click Save. The configlet appears in the Configlet Table and is ready for execution or scheduling.

Executing a Configlet

To execute a configlet immediately, click the execute icon in the Actions column of the Configlet Table. Cloudmon pushes the commands to the target devices using the NCM protocol and credentials configured for each device. Check the Execution History tab for results, showing per-device status, whether each command was accepted, and the full session output. This is the first place to look if a configlet runs but the configuration change does not appear to have applied.

Scheduling a Configlet

To run a configlet on a recurring basis, click the schedule icon in the Actions column and fill in the scheduling fields:

FieldDescription
Schedule NameA name to identify this scheduled task in the Scheduled Tasks tab.
VendorThe device vendor for this scheduled execution.
ConfigletThe configlet to execute, selected from the dropdown of saved configlets.
IntervalHow often the configlet runs. Options are Daily, Weekly, and Monthly.
Schedule TimeThe time of day the scheduled run will execute.

Click Save. All scheduled tasks are visible under the Scheduled Tasks tab where they can be viewed, edited, or deleted.

Troubleshooting

IssueWhat to check
Execution fails on all target devicesCheck the Execution History tab for the session error. Authentication failures indicate the credential does not have sufficient privilege to enter configuration mode. Confirm the Enable Password is set for devices requiring privilege mode access.
Execution reports success but configuration did not applyVerify the command syntax is correct for the selected vendor. A Cisco IOS command may not be valid on Cisco IOS XE or NX-OS. Review the session output in Execution History to confirm each command was accepted without error by the device.
Execution fails on some devices but not othersFailing devices may be running a different firmware version or feature set. Check the per-device output in Execution History and create a separate configlet with adjusted syntax for devices with different command requirements.
Scheduled configlet not running at the expected timeVerify the task exists in the Scheduled Tasks tab and the interval and schedule time are set correctly. Confirm the Cloudmon controller's system time and timezone are correct, as scheduled tasks run based on the controller's local time.