Cisco Nexus 5000 Series Command Reference
System Management Commands
Downloads: This chapterpdf (PDF - 321.0KB) The complete bookPDF (PDF - 3.84MB) | Feedback

System Management Commands

Table Of Contents

System Management Commands

abort (session)

clear logging logfile

clear logging nvram

clear logging onboard

clear logging session

clear ntp session

clear ntp statistics

commit (session)

diagnostic bootup level

ip access-list (session)

ip port access-group (session)

logging abort

logging commit

logging console

logging distribute

logging event

logging event port

logging level

logging logfile

logging module

logging monitor

logging server

logging timestamp

ntp

ntp abort

ntp commit

ntp distribute

ntp sync-retry

show diagnostic bootup level

show diagnostic result

show logging console

show logging info

show logging last

show logging level

show logging logfile

show logging module

show logging monitor

show logging nvram

show logging onboard

show logging pending

show logging pending-diff

show logging session status

show logging server

show logging status

show logging timestamp

show ntp peer-status

show ntp peers

show ntp statistics

show ntp timestamp-status

show snmp community

show snmp context

show snmp engineID

show snmp group

show snmp host

show snmp sessions

show snmp trap

snmp-server community

System Message Logging Facilities

verify (session)


System Management Commands


This chapter describes the system management commands available on Cisco Nexus 5000 Series switches.

abort (session)

To discard the current configuration session, use the abort command.

abort

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

Session configuration mode

Command History

Release
Modification

4.0(0)N1(1)

This command was introduced.


Examples

This example shows how to abort the current configuration session:

switch# configure session MySession1 
switch(config-s)# abort 
switch# 

Related Commands

Command
Description

commit

Commits a session.

configure session

Creates a configuration session.

show configuration session

Displays the contents of the session.

verify

Verifies a session.


clear logging logfile

To clears the contents of the log file, use the clear logging logfile command.

clear logging logfile

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1)

This command was introduced.


Examples

This example shows how to clear the logging logfile:

switch# clear logging logfile 
switch# 

Related Commands

Command
Description

show logging logfile

Displays the messages in the log file.


clear logging nvram

To clear the NVRAM logs, use the clear logging nvram command.

clear logging nvram

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


Examples

This example shows how to clear the NVRAM logs:

switch# clear logging nvram  

Related Commands

Command
Description

show logging nvram

Displays the NVRAM logs.


clear logging onboard

To clear the onboard failure logging (OBFL) entries in the persistent log, use the clear logging onboard command.

clear logging onboard [environmental-history] [exception-log] [obfl-log] [stack-trace]

Syntax Description

environmental-history

(Optional) Clears the OBFL environmental history.

exception-log

(Optional) Clears the OBFL exception log entries.

obfl-log

(Optional) Clears the OBFL (boot-uptime/device-version/obfl-history).

stack-trace

(Optional) Clears the OBFL stack trace entries.


Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


Examples

This example shows how to clear the OBFL environmental history entries:

switch# clear logging onboard environmental-history  

This example shows how to clear the OBFL exception-log entries:

switch# clear logging onboard exception-log  

This example shows how to clear the OBFL (boot-uptime/device-version/obfl-history) entries:

switch# clear logging onboard obfl-log  

This example shows how to clear the OBFL stack trace entries:

switch# clear logging onboard stack-trace  

Related Commands

Command
Description

show logging onboard

Displays onboard failure logs.


clear logging session

To clear the current logging session, use the clear logging session command.

clear logging session

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


Examples

This example shows how to clear the current logging session:

switch# clear logging session  

Related Commands

Command
Description

show logging session

Displays the logging session status.


clear ntp session

To clear the Network Time Protocol (NTP) session, use the clear ntp session command.

clear ntp session

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


Examples

This example shows how to discard the NTP Cisco Fabric Services (CFS) distribution session in progress:

switch# clear ntp session  

Related Commands

Command
Description

show ntp

Displays NTP information.


clear ntp statistics

To clear the Network Time Protocol (NTP) session, use the clear ntp session command.

clear ntp statistics {all-peers | io | local | memory}

Syntax Description

all-peers

Clears all peer transaction statistics.

io

Clears I/O statistics.

local

Clears local statistics.

memory

Clears memory statistics.


Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


Examples

This example shows how to discard the NTP I/O statistics:

switch# clear ntp statistics io  

Related Commands

Command
Description

show ntp

Displays NTP information.


commit (session)

To commit the current configuration session, use the commit command.

commit

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

Session configuration mode

Command History

Release
Modification

4.0(0)N1(1)

This command was introduced.


Examples

This example shows how to commit the current session:

switch(config-s)# commit 
switch(config-s)# 

Related Commands

Command
Description

configure session

Creates a configuration session.

show configuration session

Displays the contents of the session.

verify

Verifies a session.


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

4.0(0)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 level

Displays the results of the diagnostics tests.


ip access-list (session)

To create an IPv4 access control list (ACL) within a configuration session, use the ip access-list command. To remove an ACL from a configuration session, use the no form of this command.

ip access-list ACL-name

no ip access-list ACL-name

Syntax Description

ACL-name

Name of the IPv4 ACL. The name can be up to 64 alphanumeric characters and cannot contain a space or quotation mark.


Command Default

No IPv4 ACLs are defined by default.

Command Modes

Global session configuration mode

Command History

Release
Modification

4.0(0)N1(1)

This command was introduced.


Examples

This example shows how to create an IPv4 ACL for a configuration session:

switch# configure session MySession1 
switch(config-s)# ip access-list myACL 
switch(config-s-acl)# 

Related Commands

Command
Description

configure session

Creates a configuration session.

deny

Configures a deny rule in an IPv4 ACL.

interface

 

permit

Configures a permit rule in an IPv4 ACL.

show configuration session

Displays the contents of the session.


ip port access-group (session)

To apply an IPv4 access control list (ACL) to an interface as a port ACL, use the ip port access-group command. To remove an IPv4 ACL from an interface, use the no form of this command.

ip port access-group access-list-name {in | out}

no ip port access-group access-list-name {in | out}

Syntax Description

access-list-name

Name of the IPv4 ACL. The name can be up to 64 alphanumeric, case-sensitive characters long.

in

Specifies that the ACL applies to inbound traffic.

out

Specifies that the ACL applies to outbound traffic.


Command Default

None

Command Modes

Session interface configuration mode

Command History

Release
Modification

4.0(0)N1(1)

This command was introduced.


Examples

