X Commands
This chapter describes the Cisco NX-OS system management commands that begin with the letter X.
xml server max-session
To configure the number of allowed XML server sessions, use the xml server max-session command. To reset the number to the default, use the no form of this command.
xml server max-session max-sessions
no xml server max-session max-sessions
Syntax Description
Maximum number of allowed XML server sessions. The range is from 1 to 8. The default is 8. |
Defaults
Command Modes
Global configuration mode (config)
Command History
|
|
Usage Guidelines
Examples
This example shows how to configure the number of allowed XML server sessions:
switch(
config)#
xml server max-session 4
This example shows how to reset the number of allowed XML server sessions to the default:
switch(
config)#
no xml server max-session 4
Related Commands
|
|
---|---|
xml server terminate session
To terminate an XML server session, use the xml server terminate session command.
xml server terminate session session_id
Syntax Description
Defaults
Command Modes
network-admin
network-operator
vdc-admin
vdc-operator
Command History
|
|
Usage Guidelines
Examples
This example shows how to terminate an XML server session:
switch(
config)#
xml server terminate session 3
Related Commands
|
|
---|---|
xml server timeout
To configure the XML server session timeout, use the xml server timeout command. To reset the timeout to the default, use the no form of this command.
xml server timeout timeout [ session_id ]
no xml server timeout timeout [ session_id ]
Syntax Description
Timeout in seconds. The range is from 0 to 1200. The default is 1200. |
|
(Optional) XML server session number. The range is from 0 to 2147483647. |
Defaults
Command Modes
Global configuration mode (config)
Command History
|
|
Usage Guidelines
You can apply the XML server timeout only to active sessions.
Examples
This example shows how to configure the XML server timeout for active sessions:
switch(
config)#
xml server timeout 800
This example shows how to reset the timeout to the default:
switch(
config)#
no xml server timeout 800
xml server validate
To validate XML documents, use the xml server validate command. To disable XML document validation, use the no form of this command.
xml server validate { all | session_id }
no xml server validate { all | session_id }
Syntax Description
Defaults
Command Modes
network-admin
network-operator
vdc-admin
vdc-operator
Command History
|
|
Usage Guidelines
Examples
This example shows how to validate XML documents for all active sessions:
switch(
config)#
xml server validate all
This example shows how to disable validation of XML documents for all sessions:
switch(
config)#
no xml server validate all
xmlin
To install the XMLIN tool on the device and generate equivalent Network Configuration (NETCONF) formats of all CLI commands entered in this mode, use the xmlin command.
Syntax Description
Defaults
Command Modes
network-admin
network-operator
vdc-admin
vdc-operator
Command History
|
|
Usage Guidelines
The XMLIN tool converts CLI commands to the NETCONF protocol format. NETCONF is a network management protocol that provides mechanisms to install, manipulate, and delete the configuration of network devices. It uses XML-based encoding for configuration data and protocol messages. The Cisco NX-OS implementation of the NETCONF protocol supports the following protocol operations: <get>, <edit-config>, <close-session>, <kill-session>, and <exec-command>.
The XMLIN tool converts show, EXEC, and configuration commands to corresponding NETCONF <get>, <exec-command>, and <edit-config> requests. You can enter multiple configuration commands into a single NETCONF <edit-config> instance.
Note the following restrictions:
- In NETCONF, <edit-config> requests cannot consist of any show commands.
- In each <get-config> instance, only one show command is allowed.
Note Although the XMLIN tool is usually capable of generating NETCONF instances of commands even if the corresponding feature sets or the required hardware capabilities are not available on the device, you might have to install some feature sets before entering the xmlin command.
The XMLIN tool also converts the output of show commands to XML format by using the show-command | xmlin command.
Ensure the XMLIN tool is installed before you use the show-command | xmlin command.
Note XMLIN requires no license. Any feature not included in a license package is bundled with the Cisco NX-OS system images and is provided at no extra charge to you. For a complete explanation of the Cisco NX-OS licensing scheme, see the Cisco NX-OS Licensing Guide.
Examples
This example shows how the XMLIN tool is installed on the device and used to convert a set of configuration commands to an <edit-config> instance:
This example shows how to convert the output of the show interface brief command to XML: