Specifications
B-59
Cisco MWR 2941 Mobile Wireless Edge Router Software Configuration Guide, Release 12.2(33)MRB
OL-21227-02
Appendix B Cisco MWR 2941 Router Command Reference
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 is 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 is applied to the router, but none of the
configuration beyond the error is applied. If an error occurs, the command retries until the configuration
successfully completes. In the pull mode, the command does not retry after an error. By default,
NVRAM is updated except when the no-persist keyword is configured.
A message is published on the CNS event bus after the partial configuration is complete. The CNS event
bus displays 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 connects 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">
<SOAP:Header>
12.4(20)MR This command was integrated into Cisco IOS Release 12.4(20)MR.
12.2(33)MRA This command was integrated into Cisco IOS Release 12.2(33)MRA.
Release Modification