- description (EEM)
- description (NetFlow record)
- description (NetFlow monitor)
- description (NetFlow exporter)
- description (NetFlow sampler)
- description (SPAN)
- destination
- destination interface (SPAN)
- destination-profile
- destination-profile alert-group
- destination-profile email-addr
- destination-profile format
- destination-profile http
- destination-profile message-level
- destination-profile message-size
- destination-profile transport-method
- diagnostic bootup level
- diagnostic clear result module
- diagnostic eem action conservative
- diagnostic monitor interval module
- diagnostic monitor module
- diagnostic ondemand action-on-failure
- diagnostic ondemand iteration
- diagnostic s tart
- diagnostic stop
- diagnostic test simulation
- diagnostic test simulation clear
- distribute
- dscp
D Commands
This chapter describes the Cisco NX-OS system management commands that begin with the letter D.
description (EEM)
To add a description to an Embedded Event Manager (EEM) applet, use the description command. To remove the description, use the no form of this command.
Syntax Description
Defaults
Command Modes
Command History
|
|
Usage Guidelines
Examples
This example shows how to add a description to an EEM applet:
Related Commands
|
|
---|---|
description (NetFlow record)
To add a description to a NetFlow record, use the description command. To remove the description, use the no form of this command.
Syntax Description
Description string. The string can have a maximum of 63 alphanumeric characters. |
Defaults
Command Modes
NetFlow record configuration (config-flow-record)
Command History
|
|
Usage Guidelines
Examples
This example shows how to add a description to a NetFlow record:
switch(
config)#
flow record NetFlow-Record-1
switch(
config-flow-record)#
description Custom-Flow-Record-1
switch(
config-flow-record)#
This example shows how to remove the description:
switch(config
-flow-record)#
no description
Related Commands
|
|
---|---|
description (NetFlow monitor)
To add a description to a NetFlow monitor, use the description command. To remove the description, use the no form of this command.
Syntax Description
Description string. The string can have a maximum of 63 alphanumeric characters. |
Defaults
Command Modes
NetFlow monitor configuration (config-flow-monitor)
Command History
|
|
Usage Guidelines
Examples
This example shows how to add a description to a NetFlow monitor:
switch(config)#
flow monitor NetFlow-Monitor-1
switch(config-flow-monitor)#
description Custom-Monitor-1
switch(config-flow-monitor)#
This example shows how to remove the description:
switch(config-flow-monitor)#
no description
Related Commands
|
|
---|---|
description (NetFlow exporter)
To add a description to a NetFlow exporter, use the description command. To remove the description, use the no form of this command.
Syntax Description
Description string. The string can have a maximum of 63 alphanumeric characters. |
Defaults
Command Modes
NetFlow exporter configuration (config-flow-exporter)
Command History
|
|
Usage Guidelines
Examples
This example shows how to add a description to a NetFlow exporter:
switch(
config)#
flow export Netflow-Exporter-1
This example shows how to remove the description:
switch(
config-flow-exporter)#
no description
switch(
config-flow-exporter)
Related Commands
|
|
---|---|
description (NetFlow sampler)
To add a description to a NetFlow sampler, use the description command. To remove the description, use the no form of this command.
Syntax Description
Description string. The string can have a maximum of 63 alphanumeric characters. |
Defaults
Command Modes
NetFlow sampler configuration (config-flow-sampler)
Command History
|
|
Usage Guidelines
Examples
This example shows how to add a description to a NetFlow sampler:
switch(
config)#
sampler Netflow-Sampler-1
switch(config-flow-sampler)#
description Custom-Sampler-1
switch(config-flow-sampler)#
This example shows how to remove the description:
switch(
config-flow-sampler)#
no description
Related Commands
|
|
---|---|
description (SPAN)
To add a description to an Ethernet Switched Port Analyzer (SPAN) session for analyzing traffic between ports, use the description command. To remove the description, use the no form of this command.
Syntax Description
Comment or a description of up to 32 characters that is added to a SPAN session. |
Defaults
Command Modes
Monitor configuration (config-monitor)
Command History
|
|
Usage Guidelines
Examples
This example shows how to add a description to a SPAN session:
Related Commands
|
|
---|---|
Places you into the Monitor configuration mode for configuring a SPAN session. |
|
Displays the specified SPAN or ERSPAN session configuration. |
destination
To specify the destination for a NetFlow exporter, use the destination command. To remove a destination, use the no form of this command.
destination { ipaddr | ipv6addr } [ use-vrf vrf_name ]
no destination [{ ipaddr | ipv6addr } [ use-vrf vrf_name ]
Syntax Description
(Optional) Specifies the Virtual Routing and Forwarding (VRF) label. |
Defaults
Command Modes
NetFlow exporter configuration (config-flow-exporter)
Command History
|
|
Usage Guidelines
Examples
This example shows how to specify the destination for a NetFlow exporter:
switch(config)#
Flow exporter NetFlow-Exporter-1
switch(config-flow-exporter)#
destination 192.168.11.2
switch(config-flow-exporter)#
This example shows how to remove the destination:
switch(config-flow-exporter)#
no destination
Related Commands
|
|
---|---|
destination interface (SPAN)
To add a destination interface to an Ethernet Switched Port Analyzer (SPAN) session for analyzing traffic between ports, use the destination interface command. To remove the destination, use the no form of this command.
destination interface { ethernet number | port-channel number }
no destination interface { ethernet number | port-channel number }
Syntax Description
Defaults
Command Modes
Monitor configuration (config-monitor)
Command History
|
|
Usage Guidelines
Examples
This example shows how to add a destination to a SPAN session:
Related Commands
destination-profile
To create and name a destination profile for Call home, use the destination-profile command. To remove a destination profile, use the no form of this command.
destination-profile profile_name
no destination-profile profile_name
Syntax Description
Defaults
Command Modes
Call home configuration (config-callhome)
Command History
|
|
Usage Guidelines
Cisco NX-OS includes the following predefined destination profiles:
- CiscoTAC-1—Supports the Cisco-TAC alert group in XML message format. This profile is preconfigured with the callhome@cisco.com e-mail contact, maximum message size, and message severity level 0. You cannot change any of the default information for this profile.
- full-text-destination—Supports the full text message format.
- short-text-destination—Supports the short text message format.
Examples
This example shows how to create the Call home destination profile named Noc101:
switch(
config)#
callhome
switch(
config-callhome)#
destination-profile Noc101
This example shows how to remove the Call home Noc101 destination profile:
switch(
config)#
callhome
switch(
config-callhome)#
no destination-profile Noc101
Related Commands
|
|
---|---|
destination-profile alert-group
To specify which alerts a Call home destination will receive, use the destination-profile alert-group command. To remove an alert group, use the no form of this command.
destination-profile profile_name alert-group { All | Configuration | Diagnostic | EEM | Cisco-TAC | Environmental | Inventory | License | Linecard-Hardware | Supervisor-Hardware | Syslog-group-port | System | Test }
no destination-profile profile_name alert-group { All | Configuration | Diagnostic | EEM | Cisco-TAC | Environmental | Inventory | License | Linecard-Hardware | Supervisor-Hardware | Syslog-group-port | System | Test }
Syntax Description
Defaults
Command Modes
Call home configuration (config-callhome)
Command History
|
|
Usage Guidelines
Examples
This example shows how to specify that the destination profile receives all Call home messages:
Related Commands
|
|
---|---|
destination-profile email-addr
To specify an e-mail address for a Call home destination, use the destination-profile email-addr command. To remove an e-mail address, use the no form of this command.
destination-profile profile-name email-addr email-address
no destination-profile profile-name email-addr email-address
Syntax Description
Name you have given the Call home destination profile where the e-mail address is to be added. |
|
Specifies the e-mail address to be added to the Call home destination profile. |
Defaults
Command Modes
Call home configuration (config-callhome)
Command History
|
|
Usage Guidelines
Examples
This example shows how to specify an e-mail address for a Call home destination:
Related Commands
|
|
---|---|
destination-profile format
To specify a message format for sending messages to a Call home destination, use the destination-profile format command.
destination-profile profile_name format { full-txt | short-txt | XML }
Syntax Description
Defaults
Command Modes
Call home configuration (config-callhome)
Command History
|
|
Usage Guidelines
Examples
This example shows how to configure a message format for sending messages to a Call home destination:
switch(config-callhome)#
destination-profile acme_destination format full-txt
Related Commands
|
|
---|---|
destination-profile http
To specify an HTTP or HTTPS URL for a Call home destination, use the destination-profile http command. To remove a URL, use the no form of this command.
destination-profile profile-name http url
no destination-profile profile-name http url
Syntax Description
Specifies the HTTP or HTTPS URL to be added to the Call home destination profile. |
Defaults
Command Modes
Call home configuration (config-callhome)
Command History
|
|
Usage Guidelines
Examples
This example shows how to configure a URL for a Call home destination:
switch(config-callhome)#
destination-profile acme_destination http http://my_url,com/callhome
Related Commands
|
|
---|---|
destination-profile message-level
To specify a severity level for alerts that are sent to the Call home destination, use the destination-profile message-level command.
destination-profile profile_name message-level number
Syntax Description
Defaults
Command Modes
Call home configuration (config-callhome)
Command History
|
|
Usage Guidelines
Examples
This example shows how to specify that messages with a severity level 5 or higher are sent to a Call home destination:
switch(config-callhome)#
destination-profile acme_destination message-level 5
Related Commands
|
|
---|---|
destination-profile message-size
To specify a maximum allowable size for messages that are sent to a Call home destination, use the destination-profile message-size command.
destination-profile profile_name message-size number
Syntax Description
Defaults
Command Modes
Call home configuration (config-callhome)
Command History
|
|
Usage Guidelines
Examples
This example shows how to configure a maximum message size of 100000 for messages sent to a Call home destination:
Related Commands
|
|
---|---|
destination-profile transport-method
To specify a method of transporting Call home messages to a destination, use the destination-profile transport-method command. To remove the transport method, use the no form of this command.
destination-profile profile-name transport-method [ email | http ]
no destination-profile profile-name transport-method [ email | http ]
Syntax Description
Defaults
Command Modes
Call home configuration (config-callhome)
Command History
|
|
Usage Guidelines
Examples
This example shows how to specify HTTP for transporting Call home messages to a destination:
Related Commands
|
|
---|---|
diagnostic bootup level
To configure the diagnostic bootup level to trigger diagnostics when the device boots, use the diagnostic bootup level command.
diagnostic bootup level { bypass | complete }
Syntax Description
Defaults
Command Modes
network-admin
network-operator
vdc-admin
vdc-operator
Command History
|
|
Usage Guidelines
Examples
This example shows how to configure the diagnostic bootup level:
Related Commands
|
|
---|---|
diagnostic clear result module
To clear the diagnostic test result for the specified test, use the diagnostic clear result module command.
diagnostic clear result module [ slot | all ] test { test-id | all }
Syntax Description
(Optional) Specifies to clear the a diagnostic test for a specific module number. The range is from 1 to 10. |
|
(Optional) Displays the test result for all tests on all modules. |
|
Defaults
Command Modes
network-admin
network-operator
vdc-admin
vdc-operator
Command History
|
|
Usage Guidelines
Examples
This example shows how to clear a diagnostic test result:
Related Commands
|
|
---|---|
diagnostic eem action conservative
To configure the device to take corrective action when it detects failures on the PortLoopback test, the RewriteEngineLoopback test, the SnakeLoopback test, or the StandbyFabricLoopback test, use the diagnostic eem action conservative command.
diagnostic eem action conservative
Syntax Description
Defaults
Command Modes
network-admin
network-operator
vdc-admin
vdc-operator
Command History
|
|
Usage Guidelines
Examples
This example shows how to direct the switch to take corrective action:
Related Commands
diagnostic monitor interval module
To configure a diagnostic monitoring test interval on a module, use the diagnostic monitor interval module command. To remove the diagnostic monitoring test interval, use the no form of this command.
diagnostic monitor interval module module test { all | name | test-id } hour hour min min second sec
no diagnostic monitor interval module module test { all | name | test-id }
Syntax Description
Defaults
Command Modes
Global configuration mode (config)
Command History
|
|
Usage Guidelines
Examples
This example shows how to configure a diagnostic monitoring test interval on a module:
This example shows how to remove a diagnostic monitoring test interval from a module:
switch(
config)#
no diagnostic monitor interval module 1 test 5 hour 10 min 30 sec 0
switch(config)#
Related Commands
|
|
---|---|
diagnostic monitor module
To configure a diagnostic monitor test, use the diagnostic monitor module command. To remove a diagnostic monitor test, use the no form of this command.
diagnostic monitor module module test { all | name | test-id }
no diagnostic monitor module module test { all | name | test-id }
Syntax Description
Defaults
Command Modes
Global configuration mode (config)
Command History
|
|
Usage Guidelines
Examples
This example shows how to configure a diagnostic monitor test:
This example shows how to remove a diagnostic monitor test:
switch(
config)#
no diagnostic monitor module 1 test all
switch(
config)#
Related Commands
|
|
---|---|
diagnostic ondemand action-on-failure
To configure the action to take if the on-demand test fails, use the diagnostic ondemand action-on-failure command.
diagnostic ondemand action-on-failure { continue failure-count num-fails | stop }
Syntax Description
Displays the on-demand test until the test failure limit is reached. The range is from 1 to 999. The default is 1. |
|
Defaults
Command Modes
network-admin
network-operator
vdc-admin
vdc-operator
Command History
|
|
Usage Guidelines
Examples
This example shows how to configure the action if the on-demand test fails:
Related Commands
|
|
---|---|
diagnostic ondemand iteration
To configure the number of times that the on-demand test runs, use the diagnostic ondemand iteration command.
diagnostic ondemand iteration number
Syntax Description
(Optional) Number of times that the on-demand test runs. The range is from 1 to 999. The default is 1. |
Defaults
Command Modes
network-admin
network-operator
vdc-admin
vdc-operator
Command History
|
|
Usage Guidelines
Examples
This example shows how to configure the number of times that the on-demand test runs:
Related Commands
|
|
---|---|
diagnostic start
To start the on-demand diagnostic test for a module, use the diagnostic start command.
diagnostic start module slot test [test-id | test-name | all | non-disruptive] [port port-number | all]
Syntax Description
(Optional) Diagnostic start slot number. The range is from 1 to 10. |
|
(Optional) Test name. The name can be any case-sensitive, alphanumeric string up to 32 characters. |
|
Defaults
Command Modes
network-admin
network-operator
vdc-admin
vdc-operator
Command History
|
|
Usage Guidelines
Examples
This example shows how to start the on-demand diagnostic test for a module:
Related Commands
|
|
---|---|
diagnostic stop
To stop one or more diagnostic tests for a module, use the diagnostic stop command.
diagnostic stop module slot test [test-id | name | all]
Syntax Description
(Optional) Test name. The name can be any case-sensitive, alphanumeric string up to 32 characters. |
|
(Optional) Displays the diagnostic test for all tests on all modules. |
Defaults
Command Modes
network-admin
network-operator
vdc-admin
vdc-operator
Command History
|
|
Usage Guidelines
Examples
This example shows how to stop one or more diagnostic tests on a module:
Related Commands
|
|
---|---|
diagnostic test simulation
To simulate a diagnostic test for a module, use the diagnostic test simulation command
diagnostic test simulation module slot test test-id [ port {number | all }] { fail | random-fail | success }
Syntax Description
Diagnostic test simulation module number. The range is from 1 to the number of modules in the chassis. |
|
Defaults
Command Modes
network-admin
network-operator
vdc-admin
vdc-operator
Command History
|
|
Usage Guidelines
Examples
This example shows how to simulate a test result:
Related Commands
|
|
---|---|
diagnostic test simulation clear
To clear a diagnostic test simulation for a module, use the diagnostic test simulation clear command
diagnostic test simulation module number test test-id clear
Syntax Description
Specifies the diagnostic test simulation module number. The range is from 1 to the number of modules in the chassis. |
|
Defaults
Command Modes
network-admin
network-operator
vdc-admin
vdc-operator
Command History
|
|
Usage Guidelines
Examples
This example shows how to clear the diagnostic test simulation:
Related Commands
|
|
---|---|
distribute
To enable Cisco Fabric Service (CFS) to distribute configurations, use the distribute command. To disable distribution, use the no form of this command.
distribute [radius | tacacs+ ]
Syntax Description
(Optional) Specifies CFS to distribute RADIUS configurations. |
|
(Optional) Specifies CFS to distribute TACACS+ configurations. |
Defaults
Command Modes
Call home configuration mode
Global configuration mode
Command History
|
|
Usage Guidelines
This command does not require a license.
To enable CFS to distribute role configurations, see the role distribute command.
Examples
This example shows how to enable CFS to distribute Call home configurations:
switch(
config)#
callhome
This example shows how to enable CFS to distribute RADIUS configurations:
switch(
config)#
distribute radius
This example shows how to enable CFS to distribute TACACS+ configurations:
switch(
config)#
distribute
tacacs+
Related Commands
|
|
---|---|
Creates a CFS distribution region that limits the distribution scope of an application. |
dscp
To specify the differentiated services code point (DSCP) for a NetFlow exporter, use the dscp command. To remove the DSCP parameter, use the no form of this command.
Syntax Description
Differentiated services code point value. The range is from 0 to 63. |
Defaults
Command Modes
NetFlow exporter configuration (config-flow-exporter)
Command History
|
|
Usage Guidelines
Examples
This example shows how to configure the DSCP parameter:
This example shows how to remove the DSCP parameter:
switch(config-flow-exporter)#
no dscp
switch(config-flow-exporter)
Related Commands
|
|
---|---|