This example shows how to apply an IPv4 ACL named ip-acl-01 to the Ethernet interface 1/2 as a port ACL:

switch# configure session MySession1 
switch(config-s)# interface ethernet 1/2 
switch(config-s-if)# ip port access-group ip-acl-01 in 
switch(config-s-if)#

This example shows how to remove an IPv4 ACL named ip-acl-01 from Ethernet interface 1/2:

switch(config-s)# interface ethernet 1/2 
switch(config-s-if)# no ip port access-group ip-acl-01 in 
switch(config-s-if)#

Related Commands

Command
Description

show access-lists

Displays all ACLs.

show configuration session

Displays the contents of the session.


logging abort

To discard the pending changes to the syslog server configuration, use the logging abort command.

logging abort

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

Global configuration mode

Command History

Release
Modification

4.0(0)N1(1)

This command was introduced.


Examples

This example shows how to discard the changes made to the syslog server configuration:

switch(config)# logging distribute 
switch(config)# logging abort 
switch(config)# 

Related Commands

Command
Description

logging distribute

Enables the distribution of the syslog server configuration to network switches using the CFS infrastructure.

show logging pending

Displays the pending changes to the syslog server configuration.

show logging status

Displays the logging status.


logging commit

To commit the pending changes to the syslog server configuration for distribution to the switches in the fabric, use the logging commit command.

logging commit

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

Global configuration mode

Command History

Release
Modification

4.0(0)N1(1)

This command was introduced.


Examples

This example shows how to commit the distribution of the syslog server configuration:

switch(config)# logging distribute 
switch(config)# commit 
switch(config)# 

Related Commands

Command
Description

logging distribute

Enables the distribution of the syslog server configuration to network switches using the CFS infrastructure.

show logging status

Displays the logging status.


logging console

To enable logging messages to the console session, use the logging console command. To disable logging messages to the console session, use the no form of this command.

logging console [severity-level]

no logging console

Syntax Description

severity-level

(Optional) Number of the desired severity level at which messages should be logged. Messages at or numerically lower than the specified level are logged. Severity levels are as follows:

0—emergency: System unusable

1—alert: Immediate action needed

2—critical: Critical condition—default level

3—error: Error condition

4—warning: Warning condition

5—notification: Normal but significant condition

6—informational: Informational message only

7—debugging: Appears during debugging only


Command Default

None

Command Modes

Global configuration mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


Examples

This example shows how to enable logging messages with a severity level of 4 (warning) or higher to the console session:

switch# configure terminal  
switch(config)# logging console 4  

Related Commands

Command
Description

show logging console

Displays the console logging configuration.


logging distribute

To enable the distribution of the syslog server configuration to network switches using the Cisco Fabric Services (CFS) infrastructure, use the logging distribute command. To disable the distribution, use the no form of this command.

logging distribute

no logging distribute

Syntax Description

This command has no arguments or keywords.

Command Default

Distribution is disabled.

Command Modes

Global configuration mode

Command History

Release
Modification

4.0(0)N1(1)

This command was introduced.


Examples

This example shows how to enable the distribution of the syslog server configuration:

switch(config)# logging distribute 
switch(config)# 

This example shows how to disable the distribution of the syslog server configuration:

switch(config)# no logging distribute 
switch(config)# 

Related Commands

Command
Description

logging abort

Cancels the pending changes to the syslog server configuration.

logging commit

Commits the changes to the syslog server configuration for distribution to the switches in the fabric.

show logging status

Displays the logging status.


logging event

To log interface events, use the logging event command. To disable logging of interface events, use the no form of this command.

logging event port {link-status | trunk-status} {default | enable}

no logging event port {link-status | trunk-status} {default | enable}

Syntax Description

link-status

Specifies to log all UP/DOWN and CHANGE messages.

trunk-status

Specifies to log all TRUNK status messages.

default

Specifies to the default logging configuration is used by interfaces not explicitly configured.

enable

Enables the logging to override the port level configuration.


Command Default

None

Command Modes

Global configuration mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


Examples

This example shows how to log interface events:

switch# configure terminal  
switch(config)# logging event link-status default  

Related Commands

Command
Description

show logging

Displays the logging status.


logging event port

To log events on an interface, use the logging event port command. To disable logging of interface events, use the no form of this command.

logging event port {link-status | trunk-status} [default]

no logging event port {link-status | trunk-status}

Syntax Description

link-status

Specifies to log all UP/DOWN and CHANGE messages.

trunk-status

Specifies to log all TRUNK status messages.

default

(Optional) Specifies the default logging configuration that is used by interfaces not explicitly configured.


Command Default

None

Command Modes

Interface configuration mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


Examples

This example shows how to log interface events:

switch# configure terminal  
switch(config)# interface ethernet 1/1 
switch(config-if)# logging event port link-status default  

Related Commands

Command
Description

show interface

Displays the interface configuration information.

show logging

Displays the logging status.


logging level

To enable logging messages from a defined facility that have the specified severity level or higher, use the logging level command. To disable logging messages from a defined facility, use the no form of this command.

logging level facility severity-level

no logging level facility severity-level

Syntax Description

facility

Appropriate facility. The facilities are listed in the "System Message Logging Facilities" section.

To apply the same severity level to all facilities, use the all facility.

severity-level

Number of the desired severity level at which messages should be logged. Messages at or numerically lower than the specified level are logged. Severity levels are as follows:

0—emergency: System unusable

1—alert: Immediate action needed

2—critical: Critical condition—default level

3—error: Error condition

4—warning: Warning condition

5—notification: Normal but significant condition

6—informational: Informational message only

7—debugging: Appears during debugging only


Command Default

None

Command Modes

Global configuration mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


Examples

This example shows how to enable logging messages from the AAA facility that have a severity level of 2 or higher:

switch(config)# logging level aaa 2  

Related Commands

Command
Description

show logging level

Displays the facility logging level configuration.


logging logfile

To configure the name of the log file used to store system messages and the minimum severity level to log, use the logging logfile command. To disable logging to the log file, use the no form of this command.

logging logfile logfile-name severity-level [size bytes]

no logging logfile [logfile-name severity-level [size bytes]]]

Syntax Description

logfile-name

Name of the log file to be used to store system messages.

severity-level

Number of the desired severity level at which messages should be logged. Messages at or numerically lower than the specified level are logged. Severity levels are as follows:

0—emergency: System unusable

1—alert: Immediate action needed

2—critical: Critical condition—default level

3—error: Error condition

4—warning: Warning condition

