Downloads |
Table Of Contents
Supported Standards, MIBs, and RFCs
CNS Configuration Agent
Feature History
This feature module describes the CNS Configuration Agent feature. It includes the following sections:
•
Supported Standards, MIBs, and RFCs
Feature Overview
Cisco Networking Services (CNS) is a foundation technology for linking users to network services. CNS Software Developers Kit (SDK) accomplishes this linking by making applications network-aware and increasing the intelligence of the network elements. CNS SDK provides building blocks to a range of customers in market segments such as enterprise, service provider, independent software vendors, and system integrators.
The CNS Configuration Agent feature supports routing devices by providing the following:
•
•
•
Initial Configuration
When a routing device first comes up, it connects to the configuration server component of CNS Configuration Agent by establishing a TCP connection through the use of cns config initial, a standard command-line interface (CLI) command. The device issues a request and identifies itself by providing a unique configuration ID to the configuration server.
When the CNS web server receives a request for a configuration file, it invokes the Java Servlet and executes the corresponding embedded code. The embedded code directs the CNS web server to access the directory server and file system to read the configuration reference for this device (configuration ID) and template. The Configuration Agent prepares an instantiated configuration file by substituting all the parameter values specified in the template with valid values for this device. The configuration server forwards the configuration file to the CNS web server for transmission to the routing device.
The CNS Configuration Agent feature accepts the configuration file from the CNS web server, performs XML parsing, checks syntax (optional), and loads the configuration file. The routing device reports the status of the configuration load as an event to which a network monitoring or workflow application can subscribe.
Incremental Configuration
Once the network is up and running, new services can be added using the CNS Configuration Agent. Incremental (partial) configurations can be sent to routing devices. The actual configuration can be sent as an event payload by way of the Event Gateway (push operation) or as a signal event that triggers the device to initiate a pull operation.
The routing device can check the syntax of the configuration before applying it. If the syntax is correct, the routing device applies the incremental configuration and publishes an event that signals success to the configuration server. If the device fails to apply the incremental configuration, it publishes an event that indicates an error status.
Once the routing device has applied the incremental configuration, it can write it to NVRAM, or wait until signaled to do so.
Synchronized Configuration
When a routing device receives a configuration, it has the option to defer application of the configuration upon receipt of a write-signal event. The CNS Configuration Agent feature allows the device configuration to be synchronized with other dependent network activities.
Benefits
•
•
•
•
Related Documents
•
http://www.cisco.com/univercd/cc/td/doc/product/software/ios122/122newft/122t/122t2/ftcns_ea.htm
•
http://www.cisco.com/warp/public/cc/pd/nemnsw/nesv/prodlit/cns12_ds.htm
•
http://www.cisco.com/warp/customer/cc/pd/nemnsw/nesv/prodlit/index.shtml
Supported Platforms
12.2(2)T and later
The CNS Configuration Agent feature is supported on the following platforms:
•
•
•
•
•
•
•
•
•
•
•
•
12.0(18)ST
The CNS Configuration Agent feature is supported on all platforms using 12.0(18)ST or later, including:
•
•
•
•
•
12.0(22)S
The CNS Configuration Agent feature is supported on all platforms using 12.0(22)S or later, including:
•
•
•
•
•
Supported Standards, MIBs, and RFCs
Standards
None
MIBs
None
For descriptions of supported MIBs and how to use MIBs, see the Cisco MIB web site on CCO at http://www.cisco.com/public/sw-center/netmgmt/cmtk/mibs.shtml.
RFCs
None
Configuration Tasks
To configure the CNS Configuration Agent on your routing device, use any of the following commands as needed:
Command Reference
This section documents new commands. All other commands used with this feature are documented in the Cisco IOS Release 12.2 command reference publications.
•
•
•
•
•
•
•
cns config cancel
To remove a partial CNS configuration from the list of outstanding partial configurations, use the cns config cancel command in EXEC mode.
cns config cancel queue-id
Syntax Description
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Usage Guidelines
Use this command to remove a configuration specified by the queue-id variable.
Related Commands
cns config initial
To start CNS Configuration Agent and initiate an initial configuration, use the cns config initial command in global configuration mode. To remove the existing cns config initial command from the running configuration of the routing device, use the no version of this command.
cns config initial {ip-address | hostname} [port-number] [page page] [event] [syntax-check] [no-persist]
no cns config initial {ip-address | hostname} [port-number] [page page] [event] [syntax-check] [no-persist]
Syntax Description
Defaults
Default port number is 80. Default web page of the initial configuration is /Config/config.asp.
Command Modes
Global configuration
Command History
Usage Guidelines
Use this command to start the CNS Configuration Agent and initiate an initial configuration. The Configuration Agent gets the initial configuration for the routing device from the specified server. When this command is used with the event argument, one of the following status messages will be displayed by the event bus:
•
•
•
Related Commands
cns config partial
To start the CNS Configuration Agent and initiate a partial configuration, use the cns config partial command in global configuration mode. To shut down the partial Configuration Agent, use the no version of this command.
cns config partial {ipaddress | hostname} [port-number]
no cns config partial {ipaddress | hostname} [port-number]
Syntax Description
ip-address
IP address of the configuration server.
hostname
Host name of the configuration server.
port-number
(Optional) Port number of the configuration server. The default port number is 80.
Defaults
Default port number is 80.
Command Modes
Global configuration
Command History
Usage Guidelines
Use this command to start the CNS Configuration Agent and initiate an partial configuration. One of the following status messages will be displayed by the event bus:
•
•
•
Related Commands
cns config retrieve
To get the configuration of a routing device—if the partial CNS Configuration Agent is started and configured in the routing device—use the cns config retrieve command in EXEC mode.
cns config retrieve [page page] [no-syntax-check] [no-persist]
Syntax Description
Defaults
Default web page of the initial configuration is /Config/config.asp.
Command Modes
EXEC
Command History
Usage Guidelines
Use this command to get the configuration of a routing device using CNS.
Related Commands
debug cns config
To turn on debug messages related to the CNS Configuration Agent, use the debug cns config command in EXEC mode. To turn off debug messages related to the Configuration Agent, use the no version of this command.
debug cns config {all | connection | agent | syntax}
no debug cns config {all | connection | agent | syntax}
Syntax Description
all
Displays all debug messages.
connection
Displays connection handler messages.
agent
Displays Configuration Agent messages.
syntax
Displays syntax messages.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Usage Guidelines
Use this command to turn on or turn off debug messages related to the Configuration Agent.
Related Commands
debug cns xml-parser
To turn on debug messages related to the XML parser, use the debug cns xml-parser command in EXEC mode. To turn off debug messages related to the XML parser, use the no version of this command.
debug cns xml-parser
no debug cns xml-parser
Syntax Description
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Usage Guidelines
Use this command to turn on or turn off debug messages related to the XML parser.
Related Commands
cns event
Configures the Event Gateway.
show cns event
Displays information about the Event Agent.
show cns config
To show information about the CNS Configuration Agent, use the show cns config command in EXEC mode.
show cns config {status | outstanding | stats}
Syntax Description
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Usage Guidelines
Use this command to display information about the Configuration Agent.
Related Commands