Specifications

B-62
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 retrieve
Command Modes Privileged EXEC (#)
Command History
Usage Guidelines Use this command to request the configuration of a device from a configuration server. Use the cns
trusted-server command to specify which configuration server can be used (trusted).
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 does not retry.
A single message is published on the event bus after the partial configuration is complete. The event bus
displays one of the following status messages:
• cisco.mgmt.cns.config.complete—CNS configuration agent successfully applied the configuration.
• cisco.mgmt.cns.config.warning—CNS configuration agent fully applied the configuration, but
encountered possible semantic errors.
• cisco.mgmt.cns.config.failure—CNS configuration agent encountered an error and was not able to
apply the configuration.
The cns config retrieve command can be used with Command Scheduler commands (for example, kron
policy-list and cli commands) in environments where it is not practical to use the CNS event agent and
the cns config partial command. Configured within the cli command, the cns config retrieve command
can be used to poll the configuration server to detect configuration changes.
You can use the optional retry and interval keywords to specify an amount of time in seconds to wait
before attempting to retrieve a configuration from a trusted server. The number of retries is restricted to
100 to prevent the configuration agent from indefinitely attempting to reach an unreachable server. Use
the keyboard combination Ctrl-Shift-6 to abort this command.
Examples The following example shows how to request a configuration from a trusted server at 10.1.1.1:
Router(config)# cns trusted-server all 10.1.1.1
Router(config)# exit
Release Modification
12.2(2)T This command was introduced.
12.0(18)ST This command was integrated into Cisco IOS Release 12.0(18)ST.
12.0(22)S This command was integrated into Cisco IOS Release 12.0(22)S.
12.3(1) The inventory keyword was added.
12.2(25)S This command was integrated into Cisco IOS Release 12.2(25)S.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.4(15)T The retry retries and interval seconds keywords and arguments were
added.
12.2(33)SRC This command was integrated into Cisco IOS Release 12.2(33)SRC.
12.2(33)SB This command was integrated into Cisco IOS Release 12.2(33)SB.
12.2(33)SXI This command was integrated into Cisco IOS Release 12.2(33)SXI.
12.4(20)MR This command was incorporated.
12.2(33)MRA This command was integrated into Cisco IOS Release 12.2(33)MRA.