5—notification: Normal but significant condition

6—informational: Informational message only

7—debugging: Appears during debugging only

size bytes

(Optional) Specifies a maximum file size. The default file size is 4194304 bytes and can be configured from 4096 to 4194304 bytes.


Command Default

None

Command Modes

Global configuration mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


Examples

This example shows how to configure a log file called logfile to store system messages and set its severity level to 4:

switch(config)# logging logfile logfile 4 

Related Commands

Command
Description

show logging logfile

Displays the log file.


logging module

To enable module log messages, use the logging module command. To disable module log messages, use the no form of this command.

logging module [severity-level]

no logging module

Syntax Description

severity-level

(Optional) Number of the desired severity level at which messages should be logged. Messages at or numerically lower than the specified level are logged. Severity levels are as follows:

0—emergency: System unusable

1—alert: Immediate action needed

2—critical: Critical condition

3—error: Error condition

4—warning: Warning condition

5—notification: Normal but significant condition—default level

6—informational: Informational message only

7—debugging: Appears during debugging only


Command Default

None

Command Modes

Global configuration mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


Usage Guidelines

Set a specified severity level or use the default.

Examples

This example shows how to enable module log messages:

switch(config)# logging module  

Related Commands

Command
Description

show logging module

Displays the module logging status.


logging monitor

To enable the device to log messages to the monitor (terminal line), use the logging monitor command. To disable monitor log messages, use the no form of this command.

logging monitor [severity-level]

no logging monitor

Syntax Description

severity-level

(Optional) Number of the desired severity level at which messages should be logged. Messages at or numerically lower than the specified level are logged. Severity levels are as follows:

0—emergency: System unusable

1—alert: Immediate action needed

2—critical: Critical condition—default level

3—error: Error condition

4—warning: Warning condition

5—notification: Normal but significant condition

6—informational: Informational message only

7—debugging: Appears during debugging only


Command Default

None

Command Modes

Global configuration mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


Usage Guidelines

This configuration applies to Telnet and Secure Shell (SSH) sessions.

Examples

This example shows how to enable monitor log messages:

switch(config)# logging monitor  

Related Commands

Command
Description

show logging monitor

Displays the status of monitor logging.


logging server

To configure a remote syslog server at the specified hostname or IPv4/IPv6 address, use the logging server command. To disable the remote syslog server, use the no form of this command.

logging server host [severity-level] [facility {auth | authpriv | cron | daemon | ftp | kernel | local0 | local1 | local2 | local3 | local4 | local5 | local6 | local7 | lpr | mail | news | syslog | user | uucp}| use-vrf {vrf_name | management}]

no logging server host [severity-level] [facility {auth | authpriv | cron | daemon | ftp | kernel | local0 | local1 | local2 | local3 | local4 | local5 | local6 | local7 | lpr | mail | news | syslog | user | uucp}| use-vrf {vrf_name | management}]

Syntax Description

host

Hostname or IPv4/IPv6 address of the remote syslog server.

severity-level

(Optional) Number of the desired severity level at which messages should be logged. Messages at or numerically lower than the specified level are logged. Severity levels are as follows:

0—emergency: System unusable

1—alert: Immediate action needed

2—critical: Critical condition—default level

3—error: Error condition

4—warning: Warning condition

5—notification: Normal but significant condition

6—informational: Informational message only

7—debugging: Appears during debugging only

facility facility

(Optional) Specifies the appropriate outgoing facility. The facilities are listed in the System Message Logging Facilities section.

The default outgoing facility is local7.

vrf vrf_name

(Optional) Specifies the virtual routing and forwarding (VRF) to be used in the remote server. The name can be a maximum of 32 alphanumeric characters.

management

Specifies the management VRF. This is the default VRF.


Command Default

The default outgoing facility is local7.

The default VRF is management.

Command Modes

Global configuration mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.

4.1(3)N2(1)

The use-vrf keyword was added.


Examples

This example shows how to configure a remote syslog server at a specified IPv4 address, using the default outgoing facility:

switch(config)# logging server 192.168.2.253  

This example shows how to configure a remote syslog server at a specified hostname with severity level 5 or higher:

switch(config)# logging server syslogA 5  

Related Commands

Command
Description

show logging server

Displays the configured syslog servers.


logging timestamp

To set the logging time-stamp units, use the logging timestamp command. To reset the logging time-stamp units to the default, use the no form of this command.

logging timestamp {microseconds | milliseconds | seconds}

no logging timestamp {microseconds | milliseconds | seconds}

Syntax Description

microseconds

Specifies the units to use for logging timestamps in microseconds. The default units are seconds.

milliseconds

Specifies the units to use for logging timestamps in milliseconds.

seconds

Specifies the units to use for logging timestamps in seconds. The default units are seconds.


Command Default

None

Command Modes

Global configuration mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


Usage Guidelines

By default, the units are seconds.

Examples

This example shows how to set the logging time-stamp units to microseconds:

switch(config)# logging timestamp microseconds  

Related Commands

Command
Description

show logging timestamp

Displays the logging time-stamp configuration.


ntp

To configure the Network Time Protocol (NTP) peers and servers for the switch, use the ntp command. To remove configured peers and servers, use the no form of this command.

ntp {peer hostname | server hostname} [prefer] [use-vrf vrf-name]

no ntp {peer hostname | server hostname}

Syntax Description

peer hostname

Specifies the hostname or IP address of an NTP peer.

server hostname

Specifies the hostname or IP address of the NTP server.

prefer

(Optional) Specifies this peer/server as the preferred peer/server.

use-vrf vrf-name

(Optional) Specifies the virtual routing and forwarding (VRF) used to reach this peer/server.


Command Default

None

Command Modes

Global configuration mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.

4.0(1a)N1(1)

The keyword use-vrf replaces the keyword vrf. The keyword vrf is retained for backwards compatibility.


Usage Guidelines

You can specify multiple peer associations.

Examples

This example shows how to form a server association with a server:

switch(config)# ntp server ntp.cisco.com  

This example shows how to form a peer association with a peer:

switch(config)# ntp peer 192.168.10.0  

This example shows how to delete an association with a peer:

switch(config)# no ntp peer 192.168.10.0  

Related Commands

Command
Description

ntp distribute

Enables CFS distribution for NTP.

show ntp

Displays NTP information.


ntp abort

To discard the Network Time Protocol (NTP) Cisco Fabric Services (CFS) distribution session in progress, use the ntp abort command.

ntp abort

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

Global configuration mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


Examples

