Cisco Nexus 3548 series Installation manual

Cisco Systems, Inc.
www.cisco.com
Cisco has more than 200 offices worldwide.
Addresses, phone numbers, and fax numbers
are listed on the Cisco website at
www.cisco.com/go/offices.
Cisco Nexus 3548 Switch NX-OS System
Management Command Reference
First Published: April 2013
Last Modified: May 2016
Text Part Number: OL-27851-02

THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS MANUAL ARE SUBJECT TO CHANGE WITHOUT NOTICE. ALL
STATEMENTS, INFORMATION, AND RECOMMENDATIONS IN THIS MANUAL ARE BELIEVED TO BE ACCURATE BUT ARE PRESENTED WITHOUT
WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. USERS MUST TAKE FULL RESPONSIBILITY FOR THEIR APPLICATION OF ANY PRODUCTS.
THE SOFTWARE LICENSE AND LIMITED WARRANTY FOR THE ACCOMPANYING PRODUCT ARE SET FORTH IN THE INFORMATION PACKET THAT
SHIPPED WITH THE PRODUCT AND ARE INCORPORATED HEREIN BY THIS REFERENCE. IF YOU ARE UNABLE TO LOCATE THE SOFTWARE LICENSE
OR LIMITED WARRANTY, CONTACT YOUR CISCO REPRESENTATIVE FOR A COPY.
The Cisco implementation of TCP header compression is an adaptation of a program developed by the University of California, Berkeley (UCB) as part of UCB’s public
domain version of the UNIX operating system. All rights reserved. Copyright © 1981, Regents of the University of California.
NOTWITHSTANDING ANY OTHER WARRANTY HEREIN, ALL DOCUMENT FILES AND SOFTWARE OF THESE SUPPLIERS ARE PROVIDED “AS IS” WITH
ALL FAULTS. CISCO AND THE ABOVE-NAMED SUPPLIERS DISCLAIM ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT
LIMITATION, THOSE OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OR ARISING FROM A COURSE OF
DEALING, USAGE, OR TRADE PRACTICE.
IN NO EVENT SHALL CISCO OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL, OR INCIDENTAL DAMAGES, INCLUDING,
WITHOUT LIMITATION, LOST PROFITS OR LOSS OR DAMAGE TO DATA ARISING OUT OF THE USE OR INABILITY TO USE THIS MANUAL, EVEN IF CISCO
OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this
URL: www.cisco.com/go/trademarks. Third-party trademarks mentioned are the property of their respective owners. The use of the word partner does not imply a partnership
relationship between Cisco and any other company. (1110R)
Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be actual addresses and phone numbers. Any examples, command display
output, network topology diagrams, and other figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses or phone numbers in
illustrative content is unintentional and coincidental.
Cisco Nexus 3548 Switch NX-OS System Management Command Reference
© 2016 Cisco Systems, Inc. All rights reserved.

iii
Book Title
CONTENTS
Preface 1
Audience 1
Document Conventions 1
Related Documentation 2
Documentation Feedback 3
Obtaining Documentation and Submitting a Service Request 3
New and Changed Information 1-1
System Management Commands 1-1

Contents
iv
Book Title

1
Cisco Nexus 3548 Switch NX-OS System Management Command Reference
OL-27851-02
Preface
This preface describes the audience, organization, and conventions of the Cisco Nexus 3548 Switch
NX-OS System Management Command Reference . It also provides information on how to obtain related
documentation.
This preface includes the following sections:
•Audience, page 1
•Document Conventions, page 1
•Related Documentation, page 2
•Documentation Feedback, page 3
•Obtaining Documentation and Submitting a Service Request, page 3
Audience
This publication is for experienced network administrators who configure and maintain Cisco Nexus
Series switches.
Document Conventions
Command descriptions use these conventions:
Convention Description
boldface font Commands and keywords are in boldface.
italic font Arguments for which you supply values are in italics.
[ ] Elements in square brackets are optional.
[ x | y | z ] Optional alternative keywords are grouped in brackets and separated by vertical
bars.
string A nonquoted set of characters. Do not use quotation marks around the string or
the string will include the quotation marks.

