-62
Cisco MWR 2941 Mobile Wireless Edge Router Release 3.5 Command Reference, Cisco IOS Release 15.1(3)MR
OL-26895-01
Chapter Cisco MWR 2941 Router Command Reference, Release 15.1(3)MR
cns config partial
Usage Guidelines Use this command to start the CNS partial configuration agent. You must enable the CNS event agent
using the cns event command before configuring this command. The CNS event agent sends an event
with the subject “cisco.mgmt.cns.config.load” to specify whether configuration data can be pushed to
the CNS partial configuration agent or pulled from a configuration server by the CNS partial
configuration agent.
In the push model, the event message delivers the configuration data to the partial configuration agent.
In the pull model, the event message triggers the partial configuration agent to pull the configuration data
from the CNS configuration engine. The event message contains information about the CNS
configuration engine, not the actual configuration data. The host name or IP address is the address of the
CNS configuration engine from which the configuration is pulled. Use the cns trusted-server command
to specify which CNS configuration engines can be used by the CNS partial configuration agent.
When the configuration has been received by the router, each line of the configuration will be applied in
the same order as it was received. If the Cisco IOS parser has an error with one of the lines of the
configuration, then all the configuration up to this point will be applied to the router, but none of the
configuration beyond the error will be applied. If an error occurs, the command will retry until the
configuration successfully completes. In the pull mode, the command will not retry after an error. By
default, NVRAM will be updated except when the no-persist keyword is configured.
A message will be published on the CNS event bus after the partial configuration is complete. The CNS
event bus will display one of the following status messages:
• cisco.mgmt.cns.config.complete—CNS configuration agent successfully applied the partial
configuration.
• cisco.mgmt.cns.config.warning—CNS configuration agent fully applied the partial configuration, but
encountered possible semantic errors.
• cisco.mgmt.cns.config.failure(CLI syntax)—CNS configuration agent encountered a command line
interface (CLI) syntax error and was not able to apply the partial configuration.
• cisco.mgmt.cns.config.failure(CLI semantic)—CNS configuration agent encountered a CLI
semantic error and was not able to apply the partial configuration.
Examples The following example shows how to configure the CNS partial configuration agent to accept events
from the event gateway at 172.28.129.22. The CNS partial configuration agent will connect to the CNS
configuration server at 172.28.129.22, port number 80. The CNS partial configuration agent requests are
redirected to a configuration server at 172.28.129.40, port number 80.
Router(config)# cns event 172.28.129.22
Router(config)# cns trusted-server config 172.28.129.40
Router(config)# cns config partial 172.28.129.22
The following example shows an enhanced error message sent to the subject
“cisco.mgmt.cns.config.results”:
[2005-09-08 14:30:44]: subject=cisco.mgmt.cns.config.results.dvlpr-7200-6, message=
<?xml version="1.0" encoding="UTF-8"?>
<SOAP:Envelope xmlns:SOAP="http://www.w3.org/2003/05/soap-envelope">
12.2(33)MRA This command was integrated into Cisco IOS Release 12.2(33)MRA.
15.0(1)MR This command was integrated into Cisco IOS Release 15.0(1)MR.
15.1(3)MR This command was integrated into Cisco IOS Release 15.1(3)MR.
Release Modification
Comments to this Manuals