This example shows how to discard the NTP CFS distribution session in progress:

switch(config)# ntp abort  

Related Commands

Command
Description

ntp distribute

Enables CFS distribution for NTP.

show ntp

Displays NTP information.


ntp commit

To apply the pending configuration pertaining to the Network Time Protocol (NTP) Cisco Fabric Services (CFS) distribution session in progress in the fabric, use the ntp commit command.

ntp commit

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

Global configuration mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


Examples

This example shows how to commit changes to the active NTP configuration:

switch(config)# ntp commit  

Related Commands

Command
Description

ntp distribute

Enables CFS distribution for NTP.

show ntp

Displays NTP information.


ntp distribute

To enable Cisco Fabric Services (CFS) distribution for Network Time Protocol (NTP), use the ntp distribute command. To disable this feature, use the no form of this command.

ntp distribute

no ntp distribute

Syntax Description

This command has no arguments or keywords.

Command Default

Disabled

Command Modes

Global configuration mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


Usage Guidelines

Before distributing the Fibre Channel timer changes to the fabric, the temporary changes to the configuration must be committed to the active configuration using the ntp commit command.

Examples

This example shows how to distribute the active NTP configuration to the fabric:

switch(config)# ntp distribute  

Related Commands

Command
Description

ntp commit

Commits the NTP configuration changes to the active configuration.

show ntp

Displays NTP information.


ntp sync-retry

To retry synchronization with the configured Network Time Protocol (NTP) servers, use the ntp sync-retry command.

ntp sync-retry

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


Examples

This example shows how to retry synchronization with the configured NTP servers:

switch# ntp sync-retry  

Related Commands

Command
Description

ntp distribute

Enables CFS distribution for NTP.

show ntp

Displays NTP information.


show diagnostic bootup level

To display the current bootup diagnostic level on the switch, use the show diagnostic bootup level command.

show diagnostic bootup level

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1)

This command was introduced.


Examples

This example shows how to display the current bootup diagnostic level:

switch# show diagnostic bootup level 

        Current bootup diagnostic level: complete

switch#

Related Commands

Command
Description

diagnostic bootup level

Configures the bootup diagnostic level for a faster module bootup time.

show diagnostic result

Displays the results of the diagnostics tests.


show diagnostic result

To display the results of the diagnostic tests, use the show diagnostic result command.

show diagnostic result module {module-no | all}

Syntax Description

module

Specifies the module for which diagnostic results are displayed.

module-no

Module number. Valid values are 1 to 3.

all

Displays the diagnostic results for all modules.


Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1)

This command was introduced.


Examples

This example shows how to display the diagnostic results for a specific module:

switch# show diagnostic result module 1 

Current bootup diagnostic level: complete

Module 1: 48X10GE/Supervisor  SerialNo : JAF1339ANGH

  Overall Diagnostic Result for Module 1 : PASS
  Diagnostic level at card bootup: complete

  Test results: (. = Pass, F = Fail, I = Incomplete,
                 U = Untested, A = Abort)

     1) TestUSBFlash ------------------------> .
     2) TestSPROM ---------------------------> .
     3) TestPCIe ----------------------------> .
     4) TestLED -----------------------------> .
     5) TestOBFL ----------------------------> .
     6) TestNVRAM ---------------------------> .
     7) TestPowerSupply ---------------------> F
     8) TestTemperatureSensor ---------------> .
     9) TestFan -----------------------------> .
    10) TestVoltage -------------------------> .
    11) TestGPIO ----------------------------> .
    12) TestInbandPort ----------------------> .
    13) TestManagementPort ------------------> .
    14) TestMemory --------------------------> .
    15) TestFabricEngine :

   Eth    1  2  3  4  5  6  7  8  9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24
   Port ------------------------------------------------------------------------
          .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .

   Eth   25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48
   Port ------------------------------------------------------------------------
          .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .


    16) TestFabricPort :

   Eth    1  2  3  4  5  6  7  8  9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24
   Port ------------------------------------------------------------------------
          .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .

   Eth   25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48
   Port ------------------------------------------------------------------------
          .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .


    17) TestForwardingEngine :

   Eth    1  2  3  4  5  6  7  8  9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24
   Port ------------------------------------------------------------------------
          .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .

   Eth   25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48
   Port ------------------------------------------------------------------------
          .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .


    18) TestForwardingEnginePort :

   Eth    1  2  3  4  5  6  7  8  9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24
   Port ------------------------------------------------------------------------
          .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .

   Eth   25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48
   Port ------------------------------------------------------------------------
          .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .


    19) TestFrontPort :

   Eth    1  2  3  4  5  6  7  8  9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24
   Port ------------------------------------------------------------------------
          .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .

   Eth   25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48
   Port ------------------------------------------------------------------------
          .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .


switch#

Related Commands

Command
Description

diagnostic bootup level

Configures the bootup diagnostic level for a faster module bootup time.

show diagnostic bootup level

Displays the bootup diagnostics level.


show logging console

To display the console logging configuration, use the show logging console command.

show logging console

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


Examples

This example shows how to display the console logging configuration:

switch# show logging console  

Related Commands

Command
Description

logging console

Configures logging to the console.


show logging info

To display the logging configuration, use the show logging info command.

show logging info

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


Examples

This example shows how to display the logging configuration:

switch# show logging info  

show logging last

To display the last number of lines of the logfile, use the show logging last command.

show logging last number

Syntax Description

number

Enters the number of lines to display from 1 to 9999.


Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


Examples

This example shows how to display the last 42 lines of the log file:

switch# show logging last 42  

show logging level

To display the facility logging severity level configuration, use the show logging level command.

show logging level [facility]

Syntax Description

facility

(Optional) Appropriate logging facility. The facilities are listed in the System Message Logging Facilities section.


Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


Examples

This example shows how to display the EtherChannel logging severity level configuration:

switch# show logging level port-channel  

Related Commands

Command
Description

logging level

Configures the facility logging level.


show logging logfile

To display the messages in the log file that were timestamped within the span entered, use the show logging logfile command.

show logging logfile [start-time yyyy mmm dd hh:mm:ss] [end-time yyyy mmm dd hh:mm:ss]

Syntax Description

start-time yyyy mmm dd hh:mm:ss

(Optional) Specifies a start time in the format yyyy mmm dd hh:mm:ss. Use three characters for the month (mmm) field, digits for the year (yyyy) and day (dd) fields, and digits separated by colons for the time (hh:mm:ss) field.