2
Cisco Nexus 3548 Switch NX-OS System Management Command Reference
OL-27851-02
Screen examples use these conventions:
This document uses the following conventions:
Note Means reader take note. Notes contain helpful suggestions or references to material not covered in the
manual.
Caution Means reader be careful. In this situation, you might do something that could result in equipment
damage or loss of data.
Related Documentation
Documentation for the Cisco Nexus 3000 Series Switch is available at the following URL:
http://www.cisco.com/en/US/products/ps11541/tsd_products_support_series_home.html
The documentation set is divided into the following categories:
Release Notes
The release notes are available at the following URL:
http://www.cisco.com/en/US/products/ps11541/prod_release_notes_list.html
Installation and Upgrade Guides
The installation and upgrade guides are available at the following URL:
http://www.cisco.com/en/US/products/ps11541/prod_installation_guides_list.html
Command References
The command references are available at the following URL:
http://www.cisco.com/en/US/products/ps11541/prod_command_reference_list.html
Technical References
The technical references are available at the following URL:
http://www.cisco.com/en/US/products/ps11541/prod_technical_reference_list.html
screen font Terminal sessions and information that the switch displays are in screen font.
boldface screen
font
Information that you must enter is in boldface screen font.
italic screen font Arguments for which you supply values are in italic screen font.
< > Nonprinting characters, such as passwords, are in angle brackets.
[ ] Default responses to system prompts are in square brackets.
!, # An exclamation point (!) or a pound sign (#) at the beginning of a line of code
indicates a comment line.

3
Cisco Nexus 3548 Switch NX-OS System Management Command Reference
OL-27851-02
Configuration Guides
The configuration guides are available at the following URL:
http://www.cisco.com/en/US/products/ps11541/products_installation_and_configuration_guides_list.h
tml
Error and System Messages
The system message reference guide is available at the following URL:
http://www.cisco.com/en/US/products/ps11541/products_system_message_guides_list.html
Documentation Feedback
To provide technical feedback on this document, or to report an error or omission, please send your
comments to nexu[email protected]. We appreciate your feedback.
Obtaining Documentation and Submitting a Service Request
For information on obtaining documentation, submitting a service request, and gathering additional
information, see the monthly What’s New in Cisco Product Documentation, which also lists all new and
revised Cisco technical documentation:
http://www.cisco.com/en/US/docs/general/whatsnew/whatsnew.html
Subscribe to the What’s New in Cisco Product Documentation as an RSS feed and set content to be
delivered directly to your desktop using a reader application. The RSS feeds are a free service. Cisco currently
supports RSS Version 2.0.

4
Cisco Nexus 3548 Switch NX-OS System Management Command Reference
OL-27851-02

1
Cisco Nexus 3548 Switch NX-OS System Management Command Reference
OL-27851-02
New and Changed Information
This chapter provides release-specific information for each new and changed feature in the Cisco Nexus
3548 Switch NX-OS System Management Command Reference . The latest version of this document is
available at the following Cisco website:
http://www.cisco.com/en/US/products/ps11541/tsd_products_support_series_home.html
To check for additional information about this Cisco NX-OS Release, see the Cisco Nexus 3000 Series
Switch Release Notes available at the following Cisco website:
http://www.cisco.com/en/US/products/ps11541/prod_release_notes_list.html
Table 1 summarizes the new and changed features for release 6.x and tells you where they are
documented.
Table 1 New and Changed Information for Release 6.x
Feature Description
Changed in
Release Where Documented
Warp mode Added support for hardware profile
forwarding-mode normal and updated
options for hardware profile
forwarding-mode warp.
6.0(2)A8(1) hardware profile forwarding-mode
normal
hardware profile forwarding-mode
warp
Memory error statistics Added the command to display the memory
error statistics. Added show logging
onboard memory-errors command output.
6.0(2)A4(6) show hardware profile buffer
monitor summary
show logging onboard
memory-errors
SPAN and ERSPAN Added the ability to filter, sample and
truncate packets for these features.
6.0(2)A4(1) filter
mtu
sampling

-2
Cisco Nexus 3548 Switch NX-OS System Management Command Reference
OL-27851-02
Chapter New and Changed Information
ERSPAN This feature was introduced.
The monitor session command was updated
to include the erspan-destination and
erspan-source keywords.
6.0(2)A1(1) description (SPAN, ERSPAN)
destination ip (ERSPAN)
destination interface (ERSPAN)
monitor erspan origin ip-address
monitor session
shut (ERSPAN)
source (SPAN, ERSPAN)
source ip (ERSPAN)
vrf (ERSPAN)
show monitor session
show running-config monitor
Precision Time Protocol
(PTP)
This feature was introduced. 6.0(2)A1(1) clear ptp counters
clock protocol
feature scheduler
ptp announce
ptp delay-request minimum interval
ptp domain
ptp priority1
ptp priority2
ptp source
ptp sync interval
ptp vlan
show ptp brief
show ptp clock
show ptp clock
foreign-masters-record
show ptp corrections
show ptp parent
show ptp port
show ptp time-property
show scheduler
show startup-config ptp
Table 1 New and Changed Information for Release 6.x (continued)
Feature Description
Changed in
Release Where Documented

