Submit a ticketCall us

Have You Auto Renewed? If not, you're missing out.
The SolarWinds Renewal Program comes with a host of benefits including the most recent product updates, 24/7 technical support, virtual instructor-led training and more. Experience all of this with the convenience of Auto Renewal, and never worry about missing any of these great benefits. Learn More.

Home > Success Center > Network Configuration Manager (NCM) > Downloading Context from devices as of NCM 7.4.x

Downloading Context from devices as of NCM 7.4.x

Table of contents

Updated: September 21, 2016

Overview

In previous versions of NCM, although it was possible to download multiple contexts in NCM, the startup config was usually sacrificed because of the switches and where the config type was identified. In NCM Version 7.4.x, a new process has been developed.

Environment

  • NCM version 7.4.x and later

Steps

 

In NCM 7.4.x, new template command was introduced, allowing logic to get context as well as the startup config.

This is an example of the template that would enable NCM to get the Running (admin context) Config, Startup Config, and the System Context Config

<!--SolarWinds Network Management Tools-->

<!--Copyright 2007 SolarWinds.Net All rights reserved-->

<!--Modified by bc 9/16/2016-->

<Configuration-Management Device="Cisco ASA Context" SystemOID=" 1.3.6.1.4.1.9.1.669.1.1">

                <Commands>

                  <Command Name="Reset" Value="terminal pager 0"/>

                   <Command Name="system" Value="changeto context system${CRLF}show run"/>

                 <Command Name="Startup" Value="show start"/>

                   <Command Name="Running" Value="show run"/>

                   <Command Name="DownloadConfig" Value="${ConfigType}" RegEx="#"/>

                 <Command Name="UseMultipleDownloadCommands" Value="True"/>

                   <Command Name="Reboot" Value="reload noconfirm"/>

                   <Command Name="EnterConfigMode" Value="config terminal"/>

                   <Command Name="ExitConfigMode" Value="end"/>

                   <Command Name="EraseConfig" Value="write erase${CRLF}Yes"/>

                   <Command Name="SaveConfig" Value="write memory"/>

                   <Command Name="Version" Value="show version"/>

                </Commands>

</Configuration-Management>

 

The process to set up NCM:

1. Go to NCM Settings > Configs. 

2. Add a new Config Type for each context.

3. Create the Config Type in the Device Template as well as the command needed to download the config as listed above.

The key commands in this Template making is different:

<Command Name="Reset" Value="terminal pager 0"/>

<Command Name="UseMultipleDownloadCommands" Value="True"/>

<Command Name="DownloadConfig" Value="${ConfigType}" RegEx="#"/>

<Command Name="system" Value="changeto context system${CRLF}show run"/>

<Command Name="Startup" Value="show start"/>

<Command Name="Running" Value="show run"/>

 

 

NCM logic when downloading the system context:

Log in to the device as one has set up in NCM Device settings. Provided the settings are correct, NCM upon logging in will be at the Enable Prompt.

NCM will recognize the Enable Prompt and logic is flagged as ok to issue a command.

The First command NCM will try to issue at this point, is the command identified in the “Reset” Command Line.  This is designed to enter a command to turn off paging to prevent blank lines in the config (terminal pager 0/terminal length 0 …)

Once this command is issued, the device returns back the prompt, and NCM is ready to process the next command if any.

In this example, a user has selected to download the system config type for the Web Console.

NCM is set up to use SSH to request and transfer the configs.

NCM will then use the line and use the defined Value: <Command Name="DownloadConfig" Value="${ConfigType}" RegEx="#"/>

  • ${ConfigType} (system was selected as the configtype by the user) is defined in the Command line: <Command Name="system" Value="changeto context system${CRLF}show run"/>
  • Since the prompt is going to change based on the context for these, we have to tell NCM to only consider the # when looking for the Prompt at this point as opposed to the original prompt and this is the Reason for the RegEx="#"
  • End result of the command is “changeto context system [ENTER] show run”

 

Same process will be done for the running , startup or any other context created and identified in the device template.

 

This logic or process can also be modified to be used for other devices that have sub configs in a text format such as Nexus and ACE devices.

 

 

 

Last modified

Tags

Classifications

Public