end-time yyyy mmm dd hh:mm:ss

(Optional) Specifies an end time in the format yyyy mmm dd hh:mm:ss. Use three characters for the month (mmm) field, digits for the year (yyyy) and day (dd) fields, and digits separated by colons for the time (hh:mm:ss) field.


Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


Usage Guidelines

If you do not enter an end time, the current time is used.

Examples

This example shows how to display the messages in the log file that were timestamped within the span shown:

switch# show logging logfile start-time 2008 mar 11 12:10:00  

Related Commands

Command
Description

logging logfile

Configures logging to a log file.


show logging module

To display the module logging configuration, use the show logging module command.

show logging module

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


Examples

This example shows how to display the module logging configuration:

switch# show logging module  

Related Commands

Command
Description

logging module

Configures module logging.


show logging monitor

To display the monitor logging configuration, use the show logging monitor command.

show logging monitor

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


Examples

This example shows how to display the monitor logging configuration:

switch# show logging monitor  

Related Commands

Command
Description

logging monitor

Configures logging on the monitor.


show logging nvram

To display the messages in the nonvolatile random access memory (NVRAM) log, use the show logging nvram command.

show logging nvram [last number-lines]

Syntax Description

last number-lines

(Optional) Specifies the number of lines to display. The number of lines is from 1 to 100.


Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


Examples

This example shows how to display the last 20 messages in the NVRAM log:

switch# show logging nvram last 20  

show logging onboard

To display the onboard logging information based on the error type, use the show logging onboard command.

show logging onboard {boot-uptime | device-version | endtime | environmental-history | exception-log | kernel-trace | obfl-history | obfl-logs | stack-trace | starttime | status} [> file | | type]

Syntax Description

boot-uptime

Displays the onboard failure logging (OBFL) boot and uptime information.

device-version

Displays the OBFL device version information.

endtime

Displays the OBFL logs until the specified end time in the following format: mm/dd/yy-HH:MM:SS

environmental-history

Displays the OBFL environmental history.

exception-log

Displays the OBFL exception log.

kernel-trace

Displays the OBFL kernel trace information.

obfl-history

Displays the OBFL history information.

obfl-logs

Displays the OBFL technical support log information.

stack-trace

Displays the OBFL kernel stack trace information.

starttime

Displays the OBFL logs from the specified start time in the following format: mm/dd/yy-HH:MM:SS

status

Displays the OBFL status enable or disable.

> file

(Optional) Redirects the output to a file. See the "Usage Guidelines" section for additional information.

| type

(Optional) Filters the output. See the "Usage Guidelines" section for additional information.


Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


Usage Guidelines

The date and time arguments for the starttime and endtime keywords are entered as the date month/day/year (mm/dd/yy), followed by a hyphen, and the time in 24-hour format in hours:minutes:seconds (HH:MM:SS). For example:

starttime 03/17/08-15:01:57

endtime 03/18/08-15:04:57

The valid values for file are as follows:

bootflash:

ftp:

scp:

sftp:

tftp:

volatile:

The valid values for type are as follows:

begin [-i] [-x] [word]—Begin with the line that matches the text.

-i—Ignores the case difference when comparing the strings.

-x—Prints only the lines where the match is a whole line.

word—Specifies for the expression.

count [> file | | type]—Counts number of lines.

egrep | grep print-match—Egrep or Grep. Egrep searches for lines of text that match more sophisticated regular expression syntax than grep. Grep searches for lines of text that match one or many regular expressions, and outputs only the matching lines.

-A num—Prints the specifies number of lines of context after every matching line. Range: 1 to 999.

-B num—Prints the specifies number of lines of context before every matching line. Range: 1 to 999.

-c—Prints a total count of matching lines only.

-i—Ignores the case difference when comparing the strings.

-n—Prints each match preceded by its line number.

-v—Prints only the lines that contain no matches for the word argument.

-w—Prints only lines where the match is a complete word.

-x—Prints only the lines where the match is a whole line.

word—Specifies for the expression.

exclude [-i] [-x] [word]—Excludes the lines that match.

-i—Ignores the case difference when comparing the strings.

-x—Prints only the lines where the match is a whole line.

word—Specifies for the expression.

head [-n num]—Stream Editor. The optional -n num keyword and argument allow you to specify the number of lines to print. Range: 0 to 2147483647.

include [-i] [-x] [word]—Include the lines that match.

-i—Ignores the case difference when comparing the strings.

-x—Prints only the lines where the match is a whole line.

word—Specifies for the expression.

last [num]—Displays the last lines to print. The optional num specifies the number of lines to print. Range: 0 to 9999.

less [-E | -d]—Quits at the end of the file.

-E—(Optional) Quits at the end of the file.

-d—(Optional) Specifies a dumb terminal.

no-more—Turns-off pagination for command output.

sed command—Stream Editor

wc—Counts words, lines, and characters.

-c—(Optional) Specifies the output character count.

-l—(Optional) Specifies the output line count.

-w—(Optional) Specifies the output word count.

>—Redirects it to a file.

|—Pipes command output to filter.

Use this command to view OBFL data from the system hardware. The OBFL feature is enabled by default and records operating temperatures, hardware uptime, interrupts, and other important events and messages that can assist with diagnosing problems with hardware cards or modules installed in a Cisco router or switch. Data is logged to files stored in nonvolatile memory. When the onboard hardware is started up, a first record is made for each area monitored and becomes a base value for subsequent records.

The OBFL feature provides a circular updating scheme for collecting continuous records and archiving older (historical) records, ensuring accurate data about the system. Data is recorded in one of two formats: continuous information that displays a snapshot of measurements and samples in a continuous file, and summary information that provides details about the data being collected. The message "No historical data to display" is seen when historical data is not available.

Examples

This example shows how to display the OBFL boot and uptime information:

switch# show logging onboard boot-uptime  
Sun Nov  9 06:11:59 2008:  Boot Record 
------------------------------------------------------------------------------- 
Boot Time..........:  Sun Nov  9 06:11:58 2008 
Slot Number........:  1 
Serial Number......:  FLC12280050 
Bios Version.......:    v1.2.0(06/19/08) 
Firmware Version...:  4.0(1a)N1(1) [build 4.0(1a)N1(1)] 
 

Table 7-1 describes the significant fields shown in the display.

Table 7-1 show logging onboard boot-uptime Command Output

Field
Description

Boot Time

Time boot occurred.

Slot Number

Slot number

Serial Number

Serial number of the module.

Bios Version

Primary binary input and output system (BIOS) version.

