NCM Template

NCM Template

Network Configuration Management

NCM Template

This article covers how NCM templates control the way Cloudmon logs into a device and pulls its configuration. Use it to understand Global vs. Custom templates, and to build or edit a Custom template correctly the first time.

Overview

NCM templates define how Cloudmon connects to, authenticates with, and issues backup or upload commands to network devices. Each template describes a device's login sequence, connection protocol, and the exact commands used to retrieve or push configuration files.

Templates fall into two categories: Global templates maintained by Cloudmon, and Custom templates maintained by your organisation.

Tip: A common approach is to clone a Global template and customise it, rather than building a Custom one from scratch.

Global vs. Custom Templates

TypeDescription
GlobalPre-built templates shipped with Cloudmon, covering hundreds of vendors and device models such as 3Com, Adtran, Alaxala, and Alcatel. Read-only reference templates maintained by Cloudmon.
CustomTemplates your team creates with Add NCM Template. They live in a separate Custom list and can be freely edited, cloned, or deleted. Use one when no Global template exists, or when you need to adjust commands, prompts, or timeouts.

Creating a New Custom Template

Step 1: Navigate to NCM Templates

Go to Network → NCM → Templates. Check both the Global and Custom lists for an existing template before creating a new one, to avoid duplicate work.

Step 2: Click Add Template

Click Add. This opens the Add NCM Template panel.

Step 3: Enter Basic Information

FieldDescription
NameThe internal, unique identifier for the template.
Display NameA friendly name shown in the templates list. 
DescriptionA short summary of the template's purpose.
VendorThe device manufacturer. Can also be set to All for vendor-agnostic templates, common for OS-level templates.

Step 4: Configure SysObjectID Matches 

Expand this section to automatically bind the template to devices reporting a matching SNMP SysObjectID.

  • Enter the OID.
  • Click the + icon to add multiple OIDs if the template should cover several device models.
  • Devices matching this OID are automatically assigned this template during discovery, removing the need for manual selection.

Step 5: Configure Advanced Login Settings (Optional)

Expand Advanced Login Settings to customise how Cloudmon logs into a device before running any backup or upload commands. Once any field in this section is completed, the section is marked "configured" in the template list.

FieldDescription
Enable CommandThe command sent to escalate to privileged (enable) mode, for example enable. Used for devices with a separate privileged mode.
Pre-login PromptThe prompt string Cloudmon expects to see before sending login credentials.
Pre-login CommandA command sent before the login sequence begins. Leave empty to send a line feed only.
Post-login PromptThe prompt string expected after a successful login, for example continue, confirming the session is ready for commands.
Post-login CommandA command sent immediately after login completes. Leave empty to send a line feed only.
Line FeedThe line-ending character sent with commands. Default is line feed. Change it if the device expects carriage return or CRLF.

When to use this: Configure Advanced Login Settings when a device has a non-standard login banner, requires an extra keystroke to reach a command prompt, or needs a specific enable sequence before configuration commands will work.

Step 6: Define Protocols / Command Set

This is the core of the template. It controls how Cloudmon connects to the device and what commands it runs.

ProtocolDescription
SSH / TELNETStandard interactive command execution.
SSH / TELNET — TFTPUses TFTP for configuration file transfer.
SSH — SCPUses SCP for secure file transfer.

Each protocol tab can be removed individually with the delete icon if not needed. Use + Add protocol at the bottom of the form to attach additional connection methods to the same template.

  • Exclude Criteria: Define conditions under which this template should not apply (for example specific firmware versions or model subtypes), to prevent incorrect auto-matching.
  • View Source: Opens a raw code view of the full command set, for advanced editing or copying between templates.

Step 7: Add a Section (Command Block)

Click + Add section to insert a command block. Available section types typically include:

  • Backup › Running Configuration
  • Backup › Startup Configuration
  • Upload › Running Configuration
  • Upload › Startup Configuration

Each section represents one operation, for example pulling the running configuration versus pushing a configuration file to the device.

FieldDescription
CommandThe CLI command to run.
PromptThe prompt pattern Cloudmon waits for after sending the command, for example ${prompt}.
Timeout (ms)How long to wait for a response before timing out, for example 20000.
LineFeedThe line-ending sent with this specific command, for example line feed \n.
Prompt ActionThe action to take when the prompt is matched. Default is (none).
Read From ResponseToggle that captures the command's output as the configuration data to store, rather than executing it silently.

Multiple sections can be added to a single protocol tab, for example both a Backup and an Upload section. Use the trash icon to delete a section.

Step 8: Save the Template

Review all fields for accuracy, then click Save to create the template, or Reset to clear the form and start over.

Best Practices

  • Check the Global list first. Many common vendors and models already have a ready-made template.
  • Clone a similar Global or Custom template instead of building from scratch when possible.
  • Always populate SysObjectID Matches where possible, to enable automatic template assignment during discovery.
  • Use View Source to copy command sets between similar templates quickly.
  • Enable Read From Response only on sections meant to capture configuration data, such as Backup sections, not on upload or push commands.
  • Keep the Description field detailed when multiple team members manage templates, to avoid duplicate or conflicting Custom templates.

Troubleshooting

SymptomLikely CauseFix
Template will not saveMissing required field (Name or Vendor)Confirm both fields are populated.
Device not auto-matching templateSysObjectID missing or incorrectVerify the OID under the device's SNMP details and re-enter it under SysObjectID Matches.
Login fails before commands runLogin prompts do not match device outputConfigure Advanced Login Settings (Pre/Post-login Prompt and Command) to match the device's actual banner or prompt text.
Commands fail or time outPrompt pattern or timeout set too lowIncrease Timeout (ms) and verify the Prompt field matches the device's actual CLI prompt.
Backup captures blank or incorrect dataRead From Response not enabledEnable Read From Response on the relevant section.
Wrong template applied to a deviceOverlapping SysObjectID or missing Exclude CriteriaAdd Exclude Criteria to narrow the match scope.