1
Cisco Nexus 3548 Switch NX-OS System Management Command Reference
OL-27851-02
System Management Commands
This chapter describes the Cisco NX-OS system management commands available on the Cisco Nexus
3548 switch.
Note The internal CLI commands are not supported on the Cisco Nexus Series switches.

System Management Commands
abort (Call Home)
2
Cisco Nexus 3548 Switch NX-OS System Management Command Reference
OL-27851-02
abort (Call Home)
To discard Call Home configuration changes and release the Cisco Fabric Services (CFS) lock, use the
abort command.
abort
Syntax Description This command has no arguments or keywords.
Command Default None
Command Modes Callhome configuration mode
Command History
Usage Guidelines Use this command if you are the CFS lock owner or if you are logged into the device that holds the CFS
lock.
Examples This example shows how to discard Call Home configuration changes:
switch(config-callhome)# abort
switch(config-callhome)#
Related Commands
Release Modification
5.0(3)A1(1) This command was introduced.
Command Description
show callhome Displays Call Home configuration information.
show running-config
callhome
Displays the running configuration information for Call Home.

System Management Commands
abort (session)
3
Cisco Nexus 3548 Switch NX-OS System Management Command Reference
OL-27851-02
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
Examples This example shows how to abort the current configuration session:
switch# configure session MySession1
switch(config-s)# abort
switch#
Related Commands
Release Modification
5.0(3)A1(1) This command was introduced.
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.

System Management Commands
action cli
4
Cisco Nexus 3548 Switch NX-OS System Management Command Reference
OL-27851-02
action cli
To configure a virtual shell (VSH) command string to be executed when an Embedded Event Manager
(EEM) applet is triggered, use the action cli command. To disable the VSH command string, use the no
form of this command.
action label num1 [.num2]cli [local]vsh_cmd
no action label num1 [.num2]cli
Syntax Description
Defaults None
Command Modes Embedded event manager configuration mode
Command History
Usage Guidelines This command does not require a license.
Examples This example shows how to configure a VSH command string to be executed when an EEM applet is
triggered:
switch# configure terminal
switch(config)# event manager applet cli-applet
switch(config-applet)# action 1.1 cli show version
switch(config-applet)#
Related Commands
label num1 [.num2] Unique identifier that can be any string value. Actions are sorted and run in an
ascending alphanumeric sequence using the label as the sort key. The range for
num1 is from 1 to 16 and the range for num2 is from 0 to 9.
local (Optional) Specifies the action is to be executed in the same module on which the
event occurs.
vsh_cmd VSH command string to be executed when the applet is triggered.
Release Modification
5.0(3)A1(1) This command was introduced.
Command Description
action counter Sets or modifies a named counter when an Embedded Event Manager
(EEM) applet is triggered.
action event-default Specifies that the default action for the event is to be performed when an
Embedded Event Manager (EEM) applet is triggered.
action policy-default Enables the default action of the policy being overridden.

System Management Commands
action cli
5
Cisco Nexus 3548 Switch NX-OS System Management Command Reference
OL-27851-02
action snmp-trap Specifies the generation of a Simple Network Management Protocol
(SNMP) trap when an Embedded Event Manager (EEM) applet is triggered.
action syslog Configures a syslog message to generate when an Embedded Event
Manager (EEM) applet is triggered.
Command Description

System Management Commands
action counter
6
Cisco Nexus 3548 Switch NX-OS System Management Command Reference
OL-27851-02
action counter
To set or modify a named counter when an Embedded Event Manager (EEM) applet is triggered, use the
action counter command. To restore the default value to the counter, use the no form of this command.
action label num1 [.num2] counter name name value value op {dec | inc | nop |set}
no action label num1 [.num2] counter name name
Syntax Description
Defaults None
Command Modes Embedded event manager configuration mode
Command History
Usage Guidelines This command does not require a license.
Examples This example shows how to set the counter count1 to the value in $variable when the EEM
counter-applet is triggered:
switch# configure terminal
switch(config)# event manager applet counter-applet
switch(config-applet)# action 1.2 counter name count1 value $variable op dec
switch(config-applet)#
label num1 [.num2] Unique identifier that can be any string value. Actions are sorted and run in an
ascending alphanumeric sequence using the label as the sort key. The range for
num1 is from 1 to 16 and the range for num2 is from 0 to 9.
name name Specifies the name of the counter. This identifier can be any string value up to 28
characters.
value value Specifies the value of the counter. This identifier must be an integer value and can
be in the range of 0 to 2147483647 or a $-prefixed name (for parameter
substitution).
op Specifies the operation to perform upon the counter.
dec Decrements the counter by the specified value.
inc Increments the counter by the specified value.
nop Does nothing; using this keyword just displays the specified value.
set Sets the counter to the specified value.
Release Modification
5.0(3)A1(1) This command was introduced.

