Table Of Contents
Configuring the XML Server
Configuring the Number of Allowed Sessions
Configuring the Session Timeout Period
Terminating a Server Session
Default Settings
Additional References
Standards
RFCs
Configuring the XML Server
This chapter describes how to configure the XML server and includes the following sections:
•
Configuring the Number of Allowed Sessions
•
Configuring the Session Timeout Period
•
Terminating a Server Session
•
Default Settings
•
Additional References
Configuring the Number of Allowed Sessions
Use this procedure to configure the maximum number of simultaneous sessions allowed on the XML server.
BEFORE YOU BEGIN
Before beginning this procedure, you must know or do the following:
•
You are logged in to the CLI in EXEC mode.
•
You can allow between 1 and 8 maximum sessions simultaneously on the XML server. The default is 8.
SUMMARY STEPS
1.
(Optional) show xml server status
2.
config t
3.
xml server max-session sessions
4.
(Optional) show xml server status
5.
(Optional) copy running-config startup-config
DETAILED STEPS
| |
Command
|
Purpose
|
Step 1
|
show xml server status
Example:
switch# show xml server status
operational status is enabled
maximum session configured is 8
|
(Optional) Displays information about XML server settings and any active XML server sessions.
|
Step 2
|
config t
Example:
switch# config t
switch(config)#
|
Places you in the CLI Global Configuration mode.
|
Step 3
|
xml server max-session sessions
Example:
switch(config)# xml server max-session 6
|
Sets the number of allowed XML server sessions. The default is 8. The range is from 1 to 8.
|
Step 4
|
show xml server status
Example:
switch(config)# show xml server status
|
(Optional) Displays information about the XML server settings and active XML server sessions.
|
Step 5
|
copy running-config startup-config
Example:
switch(config)# copy running-config
startup-config
[###############################] 100%
n1000v(config)#
|
(Optional) Saves the running configuration persistently through reboots and restarts by copying it to the startup configuration.
|
Configuring the Session Timeout Period
Use this procedure to configure the inactive session timeout period on the XML server.
BEFORE YOU BEGIN
Before beginning this procedure, you must know or do the following:
•
You are logged in to the CLI in EXEC mode.
•
You can set the inactive session timeout period anywhere between 0 and 1200 seconds.
SUMMARY STEPS
1.
config t
2.
xml server timeout seconds
3.
(Optional) copy running-config startup-config
DETAILED STEPS
| |
Command
|
Purpose
|
Step 1
|
config t
Example:
switch# config t
switch(config)#
|
Places you in the CLI Global Configuration mode.
|
Step 2
|
xml server timeout seconds
Example:
switch(config)# xml server timeout 1200
switch(config)#
|
Sets the number of seconds after which an inactive XML server session is terminated. The allowable range is from 0 to 1200 seconds.
|
Step 3
|
copy running-config startup-config
Example:
switch(config)# copy running-config
startup-config
[###############################] 100%
n1000v(config)#
|
(Optional) Saves the running configuration persistently through reboots and restarts by copying it to the startup configuration.
|
Terminating a Server Session
Use this procedure to terminate an active XML server session.
BEFORE YOU BEGIN
Before beginning this procedure, you must know or do the following:
•
You are logged in to the CLI in EXEC mode.
SUMMARY STEPS
1.
(Optional) show xml server status
2.
xml server terminate session
3.
(Optional) show xml server status
DETAILED STEPS
| |
Command
|
Purpose
|
Step 1
|
show xml server status
Example:
switch(config)# show xml server status
operational status is enabled
maximum session configured is 8
switch(config)#
|
(Optional) Displays information about the XML server settings and active XML server sessions.
|
Step 2
|
xml server terminate session
Example:
switch(config)# xml server terminate 8665
switch(config)#
|
Terminates the specified XML server session.
|
Step 3
|
show xml server status
Example:
switch(config)# show xml server status
|
(Optional) Displays information about the XML server settings and active XML server sessions. Verify that the session was terminated.
|
Default Settings
Table 2-1 lists the default settings for the XML API.
Table 2-1 XML API Defaults
Parameters
|
Default
|
Maximum allowed XML server sessions
|
8
|
Active XML server timeout period
|
1200 seconds
|
Additional References
For additional information related to implementing the XML management interface, see the following sections:
•
Standards
•
RFCs
Standards
Standards
|
Title
|
No new or modified standards are supported by this feature, and support for existing standards has not been modified by this feature.
|
—
|
RFCs
RFCs
|
Title
|
RFC 4741
|
NETCONF Configuration Protocol
|
RFC 4742
|
Using the NETCONF Configuration Protocol over Secure SHell (SSH)
|