Cisco Cisco IOS Software Release 12.2(25)S
CNS Agents
cns config retrieve
33
Cisco IOS Release 12.2(25)S
cns config retrieve
To request the configuration of a routing device, use the cns config retrieve command in EXEC mode.
cns config retrieve {host-name | ip-address} [encrypt] [port-number] [page page]
[overwrite-startup] [syntax-check] [no-persist] [source ip-address] [event] [inventory]
Syntax Description
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.
Default web page of the initial configuration is /cns/config.asp.
Command Modes
EXEC
Command History
host-name
Host name of the configuration server.
ip-address
IP address of the configuration server.
encrypt
(Optional) Uses a Secure Socket Layer (SSL) encrypted link to the event
gateway.
gateway.
Note
This keyword is available only in images that support SSL.
port-number
(Optional) Port number of the configuration service. The value is from 0 to
65535. The default is 80 with no encryption and 443 with encryption.
65535. The default is 80 with no encryption and 443 with encryption.
page page
(Optional) Web page where the configuration is located. The default is
/cns/config.asp.
/cns/config.asp.
overwrite-startup
(Optional) Replaces the startup configuration file. Does not apply to the
running configuration file.
running configuration file.
syntax-check
(Optional) Turns on syntax checking.
no-persist
(Optional) Suppresses the default automatic writing to NVRAM of the
configuration pulled as a result of issuing the cns config retrieve command.
If not present, issuing the cns config retrieve command causes the resultant
configuration to be automatically written to NVRAM.
configuration pulled as a result of issuing the cns config retrieve command.
If not present, issuing the cns config retrieve command causes the resultant
configuration to be automatically written to NVRAM.
source ip-address
(Optional) IP address to use as the source of CNS communications.
event
(Optional) Sends an event to the CNS event bus stating successful
completion of the configuration, a warning that the configuration contained
errors, or a message noting that the configuration failed. If the CNS event
agent is not configured, the event will be saved until the CNS event agent is
enabled. If the event keyword is not specified, a log message is sent to the
console of the device after the configuration is complete.
completion of the configuration, a warning that the configuration contained
errors, or a message noting that the configuration failed. If the CNS event
agent is not configured, the event will be saved until the CNS event agent is
enabled. If the event keyword is not specified, a log message is sent to the
console of the device after the configuration is complete.
inventory
(Optional) Sends an inventory of the line cards and modules in the router to
the CNS configuration engine as part of the HTTP request.
the CNS configuration engine as part of the HTTP request.
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.