Cisco MWR 2941 Command Reference Manual page 90

cns config retrieve
Defaults
The port number defaults to 80 with no encryption and 443 with encryption.
Default web page of the initial configuration is /cns/config.asp.
Command Modes
Privileged EXEC (#)
Command History Release
12.2(2)T
12.0(18)ST
12.0(22)S
12.3(1)
12.2(25)S
12.2(33)SRA
12.4(15)T
12.2(33)SRC
12.2(33)SB
12.2(33)SXI
12.4(20)MR
12.2(33)MRA
15.0(1)MR
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 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 not retry.
A single message will be published on the event bus after the partial configuration is complete. The event
bus will display one of the following status messages:
•
•
•
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.
Cisco MWR 2941 Router Command Reference, Release 15.0(1)MR
72
Modification
This command was introduced.
This command was integrated into Cisco IOS Release 12.0(18)ST.
This command was integrated into Cisco IOS Release 12.0(22)S.
The inventory keyword was added.
This command was integrated into Cisco IOS Release 12.2(25)S.
This command was integrated into Cisco IOS Release 12.2(33)SRA.
The retry retries and interval seconds keywords and arguments were
added.
This command was integrated into Cisco IOS Release 12.2(33)SRC.
This command was integrated into Cisco IOS Release 12.2(33)SB.
This command was integrated into Cisco IOS Release 12.2(33)SXI.
This command was incorporated.
This command was integrated into Cisco IOS Release 12.2(33)MRA.
This command was integrated into Cisco IOS Release 15.0(1)MR.
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.
Cisco MWR 2941 Router Command Reference, Release 15.0(1)MR
OL-23890-01