Firmware Version

Firmware version.


This example shows how to display the OBFL logging device information:

switch# show logging onboard device-version  
---------------------------- 
OBFL Data for 
    Module:  1 
---------------------------- 
 
Device Version Record 
---------------------------------------------------------------------- 
Timestamp                  Device Name      Instance Hardware Software 
                                                 Num  Version  Version 
---------------------------------------------------------------------- 
Sun Nov  3 07:07:00 2008   GATOS                   2        2        0 
Sun Nov  3 07:07:00 2008   GATOS                   3        2        0 
Sun Nov  3 07:07:00 2008   GATOS                   4        2        0 
Sun Nov  3 07:07:00 2008   GATOS                   5        2        0 
Sun Nov  3 07:07:00 2008   GATOS                   6        2        0 
Sun Nov  3 07:07:00 2008   GATOS                   7        2        0 
Sun Nov  3 07:07:00 2008   GATOS                   8        2        0 
Sun Nov  3 07:07:00 2008   GATOS                   9        2        0 
Sun Nov  3 07:07:00 2008   GATOS                  10        2        0 
Sun Nov  3 07:07:00 2008   GATOS                  11        2        0 
Sun Nov  3 07:07:00 2008   GATOS                  12        2        0 
Sun Nov  3 07:07:00 2008   GATOS                  13        2        0 
Mon Nov  4 00:15:08 2008   ALTOS                   0        2        0 
Mon Nov  4 00:15:08 2008   GATOS                   0        2        0 
Mon Nov  4 00:15:08 2008   GATOS                   1        2        0 
Mon Nov  4 00:15:08 2008   GATOS                   2        2        0 
 

Table 7-2 describes the significant fields shown in the display.

Table 7-2 show logging onboard device-version Command Output

Field
Description

Timestamp

Day, date, and time.

Device Name

Device name.

Instance Num

Number of instances.

Hardware Version

Hardware device version.

Software Version

Software device version.


This example shows how to display the OBFL history information:

switch# show logging onboard obfl-history  

The show logging onboard obfl-history command displays the following information:

Timestamp when OBFL is manually disabled.

Timestamp when OBFL is manually enabled.

Timestamp when OBFL data is manually cleared.

This example shows how to display the OBFL kernel stack trace information:

switch# show logging onboard stack-trace  

The show logging onboard stack-trace command displays the following information:

Time in seconds

Time in microseconds

Error description string

Current process name and identification

Kernel jiffies

Stack trace

Related Commands

clear logging onboard

Clears the OBFL entries in the persistent log.

hw-module logging onboard

Enables or disabled OBFL entries based on the error type.


show logging pending

To display the pending changes to the syslog server configuration, use the show logging pending command.

show logging pending

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1)

This command was introduced.


Examples

This example shows how to display the pending changes to the syslog server configuration:

switch# show logging pending 
switch# 

Related Commands

Command
Description

logging abort

Cancels the pending changes to the syslog server configuration.


show logging pending-diff

To display the differences from the current syslog server configuration to the pending changes of the syslog server configuration, use the show logging pending-diff command.

show logging pending-diff

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1)

This command was introduced.


Examples

This example shows how to display the pending differences of the syslog server configuration:

switch# show logging pending-diff 
switch# 

Related Commands

Command
Description

logging abort

Cancels the pending changes to the syslog server configuration.


show logging session status

To display the logging session status, use the show logging session status command.

show logging session status

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


Examples

This example shows how to display the logging session status:

switch# show logging session status  

show logging server

To display the syslog server configuration, use the show logging server command.

show logging server

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


Examples

This example shows how to display the syslog server configuration:

switch# show logging server  

Related Commands

Command
Description

logging server

Configures a remote syslog server.


show logging status

To display the logging status, use the show logging status command.

show logging status

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


Examples

This example shows how to display the logging status:

switch# show logging status 
Fabric Distribute     : Enabled
Session State         : IDLE
switch#

Related Commands

Command
Description

logging distribute

Enables the distribution of the syslog server configuration to network switches using the Cisco Fabric Services (CFS) infrastructure.


show logging timestamp

To display the logging time-stamp configuration, use the show logging timestamp command.

show logging timestamp

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


Examples

This example shows how to display the logging time-stamp configuration:

switch# show logging timestamp  

Related Commands

Command
Description

logging timestamp

Configures the logging time stamp granularity.


show ntp peer-status

To display the status of the Network Time Protocol (NTP) peers, use the show ntp peer-status command.

show ntp peer-status

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


Examples

This example shows how to display the peer status for NTP:

switch(config)# show ntp peer-status  

Related Commands

Command
Description

show ntp peers

Displays information about NTP peers.


show ntp peers

To display information about Network Time Protocol (NTP) peers, use the show ntp peers command.

show ntp peers

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


Examples

This example shows how to display information about NTP peers:

switch(config)# show ntp peers  

Related Commands

Command
Description

show ntp peer-status

Displays status information about NTP peers.


show ntp statistics

To display Network Time Protocol (NTP) statistics, use the show ntp statistics command.

show ntp statistics {io | local | memory | peer {ipaddr address | name name1 [..nameN]}

Syntax Description

io

Displays the input-output statistics.

local

Displays the counters maintained by the local NTP.

memory

Displays the statistics counters related to the memory code.

peer

Displays the per-peer statistics counter of a peer.

ipaddr address

Displays statistics for the peer with the configured IPv4 or IPv6 address. The IPv4 address format is dotted decimal, x.x.x.x. The IPv6 address format is hexadecimal A:B::C:D.

name name1

Displays statistics for a named peer.

..nameN

(Optional) Displays statistics for one or more named peers.


Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


Examples

This example shows how to display the statistics for NTP:

switch(config)# show ntp statistics local  

Related Commands

Command
Description

clear ntp statistics

Clears NTP statistics


show ntp timestamp-status

To display the Network Time Protocol (NTP) time-stamp information, use the show ntp timestamp-status command.

show ntp timestamp-status

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


Examples

This example shows how to display the NTP time-stamp status:

switch(config)# show ntp timestamp-status  

show snmp community

To display the Simple Network Management Protocol (SNMP) community strings configured on the switch, use the show snmp community command.

show snmp community

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1)

This command was introduced.


Examples

This example shows how to display the SNMP community strings:

switch# show snmp community 
Community            Group / Access      context    acl_filter
---------            --------------      -------    ----------
public                network-admin
switch#

Related Commands

Command
Description

snmp-server community