System Management Commands
action counter
7
Cisco Nexus 3548 Switch NX-OS System Management Command Reference
OL-27851-02
Related Commands Command Description
action cli Configures a virtual shell (VSH) command string to be executed when an
Embedded Event Manager (EEM) applet is triggered.
action event-default Specifies that the default action for the event is to be performed when an
Embedded Event Manager (EEM) applet is triggered.
action policy-default Enables the default action of the policy being overridden.
action reload Specifies the action of reloading the Cisco Nexus 3548 switch software
when an Embedded Event Manager (EEM) applet is triggered.
action snmp-trap Specifies the generation of a Simple Network Management Protocol
(SNMP) trap when an Embedded Event Manager (EEM) applet is triggered.
action syslog Configures a syslog message to generate when an Embedded Event
Manager (EEM) applet is triggered.

System Management Commands
action event-default
8
Cisco Nexus 3548 Switch NX-OS System Management Command Reference
OL-27851-02
action event-default
To specify that the default action for the event is to be performed when an Embedded Event Manager
(EEM) applet is triggered, use the action event-default command. To disable the default action, use the
no form of this command.
action label num1 [.num2] event-default
no action num1 [.num2] event-default
Syntax Description
Defaults None
Command Modes Embedded event manager configuration mode
Command History
Usage Guidelines If you want to allow the triggered event to process any default actions, you must configure the EEM
policy to allow the default action. For example, if you match a CLI command in a match statement, you
must add the event-default statement to the EEM policy or EEM does not allow the CLI command to
execute. You can use the terminal event-manager bypass command to allow all EEM policies with CLI
matches to execute the CLI command.
This command does not require a license.
Examples This example shows how to specify that the default action for the event is to be performed when an EEM
applet is triggered:
switch# configure terminal
switch(config)# event manager applet default-applet
switch(config-applet)# action 1.1 event-default
switch(config-applet)#
Related Commands
label num1 [.num2] Unique identifier that can be any string value. Actions are sorted and run in an
ascending alphanumeric sequence using the label as the sort key. The range for
num1 is from 1 to 16 and the range for num2 is from 0 to 9.
Release Modification
5.0(3)A1(1) This command was introduced.
Command Description
action cli Configures a virtual shell (VSH) command string to be executed when an
Embedded Event Manager (EEM) applet is triggered.
action counter set or modify a named counter when an Embedded Event Manager (EEM)
applet is triggered.

System Management Commands
action event-default
9
Cisco Nexus 3548 Switch NX-OS System Management Command Reference
OL-27851-02
action policy-default Enables the default action of the policy being overridden.
action snmp-trap Specifies the generation of a Simple Network Management Protocol
(SNMP) trap when an Embedded Event Manager (EEM) applet is triggered.
action syslog Configures a syslog message to generate when an Embedded Event
Manager (EEM) applet is triggered.
Command Description

System Management Commands
action policy-default
10
Cisco Nexus 3548 Switch NX-OS System Management Command Reference
OL-27851-02
action policy-default
To enable the default action of the policy being overridden, use the action policy-default command. To
remove the default action, use the no form of this command.
action label num1 [.num2] policy-default
no action label num1 [.num2] policy-default
Syntax Description
Defaults None
Command Modes Embedded event manager configuration mode
Command History
Usage Guidelines This command does not require a license.
Examples This example shows how to enable the default action of a policy being overridden when an EEM applet
is triggered:
switch# configure terminal
switch(config)# event manager applet default-applet
switch(config-applet)# action 1.0 policy-default
switch(config-applet)#
Related Commands
label num1 [.num2] Unique identifier that can be any string value. Actions are sorted and run in an
ascending alphanumeric sequence using the label as the sort key. The range for
num1 is from 1 to 16 and the range for num2 is from 0 to 9.
Release Modification
5.0(3)A1(1) This command was introduced.
Command Description
action cli Configures a virtual shell (VSH) command string to be executed when an
Embedded Event Manager (EEM) applet is triggered.
action counter set or modify a named counter when an Embedded Event Manager (EEM)
applet is triggered.
action event-default Specifies that the default action for the event is to be performed when an
Embedded Event Manager (EEM) applet is triggered.
action snmp-trap Specifies the generation of a Simple Network Management Protocol
(SNMP) trap when an Embedded Event Manager (EEM) applet is triggered.
action syslog Configures a syslog message to generate when an Embedded Event
Manager (EEM) applet is triggered.