D Commands


This chapter describes the system management commands that begin with D.

diagnostic bootup level

To configure the bootup diagnostic level to trigger diagnostics when the device boots, use the diagnostic bootup level command. To remove bootup diagnostic level configuration, use the no form of this command.

diagnostic bootup level {bypass | complete}

no diagnostic bootup level {bypass | complete}

Syntax Description

bypass

Specifies that all bootup tests are skipped.

complete

Specifies that all bootup diagnostics are performed. This is the default value.


Command Default

Complete

Command Modes

Global configuration mode

Command History

Release
Modification

5.2(1)N1(1)

This command was introduced.


Examples

This example shows how to configure the bootup diagnostics level to trigger the complete diagnostics:

switch(config)# diagnostic bootup level complete 
switch(config)# 
 
   

This example shows how to remove the bootup diagnostics level configuration:

switch(config)# no diagnostic bootup level complete 
switch(config)# 
 
   

Related Commands

Command
Description

show diagnostic bootup level

Displays the bootup diagnostics level.

show diagnostic bootup result

Displays the results of the diagnostics tests.


description (SPAN, ERSPAN)

To add a description to an Ethernet Switched Port Analyzer (SPAN) or an Encapsulated Remote Switched Port Analyzer (ERSPAN) session configuration, use the description command. To remove the description, use the no form of this command.

description description

no description

Syntax Description

description

String description of the SPAN session configuration. This string is limited to 80 characters.


Command Default

No description is added.

Command Modes

SPAN session configuration mode
ERSPAN session configuration mode

Command History

Release
Modification

5.2(1)N1(1)

This command was introduced.


Usage Guidelines

Use the description command to provide a reminder in the configuration to describe what certain SPAN sessions are used for. The description appears in the output of the following commands such as show monitor session and show running-config monitor.

Examples

This example shows how to add a description for a SPAN session:

switch# configure terminal
switch(config)# monitor session 9 type local
switch(config-monitor)# description A Local SPAN session
switch(config-monitor)#
 
   

This example shows how to add a description for an ERSPAN session:

switch# configure terminal
switch(config)# monitor session 9 type erspan-source
switch(config-erspan-src)# description An ERSPAN session
switch(config-erspan-src)#
 
   

Related Commands

Command
Description

destination (SPAN session)

Configures a destination SPAN port.

monitor session

Creates a new SPAN session configuration.

show monitor session

Displays SPAN session configuration information.

show running-config monitor

Displays the running configuration information of a SPAN session.

source (SPAN session)

Configures a source SPAN port.


destination (ERSPAN)

To configure an Encapsulated Remote Switched Port Analyzer (ERSPAN) destination IP address, use the destination command. To remove the destination ERSPAN IP address, use the no form of this command.

destination ip ip_address

no destination ip ip_address

Syntax Description

ip

Configures the remote IP address.

ip_address

IPv4 address in the format A.B.C.D.


Command Default

None

Command Modes

ERSPAN session configuration mode

Command History

Release
Modification

5.2(1)N1(1)

This command was introduced.


Usage Guidelines

You can configure only one destination IP address for an ERSPAN source session.

This command does not require a license.

Examples

This example shows how to configure an ERSPAN destination IP address:

switch# configure terminal
switch(config)# monitor session 1 type erspan-source
switch(config-erspan-src)# destination ip 192.0.3.1
switch(config-erspan-src)#
 
   

Related Commands

Command
Description

monitor session

Creates a new SPAN session configuration.

show monitor session

Displays SPAN session configuration information.

show running-config monitor

Displays the running configuration information of a SPAN session.

source (SPAN session)

Configures a source SPAN port.

source (ERSPAN session)

Configures a source VLAN or VSAN interface.


destination (SPAN session)

To configure a Switched Port Analyzer (SPAN) destination port, use the destination command. To remove the destination SPAN port, use the no form of this command.

destination interface {ethernet slot/[QSFP-module/]port}

no source interface {ethernet slot/[QSFP-module/]port}

Syntax Description

interface

Specifies the interface type to use as the destination SPAN port.

ethernet slot/[QSFP-module/]port

Specifies the Ethernet interface to use as the destination SPAN port. The slot number is from 1 to 255. The QSFP-module number is from 1 to 4. The port number is from 1 to 128.

Note The QSFP-module number applies only to the QSFP+ Generic Expansion Module (GEM).


Command Default

None

Command Modes

SPAN session configuration mode

Command History

Release
Modification

6.0(2)N1(2)

Support for the QSFP+ GEM was added.

5.2(1)N1(1)

This command was introduced.


Usage Guidelines

Each local SPAN session destination session must have a destination port (also called a monitoring port) that receives a copy of traffic from the source port.

The destination port can be any Ethernet physical port and must reside on the same switch as the source port (for a local SPAN session). The destination port cannot be a source port, a port channel, or SAN port channel group.

A destination port receives copies of sent and received traffic for all monitored source ports. If a destination port is oversubscribed, it can become congested. This congestion can affect traffic forwarding on one or more of the source ports.

Examples

This example shows how to configure an Ethernet interface SPAN destination port and activate the SPAN session:

switch# configure terminal
switch(config)# interface ethernet 1/5
switch(config-if)# switchport monitor
switch(config-if)# exit 
switch(config)# monitor session 9 type local
switch(config-monitor)# description A Local SPAN session
switch(config-monitor)# source interface ethernet 1/1
switch(config-monitor)# destination interface ethernet 1/5
switch(config-monitor)# no shutdown
switch(config-monitor)# 
 
   

Related Commands

Command
Description

source (SPAN session)

Configures a source SPAN port.

monitor session

Creates a new SPAN session configuration.

show monitor session

Displays SPAN session configuration information.

show running-config monitor

Displays the running configuration information of a SPAN session.