Configures the community access string to permit access to the SNMP protocol.


show snmp context

To display the Simple Network Management Protocol (SNMP) contexts configured on the switch, use the show snmp context command.

show snmp context

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1)

This command was introduced.


Examples

This example shows how to display the SNMP contexts:

switch# show snmp context 

Related Commands

Command
Description

snmp-server context

Configures an SNMP context.


show snmp engineID

To display the identification of the local Simple Network Management Protocol (SNMP) engine, use the show snmp engineID command.

show snmp engineID

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1)

This command was introduced.


Usage Guidelines

An SNMP engine is a copy of SNMP that can reside on a local or remote device. SNMP passwords are localized using the SNMP engine ID of the authoritative SNMP engine.

Examples

This example shows how to display the SNMP engine ID:

switch# show snmp engineID 
Local SNMP engineID: [Hex] 8000000903000DECB230C0
                     [Dec] 128:000:000:009:003:000:013:236:178:048:192
switch#

show snmp group

To display the names of the Simple Network Management Protocol (SNMP) groups configured on the switch, use the show snmp group command.

show snmp group

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1)

This command was introduced.


Examples

This example shows how to display the SNMP groups:

switch# show snmp group 

Role: network-admin
  Description: Predefined network admin role has access to all commands
  on the switch
  -------------------------------------------------------------------
  Rule    Perm    Type        Scope               Entity
  -------------------------------------------------------------------
  1       permit  read-write

Role: network-operator
  Description: Predefined network operator role has access to all read
  commands on the switch
  -------------------------------------------------------------------
  Rule    Perm    Type        Scope               Entity
  -------------------------------------------------------------------
  1       permit  read

Role: vdc-admin
  Description: Predefined vdc admin role has access to all commands within
  a VDC instance
  -------------------------------------------------------------------
  Rule    Perm    Type        Scope               Entity
  -------------------------------------------------------------------
  1       permit  read-write

Role: vdc-operator
  Description: Predefined vdc operator role has access to all read commands
  within a VDC instance
  -------------------------------------------------------------------
  Rule    Perm    Type        Scope               Entity
  -------------------------------------------------------------------
  1       permit  read

Role: priv-3
  Description: This is a system defined privilege role.
  vsan policy: permit (default)
  Vlan policy: permit (default)
  Interface policy: permit (default)
  Vrf policy: permit (default)

Role: priv-2
  Description: This is a system defined privilege role.
  vsan policy: permit (default)
  Vlan policy: permit (default)
  Interface policy: permit (default)
  Vrf policy: permit (default)

Role: priv-1
  Description: This is a system defined privilege role.
  vsan policy: permit (default)
  Vlan policy: permit (default)
  Interface policy: permit (default)
  Vrf policy: permit (default)

Role: priv-0
  Description: This is a system defined privilege role.
  vsan policy: permit (default)
  Vlan policy: permit (default)
  Interface policy: permit (default)
  Vrf policy: permit (default)
  -------------------------------------------------------------------
  Rule    Perm    Type        Scope               Entity
  -------------------------------------------------------------------
  10      permit  command                         traceroute6 *
  9       permit  command                         traceroute *
  8       permit  command                         telnet6 *
  7       permit  command                         telnet *
  6       permit  command                         ping6 *
  5       permit  command                         ping *
  4       permit  command                         ssh6 *
  3       permit  command                         ssh *
  2       permit  command                         enable *
  1       permit  read

Role: priv-15
  Description: This is a system defined privilege role.
  vsan policy: permit (default)
  Vlan policy: permit (default)
  Interface policy: permit (default)
  Vrf policy: permit (default)
  -------------------------------------------------------------------
  Rule    Perm    Type        Scope               Entity
  -------------------------------------------------------------------
  1       permit  read-write
switch#

show snmp host

To display the Simple Network Management Protocol (SNMP) host information, use the show snmp host command.

show snmp host

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1)

This command was introduced.


Examples

This example shows how to display the SNMP host:

switch# show snmp host 

Related Commands

Command
Description

snmp-server host

Configures an SNMP host.


show snmp sessions

To display the current Simple Network Management Protocol (SNMP) sessions, use the show snmp sessions command.

show snmp sessions

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1)

This command was introduced.


Examples

This example shows how to display the SNMP sessions:

switch# show snmp sessions 

show snmp trap

To display the Simple Network Management Protocol (SNMP) link trap generation information, use the show snmp trap command.

show snmp trap

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1)

This command was introduced.


Examples

This example shows how to display the SNMP traps:

switch# show snmp trap 
--------------------------------------------------------------------------------
Trap type                       Description                   Enabled
--------------------------------------------------------------------------------
entity               : entity_mib_change                            Yes
entity               : entity_module_status_change                  Yes
entity               : entity_power_status_change                   Yes
entity               : entity_module_inserted                       Yes
entity               : entity_module_removed                        Yes
entity               : entity_unrecognised_module                   Yes
entity               : entity_fan_status_change                     Yes
link                 : linkDown                                     Yes
link                 : linkUp                                       Yes
link                 : IETF-extended-linkDown                       Yes
link                 : IETF-extended-linkUp                         Yes
link                 : cisco-extended-linkDown                      Yes
link                 : cisco-extended-linkUp                        Yes
callhome             : event-notify                                 No
callhome             : smtp-send-fail                               No
cfs                  : state-change-notif                           No
cfs                  : merge-failure                                No
rf                   : redundancy_framework                         Yes
aaa                  : server-state-change                          No
license              : notify-license-expiry                        Yes
license              : notify-no-license-for-feature                Yes
license              : notify-licensefile-missing                   Yes
license              : notify-license-expiry-warning                Yes
zone                 : unsupp-mem                                   No
upgrade              : UpgradeOpNotifyOnCompletion                  Yes
upgrade              : UpgradeJobStatusNotify                       Yes
feature-control      : FeatureOpStatusChange                        No
sysmgr               : cseFailSwCoreNotifyExtended                  No
rmon                 : risingAlarm                                  No
rmon                 : fallingAlarm                                 No
rmon                 : hcRisingAlarm                                No
rmon                 : hcFallingAlarm                               No
config               : ccmCLIRunningConfigChanged                   No
snmp                 : authentication                               No
bridge               : topologychange                               No
bridge               : newroot                                      No
stp                  : inconsistency                                No
stpx                 : loop-inconsistency                           No
stpx                 : root-inconsistency                           No
switch#

Related Commands

Command
Description

snmp trap link-status

Enables SNMP link trap generation.


snmp-server community

To create Simple Network Management Protocol (SNMP) communities for SNMPv1 or SNMPv2c, use the snmp-server community command. To revert to the defaults, sue the no form of this command.

snmp-server community com-name [group grp-name | ro | rw | use-acl acl-name]

no snmp-server community com-name [group grp-name | ro | rw | use-acl acl-name]

Syntax Description

com-name

SNMP community string. The name can be any alphanumeric string up to 32 characters.

group grp-name

(Optional) Specifies the group to which the community belongs. The name can be a maximum of 32 characters.

ro

(Optional) Specifies read-only access with this community string.

rw

(Optional) Specifies read-write access with this community string.

use-acl acl-name

(Optional) Specifies the access control list (ACL) to filter SNMP requests. The name can be a maximum of 32 characters.


Command Default

None

Command Modes

Global configuration mode

Command History

Release
Modification

4.2(1)N1(1)

This command was introduced.


Usage Guidelines

You can assign an access list (ACL) to a community to filter incoming SNMP requests. If the assigned ACL allows the incoming request packet, SNMP processes the request. If the ACL denies the request, SNMP drops the request and sends a system message.

See the Cisco Nexus 5000 Series NX-OS Security Configuration Guide for more information on creating ACLs. The ACL applies to both IPv4 and IPv6 over UDP and TCP. After creating the ACL, assign the ACL to the SNMP community.

Examples

This example shows how to create an SNMP community string and assign an ACL to the community to filter SNMP requests:

switch(config)# snmp-server community public use-acl my_acl_for_public 
switch(config)# 

Related Commands

Command
Description

show snmp community

Displays the SNMP community strings.


System Message Logging Facilities

Table 7-3 lists the facilities that you can use in system message logging configuration.

Table 7-3 System Message Logging Facilities 

Facility
Description

aaa

Sets level for aaa syslog messages.

aclmgr

Sets level for aclmgr syslog messages.

adjmgr

Sets syslog filter level for Adjacency Manager.

afm

Sets level for afm syslog messages.

all

Sets level for all facilities.

altos

Altos syslog level.

arp

Sets syslog filter level for ARP.

auth

Sets level for Authorization System.

authpriv

Sets level for Authorization (Private) system.

bootvar

Sets level for bootvar.

callhome

Callhome syslog level.

capability

Sets syslog level for mig utils daemon.

cdp

Sets logging level for CDP.

cert-enroll

Cert-enroll syslog level.

cfs

Sets logging level for CFS.

clis

Sets syslog filter level for CLIS.

core

Core daemon syslog level.

cron

Sets level for Cron/at facility.

daemon

Sets level for System daemons.

dcbx

Sets level for dcx syslog messages.

device-alias

Sets syslog level for Device Alias Distribution Service.

dstats

Delta statistics syslog level.

epp

Sets level for EPP syslog messages.

ethpc

Sets level for ethpc syslog messages.

ethpm

Sets level for ethpm syslog messages.

evmc

Sets level for evmc syslog messages.

fabric_start_cfg_mgr

Fabric start cfg mgr syslog level.

fc2d

Sets level for fc2d syslog messages.

fcdomain

Sets level for fcdomain syslog messages.

fcns

Sets syslog filter level for name server.

fcpc

Sets level for fcpc syslog messages.

fcs

Sets syslog filter level for FCS.

fdmi

Sets logging level for fdmi.

feature-mgr

Feature manager syslog level.

flogi

Configure level for flogi syslog messages.

fs-daemon

FS daemon syslog level.

fspf

FSPF syslog level.

ftp

Sets level for File Transfer System.

fwm

Sets level for fwm syslog messages.

gatos

Gatos syslog level.

im

Sets level for im syslog messages.

kernel

Sets level for kernel.

l3vm

Sets syslog filter level for L3VM.

license

Licensing syslog level.

local0

Sets level for Local use daemons.

local1

Sets level for Local use daemons.

local2

Sets level for Local use daemons.

local3

Sets level for Local use daemons.

local4

Sets level for Local use daemons.

local5

Sets level for Local use daemons.

local6

Sets level for Local use daemons.

local7

Sets level for Local use daemons.

lpr

Sets level for Line Printer System.

mail

Sets level for Mail system.

monitor

Sets level for ethernet span syslog messages.

news

Sets level for USENET news.

nohms

Sets level for nohms syslog messages.

nqosm

Sets level for nqosm syslog messages.

ntp

Sets syslog filter level for NTP.

pfm

Sets level for pfm syslog messages.

pktmgr

Sets syslog filter level for Packet Manager.

plugin

Sets level for plugin syslog messages.

port

Sets level for port syslog messages.

port-channel

Sets level for EtherChannel syslog messages.

qd

Sets level for qd syslog messages.

radius

RADIUS syslog level.

rdl

Sets logging level for RDL.

res_mgr

Set slevel for res_mgr syslog messages.

rib

Sets level for rib.

rlir

Sets level for RLIR.

rscn

Sets level for RSCN.

san-port-channel

Sets level for san-port-channel syslog messages.

scsi-target

SCSI target daemon syslog level.

security

Security syslog level.

session

Sets level for session-manager syslog messages.

sifmgr

Sets level for sifmgr syslog messages.

spanning-tree

Sets level for stp syslog messages.

stp

Sets level for stp syslog messages.

syslog

Sets level for Internal Syslog Messages.

sysmgr

System Manager syslog level.

tcpudp

Sets syslog filter level for TCPUDP.

track

Sets level for track syslog messages.

urib

Sets syslog filter level for URIB.

user

Sets level for User Process.

uucp

Sets level for Unix-to-Unix copy system.

vlan_mgr

Sets level for VLAN syslog messages.

vmm

Sets level for vmm syslog messages.

vsan

VSAN syslog level.

vshd

Sets logging level for vshd.

wwnm

Sets WWN Manager syslog level.

xml

XML agent syslog level.

zone

Sets syslog filter level for zone server.

zschk

Sets level for zschk syslog messages.


verify (session)

To verify the current configuration session, use the verify command.

verify

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

Session configuration mode

Command History

Release
Modification

4.0(0)N1(1)

This command was introduced.


Examples

This example shows how to verify a session:

switch(config-s)# verify 
Failed to start Verification: Session Database already locked, Verify/Commit in
Progress.
switch(config-s)# 

Related Commands

Command
Description

commit

Commits a session.

configure session

Creates a configuration session.

show configuration session

Displays the contents of the session.