Cisco Nexus 7000 Series NX-OS System Management Command Reference

August 2013

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.

Text Part Number: OL-25806-03

TTHE 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 UCBs 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 used in this document are not intended to be actual addresses. Any examples, command display output, and figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses in illustrative content is unintentional and coincidental. Cisco Nexus 7000 Series NX-OS System Management Command Reference 20082013 Cisco Systems, Inc. All rights reserved.

CONTENTS

New and Changed Information Preface

1xxiii 1xxiii 1xxiii 1xxiv 1xxv

1xvii

Audience

Organization

Document Conventions Related Documentation

Obtaining Documentation and Submitting a Service Request A Commands

SM-1 SM-2 SM-3

1xxvi

abort (Call home) action cli

SM-4

abort (Session Manager) action counter

SM-5

action event-default action exceptionlog action forceshut action overbudgetshut action policy-default action reload action syslog alert-group B Commands blink
SM-13

SM-7 SM-8

SM-10 SM-11 SM-12

action snmp-trap

SM-14

SM-15 SM-17 SM-19

SM-20 SM-23 SM-24 SM-26 SM-27 SM-28 SM-29

Cisco Nexus 7000 Series NX-OS System Management Command Reference

C Commands callhome

callhome send callhome test cdp advertise cdp enable

OL-25806-03

iii

Contents

cdp format device-id cdp holdtime cdp timer cfs eth cfs ipv4 cfs region checkpoint clear cdp clear cores cfs distribute
SM-34 SM-35 SM-37 SM-39 SM-31 SM-32 SM-33

SM-30

check logflash

SM-40 SM-42

clear callhome session

SM-43

clear checkpoint database

SM-45 SM-46 SM-47

SM-44

clear flow exporter clear flow monitor

clear hardware flow ip clear logging logfile clear logging nvram clear logging onboard clear logging session clear ntp session clear ntp statistics clear nvram
SM-59

SM-49 SM-51

clear logging ip access-list cache

SM-52 SM-53 SM-54 SM-56

SM-57 SM-58

clear platform flow ip clear rmon

SM-63

SM-60 SM-62

clear processes log archive clear session state name clear snmp counters clear snmp hostconfig collect counter collect flow collect routing collect interface
SM-68

SM-64

SM-65 SM-66 SM-67

clear system reset-reason

SM-70 SM-72 SM-74

Cisco Nexus 7000 Series NX-OS System Management Command Reference

iv

OL-25806-03

Contents

collect timestamp sys-uptime collect transport tcp flags commit (Call home) configure session contract-id counter customer-id D Commands
SM-85 SM-86 SM-89 SM-91 SM-92 SM-81

SM-77

SM-79

commit (Session Manager)

SM-84

SM-83

description (EEM)

description (NetFlow record) description (NetFlow monitor) description (NetFlow exporter) description (NetFlow sampler) description (SPAN) destination
SM-98 SM-97

SM-93 SM-94 SM-95 SM-96

destination interface (SPAN) destination-profile

SM-101

SM-99

destination-profile alert-group destination-profile email-addr destination-profile format destination-profile http

SM-103 SM-105

SM-107 SM-108 SM-109 SM-110 SM-111

destination-profile message-level destination-profile message-size diagnostic bootup level

SM-112

destination-profile transport-method diagnostic clear result module diagnostic monitor module

SM-113 SM-114

diagnostic monitor interval module

SM-116

diagnostic ondemand action-on-failure diagnostic ondemand iteration diagnostic start diagnostic stop
SM-120 SM-121 SM-122 SM-124 SM-119

SM-118

diagnostic test simulation

diagnostic test simulation clear

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

Contents

distribute dscp

SM-125

SM-127 SM-129 SM-130 SM-131

E Commands erspan-id

ethanalyzer local interface ethanalyzer local read event cli

SM-134 SM-136 SM-138 SM-139 SM-140

SM-133

event counter event fanabsent event fanbad event gold

event manager applet

SM-142 SM-143 SM-144

event manager clear counter event manager environment event manager policy event manager run event module-failure event module status event oir event snmp event syslog event track exporter F Commands feature lldp feature ntp feature ptp
SM-152 SM-154 SM-147 SM-148 SM-150

event manager clear history events

SM-145 SM-146

event policy-default
SM-155

event storm-control
SM-159

SM-158

event temperature
SM-162 SM-164 SM-165

SM-161

SM-166 SM-168

feature netflow

SM-169 SM-171 SM-173 SM-174

feature scheduler filter access-group filter vlan

SM-176

Cisco Nexus 7000 Series NX-OS System Management Command Reference

vi

OL-25806-03

Contents

filter vlan include-untagged flow exporter flow monitor flow record flow timeout H Commands
SM-178 SM-180 SM-183 SM-185 SM-187

SM-177

hw-module logging onboard I Commands ip dscp ip ttl

SM-191 SM-192

SM-188

ip access-list ip flow monitor

SM-197

SM-193 SM-194

L Commands lldp receive lldp reinit lldp timer

SM-199 SM-200 SM-202 SM-204 SM-206 SM-208 SM-210 SM-212 SM-214 SM-216 SM-217

lldp holdtime

lldp tlv-select lldp transmit locator-led logging event logging level logging logfile logging module logging monitor logging server logging console

logging ip access-list cache

SM-219 SM-221

logging message interface type ethernet description

SM-225 SM-227 SM-229 SM-231

SM-223

logging source-interface logging timestamp M Commands match ip

SM-233 SM-234

SM-232

match datalink

SM-236

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

vii

Contents

match ipv4

SM-237 SM-238 SM-240

match (NetFlow) match transport mode

SM-241

monitor counter monitor session mtu

SM-248

SM-242 SM-244

monitor erspan origin ip-address

SM-245

multicast best-effort N Commands ntp abort

SM-253 SM-254

SM-250

ntp access-group ntp authenticate ntp commit ntp distribute ntp enable ntp logging ntp master ntp peer ntp server ntp source

SM-255 SM-257 SM-259

ntp authentication-key
SM-261 SM-262 SM-263 SM-264 SM-266 SM-268 SM-270 SM-272

ntp source-interface ntp sync-retry ntp trusted-key O Commands

SM-273

SM-274 SM-275

SM-277 SM-278 SM-279 SM-280

option exporter-stats timeout option interface-table timeout option sampler-table timeout P Commands
SM-281 SM-282 SM-283 SM-284

port-monitor activate port-monitor enable port-monitor name port-type

SM-285

Cisco Nexus 7000 Series NX-OS System Management Command Reference

viii

OL-25806-03

Contents

poweroff module ptp announce ptp domain ptp priority1 ptp priority2 ptp source ptp vlan R Commands rate-limit record

SM-286 SM-287

power redundancy-mode
SM-289

ptp delay-request minimum interval

SM-293 SM-295

SM-291

ptp pdelay-req-interval
SM-297 SM-298 SM-300

ptp sync interval

SM-304

SM-302

SM-307 SM-308

SM-310 SM-311 SM-312 SM-313 SM-314

record netflow

record netflow ipv4 record netflow ipv6 remote-span rmon alarm rmon event rmon hcalarm role distribute

record netflow-original
SM-315 SM-316 SM-318 SM-320 SM-322

rollback running-config checkpoint S Commands sampler save shut scheduler

SM-325 SM-326

SM-323

SM-328 SM-329

SM-332 SM-333

snmp-server aaa-user cache-timeout snmp-server community snmp-server contact snmp-server context

SM-334 SM-336 SM-337 SM-339

snmp-server enable traps

snmp-server globalEnforcePriv

SM-343

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

ix

Contents

snmp-server host

SM-344 SM-346 SM-347

snmp-server host filter-vrf snmp-server host use-vrf snmp-server location

SM-348 SM-349

snmp-server mib community-map snmp-server protocol enable snmp-server source-interface snmp-server tcp-session snmp-server user snmp-trap source source
SM-358 SM-355

SM-351 SM-352

SM-354

snmp-server user enforcePriv

SM-360 SM-361 SM-363

SM-357

switchport monitor system cores system hap-reset system heartbeat system no hap-reset system no heartbeat system no watchdog system pss shrink

SM-365 SM-367 SM-368 SM-369 SM-370 SM-371

system no standby manual-boot

SM-372

system no watchdog kgdb

SM-374

SM-373

system standby manual-boot system startup-config init system startup-config unlock system switchover system trace system watchdog
SM-380

SM-375

SM-376 SM-377 SM-378

system test-preupgrade running-ver

SM-381 SM-382 SM-383

system watchdog kgdb Show Commands show callhome show cdp

SM-385 SM-386

show callhome transport

SM-390

SM-388

Cisco Nexus 7000 Series NX-OS System Management Command Reference

OL-25806-03

Contents

show cdp neighbors show cfs application show cfs lock show cfs peers show cfs regions show cfs status show checkpoint

SM-392 SM-393

SM-395 SM-397

show cfs merge status

SM-399

SM-401 SM-403 SM-405 SM-407 SM-409

show configuration session show cores

SM-410

show configuration session global-info show diagnostic bootup level

SM-411

show diagnostic content module show diagnostic events show diagnostic result show diagnostic status show diff rollback-patch show environment show environment power
SM-415

SM-412 SM-414

show diagnostic description module show diagnostic ondemand setting

SM-418 SM-420

SM-417

show diagnostic simulation

SM-421 SM-422

SM-423 SM-426 SM-428 SM-429 SM-430

show event manager environment show event manager event-types show event manager history events show event manager policy show event manager script show flow exporter show flow interface show flow monitor show flow record show flow timeout
SM-436 SM-438 SM-440 SM-446 SM-448

SM-431 SM-432

show event manager policy-state show event manager system-policy

SM-433 SM-434

show hardware feature-capability

SM-449

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

xi

Contents

show hardware capacity

SM-450 SM-452 SM-454

show hardware capacity interface show hardware flow aging show hardware flow entry show hardware flow ip show hardware flow sampler show hardware flow utilization show inventory
SM-466 SM-456 SM-458

show hardware capacity fabric-utilization

SM-460 SM-462 SM-464

show lldp dcbx interface ethernet show lldp interface ethernet show lldp neighbors show lldp timers show lldp tlv-select show lldp traffic
SM-471 SM-473 SM-474

SM-468

SM-470

SM-475 SM-476

show lldp traffic interface ethernet show locator-led status show logging console show logging info show logging last show logging level show logging logfile show logging loopback show logging module show logging monitor show logging nvram show logging onboard show logging onboard show logging server show logging status show module show monitor
SM-478 SM-479

SM-480 SM-482

show logging ip access-list cache

SM-483 SM-484 SM-485 SM-486 SM-487 SM-488 SM-489 SM-490 SM-497 SM-499

show logging session status

SM-501

SM-500

show logging timestamp

SM-503 SM-506

SM-502

Cisco Nexus 7000 Series NX-OS System Management Command Reference

xii

OL-25806-03

Contents

show monitor session show ntp access-groups

SM-507 SM-509 SM-510 SM-511

show ntp authentication-keys show ntp authentication-status show ntp internal show ntp peers
SM-512

show ntp logging-status

SM-515

SM-514

show ntp peer-status show ntp pending-diff show ntp pending peers show ntp session status show ntp status show ntp source show ntp statistics show ntp status

SM-516 SM-517 SM-518 SM-519

SM-520 SM-521

show ntp rts-update

SM-522 SM-523

show ntp source-interface

SM-524 SM-525

show ntp trusted-keys show port-monitor

SM-527 SM-528

show platform hardware capacity interface resources

SM-529 SM-531 SM-533

show port-monitor active show port-monitor status show processes

SM-534

show processes cpu show process cpu sort show processes log show ptp brief show ptp clock

SM-536 SM-537

show processes cpu history

SM-541

SM-539

show processes memory

SM-546 SM-548

SM-544

show ptp clocks foreign-masters-record show ptp corrections show ptp parent show ptp port
SM-556 SM-558 SM-552 SM-554

SM-550

show ptp time-property

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

xiii

Contents

show redundancy status show rmon

SM-562

SM-560

show running-config cdp show running-config eem show running-config lldp

SM-564 SM-566

show running-config diagnostic

SM-567 SM-568 SM-569 SM-570

show running-config monitor show running-config netflow show running-config ntp show running-config snmp show sampler show scheduler show snmp
SM-575 SM-576

SM-572 SM-574

SM-578 SM-581 SM-583 SM-584 SM-585 SM-587 SM-589 SM-590

show snmp community show snmp context show snmp engineID show snmp group show snmp host show snmp sessions show snmp trap show snmp user show sprom

show snmp source-interface

SM-591 SM-593

SM-595 SM-598 SM-600

show startup-config cdp show startup-config cfs show startup-config eem

show startup-config diagnostic

SM-601

SM-602 SM-603 SM-604

show startup-config monitor show startup-config netflow show startup-config ntp show startup-config snmp show system cores show system error-id
SM-610 SM-611

SM-606 SM-608

show system memory-status show system pss shrink status

SM-612 SM-613

Cisco Nexus 7000 Series NX-OS System Management Command Reference

xiv

OL-25806-03

Contents

show system pss shrink status details show system reset-reason show system redundancy show system resources show system uptime show tech-support cfs show tech-support snmp show xml server status T Commands tag
SM-631 SM-616 SM-618 SM-620

SM-614

show system standby manual-boot

SM-622 SM-623

SM-621

show tech-support ascii-cfg

SM-625 SM-627

show tech-support session-mgr

SM-629

SM-628

SM-632 SM-634 SM-635

template data timeout test watchdog

SM-636

terminal event-manager bypass transport email mail-server transport http proxy enable transport http proxy server transport http use-vrf transport udp V Commands verify version 5 version 9 vrf
SM-648 SM-651 SM-652 SM-642

SM-637 SM-639 SM-640

SM-641

SM-643

SM-644 SM-645 SM-646

X Commands

xml server max-session xml server timeout xml server validate

xml server terminate session

SM-654 SM-655

SM-653

System Message Logging Facilities

SM-657

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

xv

Contents

Cisco Nexus 7000 Series NX-OS System Management Command Reference

xvi

OL-25806-03

Preface
This preface describes the audience, organization, and conventions of the Cisco Nexus 7000 Series NX-OS System Management Command Reference and how to obtain related documentation. This chapter includes the following sections:

Audience, page xvii Organization, page xvii Document Conventions, page xviii Related Documentation, page xix Documentation Feedback, page xxi Obtaining Documentation and Submitting a Service Request, page xxi

Audience
This publication is for experienced users who configure and maintain Cisco NX-OS devices.

Organization
This reference is organized as follows: Chapter and Title A Commands B Commands C Commands D Commands E Commands Description Describes the Cisco NX-OS system management commands that begin with the letter A. Describes the Cisco NX-OS system management commands that begin with the letter B. Describes the Cisco NX-OS system management commands that begin with the letter C. Describes the Cisco NX-OS system management commands that begin with the letter D. Describes the Cisco NX-OS system management commands that begin with the letter E.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

xvii

Preface

Chapter and Title F Commands H Commands I Commands L Commands N Commands M Commands O Commands P Commands R Commands S Commands

Description Describes the Cisco NX-OS system management commands that begin with the letter F. Describes the Cisco NX-OS system management commands that begin with the letter H. Describes the Cisco NX-OS system management commands that begin with the letter I. Describes the Cisco NX-OS system management commands that begin with the letter L. Describes the Cisco NX-OS system management commands that begin with the letter N. Describes the Cisco NX-OS system management commands that begin with the letter M. Describes the Cisco NX-OS system management commands that begin with the letter O. Describes the Cisco NX-OS system management commands that begin with the letter P. Describes the Cisco NX-OS system management commands that begin with the letter R. Describes the Cisco NX-OS system management commands that begin with the letter S, except for show commands. Describes the Cisco NX-OS system management show commands. Describes the Cisco NX-OS system management commands that begin with the letter T. Describes the Cisco NX-OS system management commands that begin with the letter V. Describes the Cisco NX-OS system management commands that begin with the letter X. Lists the Cisco NX-OS system message logging facilities.

Show Commands T Commands V Commands X Commands System Message Logging Facilities

Document Conventions
Command descriptions use these conventions: Convention boldface font italic font [ ] Description Commands and keywords are in boldface. Arguments for which you supply values are in italics. Elements in square brackets are optional.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

xviii

OL-25806-03

Preface

[x|y|z] string

Optional alternative keywords are grouped in brackets and separated by vertical bars. A nonquoted set of characters. Do not use quotation marks around the string or the string will include the quotation marks.

Screen examples use these conventions:

screen font boldface screen font italic screen font

Terminal sessions and information that the switch displays are in screen font. Information you must enter is in boldface 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.

< > [ ] !, #

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.

Tip

Means the following information will help you solve a problem.

Related Documentation
Cisco NX-OS includes the following documents:

Release Notes
Cisco Nexus 7000 Series NX-OS Release Notes, Release 6.x

NX-OS Configuration Guides

Configuring the Cisco Nexus 2000 Series Fabric Extender Cisco Nexus 7000 Series NX-OS Configuration Examples, Release 5.x Cisco Nexus 7000 Series NX-OS FabricPath Configuration Guide Configuring Feature Set for FabricPath Cisco Nexus 7000 Series NX-OS Fundamentals Configuration Guide, Release 6.x

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

xix

Preface

Cisco Nexus 7000 Series NX-OS High Availability and Redundancy Guide Cisco Nexus 7000 Series NX-OS Interfaces Configuration Guide, Release 6.x Cisco Nexus 7000 Series NX-OS IP SLAs Configuration Guide Cisco Nexus 7000 Series NX-OS Layer 2 Switching Configuration Guide Cisco Nexus 7000 Series NX-OS LISP Configuration Guide Cisco Nexus 7000 Series NX-OS MPLS Configuration Guide Cisco Nexus 7000 Series NX-OS Multicast Routing Configuration Guide Cisco Nexus 7000 Series NX-OS OTV Configuration Guide Cisco Nexus 7000 Series OTV Quick Start Guide Cisco Nexus 7000 Series NX-OS Quality of Service Configuration Guide, Release 6.x Cisco Nexus 7000 Series NX-OS SAN Switching Configuration Guide Cisco Nexus 7000 Series NX-OS Security Configuration Guide, Release 6.x Cisco Nexus 7000 Series NX-OS System Management Configuration Guide, Release 6.x Cisco Nexus 7000 Series NX-OS Unicast Routing Configuration Guide, Release 6.x Cisco Nexus 7000 Series NX-OS Verified Scalability Guide Cisco Nexus 7000 Series NX-OS Virtual Device Context Configuration Guide, Release 5.x Cisco Nexus 7000 Series NX-OS Virtual Device Context Quick Start Cisco NX-OS FCoE Configuration Guide for Cisco Nexus 7000 and Cisco MDS 9500

NX-OS Command References

Cisco Nexus 7000 Series NX-OS Command Reference Master Index Cisco Nexus 7000 Series NX-OS FabricPath Command Reference Cisco Nexus 7000 Series NX-OS Fundamentals Command Reference Cisco Nexus 7000 Series NX-OS High Availability Command Reference Cisco Nexus 7000 Series NX-OS Interfaces Command Reference Cisco Nexus 7000 Series NX-OS IP SLAs Command Reference Cisco Nexus 7000 Series NX-OS Layer 2 Switching Command Reference Cisco Nexus 7000 Series NX-OS LISP Command Reference Cisco Nexus 7000 Series NX-OS MPLS Command Reference Cisco Nexus 7000 Series NX-OS Multicast Routing Command Reference Cisco Nexus 7000 Series NX-OS OTV Command Reference Cisco Nexus 7000 Series NX-OS Quality of Service Command Reference Cisco Nexus 7000 Series NX-OS SAN Switching Command Reference Cisco Nexus 7000 Series NX-OS Security Command Reference Cisco Nexus 7000 Series NX-OS System Management Command Reference Cisco Nexus 7000 Series NX-OS Unicast Routing Command Reference Cisco Nexus 7000 Series NX-OS Virtual Device Context Command Reference Cisco NX-OS FCoE Command Reference for Cisco Nexus 7000 and Cisco MDS 9500

Cisco Nexus 7000 Series NX-OS System Management Command Reference

xx

OL-25806-03

Preface

Other Software Documents

Cisco NX-OS Licensing Guide Cisco Nexus 7000 Series NX-OS MIB Quick Reference Cisco Nexus 7000 Series NX-OS Software Upgrade and Downgrade Guide, Release 6.x Cisco NX-OS System Messages Reference Cisco Nexus 7000 Series NX-OS Troubleshooting Guide Cisco NX-OS XML Interface User Guide

Documentation Feedback
To provide technical feedback on this document, or to report an error or omission, please send your comments to [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 Whats New in Cisco Product Documentation at: http://www.cisco.com/en/US/docs/general/whatsnew/whatsnew.html. Subscribe to Whats New in Cisco Product Documentation, which lists all new and revised Cisco technical documentation, as an RSS feed and deliver content directly to your desktop using a reader application. The RSS feeds are a free service.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

xxi

Preface

Cisco Nexus 7000 Series NX-OS System Management Command Reference

xxii

OL-25806-03

New and Changed Information

This chapter provides release-specific information for each new and changed feature in the Cisco Nexus 7000 Series 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/docs/switches/datacenter/sw/6_0/nx-os/system_management/command/r eference/sm_nx_os_book.html To check for additional information about Cisco NX-OS Release 6.0, see the Cisco NX-OS Release Notes available at the following Cisco website: http://www.cisco.com/en/US/docs/switches/datacenter/sw/6_0/nx-os/release/notes/6x_nx-os_release_n ote.html Table 1 summarizes the new and changed features for the Cisco Nexus 7000 Series NX-OS System Management Command Reference, and tells you where they are documented.
Table 1 New and Changed Features for Release 6.x

Feature BloggerD

Description This command was introduced. This command was introduced. This command was introduced.

Changed in Release Where Documented 6.2(2) 6.2(2) 6.2(2) 6.2(2) bloggerd log-dump bloggerd log-transfer bloggerd parse log-buffer xmlin

Converting CLI Commands to Network Configuration Format NTP

This command was introduced.

Added the match-all keyword to the ntp access-group command. This command was introduced. This command was introduced. This command was introduced. This command was introduced. This command was introduced. This command was introduced.

6.2(2) 6.2(2) 6.2(2) 6.2(2) 6.2(2) 6.2(2) 6.2(2) 6.2(2) 6.2(2)

ntp access-group ntp broadcast ntp broadcastdelay ntp disable ntp multicast ntp multicast client ntp passive filter (ERSPAN) filter (SPAN)

SPAN

This command was introduced. This command was introduced.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

xxiii

New and Changed Information

Table 1

New and Changed Features for Release 6.x (continued)

Feature

Description This command was introduced. This command was introduced. This command was introduced. This command was introduced. This command was introduced. Added support for F2e Series modules with 100 microseconds and 100 nanoseconds granularity. Added the rx, tx, and shut keywords to the monitor session command. This command was introduced. This command was introduced. This command was introduced.

Changed in Release Where Documented 6.2(2) 6.2(2) 6.2(2) 6.2(2) 6.2(2) 6.2(2) 6.2(2) 6.2(2) 6.2(2) 6.2(2) 6.2(2) filter frame-type arp filter frame-type eth filter frame-type fcoe filter frame-type ipv6 mode extended monitor erspan granularity monitor session show resource monitor-session show resource monitor-session-extended source exception show cores show process cpu sort show processes memory show tech-support all binary flow timeout show interface ethernet capabilities show interface ethernet show interface ethernet counter detailed power efficient-ethernet header-type monitor erspan granularity mtu sampling show flow timeout ptp source show monitor session

System Cores

This command was introduced.

Added the 5sec, 1min, and 5min keywords to the 6.2(2) show cpu processes sort command. Added the sort keyword to the show processes memory command. Troubleshooting Features This command was introduced. flow timeout Added the seconds argument for the syntax description and also the note. 6.2(2) 6.2(2) 6.1(2) 6.1(2) 6.1(2) 6.1(2) 6.1(2) 6.1(1) 6.1(1) 6.1(1) 6.1(1) 6.1(1) 6.1(1) 6.1(1)

Energy Efficient Ethernet This command was introduced. This command was introduced. This command was introduced. This command was introduced. header-type monitor erspan granularity mtu sampling show flow timeout ptp source show monitor session This command was introduced. This command was introduced. Starting with 6.1, MTU truncation also support ERSPAN session. This command was introduced. Changed the command output. vrf option is deprecated in Cisco NX-OS 6.1(1) release. Changed the command output for erspan-source sessions.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

xxiv

OL-25806-03

New and Changed Information

Table 1

New and Changed Features for Release 6.x (continued)

Feature NetFlow hardware Flexible Netflow Callhome

Description The show hardware ip command has been changed to the show hardware flow command.

Changed in Release Where Documented 6.0(1) show hardware flow show flow sw-monitor transport http proxy enable transport http proxy server tag logging message interface type ethernet description feature ntp ntp master

The show flow monitor command has been 6.0(1) changed to the show flow-sw monitor command. Added the ability to send HTTP messages through an HTTP proxy server. Added support for multiple event triggers in a single EEM policy. Added the ability to support descriptions for physical Ethernet interfaces and subinterfaces in the system message log. Changed the [no] ntp enable command to the [no] feature ntp command. Added the ability to configure the device as the NTP authoritative server, enabling it to distribute time even if it is not synchronized to an existing time server. 5.2(1)

EEM event correlation Logging

5.2(1) 5.2(1)

Network Time Protocol

5.2(1)

Precision Time Protocol

Added support for PTP is a time synchronization 5.2(1) protocol nodes distributed across a network. This protocol provides greater accuracy than other time synchronization protocols.

feature ptp ptp announce ptp delay-request minimum interval ptp domain ptp priority1 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 mtu multicast best-effort rate-limit

SPAN Monitor

Added the ability to configure MTU truncation, 5.2(1) the source rate limit, and the multicast best effort mode for each SPAN session and the ability to configure MTU truncation and the multicast best effort mode for each ERSPAN session.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

xxv

New and Changed Information

Table 1

New and Changed Features for Release 6.x (continued)

Feature Encapsulated Remote Switched Port Analyzer (ERSPAN)

Description

Changed in Release Where Documented erspan-id filter access-group ip access-list ip dscp ip ttl monitor erspan origin ip-address monitor erspan granularity vrf A Commands Show Commands A Commands Show Commands D Commands C Commands C Commands A Commands Show Commands T Commands

You can now configure and monitor ERSPAN for 5.1(1) analyzing traffic between ports.

AAA MSCHAP V2 authentication AAA accounting log 802.1x authentication RADIUS statistics TACACS+ statistics TACACS+ command authorization

Added the mschapv2 keyword to the aaa authentication login default and show authentication commands.

4.2(1)

Added the last-index and start-seqnum 4.2(1) keywords to the show accounting log command. Added the dot1x pae authenticator command. Added the clear radius-server statistics command. Added the clear tacacs-server statistics command. Added the following commands to support TACACS+ command authorication:

4.2(1) 4.2(1) 4.2(1) 4.2(1)

aaa test authorization command-type show aaa authorization tacacs-server authorization command login default tacacs-server authorization config-command login default terminal verify-only 4.2(1)

Port Security

Changed the following commands to support support port security on port-channel interfaces:

C Commands S Commands

clear port-security switchport port-security switchport port-security aging time switchport port-security aging type switchport port-security mac-address switchport port-security mac-address sticky switchport port-security maximum switchport port-security violation

Cisco Nexus 7000 Series NX-OS System Management Command Reference

xxvi

OL-25806-03

New and Changed Information

Table 1

New and Changed Features for Release 6.x (continued)

Feature IP ACLs

Description

Changed in Release Where Documented F Commands

Added the fragments command to support 4.2(1) optimization of fragment handling during IP ACL processing. Added or changed the following commands to support MAC packet classification:

MAC ACLs

4.2(1)

I Commands M Commands

ip port access-group ipv6 port traffic-filter mac packet-classify 4.1(2) abort (Call home) cfs distribute cfs ipv4 cfs ipv4 cfs region commit (Call home) distribute show cfs application show cfs lock show cfs merge status show cfs peers show cfs regions show cfs status show tech-support cfs switchport monitor

Cisco Fabric Services

Cisco Fabric Services (CFS) distributes data, including configuration changes, to all Cisco NX-OS devices in a network.

Ethernet Switched Port Analyzer

Cisco Ethernet Switched Port Analyzer (SPAN) destinations are enhanced to support intrusion detection by allowing the following:

4.1(2)

Injecting packets to disrupt a TCP packet stream. Enabling a forwarding engine to learn the MAC address of the IDS. abort (Call home) cfs distribute cfs ipv4 cfs region commit (Call home) distribute show cfs application show cfs lock show cfs merge status show cfs peers show cfs regions show cfs status show tech-support cfs

Call Home

Call Home is enhanced to support the distribution 4.1(2) of configurations using CFS.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

xxvii

New and Changed Information

Table 1

New and Changed Features for Release 6.x (continued)

Feature Locator LEDs Online diagnostics (GOLD)

Description

Changed in Release Where Documented locator-led show locator-led status show diagnostic events show module

Locator LEDs can be configured to blink to help 4.1(2) locate them on the system. Cisco online diagnostics are enhanced to provide 4.1(2) viewing of events, and to display diagnostic information in the output of the show module command. Syslog facilities are updated to include: AMT, CFS, DCBX, LISP, Routing IPv6 Multicast, and Routing Multicast. Added the ntp enable command. Adds commands to view hardware fabric utilization. 4.1(2)

Syslog

System Message Logging Facilities

NTP New show hardware fabric-utilization commands SNMP SNMPMultiple Instance Support

4.0(3) 4.0(3)

N Commands Show Commands

Added the snmp-server aaa-user cache-timeout 4.0(3) and snmp-server protocol commands. Adds commands for SNMP context to logical network entity mapping, including protocol instances and virtual routing and forwarding (VRF) instances. Adds commands to view NetFlow hardware flows. 4.0(2)

S Commands S Commands

New NetFlow show commands

4.0(2)

Show Commands

Cisco Nexus 7000 Series NX-OS System Management Command Reference

xxviii

OL-25806-03

A Commands
This chapter describes the Cisco NX-OS system management commands that begin with the letter A.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

A Commands abort (Call home)

abort (Call home)

To delete a Call home Cisco Fabric Services (CFS) configuration session without applying the configuration, use the abort command. abort

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Call home configuration

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.1(2)

Modification This command was introduced.

Usage Guidelines

The abort command is supported only on the device where the CFS fabric lock is acquired. This command does not require a license.

Examples

This example shows how to abort a Call home CFS configuration session:
switch(config-callhome)# abort switch(config-callhome)# show callhome session status Last Action Time Stamp : Mon Dec 22 17:34:37 2008 Last Action : Abort Last Action Result : Success Last Action Failure Reason : none

Related Commands

Command show session status callhome callhome distribute

Description Displays the status of the current CFS configuration session, including the last action and its result. Enters the Call home configuration mode. Enables CFS distribution of the Call home configuration.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

OL-25806-03

A Commands abort (Session Manager)

abort (Session Manager)

To delete a Session Manager configuration session without applying the configuration, use the abort command. abort

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Session configuration

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to abort a Session Manager configuration session and show the aborted session:
switch(config-s-acl)# abort switch# show configuration session ACL_permit_tcp ERROR: Session not found switch# show configuration session summary There are no active configuration sessions

Related Commands

Command show configuration session show configuration session summary

Description Displays the status of the current CFS configuration session, including the last action and its result. Displays a summary of the configuration session.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

A Commands action cli

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 cli [local] vsh_cmd no action label cli

Syntax Description

label

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. If the string contains embedded blanks, enclose it in double quotation marks. (Optional) Specifies the action is to be executed in the same module on which the event occurs. VSH command string to be executed when the applet is triggered.

local vsh_cmd

Defaults

None

Command Modes

Embedded event manager

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

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 callhome send eem subject "port down" body "acme port is down" switch(config-applet)#

Related Commands

Command event manager applet

Description Registers an applet with the Embedded Event Manager (EEM).

Cisco Nexus 7000 Series NX-OS System Management Command Reference

OL-25806-03

A Commands action counter

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 counter name name value value op {dec | inc | nop | set} no action label counter name name

Syntax Description

label

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. If the string contains embedded blanks, enclose it in double quotation marks. Specifies the name of the counter. This identifier can be any string value. Specifies the value of the counter. This identifier must be an integer value in the range from 2147483648 to 2147483647 inclusive, or a $-prefixed name (for parameter substitution). Specifies the operation to perform upon the counter. Decrements the counter by the specified value. Increments the counter by the specified value. Does nothing, using this keyword just displays the specified value. Sets the counter to the specified value.

name name value value

op dec inc nop set

Defaults

None

Command Modes

Embedded event manager

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

A Commands action counter

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)#

Cisco Nexus 7000 Series NX-OS System Management Command Reference

OL-25806-03

A Commands action event-default

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 event-default no action label event-default

Syntax Description

label

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. If the string contains embedded blanks, enclose it in double quotation marks.

Defaults

None

Command Modes

Embedded event manager

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

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.15 event-default switch(config-applet)#

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

A Commands action exceptionlog

action exceptionlog
To log an exception if the specific conditions are encountered when an Embedded Event Manager (EEM) applet is triggered, use the action exceptionlog command. To remove the exception log, use the no form of this command. action label exceptionlog module module syserr error devid id errtype type errcode code phylayer layer ports list harderror error [desc string] no action label exceptionlog module module syserr error devid id errtype type errcode code phylayer layer ports list harderror error [desc string]

Syntax Description

label

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. If the string contains embedded blanks, enclose it in double quotation marks. Records an exception for the specified module number. Records an exception for the specified system error. Records an exception for the specified device ID. Records an exception for the specified error type. Records an exception for the specified error code. Records an exception for the specified physical layer. Records an exception for the specified ports. Records an exception for the specified hard error. (Optional) Specifies a description of the exception logging condition.

module module syserr error devid id errtype type errcode code phylayer layer ports list harderror error desc string

Defaults

None

Command Modes

Embedded event manager

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

OL-25806-03

A Commands action exceptionlog

Examples

This example shows how to log an EEM applet exception:

switch# configure terminal switch(config)# event manager applet exception-applet switch(config-applet)# action 1.2 exceptionlog module 1 syserr 0x41150010 devid 96 errtype 2 errcode 354 phylayer 0 ports 1-24 harderror false desc "r2d2 general error switch(config-applet)#

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

A Commands action forceshut

action forceshut
To configure a forced shutdown of a module, a crossbar ASIC, or the entire switch when an Embedded Event Manager (EEM) applet is triggered, use the action forceshut command. To remove the forced shutdown, use the no form of this command. action label forceshut [{module module | xbar xbar-number}] reset-reason string no action label forceshut [{module module | xbar xbar-number}] reset-reason string

Syntax Description

label

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. If the string contains embedded blanks, enclose it in double quotation marks. (Optional) Forces a shutdown of the specified module. The module range is from 1 to 10. (Optional) Forces a shutdown of the specified crossbar ASIC. The ASIC range is from 1 to 5.

module module xbar xbar-number

reset-reason string Provides a string that is enclosed in double quotation marks to explain the reason for a forced shutdown.

Defaults

None

Command Modes

Embedded event manager

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure a forced shutdown of module 4 when an EEM applet is triggered:
switch# configure terminal switch(config)# event manager applet forceshut-applet switch(config-applet)# action 1.3 forceshut module 4 reset-reason module 4 failed switch(config-applet)#

Cisco Nexus 7000 Series NX-OS System Management Command Reference

10

OL-25806-03

A Commands action overbudgetshut

action overbudgetshut
To configure the shutdown of a module or the entire switch due to an overbudget power condition when an Embedded Event Manager (EEM) applet is triggered, use the action overbudgetshut command. To remove the shutdown configuration, use the no form of this command. action label overbudgetshut [module module] no action label overbudgetshut [module module]

Syntax Description

label

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. If the string contains embedded blanks, enclose it in double quotation marks. (Optional) Forces a shutdown of the specified module. For 9slot : The range is from 1 to 9. For 10slot : The range is from 1 to 10. For 18slot : The range is from 1 to 18.

module module

Defaults

None (The default action is to powerdown just the linecards starting from slot_1 till the switch recovers from overbudget condition. In other words, skip both the supervisors (active and standby) and skip all spine/xbars, powerdown lcs starting from slot 1 onwards, till the "Available" power recovers from overbudget condition).

Command Modes

Embedded event manager

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

11

A Commands action overbudgetshut

Examples

This example shows how to configure a power overbudget shutdown of module 4 when an EEM applet is triggered:
switch# configure terminal switch(config)# event manager applet overbudget-applet switch(config-applet)# action 1.4 overbudgetshut module 4 switch(config-applet)#

Cisco Nexus 7000 Series NX-OS System Management Command Reference

12

OL-25806-03

A Commands action policy-default

action policy-default
To enable the default action(s) 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 policy-default no action label policy-default

Syntax Description

label

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. If the string contains embedded blanks, enclose it in double quotation marks.

Defaults

None

Command Modes

Embedded event manager

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

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.65 policy-default switch(config-applet)#

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

13

A Commands action reload

action reload
To specify the action of reloading the switch software when an Embedded Event Manager (EEM) applet is triggered, use the action reload command. To remove the action of reloading the switch software, use the no form of this command. action label reload no action label reload

Syntax Description

label

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. If the string contains embedded blanks, enclose it in double quotation marks.

Defaults

None

Command Modes

Embedded event manager

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to specify the action of reloading the switch software when an EEM applet is triggered:
switch# configure terminal switch(config)# event manager applet reload-applet switch(config-applet)# action 1.5 reload switch(config-applet)#

Cisco Nexus 7000 Series NX-OS System Management Command Reference

14

OL-25806-03

A Commands action snmp-trap

action snmp-trap
To specify the generation of a Simple Network Management Protocol (SNMP) trap when an Embedded Event Manager (EEM) applet is triggered, use the action snmp-trap command. To disable the SNMP trap, use the no form of this command. action label snmp-trap [intdata1 integer] [intdata2 integer] [strdata string] no action label snmp-trap [intdata1 integer] [intdata2 integer] [strdata string]

Syntax Description

label

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. If the string contains embedded blanks, enclose it in double quotation marks. (Optional) Specifies an integer to be sent in the SNMP trap message to the SNMP agent. (Optional) Specifies a second integer to be sent in the SNMP trap message to the SNMP agent. (Optional) Specifies a string to be sent in the SNMP trap message to the SNMP agent. If the string contains embedded blanks, enclose it in double quotation marks.

intdata1 integer intdata2 integer strdata string

Defaults

None

Command Modes

Embedded event manager

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to specify an SNMP trap to generate when an EEM applet is triggered:
switch# configure terminal switch(config)# event manager applet snmp-applet switch(config-applet)# action 1.7 snmp-trap strdata "EEM detected server failure" switch(config-applet)#

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

15

A Commands action syslog

action syslog
To configure a syslog message to generate when an Embedded Event Manager (EEM) applet is triggered, use the action syslog command. To disable the syslog message, use the no form of this command. action label syslog [priority {prio | prio-str}] msg msg-text no action label syslog [priority {prio | prio-str}] msg msg-text

Syntax Description

label

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. If the string contains embedded blanks, enclose it in double quotation marks. (Optional) Specifies the priority level of the syslog messages. If this keyword is not selected, all syslog messages are set at the informational priority level. If this keyword is selected, the priority level argument must be defined. Priority level:

priority

prio

emergenciesSpecifies the system is unusable. alertsSpecifies immediate action is needed. criticalSpecifies critical conditions. errorsSpecifies error conditions. warnings Specifies warning conditions. notificationsSpecifies normal but significant conditions. informationalSpecifies informational messages. This is the default. debuggingSpecifies debugging messages.

prio-str msg msg-text

A $-prefixed parameter that you previously set to a priority level. Specifies the message to be logged. The msg-text can contain character text, an environment variable, or a combination of the two. If the string contains embedded blanks, enclose it in double quotation marks.

Defaults

None

Command Modes

Embedded event manager

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

16

OL-25806-03

A Commands action syslog

Usage Guidelines

Messages written to syslog from an EEM applet are not screened for EEM syslog events, which may lead to recursive EEM syslog events. Messages that are sent from an EEM applet include the applet name for identification. This command does not require a license.

Examples

This example shows how to configure a syslog message to save when an EEM applet is triggered:
switch# configure terminal switch(config)# event manager applet syslog-applet switch(config-applet)# action 1.7 syslog priority critical msg "Syslog condition: $log" switch(config-applet)#

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

17

A Commands alert-group

alert-group
To configure a Call home CLI command for an alert group, use the alert-group command. To remove the command from the alert group, use the no form of this command. alert-group {All | Configuration | Diagnostic | EEM |Environmental | Inventory | License | Linecard-Hardware | Supervisor-Hardware | Syslog-group-port | System | Test} user-def-cmd cli_command no alert-group {All | Configuration | Diagnostic | Environmental | Inventory | License | Linecard-Hardware | Supervisor-Hardware | Syslog-group-port | System | Test} user-def-cmd cli_command

Syntax Description

All

Specifies all alert groupsconfiguration, diagnostic, EEM, environmental, inventory, license, linecard-hardware, supervisor-hardware, syslog-group-port, system, and test. Specifies events related to configurations. Specifies events related to diagnostics. Specifies events related to EEM. Specifies events related to the inventory status. Specifies events related to license. Specifies events related to line card hardware. Specifies events related to the supervisor module. Specifies events related to syslog messages filed by port manager. Specifies events related to software. Specifies events related to tests. Configures a valid CLI command for the alert group.

Configuration Diagnostic EEM Inventory License LinecardHardware SupervisorHardware Syslog-groupport System Test user-def-cmd cli_command

Environmental Specifies events related to power,fan,temperature related events.

Defaults

None

Command Modes

Call home configuration

SupportedUserRoles

network-admin vdc-admin

Cisco Nexus 7000 Series NX-OS System Management Command Reference

18

OL-25806-03

A Commands alert-group

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to add the show ip routing command to the configuration alert group:
switch# config t switch(config)# callhome switch(config-callhome)# alert-group Configuration user-def-cmd show ip routing

Related Commands

Command callhome callhome distribute show callhome destination-profile name

Description Enters the Call home configuration mode. Enables CFS distribution of the Call home configuration. Displays one or more Call home destination profiles.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

19

A Commands alert-group

Cisco Nexus 7000 Series NX-OS System Management Command Reference

20

OL-25806-03

B Commands
This chapter describes the Cisco NX-OS system management commands that begin with the letter B.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

21

B Commands blink

blink
To blink the LED on the system, use the blink command. To restore the default LED state, use the no form of this command.

Note

Beginning with Cisco NX-OS Release 4.1(2), the blink command is not available in Cisco NX-OS software. Use the locator-led command for this function. blink {chassis | fan f-number | module slot | powersupply ps-number | xbar x-number} no blink {chassis | fan f-number | module slot | powersupply ps-number | xbar x-number}

Syntax Description

chassis fan f-number module slot powersupply ps-number xbar x-number

Blinks the chassis LED. Blinks the LED that represents the configured fan number. The range depends on the platform. Use ? to see the range. Blinks the module LED. The range depends on the platform. Use ? to see the range. Blinks the power supply LED. The range depends on the platform. Use ? to see the range. Blinks the xbar module LED. The range depends on the platform. Use ? to see the range.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

Use the blink command to flash the LED on a component in the system. You can use this blinking LED to identify the component to an administrator in the data center. This command does not require a license.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

22

OL-25806-03

B Commands blink

Examples

This example blinks the LED for module 4:

switch# blink module 4

Related Commands

Command

Description

show locator-led status Displays the status of locator LEDs on the system.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

23

B Commands bloggerd log-dump

bloggerd log-dump
To enable threshold-based log dumps on a per application, per virtual device context (VDC), per module, or on a switch-wide basis, use the bloggerd log-dump command. To disable threshold-based log dumps, use the no form of this command. bloggerd log-dump {all | module module-number sap sap-number [vdc vdc-number | vdc-all] | sap sap-number [vdc vdc-number | vdc-all]} no bloggerd log-dump {all | module module-number sap sap-number [vdc vdc-number | vdc-all] | sap sap-number [vdc vdc-number | vdc-all]}

Syntax Description

all module module-number sap sap-number

Enables a log dump for all services across all modules on the device. Enables a log dump for the specific module. The range for the module number argument is from1 to 18. Enables a log dump for a specific Service Access Point (SAP). The range for the sap-number argument is from 0 to 65536. A value of 0 enables a log dump of all SAPs. (Optional) Enables a log dump for the specific VDC. The range for the vdc-number argument is from 1 to 5. (Optional) Enables a log dump for the SAP on all VDCs on the device.

vdc vdc-number vdc-all

Defaults

A threshold-based log dump is enabled for the default VDC.

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 6.2(2)

Modification This command was introduced.

Usage Guidelines

You can use the bloggerd log-dump command to prevent application logs from rolling over and becoming lost. You can enable threshold-based log dumps on a per application, per VDC, per module, or on a switch-wide basis to ensure that application logs are saved into files just before a rollover. Once the logs are dumped, you can configure them to be transferred to a more persistent location (either an external log server or to the active supervisor modules logflash device) using the bloggerd log transfer command. All collected logs are in binary format and must be parsed into ASCII format using DeBlogger.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

24

OL-25806-03

B Commands bloggerd log-dump

Note

We recommend that you use BloggerD only with TAC supervision. This command does not require a license.

Examples

This example shows how to enable threshold-based log dumps on a device-wide basis:
switch(config)# bloggerd log-dump all Sending Enable Request to Bloggerd Bloggerd Log Dump Successfuly enabled

Related Commands

Command bloggerd log-transfer bloggerd parse log-buffer

Description Enables the transfer of application logs. Parses the log buffers using DeBlogger.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

25

B Commands bloggerd log-transfer

bloggerd log-transfer
To enable the transfer of application logs to an external log server or a logflash device, use the bloggerd log-transfer command. To disable the transfer of application logs, use the no form of this command. bloggerd log-transfer {ip-address tftp-path-name | logflash} no bloggerd log-transfer

Syntax Description

ip-address tftp-path-name logflash

IP address of the logging server. Name of the TFTP server path. Enables all log files to be transferred to to the active supervisor module's logflash device.

Defaults

None

Command Modes

Global configuration mode (config)

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 6.2(2)

Modification This command was introduced.

Usage Guidelines

The bloggerd log-transfer command allows you to configure the transfer of application logs to a more persistent location (either an external log server or to the active supervisor modules logflash device). All collected logs are in binary format and must be parsed into ASCII format using DeBlogger.

Note

We recommend that you use BloggerD only with TAC supervision. This command does not require a license.

Examples

This example shows how to enable a log dump and transfer of log files on the device:
switch(config)# bloggerd log-dump all Sending Enable Request to Bloggerd Bloggerd Log Dump Successfuly enabled switch(config)# bloggerd log-transfer 10.10.10.1 /cisco_blogger/

Cisco Nexus 7000 Series NX-OS System Management Command Reference

26

OL-25806-03

B Commands bloggerd log-transfer

Related Commands

Command bloggerd log-dump bloggerd parse log-buffer

Description Enables threshold-based log dumps. Parses the log buffers using DeBlogger.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

27

B Commands bloggerd parse log-buffer

bloggerd parse log-buffer

To parse the log buffers from binary format to ASCII format using DeBlogger, use the bloggerd parse log-buffer command. bloggerd parse log-buffer {directory directory-path | file file-name}

Syntax Description

directory directory-path file file-name

Specifies the directory path of file to be parsed by DeBlogger. Specifies the filename of file to be parsed by DeBlogger.

Defaults

A threshold-based log dump is enabled for the default VDC.

Command Modes

Global configuration mode (config)

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 6.2(2)

Modification This command was introduced.

Usage Guidelines

DeBlogger is an external parsing framework that converts binary data into ASCII format by linking with the necessary application libraries. You can use the bloggerd parse log-buffer command to parse logs from binary to ASCII format.

Note

We recommend that you use BloggerD only with TAC supervision. This command does not require a license.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

28

OL-25806-03

B Commands bloggerd parse log-buffer

Examples

This example shows how to parse binary logs to ASCII format on the device:
switch# bloggerd parse log-buffer directory /tmp/blogger/ Parsing file: /tmp/blogger//module-5_vdc-1_spm_binary_sdwrap_app_uuid_404_inst_1 _type_0_06_15_2013_00:42:56 *************************************************************** =========================================================== META DATA: =========================================================== Log Data Type: SDWRAP_LOG_DATA_TYPE_EVENT_HISTORY Module Number: 5 VDC ID: 1 APP UUID: 0 Buffer UUID: 404 Buffer Instance: 1

Related Commands

Command bloggerd log-dump bloggerd log-transfer

Description Enables threshold-based log dumps. Enables the transfer of application logs.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

29

B Commands bloggerd parse log-buffer

Cisco Nexus 7000 Series NX-OS System Management Command Reference

30

OL-25806-03

C Commands
This chapter describes the Cisco NX-OS system management commands that begin with the letter C.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

31

C Commands callhome

callhome
To enter the CLI Call home configuration mode, use the callhome command. callhome

Syntax Description

This command has no arguments or keywords.

Defaults

Disabled

Command Modes

Global configuration mode

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to enter the Call home configuration mode:
switch(config)# callhome switch(config-callhome)#

Related Commands

snmp-server contact email-contact phone-contact streetaddress contract-id customer-id site-id switch-priority destination-profile enable callhome test

Specifies or modifies the snmp-server contact name for Call home. Specifies the e-mail address of the person responsible for the device. Specifies the phone number of the person responsible for the device. Specifies the street address of the person responsible for the device. Specifies the service agreement contract number for this device. Specifies the service agreement customer number for this device. Specifies the site ID number for this device. Specifies the priority number for this device. Creates and configures a Call home destination profile. Enables Call home. By default, Call home is disabled. Sends a test message to all configured destinations.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

32

OL-25806-03

C Commands callhome

callhome send show callhome

Sends the specified Call home test message to all configured destinations. Displays the Call home configuration.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

33

C Commands callhome send

callhome send
To send a Call home message to all configured destinations, use the callhome send command. callhome send [configuration | diagnostic]

Syntax Description

configuration diagnostic

(Optional) Sends a configuration message. (Optional) Sends a diagnostic message.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to send a Call home configuration message:

switch(config)# callhome send configuration trying to send configuration callhome message switch(config)#

Related Commands

Command callhome callhome test show callhome

Description Enters the Call home configuration mode. Sends a test message to all configured Call home destinations. Displays the Call home configuration.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

34

OL-25806-03

C Commands callhome test

callhome test
To send a test message to all configured Call home destinations, use the callhome test command. callhome test {inventory}

Syntax Description

inventory

Sends a dummy callhome inventory to all configured Call home destinations.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to send a Call home test message:

switch(config)# callhome test trying to send test callhome message switch(config)#

Related Commands

Command callhome callhome send show callhome

Description Enters the Call home configuration mode. Sends a configuration or diagnostic message to all configured Call home destinations. Displays the Call home configuration.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

35

C Commands cdp advertise

cdp advertise
To configure the Cisco Discovery Protocol (CDP) version supported by the device, use the cdp advertise command. To remove the CDP configuration, use the no form of this command. cdp advertise {v1 | v2} no cdp advertise [v1 | v2]

Syntax Description

v1 v2

Specifies CDP Version 1. Specifies CDP Version 2.

Defaults

None

Command Modes

Global configuration mode (config) if-ethernet-all configuration (config-if-ethernet-all) if-gig-ether configuration (config-if-gig-ether) if-eth-base (config-if-eth-base) if-mgmt-ether (config-if-mgmt-ether)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure the CDP version:

switch(config)# cdp advertise v2 switch(config)

This example shows how to remove the CDP configuration:

switch(config)# no cdp advertise v2 switch(config)

Related Commands

Command cdp enable

Description Enables CDP on an interface.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

36

OL-25806-03

C Commands cdp enable

cdp enable
To enable Cisco Discovery Protocol (CDP) on an interface, use the cdp enable command. To disable CDP, use the no form of this command. cdp enable no cdp enable

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Global configuration mode (config)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to enable CDP on an interface:

switch(config)# enable cdp switch(config)#

This example shows how to disable CDP on an interface:

switch(config)# no cdp enable

Related Commands

Command cdp advertise

Description Configures the CDP version supported by the device.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

37

C Commands cdp format device-id

cdp format device-id

To configure a device ID format for Cisco Discovery Protocol (CDP), use the cdp format device-id command. To remove the device ID format, use the no form of this command. cdp format device-id {mac-address | serial-number | system-name} no cdp format device-id {mac-address | serial-number | system-name}

Syntax Description

mac-address serial-number system-name

Specifies the MAC-address of the chassis. Specifies the chassis serial number or Organizationally Unique Identifier (OUI). Specifies the system name. The default is fully qualified domain name.

Defaults

None

Command Modes

Global configuration mode (config)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure a device ID format for CDP:

switch(config)# cdp format device-id mac-address switch(config)#

This example shows how to remove the device ID format:

switch(config)# no cdp format device-id mac-address switch(config)#

Related Commands

Command cdp enable

Description Configures a device ID format for CDP.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

38

OL-25806-03

C Commands cdp holdtime

cdp holdtime
To configure the time that Cisco Discovery Protocol (CDP) holds onto neighbor information before refreshing it, use the cdp holdtime command. To remove the CDP hold time, use the no form of this command. cdp holdtime seconds no cdp holdtime seconds

Syntax Description

seconds

Hold time in seconds. The range is from 10 to 255.

Defaults

None

Command Modes

Global configuration mode (config)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure a time that CDP holds onto neighbor information:
switch(config)# cdp holdtime 30 switch(config)#

This example shows how to remove the CDP hold time:

switch(config)# no cdp holdtime 30 switch(config)#

Related Commands

Command cdp timer

Description Configures the CDP refresh time interval.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

39

C Commands cdp timer

cdp timer
To configure the Cisco Discovery Protocol (CDP) refresh time interval, use the cdp timer command. To remove the CDP refresh time interval configuration, use the no form of this command. cdp timer seconds no cdp timer seconds

Syntax Description

seconds

Time interval in seconds. The range is from 5 to 254.

Defaults

None

Command Modes

Global configuration mode (config)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure the CDP refresh time interval:
switch(config)# cdp timer 45 switch(config)#

This example shows how to remove the CDP refresh time interval:
switch(config)# no cdp timer 45 switch(config)#

Related Commands

Command cdp holdtime

Description Configures the time that CDP holds onto neighbor information before refreshing it.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

40

OL-25806-03

C Commands cfs distribute

cfs distribute
To globally enable Cisco Fabric Services (CFS) distribution for the device, use the cfs distribute command. To disable CFS distribution, use the no form of this command. To remove the CFS configuration, use the no form of this command. cfs distribute no cfs distribute

Syntax Description

This command has no arguments or keywords.

Defaults

Enabled

Command Modes

Global configuration mode

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.1(2)

Modification This command was introduced.

Usage Guidelines

This command does not require a license. In order to distribute configuration information, CFS distribution must be enabled for both the device and the application. CFS is enabled by default for the device. All devices in the fabric must have CFS enabled or they do not receive distributions. If CFS distribution is disabled for an application, that application does not distribute any configuration and it does not accept a distribution from other devices in the fabric.

Examples

This example shows how to enable CFS distribution:

switch(config)# cfs distribute

Related Commands

show cfs status role distribute

Displays the CFS distribution status. Enables CFS to distribute role configurations.

show application_name Displays the status of the specified application, including whether CFS status distribution is enabled for the application. cfs region Specifies a region for limiting the CFS distribution scope.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

41

C Commands cfs eth

cfs eth
To globally configure the device to use Ethernet to distribute changes for all Cisco Fabric Services (CFS)-enabled applications, use the cfs eth command. To remove the CFS configuration, use the no form of this command. cfs eth {distribute} no cfs eth distribute

Syntax Description

distribute

Enables CFS distribution over Ethernet.

Defaults

None

Command Modes

Global configuration mode (config)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.1(2)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure the device to use Ethernet to distribute changes for all CFS-enabled applications:
switch(config)# cfs eth distribute switch(config)#

This example shows how to remove the CFS configuration:

switch(config)# no cfs eth distribute This will prevent CFS from distributing over Ethernet network. Are you sure? (y/n) n switch(config)#

Related Commands

Command cfs distribute show cfs status

Description Globally enables CFS distribution for the device. Displays the CFS distribution status.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

42

OL-25806-03

C Commands cfs ipv4

cfs ipv4
To globally configure the device to use IPv4 to distribute changes for all Cisco Fabric Services (CFS)-enabled applications, use the cfs ipv4 command. To remove the CFS configuration, use the no form of this command. cfs ipv4 [mcast | distribute] no cfs ipv4 [mcast | distribute]

Syntax Description

mcast distribute

(Optional) Configures the IPv4 multicast address over which configuration changes are distributed. (Optional) Configures the device to use IPv4 to distribute changes in CFS-enabled applications.

Defaults

The default IPv4 multicast address is 239.255.70.83.

Command Modes

Global configuration mode

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.1(2)

Modification This command was introduced.

Usage Guidelines

This command does not require a license. CFS cannot distribute over both IPv4 and IPv6 from the same device. In order to distribute configuration information, CFS distribution must be enabled for both the device and the application. CFS is enabled by default for the device. All devices in the fabric must have CFS enabled or they do not receive distributions. If CFS distribution is disabled for an application, that application does not distribute any configuration and it does not accept a distribution from other devices in the fabric. CFS over IP must be disabled before you can change the multicast address.

Examples

This example shows how to first disable CFS distribution over IPv4 and then configure the IPv4 multicast address over which configuration changes are distributed:
switch(config)# no cfs ipv4 distribute This will prevent CFS from distributing over IPv4 network.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

43

C Commands cfs ipv4

Are you sure? (y/n) [n] y switch(config)# cfs ipv4 mcast-address 239.255.1.1 Distribution over this IP type will be affected Change multicast address for CFS-IP ? Are you sure? (y/n) [n] y

Related Commands

cfs distribute cfs show cfs status application_name distribute

Globally enables CFS distribution for the device. Specifies a CFS distribution mode. Displays the CFS distribution status. Enables distribution for the specified application, such as RADIUS.

show application_name Displays the status of the specified application, such as RADIUS, including status whether CFS distribution is enabled for the application.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

44

OL-25806-03

C Commands cfs region

cfs region
To create a Cisco Fabric Services (CFS) region that limits the distribution scope of an application, use the cfs region command. To remove the region or the application, use the no form of this command. cfs region region_id application_name no cfs region no application_name

Syntax Description

region_id

CFS region that is identified by numbers 0 through 200. Region 0 is the default region and it contains every device in the fabric that is not assigned to another region. You can configure region number 1 through 200. Application that you assign to the specified region for CFS distribution.

application_name

Defaults

The default region ID is 0.

Command Modes

Global configuration mode CFS region configuration mode

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.1(2)

Modification This command was introduced.

Usage Guidelines

If a feature is moved, that is, assigned to a new region, its scope is restricted to that region; it ignores all other regions for distribution or merging purposes. You can set up a CFS region to distribute configurations for multiple applications. However, on a given device, only one CFS region at a time can distribute the configuration for a given application. Once you assign an application to a CFS region, its configuration cannot be distributed within another CFS region. If you remove an application from a region, and do not assign it into a different region, it is added to the default region, region 0. If you attempt to add an application to the same region more than once, the following message appears:
Application already present in the same region.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

45

C Commands cfs region

In order to distribute configuration information, CFS distribution must be enabled for both the device and the application. CFS is enabled by default for the device. All devices in the fabric must have CFS enabled or they do not receive distributions. If CFS distribution is disabled for an application, then that application does not distribute any configuration and it does not accept a distribution from other devices in the fabric. This command does not require a license.

Examples

This example shows how to create region 4 and add the NTP application to it. When you create a region, the CLI places you into region configuration mode for that region, where you can then add an application.
switch(config)# cfs region 4 switch(config-cfs-region)# callhome switch(config-cfs-region)# show cfs region brief --------------------------------------Region Application Enabled --------------------------------------4 ntp no 4 callhome no 6 igmp yes 6 radius no switch(config-cfs-region)#

Related Commands

show cfs region show cfs status application_name distribute

Displays the CFS distribution region(s) configured for the device. Displays the CFS distribution status. Enables distribution for the specified application, such as NTP.

show application_name Displays the status of the specified application, such as NTP, including status whether CFS distribution is enabled for the application.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

46

OL-25806-03

C Commands check logflash

check logflash
To check the compactFlash, use the check logflash command. check logflash [bad-blocks]

Syntax Description

bad-blocks

(Optional) Finds bad blocks in compactFlash.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(3)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to check compactFlash:

switch# check logflash

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

47

C Commands checkpoint

checkpoint
To configure the rollback checkpoint, use the checkpoint command. To delete the checkpoint, use the no form of this command. checkpoint {name | description description | file name} no checkpoint name

Syntax Description

name

(Optional) Checkpoint name used in the checkpoint database. The name can be any alphanumeric string up to 80 characters but cannot contain spaces. (Optional) Specifies the checkpoint description for the given checkpoint. The description can contain up to 80 alphanumeric characters, including spaces. (Optional) Specifies the filename used to save the checkpoint.

description description

file name

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

If you use the checkpoint command without a name, Cisco NX-OS creates the file with the name auto-x, where x is a decimal number that increases each time you create an unnamed checkpoint file. This command does not require a license.

Examples

This example shows how to configure the rollback checkpoint:

switch# checkpoint stable switch#

This example shows how to delete the checkpoint file:

switch# no checkpoint stable

Cisco Nexus 7000 Series NX-OS System Management Command Reference

48

OL-25806-03

C Commands checkpoint

switch#

Related Commands

Command clear checkpoint database

Description Displays the contents of the checkpoint file.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

49

C Commands clear callhome session

clear callhome session

To clear a Call home Cisco Fabric Services (CFS) distribution session, use the clear callhome session command. clear callhome session

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to clear a Call home CFS distribution session:
switch(config)# clear callhome session

Related Commands

Command callhome callhome send show callhome

Description Enters the Call home configuration mode. Sends a configuration or diagnostic message to all configured Call home destinations. Displays the Call home configuration.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

50

OL-25806-03

C Commands clear cdp

clear cdp
To clear Cisco Discovery Protocol (CDP) statistics on an interface, use the clear cdp command. clear cdp {counters [interface interface] | table [interface interface]}

Syntax Description

counters interface interface table

Clears CDP counters on all interfaces. (Optional) Clears CDP counters on an interface. Clears CDP cache on all interfaces.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to clear CDP statistics on an interface:

switch(config)# clear cdp counters switch(config)#

Related Commands

Command enable cdp

Description Enables CDP on an interface.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

51

C Commands clear checkpoint database

clear checkpoint database

To delete all checkpoint files in the database, use the clear checkpoint database command. clear checkpoint database

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to clear the checkpoint database:

switch# clear checkpoint database Processing the Request... Please Wait ..... Done switch#

Related Commands

Command show checkpoint

Description Displays the contents of the checkpoint file.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

52

OL-25806-03

C Commands clear cores

clear cores
To clear the core files, use the clear cores command. clear cores [archive]

Syntax Description

archive

(Optional) Clears the core file on the logflash file system.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

Use the show system cores command to display information about the core files. This command does not require a license.

Examples

This example shows how to clear the core file:

switch# clear cores

This example shows how to clear the core on the logflash file system:
switch# clear cores archive

Related Commands

Command show system cores system cores

Description Displays the core filename. Configures the core filename.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

53

C Commands clear flow exporter

clear flow exporter

To clear the statistics for a Flexible NetFlow flow exporter, use the clear flow exporter command. clear flow exporter {name exporter-name | exporter-name}

Syntax Description

name exporter-name

Specifies the name of a flow exporter. Name of an existing flow exporter.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

You must have already enabled traffic monitoring with Flexible NetFlow using an exporter before you can use the clear flow exporter command. This command does not require a license.

Examples

This example clears the statistics for the flow exporter named NFC-DC-PHOENIX:
switch# clear flow exporter name NFC-DC-PHOENIX switch#

Related Commands

Command clear flow exporter flow exporter show flow exporter

Description Clears the statistics for exporters. Creates a flow exporter. Displays flow exporter status and statistics.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

54

OL-25806-03

C Commands clear flow monitor

clear flow monitor

To clear a Flexible NetFlow flow monitor, flow monitor cache, or flow monitor statistics and to force the export of the data in the flow monitor cache, use the clear flow monitor command. clear flow monitor {name monitor-name | monitor-name} [cache [force-export] | statistics]

Syntax Description

name monitor-name cache force-export statistics

Specifies the name of a flow monitor. Name of an existing flow monitor. (Optional) Clears the flow monitor cache information. (Optional) Forces the export of the flow monitor cache statistics. (Optional) Clears the flow monitor statistics.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

You must enable Flexible NetFlow monitor before you can use the clear flow monitor command. Use the clear flow monitor monitor-name cache command to remove all entries from the flow monitor cache. These entries will not be exported and the data gathered in the cache is lost. The statistics for the cleared cache entries are maintained. Use the clear flow monitor monitor-name force-export command to remove all entries from the flow monitor cache and exports them to all flow exporters that are assigned to the flow monitor. This process can result in an short term increase in the CPU utilization.

Caution

Be careful when you use the clear flow monitor monitor-name force-export command because using this command might cause a short-term increase in the CPU utilization. Use the clear flow monitor monitor-name statistics command to clear the statistics and cache entries for this flow monitor.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

55

C Commands clear flow monitor

The Current entries statistic is not cleared because this statistic indicates how many entries are in the cache. This command does not require a license.

Examples

This example shows how to clear the statistics and cache entries for the flow monitor named NFC-DC-PHOENIX:
switch# clear flow monitor name NFC-DC-PHOENIX switch#

This example shows how to clear the statistics and cache entries for the flow monitor named NFC-DC-PHOENIX and forces an export:
switch# clear flow monitor NFC-DC-PHOENIX force-export switch#

This example shows how to clear the cache for the flow monitor named NFC-DC-PHOENIX and forces an export:
switch# clear flow monitor NFC-DC-PHOENIX cache force-export switch#

This example shows how to clear the statistics for the flow monitor named NFC-DC-PHOENIX:
switch# clear flow monitor NFC-DC-PHOENIX statistics switch#

Related Commands

Command clear flow monitor flow monitor show flow sw-monitor

Description Clears the flow monitor. Creates a flow monitor. Displays flow monitor status and statistics.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

56

OL-25806-03

C Commands clear hardware flow ip

clear hardware flow ip

To clear the NetFlow hardware IP flow, use the clear hardware flow ip command. clear hardware flow ip [{{vdc vdc_id} | {monitor name} | {profile profile-id} | {vlan vlan-id} | {interface if-type if-number}}] [instance inst] [force-export] [module num]

Syntax Description

vdc vdc_id monitor name profile profile-id vlan vlan-id interface if-type if-number instance inst force-export module num

Specifies the VDC. The range is from 1 to 16. Specifies the name of the NetFlow flow monitor. The monitor name can be any case-sensitive, alphanumeric string up to 64 characters. Specifies the name of the flow profile. The range is from 1 to 31. Specifies the VLAN. The range is from 1 to 4094. Specifies the interface. Interface type. For more information, use the question mark (?) online help function. Interface or subinterface number. For more information about the numbering syntax for your networking device, use the question mark (?) online help function. (Optional) Specifies the EARL instance. The EARL instance can be any alphanumeric string up to 32 characters. (Optional) Forces data to be exported to the collector prior to the clear operation. (Optional) Specifies the module.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to clear the NetFlow hardware IP flow:

switch(config)# clear hardware flow ip module 8 ethernet 2/1 switch(config)#

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

57

C Commands clear hardware flow ip

Related Commands

Command show hardware flow {ip | ipv6}

Description Displays information about NetFlow hardware IP / IPV6 flows.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

58

OL-25806-03

C Commands clear logging ip access-list cache

clear logging ip access-list cache

To clear all the entries from the Optimized ACL Logging (OAL) cache and send them to the syslog, use the clear logging ip access-list cache command. clear logging ip access-list cache

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to clear all the entries from the OAL cache and send them to the syslog:
switch# clear logging ip access-list cache switch#

Related Commands

Command show logging ip access-list

Description Displays the logging status for IP access lists.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

59

C Commands clear logging logfile

clear logging logfile

To clear messages from the logging file, use the clear logging logfile command. clear logging logfile

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to clear messages from the logging file:
switch# clear logging logfile switch#

Related Commands

Command show logging logfile

Description Displays the logs in the local log file.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

60

OL-25806-03

C Commands clear logging nvram

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.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to clear the NVRAM logs:

switch# clear logging nvram switch#

Related Commands

Command show logging nvram

Description Displays the NVRAM logs.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

61

C Commands clear logging onboard

clear logging onboard

To clear the onboard failure logging (OBFL) entries in the persistent log, use the clear logging onboard command. clear logging onboard [counter-stats] [environmental-history] [error-stats] [exception-log] [interrupt-stats] [module num] [obfl-log] [stack-trace]

Syntax Description

counter-stats error-stats exception-log interrupt-stats module num obfl-log stack-trace

(Optional) Clears the OBFL counter statistics. (Optional) Clears the OBFL error statistics. (Optional) Clears the OBFL exception log entries. (Optional) Clears the OBFL interrupt statistics. (Optional) Clears the OBFL information for a specific module. (Optional) Clears the OBFL (boot-uptime/device-version/obfl-history). (Optional) Clears the OBFL stack trace entries.

environmental-history (Optional) Clears the OBFL environmental history.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1) 4.0(2)

Modification This command was introduced. Added the counter-stats keyword.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to clear the OBFL environmental history entries:
switch# clear logging onboard environmental-history switch#

This example shows how to clear the OBFL error statistics:

switch# clear logging onboard error-stats switch#

Cisco Nexus 7000 Series NX-OS System Management Command Reference

62

OL-25806-03

C Commands clear logging onboard

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

switch# clear logging onboard exception-log switch#

This example shows how to clear the OBFL interrupt statistics:

switch# clear logging onboard interrupt-stats switch#

This example shows how to clear the OBFL information for a specific module:
switch# clear logging onboard module 2 switch#

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

switch# clear logging onboard obfl-log switch#

This example shows how to clear the OBFL stack trace entries:
switch# clear logging onboard stack-trace switch#

Related Commands

Command hw-module logging onboard show logging onboard

Description Enables OBFL based on the error type. Displays onboard failure logs.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

63

C Commands clear logging session

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.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to clear the current logging session:

switch# clear logging session switch#

Related Commands

Command show logging session

Description Displays the logging session status.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

64

OL-25806-03

C Commands clear ntp session

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.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.2(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to clear the NTP session:

switch(config)# clear ntp session

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

65

C Commands clear ntp statistics

clear ntp statistics

To clear the Network Time Protocol (NTP) statistics, use the clear ntp statistics command. clear ntp statistics {all-peers | io | local | memory}

Syntax Description

all-peers io local memory

Clears statistics for all NTP peers. Clears IO statistics. Clears local statistics. Clears memory statistics.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to clear statistics for all NTP peers:
switch(config)# clear ntp statistics all-peers

Related Commands

Command show ntp peers

Description Displays information about NTP peers.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

66

OL-25806-03

C Commands clear nvram

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

Syntax Description

This command has no keywords or arguments.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to clear NVRAM:

switch(config)# clear nvram

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

67

C Commands clear platform flow ip

clear platform flow ip

To clear NetFlow hardware IPv4 entries, use the clear platform flow ip command. clear platform flow ip [type] [force-export] [module mod-num]

Syntax Description

type force-export module mod-num

(Optional) Type of entry to clear. See the Usage Guidelines section for valid values. (Optional) Specifies a forced export of the cleared data to a collector. (Optional) Specifies a module. The ranges for the module number depends on the chassis used.

Defaults

If you do not specify the type, all types are cleared.

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to specify a forced export of the cleared data to a collector:
switch# clear platform flow ip forced-export switch#

This example shows how to clear the NetFlow statistics for a module:
switch# clear platform flow ip module 2 switch#

Cisco Nexus 7000 Series NX-OS System Management Command Reference

68

OL-25806-03

C Commands clear platform flow ip

Related Commands

Command flow exporter clear flow monitor flow monitor show flow sw-monitor

Description Creates a flow exporter. Clears the flow monitor. Creates a flow monitor. Displays flow monitor status and statistics.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

69

C Commands clear processes log archive

clear processes log archive

To delete a log file on a log flash, use the clear processes log archive command. clear processes log archive [file file-number]

Syntax Description

file file-number (Optional) Specifies to delete a log file on a log flash.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to delete a log file on a log flash:

switch(config)# clear processes log archive switch(config)#

Related Commands

Command show processes log

Description Displays the contents of the process log.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

70

OL-25806-03

C Commands clear rmon

clear rmon
To delete the Remote Network Monitoring (RMON) tables from a simple network management protocol (SNMP) notification, use the clear rmon command. clear rmon {alarms | events | hcalarms | all-alarms}

Syntax Description

alarms events hcalarms all-alarms

Clears all 32-bit alarms. Clears the RMON log and also clears the RMON event table. Clears all 64-bit RMON alarms. Clears all 32-bit and 64-bit RMON alarms.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.1(2)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to delete RMON tables:

switch(config)# clear rmon alarms switch(config)#

Related Commands

Command clear snmp counters

Description Deletes SNMP counters.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

71

C Commands clear session state name

clear session state name

To clear the state information for a session, use the clear session state name command. clear session state name name

Syntax Description

name

Name of the session. The name can be any case-sensitive, alphanumeric string up to 63 characters.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to clear the internal state for a configuration session:
switch# clear session state name myACLs

Related Commands

Command show configuration session

Description Displays information about the configuration sessions.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

72

OL-25806-03

C Commands clear snmp counters

clear snmp counters

To delete Simple Network Management Protocol (SNMP) counters, use the clear snmp counters command. clear snmp counters

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.1(2)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to delete SNMP counters:

switch(config)# clear snmp counters switch(config)#

Related Commands

Command show snmp sessions

Description Displays information about SNMP sessions.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

73

C Commands clear snmp hostconfig

clear snmp hostconfig

To delete the Simple Network Management Protocol (SNMP) host configuration, use the clear snmp hostconfig command. clear snmp hostconfig

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.1(2)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to delete the SNMP host configuration:

switch(config)# clear snmp hostconfig switch(config)#

Related Commands

Command show snmp sessions clear snmp counters

Description Displays SNMP sessions. Deletes SNMP counters.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

74

OL-25806-03

C Commands clear system reset-reason

clear system reset-reason

To clear the device reset-reason history, use the clear system reset-reason command. clear system reset-reason

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to clear the device reset-reason history:

switch# clear system reset-reason

Related Commands

Command show system reset-reason

Description Displays the device reset-reason history.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

75

C Commands collect counter

collect counter
To configure the number of bytes or packets in a flow as a nonkey field and collect the counter values (number of bytes or packets seen) for a Flexible NetFlow flow record, use the collect counter command. To disable the use of the number of bytes or packets in a flow (counters) as a nonkey field for a Flexible NetFlow flow record, use the no form of this command. collect counter {bytes [long] | packets [long]} no collect counter {bytes [long] | packets [long]}

Syntax Description

bytes long packets

Configures the number of bytes seen in a flow as a nonkey field and collects the total number of bytes from the flow. (Optional) Collects the total number of bytes from the flow using a 64-bit counter. Configures the number of bytes seen in a flow as a nonkey field and collects the total number of packets from the flow.

Defaults

This command is not enabled by default.

Command Modes

Flow record configuration

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

The Flexible NetFlow commands that start with collect are used to configure nonkey fields for the flow monitor record and to enable capturing the values in the fields for the flow created with the record. The values in nonkey fields are added to flows to provide additional information about the traffic in the flows. A change in the value of a nonkey field does not create a new flow. In most cases, the values for nonkey fields are taken from only the first packet in the flow. Use the collect counter packets command to configure a 32-bit counter that is incremented for each packet seen in the flow. For extremely long flow it is possible for this counter to wrap when it reaches the limit of 4 billion or more packets. When the flow monitor detects a scenario that could cause a wrap, the flow monitor with a normal cache type exports the flow and starts a new flow. Use the collect counter packets long command to configure a 64-bit counter that is incremented for each packet seen in the flow. It is unlikely that a 64-bit counter will ever wrap. This command does not require a license.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

76

OL-25806-03

C Commands collect counter

Examples

This example shows how to enable collecting the total number of bytes from the flows as a nonkey field:
switch(config)# flow record FLOW-RECORD-1 switch(config-flow-record)# collect counter bytes

This example shows how to enable collecting the total number of bytes from the flows as a nonkey field using a 64 bit counter:
switch(config)# flow record FLOW-RECORD-1 switch(config-flow-record)# collect counter bytes long

This example shows how to enable collecting the total number of packets from the flows as a nonkey field:
switch(config)# flow record FLOW-RECORD-1 switch(config-flow-record)# collect counter packets

This example shows how to enable collecting the total number of packets from the flows as a nonkey field using a 64-bit counter:
switch(config)# flow record FLOW-RECORD-1 switch(config-flow-record)# collect counter packets long

Related Commands

Command collect counter collect flow collect interface collect ipv4 collect routing collect timestamp collect transport debug flow record flow record match flow match interface match ipv4 match routing match timestamp match transport show flow record

Description Configures the counters as a nonkey field and collects the counter values. Configures flow identifying fields as nonkey fields and collects their values. Configures the input and/or output interface as a nonkey field and collects the values. Configures an IPv4 field as a nonkey field and collects the value in it. Configures a routing attribute as a nonkey field and collects the value of the field. Configures the time stamp fields as nonkey fields and collects the values. Configures a transport layer field as a nonkey field and collects the values. Enables debugging output for flow records. Creates a flow record. Configures one or more of the flow fields as key fields. Configures the direction that traffic flows in respect to an interface (interface field) as a key field. Configures one or more of the IPv4 fields as a key field. Configures one or more of the routing fields as a key field. Configures a time stamp field as a key field. Configures one or more of the transport fields as key fields. Displays the flow record status and statistics.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

77

C Commands collect flow

collect flow
To configure the flow direction or the flow sampler ID number as a nonkey field and collect their values for a Flexible NetFlow flow record, use the collect flow command. To disable the use of the flow direction or the flow sampler ID number as a nonkey field for a Flexible NetFlow flow record, use the no form of this command. collect flow {direction | sampler} no collect flow {direction | sampler}

Syntax Description

direction sampler

Configures the flow direction as a nonkey field and collects the direction that the flow was monitored in. Configures the flow sampler ID as a nonkey field and collects the ID of the sampler that is assigned to the flow monitor.

Defaults

This command is not enabled by default.

Command Modes

Flow record configuration

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

The Flexible NetFlow commands that start with collect are used to configure nonkey fields for the flow monitor record and to enable capturing the values in the fields for the flow created with the record. The values in nonkey fields are added to flows to provide additional information about the traffic in the flows. A change in the value of a nonkey field does not create a new flow. In most cases, the values for nonkey fields are taken from only the first packet in the flow. Use the collect flow direction command to indicate the direction of the flow. Use this command when you configure a single flow monitor for input and output flows and to find and eliminate flows that are being monitored twice: once on input and once on output. Use the collect flow sampler command to collect the ID of the flow sampler that is used to monitor the flow. Use this command when more than one flow sampler is being used with different sampling rates. The option sampler-table command exports option records with mappings of the flow sampler ID to the sampling rate so that the collector can calculate the scaled counters for each flow. This command does not require a license.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

78

OL-25806-03

C Commands collect flow

Examples

This example shows how to configure the direction of the flow nonkey that was monitored as a nonkey field:
switch(config)# flow record FLOW-RECORD-1 switch(config-flow-record)# collect flow direction

This example shows how to configure an ID of the flow sampler that is assigned to the flow as a nonkey field and collects the ID of the flow sampler:
switch(config)# flow record FLOW-RECORD-1 switch(config-flow-record)# collect flow sampler

Related Commands

Command collect counter collect flow collect interface collect ipv4 collect routing collect timestamp collect transport flow record match flow match interface match ipv4 match routing match timestamp match transport show flow record

Description Configures the counters as a nonkey field and collects the counter values. Configures flow identifying fields as nonkey fields and collects their values. Configures the input and/or output interface as a nonkey field and collects the values. Configures an IPv4 field as a nonkey field and collects the value in it. Configures a routing attribute as a nonkey field and collects the value of the field. Configures the times tamp fields as nonkey fields and collects the values. Configures a transport layer field as a nonkey field and collects the values. Creates a flow record. Configures one or more of the flow fields as key fields. Configures the direction that traffic flows in respect to an interface (interface field) as a key field. Configures one or more of the IPv4 fields as a key field. Configures one or more of the routing fields as a key field. Configures a time stamp field as a key field. Configures one or more of the transport fields as key fields. Displays the flow record status and statistics.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

79

C Commands collect interface

collect interface
To configure the input or output interface as a nonkey field and collect the values for a Flexible NetFlow flow record, use the collect interface command. To disable the use of the input or output interface as a nonkey field for a Flexible NetFlow flow record, use the no form of this command. collect interface {input | output} no collect interface {input | output}

Syntax Description

input output

Configures the input interface as a nonkey field and collects the input interface from the flows. Configures the output interface as a nonkey field and collects the output interface from the flows.

Defaults

This command is not enabled by default.

Command Modes

Flow record configuration

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

The Flexible NetFlow commands that start with collect are used to configure nonkey fields for the flow monitor record and to enable capturing the values in the fields for the flow created with the record. The values in nonkey fields are added to flows to provide additional information about the traffic in the flows. A change in the value of a nonkey field does not create a new flow. In most cases, the values for nonkey fields are taken from only the first packet in the flow. This command does not require a license.

Examples

This example shows how to configure the input interface as a nonkey field and collect the input interface value:
switch(config)# flow record FLOW-RECORD-1 switch(config-flow-record)# collect interface input

This example shows how to configure the input interface as a nonkey field and collect the output interface value:
switch(config)# flow record FLOW-RECORD-1 switch(config-flow-record)# collect interface output

Cisco Nexus 7000 Series NX-OS System Management Command Reference

80

OL-25806-03

C Commands collect interface

Related Commands

Command collect counter collect flow collect interface collect ipv4 collect routing collect timestamp collect transport flow record match flow match interface match ipv4 match routing match timestamp match transport show flow record

Description Configures the counters as a nonkey field and collects the counter values. Configures flow identifying fields as nonkey fields and collects their values. Configures the input or output interface as a nonkey field and collects the values. Configures an IPv4 field as a nonkey field and collects the value in it. Configures a routing attribute as a nonkey field and collects the value of the field. Configures the time stamp fields as a nonkey field and collects the values. Configures a transport layer field as a nonkey field and collects the values. Creates a flow record. Configures one or more of the flow fields as key fields. Configures the direction that traffic flows in respect to an interface (interface field) as a key field. Configures one or more of the IPv4 fields as a key field. Configures one or more of the routing fields as a key field. Configures a time stamp field as a key field. Configures one or more of the transport fields as key fields. Displays the flow record status and statistics.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

81

C Commands collect routing

collect routing
To configure a routing attribute as a nonkey field and collect the value of the field for a Flexible NetFlow flow record, use the collect routing command. To disable the use of a routing attribute as a nonkey field for a Flexible NetFlow flow record, use the no form of this command. collect routing {{destination | source} as [peer] | traffic-index | forwarding-status | next-hop address ipv4 [bgp]} no collect routing {{destination | source} as [peer] | traffic-index | forwarding-status | next-hop address ipv4 [bgp]}

Syntax Description

destination source as peer

Configures one or more of the destination routing attributes fields as a nonkey field and collects the values from the flows. Configures one or more of the source routing attributes fields as a nonkey field and collects the values from the flows. Configures the destination AS field as a nonkey field and collects the value in the AS field from the flows. (Optional) Configures the destination AS number of the peer network as a nonkey field and collects the value of the AS number of the peer network from the flows. Configures the Border Gateway Protocol (BGP) source or destination traffic index as a nonkey field and collects the value of the BGP destination traffic index from the flows. Collects the forwarding status of the packet and triggers the collection of flows denied by Access Control List (ACL) entries. Configures the next-hop value as a nonkey field and collects information regarding the next-hop from the flows. (Optional) Configures the IP address of the next hop BGP network as a nonkey field and collects the value of the IP address of the BGP next-hop network from the flows.

traffic-index

forwarding-status next-hop address ipv4 bgp

Defaults

This command is not enabled by default.

Command Modes

Flow record configuration

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

82

OL-25806-03

C Commands collect routing

Usage Guidelines

The Flexible NetFlow commands that start with collect are used to configure nonkey fields for the flow monitor record and to captures the values in the fields for the flow created with the record. The values in nonkey fields are added to flows to provide additional information about the traffic in the flows. A change in the value of a nonkey field does not create a new flow. In most cases, the values for nonkey fields are taken from only the first packet in the flow. Use the collect routing source as [peer] command to collect the 16-bit AS number based on a lookup of the router's routing table using the source IP address. The optional peer keyword provides the expected next network, not the originating network.

Note

The the 16-bit AS number is based on how packets are routed back from this router and the value might not be accurate for asymmetrical routes. Use the collect routing destination as [peer] command to collect the 16-bit AS number based on a lookup of the router's routing table using the destination IP address. The optional peer keyword provides the expected next network, not the destination network. Use the collect routing source traffic-index command to collect the traffic index field based on the source AS for this flow. The traffic-index field is a value that is propagated through BGP. Use the collect routing forwarding-status command to collect a field to indicate if the packets were successfully forwarded. The field is in two parts and may be up to 4 bytes in length. At this time, only the status field is used:
+-+-+-+-+-+-+-+-+ | S | Reason | | t | codes | | a | or | | t | flags | | u | | | s | | +-+-+-+-+-+-+-+-+ 0 1 2 3 4 5 6 7 Status: 00b=Unknown, 01b = Forwarded, 10b = Dropped, 11b = Consumed

This command does not require a license.

Examples

This example shows how to configure the 16-bit AS number based on a lookup of the routers routing table using the source IP address as a nonkey field and collects the 16-bit AS number value:
switch(config)# flow record FLOW-RECORD-1 switch(config-flow-record)# collect routing source as

This example shows how to configure the 16-bit AS number based on a lookup of the routers routing table using the destination IP address as a nonkey field and collects the 16-bit AS number value:
switch(config)# flow record FLOW-RECORD-1 switch(config-flow-record)# collect routing destination as

This example shows how to configure the value in the traffic index field based on the source AS for a flow as a nonkey field and collects the value in the traffic index field value:
switch(config)# flow record FLOW-RECORD-1 switch(config-flow-record)# collect routing source traffic-index

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

83

C Commands collect routing

This example shows how to configure the forwarding status as a nonkey field and collects the forwarding status value:
switch(config)# flow record FLOW-RECORD-1 switch(config-flow-record)# collect routing forwarding-status

Related Commands

Command collect counter collect flow collect interface collect ipv4 collect routing collect timestamp collect transport flow record match flow match interface match ipv4 match routing match timestamp match transport show flow record

Description Configures the counters as a nonkey field and collects the counter values. Configures flow identifying fields as nonkey fields and collects their values. Configures the input or output interface as a nonkey field and collects the values. Configures an IPv4 field as a nonkey field and collects the value in it. Configures a routing attribute as a nonkey field and collects the value of the field. Configures the times tamp fields as a nonkey field and collects the values. Configures a transport layer field as a nonkey field and collects the values. Creates a flow record. Configures one or more of the flow fields as key fields. Configures the direction that traffic flows in respect to an interface (interface field) as a key field. Configures one or more of the IPv4 fields as key fields. Configures one or more of the routing fields as key fields. Configures a time stamp field as a key field. Configures one or more of the transport fields as key fields. Displays the flow record status and statistics.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

84

OL-25806-03

C Commands collect timestamp sys-uptime

collect timestamp sys-uptime

To configure the TIMESTAMP SYS-UPTIME field as a nonkey field and collect the values in them for a Flexible NetFlow flow record, use the collect timestamp sys-uptime command. To disable the use of the TIMESTAMP SYS-UPTIME field as a nonkey for a Flexible NetFlow flow record, use the no form of this command. collect timestamp sys-uptime {first | last} no collect timestamp sys-uptime {first | last}

Syntax Description

first

Configures the sys-uptime for the time that the first packet was seen from the flows as a nonkey field and collects time stamps based on the sys-uptime for the time that the first packet was seen from the flows. Configures the sys-uptime for the time that the last packet was seen from the flows as a nonkey field and collects time stamps based on the sys-uptime for the time that the most recent packet was seen from the flows.

last

Defaults

This command is not enabled by default.

Command Modes

Flow record configuration

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

The Flexible NetFlow commands that start with collect are used to configure nonkey fields for the flow monitor record and to enable capturing the values in the fields for the flow created with the record. The values in nonkey fields are added to flows to provide additional information about the traffic in the flows. A change in the value of a nonkey field does not create a new flow. In most cases, the values for nonkey fields are taken from only the first packet in the flow. This command does not require a license.

Examples

This example shows how to configure timestamps based on the sys-uptime for the time that the first packet was seen from the flows as a nonkey field and collects the sys-uptime for the time that the first packet was seen from the flows:
switch(config)# flow record FLOW-RECORD-1 switch(config-flow-record)# collect timestamp sys-uptime first

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

85

C Commands collect timestamp sys-uptime

This example shows how to configure timestamps based on the sys-uptime for the time that the most recent packet was seen from the flows as a nonkey field and collects the sys-uptime for the time that the most recent packet was seen from the flows:
switch(config)# flow record FLOW-RECORD-1 switch(config-flow-record)# collect timestamp sys-uptime last

Related Commands

Command collect counter collect flow collect interface collect ipv4 collect routing collect timestamp collect transport flow record match flow match interface match ipv4 match routing match timestamp match transport show flow record

Description Configures the counters as a nonkey field and collects the counter values. Configures flow identifying fields as nonkey fields and collects their values. Configures the input or output interface as a nonkey field and collects the values. Configures an IPv4 field as a nonkey field and collects the value in it. Configures a routing attribute as a nonkey field and collects the value of the field. Configures the time stamp fields as a nonkey field and collects the values. Configures a transport layer field as a nonkey field and collects the values. Creates a flow record. Configures one or more of the flow fields as key fields. Configures the direction that traffic flows in respect to an interface (interface field) as a key field. Configures one or more of the IPv4 fields as key fields. Configures one or more of the routing fields as key fields. Configures a time stamp field as a key field. Configures one or more of the transport fields as key fields. Displays the flow record status and statistics.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

86

OL-25806-03

C Commands collect transport tcp flags

collect transport tcp flags

To configure a Transmission Control Protocol (TCP) field as a nonkey field and collect the value in it for a Flexible NetFlow flow record, use the collect transport tcp flags command. To disable the use of a TCP field as a nonkey field for a Flexible NetFlow flow record, use the no form of this command. collect transport tcp flags no collect transport tcp flags

Syntax Description

This command has no arguments or keywords

Defaults

This command is not enabled by default.

Command Modes

Flow record configuration

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

The Flexible NetFlow commands that start with collect are used to configure nonkey fields for the flow monitor record and to enable capturing the values in the fields for the flow created with the record. The values in nonkey fields are added to flows to provide additional information about the traffic in the flows. A change in the value of a nonkey field does not create a new flow. In most cases, the values for nonkey fields are taken from only the first packet in the flow. This command does not require a license.

Examples

This example shows how to configure the TCP flags as a nonkey field:
switch(config)# flow record FLOW-RECORD-1 switch(config-flow-record)# collect transport tcp flags

Related Commands

Command collect counter collect flow collect interface

Description Configures the counters as a nonkey field and collects the counter values. Configures flow identifying fields as nonkey fields and collects their values. Configures the input or output interface as a nonkey field and collects the values.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

87

C Commands collect transport tcp flags

Command collect ipv4 collect routing collect timestamp collect transport flow record match flow match interface match ipv4 match routing match timestamp match transport show flow record

Description Configures an IPv4 field as a nonkey field and collects the value in it. Configures a routing attribute as a nonkey field and collects the value of the field. Configures the timestamp fields as nonkey fields and collects the values. Configures a transport layer field as a nonkey field and collects the values. Creates a flow record. Configures one or more of the flow fields as key fields. Configures the direction that traffic flows in respect to an interface (interface field) as a key field. Configures one or more of the IPv4 fields as key fields. Configures one or more of the routing fields as key fields. Configures a time stamp field as a key field. Configures one or more of the transport fields as key fields. Displays the flow record status and statistics.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

88

OL-25806-03

C Commands commit (Call home)

commit (Call home)

To distribute a Cisco Fabric Services (CFS) configuration, use the commit command. commit

Syntax Description

This command has no arguments or keywords

Defaults

None

Command Modes

Call home configuration

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.1(2)

Modification This command was introduced.

Usage Guidelines

The commit command results in the distribution of the CFS configuration to the running configuration of all CFS-enabled devices in the fabric. You can only use the commit command on the specific device where the fabric lock was acquired. Configuration changes that have not been committed yet (still saved as a working copy) are not in the running configuration and do not display in the output of show commands. An empty commit is allowed to distribute a current configuration if you want to make sure that all devices are synchronized. This command does not require a license.

Examples

This example shows how to commit a CFS configuration and verify that the commit was successful:
switch(config-callhome)# commit switch(config-callhome)# show callhome session status Last Action Time Stamp : Tue Dec 23 11:15:02 2008 Last Action : Commit Last Action Result : Success Last Action Failure Reason : none

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

89

C Commands commit (Call home)

Related Commands

Command abort show cfs application

Description Deletes the CFS session. Displays the applications that are currently CFS-enabled.

show application_name Displays information about the CFS configuration session status for an session status application.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

90

OL-25806-03

C Commands commit (Session Manager)

commit (Session Manager)

To validate and apply the commands in the Session Manager configuration session, use the commit command. commit [verbose]

Syntax Description

verbose

(Optional) Displays a detailed version of the results of the commit command.

Defaults

None

Command Modes

Session configuration

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

The commit command results in a validation of the entire Session Manager configuration, and, if valid, the configuration is applied to the device, This command does not require a license.

Examples

This example shows how to commit a Session Manager configuration:

switch# config session ACL_tcp_in Config Session started, Session ID is 1 Enter configuration commands, one per line. switch(config-s)# verify Verification Successful switch(config-s)# commit Commit Successful switch#

End with CNTL/Z.

Related Commands

Command abort exit show configuration session

Description Deletes the session and exists session configuration mode. Exits session configuration mode without committing the commands. Displays information about the Session Manager configuration session.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

91

C Commands configure session

configure session
To create or modify an access control list (ACL) configuration session with the Session Manager feature, use the configure session command. configure session name

Syntax Description

name

Name of the session. The name can be any case-sensitive, alphanumeric string up to 63 characters.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license. Session Manager supports only the ACL feature.

Examples

This example shows how to create an ACL configuration session:

switch# configure session myACLs switch(config-s)#

Related Commands

Command show configuration session

Description Displays information about the Session Manager configuration sessions.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

92

OL-25806-03

C Commands contract-id

contract-id
To specify a service agreement contract ID in Call home, use the contract-id command. To remove it, use the no form of this command. contract-id contract_id_number no contract-id

Syntax Description

contract_id_ number

Contract number for this device from the service agreement. The contract number can be up to 255 alphanumeric characters in free format.

Defaults

None

Command Modes

Call home configuration

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure a service agreement contract ID in Call home:
switch(config-callhome)# contract-id Contract5678

Related Commands

Command callhome email-contact phone-contact streetaddress customer-id site-id switch-priority show callhome

Description Places you into Call home configuration mode. Specifies the e-mail address of the person responsible for the device. Specifies the phone number of the person responsible for the device. Specifies the street address of the person responsible for the device. Specifies the service agreement customer number for this device. Specifies the site ID number for this device. Specifies the priority number for this device. Displays the Call home configuration.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

93

C Commands counter

counter
To configure a Simple Network Management Protocol (SNMP) port-monitor counter, use the counter command. To remove the port-monitor counter configuration, use the no form of this command. counter {invalid-crc [poll-interval poll-interval {absolute rising-threshold rising-threshold event event-id [falling-threshold falling-threshold event event-id] | delta rising-threshold rising-threshold event event-id [falling-threshold falling-threshold event event-id]}] | invalid-words [poll-interval poll-interval {absolute rising-threshold rising-threshold event event-id [falling-threshold falling-threshold event event-id] | delta rising-threshold rising-threshold event event-id [falling-threshold falling-threshold event event-id]}] | link-loss [poll-interval poll-interval {absolute rising-threshold rising-threshold event event-id [falling-threshold falling-threshold event event-id] | delta rising-threshold rising-threshold event event-id [falling-threshold falling-threshold event event-id]}] | protocol-error [poll-interval poll-interval {absolute rising-threshold rising-threshold event event-id [falling-threshold falling-threshold event event-id] | delta rising-threshold rising-threshold event event-id [falling-threshold falling-threshold event event-id]}] | rx-performance [poll-interval poll-interval {absolute rising-threshold rising-threshold event event-id [falling-threshold falling-threshold event event-id] | delta rising-threshold rising-threshold event event-id [falling-threshold falling-threshold event event-id]}] | signal-loss [poll-interval poll-interval {absolute rising-threshold rising-threshold event event-id [falling-threshold falling-threshold event event-id] | delta rising-threshold rising-threshold event event-id [falling-threshold falling-threshold event event-id]}] | sync-loss [poll-interval poll-interval {absolute rising-threshold rising-threshold event event-id [falling-threshold falling-threshold event event-id] | delta rising-threshold rising-threshold event event-id [falling-threshold falling-threshold event event-id]}] | tx-performance [poll-interval poll-interval {absolute rising-threshold rising-threshold event event-id [falling-threshold falling-threshold event event-id] | delta rising-threshold rising-threshold event event-id [falling-threshold falling-threshold event event-id]}]} no counter {invalid-crc [poll-interval poll-interval {absolute rising-threshold rising-threshold event event-id [falling-threshold falling-threshold event event-id] | delta rising-threshold rising-threshold event event-id [falling-threshold falling-threshold event event-id]}] | invalid-words [poll-interval poll-interval {absolute rising-threshold rising-threshold event event-id [falling-threshold falling-threshold event event-id] | delta rising-threshold rising-threshold event event-id [falling-threshold falling-threshold event event-id]}] | link-loss [poll-interval poll-interval {absolute rising-threshold rising-threshold event event-id [falling-threshold falling-threshold event event-id] | delta rising-threshold rising-threshold event event-id [falling-threshold falling-threshold event event-id]}] | protocol-error [poll-interval poll-interval {absolute rising-threshold rising-threshold event event-id [falling-threshold falling-threshold event event-id] | delta rising-threshold rising-threshold event event-id [falling-threshold falling-threshold event event-id]}] | rx-performance [poll-interval poll-interval {absolute rising-threshold rising-threshold event event-id [falling-threshold falling-threshold event event-id] | delta rising-threshold rising-threshold event event-id [falling-threshold falling-threshold event event-id]}] | signal-loss [poll-interval poll-interval {absolute rising-threshold rising-threshold event event-id [falling-threshold falling-threshold event event-id] | delta rising-threshold rising-threshold event event-id [falling-threshold falling-threshold event event-id]}] | sync-loss [poll-interval poll-interval {absolute rising-threshold rising-threshold event event-id [falling-threshold falling-threshold event event-id] | delta rising-threshold rising-threshold event event-id [falling-threshold falling-threshold event event-id]}] |

Cisco Nexus 7000 Series NX-OS System Management Command Reference

94

OL-25806-03

C Commands counter

tx-performance [poll-interval poll-interval {absolute rising-threshold rising-threshold event event-id [falling-threshold falling-threshold event event-id] | delta rising-threshold rising-threshold event event-id [falling-threshold falling-threshold event event-id]}]}

Syntax Description

invalid-crc poll-interval absolute rising-threshold rising-threshold event event-id falling-threshold falling-threshold delta invalid-words link-loss protocol-error rx-performance signal-loss sync-loss tx-performance

Configures the invalid-crc counter. (Optional) Poll interval for counter in seconds. The range is from 0 to 2147483647. Specifies the absolute type threshold. Configures the rising-threshold value. Rising-threshold limit. The range is from 0 to18446744073709551615. Configures the rising-threshold event. Event ID from the event configuration.The range is from 1 to 65535. (Optional) Configures the falling-threshold value. (Optional) Falling-threshold limit. The range is from 2147483648 to 2147483647. (Optional) Specifies the delta type threshold. Configures the invalid-words counter. Configures the link-loss counter. Configures the protocol-error counter. Configures the ingress (rx) performance counter. Configures the signal-loss counter. Configures the sync-loss counter. Configures the egress (tx) performance counter.

Defaults

None

Command Modes

Port-monitor configuration (config-port-monitor)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.1(2)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure an SNMP counter:

switch(config) port-monitor name PM1 switch(config-port-monitor)# counter invalid-crc poll-interval 30 absolute rising-threshold 10000000 event 100

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

95

C Commands counter

switch(config-port-monitor)#

This example shows how to remove an SNMP counter configuration:

switch(config)# no counter invalid-crc poll-interval 30 absolute rising-threshold 10000000 event 100 switch(config-port-monitor)#

Related Commands

Command monitor counter

Description Configures a monitor counter.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

96

OL-25806-03

C Commands customer-id

customer-id
To specify a service agreement customer ID in Call home, use the customer-id command. To remove it, use the no form of this command. customer-id contract_id_number no customer-id

Syntax Description

contract_id_ number

Customer number for this device from the service agreement. The customer number can be up to 255 alphanumeric characters in free format.

Defaults

None

Command Modes

Call home configuration

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure a service agreement customer ID in Call home:
switch(config-callhome)# customer-id Customer123456

Related Commands

Command callhome email-contact phone-contact streetaddress contract-id site-id switch-priority show callhome

Description Places you into Call home configuration mode. Specifies the e-mail address of the person responsible for the device. Specifies the phone number of the person responsible for the device. Specifies the street address of the person responsible for the device. Specifies the service agreement contract number for this device. Specifies the site ID number for this device. Specifies the priority number for this device. Displays the Call home configuration.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

97

C Commands customer-id

Cisco Nexus 7000 Series NX-OS System Management Command Reference

98

OL-25806-03

D Commands
This chapter describes the Cisco NX-OS system management commands that begin with the letter D.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

99

D Commands description (EEM)

description (EEM)
To add a description to an Embedded Event Manager (EEM) applet, use the description command. To remove the description, use the no form of this command. description description no description

Syntax Description

description

Comment or a description that is added to an EEM applet.

Defaults

None

Command Modes

Embedded event manager

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to add a description to an EEM applet:

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)# description counter policy for acme switch(config-applet)#

Related Commands

Command show event manager policy

Description Displays information about the configured EEM policy.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

100

OL-25806-03

D Commands description (NetFlow record)

description (NetFlow record)

To add a description to a NetFlow record, use the description command. To remove the description, use the no form of this command. description line no description [line]

Syntax Description

line

Description string. The string can have a maximum of 63 alphanumeric characters.

Defaults

None

Command Modes

NetFlow record configuration (config-flow-record)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to add a description to a NetFlow record:

switch(config)# flow record NetFlow-Record-1 switch(config-flow-record)# description Custom-Flow-Record-1 switch(config-flow-record)#

This example shows how to remove the description:

switch(config-flow-record)# no description

Related Commands

Command show flow record

Description Displays information about NetFlow records.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

101

D Commands description (NetFlow monitor)

description (NetFlow monitor)

To add a description to a NetFlow monitor, use the description command. To remove the description, use the no form of this command. description line no description [line]

Syntax Description

line

Description string. The string can have a maximum of 63 alphanumeric characters.

Defaults

None

Command Modes

NetFlow monitor configuration (config-flow-monitor)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to add a description to a NetFlow monitor:

switch(config)# flow monitor NetFlow-Monitor-1 switch(config-flow-monitor)# description Custom-Monitor-1 switch(config-flow-monitor)#

This example shows how to remove the description:

switch(config-flow-monitor)# no description

Related Commands

Command show flow sw-monitor

Description Displays information about NetFlow monitors.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

102

OL-25806-03

D Commands description (NetFlow exporter)

description (NetFlow exporter)

To add a description to a NetFlow exporter, use the description command. To remove the description, use the no form of this command. description line no description [line]

Syntax Description

line

Description string. The string can have a maximum of 63 alphanumeric characters.

Defaults

None

Command Modes

NetFlow exporter configuration (config-flow-exporter)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to add a description to a NetFlow exporter:

switch(config)# flow export Netflow-Exporter-1 switch(config-flow-exporter)# description Custom-Exporter-1 switch(config-flow-exporter)

This example shows how to remove the description:

switch(config-flow-exporter)# no description switch(config-flow-exporter)

Related Commands

Command show flow exporter

Description Displays information about NetFlow exporters.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

103

D Commands description (NetFlow sampler)

description (NetFlow sampler)

To add a description to a NetFlow sampler, use the description command. To remove the description, use the no form of this command. description line no description [line]

Syntax Description

line

Description string. The string can have a maximum of 63 alphanumeric characters.

Defaults

None

Command Modes

NetFlow sampler configuration (config-flow-sampler)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to add a description to a NetFlow sampler:

switch(config)# sampler Netflow-Sampler-1 switch(config-flow-sampler)# description Custom-Sampler-1 switch(config-flow-sampler)#

This example shows how to remove the description:

switch(config-flow-sampler)# no description

Related Commands

Command show sampler

Description Displays information about NetFlow samplers.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

104

OL-25806-03

D Commands description (SPAN)

description (SPAN)
To add a description to an Ethernet Switched Port Analyzer (SPAN) session for analyzing traffic between ports, use the description command. To remove the description, use the no form of this command. description description no description

Syntax Description

description

Comment or a description of up to 32 characters that is added to a SPAN session.

Defaults

None

Command Modes

Monitor configuration (config-monitor)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

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

switch# configure terminal switch(config)# monitor session 3 switch(config-monitor)# description span_session_3

Related Commands

Command monitor session show monitor session

Description Places you into the Monitor configuration mode for configuring a SPAN session. Displays the specified SPAN or ERSPAN session configuration.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

105

D Commands destination

destination
To specify the destination for a NetFlow exporter, use the destination command. To remove a destination, use the no form of this command. destination {ipaddr | ipv6addr} [use-vrf vrf_name] no destination [{ipaddr | ipv6addr} [use-vrf vrf_name]

Syntax Description

ipaddr ipv6addr use-vrf vrf_name

Destination IP address for a collector. Destination IPv6 address for a collector. (Optional) Specifies the Virtual Routing and Forwarding (VRF) label.

Defaults

None

Command Modes

NetFlow exporter configuration (config-flow-exporter)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to specify the destination for a NetFlow exporter:
switch(config)# Flow exporter NetFlow-Exporter-1 switch(config-flow-exporter)# destination 192.168.11.2 switch(config-flow-exporter)#

This example shows how to remove the destination:

switch(config-flow-exporter)# no destination

Related Commands

Command show flow exporter

Description Displays information about NetFlow exporters.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

106

OL-25806-03

D Commands destination interface (SPAN)

destination interface (SPAN)

To add a destination interface to an Ethernet Switched Port Analyzer (SPAN) session for analyzing traffic between ports, use the destination interface command. To remove the destination, use the no form of this command. destination interface {ethernet number | port-channel number} no destination interface {ethernet number | port-channel number}

Syntax Description

ethernet number

Specifies the destination Ethernet interface slot number for the specified SPAN session. Source packets are copied from this destination. The range is from 1 through 10. Specifies the destination port channel interface for the specified SPAN session. Source packets are copied from this destination. The range is from 1 through 4096.

port-channel number

Defaults

None

Command Modes

Monitor configuration (config-monitor)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to add a destination to a SPAN session:

switch# configure terminal switch(config)# monitor session 3 switch(config-monitor)# destination interface ethernet 2/5, ethernet 3/7

Related Commands

Command monitor session

Description Places you into the Monitor configuration mode for configuring a SPAN session.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

107

D Commands destination interface (SPAN)

Command show monitor session description

Description Displays the specified SPAN or ERSPAN session configuration. Adds a comment or a description of up to 32 characters to a SPAN session.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

108

OL-25806-03

D Commands destination-profile

destination-profile
To create and name a destination profile for Call home, use the destination-profile command. To remove a destination profile, use the no form of this command. destination-profile profile_name no destination-profile profile_name

Syntax Description

profile_name

User-defined destination profile name.

Defaults

None

Command Modes

Call home configuration (config-callhome)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

Cisco NX-OS includes the following predefined destination profiles:

CiscoTAC-1Supports the Cisco-TAC alert group in XML message format. This profile is preconfigured with the [email protected] e-mail contact, maximum message size, and message severity level 0. You cannot change any of the default information for this profile. full-text-destinationSupports the full text message format. short-text-destinationSupports the short text message format.

This command does not require a license.

Examples

This example shows how to create the Call home destination profile named Noc101:
switch(config)# callhome switch(config-callhome)# destination-profile Noc101

This example shows how to remove the Call home Noc101 destination profile:
switch(config)# callhome switch(config-callhome)# no destination-profile Noc101

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

109

D Commands destination-profile

Related Commands

Command show callhome destination-profile name show callhome

Description Displays the specified Call home destination profile.

Displays the Call home configuration.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

110

OL-25806-03

D Commands destination-profile alert-group

destination-profile alert-group
To specify which alerts a Call home destination will receive, use the destination-profile alert-group command. To remove an alert group, use the no form of this command. destination-profile profile_name alert-group {All | Configuration | Diagnostic | EEM | Cisco-TAC | Environmental | Inventory | License | Linecard-Hardware | Supervisor-Hardware | Syslog-group-port | System | Test} no destination-profile profile_name alert-group {All | Configuration | Diagnostic | EEM | Cisco-TAC | Environmental | Inventory | License | Linecard-Hardware | Supervisor-Hardware | Syslog-group-port | System | Test}

Syntax Description

profile_name alert-group All Configuration Diagnostic EEM Cisco-TAC Environmental Inventory License LinecardHardware SupervisorHardware Syslog-group-port System Test

User-defined Call home destination profile name. Adds an alert group to the specified Call home destination profile. Specifies that the Call home destination profile receives all callhome messages. Specifies that the Call home destination profile is notified of events related to configuration. Specifies that the Call home destination profile is notified of events related to the diagnostic. Specifies that the Call home destination profile is notified of EEM events. Specifies that the Call home destination profile is notified of events that are meant for Cisco TAC only. Specifies that the Call home destination profile is notified of events related to power, fan, and temperature. Specifies that the Call home destination profile is notified of inventory status events. Specifies that the Call home destination profile is notified of events related to licensing. Specifies that the Call home destination profile is notified of line card-related events. Specifies that the Call home destination profile is notified of supervisor-related events. Specifies that the Call home destination profile is notified of events related to syslog messages filed by port manager. Specifies that the Call home destination profile is notified of software-related events. Specifies that the Call home destination profile is notified of user-generated test events.

Defaults

None

Command Modes

Call home configuration (config-callhome)

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

111

D Commands destination-profile alert-group

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to specify that the destination profile receives all Call home messages:
switch# config t Enter configuration commands, one per line. End with CNTL/Z. switch(config)# callhome switch(config-callhome)# destination-profile Noc101 alert-group All switch(config-callhome)# show callhome destination-profile profile Noc101 Noc101 destination profile information maximum message size:2500000 message format:XML message-level:0 email addresses configured: alert groups configured: all

Related Commands

Command show callhome

Description Displays the Call home configuration.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

112

OL-25806-03

D Commands destination-profile email-addr

destination-profile email-addr
To specify an e-mail address for a Call home destination, use the destination-profile email-addr command. To remove an e-mail address, use the no form of this command. destination-profile profile-name email-addr email-address no destination-profile profile-name email-addr email-address

Syntax Description

profile-name email-addr email-address

Name you have given the Call home destination profile where the e-mail address is to be added. Specifies the e-mail address to be added to the Call home destination profile.

Defaults

None

Command Modes

Call home configuration (config-callhome)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to specify an e-mail address for a Call home destination:
switch# config t Enter configuration commands, one per line. End with CNTL/Z. switch(config)# callhome switch(config-callhome)# destination-profile Noc101 email-addr [email protected] switch(config-callhome)# show callhome destination-profile profile Noc101 Noc101 destination profile information maximum message size:2500000 message format:XML message-level:0 email addresses configured: [email protected] alert groups configured: all

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

113

D Commands destination-profile email-addr

Related Commands

Command show callhome

Description Displays the Call home configuration.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

114

OL-25806-03

D Commands destination-profile format

destination-profile format
To specify a message format for sending messages to a Call home destination, use the destination-profile format command. destination-profile profile_name format {full-txt | short-txt | XML}

Syntax Description

profile_name format full-txt short-txt XML

Name you have given the Call home destination profile where the message format is to be specified. Establishes a format for sending Call home messages to the specified destination (XML is the default). Specifies that messages are sent to the named Call home destination in plain text. Specifies that messages are sent to the named Call home destination in short text. Specifies that messages are sent to the named Call home destination in XML. XML is the default Call home message format.

Defaults

XML

Command Modes

Call home configuration (config-callhome)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure a message format for sending messages to a Call home destination:
switch(config-callhome)# destination-profile acme_destination format full-txt

Related Commands

Command show callhome destination-profile show callhome

Description Displays a Call home destination profiles. Displays the Call home configuration.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

115

D Commands destination-profile http

destination-profile http
To specify an HTTP or HTTPS URL for a Call home destination, use the destination-profile http command. To remove a URL, use the no form of this command. destination-profile profile-name http url no destination-profile profile-name http url

Syntax Description

profile-name http url

Name you have given the Call home destination profile. Specifies the HTTP or HTTPS URL to be added to the Call home destination profile.

Defaults

None

Command Modes

Call home configuration (config-callhome)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure a URL for a Call home destination:
switch(config-callhome)# destination-profile acme_destination http http://my_url,com/callhome

Related Commands

Command show callhome destination-profile show callhome

Description Displays a Call home destination profiles. Displays the Call home configuration.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

116

OL-25806-03

D Commands destination-profile message-level

destination-profile message-level
To specify a severity level for alerts that are sent to the Call home destination, use the destination-profile message-level command. destination-profile profile_name message-level number

Syntax Description

profile_name message-level number

Name you have given the Call home destination profile where the message format is to be specified. Specifies the severity level at which messages that are sent to the Callhome destination. Message severity level designations that begin at the lowest urgency level 0 and progress to level 9, the most urgent. If you specify level 5, for example, all messages designated level 5 or higher are sent to the destination.

Defaults

None

Command Modes

Call home configuration (config-callhome)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to specify that messages with a severity level 5 or higher are sent to a Call home destination:
switch(config-callhome)# destination-profile acme_destination message-level 5

Related Commands

Command show callhome destination-profile show callhome

Description Displays a Call home destination profiles. Displays the Call home configuration.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

117

D Commands destination-profile message-size

destination-profile message-size
To specify a maximum allowable size for messages that are sent to a Call home destination, use the destination-profile message-size command. destination-profile profile_name message-size number

Syntax Description

profile_name message-size number

Name you have given the Call home destination profile where the maximum message size is to be specified. Specifies the maximum allowable size for messages sent to the specified Call home destination. The default is 2500000. Maximum allowable size of a message sent to the specified Call home destination. The range is from 0 to 5000000.

Defaults

2500000

Command Modes

Call home configuration (config-callhome)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure a maximum message size of 100000 for messages sent to a Call home destination:
switch(config-callhome)# destination-profile acme_destination message-size 100000

Related Commands

Command show callhome destination-profile show callhome

Description Displays a Call home destination profiles. Displays the Call home configuration.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

118

OL-25806-03

D Commands destination-profile transport-method

destination-profile transport-method
To specify a method of transporting Call home messages to a destination, use the destination-profile transport-method command. To remove the transport method, use the no form of this command. destination-profile profile-name transport-method [email | http] no destination-profile profile-name transport-method [email | http]

Syntax Description

profile-name transportmethod email http

Name you have given the Call home destination profile where the transport method is to be specified. Specifies the method (email or HTTP) for sending messages to the Call home destination. (Optional) Specifies if using e-mail to send Call home messages to the Call home destination. (Optional) Specifies if using HTTP to send Call home messages to the Call home destination.

Defaults

None

Command Modes

Call home configuration (config-callhome)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to specify HTTP for transporting Call home messages to a destination:
switch(config-callhome)# destination-profile acme_destination transport-method http switch(config-callhome)#

Related Commands

Command show callhome destination-profile show callhome

Description Displays a Call home destination profiles. Displays the Call home configuration.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

119

D Commands diagnostic bootup level

diagnostic bootup level

To configure the diagnostic bootup level to trigger diagnostics when the device boots, use the diagnostic bootup level command. diagnostic bootup level {bypass | complete}

Syntax Description

bypass complete

Specifies to not perform any bootup diagnostics. Displays all bootup diagnostics. The default is complete.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure the diagnostic bootup level:

switch(config)# diagnostic bootup level bypass switch#

Related Commands

Command

Description

show diagnostic bootup Displays the diagnostic bootup level. level

Cisco Nexus 7000 Series NX-OS System Management Command Reference

120

OL-25806-03

D Commands diagnostic clear result module

diagnostic clear result module

To clear the diagnostic test result for the specified test, use the diagnostic clear result module command. diagnostic clear result module [slot | all] test {test-id | all}

Syntax Description

slot all test test-id

(Optional) Specifies to clear the a diagnostic test for a specific module number. The range is from 1 to 10. (Optional) Displays the test result for all tests on all modules. Displays the diagnostic test selection. Test ID. The range is from 1 to 14.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to clear a diagnostic test result:

switch# diagnostic clear result module 6 test 6

Related Commands

Command show diagnostic result

Description Displays a diagnostic test result for a specified test.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

121

D Commands diagnostic monitor interval module

diagnostic monitor interval module

To configure a diagnostic monitoring test interval on a module, use the diagnostic monitor interval module command. To remove the diagnostic monitoring test interval, use the no form of this command. diagnostic monitor interval module module test {all | name | test-id} hour hour min min second sec no diagnostic monitor interval module module test {all | name | test-id}

Syntax Description

module test all name test-id hour hour min min second sec

Module number. Specifies a diagnostic test. Specifies all test IDs. Test name. Test ID number. Specifies the hour of the interval that the test begins. Hour of the interval that you specify to start the test. Specifies the minute of the interval that the test begins. Minute of the interval that you specify to start the test. Specifies the second of the interval that the test begins. Second of the interval that you specify to start the test.

Defaults

None

Command Modes

Global configuration mode (config)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure a diagnostic monitoring test interval on a module:
switch(config)# diagnostic monitor interval module 1 test 5 hour 10 min 30 sec 0 switch(config)#

This example shows how to remove a diagnostic monitoring test interval from a module:

Cisco Nexus 7000 Series NX-OS System Management Command Reference

122

OL-25806-03

D Commands diagnostic monitor interval module

switch(config)# no diagnostic monitor interval module 1 test 5 hour 10 min 30 sec 0 switch(config)#

Related Commands

Command show running-config diagnostic diagnostic monitor module

Description Displays the running-configuration diagnostics. Configures a diagnostic monitor test.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

123

D Commands diagnostic monitor module

diagnostic monitor module

To configure a diagnostic monitor test, use the diagnostic monitor module command. To remove a diagnostic monitor test, use the no form of this command. diagnostic monitor module module test {all | name | test-id} no diagnostic monitor module module test {all | name | test-id}

Syntax Description

module test all name test-id

Module number. Specifies a diagnostic test selection. Specifies all test IDs. Test name. The maximum number of characters is 32. Test ID number.

Defaults

None

Command Modes

Global configuration mode (config)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure a diagnostic monitor test:

switch(config)# diagnostic monitor module 1 test all switch(config)#

This example shows how to remove a diagnostic monitor test:

switch(config)# no diagnostic monitor module 1 test all switch(config)#

Cisco Nexus 7000 Series NX-OS System Management Command Reference

124

OL-25806-03

D Commands diagnostic monitor module

Related Commands

Command show startup-config diagnostic show running-config diagnostic

Description Displays the startup-configuration diagnostics. Displays the running-configuration diagnostics.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

125

D Commands diagnostic ondemand action-on-failure

diagnostic ondemand action-on-failure

To configure the action to take if the on-demand test fails, use the diagnostic ondemand action-on-failure command. diagnostic ondemand action-on-failure {continue failure-count num-fails | stop}

Syntax Description

continue failure-count Displays the on-demand test until the test failure limit is reached. The range num-fails is from 1 to 999. The default is 1. stop Stops on-demand tests immediately if a test fails.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure the action if the on-demand test fails:
switch# diagnostic ondemand action-on-failure continue failure-count 992 switch#

Related Commands

Command show diagnostic ondemand

Description Displays information about on-demand tests.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

126

OL-25806-03

D Commands diagnostic ondemand iteration

diagnostic ondemand iteration

To configure the number of times that the on-demand test runs, use the diagnostic ondemand iteration command. diagnostic ondemand iteration number

Syntax Description

number

(Optional) Number of times that the on-demand test runs. The range is from 1 to 999. The default is 1.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure the number of times that the on-demand test runs:
switch# diagnostic ondemand iteration 992

Related Commands

Command show diagnostic ondemand

Description Displays information about on-demand tests.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

127

D Commands diagnostic start

diagnostic start
To start the on-demand diagnostic test for a module, use the diagnostic start command. diagnostic start module slot test [test-id | test-name | all | non-disruptive] [port port-number | all]

Syntax Description

slot test test-id test-name all non-disruptive port port-number

(Optional) Diagnostic start slot number. The range is from 1 to 10. Displays the diagnostic test. (Optional) Test ID. The range is from 1 to 14. (Optional) Test name. The name can be any case-sensitive, alphanumeric string up to 32 characters. (Optional) Displays all ports. (Optional) Displays the nondisruptive tests. (Optional) Displays the port interface. (Optional) Interface port number.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to start the on-demand diagnostic test for a module:
switch# diagnostic start module 6 test all

Related Commands

Command diagnostic stop

Description Stops on-demand diagnostics.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

128

OL-25806-03

D Commands diagnostic stop

diagnostic stop
To stop one or more diagnostic tests for a module, use the diagnostic stop command. diagnostic stop module slot test [test-id | name | all]

Syntax Description

slot test test-id name all

Slot number. The slot range is from 1 to 10. Displays the diagnostic test. (Optional) Test ID. The range is from 1 to 14. (Optional) Test name. The name can be any case-sensitive, alphanumeric string up to 32 characters. (Optional) Displays the diagnostic test for all tests on all modules.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to stop one or more diagnostic tests on a module:
switch# diagnostic stop module 6 test all switch#

Related Commands

Command diagnostic start

Description Starts one or more diagnostic tests.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

129

D Commands diagnostic test simulation

diagnostic test simulation

To simulate a diagnostic test for a module, use the diagnostic test simulation command diagnostic test simulation module slot test test-id [port {number | all}] {fail | random-fail | success}

Syntax Description

slot test test-id port number all fail random-fail success

Diagnostic test simulation module number. The range is from 1 to the number of modules in the chassis. Specifies the test ID. The range is from 1 to 15. (Optional) Specifies the interface port to display. Interface port number. Specifies all interface ports. Displays failed test results. Displays random fail test results. Displays pass test results.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to simulate a test result:

switch# diagnostic test simulation module 2 test 2 fail switch#

Cisco Nexus 7000 Series NX-OS System Management Command Reference

130

OL-25806-03

D Commands diagnostic test simulation

Related Commands

Command diagnostic test simulation clear

Description Clears a diagnostic test simulation.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

131

D Commands diagnostic test simulation clear

diagnostic test simulation clear

To clear a diagnostic test simulation for a module, use the diagnostic test simulation clear command diagnostic test simulation module number test test-id clear

Syntax Description

module number test test-id

Specifies the diagnostic test simulation module number. The range is from 1 to the number of modules in the chassis. Specifies the test ID. The range is from 1 to 15.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to clear the diagnostic test simulation:

switch# diagnostic test simulation module 2 test 2 clear switch#

Related Commands

Command diagnostic test simulation

Description Simulates a diagnostic test.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

132

OL-25806-03

D Commands distribute

distribute
To enable Cisco Fabric Service (CFS) to distribute configurations, use the distribute command. To disable distribution, use the no form of this command. distribute [radius | tacacs+] no distribute

Syntax Description

radius tacacs+

(Optional) Specifies CFS to distribute RADIUS configurations. (Optional) Specifies CFS to distribute TACACS+ configurations.

Defaults

None

Command Modes

Call home configuration mode Global configuration mode

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.1(2)

Modification This command was introduced.

Usage Guidelines

This command does not require a license. To enable CFS to distribute role configurations, see the role distribute command.

Examples

This example shows how to enable CFS to distribute Call home configurations:
switch(config)# callhome switch(config-callhome)# distribute

This example shows how to enable CFS to distribute RADIUS configurations:

switch(config)# distribute radius

This example shows how to enable CFS to distribute TACACS+ configurations:

switch(config)# distribute tacacs+

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

133

D Commands distribute

Related Commands

Command show cfs status cfs cfs region

Description Displays the CFS distribution status. Specifies a CFS distribution mode. Creates a CFS distribution region that limits the distribution scope of an application.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

134

OL-25806-03

D Commands dscp

dscp
To specify the differentiated services code point (DSCP) for a NetFlow exporter, use the dscp command. To remove the DSCP parameter, use the no form of this command. dscp dscp no dscp [dscp]

Syntax Description

dscp

Differentiated services code point value. The range is from 0 to 63.

Defaults

None

Command Modes

NetFlow exporter configuration (config-flow-exporter)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure the DSCP parameter:

switch(config)# Flow exporter Custom-NetFlow-Exporter-1 switch(config-flow-exporter)# dscp 32 switch(config-flow-exporter)#

This example shows how to remove the DSCP parameter:

switch(config-flow-exporter)# no dscp switch(config-flow-exporter)

Related Commands

Command show flow exporter

Description Displays information about NetFlow exporters.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

135

D Commands dscp

Cisco Nexus 7000 Series NX-OS System Management Command Reference

136

OL-25806-03

E Commands
This chapter describes the Cisco NX-OS system management commands that begin with the letter E.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

137

E Commands erspan-id

erspan-id
To configure the flow ID for an Encapsulated Remote Switched Port Analyzer (ERSPAN)) session, use the erspan-id command. erspan-id flow_id

Syntax Description

flow_id

ERSPAN flow ID. The range is from 1 to 1023.

Defaults

None

Command Modes

config-erspan-src

SupportedUserRoles

network-admin network-operator

Command History

Release 5.1(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure the flow ID for an ERSPAN session:
switch# configure terminal switch(config)# monitor session 5 type erspan-source switch(config-erspan-src)# erspan-id 100 switch(config-erspan-src)#

Related Commands

Command ip dscp ip ttl vrf monitor-session

Description Configures the DSCP value of the packets in the ERSPAN traffic. Configures the IP time-to-live (TTL) value of the ERSPAN traffic. Configures the VRF for ERSPAN traffic forwarding. Enters the monitor configuration mode for configuring an ERSPAN or SPAN session for analyzing traffic between ports.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

138

OL-25806-03

E Commands ethanalyzer local interface

ethanalyzer local interface

To capture packets to or from the supervisor or management interface, use the ethanalyzer local interface command. To stop packet capture, use the no form of this command. ethanalyzer local interface {inband | mgmt} [[capture-filter capt-expression] [capture-ring-buffer duration seconds write bootflash | files files write bootflash | filesize kilobytes write bootflash [display-filter disp-expression] [limit-captured-frames limit] [limit-frame-size bytes] [write location]] [brief] no ethanalyzer local interface {inband | mgmt} [[capture-filter capt-expression] [capture-ring-buffer duration seconds write bootflash | files files write bootflash | filesize kilobytes write bootflash [display-filter disp-expression] [limit-captured-frames limit] [limit-frame-size bytes] [write location]] [brief]

Syntax Description

inband mgmt capture-filter capt-expression capture-ring-buffer duration seconds write files

Captures packets going between the supervisor module and the interface modules. Captures packets going to or from the mgmt0 port. (Optional) Filters the display of output based on the expression. The expression is a quoted string. (Optional) Captures ring buffer option. Stop writing to the file or switch to the next file after value seconds have elapsed. Duration in seconds. The range is from 0-2147483647. Filename to save capture to. Stop writing to capture files after value number of files were written or begin again with the first file after value number of files were written (form a ring buffer). Number of files. The range is from 2 to 64. Specifies the bootflash file name. Stop writing to a capture file or switch to the next file after it reaches a size of value kilobytes. Size in kilobytes. The range is from 1to 65536. (Optional) Filters the display of output based on the expression. The expression is a quoted string.

files bootflash filesize kilobytes display-filter disp-expression

limit-captured-frames (Optional) Configures the maximum number of frames to capture. The range limit is from 0 to 2147483647. The default is 100. limit-frame-size bytes write location brief (Optional) Captures the configured number of bytes from a frame. The range is from 64 to 65535. (Optional) Saves the captured information to the configured location. The location can be any case-sensitive, alphanumeric string up to 64 characters. (Optional) Displays the protocol summary of the captured packets.

Defaults

No packets captured.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

139

E Commands ethanalyzer local interface

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.2(5) and 5.0(1) 4.0(1)

Modification Added the option capture-ring-buffer to the syntax description. This command was introduced.

Usage Guidelines

Cisco Ethanalyzer is based on the Wireshark open source code. This command does not require a license.

Examples

This example shows how to capture all packets on the mgmt 0 port:
switch# ethanalyzer local interface mgmt #

Related Commands

Command

Description

ethanalyzer local read Reads the captured packet data from an Ethanalyzer capture.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

140

OL-25806-03

E Commands ethanalyzer local read

ethanalyzer local read

To read packets captured by Ethanalyzer, use the ethanalyzer local read command. To stop reading the packet capture, use the no form of this command. ethanalyzer local read location no ethanalyzer local read location

Syntax Description

location

Location to read captured packets from. The location can be any case-sensitive, alphanumeric string up to 64 characters.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

Cisco Ethanalyzer is based on the Wireshark open source code. This command does not require a license.

Examples

This example shows how to capture all packets on the mgmt 0 port:
switch# ethanalyzer local read bootflash:test-mgmt0 #

Related Commands

Command ethanalyzer local interface

Description Captures packets to or from the supervisor or mgmt0 port.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

141

E Commands event cli

event cli
To specify the event criteria for an Embedded event manager (EEM) applet that is run by matching a Cisco NX-OS command-line interface (CLI) command, use the event cli command. To remove the CLI command event criteria, use the no form of this command. event cli [tag tag] match regex [count countnum] [time interval] no event cli match regex [count countnum] [time interval]

Syntax Description

tag tag match regex

(Optional) Identifies this specific event when multiple events are included in the policy. Specifies the regular expression (regex) used to perform the CLI command pattern match. The CLI command must have been successfully parsed before the pattern match is attempted. The pattern match is compared with the fully expanded CLI command string. If the expression contains embedded blanks, enclose it in double quotation marks. (Optional) Specifies the number of matching occurrences before an EEM event is triggered. When a number is not specified, an EEM event is triggered after the first match. The countnum argument must be an integer greater than 0. (Optional) Specifies the time interval during which the one or more occurrences must take place. When the keyword is not specified, no time period check is applied. The interval argument is an integer that represents seconds in the range from 0 to 4294967295.

count countnum

time interval

Defaults

None

Command Modes

Embedded event manager

SupportedUserRoles

network-admin vdc-admin

Command History

Release 5.2.(1) 4.0(1)

Modification Added the tag tag keywords. This command was introduced.

Usage Guidelines

The event cli match regex command must meet the following criteria:
1.

It must be a fully qualified CLI string that must include the complete, not relative, path. For example, to describe the shutdown command under interface mode, the command should be:
switch(config-applet)# event cli match conf t ; interface * ; shutdown

Cisco Nexus 7000 Series NX-OS System Management Command Reference

142

OL-25806-03

E Commands event cli

2.

The delimiter between the modes must be ; , which is a space followed by a semi-colon and followed by another space.

This command does not require a license.

Examples

This example shows how to specify a CLI command for the EEM applet to match:
switch# configure terminal switch(config)# event manager applet eventcli-applet switch(config-applet)# event cli match "write memory.*" time 13 switch(config-applet)#

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

143

E Commands event counter

event counter
To specify the event criteria for an Embedded Event Manager (EEM) applet that is run on the basis of a named counter crossing a threshold, use the event counter command. To remove the counter event criteria, use the no form of this command. event counter [tag tag] name name entry-val value entry-op {gt | ge | eq | ne | lt | le} [exit-val value exit-op {gt | ge | eq | ne | lt | le}] no event counter name name

Syntax Description

tag tag name name entry-val value

(Optional) Identifies this specific event when multiple events are included in the policy. Specifies the name of the counter that will be monitored. The name identifier can be any string value. Specifies the value with which the contents of the current counter are compared to decide if a counter event should be raised. The range is from 2147483648 to 2147483647, inclusive. Compares the contents of the current counter value with the entry value using the specified operator:

entry-op op

gtGreater than geGreater than or equal to eqEqual to neNot equal to ltLess than leLess than or equal to

If there is a match, an event is triggered and event monitoring is disabled until the exit criteria are met. exit-val value (Optional) Specifies the value with which the contents of the current counter are compared to decide whether the exit criteria are met. The range is from 2147483648 to 2147483647, inclusive. (Optional) Compares the contents of the current counter with the exit value using a specified operator:

exit-op op

gtGreater than geGreater than or equal to eqEqual to neNot equal to ltLess than leLess than or equal to

If there is a match, an event is triggered and event monitoring is reenabled.

Defaults

None

Cisco Nexus 7000 Series NX-OS System Management Command Reference

144

OL-25806-03

E Commands event counter

Command Modes

Embedded event manager

SupportedUserRoles

network-admin vdc-admin

Command History

Release 5.2.(1) 4.0(1)

Modification Added the tag tag keywords. This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to specify an event criteria for an EEM applet that is run when the defined critical_errors counter exceeds the entry value:
switch# configure terminal switch(config)# event manager applet eventcntr-applet switch(config-applet)# event counter name critical_errors entry-val 3 entry-op gt switch(config-applet)#

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

145

E Commands event fanabsent

event fanabsent
To specify an event criteria for an Embedded Event Manager (EEM) applet that is run on the basis of a fan absent event, use the event fanabsent command. To remove the fan absent event criteria, use the no form of this command. event fanabsent [fan number] time interval no event fanabsent [fan number] time interval

Syntax Description

fan number time interval

(Optional) Specifies a fan number to monitor for a fan absent event. The range is from 1 to 4. Specifies the time interval (in seconds) within which the fan can stay absent. The range is from 0 to 4294967295.

Defaults

None

Command Modes

Embedded event manager

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to specify that an EEM applet runs when a fan absent event occurs:
switch# configure terminal switch(config)# event manager applet absent-applet switch(config-applet)# event fanabsent time 42 switch(config-applet)#

Cisco Nexus 7000 Series NX-OS System Management Command Reference

146

OL-25806-03

E Commands event fanbad

event fanbad
To specify an event criteria for an Embedded Event Manager (EEM) applet that is run on the basis of a fan bad event, use the event fanbad command. To remove the fan bad event criteria, use the no form of this command. event fanbad [fan number] time interval no event fanbad [fan number] time interval

Syntax Description

fan number time interval

(Optional) Specifies a fan number to monitor for a fan bad event. The range is from 1 to 4. Specifies the time interval (in seconds) within which the fan can stay bad. The range is from 0 to 4294967295.

Defaults

None

Command Modes

Embedded event manager

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to specify that an EEM applet runs when a fan bad event occurs:
switch# configure terminal switch(config)# event manager applet bad-applet switch(config-applet)# event fanbad time 42 switch(config-applet)#

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

147

E Commands event gold

event gold
To specify an event criteria for an Embedded Event Manager (EEM) applet that is run on the basis of a Generic Online Diagnostic (GOLD) failure event when monitoring one or more modules, use the event gold command. To remove the GOLD failure event criteria, use the no form of this command. event gold module {module | all} test name [severity {minor | moderate | major}] testing-type {bootup | ondemand | scheduled | monitoring} consecutive-failure cnt no event gold module {module | all} test name

Syntax Description

module module all test name severity

Specifies that one module or all modules must be monitored:

Note

The module keyword is required to complete the event gold command.

Number of a specific module to be monitored. Specifies that all modules are to be monitored. Specifies the test name of the event criteria. (Optional) Specifies the event criteria match for the diagnostic result matches with the GOLD diagnostic error:

minorSpecifies to match to minor GOLD diagnostic errors. moderateSpecifies to match moderate GOLD diagnostic errors. majorSpecifies to match major GOLD diagnostic errors. bootupSpecifies the diagnostic tests running on system bootup. ondemandSpecifies the diagnostic tests running from CLI after the module is online. scheduleSpecifies the scheduled diagnostic tests. monitoringSpecifies the diagnostic tests that are running periodically in the background to monitor the health of the system.

testing-type

Specifies the event criteria based on the testing types of diagnostic from GOLD:

consecutive-failure Specifies the event criteria based on consecutive test failure information from cnt GOLD.

Defaults

None

Command Modes

Embedded event manager

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

148

OL-25806-03

E Commands event gold

Usage Guidelines

This command does not require a license.

Examples

This example shows how to specify that an EEM applet runs when a new GOLD failure event occurs for any module:
switch# configure terminal switch(config)# event manager applet gold-match switch(config-applet)# event gold module all test atBoot testing-type bootup switch(config-applet)#

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

149

E Commands event manager applet

event manager applet

To register an applet with the Embedded Event Manager (EEM) and to enter applet configuration mode, use the event manager applet command. To remove the applet command from the configuration, use the no form of this command. event manager applet applet-name [override name] no event manager applet applet-name

Syntax Description

applet-name override name

Unique identifier for the applet. This identifier can be any string value. (Optional) Specifies this policy will override a system policy. The name is the name of the system policy to override. It should begin with a double underscore.

Defaults

None

Command Modes

Embedded event manager

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to register an applet with EEM and to enter applet configuration mode:
switch# configure terminal switch(config)# event manager applet eem-applet switch(config-applet)#

Cisco Nexus 7000 Series NX-OS System Management Command Reference

150

OL-25806-03

E Commands event manager clear counter

event manager clear counter

To specify an Embedded Event Manager (EEM) counter to clear, use the event manager clear counter command. event manager clear counter counter-name

Syntax Description

counter-name

Name of the counter to clear.

Defaults

None

Command Modes

Embedded event manager

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to clear an EEM counter:

switch# configure terminal switch(config)# event manager clear counter eem-counter switch(config)#

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

151

E Commands event manager clear history events

event manager clear history events

To clear all Embedded Event Manager (EEM) event history, use the event manager clear history events command. event manager clear history events

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Embedded event manager

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to clear all of the EEM event history:
switch# configure terminal switch(config)# event manager clear history events switch(config)#

Cisco Nexus 7000 Series NX-OS System Management Command Reference

152

OL-25806-03

E Commands event manager environment

event manager environment

To set an Embedded Event Manager (EEM) environment variable, use the event manager environment command. To disable an EEM environment variable, use the no form of this command. event manager environment varname varvalue no event manager environment varname

Syntax Description

varname varvalue

Name of the EEM environment variable. String of characters, including embedded spaces, to be placed in the environment variable varname.

Defaults

None

Command Modes

Embedded event manager

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to set an EEM environment variable:

switch# configure terminal switch(config)# event manager environment _cron_entry 0-59/2 0-23/1 * * 0-7 switch(config)#

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

153

E Commands event manager policy

event manager policy

To register an Embedded Event Manager (EEM) policy with the EEM, use the event manager policy command. To remove the event manager policy command from the configuration file, use the no form of this command. event manager policy VSHscriptfilename no event manager policy VSHscriptfilename

Syntax Description

VSHscriptfilename Name of the VSH script file to register with the EEM. This name becomes the name of the EEM policy.
Note

System policy names begin with two underscore characters (__).

Defaults

None

Command Modes

Embedded event manager

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license. The EEM schedules and runs policies on the basis of an event specification that is contained within the policy itself. When the event manager policy command is invoked, the EEM examines the policy and registers it to be run when the specified event occurs.

Examples

This example shows how to register a policy:

switch# configure terminal switch(config)# event manager policy fanpolicy.vsh switch(config)#

Cisco Nexus 7000 Series NX-OS System Management Command Reference

154

OL-25806-03

E Commands event manager run

event manager run

To manually run a registered Embedded Event Manager (EEM) policy, use the event manager run command. event manager run policy-name

Syntax Description

policy-name

Name of the registered EEM policy to run.

Note

System policy names begin with two underscore characters (__).

Defaults

None

Command Modes

Embedded event manager

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to manually run a registered EEM policy:

switch# configure terminal switch(config)# event manager run fanpolicy.vsh switch(config)#

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

155

E Commands event module-failure

event module-failure
To specify an event criteria for an Embedded Event Manager (EEM) applet that is run on the basis of a module failure event, use the event module-failure command. To remove the module failure event criteria, use the no form of this command. event module-failure type err-name module {all | module} count count [time interval] no event module-failure type err-name module {all | module} count count

Syntax Description

type err-name

Specifies the type of failure condition. Select one of the err-name conditions: anyAny failure addon-sequence-failureAddon sequence failure hitless-upgrade-diag-failureRuntime diagnostic failure after hitless upgrade hitless-upgrade-failureHitless upgrade failure hitless-upgrade-procmgr-notifLC software failure after hitless upgrade hitless-upgrade-reg-failureRegistration failure after hitless upgrade hitless-upgrade-seq-timeoutHitless upgrade sequence timeout image-download-failedImage download failure image-upgrade-failedImage upgrade failed insertion-seq-failureInsertion sequence failure lc-failedLC failed lc-not-respondingLC not responding lc-ready-timeoutLC ready timeout lc-sw-failureLC software failure registration-failureRegistration failure registration-timeoutRegistration timeout runtime-diag-failureRuntime diag failure runtime-diag-timeoutRuntime diag timeout sequence-timeoutSequence timeout srg-info-resp-timeoutSRG info response timeout unexpected-registrationUnexpected registration received upgrade-srg-not-compatibleUpgrade SRG not compatible

module module all count count time interval

Specifies that one module or all modules must be monitored. Number of a specific module to be monitored. Specifies that all modules are to be monitored. Specifies the number of matching occurrences before a module failure event is triggered. The range is from 0 to 4294967295. (Optional) Specifies the time interval (in seconds) within which the events need to happen. The range is from 0 to 4294967295.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

156

OL-25806-03

E Commands event module-failure

Defaults

None

Command Modes

Embedded event manager

SupportedUserRoles

network-admin vdc-admin

Command History

Release 5.2.(1) 4.0(1)

Modification Added the tag tag keywords. This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to specify that an EEM applet runs when a module failure event occurs:
switch# configure terminal switch(config)# event manager applet modfail-applet switch(config-applet)# event module-failure type unexpected-registration module 6 count 2 switch(config-applet)#

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

157

E Commands event module status

event module status

To configure a status event on a module, use the event module status command. To remove the status event configuration, use the no form of this command. event module status {online | offline | any} module {all | module-number} no event module status {online | offline | any} module {all | module-number}

Syntax Description

online offline any module all

Specifies the online status. Specifies the offline status. Specifies the online or offline status. Specifies a module. Specifies all modules.

module-number Module number. The range is from 1 to 18.

Defaults

None

Command Modes

Embedded event manager

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure a status event on a module:

switch(config)# event manager applet EVM1 switch(config-applet)# event module status any module 10 switch(config-applet)#

This example shows how to remove the status event configuration:

switch(config-applet)# no event module status any module 10 switch(config-applet)#

Cisco Nexus 7000 Series NX-OS System Management Command Reference

158

OL-25806-03

E Commands event module status

Related Commands

Command event manager applet event manager policy

Description Registers an applet with the Embedded Event Manager (EEM). Registers an Embedded Event Manager (EEM) policy with the EEM.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

159

E Commands event oir

event oir
To specify that an Embedded Event Manager (EEM) applet be run on the basis of an event raised when a hardware online insertion and removal (OIR) occurs, use the event oir command. This command has three forms; fan, module, and powersupply. To remove the OIR specification from the configuration, use the no form of this command. event oir [tag tag] {fan | module | powersupply} {insert | remove | anyoir} [number] no event oir [tag tag] {fan | module | powersupply} {insert | remove | anyoir} [number]

Syntax Description

tag tag fan module powersupply insert remove anyoir number

(Optional) Identifies this specific event when multiple events are included in the policy. Specifies the system fans. Optionally, specify an individual fan. Specifies the system modules. Optionally, specify an individual module. Specifies the system power supplies. Optionally, specify an individual power supply. Specifies to insert OIR. Specifies to remove OIR. Specifies to either insert or remove OIR. (Optional) If you selected fan, enter a fan number to monitor for an OIR event. The range is from 1 to 4. If you selected module, enter a module number to monitor for an OIR event. The range is from 1 to 10. If you selected powersupply, enter a power supply number to monitor for an OIR event. The range is from 1 to 3.

Defaults

None

Command Modes

Embedded event manager

SupportedUserRoles

network-admin vdc-admin

Command History

Release 5.2.(1) 4.0(1)

Modification Added the tag tag keywords. This command was introduced.

Usage Guidelines

This command does not require a license.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

160

OL-25806-03

E Commands event oir

Examples

This example shows how to specify that an EEM applet be run on the basis of an event raised when a module OIR occurs:
switch# configure terminal switch(config)# event manager applet oir-applet switch(config-applet)# event oir module anyoir switch(config-applet)#

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

161

E Commands event policy-default

event policy-default
To use the event if a system policy is being overridden, use the event policy-default command. To use the overridden policy, use the no form of this command. event policy-default count count [time interval] no event policy-default count count

Syntax Description

count count time interval

Specifies the number of matching occurrences before a default event is triggered. The range is from 0 to 4294967295. (Optional) Specifies the time interval (in seconds) within which the events need to happen. The range is from 0 to 4294967295.

Defaults

None

Command Modes

Embedded event manager

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to use the event in the system policy being overridden:
switch# configure terminal switch(config)# event policy-default count 6 switch(config)#

Cisco Nexus 7000 Series NX-OS System Management Command Reference

162

OL-25806-03

E Commands event snmp

event snmp
To specify the event criteria for an Embedded Event Manager (EEM) applet that is run by sampling Simple Network Management Protocol (SNMP) object identifier values, use the event snmp command. To remove the SNMP event criteria, use the no form of this command. event snmp [tag tag] oid value get-type {exact | next} entry-op {gt | ge | eq | ne | lt | le} entry-val value [{exit-comb {or | and} exit-op {gt | ge | eq | ne | lt | le} exit-val value exit-time time} | {exit-op {gt | ge | eq | ne | lt | le} exit-val value}] poll-interval value no event snmp [tag tag] oid value get-type {exact | next} entry-op {gt | ge | eq | ne | lt | le} entry-val value [{exit-comb {or | and} exit-op {gt | ge | eq | ne | lt | le} exit-val value exit-time time} | {exit-op {gt | ge | eq | ne | lt | le} exit-val value}] poll-interval value

Syntax Description

tag tag oid value

(Optional) Identifies this specific event when multiple events are included in the policy. Specifies the SNMP object identifier (object ID) values in the value argument as the event criteria. The value of the data element must be in SNMP dotted notation. An OID is defined as a type in the associated MIB and each type has an object value. Monitoring of some OID types is supported. When the oid keyword is used, an error message is returned if the OID is not one of the following:

INTEGER_TYPE COUNTER_TYPE GAUGE_TYPE TIME_TICKS_TYPE COUNTER_64_TYPE OCTET_PRIM_TYPE OPAQUE_PRIM_TYPE

get-type exact next entry-op op

Specifies the type of SNMP get operation to be applied to the object ID specified by the oid value argument. Retrieves the object ID specified by the oid value argument. Retrieves the object ID that is the alphanumeric successor to the object ID specified by the oid value argument. Compares the contents of the current object ID value with the entry value using the specified operator:

gtGreater than geGreater than or equal to eqEqual to neNot equal to ltLess than leLess than or equal to

If there is a match, an event is triggered and event monitoring is disabled until the exit criteria are met.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

163

E Commands event snmp

entry-val value exit-comb or and exit-op op

Specifies the value with which the contents of the current object ID are compared to decide if an SNMP event should be raised. (Optional) Indicates the combination of exit conditions that must be met before event monitoring is reenabled. (Optional) Specifies that an exit comparison operator and an exit object ID value or an exit time value must exist. (Optional) Specifies that an exit comparison operator, an exit object ID value, and an exit time value must exist. (Optional) Compares the contents of the current object ID with the exit value using the specified operator:

gtGreater than geGreater than or equal to eqEqual to neNot equal to ltLess than leLess than or equal to This keyword and its argument are not optional if the exit-comb keyword is defined.

If there is a match, an event is triggered and event monitoring is reenabled.

Note

exit-val value

(Optional) Specifies the value with which the contents of the current object ID are compared to decide whether the exit criteria are met.
Note

This keyword and its argument are not optional if the exit-comb keyword is defined.

poll-interval value Specifies the time interval between consecutive polls. The value argument is an integer that represents seconds in the range from 1 to 4294967295. The minimum polling interval is 1 second.

Defaults

None

Command Modes

Embedded event manager

SupportedUserRoles

network-admin vdc-admin

Command History

Release 5.2.(1) 4.0(1)

Modification Added the tag tag keywords. This command was introduced.

Usage Guidelines

This command does not require a license.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

164

OL-25806-03

E Commands event snmp

Examples

This example shows how to specify the event criteria for an EEM applet that is run by sampling SNMP object identifier values:
switch# configure terminal switch(config)# event manager applet snmp-applet switch(config-applet)# event snmp oid 4.2.1.6 get-type next entry-op eq entry-val 42 poll-interval 2 switch(config-applet)#

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

165

E Commands event storm-control

event storm-control
To specify an event criteria for an Embedded Event Manager (EEM) applet that is run on the basis of a storm control event, use the event storm-control command. To remove the storm control event criteria, use the no form of this command. event storm-control no event storm-control

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Embedded event manager

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to specify that an EEM applet runs when a storm control event occurs:
switch# configure terminal switch(config)# event manager applet storm-applet switch(config-applet)# event storm-control switch(config-applet)#

Cisco Nexus 7000 Series NX-OS System Management Command Reference

166

OL-25806-03

E Commands event syslog

event syslog
To configure Cisco NX-OS Embedded Event Manager (EEM) to monitor an event, use the event syslog command. To remove the syslog configuration, use the no form of this command. event syslog [ tag tag] [occurs | pattern msg-text | period | priority [0-7 | emergencies | alerts | critical | errors | warnings | notifications | informational | debugging]] no event syslog [tag tag] [occurs | pattern msg-text | period | priority [0-7 | emergencies | alerts | critical | errors | warnings | notifications | informational | debugging]]

Syntax Description

tag tag occurs pattern msg-text

(Optional) Identifies this specific event when multiple events are included in the policy. (Optional) Specifies the number of occurrences. The range is from 1 to 65000. (Optional) Specifies the matching regular expression (regex). The pattern can contain character text, an environment variable, or a combination of the two. If the string contains embedded blanks, it is enclosed with double quotation marks. (Optional) Specifies the time interval during which the event occurs. The range is from 0 to 4294967295. (Optional) Specifies the priority level of the syslog messages. If this keyword is not selected, all syslog messages are set at the informational priority level. If this keyword is selected, the priority level argument must be defined. (Optional) Enters the priority of the log message. (Optional) Specifies that the system is unusable. (Optional) Specifies that immediate action is needed. (Optional) Specifies critical conditions. (Optional) Specifies error conditions. (Optional) Specifies warning conditions. (Optional) Specifies normal but significant conditions. (Optional) Specifies informational messages. This is the default. (Optional) Specifies debugging messages.

period priority

0-7 emergencies alerts critical errors warnings notifications informational debugging

Defaults

None

Command Modes

Embedded event manager

SupportedUserRoles

network-admin vdc-admin

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

167

E Commands event syslog

Command History

Release 5.2.(1) 5.1(1)

Modification Added the tag tag keywords. This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure a syslog message to monitor when an EEM applet is triggered:
switch# configure terminal switch(config-applet)# event syslog occurs 10 pattern "authentication failed" Configuration accepted successfully

This example shows how to remove the syslog message monitor configuration:
switch# configure terminal switch(config-applet)# event syslog occurs 10 pattern "authentication failed" Configuration accepted successfully

Related Commands

Command action syslog

Description Configures a syslog message to generate when an Embedded Event Manager (EEM) applet is triggered.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

168

OL-25806-03

E Commands event temperature

event temperature
To specify an event criteria for an Embedded Event Manager (EEM) applet that is run on the basis of a temperature event, use the event temperature command. To remove the temperature event criteria, use the no form of this command. event temperature [module module] [sensor number] threshold {major | minor | any} no event temperature threshold {major | minor | any}

Syntax Description

module module sensor number threshold major minor any

(Optional) Specifies that a specific module must be monitored.The range is from 1 to 10. (Optional) Specify that a specific sensor must be monitored. The range is from 1 to 18. Specifies the threshold event that triggers the EEM applet. Choose either major, minor, or any (major or minor). Specifies a major event. Specifies a minor event. Specifies any event.

Defaults

None

Command Modes

Embedded event manager

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to specify that an EEM applet runs when a temperature event occurs:
switch# configure terminal switch(config)# event manager applet temp-applet switch(config-applet)# event temperature threshold major switch(config-applet)#

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

169

E Commands event track

event track
To specify the event criteria for an Embedded Event Manager (EEM) applet that is run on the basis of an object tracking subsystem report for the specified object number, use the event track command. To remove the report event criteria, use the no form of this command. event track [tag tag] object-id state {any | up | down} no event track [tag tag] object-id

Syntax Description

tag tag object-id state up down any

(Optional) Identifies this specific event when multiple events are included in the policy. Tracked object number. The range from 1 to 500. Specifies that the tracked object transition causes an event to be raised. Specifies an event is to be raised when the tracked object transitions from a down state to an up state. Specifies an event is to be raised when the tracked object transitions from an up state to a down state. Specifies an event is to be raised when the tracked object transitions to or from any state.

Defaults

None

Command Modes

Embedded event manager

SupportedUserRoles

network-admin vdc-admin

Command History

Release 5.2.(1) 4.0(1)

Modification Added the tag tag keywords. This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to specify that an EEM applet runs when the state of a tracked object changes:
switch# configure terminal switch(config)# event manager applet tracking-applet switch(config-applet)# event track 42 state down switch(config-applet)#

Cisco Nexus 7000 Series NX-OS System Management Command Reference

170

OL-25806-03

E Commands event track

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

171

E Commands exporter

exporter
To specify a NetFlow exporter to use for a NetFlow monitor, use the exporter command. To remove a NetFlow exporter, use the no form of this command. exporter name no exporter name

Syntax Description

name

Name of the exporter.

Defaults

None

Command Modes

NetFlow monitor configuration (config-flow-monitor)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure a NetFlow exporter for a NetFlow monitor:
switch(config)# flow monitor Custom-Flow-Monitor-1 switch(config-flow-monitor)# exporter Custom-Flow-Exporter-1 switch(config-flow-monitor)#

This example shows how to remove a NetFlow exporter:

switch(config-flow-monitor)# no exporter

Related Commands

Command show flow sw-monitor

Description Displays information about NetFlow monitors.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

172

OL-25806-03

F Commands
This chapter describes the Cisco NX-OS system management commands that begin with the letter F.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

173

F Commands feature lldp

feature lldp
To enable the Link Layer Discovery Protocol (LLDP) feature globally, use the feature lldp command. To disable the LLDP feature, use the no form of this command. feature lldp no feature lldp

Syntax Description

This command has no arguments or keywords.

Defaults

Disabled

Command Modes

Global configuration mode (config)

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 5.0(1)

Modification This command was introduced.

Usage Guidelines

In order for LLDP to discover servers connected to your device, the servers must be running openLLDP software. LLDP must be enabled on the device before you can enable or disable it on any interfaces.

Note

LLDP is supported only on physical interfaces. LLDP timers and type, length, and value (TLV) descriptions cannot be configured using Cisco DCNM. LLDP can discover up to one device per port. LLDP can discover up to one server per port. LLDP can discover only Linux servers that are connected to your device. LLDP can discover Linux servers, if they are not using a converged network adapter (CNA); however, LLDP cannot discover other types of servers. Make sure that you are in the correct virtual device context (VDC). To switch VDCs, use the switchto vdc command. This command does not require a license.

Examples

This example shows how to enable the LLDP feature globally:

Cisco Nexus 7000 Series NX-OS System Management Command Reference

174

OL-25806-03

F Commands feature lldp

switch(config)# feature lldp switch(config)

This example shows how to disable the LLDP feature:

switch(config)# no feature lldp switch(config)#2010 Jan 11 01:50:33 switch %FEATURE-MGR-2-FM_AUTOCKPT_IN_PROGRESS: AutoCheckpoint system-fm-lldp's creation in progress... 2010 Jan 21 01:50:34 switch %FEATURE-MGR-2-FM_AUTOCKPT_SUCCEEDED: AutoCheckpoint created successfully switch(config)#

Related Commands

Command show running-config lldp

Description Displays the global LLDP configuration.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

175

F Commands feature netflow

feature netflow
To globally enable the NetFlow feature, use the feature netflow command. To disable NetFlow, use the no form of this command. feature netflow no feature netflow

Syntax Description

This command does not have any arguments or keywords.

Defaults

Disabled

Command Modes

Global configuration mode

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to enable NetFlow on a Cisco NX-OS device:

switch(config)# configure terminal switch(config)# feature netflow switch(config)#

This example shows how to disable NetFlow on a Cisco NX-OS device:

switch(config)# no feature netflow switch(config)#

Related Commands

Command flow record show flow record

Description Creates a flow record and enters flow record configuration mode. Displays information about NetFlow flow records.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

176

OL-25806-03

F Commands feature ntp

feature ntp
To enable the Network Time Protocol (NTP) on a virtual device context (VDC), use the feature ntp command. To disable NTP on a VDC, use the no form of this command. feature ntp no feature ntp

Syntax Description

This command does not have any arguments or keywords.

Defaults

Enabled

Command Modes

Global configuration mode

SupportedUserRoles

network-admin vdc-admin

Command History

Release 5.2(1)

Modification This command was introduced.

Usage Guidelines

Make sure that you are in the correct virtual device context (VDC). To change the VDC, use the switchto vdc command. This command does not require a license.

Examples

This example shows how to enable NTP on a VDC:

switch# configure terminal switch(config)# feature ntp

This example shows how to disable NTP on a VDC:

switch# configure terminal switch(config)# no feature ntp

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

177

F Commands feature ntp

Related Commands

Command ntp master ntp enable

Description Configures the device to act as an authoritative NTP server. Enables the NTP feature on a VDC.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

178

OL-25806-03

F Commands feature ptp

feature ptp
To enable the Precision Time Protocol (PTP) feature on the current virtual device context (VDC), use the feature ptp command. To disable the PTP feature, use the no form of this command. feature ptp no feature ptp

Syntax Description

This command has no arguments or keywords.

Defaults

Disabled

Command Modes

Global configuration mode

SupportedUserRoles

network-admin vdc-admin

Command History

Release 5.2(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to enable the PTP feature on the current VDC:
switch# configure terminal switch(config)# feature ptp switch(config)#

This example shows how to disable the PTP feature on the current VDC:
switch(config)# no feature ptp 2011 Jul 5 06:11:07 switch %FEATURE-MGR-2-FM_AUTOCKPT_IN_PROGRESS: AutoCheckpoi nt system-fm-ptp's creation in progress... 2011 Jul 5 06:11:07 switch %FEATURE-MGR-2-FM_AUTOCKPT_SUCCEEDED: AutoCheckpoint created successfully switch(config)#

Related Commands

Command ptp source ptp domain ptp priority1

Description Configures the source IP address for all PTP packets. Configures the domain number to use for this clock. Configures the priority1 value to use when advertising this clock.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

179

F Commands feature ptp

Command ptp priority2 show ptp brief show ptp clock

Description Configures the priority2 value to use when advertising this clock. Displays the PTP status. Displays the properties of the local clock.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

180

OL-25806-03

F Commands feature scheduler

feature scheduler
To enable the scheduling of maintenance jobs, use the feature scheduler command. To disable the scheduler, use the no form of this command. feature scheduler no feature scheduler

Syntax Description

This command has no arguments or keywords.

Defaults

Disabled

Command Modes

Global configuration mode

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modified This command was introduced.

Usage Guidelines

You must enable the scheduler feature before you can configure a maintenance job. Maintenance jobs can be scheduled for one-time-only or at periodic intervals. Maintenance jobs include quality of service policy changes, data and configuration backup, and so on. This command does not require a license.

Examples

This example shows how to enable the scheduler:

switch# config t switch(config)# feature scheduler switch(config)#

This example shows how to disable the scheduler:

switch# config t switch(config)# no feature scheduler switch(config)#

Related Commands

Command scheduler show scheduler

Description Creates and schedules maintenance jobs. Displays scheduler information.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

181

F Commands filter (ERSPAN)

filter (ERSPAN)
To configure the filters for an Encapsulated Remote Switched Port Analyzer (ERSPAN) session, use the filter command. To remove the filters, use the no form of this command. filter [access-group acl-filter] [vlan vlan-range] [bpdu [true | false]] [cos cos-value] [dest-mac dest-mac] [eth-type eth-value] [flow-hash flow-value] [pc-lane port-number] [src_mac mac-address] [trace-route [true | false]] no filter [access-group acl-filter] [vlan vlan-range] [bpdu [true | false]] [cos cos-value] [dest-mac dest-mac] [eth-type eth-value] [flow-hash flow-value] [pc-lane port-number] [src_mac mac-address] [trace-route [true | false]]

Syntax Description

access-group acl-filter vlan vlan-range bpdu true false cos cos-value dest-mac dest-mac eth-type eth-value flow-hash flow-value src_mac mac-address trace-route true false

(Optional) Specifies a filter based on an access control group. (Optional) Specifies a filter based on a VLAN range. (Optional) Specifies a filter based on the bridge protocol data unit (BPDU) class of packets. (Optional) Specifies that a filter based on the bridge protocol data unit (BPDU) class of packets is used. (Optional) Specifies a filter based on non-BPDU class of packets. (Optional) Specifies a filter based on the class of service (CoS) in the dotlq header. (Optional) Specifies a filter based on a destination MAC address. (Optional) Specifies a filter based on the Ethernet type. (Optional) Specifies a filter based on the result bundle hash (RBH) value.

pc-lane port-number (Optional) Specifies a filter based on a member of the port channel. (Optional) Specifies a filter based on a source MAC address. (Optional) Specifies a filter based on trace-route packets. (Optional) Specifies a that a filter based on trace-route packets is used. (Optional) Specifies a filter based on non trace-route packets.

Defaults

None

Command Modes

config-erspan-src mode

SupportedUserRoles

network-admin VDC-admin

Cisco Nexus 7000 Series NX-OS System Management Command Reference

182

OL-25806-03

F Commands filter (ERSPAN)

Command History

Release 6.2(2)

Modification This command was introduced.

Usage Guidelines

You can configure filters for ingress or egress ERSPAN traffic based on a set of rules. A simple filter has only one rule, and multiple fields or conditions can be added to this rule. The packets are spanned only if all conditions are met. Port channel member lane is not supported on F1 Series modules. F2 and F2e Series modules do not support egress SPAN filtering for destination MAC addresses and source MAC addresses. This command does not require a license.

Examples

This example shows how to configure filters for an ERSPAN session:

switch# configure terminal switch(config)# monitor session 3 type erspan-source switch(config-erspan-src)# filter vlan 3-5 switch(config-erspan-src)# filter trace-route true

Related Commands

Command filter (SPAN)

Description Configures the filters for a SPAN session.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

183

F Commands filter (SPAN)

filter (SPAN)
To configure the filters for an Ethernet Switched Port Analyzer (SPAN) session, use the filter command. To remove the filters, use the no form of this command. filter [vlan vlan-range] [bpdu [true | false]] [cos cos-value] [dest-mac dest-mac] [eth-type eth-value] [flow-hash flow-value] [pc-lane port-number] [src_mac mac-address] [trace-route [true | false]] no filter [vlan vlan-range] [bpdu [true | false]] [cos cos-value] [dest-mac dest-mac] [eth-type eth-value] [flow-hash flow-value] [pc-lane port-number] [src_mac mac-address] [trace-route [true | false]]

Syntax Description

vlan vlan-range bpdu true false cos cos-value dest-mac dest-mac eth-type eth-value flow-hash flow-value src_mac mac-address trace-route true false

(Optional) Specifies a filter based on a VLAN range. (Optional) Specifies a filter based on the bridge protocol data unit (BPDU) class of packets. (Optional) Specifies that a filter based on the bridge protocol data unit (BPDU) class of packets is used. (Optional) Specifies a filter based on non-BPDU class of packets. (Optional) Specifies a filter based on the class of service (CoS) in the dotlq header. (Optional) Specifies a filter based on a destination MAC address. (Optional) Specifies a filter based on the Ethernet type. (Optional) Specifies a filter based on the result bundle hash (RBH) value.

pc-lane port-number (Optional) Specifies a filter based on a member of the port channel. (Optional) Specifies a filter based on a source MAC address. (Optional) Specifies a filter based on trace-route packets. (Optional) Specifies a that a filter based on trace-route packets is used. (Optional) Specifies a filter based on non trace-route packets.

Defaults

None

Command Modes

Config-monitor configuration mode (config-monitor)

SupportedUserRoles

network-admin VDC-admin

Command History

Release 6.2(2)

Modification This command was introduced.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

184

OL-25806-03

F Commands filter (SPAN)

Usage Guidelines

You can configure filters for ingress or egress SPAN traffic based on a set of rules. A simple filter has only one rule, and multiple fields or conditions can be added to this rule. The packets are spanned only if all conditions are met. Port channel member lane is not supported on F1 Series modules. F2 and F2e Series modules do not support egress SPAN filtering for destination MAC addresses and source MAC addresses. This command does not require a license.

Examples

This example shows how to configure filters for an SPAN session:

switch# configure terminal switch(config)# monitor session 3 switch(config-monitor)# filter vlan 3-5 switch(config-monitor)# filter trace-route true

Related Commands

Command filter (ERSPAN) show monitor session

Description Configures the filters for an ERSPAN session. Displays information about a SPAN or ERSPAN session.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

185

F Commands filter access-group

filter access-group
To apply an access group to an Encapsulated Remote Switched Port Analyzer (ERSPAN) source session, use the filter access-group command. To remove an access group, use the no form of this command. filter access-group acl_filter no filter access-group acl_filter

Syntax Description

acl_filter

Access control list (ACL) name. An ACL associates the access list with the SPAN session.

Defaults

None

Command Modes

config-monitor-erspan-src

SupportedUserRoles

network-admin VDC-admin

Command History

Release 5.1(1)

Modification This command was introduced.

Usage Guidelines

Only the permit to deny actions are allowed for Encapsulated Remote Switched Port Analyzer (ERSPAN) access control list (ACL) filters. For information about ACL-related commands, see the Cisco Nexus 7000 Series NX-OS Security Command Reference. This command does not require a license.

Examples

This example shows how to apply an access group to an ERSPAN session:

switch# configure terminal switch(config)# monitor session 3 type erspan-source switch(config-monitor-erspan-src)# filter vlan 3-5, 7 switch(config-monitor-erspan-src)# filter access-group ACL1

This example shows how to disassociate an access group to an ERSPAN session:

switch# configure terminal switch(config)# monitor session 3 type erspan-source switch(config-monitor-erspan-src)# filter vlan 3-5, 7 switch(config-monitor-erspan-src)# no filter access-group ACL1

Cisco Nexus 7000 Series NX-OS System Management Command Reference

186

OL-25806-03

F Commands filter access-group

Related Commands

Command filter vlan

Description Applies a VLAN filter to a session.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

187

F Commands filter frame-type arp

filter frame-type arp

To configure the Address Resolution Protocol (ARP) frame type filter for the Encapsulated Remote Switched Port Analyzer (ERSPAN) session, use the filter frame-type arp command. To remove the filter from the session, enter the no form of this command. filter frame-type arp [arp-rarp [arp | rarp] [req-resp [req | rsp]] [sender-ip ip-address] [target-ip ip-address]] no filter frame-type arp [arp-rarp [arp | rarp] [req-resp [req | rsp]] [sender-ip ip-address] [target-ip ip-address]]

Syntax Description

arp-rarp arp rarp req-resp req resp sender-ip ip-address target-ip ip-address

(Optional) Specifies an ARP or Reverse Address Resolution Protocol (RARP) frame type filter. (Optional) Specifies an ARP frame type filter. (Optional) Specifies an RARP frame type filter. (Optional) Specifies a filter based on a request or response. (Optional) Specifies a filter based on a request. (Optional) Specifies a filter based on a response. (Optional) Specifies a filter based on a sender IP address. (Optional) Specifies a filter based on a target IP address.

Defaults

None

Command Modes

config-erspan-src mode

SupportedUserRoles

network-admin vdc-admin

Command History

Release 6.2(2)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure the ARP frame type filter for the ERSPAN session:
switch(config)# monitor session 1 type erspan-source switch(config-erspan-src)# filter frame-type arp arp-rarp arp

Cisco Nexus 7000 Series NX-OS System Management Command Reference

188

OL-25806-03

F Commands filter frame-type arp

Related Commands

Command filter (ERSPAN) filter frame-type eth filter frame-type fcoe filter frame-type ipv4 filter frame-type ipv6 monitor session

Description Configures the filters for an ERSPAN session. Configures the Ethernet frame type filter for the SPAN or ERSPAN session. Configures the FCoE frame type filter for the SPAN or ERSPAN session. Configures the IPv4 frame type filter for the SPAN or ERSPAN session. Configures the IPv6 frame type filter for the SPAN or ERSPAN session. Places you in the monitor configuration mode for configuring a SPAN or ERSPAN session.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

189

F Commands filter frame-type eth

filter frame-type eth

To configure the Ethernet frame type filter for the Ethernet Switched Port Analyzer (SPAN) or Encapsulated Remote Switched Port Analyzer (ERSPAN) session, use the filter frame-type eth command. To remove the Ethernet frame type filter, use the no form of this command. filter frame-type eth no filter frame-type eth

Syntax Description

This command has no arguments or keywords.

Command Modes

config-monitor mode (for a SPAN session) config-erspan-src mode (for an ERSPAN session)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 6.2(2)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure the Ethernet frame type filter for a SPAN session:
switch(config)# monitor session 1 switch(config-monitor)# filter frame-type eth

This example shows how to configure the Ethernet frame type filter for an ERSPAN session:
switch(config)# monitor session 1 type erspan-source switch(config-erspan-src)# filter frame-type eth

Related Commands

Command filter (ERSPAN) filter (SPAN) filter frame-type arp filter frame-type fcoe filter frame-type ipv4

Description Configures the filters for an ERSPAN session. Configures the filters for a SPAN session. Configures the ARP frame type filter for the ERSPAN session. Configures the FCoE frame type filter for the SPAN or ERSPAN session. Configures the IPv4 frame type filter for the SPAN or ERSPAN session.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

190

OL-25806-03

F Commands filter frame-type eth

Command filter frame-type ipv6 monitor session

Description Configures the IPv6 frame type filter for the SPAN or ERSPAN session. Places you in the monitor configuration mode for configuring a SPAN or ERSPAN session.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

191

F Commands filter frame-type fcoe

filter frame-type fcoe

To configure the Fibre Channel over Ethernet (FCoE) frame type filter for the Ethernet Switched Port Analyzer (SPAN) or Encapsulated Remote Switched Port Analyzer (ERSPAN) session, use the filter frame-type fcoe command. To remove the FCoE frame type filter, use the no form of this command. filter frame-type fcoe [[fc-sid FC-source-ID] [fc-did FC-dest-ID] [fcoe-type fcoe-value] [r-ctl r-ctl-value] [sof sof-value] [cmd-code cmd-value]] no filter frame-type fcoe [[fc-sid FC-source-ID] [fc-did FC-dest-ID] [fcoe-type fcoe-value] [r-ctl r-ctl-value] [sof sof-value] [cmd-code cmd-value]]

Syntax Description

fc-sid FC-source-ID fcoe-type fcoe-value r-ctl r-ctl-value sof sof-value cmd-code cmd-value

(Optional) Specifies a filter based on an FC source ID.

fc-did FC-dest-ID (Optional) Specifies a filter based on an FC destination ID. (Optional) Specifies a filter based on an FCoE type. (Optional) Specifies a filter based on the routing control flags (R CTL) value. (Optional) Specifies a filter based on the start of frame (SOF) packets. (Optional) Specifies a filter based on a command code.

Defaults

None

Command Modes

config-monitor mode (for a SPAN session) config-erspan-src mode (for an ERSPAN session)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 6.2(2)

Modification This command was introduced.

Usage Guidelines

F1 Series modules do not support FCoE source IDs and FCoE destination IDs. This command does not require a license.

Examples

This example shows how to configure the FCoE frame type filter for a SPAN session:
switch(config)# monitor session 1 switch(config-monitor)# filter frame-type fcoe

Cisco Nexus 7000 Series NX-OS System Management Command Reference

192

OL-25806-03

F Commands filter frame-type fcoe

This example shows how to configure the FCoE frame type filter for an ERSPAN session:
switch(config)# monitor session 1 type erspan-source switch(config-erspan-src)# filter frame-type fcoe fc-did 2

Related Commands

Command filter (ERSPAN) filter (SPAN) filter frame-type arp filter frame-type eth filter frame-type ipv4 filter frame-type ipv6 monitor session

Description Configures the filters for an ERSPAN session. Configures the filters for a SPAN session. Configures the ARP frame type filter for the ERSPAN session. Configures the FCoE frame type filter for the SPAN or ERSPAN session. Configures the IPv4 frame type filter for the SPAN or ERSPAN session. Configures the IPv6 frame type filter for the SPAN or ERSPAN session. Places you in the monitor configuration mode for configuring a SPAN or ERSPAN session.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

193

F Commands filter frame-type ipv4

filter frame-type ipv4

To configure the IPv4 frame type filter for the Ethernet Switched Port Analyzer (SPAN) or Encapsulated Remote Switched Port Analyzer (ERSPAN) session, use the filter frame-type ipv4 command. To remove the Ethernet frame type filter, use the no form of this command. filter frame-type ipv4 [[src-ip src-ip] [dest-ip dest-ip] [tos tos-value] [l4-protocol l4-value]] no filter frame-type ipv4 [[src-ip src-ip] [dest-ip dest-ip] [tos tos-value] [l4-protocol l4-value]]

Syntax Description

src-ip src-ip dest-ip dest-ip tos tos-value l4-protocol l4-value

(Optional) Specifies a filter based on an IPv4 source IP address. (Optional) Specifies a filter based on an IPv4 destination IP address. (Optional) Specifies a filter based on the type of service (ToS) in the IP header. (Optional) Specifies a filter based on a Layer 4 protocol number set in the protocol field of the IP header.

Defaults

None

Command Modes

config-monitor mode (for a SPAN session) config-erspan-src mode (for an ERSPAN session)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 6.2(2)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure the IPv4 frame type filter for a SPAN session:
switch(config)# monitor session 1 switch(config-monitor)# filter frame-type ipv4 l4-protocol 3

This example shows how to configure the IPv4 frame type filter for an ERSPAN session:
switch(config)# monitor session 1 type erspan-source switch(config-erspan-src)# filter frame-type ipv4 l4-protocol 3

Cisco Nexus 7000 Series NX-OS System Management Command Reference

194

OL-25806-03

F Commands filter frame-type ipv4

Related Commands

Command monitor session filter (ERSPAN) filter (SPAN) filter frame-type arp filter frame-type eth filter frame-type fcoe filter frame-type ipv6

Description Places you in the monitor configuration mode for configuring a SPAN or ERSPAN session. Configures the filters for an ERSPAN session. Configures the filters for a SPAN session. Configures the ARP frame type filter for the ERSPAN session. Configures the FCoE frame type filter for the SPAN or ERSPAN session. Configures the FCoE frame type filter for the SPAN or ERSPAN session. Configures the IPv6 frame type filter for the SPAN or ERSPAN session

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

195

F Commands filter frame-type ipv6

filter frame-type ipv6

To configure the IPv6 frame type filter for the Ethernet Switched Port Analyzer (SPAN) or Encapsulated Remote Switched Port Analyzer (ERSPAN) session, use the filter frame-type ipv6 command. To remove the IPv6 frame type filter, use the no form of this command. filter frame-type ipv6 [src-ip src-ip] [dest-ip dest-ip] [tos tos-value] [l4-protocol l4-value] no filter frame-type ipv6 [src-ip src-ip] [dest-ip dest-ip] [tos tos-value] [l4-protocol l4-value]

Syntax Description

src-ip src-ip dest-ip dest-ip tos tos-value l4-protocol l4-value

(Optional) Specifies a filter based on an IPv6 source IP address. (Optional) Specifies a filter based on an IPv6 destination IP address. (Optional) Specifies a filter based on the type of service (ToS) in the IP header. (Optional) Specifies a filter based on a Layer 4 protocol number set in the protocol field of the IP header.

Defaults

None

Command Modes

config-monitor mode (for a SPAN session) config-erspan-src mode (for an ERSPAN session)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 6.2(2)

Modification This command was introduced.

Usage Guidelines

F1 Series modules have limited support for rule-based SPAN. They do not support IPv6 source IP and IPv6 destination IP filters. They support only IPv4 and IPv6 ToS filters with values from 0 to 3. F2 and F2e Series modules have limited support for rule-based SPAN. They do not support wildcards in the IPv6 source IP filter and IPv6 destination IP filter. This command does not require a license.

Examples

This example shows how to configure the IPv6 frame type filter for a SPAN session:
switch(config)# monitor session 1 switch(config-monitor)# filter frame-type ipv6 src-ip 10.0.0.1

This example shows how to configure the IPv6 frame type filter for an ERSPAN session:
switch(config)# monitor session 1 type erspan-source switch(config-erspan-src)# filter frame-type ipv6 src-ip 10.0.0.1

Cisco Nexus 7000 Series NX-OS System Management Command Reference

196

OL-25806-03

F Commands filter frame-type ipv6

Related Commands

Command monitor session filter (ERSPAN) filter (SPAN) filter frame-type arp filter frame-type eth filter frame-type fcoe filter frame-type ipv4

Description Places you in the monitor configuration mode for configuring a SPAN or ERSPAN session. Configures the filters for an ERSPAN session. Configures the filters for a SPAN session. Configures the ARP frame type filter for the ERSPAN session. Configures the FCoE frame type filter for the SPAN or ERSPAN session. Configures the FCoE frame type filter for the SPAN or ERSPAN session. Configures the IPv4 frame type filter for the SPAN or ERSPAN session

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

197

F Commands filter vlan

filter vlan
To apply a VLAN access map to one or more VLANs, use the filter vlan command. To remove a VLAN access map, use the no form of this command. filter vlan vlan_mrange [include-untagged] no filter vlan vlan_mrange [include-untagged]

Syntax Description

vlan_mrange

Name of the VLAN access map that you want to create or configure. The range is from 1 to 3967 and from 4048 to 4093.

include-untagged (Optional) Specifies untagged frames on a port with Layer 3 subinterfaces.

Defaults

None

Command Modes

Config-monitor configuration (config-monitor)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to apply a VLAN access map to one or more VLANs:
switch(config)# monitor session 1 switch(config-monitor)# filter vlan 5-10 include-untagged switch(config-monitor)#

This example shows how to remove the VLAN access map:

switch(config-monitor)# no filter vlan 5-10 include-untagged switch(config-monitor)#

Related Commands

Command filter vlan include-untagged

Description Applies a VLAN access map to one or more VLANs and includes untagged frames on a port with Layer 3 subinterfaces.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

198

OL-25806-03

F Commands filter vlan include-untagged

filter vlan include-untagged

To apply a VLAN access map to one or more VLANs and include untagged frames on a port with Layer 3 subinterfaces, use the filter vlan include-untagged command. To remove a VLAN access map to one or more VLANs with untagged frames on a port with Layer 3 subinterfaces, use the no form of this command. filter vlan include-untagged no filter vlan include-untagged

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Config-monitor configuration (config-monitor)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to apply a VLAN access map to one or more VLANs and include untagged frames on a port with Layer 3 subinterfaces:
switch(config)# monitor session 1 switch(config-monitor)# filter vlan 1-20 include-untagged switch(config-monitor)#

This example shows how to remove a VLAN access map to one or more VLANs with untagged frames on a port with Layer 3 subinterfaces:
switch(config-monitor)# no filter vlan 1-20 include-untagged switch(config-monitor)#

Related Commands

Command filter vlan

Description Applies a VLAN access map to one or more VLANs.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

199

F Commands flow exporter

flow exporter
To create a Flexible NetFlow flow exporter or to modify an existing Flexible NetFlow flow exporter, use the flow exporter command. To remove a Flexible NetFlow flow exporter, use the no form of this command. flow exporter exporter-name no flow exporter exporter-name

Syntax Description

exporter-name

Name of the flow exporter that is created or modified.

Defaults

Flow exporters are not present in the configuration until you create them.

Command Modes

Global configuration mode

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

Flow exporters export the data in the flow monitor cache to a remote system, such as a server running NetFlow collector, for analysis and storage. Flow exporters are created as separate entities in the configuration. Flow exporters are assigned to flow monitors to provide data export capability for the flow monitors. You can create several flow exporters and assign them to one or more flow monitors to provide several export destinations. You can create one flow exporter and apply it to several flow monitors. Once you enter the flow export configuration mode, the prompt changes to the following:
switch(config-flow-exporter)#

Within the flow export configuration mode, the following keywords and arguments are available to configure the flow exporters:

description descriptionProvides a description for this flow exporter; you can use a maximum of 63 characters. destination {ip-addr | ipv6-addr} [use-vrf label-name]Specifies the destination address for the collector. Enter the optional use-vrf label-name to specify a VRF. Use the following format when entering the destination address:
ip-addrA .B .C.D ipv6-addrA:B::C:D

Cisco Nexus 7000 Series NX-OS System Management Command Reference

200

OL-25806-03

F Commands flow exporter

dscp valueSpecifies the differentiated services code point (DSCP) value. The range is from 0 to 63. exitExits from the current configuration mode. noNegates a command or sets its defaults. source interfaceSpecifies the source interface for this destination. The valid values for interface are as follows:
ethernet mod/portSpecifies the Ethernet IEEE 802.3z interface module and port number. The

ranges for the module and port number depend on the chassis used.
loopback virtual-numSpecifies the virtual interface number. The range is from 0 to 1023. mgmt numSpecifies the management interface number. The range is from 0 to 10.

transport udp dest-portSpecifies the transport UDP destination port. The range is from 0 to 65535. version {5 | 9}Specifies the export version 5 or the version 9 and enters the export version configuration mode. See the version command for additional information.

This command does not require a license.

Examples

This example shows how to create a flow exporter named FLOW-EXPORTER-1, enter flow exporter configuration mode, and configure the flow exporter:
switch(config)# flow exporter FLOW-EXPORTER-1 switch(config-flow-exporter)# description located in Pahrump, NV switch(config-flow-exporter)# destination A.B.C.D switch(config-flow-monitor)# dscp 32 switch(config-flow-monitor)# source ethernet 3/2 switch(config-flow-monitor)# transport udp 59 switch(config-flow-monitor)# version 5

Related Commands

Command clear flow exporter show flow exporter

Description Clears the flow monitor. Displays flow monitor status and statistics.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

201

F Commands flow monitor

flow monitor
To create a Flexible NetFlow flow monitor or to modify an existing Flexible NetFlow flow monitor and enter flow monitor configuration mode, use the flow monitor command. To remove a Flexible NetFlow flow monitor, use the no form of this command. flow monitor monitor-name no flow monitor monitor-name

Syntax Description

monitor-name

Name of the flow monitor that is created or modified.

Defaults

Flow monitors are not present in the configuration until you create them.

Command Modes

Global configuration mode

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

Flow monitors are the Flexible NetFlow component that is applied to interfaces to perform network traffic monitoring. Flow monitors consist of a record that you add to the flow monitor after you create the flow monitor and a cache that is automatically created at the time that the flow monitor is applied to the first interface. Flow data is collected from the network traffic during the monitoring process based on the key and nonkey fields in record that is configured for the flow monitor and stored in the flow monitor cache. Once you enter the flow monitor configuration mode, the prompt changes to the following:
switch(config-flow-monitor)#

Within the flow monitor configuration mode, the following keywords and arguments are available to configure the flow monitor:

description descriptionProvides a description for this flow monitor; you use a maximum of 63 characters. exitExits from the current configuration mode. exporter nameSpecifies the name of an exporter to export records. noNegates a command or sets its defaults. record {record-name | netflow ipv4 collection-type | netflow-original}Specifies a flow record to use as follows:

Cisco Nexus 7000 Series NX-OS System Management Command Reference

202

OL-25806-03

F Commands flow monitor

record-nameName of a record. netflow ipv4 collection-typeSpecifies the traditional IPv4 NetFlow collection schemes as

follows: original-inputSpecifies the traditional IPv4 input NetFlow. original-outputSpecifies the traditional IPv4 output NetFlow. protocol-portSpecifies the protocol and ports aggregation scheme.
netflow-originalSpecifies the traditional IPv4 input NetFlow with origin autonomous

systems. The netflow-original and original-input keywords are the same and are equivalent to the following commands:

match ipv4 source address match ipv4 destination address match ip tos match ip protocol match transport source-port match transport destination-port match interface input collect counter bytes collect counter packet collect timestamp sys-uptime first collect timestamp sys-uptime last collect interface output collect transport tcp flags collect routing next-hop address ipv4 collect routing source as collect routing destination as

The original-output keywords are the same as the original-input keywords except for the following:

match interface output (instead of match interface input) collect interface input (instead of collect interface output)

This command does not require a license.

Examples

This example shows how to create and configure a flow monitor named FLOW-MONITOR-1:
switch(config)# flow monitor switch(config-flow-monitor)# switch(config-flow-monitor)# switch(config-flow-monitor)# switch(config-flow-monitor)# FLOW-MONITOR-1 description monitor location las vegas, NV exporter exporter-name1 record test-record netflow ipv4 original-input

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

203

F Commands flow monitor

Related Commands

Command clear flow monitor show flow sw-monitor

Description Clears the flow monitor. Displays flow monitor status and statistics.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

204

OL-25806-03

F Commands flow record

flow record
To create a Flexible NetFlow flow record or to modify an existing Flexible NetFlow flow record and enter flow record configuration mode, use the flow record command. To remove a Flexible NetFlow flow record, use the no form of this command. flow record record-name no flow record record-name

Syntax Description

record-name

Name of the flow record that is created or modified.

Defaults

Flow records are not present in the configuration until you create them.

Command Modes

Global configuration mode

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

Flexible NetFlow uses key and nonkey fields just as original NetFlow does to create and populate flows in a cache. In Flexible NetFlow, a combination of key and nonkey fields is called a record. Original NetFlow and Flexible NetFlow both use the values in key fields in IP datagrams, such as the IP source or destination address and the source or destination transport protocol port, as the criteria for determining when a new flow must be created in the cache while network traffic is being monitored. A flow is defined as a stream of packets between a given source and a given destination. New flows are created whenever NetFlow analyzes a packet that has a unique value in one of the key fields. Once you enter the flow record configuration mode, the prompt changes to the following:
switch(config-flow-record)#

Within the flow record configuration mode, the following keywords and arguments are available to configure the flow record:

collectSpecifies a nonkey field. See the collect command for additional information. description descriptionProvides a description for this flow record; you use a maximum of 63 characters. exitExits from the current configuration mode. matchSpecifies a key field. See the match command for additional information. noNegates a command or sets its defaults.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

205

F Commands flow record

Cisco NX-OS enables the following match fields by default when you create a flow record:

match interface input match interface output match flow direction

This command does not require a license.

Examples

This example shows how to create a flow record and enter flow record configuration mode:
switch(config)# flow record FLOW-RECORD-1 switch(config-flow-record)#

Related Commands

Command clear flow monitor flow monitor show flow sw-monitor

Description Clears the flow monitor. Creates a flow monitor. Displays flow monitor status and statistics.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

206

OL-25806-03

F Commands flow timeout

flow timeout
To create a Flexible NetFlow flow timeout or to modify an existing Flexible NetFlow flow timeout, use the flow timeout command. To remove a Flexible NetFlow flow timeout, use the no form of this command. flow timeout {active seconds | aggressive threshold percentage | fast seconds threshold packets | inactive seconds | session | seconds} no flow timeout {active seconds | aggressive threshold percentage | fast seconds threshold packets | inactive seconds | session | seconds}

Syntax Description

active seconds aggressive threshold percentage fast seconds threshold packets inactive seconds session seconds

Specifies the active or long timeout in seconds. The range is from 60 to 4092. The default is 1800. Specifies the percentage of the NetFlow table content. The range is from 50 to 99. Specifies the fast aging timeout in seconds. The range is from 32 to 512. The default is not supported. Specifies the packet threshold for a flow timeout in packets. The range is from 1 to 4000. The default is not supported. Specifies the inactive or normal timeout in seconds. The range is from 15 to 4092. The default is 15. Enables TCP session aging. Flush timeout value in seconds for F2 Series modules. The range is from 5 to 60 seconds.

Defaults

The default settings are as follows:

Active timeout1800 seconds Aggressive aging timeoutDisabled Fast timeoutDisabled Inactive timeout15 seconds Session aging timeoutDisabled Flush cache timeout 15 seconds (enabled only on F2)

Command Modes

Global configuration mode

SupportedUserRoles

network-admin vdc-admin

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

207

F Commands flow timeout

Command History

Release 6.1(2) 4.0(1)

Modification Added the seconds argument for the syntax description and also the note. This command was introduced.

Usage Guidelines

The active timeout is the amount of time to wait before sending flow information about an active session. The flow is not removed from the cache after this timeout; however, the packet count, byte count, and timestamps are reset. The aggressive timeout only affects hardware caches and is used when flows are being received faster than expected. If flows are being received faster than the threshold, they are aged out of the cache. The fast timeout specifies when an inactive flow should be aged out. The inactive timeout is used for Transmission Control Protocol (TCP) sessions that receive no more data from the sender (FIN) followed by an acknowledgment field is significant (ACK) or a reset (RST) packet being received. The inactive timeout indicates the session is over and the flow can be aged out.

Note

Only the flow timeout seconds command is supported for F2 Series modules. All of the other NetFlow timeout commands are supported for M Series modules only. This command does not require a license.

Examples

This example shows how to specify the active or long timeout value in seconds for the F1 and M1 Series modules:
switch(config)# flow timeout active 45 switch(config)#

This example shows how to specify the percentage of the NetFlow table content:
switch(config)# flow timeout aggressive threshold 45 switch(config)#

This example shows how to specify the fast aging timeout in seconds:
switch(config)# flow timeout fast 30 threshold 20 switch(config)#

This example shows how to specify the inactive or normal timeout in seconds:
switch(config)# flow timeout inactive 45 switch(config)#

This example shows how to specify the flush cache timeout in seconds for F2 Series module:
switch(config)# flow timeout 45 switch(config)#

Related Commands

Command flow record clear flow monitor

Description Creates a flow exporter. Clears the flow monitor.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

208

OL-25806-03

F Commands flow timeout

Command flow monitor show flow sw-monitor

Description Creates a flow monitor. Displays flow monitor status and statistics.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

209

F Commands flow timeout

Cisco Nexus 7000 Series NX-OS System Management Command Reference

210

OL-25806-03

H Commands
This chapter describes the Cisco NX-OS system management commands that begin with the letter H.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

211

H Commands hw-module logging onboard

hw-module logging onboard

To enable onboard failure logging (OBFL) based on the error type, use the hw-module logging onboard command. To disable OBFL (not recommended), use the no form of this command. hw-module logging onboard [counter-stats] [environmental-history] [error-stats] [interrupt-stats] [module num] [obfl-log] no hw-module logging onboard [environmental-history] [error-stats] [interrupt-stats] [module num] [obfl-log]

Syntax Description

counter-stats error-stats interrupt-stats module num obfl-log

(Optional) Specifies the OBFL counter statistics. (Optional) Specifies OBFL error statistics. (Optional) Specifies OBFL interrupt statistics. (Optional) Specifies OBFL information for a specific module. (Optional) Specifies OBFL (boot-uptime/device-version/obfl-history).

environmental-history (Optional) Specifies the OBFL environmental history.

Defaults

Enabled and is the recommended state.

Command Modes

Global configuration mode

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1) 4.0(2)

Modification This command was introduced. Added counter-stats keyword.

Usage Guidelines

The hw-module logging onboard command enables events to be recorded in files stored in nonvolatile memory, so that the data can be used to diagnose problems with hardware modules installed in a Cisco router or switch. When the onboard hardware is started up, a first record is made for each area monitored and becomes a base value for subsequent records. This command provides a circular updating scheme for collecting continuous records and archiving older (historical) records, ensuring accurate data about the hardware. Data is recorded in one of two formats: continuous information that displays a snapshot of data in a continuous file, and summary information that provides details about the data being collected. Use the show logging onboard command to see reports of current and historical data.

Note

We recommend that you do not disable OBFL.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

212

OL-25806-03

H Commands hw-module logging onboard

This configuration command is applicable to the module inserted in a device. When the module is removed and inserted into a new device, the configuration of this command follows the module to the new device. This command does not require a license.

Examples

This example shows how to configure OBFL message logging at level 7 (debugging):
Router> enable switch# configure terminal switch(config)# hw-module switch 2 module 1 logging onboard message level 7 switch(config)# end

Related Commands

Command attach clear logging onboard show logging onboard

Description Connects to a specific line card for the purpose of executing commands on that card. Clears onboard failure logs. Displays onboard failure logs.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

213

H Commands header-type

header-type
To set the ERSPAN source version, use the header-type command. To disable this feature, use the no form of this command. header-type version no header-type version

Syntax Description

version

(Optional) specifies the ERSPAN source version 3.

Defaults

Enabled and is the recommended state.

Command Modes

Global configuration mode

SupportedUserRoles

network-admin vdc-admin

Command History

Release 6.1(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to change the ERSPAN source session from Type II to Type III:
switch# configure terminal switch(config)# monitor session 3 type erspan-source switch(config-erspan-src)# header-type 3 switch(config-erspan-src)#

Related Commands

Command show logging onboard

Description Displays onboard failure logs.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

214

OL-25806-03

H Commands header-type

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

215

H Commands header-type

Cisco Nexus 7000 Series NX-OS System Management Command Reference

216

OL-25806-03

I Commands
This chapter describes the Cisco NX-OS system management commands that begin with the letter I.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

217

I Commands ip access-list

ip access-list
To configure an IP access-list, use the ip access-list command. ip access-list [acl_name | match-local-traffic]

Syntax Description

acl_name match-local-traffic

Name of the access control list (ACL). (Optional) Enables access-list matching for locally generated traffic.

Defaults

None

Command Modes

config-acl

SupportedUserRoles

network-admin VDC-admin

Command History

Release 5.1(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure an IP access list:

switch# configure terminal switch(config)# ip access-list match_12_pkts switch(config-acl)# permit ip 12.0.0.0 0.255.255.255 any switch(config-acl)#

Related Commands

Command filter access-group

Description Applies an access control group to an Encapsulated Remote Switched Port Analyzer (ERSPAN) source session.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

218

OL-25806-03

I Commands ip dscp

ip dscp
To configure the differentiated devices code point (DSCP) value of the packets in the Encapsulated Remote Switched Port Analyzer (ERSPAN) traffic, use the ip dscp command. ip dscp dscp_value

Syntax Description

dscp_value

Value of the DSCP of the packets in the ERSPAN traffic. The range is from 0 to 63.

Defaults

Command Modes

config-erspan-src

SupportedUserRoles

network-admin network-operator

Command History

Release 5.1(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure the DSCP value of the packets in the ESRSPAN traffic:
switch# configure terminal switch(config)# monitor session 5 type erspan-source switch(config-erspan-src)# ip dscp 10 switch(config-erspan-src)#

Related Commands

Command ip ttl monitor-session

Description Configures the IP time-to-live (TTL) value of the ERSPAN traffic. Enters the monitor configuration mode for configuring an ERSPAN or SPAN session for analyzing traffic between ports.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

219

I Commands ip flow monitor

ip flow monitor
To enable a Flexible NetFlow flow monitor for traffic that the router is receiving or forwarding, use the ip flow monitor command. To disable a Flexible NetFlow flow monitor, use the no form of this command. ip flow monitor monitor-name {input | output} [sampler sampler-name]

Syntax Description

monitor-name input output sampler sampler-name

Name of a flow monitor that you previously configured. Monitors traffic that the routers are receiving on the interface. Monitors traffic that the routers are transmitting on the interface. (Optional) Specifies the name of a flow sampler for the flow monitor. Flow sampler for this flow monitor using the name of a sampler that you previously configured.

Defaults

Disabled

Command Modes

Interface configuration

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

You must have already created a flow monitor by using the flow monitor command before you can apply the flow monitor to an interface with the ip flow monitor command to enable traffic monitoring with Flexible NetFlow. You must have already created a sampler by using the sampler command before you can enable a flow sampler for this flow monitor with the ip flow monitor command. When adding a sampler to a flow monitor, only packets that are selected by the named sampler are entered into the cache to form flows. Each use of a sampler results in separate statistics being stored for that usage. You cannot add a sampler to a flow monitor after the flow monitor has been enabled on an interface. You must remove the flow monitor from the interface before you enable the same flow monitor with a sampler. See the Examples section for more information.

Note

The statistics for each flow needs to be scaled to give the expected true usage. For example, if you are using a 1 in 10 sampler, you must multiply the packet and byte counters by 10.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

220

OL-25806-03

I Commands ip flow monitor

This command does not require a license.

Examples

This example shows how to enable a flow monitor for monitoring input traffic:
switch(config)# vlan configuration 2 switch(config-vlan-config)# ip flow monitor FLOW-MONITOR-1 input

Note

VLAN configuration mode enables you to configure VLANs independently of their creation, which is required for VTP client support. Egress NetFlow on VLAN is not supported

This example shows how to enable a flow monitor for monitoring output traffic:
switch(config)# interface ethernet0/0 switch(config-if)# ip flow monitor FLOW-MONITOR-1 output

This example shows how to enable the same flow monitor on the same interface for monitoring input and output traffic:
switch(config)# interface ethernet0/0 switch(config-if)# ip flow monitor FLOW-MONITOR-1 input switch(config-if)# ip flow monitor FLOW-MONITOR-1 output

This example shows how to enable two different flow monitors on the same interface for monitoring input and output traffic:
switch(config)# interface ethernet0/0 switch(config-if)# ip flow monitor FLOW-MONITOR-1 input switch(config-if)# ip flow monitor FLOW-MONITOR-2 output

This example shows how to enable the same flow monitor on two different interfaces for monitoring input and output traffic:
switch(config)# interface ethernet0/0 switch(config-if)# ip flow monitor FLOW-MONITOR-1 input switch(config)# interface ethernet1/0 switch(config-if)# ip flow monitor FLOW-MONITOR-1 output

This example shows how to enable two different flow monitors on two different interfaces for monitoring input and output traffic:
switch(config)# interface ethernet0/0 switch(config-if)# ip flow monitor FLOW-MONITOR-1 input switch(config)# interface ethernet1/0 switch(config-if)# ip flow monitor FLOW-MONITOR-2 output

This example shows how to enable a flow monitor for monitoring input traffic with a sampler to limit the input packets that are sampled:
switch(config)# interface ethernet0/0 switch(config-if)# ip flow monitor FLOW-MONITOR-1 input sampler SAMPLER-1

This example shows how to enable a flow monitor for monitoring output traffic with a sampler to limit the output packets that are sampled:
switch(config)# interface ethernet0/0 switch(config-if)# ip flow monitor FLOW-MONITOR-1 output sampler SAMPLER-1

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

221

I Commands ip flow monitor

This example shows how to enable two different flow monitors for monitoring input and output traffic with a sampler on the flow monitor that is monitoring input traffic to limit the input packets that are sampled:
switch(config)# interface ethernet0/0 switch(config-if)# ip flow monitor FLOW-MONITOR-1 input sampler SAMPLER-1 switch(config-if)# ip flow monitor FLOW-MONITOR-2 output

This example shows how to enable two different flow monitors for monitoring input and output traffic with a sampler on the flow monitor that is monitoring output traffic to limit the output packets that are sampled:
switch(config)# interface ethernet0/0 switch(config-if)# ip flow monitor FLOW-MONITOR-2 input switch(config-if)# ip flow monitor FLOW-MONITOR-2 output sampler SAMPLER-1

This example shows what happens when you try to add a sampler to a flow monitor that has already been enabled on an interface without a sampler:
switch(config)# interface Ethernet0/0 switch(config-if)# ip flow monitor FLOW-MONITOR-1 input sampler SAMPLER-1 % Flow Monitor: Flow Monitor 'FLOW-MONITOR-1' is already on in full mode and cannot be enabled with a sampler.

This example shows how to remove the flow monitor from the interface so that it can be enabled with the sampler:
switch(config)# interface Ethernet0/0 switch(config-if)# no ip flow monitor FLOW-MONITOR-1 input switch(config-if)# ip flow monitor FLOW-MONITOR-1 input sampler SAMPLER-1

This example shows how to remove a sampler from a flow monitor on an interface by entering the flow monitor command again without the sampler sampler-name keyword and argument:
switch(config)# interface Ethernet0/0 switch(config-if)# ip flow monitor FLOW-MONITOR-1 input % Flow Monitor: Flow Monitor 'FLOW-MONITOR-1' is already on in sampled mode and cannot be enabled in full mode.

This example shows how to remove the flow monitor that was enabled with a sampler from the interface so that it can be enabled without the sampler:
switch(config)# interface Ethernet0/0 switch(config-if)# no ip flow monitor FLOW-MONITOR-1 input sampler SAMPLER-1 switch(config-if)# ip flow monitor FLOW-MONITOR-1 input

Related Commands

Command flow exporter flow monitor flow record sampler

Description Creates a flow exporter. Creates a flow monitor. Creates a flow record. Creates a flow sampler.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

222

OL-25806-03

I Commands ip tftp source-interface

ip tftp source-interface
To configure source interface feature for TFTP client, use the ip tftp source-interface command. To disable this feature, use the no form of the command. ip tftp source-interface ethernet slot/chassis number | loopback virtual interface number no ip tftp source-interface ethernet slot/chassis number | loopback virtual interface number

Syntax Description

ethernet slot/chassis number loopback virtual interface number

Specifies the ethernet IEEE 802.3z. Specifies the slot or chassis number. The range is from 1 to 253. Specifies the loopback interface. Specifies the virtual interface number. The range is from 0 to 1023.

Defaults

None

Command Modes

Global configuration mode

SupportedUserRoles

network-admin VDC-admin

Command History

Release 5.2(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure the ethernet IEEE 802.3z:

switch# configure terminal switch(config)# ip tftp source-interface ethernet 1/ 1 switch(config)#

This example shows how to configure the loopback interface:

switch(config)# ip tftp source-interface loopback 1 switch(config)#

Related Commands

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

223

I Commands ip tftp source-interface

Command show ip tftp interface source-interface

Description Displays source TFTP client information.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

224

OL-25806-03

I Commands ip ttl

ip ttl
To configure the IP time-to-live (TTL) value of the Encapsulated Remote Switched Port Analyzer (ERSPAN) traffic, use the ip ttl command. ip ttl ttl_value

Syntax Description

ttl_value

Value of the IP TTL of the ERSPAN traffic. The range is from 1 to 255.

Defaults

255

Command Modes

config-erspan-src and config-erspan-dst

SupportedUserRoles

network-admin network-operator

Command History

Release 5.1(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure the IP TTL value of the ESRSPAN source:
switch# configure terminal switch(config)# monitor session 5 type erspan-source switch(config-erspan-src)# ip ttl 30 switch(config-erspan-src)#

This example shows how to configure the IP TTL value of the ESRSPAN destination:
switch# configure terminal switch(config)# monitor session 3 type erspan-destination switch(config-erspan-dst)# ip ttl 35 switch(config-erspan-dst)#

Related Commands

Command ip dscp monitor-session

Description Configures the DSCP value of the packets in the ERSPAN traffic. Enters the monitor configuration mode for configuring an ERSPAN or SPAN session for analyzing traffic between ports.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

225

I Commands ip ttl

Cisco Nexus 7000 Series NX-OS System Management Command Reference

226

OL-25806-03

L Commands
This chapter describes the Cisco NX-OS system management commands that begin with the letter L.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

227

L Commands lldp holdtime

lldp holdtime
To configure the amount of time that a receiving device should hold the information sent by your device before discarding it, use the lldp holdtime command. To remove the hold time configuration, use the no form of this command. lldp holdtime seconds

Syntax Description

seconds

Hold time in seconds. The range is from 10 to 255 seconds.

Defaults

120 seconds

Command Modes

Global configuration mode (config)

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 5.0(1)

Modification This command was introduced.

Usage Guidelines

Make sure that you are in the correct virtual device context (VDC). To switch VDCs, use the switchto vdc command. This command does not require a license.

Examples

This example shows how to configure the Link Layer Discovery Protocol (LLDP) hold time:
switch(config)# lldp holdtime 180 switch(config)#

This example shows how to remove the LLDP hold time configuration:
switch(config)# no lldp holdtime 180 switch(config)#

Related Commands

Command lldp reinit

Description Specifies the delay time in seconds for LLDP to initialize on any interface.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

228

OL-25806-03

L Commands lldp holdtime

Command lldp timer show lldp timers

Description Specifies the transmission frequency of LLDP updates in seconds. Displays the LLDP holdtime, delay time, and update frequency configuration.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

229

L Commands lldp receive

lldp receive
To enable the reception of Link Layer Discovery Protocol (LLDP) packets on an interface, use the lldp receive command. To disable the reception of LLDP packets, use the no form of this command. lldp receive no lldp receive

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Interface configuration mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 5.0(1)

Modification This command was introduced.

Usage Guidelines

Make sure that you are in the correct virtual device context (VDC). To switch VDCs, use the switchto vdc command. Make sure that you have globally enabled LLDP on the device. This command does not require a license.

Examples

This example shows how to enable the reception of LLDP packets on an interface:
switch(config)# interface ethernet 6/3 switch(config-if)# lldp receive switch(config-if)# exit switch(config)#

This example shows how to disable the reception of LLDP packets on an interface:
switch(config)# interface ethernet 6/3 switch(config-if)# no lldp receive switch(config-if)# exit switch(config)#

Cisco Nexus 7000 Series NX-OS System Management Command Reference

230

OL-25806-03

L Commands lldp receive

Related Commands

Command lldp transmit show lldp interface ethernet

Description Enables the transmission of LLDP packets on an interface. Displays the LLDP configuration on an interface.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

231

L Commands lldp reinit

lldp reinit
To configure the delay time for the Link Layer Discovery Protocol (LLDP) to initialize on any interface, use the lldp reinit command. To remove the LLDP initialization configuration, use the no form of this command. lldp reinit seconds

Syntax Description

seconds

Initialize time in seconds. The range is from 1 to 10.

Defaults

2 seconds

Command Modes

Global configuration mode (config)

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 5.0(1)

Modification This command was introduced.

Usage Guidelines

Make sure that you are in the correct virtual device context (VDC). To switch VDCs, use the switchto vdc command. This command does not require a license.

Examples

This example shows how to configure the delay time for LLDP initialization:
switch(config)# lldp reinit 6 switch(config)#

This example shows how to remove the LLDP initialization configuration:

switch(config)# no lldp reinit 6 switch(config)#

Related Commands

Command lldp holdtime

Description Specifies the amount of time in seconds that a receiving device should hold the information sent by your device before discarding it.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

232

OL-25806-03

L Commands lldp reinit

Command lldp timer show lldp timers

Description Specifies the transmission frequency of LLDP updates in seconds. Displays the LLDP holdtime, delay time, and update frequency configuration.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

233

L Commands lldp timer

lldp timer
To configure the transmission frequency of Link Layer Discovery Protocol (LLDP) updates, use the lldp timer command. To remove the transmission frequency configuration for LLDP updates, use the no form of this command. lldp timer seconds

Syntax Description

seconds

Transmission frequency in seconds. The range is from 5 to 254.

Defaults

30 seconds

Command Modes

Global configuration mode (config)

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 5.0(1)

Modification This command was introduced.

Usage Guidelines

Make sure that you are in the correct virtual device context (VDC). To switch VDCs, use the switchto vdc command. This command does not require a license.

Examples

This example shows how to configure the transmission frequency for LLDP updates:
switch(config)# lldp timer 45 switch(config)#

This example shows how to remove the transmission frequency configuration for LLDP updates:
switch(config)# no lldp timer 45 switch(config)#

Cisco Nexus 7000 Series NX-OS System Management Command Reference

234

OL-25806-03

L Commands lldp timer

Related Commands

Command lldp reint lldp holdtime show lldp timers

Description Specifies the delay time in seconds for LLDP to initialize on any interface. Specifies the amount of time in seconds that a receiving device should hold the information sent by your device before discarding it. Displays the LLDP holdtime, delay time, and update frequency configuration.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

235

L Commands lldp tlv-select

lldp tlv-select
To configure the type, length, and value (TLV) descriptions to send and receive in Link Layer Discovery Protocol (LLDP) packets, use the lldp tlv-select command. To remove the TLV configuration, use the no form of this command. lldp tlv-select [dcbxp | management-address | port-description | port-vlan | system-capabilities | system-description | system-name] no lldp tlv-select [dcbxp | management-address | port-description | port-vlan | system-capabilities | system-description | system-name]

Syntax Description

dcbxp port-description port-vlan system-capabilities system-description system-name

(Optional) Specifies the DCBXP TLV. (Optional) Specifies the Port Description TLV. (Optional) Specifies the Port VLAN ID TLV. (Optional) Specifies the System Capabilities TLV. (Optional) Specifies the System Description TLV. (Optional) Specifies the System Name TLV.

management-address (Optional) Specifies the Management Address TLV.

Defaults

By default, all available TLVs are enabled.

Command Modes

Global configuration mode (config)

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 5.0(1)

Modification This command was introduced.

Usage Guidelines

Make sure that you are in the correct virtual device context (VDC). To switch VDCs, use the switchto vdc command. This command does not require a license.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

236

OL-25806-03

L Commands lldp tlv-select

Examples

This example shows how to enable the system capabilities TLV:

switch(config)# lldp tlv-select system-capabilities switch(config)#

This example shows how to disable the system capabilities TLV:

switch(config)# no lldp tlv-select system-capabilities switch(config)#

Related Commands

Command show lldp tlv-select show lldp dcbx interface ethernet

Description Displays the LLDP TLV configuration. Displays the local DCBX control status.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

237

L Commands lldp transmit

lldp transmit
To enable the transmission of Link Layer Discovery Protocol (LLDP) packets on an interface, use the lldp transmit command. To disable the transmission of LLDP packets, use the no form of this command. lldp transmit no lldp transmit

Syntax Description

This command has no arguments or keywords.

Defaults

Enabled

Command Modes

Interface configuration mode

SupportedUserRoles

network-admin vdc-admin

Command History

Release 5.0(1)

Modification This command was introduced.

Usage Guidelines

Make sure that you are in the correct virtual device context (VDC). To switch VDCs, use the switchto vdc command. Make sure that you have globally enabled the LLDP on the device. This command does not require a license.

Examples

This example shows how to enable the transmission of LLDP packets on an interface:
switch(config)# interface ethernet 7/1 switch(config-if)# lldp transmit switch(config-if)# exit switch(config)#

This example shows how to disable the transmission of LLDP packets on an interface:
switch(config)# interface ethernet 7/1 switch(config-if)# no lldp transmit switch(config-if)# exit switch(config)#

Cisco Nexus 7000 Series NX-OS System Management Command Reference

238

OL-25806-03

L Commands lldp transmit

Related Commands

Command lldp receive show lldp interface ethernet

Description Enables the reception of LLDP packets on an interface. Displays the LLDP configuration on an interface.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

239

L Commands locator-led

locator-led
To blink an LED on the system, use the locator-led command. To restore the default LED state, use the no form of this command. locator-led {chassis | fan f-number | module slot | powersupply ps-number | xbar x-number} no locator-led {chassis | fan f-number | module slot | powersupply ps-number | xbar x-number}

Syntax Description

chassis fan f-number module slot powersupply ps-number xbar x-number

Blinks the chassis LED. Blinks the LED that represents the configured fan number. The range depends on the platform. Use ? to see the range. Blinks the module LED. The range depends on the platform. Use ? to see the range. Blinks the power supply LED. The range depends on the platform. Use ? to see the range. Blinks the xbar module LED. The range depends on the platform. Use ? to see the range.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.1(2)

Modification This command was introduced.

Usage Guidelines

Use the locator-led command to flash the LED on a component in the system. You can use this blinking LED to identify the component to an administrator in the data center. This command does not require a license.

Examples

This example shows how to blink the LED for module 4:

switch# locator-led module 4

Cisco Nexus 7000 Series NX-OS System Management Command Reference

240

OL-25806-03

L Commands locator-led

Related Commands

Command

Description

show locator-led status Displays the status of locator LEDs on the system.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

241

L Commands logging console

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:

0emergency: System unusable 1alert: Immediate action needed 2critical: Critical conditiondefault level 3error: Error condition 4warning: Warning condition 5notification: Normal but significant condition 6informational: Informational message only 7debugging: Appears during debugging only

Defaults

None

Command Modes

Global configuration mode

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

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 switch(config)#

Cisco Nexus 7000 Series NX-OS System Management Command Reference

242

OL-25806-03

L Commands logging console

Related Commands

Command show logging console

Description Displays the console logging configuration.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

243

L Commands logging event

logging event
To log interface events, use the logging event command. logging event {link-status | trunk-status} {enable | default} no logging event {link-status | trunk-status} {enable | default}

Syntax Description

link-status trunk-status default enable

Logs all UP/DOWN and CHANGE messages. Logs all TRUNK status messages. Specifies that the default logging configuration is used by interfaces not explicitly configured. Specifies to enable logging to override the port level configuration.

Defaults

None

Command Modes

Global configuration mode

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to log interface events:

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

Related Commands

Command show logging

Description Displays the logging status.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

244

OL-25806-03

L Commands logging ip access-list cache

logging ip access-list cache

To configure the Optimized ACL Logging (OAL) parameters, use the logging ip access-list cache command. To reset to the default settings, use the no form of this command. logging ip access-list cache {{entries num_entries} | {interval seconds} | {threshold num_packets}} no logging ip access-list cache {{entries num_entries} | {interval seconds} | {threshold num_packets}}

Syntax Description

entries num_entries interval seconds threshold num_packets

Specifies the maximum number of log entries that are cached in the software. The range is from 0 to 1048576. The default value is 8000 entries. Specifies the maximum time interval before an entry is sent to a syslog. The range is from 5 to 86400. The default value is 300 seconds. Specifies the number of packet matches (hits) before an entry is sent to a syslog. The range is from 0 to 1000000. The default value is 0 packetsrate limiting is off; the system log is not triggered by the number of packet matches.

Defaults

None

Command Modes

Global configuration mode

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to to specify the maximum number of log entries that are cached in the software:
switch# configure terminal switch(config)# logging ip access-list cache entries 200 switch(config)#

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

245

L Commands logging ip access-list cache

This example shows how to specify the maximum time interval before an entry is sent to the system log:
switch# configure terminal switch(config)# logging ip access-list cache interval 350 switch(config)#

This example shows how to specify the number of packet matches before an entry is sent to the system log:
switch# configure terminal switch(config)# logging ip access-list cache threshold 125 switch(config)#

Related Commands

Command show logging ip access-list

Description Displays the status of IP access list logging.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

246

OL-25806-03

L Commands logging level

logging level
To enable logging messages from the defined facility that have the specified severity level or higher, use the logging level command. To disable logging messages from the 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 on page 715. To apply the same severity level to all facilities, use the all facility. 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:

severity-level

0emergency: System unusable 1alert: Immediate action needed 2critical: Critical conditiondefault level 3error: Error condition 4warning: Warning condition 5notification: Normal but significant condition 6informational: Informational message only 7debugging: Appears during debugging only

Defaults

None

Command Modes

Global configuration mode

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

247

L Commands logging level

Examples

This example shows how to enable logging messages from the AAA facility that have a severity level of 2 or higher:
switch# configure terminal switch(config)# logging level aaa 2 switch(config)#

Related Commands

Command show logging level

Description Displays the facility logging level configuration.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

248

OL-25806-03

L Commands logging logfile

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 severity-level

Name of the log file to be used to store system messages. 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:

0emergency: System unusable 1alert: Immediate action needed 2critical: Critical conditiondefault level 3error: Error condition 4warning: Warning condition 5notification: Normal but significant condition 6informational: Informational message only 7debugging: Appears during debugging only

size bytes

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

Defaults

None

Command Modes

Global configuration mode

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

249

L Commands logging logfile

Examples

This example shows how to configure a log file called logfile to store system messages and set its severity level to 4:
switch# configure terminal switch(config)# logging logfile logfile 4 switch(config)#

Related Commands

Command show logging logfile

Description Displays the log file.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

250

OL-25806-03

L Commands logging message interface type ethernet description

logging message interface type ethernet description

To add the description for physical Ethernet interfaces and subinterfaces in the system message log, use the logging message interface type ethernet description command. To disable the printing of the interface description for physical Ethernet interfaces in the system message log, use the no form of this command. logging message interface type ethernet description no logging message interface type ethernet description

Syntax Description

This command does not have any arguments or password.

Defaults

None

Command Modes

Global configuration mode

SupportedUserRoles

network-admin vdc-admin

Command History

Release 5.2(1)

Modification This command was introduced.

Usage Guidelines

Make sure that you are in the correct VDC. To change the VDC, use the switchto vdc command. This command does not require a license.

Examples

This example shows how to add the description for physical Ethernet interfaces and subinterfaces in the system message log:
switch# configure terminal switch(config)# logging message interface type ethernet description

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

251

L Commands logging message interface type ethernet description

This example shows how to disable the printing of the interface description for physical Ethernet interfaces in the system message log:
switch# configure terminal switch(config)# no logging message interface type ethernet description

Related Commands

Command logging monitor show logging monitor

Description Enables the device to log messages to the monitor based on a specified severity level or higher. Displays the monitor logging configuration.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

252

OL-25806-03

L Commands logging module

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:

0emergency: System unusable 1alert: Immediate action needed 2critical: Critical condition 3error: Error condition 4warning: Warning condition 5notification: Normal but significant conditiondefault level 6informational: Informational message only 7debugging: Appears during debugging only

Defaults

None

Command Modes

Global configuration mode

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to enable module log messages:

switch# configure terminal switch(config)# logging module switch(config)#

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

253

L Commands logging module

Related Commands

Command show logging module

Description Displays the module logging status.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

254

OL-25806-03

L Commands logging monitor

logging monitor
To log messages to the monitor (terminal line), use the logging monitor command to enable the device. 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:

0emergency: System unusable 1alert: Immediate action needed 2critical: Critical conditiondefault level 3error: Error condition 4warning: Warning condition 5notification: Normal but significant condition 6informational: Informational message only 7debugging: Appears during debugging only

Defaults

Command Modes

Global configuration mode

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This configuration applies to Telnet and SSH sessions. This command does not require a license.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

255

L Commands logging monitor

Examples

This example shows how to enable monitor log messages:

switch# configure terminal switch(config)# logging monitor switch(config)#

Related Commands

Command show logging monitor

Description Displays the status of monitor logging.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

256

OL-25806-03

L Commands logging server

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 [use-vrf VRF_name [facility {auth | authpriv | cron | daemon | ftp | kernel | local0 | local1 | local2 | local3 | local4 | local5 | local6 | local7 | lpr | mail | news | syslog | user | uucp}]]] no logging server host

Syntax Description

host severity-level

Hostname or IPv4/IPv6 address of the remote syslog server. (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:

0emergency: System unusable 1alert: Immediate action needed 2critical: Critical conditiondefault level 3error: Error condition 4warning: Warning condition 5notification: Normal but significant condition 6informational: Informational message only 7debugging: Appears during debugging only

use-vrf VRF_name (Optional) Specifies the VPN routing and forwarding (VRF) instance. In Cisco NX-OS Release 4.2 or later releases, the default VRF is default. facility facility (Optional) Specifies the outgoing facility. The facilities are listed in the System Message Logging Facilities section on page 715. The default outgoing facility is local7.

Defaults

None

Command Modes

Global configuration mode

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

257

L Commands logging server

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure a remote syslog server at a specified IPv4 address using the default outgoing facility:
switch# configure terminal switch(config)# logging server 172.28.254.253 switch(config)#

This example shows how to configure a remote syslog server at a specified hostname with severity level 5 or higher:
switch# configure terminal switch(config)# logging server syslogA 5 switch(config)#

Related Commands

Command show logging server

Description Displays the configured syslog servers.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

258

OL-25806-03

L Commands logging source-interface

logging source-interface
To enable a source interface for the remote syslog server, use the logging source-interface command. To disable the source interface, use the no form of this command. logging source-interface loopback virtual_interface no logging source-interface loopback virtual_interface

Syntax Description

loopback virtual_interface

Enables the loopback interface.The range is from 0 to 1023.

Defaults

None

Command Modes

Global configuration mode

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to enable a source interface for the syslog server:
switch# configure terminal switch(config)# logging source-interface loopback 5 switch(config)#

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

259

L Commands logging timestamp

logging timestamp
To set the logging time stamp units, use the logging timestamp command. To reset the logging timestamp 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 milliseconds seconds

Specifies the time stamp unit in microseconds. The default units are seconds. Specifies the time stamp unit in milliseconds. Specifies the time stamp unit in seconds.

Defaults

None

Command Modes

Global configuration mode

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to set the logging time stamp units to microseconds:
switch# configure terminal switch(config)# logging timestamp microseconds switch(config)#

Related Commands

Command show logging timestamp

Description Displays the logging time stamp configuration.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

260

OL-25806-03

M Commands
This chapter describes the Cisco NX-OS system management commands that begin with the letter M.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

261

M Commands match datalink

match datalink
To configure the match data link (or Layer 2) attributes option in a flow record, use the match datalink command. To remove the data link configuration, use the no form of this command. match datalink {mac source-address | mac destination-address | ethertype | vlan} no match datalink {mac source-address | mac destination-address | ethertype | vlan}

Syntax Description

mac source-address destination-address ethertype vlan

Specifies the MAC address. Specifies the source MAC address. Specifies the destination MAC address. Specifies the EtherType. Specifies the VLAN ID.

Defaults

None

Command Modes

NetFlow record configuration (config-flow-record)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.1

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure the match data link attributes option in a flow record:
switch(config)# flow record NetFlow1 switch(config-flow-record)# match datalink mac source-address switch(config-flow-record)#

This example shows how to remove the data link match option from a flow record:
switch(config-flow-record)# no match datalink mac source-address switch(config-flow-record)#

Cisco Nexus 7000 Series NX-OS System Management Command Reference

262

OL-25806-03

M Commands match datalink

Related Commands

Command match ip match ipv4

Description Configures the match IP option for defining a NetFlow record map. Configures the match IPv4 option for defining a NetFlow record map.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

263

M Commands match ip

match ip
To configure the match IP option for defining a NetFlow record map, use the match ip command. To remove this option, use the no form of this command. match ip {protocol | tos} no match ip {protocol | tos}

Syntax Description

protocol tos

Specifies the protocol. Specifies the type of service (ToS).

Defaults

None

Command Modes

NetFlow record configuration (config-flow-record)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure the match IP option for defining a NetFlow record map:
switch(config)# flow record Custom-NetFlow-Record-1 switch(config-flow-record)# match ip protocol switch(config-flow-record)# match ip tos switch(config-flow-record)#

This example shows how to remove the match option:

switch(config-flow-record)# no match ip protocol switch(config-flow-record)# no match ip tos switch(config-flow-record)#

Related Commands

Command show flow record

Description Displays information about NetFlow records.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

264

OL-25806-03

M Commands match ipv4

match ipv4
To configure the match IPv4 option for defining a NetFlow record map, use the match ipv4 command. To remove this option, use the no form of this command. match ipv4 {source | destination} address no match ipv4 {source | destination} address

Syntax Description

source destination address

Specifies the source address. Specifies the destination address. Specifies the address.

Defaults

None

Command Modes

NetFlow record configuration (config-flow-record)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure the match IPv4 option for defining a NetFlow record map:
switch(config)# flow record Custom-NetFlow-Record-1 switch(config-flow-record)# match ipv4 source address switch(config-flow-record)# match ipv4 destination address switch(config-flow-record)#

This example shows how to remove the match IPv4 configuration:

switch(config-flow-record)# no match ipv4 source address switch(config-flow-record)# no match ipv4 destination address switch(config-flow-record)#

Related Commands

Command show flow record

Description Displays information about NetFlow records.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

265

M Commands match (NetFlow)

match (NetFlow)
To specify match criteria for Flexible NetFlow flow records, use the match command. To remove match criteria for flow records, use the no form of this command. match {flow direction | interface {input | output} | ip {protocol | tos} | ipv4 {destination address | source address} | transport {destination-port | source-port}} match {flow direction | interface {input | output} | ip {protocol | tos} | ipv4 {destination address | source address} | transport {destination-port | source-port}}

Syntax Description

flow direction interface input interface output ip protocol ip tos ipv4 destination address ipv4 source address transport destination-port transport source-port

Specifies the direction of the flow to be matched. Specifies that the match criterion is based on the input interface. Specifies that the match criterion is based on the output interface. Specifies that the match criterion is based on protocol. Specifies that the match criterion is based on type of service (ToS). Specifies that the match criterion is based on the destination IPv4 address. Specifies that the match criterion is based on the source IPv4 address. Specifies that the match criterion for transport layer fields is based on the destination port. Specifies that the match criterion for transport layer fields is based on the destination port.

Defaults

No matching criteria are specified by default.

Command Modes

Flow record configuration

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

A Flexible NetFlow flow record must be enabled before you can use the match command. This command does not require a license.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

266

OL-25806-03

M Commands match (NetFlow)

Examples

This example shows how to specify the direction of the flow to be matched:
switch(config)# flow record FLOW-RECORD-1 switch(config-flow-record)# match flow direction

This example shows how to specify the match criterion is based on the input interface:
switch(config)# flow record FLOW-RECORD-1 switch(config-flow-record)# match interface input

This example shows how to specify that the match criterion is based on the output interface:
switch(config)# flow record FLOW-RECORD-1 switch(config-flow-record)# match interface output

This example shows how to specify that the match criterion is based on protocol:
switch(config)# flow record FLOW-RECORD-1 switch(config-flow-record)# match ip protocol

This example shows how to specify that the match criterion is based on type of service (ToS):
switch(config)# flow record FLOW-RECORD-1 switch(config-flow-record)# match ip tos

This example shows how to specify that the match criterion is based on the destination IPv4 address:
switch(config)# flow record FLOW-RECORD-1 switch(config-flow-record)# match ipv4 destination address

This example shows how to specify that the match criterion is based on the source IPv4 address:
switch(config)# flow record FLOW-RECORD-1 switch(config-flow-record)# match ipv4 source address

This example shows how to specify that the match criterion for transport layer fields is based on the destination port:
switch(config)# flow record FLOW-RECORD-1 switch(config-flow-record)# match ipv4 transport destination-port

This example shows how to specify that the match criterion for transport layer fields is based on the source port:
switch(config)# flow record FLOW-RECORD-1 switch(config-flow-record)# match ipv4 transport source-port

Related Commands

Command flow record

Description Creates a flow record.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

267

M Commands match transport

match transport
To configure the match transport option for defining a NetFlow record map, use the match transport command. To remove the match transport option, use the no form of this command. match transport {destination-port | source-port} no match transport {destination-port | source-port}

Syntax Description

destination-port Specifies the transport destination port. source-port Specifies the transport source port.

Defaults

None

Command Modes

NetFlow record configuration (config-flow-record)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure the match transport option for defining a NetFlow record map:
switch(config)# flow record Custom-NetFlow-Record-1 switch(config-flow-record)# match transport source-port

This example shows how to remove the configuration:

switch(config-flow-record)# no match transport source-port switch(config-flow-record)

Related Commands

Command show flow record

Description Displays information about NetFlow records.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

268

OL-25806-03

M Commands mode

mode
To specify the mode in a NetFlow sampler, use the mode command. To remove the mode, use the no form of this command. mode samples no mode [samples]

Syntax Description

samples

Number of samples per sampling. The range is from 1 to 64.

Defaults

None

Command Modes

NetFlow sampler configuration (config-flow-sampler)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Note

For F2 Series modules, and additional sampling of 1:100 is applied over the configured valued. For example, if the configured sampling is 1 in 800, the actual applied samplings is 1 in 80000. With this always-enabled additional 1:100 sampling, the packets range for all F2 Series module ports is from 1 to 819100.

Examples

This example shows how to specify the mode in a NetFlow sampler:

switch(config)# sampler Custom-NetFlow-Sampler-1 switch(config-flow-sampler)# mode 1 out-of 1000 switch(config-flow-sampler)#

This example shows how to remove the mode configuration:

switch(config-flow-sampler)# no mode

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

269

M Commands mode

Related Commands

Command show sampler

Description Displays information about NetFlow samplers.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

270

OL-25806-03

M Commands mode extended

mode extended
To configure the Ethernet Switched Port Analyzer (SPAN) session as an extended bidirectional session, use the mode extended command. To remove the SPAN session as an extended bidirectional session, use the no form of this command. mode extended no mode extended

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Monitor configuration mode (config-monitor)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 6.2(2)

Modification This command was introduced.

Usage Guidelines

You cannot use this command for a unidirectional SPAN session. Extended SPAN sessions cannot source incoming traffic on M1 Series modules in either the ingress or egress direction. Extended SPAN sessions support traffic only from the F Series and M2 Series modules. Hardware session 15 is used by NetFlow on F2 and F2e Series modules. Any extended session using this hardware ID will not span incoming traffic on the F2 and the F2e ports. This command does not require a license.

Examples

This example shows how to configure the SPAN session as an extended bidirectional session:
switch(config)# monitor session 3 tx switch(config-monitor)# mode extended

Related Commands

Command monitor session

Description Places you in the monitor configuration mode for configuring a SPAN session.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

271

M Commands monitor counter

monitor counter
To configure a Simple Network Management Protocol (SNMP) monitor counter, use the monitor counter command. To remove a monitor counter configuration, use the no form of this command. monitor counter {invalid-crc | invalid-words | link-loss | protocol-error | rx-performance | signal-loss | state-change | sync-loss | tx-performance} no monitor counter {invalid-crc | invalid-words | link-loss | protocol-error | rx-performance | signal-loss | state-change | sync-loss | tx-performance}

Syntax Description

invalid-crc invalid-words link-loss protocol-error signal-loss state-change sync-loss

Configures the invalid-crc counter. Configures the invalid-words counter. Configures the link-loss counter. Configures the protocol-error counter. Configures the signal-loss counter. Configures the state-change counter. Configures the sync-loss counter.

rx-performance Configure the ingress (rx) performance counter.

tx-performance Configures the egress (tx) performance counter.

Defaults

None

Command Modes

Port-monitor configuration (config-port-monitor)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.1(2)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure an SNMP counter:

switch(config) port-monitor name PM1 switch(config-port-monitor)# monitor counter signal-loss switch(config-port-monitor)#

This example shows how to remove a counter configuration:

Cisco Nexus 7000 Series NX-OS System Management Command Reference

272

OL-25806-03

M Commands monitor counter

switch(config)# no monitor counter signal-loss switch(config-port-monitor)#

Related Commands

Command counter

Description Configures an individual counter.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

273

M Commands monitor erspan origin ip-address

monitor erspan origin ip-address

To configure the Encapsulated Remote Switched Port Analyzer (ERSPAN) origin IP address, use the monitor erspan origin ip-address command. To remove the ERSPAN origin IP address configuration, use the no form of this command. monitor erspan origin ip-address ip-address global no monitor erspan origin ip-address ip-address global

Syntax Description

ip-address global

Global origin IP address. (Optional) Specifies the default virtual device context (VDC) configuration across all VDCs.

Defaults

None

Command Modes

Global configuration mode (config)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 5.1(1)

Modification This command was introduced.

Usage Guidelines

The global origin IP address can be configured in either the default VDC or the admin VDC. The value that is configured in this VDC is valid across all VDCs. When you change the origin IP address in the default VDC, it impacts all of the sessions. This command does not require a license.

Examples

This example shows how to configure the ERSPAN origin IP address:

switch# configure terminal switch(config)# monitor erspan origin ip-address 10.1.1.1 global switch(config)#

This example shows how to remove the ERSPAN IP address:

switch# configure terminal switch(config)# no monitor erspan origin ip-address 10.1.1.1 global switch(config)#

Cisco Nexus 7000 Series NX-OS System Management Command Reference

274

OL-25806-03

M Commands monitor erspan granularity

monitor erspan granularity

To configure the granularity for Encapsulated Remote Switched Port Analyzer (ERSPAN) Type III sessions, use the monitor erspan granularity command. To remove this feature, use the no form of this command. monitor erspan granularity {100_ms | 100_ns | 1588 | ns} no monitor erspan granularity {100_ms | 100_ns | 1588 | ns}

Syntax Description

100_ms 100_ns 1588 ns

Specifies 100 microseconds. Specifies 100 nanoseconds. Specifies the IEEE 1588 time representation format in seconds or nanoseconds. Specifies nanoseconds.

Defaults

vdc

Command Modes

Global configuration mode (config)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 6.1(1)

Modification This command was introduced.

Usage Guidelines

The clock manager adjusts the ERSPAN timers based on the granularity setting. If you configure IEEE 1588, the clock manager synchronizes the ERSPAN timers across switches. Otherwise, the clock manager synchronizes the ERSPAN timer with the master timer in the switch. 588 granularity mode is not supported in Cisco NX-OS Release 6.1 and is rejected if selected. M2 Series modules support 100 microseconds, 100 nanoseconds, and nanoseconds granularity. F2 Series and F2e Series modules support only 100 microseconds and 100 nanoseconds granularity. This command can be applied only in the default VDC. This command does not require a license.

Examples

This example shows how to configure the granularity for 100 microseconds:
switch# configure terminal switch(config)# monitor erspan granularity 100_ms switch(config)#

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

275

M Commands monitor session

monitor session
To enter the monitor configuration mode for configuring Encapsulated Remote Switched Port Analyzer (ERSPAN) or an Ethernet Switched Port Analyzer (SPAN) session for analyzing traffic between ports, use the monitor session command. To disable an ERSPAN or an SPAN session(s), use the no form of this command. monitor session {session_number | all} {rx | tx | type [erspan-source | erspan-destination | local] | shut} no monitor session {session_number | all} [shut]

Syntax Description

session_number all rx tx type erspan-source erspan-destination local shut

Session number to use for monitoring a switched port. The range is from 1 to 48. Specifies all sessions for monitoring a switched port. Specifies an ingress-extended SPAN session. Specifies an egress-extended SPAN session. Specifies a session type. A session type can be local, erspan-source, or erspan-destination. (Optional) Creates an ERSPAN source session. (Optional) Creates an ERSPAN destination session. (Optional) Creates a local session. Specifies a shut state for the selected session.

Defaults

None

Command Modes

Global configuration mode (config)

SupportedUserRoles

Super user VDC administrator VDC user

Command History

Release 6.2(2) 5.1(1) 4.0(1)

Modification Added the rx, tx, and shut keywords. The number of sessions has been increased to 48. This command was introduced.

Usage Guidelines

While configuring an ERSPAN source session, if rx, tx, or both keywords are not entered, the source is configured for both directions.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

276

OL-25806-03

M Commands monitor session

The new session configuration is added to the existing session configuration. By default, the session is created in the shut state, and the session is a local SPAN session. For more information about the ERSPAN configuration, see the Cisco Nexus 7000 Series NX-OS System Management Configuration Guide, Release 6.x. This command does not require a license.

Examples

This example shows how to enter the monitor configuration mode for configuring SPAN session number 9 for analyzing traffic between ports:
switch(config)# monitor switch(config-monitor)# switch(config-monitor)# switch(config-monitor)# switch(config-monitor)# session 9 type local description A Local SPAN session source interface ethernet 1/1 destination interface ethernet 1/2 no shut

This example shows how to configure any SPAN destination interfaces as Layer 2 SPAN monitor ports before activating the SPAN session:
switch(config)# interface ethernet 1/2 switch(config-if)# switchport switch(config-if)# switchport monitor switch(config-if)# no shutdown

This example shows how to configure a typical SPAN destination trunk interface:
switch(config)# interface Ethernet1/2 switch(config-if)# switchport switch(config-if)# switchport mode trunk switch(config-if)# switchport monitor switch(config-if)# switchport trunk allowed vlan 10-12 switch(config-if)# no shutdown

This example shows how to terminate or extend RSPAN:

switch(config)# vlan 200 switch(config-vlan)# remote-span switch(config-vlan)#

This example shows how to monitor RSPAN VLAN traffic using a local SPAN:
switch(config)# monitor switch(config-monitor)# switch(config-monitor)# switch(config-monitor)# switch(config-monitor)# switch(config-monitor)# session 1 type local description RSPAN VLAN as source source vlan 200 destination interface ethernet 1/2 no shut

This example shows how to disable a SPAN session:

switch(config)# no monitor session 9 type local

This example show how to create an ERSPAN source:

switch# configure terminal switch(config)# monitor session 1 type erspan-source switch(config-monitor-erspan-src)# source int eth1/1 switch(config-monitor-erspan-src)# destination ip address 10.1.1.1 switch(config-monitor-erspan-src)# erspan-id 101 switch(config-monitor-erspan-src)# vrf erspan-vrf switch(config-monitor-erspan-src)# filter vlan 100 switch(config-monitor-erspan-src)# no shut

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

277

M Commands monitor session

This example show how to create an ERSPAN destination:

switch# configure terminal switch(config)# monitor session 1 type erspan-destination switch(config-monitor-erspan-dst)# destination interface eth1/5 switch(config-monitor-erspan-dst)# vrf foo switch(config-monitor-erspan-dst)# erspan-id 12 switch(config-monitor-erspan-dst)# source ip 10.1.1.1 switch(config-monitor-erspan-dst)# no shut

This example show how to create an access control list (ACL) filter and associate it with the ERSPAN source, IP time-to-leave (TTL), and differentiated services code point (DSCP) value:
switch# configure terminal switch(config)# monitor session 3 type erspan-source switch(config-monitor)# description erspan_src_session_3 switch(config-monitor-erspan-src)# source interface port-channel 2 switch(config-monitor-erspan-src)# filter vlan 3-5, 7 switch(config-monitor-erspan-src)# filter access-group ACL1 switch(config-monitor-erspan-src)# destination ip-address 10.1.1.1 switch(config-monitor-erspan-src)# erspan-id 5 switch(config-erspan-src)# vrf default switch(config-erspan-src)# ip ttl 25 switch(config-erspan-src)# ip dscp 42 switch(config-monitor-erspan-src)# exit

Related Commands

Command show monitor session description destination source

Description Displays the specified SPAN or ERSPAN session configuration. Adds a comment or a description of up to 32 characters to a SPAN session. Adds a SPAN destination where source packets are copied. Configures the source and the traffic direction in which to copy packets for a SPAN and ERSPAN session.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

278

OL-25806-03

M Commands mtu

mtu
To configure the maximum transmission unit (MTU) truncation size for packets in the specified Ethernet Switched Port Analyzer (SPAN) session, use the mtu command. To remove the MTU truncation size configuration, use the no form of this command. mtu mtu-size no mtu

Syntax Description

mtu-size

MTU truncation size. The configurable range is from 176 to 1500 bytes. The local SPAN range is from 64 to 1500 bytes.

Defaults

Disabled

Command Modes

Monitor configuration (config-monitor)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 6.1(1) 5.2(1)

Modification Starting with 6.1, MTU truncation also support ERSPAN session. This command was introduced.

Usage Guidelines

Make sure that you are in the correct virtual device context (VDC). To change the VDC, use the switchto vdc command. MTU truncation and the SPAN rate limit cannot be enabled for the same SPAN session. If you configure both for one session, only the rate limit is allowed on F1 Series modules, and MTU truncation is disabled until you disable the rate limit configuration. This limitation does not apply to F2 and M2 Series modules or Supervisor 2. MTU truncation and the ERSPAN source rate limit are supported only on F Series and M2 Series modules and Supervisor 2. They are not supported on M1 Series modules.

Note

MTU truncation and ERSPAN sampling can be enabled at the same time and have no precedence over each other because they are applied to different aspects of the source packet (size versus packet count). This command does not require a license.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

279

M Commands mtu

Examples

This example shows how to configure the MTU truncation size for packets in the specified SPAN session:
switch# configure terminal switch(config)# monitor session 5 switch(config-monitor)# mtu 128 switch(config-monitor)#

This example shows how to configure the MTU truncation size for packets in the specified ERSPAN session:
switch# configure terminal switch(config)# monitor session 3 type erspan-source switch(config-erspan-src)# mtu 100

This example shows how to remove the MTU truncation size configuration for packets in the specified SPAN session:
switch# configure terminal switch(config)# monitor session 5 switch(config-monitor)# no mtu

Related Commands

Command monitor session show monitor session

Description Places you in the monitor configuration mode for configuring a SPAN session. Displays the status of the SPAN or ERSPAN session.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

280

OL-25806-03

M Commands multicast best-effort

multicast best-effort
To configure the multicast best effort mode for the specified Encapsulated Remote Switched Port Analyzer (ERSPAN) or the Ethernet Switched Port Analyzer (SPAN) session, use the multicast best-effort command. To remove the multicast best effort mode for an ERSPAN or SPAN session, use the no form of this command. multicast best-effort no multicast best-effort

Syntax Description

This command has no arguments or keywords.

Defaults

Disabled

Command Modes

Monitor configuration (config-monitor)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 5.2(1)

Modification This command was introduced.

Usage Guidelines

By default, SPAN replication occurs on both the ingress and egress line card. When you enable the multicast best effort mode, SPAN replication occurs only on the ingress line card for multicast traffic or on the egress line card for packets egressing out of Layer 3 interfaces (that is, on the egress line card, packets egressing out of Layer 2 interfaces are not replicated for SPAN). Make sure that you are in the correct virtual device context (VDC). To change the VDC, use the switchto vdc command.

Note

Multicast best effort mode applies only to M1 Series modules This command does not require a license.

Examples

This example shows how to configure the multicast best effort mode for the specifies ERSPAN or SPAN session:
switch# configure terminal switch(config)# monitor session 3 switch(config-monitor)# multicast best-effort switch(config-monitor)#

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

281

M Commands multicast best-effort

This example shows how to remove the multicast best effort mode for the specified ERSPAN or SPAN session:
switch# configure terminal switch(config)# monitor session 3 switch(config-monitor)# no multicast best-effort switch(config-monitor)#

Related Commands

Command monitor session show monitor session

Description Places you in the monitor configuration mode for configuring a SPAN session. Displays the status of the SPAN or ERSPAN session.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

282

OL-25806-03

N Commands
This chapter describes the Cisco NX-OS system management commands that begin with the letter N.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

283

N Commands ntp abort

ntp abort
To abort the Network Time Protocol (NTP) configuration, use the ntp abort command. ntp abort

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Global configuration mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.1(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to abort the NTP configuration:

switch# ntp abort No changes to abort switch#

Related Commands

Command ntp commit ntp distribute

Description Commits the NTP configuration. Enables Cisco Fabric Services (CFS) distribution for NTP.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

284

OL-25806-03

N Commands ntp access-group

ntp access-group
To configure an access group to control Network Time Protocol (NTP) access, use the ntp access-group command. To remove the NTP peer access group, use the no form of this command. ntp access-group {peer | serve | serve-only | query-only | match-all} access-list-name no ntp access-group {peer | serve | serve-only | query-only | match-all} access-list-name

Syntax Description

peer serve

Allows the device to receive time requests and NTP control queries to synchronize itself to the servers specified in the access list. Allows the device to receive time requests and NTP control queries from the servers specified in the access list but not to synchronize itself to the specified servers. Allows the device to receive only time requests from servers specified in the access list. Allows the device to receive only NTP control queries from the servers specified in the access list. Enables the access group options to be scanned in the following order: peer, serve, serve-only, query-only. Name of the NTP access group. The name can be any alphanumeric string up to 32 characters, including special characters.

serve-only query-only match-all access-list-name

Defaults

If you do not configure any access groups, NTP access is granted to all devices.

Command Modes

Global configuration mode

SupportedUserRoles

network-admin vdc-admin

Command History

Release 6.2(2) 5.2(1) 5.0(1)

Modification Added the match-all keyword. Added the serve, serve-only, and query-only keywords. This command was introduced.

Usage Guidelines

Make sure that you are in the correct virtual device context (VDC). To change the VDC, use the switchto vdc command.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

285

N Commands ntp access-group

The ntp access-group match-all command causes the access group options to be scanned in the following order, from least restrictive to most restrictive: peer, serve, serve-only, query-only. If the incoming packet does not match the peer access group, the packet goes to the serve access group to be processed. If the packet does not match the serve access group, it goes to the next access group and so on. This command also enables IPv6 access group processing. The ntp access-group match-all command is available beginning with Cisco NX-OS Release 6.2(2). If you enter the no form of this command, do not enter this command or create an access group using an earlier version of Cisco NX-OS. ACL processing stops and does not continue to the next access group option if the incoming packet does not match the peer access group or if NTP matches a deny ACL rule in a configured peer. This command does not require a license.

Examples

This example shows how to configure a peer access group for NTP:
switch# config t switch(config)# ntp access-group peer Admin_Group_123 switch(config)#

This example shows how to remove an NTP peer access group:

switch# config t switch(config)# no ntp access-group peer Admin_Group_123 switch(config)#

Related Commands

Command feature ntp show ntp access-groups

Description Enables the NTP on a VDC. Displays the NTP access groups.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

286

OL-25806-03

N Commands ntp authenticate

ntp authenticate
To enable Network Time Protocol (NTP) authentication, use the ntp authenticate command. To disable NTP authentication, use the no form of this command. ntp authenticate no ntp authenticate

Syntax Description

This command has no arguments or keywords.

Defaults

Disabled

Command Modes

Global configuration mode (config)

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 5.0(1)

Modification This command was introduced.

Usage Guidelines

Make sure that you are in the correct virtual device context (VDC). To change the VDC, use the switchto vdc command. This command does not require a license.

Examples

This example shows how to enable NTP authentication:

switch(config)# ntp authenticate switch(config)#

This example shows how to disable NTP authentication:

switch(config)# no ntp authenticate switch(config)#

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

287

N Commands ntp authenticate

Related Commands

Command ntp authentication-key ntp trusted-key show ntp authentication-status

Description Configures an NTP authentication key. Configures one or more keys that a time source must provide in its NTP packets in order for the device to synchronize to it. Displays the status of NTP authentication.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

288

OL-25806-03

N Commands ntp authentication-key

ntp authentication-key
To configure a Network Time Protocol (NTP) authentication key, use the ntp authentication-key command. To remove the NTP authentication key, use the no form of this command. ntp authentication-key number md5 md5-string no ntp authentication-key number md5 md5-string

Syntax Description

number md5 md5-string

Authentication key number. The range is from 1 to 65535. Specifies the MD5 algorithm for authentication. MD5 string. Cisco NX-OS Release 5.2(3) and later 5.x releases support up to 15 alphanumeric characters for the MD5 string. Earlier 5.x releases and Cisco NX-OS Release 6.0(1) support up to 8 alphanumeric characters.

Defaults

Disabled

Command Modes

Global configuration mode (config)

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 5.2(3) 5.0(1)

Modification Increases the length of NTP authentication keys from 8 to 15 alphanumeric characters. This command was introduced.

Usage Guidelines

Make sure that you are in the correct virtual device context (VDC). To change the VDC, use the switchto vdc command. The device does not synchronize to a time source unless the source has one of these authentication keys and the key number is specified by the ntp trusted-key command. This command does not require a license.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

289

N Commands ntp authentication-key

Examples

This example shows how to configure an NTP authentication key:

switch# config t switch(config)# ntp authentication-key 42 md5 aNiceKey switch(config)#

This example shows how to remove the NTP authentication key:

switch# config t switch(config)# no ntp authentication-key 42 md5 aNiceKey switch(config)#

Related Commands

Command show ntp authentication-key

Description Configures one or more keys that a time source must provide in its NTP packets in order for the device to synchronize to it.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

290

OL-25806-03

N Commands ntp broadcast

ntp broadcast
To enable a Network Time Protocol (NTP) IPv4 broadcast server on the specified interface, use the ntp broadcast command. To disable the NTP IPv4 broadcast server, use the no form of this command. ntp broadcast [destination ip-address] [key key-id] [version number] no ntp broadcast [destination ip-address] [key key-id] [version number]

Syntax Description

destination ip-address key key-id version number

(Optional) Configures the broadcast destination IPv4 address. (Optional) Configures the broadcast authentication key number. The range is from 1 to 65535. (Optional) Configures the NTP version. The range is from 2 to 4.

Defaults

None

Command Modes

Interface configuration mode (config-if)

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 6.2(2)

Modification This command was introduced.

Usage Guidelines

Use NTP broadcast or multicast associations when time accuracy and reliability requirements are modest, your network is localized, and the network has more than 20 clients. We recommend that you use NTP broadcast or multicast associations in networks that have limited bandwidth, system memory, or CPU resources.

Note

Time accuracy is marginally reduced in NTP broadcast associations because information flows only one way. This command does not require a license.

Examples

This example shows how to enable an NTP IPv4 broadcast server on the interface:
switch# configure terminal switch(config)# interface ethernet 6/1 switch(config-if)# ntp broadcast destination 192.0.2.10

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

291

N Commands ntp broadcast

Related Commands

Command ntp enable

Description Enables NTP.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

292

OL-25806-03

N Commands ntp broadcastdelay

ntp broadcastdelay
To configure the estimated Network Time Protocol (NTP) broadcast round-trip delay, use the ntp broadcastdelay command. To disable the estimated broadcast round-trip delay, use the no form of this command. ntp broadcastdelay [delay] no ntp broadcastdelay [delay]

Syntax Description

delay

(Optional) Broadcast round-trip delay in microseconds. The range is from 1 to 999999.

Defaults

None

Command Modes

Global configuration mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 6.2(2)

Modification This command was introduced.

Usage Guidelines

Use NTP broadcast or multicast associations when time accuracy and reliability requirements are modest, your network is localized, and the network has more than 20 clients. We recommend that you use NTP broadcast or multicast associations in networks that have limited bandwidth, system memory, or CPU resources.

Note

Time accuracy is marginally reduced in NTP broadcast associations because information flows only one way. This command does not require a license.

Examples

This example shows how to configure the estimated broadcast round-trip delay:
switch# configure terminal switch(config-if)# ntp broadcastdelay 100

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

293

N Commands ntp broadcastdelay

Related Commands

Command ntp enable

Description Enables NTP.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

294

OL-25806-03

N Commands ntp commit

ntp commit
To commit the Network Time Protocol (NTP) configuration, use the ntp commit command. ntp commit

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Global configuration mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.1(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to commit the NTP configuration:

switch# ntp commit switch#

Related Commands

Command ntp abort ntp distribute

Description Aborts the NTP configuration. Enables Cisco Fabric Services (CFS) distribution for NTP.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

295

N Commands ntp disable

ntp disable
To disable Network Time Protocol (NTP), use the ntp disable command. To reenable NTP, use the no form of this command. ntp disable {ip | ipv6} no ntp disable {ip | ipv6}

Syntax Description

ip ipv6

Disables IPv4 on the interface. Disables IPv6 on the interface.

Defaults

Enabled

Command Modes

Interface configuration mode

SupportedUserRoles

network-admin vdc-admin

Command History

Release 6.2(2)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to disable NTP:

switch# ntp disable

Related Commands

Command ntp enable

Description Enables NTP.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

296

OL-25806-03

N Commands ntp distribute

ntp distribute
To enable Cisco Fabric Services (CFS) distribution for the 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.

Defaults

None

Command Modes

Global configuration mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.1(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to distribute the active NTP configuration to the fabric:
switch(config)# ntp distribute switch(config)#

This example shows how to stop distribution of the active NTP configuration to the fabric:
switch(config)# no ntp distribute switch(config)#

Related Commands

Command ntp abort ntp commit

Description Aborts the NTP configuration. Commits the NTP configuration.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

297

N Commands ntp enable

ntp enable
To enable Network Time Protocol (NTP), use the ntp enable command. To disable NTP, use the no command form. ntp enable no ntp enable

Syntax Description

This command has no arguments or keywords.

Defaults

Enabled

Command Modes

Global configuration mode

SupportedUserRoles

network-admin vdc-admin

Command History

Release 5.2(1) 4.0(3)

Modification This command was deprecated. This command was introduced.

Usage Guidelines

NTP must be configured in the default VDC. It cannot be configured in any other VDC. This command does not require a license.

Examples

This example shows how to disable NTP:

switch# no ntp enable

Related Commands

Command ntp server

Description Configures a remote NTP server.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

298

OL-25806-03

N Commands ntp logging

ntp logging
To enable Network Time Protocol (NTP) logging, use the ntp logging command. To disable NTP logging, use the no form of this command. ntp logging no ntp logging

Syntax Description

This command has arguments or keywords.

Defaults

Disabled

Command Modes

Global configuration mode (config)

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 5.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license. Make sure that you are in the correct virtual device context (VDC). To change the VDC, use the switchto vdc command.

Examples

This example shows how to enable NTP logging:

switch# config t switch(config)# ntp logging switch(config)#

This example shows how to disable NTP logging:

switch# config t switch(config)# no ntp logging switch(config)#

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

299

N Commands ntp logging

Related Commands

Command show ntp logging-status show ntp statistics

Description Displays the NTP logging status. Displays the NTP statistics.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

300

OL-25806-03

N Commands ntp master

ntp master
To configure the device to act as an authoritative Network Time Protocol (NTP) server, use the ntp master command. To remove the device as an authoritative NTP server, use the no form of this command. ntp master [stratum] no ntp master [stratum]

Syntax Description

stratum

(Optional) Stratum level. The range is from 1 to 15.

Defaults

None

Command Modes

Global configuration mode

SupportedUserRoles

network-admin vdc-admin

Command History

Release 5.2(1)

Modification This command was introduced.

Usage Guidelines

This command enables the device to distribute time even when it is not synchronized to an existing time server. Make sure that you are in the correct virtual device context (VDC). To change the VDC, use the switchto vdc command. This command does not require a license.

Examples

This example shows how to configure the device to act as an authoritative NTP server:
switch# configure terminal switch(config)# feature ntp switch(config)# ntp master 5

This example shows how to remove a device as an authoritative NTP server:

switch# configure terminal switch(config)# no ntp master 5

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

301

N Commands ntp master

Related Commands

Command feature ntp show running-config ntp

Description Enables NTP on a virtual device context (VDC). Displays information about the NTP configuration that is currently running on the switch.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

302

OL-25806-03

N Commands ntp multicast

ntp multicast
To enable an Network Time Protocol (NTP) IPv4 or IPv6 multicast server on the interface, use the ntp multicast command. To disable an NTP multicast server on the interface, use the no form of this command. ntp multicast [ipv4-address | ipv6 address] [key key-id] [ttl value] [version number] no ntp multicast [ipv4-address | ipv6 address] [key key-id] [ttl value] [version number]

Syntax Description

ip4-address ipv6-address key key-id ttl value version number

(Optional) Multicast IPv4 address. (Optional) Multicast IPv6 address. (Optional) Configures the broadcast authentication key number. The range is from 1 to 65535. (Optional) Configures the time-to-live (TTL) value of the multicast packets. The range is from 1 to 255 (Optional) Configures the NTP version. The range is from 2 to 4.

Defaults

None

Command Modes

Interface configuration mode

SupportedUserRoles

network-admin vdc-admin

Command History

Release 6.2(2)

Modification This command was introduced.

Usage Guidelines

You can use the ntp multicast command to configure an NTP IPv4 or IPv6 multicast server on an interface. The device then sends multicast packets through that interface periodically. Use NTP broadcast or multicast associations when time accuracy and reliability requirements are modest, your network is localized, and the network has more than 20 clients. We recommend that you use NTP broadcast or multicast associations in networks that have limited bandwidth, system memory, or CPU resources. This command does not require a license.

Examples

This example shows how to configure an NTP IPv6 multicast server on an interface:
switch(config)# interface ethernet 6/1 switch(config-if)# ntp multicast FF02:1::FF0E:8C6C

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

303

N Commands ntp multicast

Related Commands

Command feature ntp ntp multicast client show running-config ntp

Description Enables NTP on a virtual device context (VDC). Configures an NTP multicast client on an interface. Displays information about the NTP configuration that is currently running on the switch.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

304

OL-25806-03

N Commands ntp multicast client

ntp multicast client

To configure a Network Time Protocol (NTP) multicast client on an interface, use the ntp multicast client command. To disable an NTP multicast client on the interface, use the no form of this command. ntp multicast client [ipv4-address | ipv6 address] no ntp multicast client [ipv4-address | ipv6 address]

Syntax Description

ip4-address ipv6-address

(Optional) Multicast IPv4 address. (Optional) Multicast IPv6 address.

Defaults

None

Command Modes

Interface configuration mode

SupportedUserRoles

network-admin vdc-admin

Command History

Release 6.2(2)

Modification This command was introduced.

Usage Guidelines

You can use the ntp multicast client command to configure an NTP multicast client on an interface. The device then listens to NTP multicast messages and discards any messages that come from an interface for which multicast is not configured. Use NTP broadcast or multicast associations when time accuracy and reliability requirements are modest, your network is localized, and the network has more than 20 clients. We recommend that you use NTP broadcast or multicast associations in networks that have limited bandwidth, system memory, or CPU resources. This command does not require a license.

Examples

This example shows how to configure an NTP IPv6 multicast server on an interface:
switch(config)# interface ethernet 6/1 switch(config-if)# ntp multicast client FF02:1::FF0E:8C6C

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

305

N Commands ntp multicast client

Related Commands

Command ntp multicast feature ntp show running-config ntp

Description Configures an NTP multicast server on an interface. Enables NTP on a virtual device context (VDC). Displays information about the NTP configuration that is currently running on the switch.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

306

OL-25806-03

N Commands ntp passive

ntp passive
To enable Network Time Protocol (NTP) to send synchronization responses and form associations, use the ntp passive command. To prevent NTP from forming associations, use the no form of this command. ntp passive no ntp passive

Syntax Description

This command has arguments or keywords.

Command Modes

Global configuration mode

SupportedUserRoles

network-admin vdc-admin

Command History

Release 6.2(2)

Modification This command was introduced.

Usage Guidelines

Make sure that you are in the correct virtual device context (VDC). To change the VDC, use the switchto vdc command. This command is available beginning with Cisco NX-OS Release 6.2(2). In previous releases, associations are enabled automatically and cannot be disabled. This command does not require a license.

Examples

This example shows how to enable NTP to form associations:

switch# configure terminal switch(config)# feature ntp switch(config)# ntp passive

Related Commands

Command feature ntp show running-config ntp

Description Enables NTP on a VDC. Displays information about the NTP configuration that is currently running on the switch.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

307

N Commands ntp peer

ntp peer
To configure a device as a Network Time Protocol (NTP) peer, use the ntp peer command. To remove the device as an NTP peer, use the no form of this command. ntp peer {ip-address | ipv6-address | dns-name} [key key-id] [prefer] [use-vrf vrf-name] no ntp peer {ip-address | ipv6-address | dns-name} [key key-id] [prefer] [use-vrf vrf-name]

Syntax Description

ip-address ipv6-address dns-name key key-id prefer use-vrf vrf-name

IPv4 address. IPv6 address. Domain Name Server (DNS) name. (Optional) Specifies the key to be used for associating with a server. Key ID. The range is from 1 to 65535. (Optional) Specifies the given NTP server as the preferred one. (Optional) Specifies the virtual routing and forwarding (VRF) name. VRF name. The VRF name can be default, management, or any case-sensitive, alphanumeric string up to 32 characters.

Defaults

None

Command Modes

Global configuration mode (config)

SupportedUserRoles

network-admin vdc-admin network-operator vdc-operator

Command History

Release 5.0(1)

Modification This command was introduced.

Usage Guidelines

Make sure that you are in the correct virtual device context (VDC). To change the VDC, use the switchto vdc command. You can configure multiple peer associations. If you configure a key to be used while communicating with the NTP server, make sure that the key exists as a trusted key on the device. This command does not require a license.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

308

OL-25806-03

N Commands ntp peer

Examples

This example shows how to configure an NTP peer:

switch(config)# config t switch(config)# ntp peer 190.0.2.1 key 123 prefer use-vrf RED switch(config)#

This example shows how to remove an NTP peer:

switch# config t switch(config)# no ntp peer 190.0.2.1 switch(config)#

Related Commands

Command ntp server show ntp peers show ntp peer-status

Description Configures an NTP server. Displays all the NTP peers. Displays the status for all the server/peers.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

309

N Commands ntp server

ntp server
To configure a Network Time Protocol (NTP) server, use the ntp server command. To remove the NTP server, use the no form of this command. ntp server {ip-address | ipv6-address | dns-name} [key key-id] [prefer] [use-vrf vrf-name] no ntp server {ip-address | ipv6-address | dns-name} [key key-id] [prefer] [use-vrf vrf-name]

Syntax Description

ip-address ipv6-address dns-name key key-id prefer use-vrf vrf-name

IPv4 address. IPv6 address. Domain Name Server (DNS) name. (Optional) Specifies the key to be used for associating with a server. Key ID. The range is from 1 to 65535. (Optional) Specifies the given NTP server as the preferred one. (Optional) Specifies the virtual routing and forwarding (VRF) name. VRF name. The VRF name can be default, management, or any case-sensitive, alphanumeric string up to 32 characters.

Defaults

None

Command Modes

Global configuration mode (config)

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 5.0(1)

Modification This command was introduced.

Usage Guidelines

Make sure that you are in the correct virtual device context (VDC). To change the VDC, use the switchto vdc command. If you configure a key to be used while communicating with the NTP server, make sure that the key exists as a trusted key on the device. This command does not require a license.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

310

OL-25806-03

N Commands ntp server

Examples

This example shows how to configure an NTP server:

switch(config) config t switch(config)# ntp server 190.0.2.10 key 123 prefer use-vrf RED switch(config)#

This example shows how to remove an NTP server:

switch# config t switch(config)# no ntp server 190.0.2.10 key 123 prefer use-vrf RED switch(config)#

Related Commands

Command ntp peer show ntp peer-status show ntp peers

Description

Configures a device as an NTP peer.

Displays the status of all NTP servers and peers. Displays all the NTP peers.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

311

N Commands ntp source

ntp source
To configure the Network Time Protocol (NTP) source, use the ntp source command. To remove the NTP source, use the no form of this command. ntp source addr no ntp source addr

Syntax Description

addr

IPv4 or IPv6 address of the source. The IPv4 address format is dotted decimal, x.x.x.x. The IPv6 address format is hex A:B::C:D.

Defaults

None

Command Modes

Global configuration mode (config)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure the NTP source:

switch(config)# ntp source 192.0.2.3

This example shows how to remove the NTP source:

switch(config)# no ntp source 192.0.2.3

Related Commands

Command show ntp source

Description Displays information about the NTP source.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

312

OL-25806-03

N Commands ntp source-interface

ntp source-interface
To configure the Network Time Protocol (NTP) source interface, use the ntp source-interface command. To remove an NTP source interface, use the no form of this command. ntp source-interface if_index no ntp source-interface if_index

Syntax Description

if_index

Source interface.

Defaults

None

Command Modes

Global configuration mode (config)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.1(3)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure an NTP source interface:

switch(config)# ntp source-interface loopback 1 switch(config)#

This example shows how to remove an NTP source configuration:

switch(config)# no ntp source-interface loopback 1 switch(config)#

Command show ntp source-interface

Description Displays information about the NTP source interface.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

313

N Commands ntp sync-retry

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

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to resynchronize NTP:

switch# ntp sync-retry

Related Commands

Command ntp server

Description Configures a remote NTP server.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

314

OL-25806-03

N Commands ntp trusted-key

ntp trusted-key
To configure one or more keys that a time source must provide in its Network Time Protocol (NTP) packets in order for the device to synchronize to it, use the ntp trusted-key command. To remove the NTP trusted key, use the no form of this command. ntp trusted-key number no ntp trusted-key number

Syntax Description

number

Trusted key number. The range is from 1 to 65535.

Defaults

None

Command Modes

Global configuration mode (config)

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 5.0(1)

Modification This command was introduced.

Usage Guidelines

Make sure that you are in the correct virtual device context (VDC). To change the VDC, use the switchto vdc command. This command provides protection against accidentally synchronizing the device to a time source that is not trusted. This command does not require a license.

Examples

This example shows how to configure an NTP trusted key:

switch# config t switch(config)# ntp trusted-key 42 switch(config)#

This example shows how to remove the NTP trusted key:

switch# config t switch(config)# no ntp trusted-key 42 switch(config)#

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

315

N Commands ntp trusted-key

Related Commands

Command show ntp trusted-keys

Description Displays the status of NTP authentication.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

316

OL-25806-03

O Commands
This chapter describes the Cisco NX-OS system management commands that begin with the letter O.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

317

O Commands option exporter-stats timeout

option exporter-stats timeout

To configure the NetFlow exporter resend timer, use the option exporter-stats timeout command. To remove the NetFlow exporter resend timer, use the no form of this command. option exporter-stats timeout time no option exporter-stats timeout

Syntax Description

time

Time in seconds. The range is from 1 to 86400.

Defaults

None

Command Modes

NetFlow exporter version 9 configuration (config-flow-exporter-version-9)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure the NetFlow exporter resend timer:
switch(config)# flow exporter Custom-Flow-Exporter-1 switch(config-flow-exporter)# version 9 switch(config-flow-exporter-version-9)# option exporter-stats timeout 1200 switch(config-flow-exporter-version-9)#

This example shows how to remove the NetFlow exporter resend timer configuration:
switch(config-flow-exporter-version-9)# no option exporter-stats timeout switch(config-flow-exporter-version-9)#

Related Commands

Command show flow exporter

Description Displays information about NetFlow exporters.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

318

OL-25806-03

O Commands option interface-table timeout

option interface-table timeout

To configure the NetFlow exporter interface-table timer, use the option interface-table timeout command. To remove the interface-table timer, use the no form of this command. option interface-table timeout time no option interface-table timeout [time]

Syntax Description

time

Time in seconds. The range is from 1 to 86400.

Defaults

None

Command Modes

NetFlow exporter version 9 configuration (config-flow-exporter-version-9)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure the NetFlow exporter interface-table timer:
switch(config)# flow exporter Custom-Flow-Exporter-1 switch(config-flow-exporter)# version 9 switch(config-flow-exporter-version-9)# option interface-table timeout 1200 switch(config-flow-exporter-version-9)#

This example shows how to remove the NetFlow exporter interface-table timer configuration:
switch(config-flow-exporter-version-9)# no option interface-table timeout

Related Commands

Command show flow exporter

Description Displays information about the NetFlow exporters.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

319

O Commands option sampler-table timeout

option sampler-table timeout

To configure the NetFlow exporter sampler-table timer, use the option sampler-table timeout command. To remove the sampler-table timer, use the no form of this command. option sampler-table timeout time no option sampler-table timeout [time]

Syntax Description

time

Time in seconds. The range is from 1 to 86400.

Defaults

None

Command Modes

NetFlow exporter version 9 configuration (config-flow-exporter-version-9)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure the NetFlow exporter sampler-table timer:
switch(config)# flow exporter Custom-Flow-Exporter-1 switch(config-flow-exporter)# version 9 switch(config-flow-exporter-version-9)# option sampler-table timeout 1200 switch(config-flow-exporter-version-9)#

This example shows how to remove the sampler-table timer configuration:

switch(config)# no option sampler-table timeout switch(config)#

Related Commands

Command show flow exporter

Description Displays information about NetFlow exporters.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

320

OL-25806-03

P Commands
This chapter describes the Cisco NX-OS system management commands that begin with the letter P.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

321

P Commands port-monitor activate

port-monitor activate
To activate a Simple Network Management Protocol (SNMP) port-monitor policy, use the port-monitor activate command. To deactivate a port-monitor policy, use the no form of this command. port-monitor activate [policy-name] no port-monitor activate [policy-name]

Syntax Description

policy-name

(Optional) Port-monitor policy. The maximum number of alphanumeric characters is 32.

Defaults

None

Command Modes

Global configuration mode (config)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.1(2)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to activate an SNMP port-monitor policy:

switch(config)# port-monitor name policy_1 switch(config-port-monitor)# port-monitor activate policy_1 switch(config)#

This example shows how to deactivate a port-monitor policy:

switch(config-port-monitor)# no port-monitor activate policy_1 switch(config)#

Related Commands

Command counter

Description Configures an individual counter.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

322

OL-25806-03

P Commands port-monitor enable

port-monitor enable
To enable the Simple Network Management Protocol (SNMP) port-monitor feature, use the port-monitor enable command. To disable the port-monitor feature, use the no form of this command. port-monitor enable no port-monitor enable

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Global configuration mode (config)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.1(2)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to enable the SNMP port-monitor feature:

switch(config)# port-monitor enable switch(config)#

This example shows how to disable the SNMP port-monitor feature:

switch(config)# no port-monitor enable switch(config)#

Related Commands

Command port-monitor activate

Description Activates the specified port-monitor policy.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

323

P Commands port-monitor name

port-monitor name
To create a Simple Network Management Protocol (SNMP) port-monitor policy, use the port-monitor name command. To delete a port-monitor policy, use the no form of this command. port-monitor name policy-name no port-monitor name policy-name

Syntax Description

policy-name

Policy name. The maximum number of alphanumeric characters is 32.

Defaults

None

Command Modes

Global configuration mode (config)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.1(2)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to create an SNMP port-monitor policy:

switch(config)# port-monitor name PM1 switch(config-port-monitor)#

This example shows how to remove an SNMP port-monitor policy:

switch(config)# no port-monitor name PM1 switch(config)

Related Commands

Command port-monitor activate

Description Activates the specified port-monitor policy.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

324

OL-25806-03

P Commands port-type

port-type
To configure a port type for the Simple Network Management Protocol (SNMP) port monitoring, use the port-type command. To delete the port-type configuration for port monitoring, use the no form of this command. port-type {access-port | all | trunks} no port-type {access-port | all | trunks}

Syntax Description

access-port all trunks

Configures port monitoring for access ports. Configures port monitoring for all ports. Configures port monitoring for trunk ports.

Defaults

None

Command Modes

Port-monitor configuration (config-port-monitor)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.1(2)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure a port type for the SNMP port-monitor configuration:
switch(config)# port-monitor name PM1 switch(config-port-monitor)# port-type all switch(config-port-monitor)#

This example shows how to remove a port-type configuration:

switch(config-port-monitor)# no port-type all switch(config-port-monitor)#

Related Commands

Command port-monitor activate

Description Activates the specified port-monitor policy.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

325

P Commands power efficient-ethernet

power efficient-ethernet
To enable Energy Efficient Ethernet (EEE) for the port or port range, use the power efficient-ethernet command. To disable this feature, use the no form of this command. power efficient-ethernet auto | sleep threshold aggressive no power efficient-ethernet auto | sleep threshold aggressive

Syntax Description

auto sleep threshold aggressive

Specifies auto negotiation for EEE. Specifies the EEE low power idle sleep configuration. Specifies the EEE low power idle sleep threshold. Specifies the EEE low power idle aggressive sleep mode.

Defaults

no power efficient-ethernet (that is EEE is off).

Command Modes

Global configuration mode

SupportedUserRoles

network-admin vdc-admin

Command History

Release 6.1(2)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to enable auto negotiation for EEE for the port or port range:
switch(config-if)# power efficient-ethernet auto ERROR: Ethernet2/1: Port is not capable of Energy Efficient Ethernet

This example shows how to enable EEE LPI threshold aggressive sleep mode:
switch(config-if)# power efficient-ethernet sleep threshold aggressive ERROR: Ethernet2/1: Port is not capable of Energy Efficient Ethernet

Related Commands

Command show module

Description Displays information about a module.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

326

OL-25806-03

P Commands poweroff module

poweroff module
To power off a module, use the poweroff module command. To return power to the module, use the no form of this command. poweroff module module no poweroff module module

Syntax Description

module

Module number. The range is from 1 to 18.

Defaults

None

Command Modes

Global configuration mode (config)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to power off module 2:

switch# poweroff module 2

Related Commands

Command show module

Description Displays information about a module.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

327

P Commands power redundancy-mode

power redundancy-mode
To configure the power supply redundancy mode, use the power redundancy-mode command. To disable this mode, use the no form of this command. power redundancy-mode {combined [force] | insrc-redundant | ps-redundant [single-input] | redundant} no power redundancy-mode {combined [force] | insrc-redundant | ps-redundant [single-input] | redundant}

Syntax Description

combined force insrc-redundant ps-redundant single-input redundant

Specifies the combined power supply mode. (Optional) Forces the device to choose the combined mode without prompting the user. Specifies the input source redundancy mode. Specifies the power supply redundancy mode. (Optional) Specifies a single power input. Specifies the full redundancy mode.

Defaults

ps-redundant

Command Modes

Global configuration mode (config)

SupportedUserRoles

network-admin Release 4.2(1) Modification This command was introduced.

Usage Guidelines

You can use the power redundancy-mode command only in the default virtual device context (VDC). You can configure the power supplies with the following modes:

Combined modeThis mode does not provide power redundancy. The available power for this mode is the total power capacity of all power supplies. Input source redundancy modeThis mode utilizes two electrical grids, each one powering a half module within each power supply. If one power grid goes down, each power supply continues to draw power through its other half module. The available power is the amount of power by the lesser of the two grids through the power supplies. Power supply redundancy modeThis mode provides an extra power supply in case an active power supply goes down. The power supply that can supply the most power operates in standby mode. The other one or two power supplies are active. The available power is the amount of power provided by the active power supply units.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

328

OL-25806-03

P Commands power redundancy-mode

Full redundancy modeThis mode combines power supply redundancy and input source redundancy, which means that the chassis has an extra power supply and one half of each power supply is connected to one electrical grid while the other half of each power supply is connected to the other electrical grid. The available power is the lesser of the available power for power supply redundancy mode and input source redundancy mode.

This command does not require a license.

Examples

This example shows how to configure the power supply redundancy mode:
switch# config t switch(config)# power redundancy-mode ps-redundant

This example shows how to disable the power supply redundancy mode:
switch# config t switch(config)# no power redundancy-mode ps-redundant

Related Commands

Command show environment power

Description Displays information about the power capacity and power distribution of the system.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

329

P Commands ptp announce

ptp announce
To configure the interval between Precision Time Protocol (PTP) announce messages on an interface or the number of PTP intervals before a timeout occurs on an interface, use the ptp announce command. To remove the interval configuration for PTP messages, use the no form of this command. ptp announce {interval seconds | timeout count} no ptp announce {interval seconds | timeout count}

Syntax Description

interval seconds timeout count

Specifies the interval between Precision Time Protocol (PTP) announce messages on an interface. Log seconds. The range is from 0 to 4. Specifies the number of PTP intervals before a timeout occurs on an interface. Timeout count. The range is from 2 to 10.

Defaults

PTP announce interval: 1 (one packet every 2 seconds) PTP announce timeout: 3

Command Modes

Interface configuration mode (config-if)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 5.2(1)

Modification This command was introduced.

Usage Guidelines

Make sure that you are in the correct virtual device context (VDC). To change the VDC, use the switchto vdc command. Make sure that you have globally enabled PTP on the device and configured the source IP address for PTP communication. This command does not require a license.

Examples

This example shows how to configure the interval between PTP announce messages on an interface:
switch# configure terminal switch(config)# interface ethernet 5/1 switch(config-if)# ptp announce interval 1 switch(config-if)#

Cisco Nexus 7000 Series NX-OS System Management Command Reference

330

OL-25806-03

P Commands ptp announce

This example shows how to remove the interval configuration for PTP messages:
switch(config)# interface ethernet 5/1 switch(config-if)# no ptp announce interval 1 switch(config-if)#

Related Commands

Command ptp ptp delay-request minimum interval ptp sync interval ptp vlan vlan

Description Enables or disables PTP on an interface. Configures the minimum interval allowed between PTP delay-request messages when the port is in the master state. Configures the interval between PTP synchronization messages on an interface. Configures the PTP VLAN value on an interface.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

331

P Commands ptp delay-request minimum interval

ptp delay-request minimum interval

To configure the minimum interval allowed between Precision Time Protocol (PTP) delay-request messages when the port is in the master state, use the ptp delay-request minimum interval command. To remove the minimum interval configuration for PTP delay-request messages, use the no form of this command. ptp delay-request minimum interval seconds no ptp delay-request minimum interval seconds

Syntax Description

seconds

Log seconds. The range is from -1 to 6.

Defaults

2 (one packet every 4 seconds).

Command Modes

Interface configuration mode (config-if)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 5.2(1)

Modification This command was introduced.

Usage Guidelines

Make sure that you are in the correct virtual device context (VDC). To change the VDC, use the switchto vdc command. Make sure that you have globally enabled PTP on the device and configured the source IP address for PTP communication. This command does not require a license.

Examples

This example shows how to configure the minimum interval allowed between PTP delay-request messages:
switch# configure terminal switch(config)# interface ethernet 5/1 switch(config-if)# ptp delay-request minimum interval 3 switch(config-if)#

This example shows how to remove the minimum interval configuration for PTP delay-request messages:
switch(config)# interface ethernet 5/1 switch(config-if)# no ptp delay-request minimum interval 3 switch(config-if)#

Cisco Nexus 7000 Series NX-OS System Management Command Reference

332

OL-25806-03

P Commands ptp delay-request minimum interval

Related Commands

Command ptp ptp announce ptp sync interval ptp vlan vlan

Description Enables or disables PTP on an interface. Configures the interval between PTP announce messages on an interface or the number of PTP intervals before a timeout occurs on an interface. Configures the interval between PTP synchronization messages on an interface. Configures the PTP VLAN value on an interface.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

333

P Commands ptp domain

ptp domain
To configure a domain number for the Precision Time Protocol (PTP) clock, use the ptp domain command. To remove the domain configuration for the PTP clock, use the no form of this command. ptp domain domain_number no ptp domain domain_number

Syntax Description

domain_number

Domain number. The range is from 0 to 28.

Defaults

Command Modes

Global configuration mode (config)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 5.2(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure a domain number for the PTP clock:
switch# configure terminal switch(config)# ptp domain 6 switch(config)#

This example shows how to remove the PTP domain configuration:

switch(config)# no ptp domain 6 switch(config)#

Related Commands

Command feature ptp ptp source ptp priority1 ptp priority2

Description Enables or disables PTP on the device. Configures the source IP address for all PTP packets. Configures the priority1 value to use when advertising this clock. Configures the priority2 value to use when advertising this clock.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

334

OL-25806-03

P Commands ptp domain

Command show ptp brief show ptp clock

Description Displays the PTP status. Displays the properties of the local clock.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

335

P Commands ptp priority1

ptp priority1
To configure the priority1 value when advertising the Precision Time Protocol (PTP) clock, use the ptp priority1 command. To remove the priority1 value, use the no form of this command. ptp priority1 priority-number no ptp priority1 priority-number

Syntax Description

priority-number

Priority number. The range is from 0 to 255.

Defaults

255

Command Modes

Global configuration mode (config)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 5.2(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure the priority1 value when advertising the PTP clock:
switch# configure terminal switch(config)# ptp priority1 10

This example shows how to remove the priority1 value when advertising the PTP clock:
switch# configure terminal switch(config)# no ptp priority1 10

Related Commands

Command feature ptp ptp source ptp domain ptp priority2 show ptp brief show ptp clock

Description Enables or disables PTP on the device. Configures the source IP address for all PTP packets. Configures the domain number to use for this clock. Configures the priority2 value to use when advertising this clock. Displays the PTP status. Displays the properties of the local clock.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

336

OL-25806-03

P Commands ptp priority2

ptp priority2
To configure the priority2 value when advertising the Precision Time Protocol (PTP) clock, use the ptp priority2 command. To remove the priority2 value when advertising the PTP, use the no form of this command. ptp priority2 priority-number no ptp priority2 priority-number

Syntax Description

priority-number

Priority number. The range is from 0 to 255.

Defaults

255

Command Modes

Global configuration mode (config)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 5.2(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure the priority2 value when advertising the PTP clock:
switch# configure terminal switch(config)# ptp priority2 1

This example shows how to remove the priority2 value configuration for use when advertising the PTP clock:
switch# configure terminal switch(config)# no ptp priority2 1

Related Commands

Command feature ptp ptp source ptp domain ptp priority1

Description Enables or disables PTP on the device. Configures the source IP address for all PTP packets. Configures the domain number to use for this clock. Configures the priority1 value to use when advertising this clock.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

337

P Commands ptp priority2

Command show ptp brief show ptp clock

Description Displays the PTP status. Displays the properties of the local clock.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

338

OL-25806-03

P Commands ptp source

ptp source
To configure the global source for all the Precision Time Protocol (PTP) packets, use the ptp source command. To remove the global source for PTP packets, use the no form of this command. ptp source ip_address [vrf vrf-id] no ptp source ip_address [vrf vrf-id]

Syntax Description

ip_address vrf vrf-id

IPv4 address of the source. Specifies the VRF to be used for hello messages. Specifies the VRF ID.

Defaults

None

Command Modes

Global configuration mode (source)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 6.1(1) 5.2(1)

Modification vrf option is deprecated in Cisco NX-OS 6.1(1) release. This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure the global source for all PTP packets:
switch# configure terminal switch(config)# ptp source 10.1.1.1 switch(config)#

This example shows how to remove the global source configuration for all PTP packets:
switch(config)# no ptp source 10.1.1.1 switch(config)#

Related Commands

Command feature ptp ptp domain

Description Enables or disables PTP on the device. Configures the domain number to use for this clock.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

339

P Commands ptp source

Command ptp priority1 ptp priority2 show ptp brief show ptp clock

Description Configures the priority1 value to use when advertising this clock. Configures the priority2 value to use when advertising this clock. Displays the PTP status. Displays the properties of the local clock.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

340

OL-25806-03

P Commands ptp sync interval

ptp sync interval

To configure the interval between Precision Time Protocol (PTP) synchronization messages on an interface, use the ptp sync interval command. To remove the interval configuration for PTP messages synchronization, use the no form of this command. ptp sync interval seconds no ptp sync interval seconds

Syntax Description

seconds

Log seconds. The range is from 1 to 2.

Defaults

2 (one packet every 4 seconds)

Command Modes

Interface configuration mode (config-if)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 5.2(1)

Modification This command was introduced.

Usage Guidelines

Make sure that you are in the correct virtual device context (VDC). To change the VDC, use the switchto vdc command. Make sure that you have globally enabled PTP on the device and configured the source IP address for PTP communication. This command does not require a license.

Examples

This example shows how to configure the interval between PTP synchronization messages on an interface:
switch# configure terminal switch(config)# interface ethernet 5/1 switch(config-if)# ptp sync interval 1 switch(config-if)#

This example shows how to remove the interval configuration for PTP messages synchronization:
switch(config)# interface ethernet 5/1 switch(config-if)# no ptp sync interval 1 switch(config-if)#

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

341

P Commands ptp sync interval

Related Commands

Command ptp ptp announce ptp delay-request minimum interval ptp vlan vlan

Description Enables or disables PTP on an interface. Configures the interval between PTP announce messages on an interface or the number of PTP intervals before a timeout occurs on an interface. Configures the minimum interval allowed between PTP delay-request messages when the port is in the master state. Configures the PTP VLAN value on an interface.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

342

OL-25806-03

P Commands ptp vlan

ptp vlan
To configure the Precision Time Protocol (PTP) VLAN value on an interface, use the ptp vlan command. To remove the PTP VLAN value from an interface, use the no form of this command. ptp vlan vlan-number no ptp vlan vlan-number

Syntax Description

vlan-number

VLAN number. The range is from 1 to 4094.

Defaults

Command Modes

Interface configuration mode (config-if)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 5.2(1)

Modification This command was introduced.

Usage Guidelines

Make sure that you are in the correct virtual device context (VDC). To change the VDC, use the switchto vdc command. Make sure that you have globally enabled PTP on the device and configured the source IP address for PTP communication. This command does not require a license.

Examples

This example shows how to configure the PTP VLAN value on an interface:
switch# configure terminal switch(config)# interface ethernet 5/5 switch(config-if)# ptp vlan 9 switch(config-if)#

This example shows how to remove the PTP VLAN value from an interface:
switch(config)# interface ethernet 5/5 switch(config-if)# no vlan 9

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

343

P Commands ptp vlan

Related Commands

Command ptp ptp announce ptp delay-request minimum interval ptp sync interval

Description Enables or disables PTP on an interface. Configures the interval between PTP announce messages on an interface or the number of PTP intervals before a timeout occurs on an interface. Configures the minimum interval allowed between PTP delay-request messages when the port is in the master state. Configures the interval between PTP synchronization messages on an interface.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

344

OL-25806-03

R Commands
This chapter describes the Cisco NX-OS system management commands that begin with the letter R.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

345

R Commands rate-limit

rate-limit
To configure the source rate limit for Ethernet Switched Port Analyzer (SPAN) packets in the specified SPAN session, use the rate-limit command. To remove the rate limit configuration, use the no form of this command. rate-limit {auto | 1-100} no rate-limit

Syntax Description

auto 1-100

Automatically calculates the rate limit on a per gigabyte basis as follows: destination bandwidth/aggregate source bandwidth. Specifies the percentage of the maximum rate of SPAN packets that can be sent out from each forwarding engine on a line card. The range is from 1 to 100.

Defaults

Disabled

Command Modes

Monitor configuration (config-monitor)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 5.2(1)

Modification This command was introduced.

Usage Guidelines

Make sure that you are in the correct virtual device context (VDC). To change the VDC, use the switchto vdc command. MTU truncation and the SPAN rate limit cannot be enabled for the same SPAN session. If you configure both for one session, only the rate limit is allowed on F1 Series modules, and MTU truncation is disabled until you disable the rate limit configuration.

Note

SPAN rate limit is supported only on F1 Series modules and F2 Series modules. This command does not require a license

Examples

This example shows how to configure the rate limit for SPAN packets in the specified SPAN session:
switch# configure terminal switch(config)# monitor session 3 switch(config-monitor)# rate-limit 30

Cisco Nexus 7000 Series NX-OS System Management Command Reference

346

OL-25806-03

R Commands rate-limit

switch(config-monitor)#

This example shows how to remove the rate limit configuration for SPAN packets in the specified SPAN session:
switch# configure terminal switch(config)# monitor session 3 switch(config-monitor)# no rate-limit

Related Commands

Command monitor session show monitor session

Description Places you in the monitor configuration mode for configuring a SPAN session. Displays the status of the SPAN or ERSPAN session.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

347

R Commands record

record
To specify a flow record to be used by a NetFlow monitor, use the record command. To remove the record, use the no form of this command. record name no record [name]

Syntax Description

name

Name of an existing NetFlow record.

Defaults

None

Command Modes

NetFlow monitor configuration (config-flow-record)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

Make sure that you are in the correct virtual device context (VDC). To change the VDC, use the switchto vdc command. This command does not require a license.

Examples

This example shows how to specify a NetFlow record to use for a NetFlow monitor:
switch(config)# switch(config)# flow monitor newflow1 switch(config-flow-monitor)# description recordflow switch(config-flow-monitor)# record netflow ipv6 original-input switch(config-flow-monitor)#

This example shows how to remove a record from a NetFlow monitor:

switch(config-flow-record)# no record netflow ipv4 original-input switch(config-flow-record)#

Related Commands

Command show flow sw-monitor

Description Displays information about NetFlow monitors.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

348

OL-25806-03

R Commands record netflow

record netflow
To select a traditional Layer 2 record for the NetFlow monitor, use the record netflow command. To remove the record selection, use the no form of this command. record netflow layer2-switched input no record netflow layer2-switched input

Syntax Description

layer2-switched input

Specifies the traditional Layer 2 NetFlow collection scheme. Specifies the input NetFlow.

Defaults

None

Command Modes

NetFlow monitor configuration

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to select a traditional Layer 2 record for the NetFlow monitor:
switch(config)# flow monitor FLowMonitor1 switch(config-flow-monitor)# record netflow layer2-switched input switch(config-flow-monitor)#

This example shows how to remove the traditional Layer 2 NetFlow record selection:
switch(config-flow-monitor)# no record netflow layer2-switched input switch(config-flow-monitor)#

Related Commands

Command record record netflow-original

Description Specifies a flow record to be used by a NetFlow monitor. Selects an input IPv4 record.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

349

R Commands record netflow ipv4

record netflow ipv4

To select an IPv4 record for the NetFlow monitor, use the record netflow ipv4 command. To remove the record selection, use the no form of this command. record netflow ipv4 {original-input | original-output | protocol-port} no record netflow ipv4 {original-input | original-output | protocol-port}

Syntax Description

original-input originaloutput protocol-port

Specifies the traditional IPv4 input NetFlow. Specifies the traditional IPv4 output NetFlow. Specifies the protocol and ports aggregation scheme.

Defaults

None

Command Modes

NetFlow monitor configuration (config-flow-monitor)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to select a NetFlow IPv4 record for the NetFlow monitor:
switch(config)# switch(config)# flow monitor newflow1 switch(config-flow-monitor)# description recordflow switch(config-flow-monitor)# record netflow ipv4 original-input switch(config-flow-monitor)#

This example shows how to remove the NetFlow IPv4 record selection:
switch(config-flow-monitor)# no record netflow ipv4 original-input

Related Commands

Command show flow sw-monitor

Description Displays information about NetFlow monitors.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

350

OL-25806-03

R Commands record netflow ipv6

record netflow ipv6

To select a NetFlow IPv6 record for the NetFlow monitor, use the record netflow ipv6 command. To remove the record selection, use the no form of this command. record netflow ipv6 {original-input | original-output | protocol-port} no record netflow ipv6 {original-input | original-output | protocol-port}

Syntax Description

original-input originaloutput protocol-port

Specifies the traditional IPv6 input NetFlow. Specifies the traditional IPv6 output NetFlow. Specifies the protocol and ports aggregation scheme.

Defaults

None

Command Modes

NetFlow monitor configuration (config-flow-monitor)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.1(3)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to select a NetFlow IPv6 record for the NetFlow monitor:
switch(config)# flow monitor Custom-NetFlow-Record-1 switch(config-flow-monitor)# record netflow ipv6 original-input

This example shows how to remove the NetFlow IPv6 record selection:
switch(config-flow-monitor)# no record netflow ipv6 original-input switch(config-flow-monitor)#

Related Commands

Command show flow sw-monitor

Description Displays information about NetFlow monitors.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

351

R Commands record netflow-original

record netflow-original
To select an input IPv4 record, use the record netflow-original command. To remove the record selection, use the no form of this command. record netflow-original no record netflow-original

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

NetFlow monitor configuration (config-flow-monitor)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to select an IPv4 input record:

switch(config)# flow monitor Custom-NetFlow-Monitor-1 switch(config-flow-monitor)# record netflow-original switch(config-flow-monitor)#

This example shows how to remove the record selection:

switch(config-flow-monitor)# no record netflow-original switch(config-flow-monitor)#

Related Commands

Command show flow sw-monitor

Description Displays information about NetFlow monitors.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

352

OL-25806-03

R Commands remote-span

remote-span
To specify a remote Ethernet Switched Port Analyzer (RSPAN) VLAN as a SPAN session source, use the remote-span command. To remove an RSPAN VLAN as a SPAN session source, use the no form of this command. remote-span no remote-span

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Vlan configuration (config-vlan)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure an RSPAN VLAN as a SPAN session source:
switch(config)# vlan 100 switch(config-vlan)# remote-span

This example shows how to remove an RSPAN VLAN configuration:

switch(config-vlan)# no remote-span switch(config-vlan)#

Related Commands

Command monitor session

Description Enters the monitor configuration mode.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

353

R Commands rmon alarm

rmon alarm
To configure a 32-bit remote monitoring RMON alarm, use the rmon alarm command. To delete RMON alarms, use the no form of this command. rmon alarm alarm number mib-object sample-interval {absolute | delta} rising-threshold value [rising-event] falling-threshold value [falling-event] [owner alarm-owner] no rmon alarm alarm-number

Syntax Description

alarm number mib-object sample-interval absolute delta rising-threshold value rising-event falling-threshold value falling-event owner alarm owner

RMON alarm number. The range is from 1 to 65535. MIB object to monitor. The maximum length is 80 characters. Sample interval in seconds. The range is from 1 to 2147483647. Specifies to test each sample directly. Specifies to test the difference (delta) between the current and previous sample. Specifies the rising threshold value. The range is from 2147483648 to 2147483647. (Optional) Event to trigger on a rising threshold crossing. The range is from 1 to 65535. If no event is specified, event 0 is used. Specifies the falling threshold value. The range is from 2147483648 to 2147483647. (Optional) Event to trigger on a falling threshold crossing. The range is from 1 to 65535. If no event is specified, event 0 is used. (Optional) Specifies an owner for the alarm. The maximum size is 80 characters.

Defaults

None

Command Modes

Global configuration mode

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

354

OL-25806-03

R Commands rmon alarm

Examples

This example shows how to configure the 32-bit alarm number 20 for OID (1.3.6.1.2.1.2.2.1.14). The sample interval is 30 seconds and delta samples are tested. The rising threshold is 15 errors per sample window; reaching this level triggers event 1. The falling threshold is 0 errors in the sample window; reaching this level triggers event 0 (no action).
switch# config terminal switch(config)# rmon alarm 20 1.3.6.1.2.1.2.2.1.14.16777216 30 delta rising-threshold 15 1 falling-threshold 0 owner cisco switch(config)# no rmon alarm 20 1.3.6.1.2.1.2.2.1.14.16777216 30 delta rising-threshold 15 1 falling-threshold 0 owner cisco

Related Commands

Command rmon event rmon hcalarm show rmon

Description Configures an RMON event. Configures the 64-bit RMON alarm. Displays RMON configuration and logged information.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

355

R Commands rmon event

rmon event
To configure an RMON event, use the rmon event command. To delete an RMON event, use the no form of this command. rmon event event-number [description text] [log] [trap community-string] [owner owner-name] no rmon event event-number

Syntax Description

event-number description text log trap community-string owner owner-name

RMON event number. The range is from 1 to 65535. (Optional) Specifies a description of the event. The maximum length is 80 characters. (Optional) Generates an RMON log entry in the onboard RMON log when the event is triggered by an alarm. (Optional) Generates SNMP traps with the specified name when the event is triggered by an alarm. The maximum length is 32 characters. (Optional) Specifies an owner for the alarm. The maximum length is 80 characters.

Defaults

None

Command Modes

Global configuration mode

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

You can trigger an events created by this command with an alarm that you configured by using the rmon alarm or rmon hcalarm commands. Events can be used by both rmon alarm (32-bit) and hcalarm (64-bit) commands.

Note

You may chose to load the default RMON events template configuration or you can delete these entries and create new RMON events. Until you create RMON alarm configurations, however, no alarms will be triggered by these configurations. This command does not require a license.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

356

OL-25806-03

R Commands rmon event

Examples

This example shows how to configure RMON event 2 to log the onboard RMON log and send an SNMP trap to public community trap destinations:
switch# config terminal switch(config)# rmon event 2 log trap public description CriticalErrors owner cisco switch#

Related Commands

Command rmon alarm rmon hcalarm show rmon

Description Configures a 32-bit RMON alarm. Configures a 64-bit RMON alarm. Displays RMON configuration and logging information.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

357

R Commands rmon hcalarm

rmon hcalarm
To configure a 64-bit RMON high-capacity alarm (hcalarm), use the rmon hcalarm command. To delete an rmon hcalarm, use the no form of this command. rmon hcalarm alarm-number mib-object sample-interval {absolute | delta} {rising-thresholdhigh value rising-threshold-low value [rising-event] [falling-threshold-high value falling-threshold-low value [falling-event]]} [owner alarm-owner] no rmon hcalarm alarm-number

Syntax Description

alarm-number mib-object sample-interval absolute delta rising-threshold -high value rising-thresholdlow value rising-event falling-thresholdhigh value falling-thresholdlow value falling-event owner alarm-owner

RMON hcalarm number. The range is from 1 to 65535. MIB object to monitor. The maximum length is 80 alphanumeric characters. Sample interval in seconds. The range is from 1 to 700000. Specifies to test each sample directly. Specifies to test the difference (delta) between the current and previous sample. Configures the upper 32 bits of the 64-bit rising threshold value. The range is from 0 to 4294967295. Configures the lower 32 bits of the 64-bit rising threshold value. The range is from 0 to 4294967295. (Optional) Event to trigger on rising threshold crossing. The range is from 0 to 65535. Configures the upper 32 bits of the 64-bit falling threshold value. The range is from 0 to 4294967295. Configures the lower 32 bits of the 64-bit falling threshold value. The range is from 0 to 4294967295. (Optional) Event to trigger on a falling threshold crossing. The range is from 0 to 65535. (Optional) Specifies an owner for the alarm. The maximum size is 80 alphanumeric characters.

Defaults

None

Command Modes

Global configuration mode

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

358

OL-25806-03

R Commands rmon hcalarm

Usage Guidelines

Event number 0 is a predefined null (or no operation) event. When no event is specified by the user in an alarm, this event is automatically used by the system. The event causes no action to be taken when triggered; however, the alarm is still reset. The event cannot be redefined by the user. It is a predefined event. This command does not require a license.

Examples

This example shows how to configure a RMON high-capacity alarm:

switch# config terminal switch(config)# rmon hcalarm 2 1.3.6.1.2.1.31.1.1.1.6.22544384 30 delta rising-threshold-high 55 rising-threshold-low 3776798720 4 falling-threshold-high 41 falling-threshold-low 3906340864 owner cisco

Related Commands

Command rmon alarm rmon hcalarm show rmon

Description Configures a 32-bit RMON alarm. Configures a 64-bit RMON alarm. Displays RMON configuration and logging information.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

359

R Commands role distribute

role distribute
To enable Cisco Fabric Services (CFS) to distribute role configurations, use the role distribute command. role distribute

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Global configuration mode

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.1(2)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to enable CFS to distribute role configurations and then display the status:
switch(config)# role distribute switch(config)# show role status Distribution: Enabled Session State: Unlocked

Related Commands

Command

Description

show application_name Displays the status of the specified application, including whether CFS status distribution is enabled for the application.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

360

OL-25806-03

R Commands rollback running-config checkpoint

rollback running-config checkpoint

To implement a rollback for the configured checkpoint file, use the rollback running-config checkpoint command. rollback running-config {checkpoint cp-name | file cp-file} [atomic | best-effort | stop-at-first-failure]

Syntax Description

checkpoint cp-name file cp-file atomic best-effort stop-at-firstfailure

Rolls back the running configuration to a checkpoint. Checkpoint name used in the checkpoint database. The name can be any alphanumeric string up to 80 characters but cannot contain spaces. Rolls back the running configuration to a configuration file. Name of configuration file. (Optional) Implements a rollback only if no errors occur. (Optional) Implements a rollback and skips any errors. (Optional) Implements a rollback that stops if an error occurs.

Defaults

None

Command Modes

Global configuration mode

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

The rollback running-config checkpoint command creates a rollback to the specified checkpoint name or file. The default rollback type is atomic.

Note

The running configuration may be disrupted before the rollback operation finally fails if you mistakenly roll back with the file option using a file from a different device but with the same VDC ID as the local VDC. This command does not require a license.

Examples

This example shows how to implement a rollback for the configured checkpoint file:

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

361

R Commands rollback running-config checkpoint

switch# rollback running-config checkpoint user-checkpoint-1 atomic Note: Applying config parallelly may fail Rollback verification Collecting Running-Config Generating Rollback Patch Executing Rollback Patch Generating Running-config for verification Generating Patch for verification switch(config)#

Related Commands

Command show diff rollback-patch

Description Displays the differences between the source and the destination file.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

362

OL-25806-03

S Commands
This chapter describes the Cisco NX-OS system management commands that begin with the letter S, excluding the show commands.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

363

S Commands sampler

sampler
To define a sampler and enter the sampler configuration mode, use the sampler command. To remove the sampler definition, use the no form of this command. sampler name no sampler name

Syntax Description

name

Name of the sampler.

Defaults

No samplers are defined.

Command Modes

Global configuration mode

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

NetFlow sampling means that M out of N packets are sampled. When a packet is sampled and there is a NetFlow cache miss, a NetFlow cache entry is created for this flow. The first packet timestamp is updated and the statistics for the first packet are initialized (for example, the bytes are set to the number of bytes in the packet and the packet count is set to one). If there is a NetFlow cache hit when the packet is sampled, the cache for this flow is updated, which includes adding the number of bytes in the packet to the byte counter and incrementing the packet count by one. Once you enter the sampler name command, you enter the sampler configuration mode, and the prompt changes to the following:
switch(config-flow-sampler)#

Within the sampler configuration mode, the following keywords and arguments are available to configure the flow monitor:

description descriptionProvides a description for this sampler; you can add a maximum of 63 characters. exitExits from the current configuration mode. mode sample-num out-of packetsConfigures the sampler mode. The valid values are as follows:
sample-numNumber of samples per sampling. The range is from 1 to 64. out-ofSpecifies the samples per packet ratio. packetsNumber of packets in each sampling. The range is from 1 to 8192.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

364

OL-25806-03

S Commands sampler

noNegates a command or sets its defaults.

This command does not require a license.

Examples

This example shows how to define a sampler and enter the sampler configuration mode:
switch(config)# sampler testsampler switch(config-flow-sampler)#

This example shows how to configure the sampler mode:

switch(config)# sampler testsampler switch(config-flow-sampler)# mode 24 out-of 1200

This example shows how to remove a sampler definition:

switch(config)# no sampler testsampler switch(config-flow)#

Related Commands

Command flow exporter flow monitor flow record

Description Creates a flow exporter. Creates a flow monitor. Creates a flow record.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

365

S Commands sampling

sampling
To set the sampling range for Switched Port Analyzer (SPAN) packets, use the sampling command. To revert to the default settings, use the no form of this command. sampling range no sampling

Syntax Description

range

Sampling range. Every nth packet will be spanned. The range is from 2 to 1023.

Defaults

None

Command Modes

Sampling only applies to local SPAN (config-monitor) and ERSPAN source session (config-monitor-erspan-src) configuration.

SupportedUserRoles

network-admin vdc-admin

Command History

Release 6.1(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to set the sampling range for the SPAN packets:
switch(config)# monitor session 3 type erspan-source switch(config-erspan-src)# sampling 100 switch(config-monitor)#

Related Commands

Command monitor session

Description Enters the monitor configuration mode.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

366

OL-25806-03

S Commands save

save
To save the current configuration session to a file, use the save command. save location

Syntax Description

location

Location of the file. The location can be in bootflash:, slot0:, or volatile: The filename can be any alphanumeric string up to 63 characters.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to save a configuration session to a file in bootflash:

switch# configure session myACLs switch(config-s)# save bootflash:sessions/myACLs

Related Commands

Command delete

Description Deletes a file from a location.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

367

S Commands scheduler

scheduler
To create or schedule a scheduler job, use the scheduler command. To remove a job or scheduled job, use the no form of this command. scheduler {aaa-authentication [username username] password [0 | 7] password | job name job-name | logfile size filesize | schedule name schedule-name} no scheduler {aaa-authentication [username username] password [0 | 7] password | job name job-name | logfile size filesize | schedule name schedule-name}

Syntax Description

aaa-authentication username username password 0 7 password job name job-name logfile size filesize schedule name schedule-name

Begins an AAA authentication exchange with a remote user. (Optional) Indicates the remote user is entering a username and specifies the username. Indicates the remote user is entering a password for authentication. Indicates the password is in clear text. Indicates the password is encrypted. Remote users password. Places you into job configuration mode for the specified job name. The maximum length of the name is 31 characters. Specifies a logfile configuration. Specifies the size of the logfile. The range is from 16 to 1024 KB. Defines a schedule for a job. Specifies the name of the schedule. The maximum length of the name is 31 characters.

Defaults

None

Command Modes

Job configuration

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

To use this command, the scheduler must already be enabled. To enable the scheduler, use the feature scheduler command.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

368

OL-25806-03

S Commands scheduler

Remote users must authenticate with the device using the scheduler aaa-authentication command before using this command to configure a maintenance job.

Note

The commands within a scheduler job must be entered in a single line separated by semicolon (;). This command does not require a license.

Examples

This example shows how to create a scheduler job that saves the running configuration to a file in bootflash and then copies the file from bootflash to a TFTP server. The filename is created using the current timestamp and switch name.
switch(config)# scheduler job name backup-cfg switch(config-job)# cli var name timestamp $(TIMESTAMP);copy running-config bootflash:/$(SWITCHNAME)-cfg.$(timestamp);copy bootflash:/$(SWITCHNAME)-cfg.$(timestamp) tftp://1.2.3.4/ vrf management switch(config-job)# end switch(config)#

This example shows how to schedule a scheduler job to run daily at 1:00 a.m:
switch(config)# scheduler schedule name daily switch(config-schedule)# job name backup-cfg switch(config-schedule)# time daily 1:00 switch(config-schedule)# end switch(config)#

This example shows how to remove a scheduler job:

switch# config t switch(config)# no scheduler job name backup-cfg

This example shows how to remove a scheduler job schedule:

switch# config t switch(config)# no scheduler schedule name daily

This example shows how to specify the password for a remote user:
switch# config t switch(config)# scheduler aaa-authentication password newpwd

This example shows how to specify a clear text password for a remote user:
switch# config t switch(config)# scheduler aaa-authentication password 0 newpwd

This example shows how to specify an encrypted password for a remote user:
switch# config t switch(config)# scheduler aaa-authentication password 7 newpwd2

This example shows how to specify a name and authentication password for a remote user:
switch# config t switch(config)# scheduler aaa-authentication username admin1 password newpwd3

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

369

S Commands scheduler

Related Commands

Command feature scheduler show scheduler

Description Enables the scheduler. Displays scheduler information.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

370

OL-25806-03

S Commands shut

shut
To shut down an Ethernet Switched Port Analyzer (SPAN) session, use the shut command. To enable a SPAN session, use the no form of this command. shut no shut

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Monitor-common configuration (config-monitor)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to shut down a SPAN session:

switch(config)# monitor session 1 switch(config-monitor)# shut

This example shows how to enable a SPAN session:

switch(config-monitor)# no shut switch(config-monitor)#

Related Commands

Command monitor session show monitor session

Description Enters the monitor configuration mode. Displays the virtual SPAN or ERSPAN configuration.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

371

S Commands snmp-server aaa-user cache-timeout

snmp-server aaa-user cache-timeout

To configure the Simple Network Management Protocol (SNMP) time-out value for synchronized AAA users, use the snmp-server aaa-user cache-timeout command. To revert to the default settings, use the no form of this command. snmp-server aaa-user cache-timeout seconds no snmp-server aaa-user cache-timeout seconds

Syntax Description

seconds

Timeout value, in seconds. The range is from 1 to 86400.

Defaults

3600 seconds

Command Modes

Global configuration mode

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(3)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure the AAA user synchronization timeout value:
switch# configure terminal switch(config)# snmp-server aaa-user cache-timeout 6000

Related Commands

Command show snmp

Description Displays information about SNMP.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

372

OL-25806-03

S Commands snmp-server community

snmp-server community
To configure the Simple Network Management Protocol (SNMP) community string, use the snmp-server community command. To remove the community string, use the no form of this command. snmp-server community name [group name | ro | rw] no snmp-server community name [group name | ro | rw]

Syntax Description

name group name ro rw

SNMP community string. The name can be any alphanumeric string up to 32 characters. (Optional) Specifies the group name to which the community belongs. The name can be any alphanumeric string up to 32 characters. (Optional) Sets read-only access for this community. (Optional) Sets read-write access for this community.

Defaults

The default community access is read-only (ro).

Command Modes

Global configuration mode

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

Use the snmp-server community command to configure read-only or read-write access to the SNMP agent on the device. You can optionally configure the community for an access group or user role. For more information on user roles, see the Cisco Nexus 7000 Series NX-OS Security Configuration Guide, Release 6.x. This command does not require a license.

Examples

This example shows how to configure a read-only SNMP community:

switch# configure terminal switch(config)# snmp-server community test ro

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

373

S Commands snmp-server community

Related Commands

Command show snmp group

Description Displays information about configured user roles.

show snmp community Displays information about SNMP communities.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

374

OL-25806-03

S Commands snmp-server contact

snmp-server contact
To configure the Simple Network Management Protocol (SNMP) contact information, use the snmp-server contact command. To remove the contact information, use the no form of this command. snmp-server contact [contact-info] no snmp-server contact [contact-info]

Syntax Description

contact-info

(Optional) SNMP contact information (sysContact). The name can be any alphanumeric string up to 255 characters.

Defaults

A zero-length string

Command Modes

Global configuration mode

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

Use the snmp-server contact command to configure the SNMP sysContact variable. This command does not require a license.

Examples

This example shows how to configure the SNMP contact:

switch# configure terminal switch(config)# snmp-server contact Jane [email protected]

Related Commands

Command show snmp

Description Displays information about SNMP.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

375

S Commands snmp-server context

snmp-server context
To configure the Simple Network Management Protocol (SNMP) context to logical network entity mapping, use the snmp-server context command. To remove the context, use the no form of this command. snmp-server context context-name [instance instance-name] [vrf vrf-name] [topology topology-name] no snmp-server context context-name [instance instance-name] [vrf vrf-name] [topology topology-name]

Syntax Description

context-name instance instance-name vrf vrf-name topology topology-name

SNMP context. The name can be any alphanumeric string up to 32 characters. (Optional) Specifies a protocol instance. The name can be any alphanumeric string up to 32 characters. (Optional) Specifies the virtual routing and forwarding (VRF) instance. The name can be any alphanumeric string up to 32 characters. (Optional) Specifies the topology. The name can be any alphanumeric string up to 32 characters.

Defaults

None

Command Modes

Global configuration mode

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(2)

Modification This command was introduced.

Usage Guidelines

Use the snmp-server context command to map between SNMP contexts and logical network entities, such as protocol instances or VRFs. Do not use the instance, vrf, or topology keywords to delete a context. If you use these keywords, you map the context to a zero-length string. If you are using SNMPv2c, use the snmp-server mib community-map command to map an SNMPv2c community to an SNMP context and use the snmp-server context command to map this context to a logical network entity. For more information on context mapping, see the Cisco Nexus 7000 Series NX-OS Security Configuration Guide, Release 6.x. This command does not require a license.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

376

OL-25806-03

S Commands snmp-server context

Examples

This example shows how to map the public1 context to VRF red:
switch# configure terminal switch(config)# snmp-server context public1 vrf red

Related Commands

Command show snmp context snmp-server mib community-map

Description Displays information about SNMP contexts. Maps an SNMPv2c community to an SNMP context.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

377

S Commands snmp-server enable traps

snmp-server enable traps

To enable the Simple Network Management Protocol (SNMP) notifications, use the snmp-server enable traps command. To disable SNMP notifications, use the no form of this command. snmp-server enable traps [aaa [server-state-change] | bgp | bridge [newroot] [topologychange] | callhome [event-notify] [smtp-send-fail] | cfs [merge-failure] [state-change-notif] | config [ccmCLIRunningConfigChanged] | eigrp | entity [entity_fan_status_change] [entity_mib_change] [entity_module_inserted] [entity_module_removed] [entity_module_status_change] [entity_power_out_change] [entity_power_status_change] [entity_unrecognised_module] | feature-control [FeatureOpStatusChange] | hsrp [state-change] | license [notify-license-expiry] [notify-license-expiry-warning] [notify-licensefile-missing] [notify-no-license-for-feature] | link [IETF-extended-linkDown] [IETF-extended-linkUp] [cisco-extended-linkDown] [cisco-extended-linkUp] [linkDown] [linkUp] | ospf instance-tag [lsa | rate-limit rate] | port-security [access-secure-mac-violation] [trunk-secure-mac-violation] | rf [redundancy_framework] | rmon [fallingAlarm | hcFallingAlarm | hcRisingAlarm | risingAlarm] | snmp [authentication] | stpx [inconsistency] [loop-consistency] [root-inconsistency] | sysmgr [cseFailSwCoreNotifyExtended] | upgrade [UpgradeJobStatusNotify] [UpgradeOpNotifyOnCompletion] | zone [default-zone-behavior-change] [merge-failure] [merge-success] [request-reject1] [unsupp-mem]] no snmp-server enable traps [aaa [server-state-change] | bgp | bridge [newroot] [topologychange] | callhome [event-notify] [smtp-send-fail] | cfs [merge-failure] [state-change-notif] | config [ccmCLIRunningConfigChanged] | eigrp | entity [entity_fan_status_change] [entity_mib_change] [entity_module_inserted] [entity_module_removed] [entity_module_status_change] [entity_power_out_change] [entity_power_status_change] [entity_unrecognised_module] | feature-control [FeatureOpStatusChange] | hsrp [state-change] | license [notify-license-expiry] [notify-license-expiry-warning] [notify-licensefile-missing] [notify-no-license-for-feature] | link [IETF-extended-linkDown] [IETF-extended-linkUp] [cisco-extended-linkDown] [cisco-extended-linkUp] [linkDown] [linkUp] | ospf instance-tag [lsa | rate-limit rate] | port-security [access-secure-mac-violation] [trunk-secure-mac-violation] | rf [redundancy_framework] | rmon [fallingAlarm | hcFallingAlarm | hcRisingAlarm | risingAlarm] | snmp [authentication] | stpx [inconsistency] [loop-consistency] [root-inconsistency] | sysmgr [cseFailSwCoreNotifyExtended] | upgrade [UpgradeJobStatusNotify] [UpgradeOpNotifyOnCompletion] | zone [default-zone-behavior-change] [merge-failure] [merge-success] [request-reject1] [unsupp-mem]]

Syntax Description

aaa server-statechange bgp bridge newroot topologychange callhome

(Optional) Enables AAA notifications. (Optional) Enables the server-state-change AAA notification. (Optional) Enables BGP notifications. (Optional) Enables STP bridge MIB notifications. (Optional) Enables STP new root bridge notifications. (Optional) Enables STP topology change notifications. (Optional) Enables Call Home notifications.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

378

OL-25806-03

S Commands snmp-server enable traps

event-notify smtp-send-fail cfs merge-failure state-change-notif config

(Optional) Enables Call Home external event notifications. (Optional) Enables the smtp-send-fail Simple Mail Transfer Protocol (SMTP) message send fail notifications. (Optional) Enables Cisco Fabric Services (CFS) notifications. (Optional) Enables merge failure notifications. (Optional) Enables state change notifications. (Optional) Enables configuration change notifications.

ccmCLIRunningConfi (Optional) Enables CLI running/startup config change notifications. gChanged eigrp entity entity_mib_change entity_module_ inserted entity_module_ removed entity_module_status _change entity_power_out_ change entity_power_status_ change entity_unrecognised_ module feature-control (Optional) Enables EIGRP4-MIB notifications. (Optional) Enables ENTITY-MIB notifications. (Optional) Enables entity MIB change notifications. (Optional) Enables entity module inserted notifications. (Optional) Enables entity module removed notifications. (Optional) Enables entity module status change notifications. (Optional) Enables entity power out change notifications. (Optional) Enables entity power status change notifications. (Optional) Enables entity unrecognized module notifications. (Optional) Enables feature change notifications.

FeatureOpStatusChan (Optional) Enables feature operation status change notifications. ge hsrp state-change license notify-license-expiry notify-license-expirywarning notify-licensefilemissing notify-no-license-forfeature link IETF-extended-linkD own IETFextended-linkUp (Optional) Enables CISCO-HSRP-MIB notifications. (Optional) Enables the state-change HSRP notifications. (Optional) Enables license notifications. (Optional) Enables license expiry notifications. (Optional) Enables license expiry warning notifications. (Optional) Enables license file missing notifications. (Optional) Enables no license installed for feature notifications. (Optional) Enables IF-MIB link notifications. (Optional) Enables Internet engineering task force (IETF) extended link state down notifications. (Optional) Enables IETF extended link state up notifications.

cisco-extended-linkDo (Optional) Enables Cisco extended link state down notifications. wn

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

379

S Commands snmp-server enable traps

cisco-extended-linkUp (Optional) Enables Cisco extended link state up notifications. linkDown linkUp ospf instance-tag lsa rate-limit rate port-security access-secure-macviolation trunk-secure-macviolation rf redundancy_ framework rmon fallingAlarm hcFallingAlarm hcRisingAlarm risingAlarm snmp authentication stpx inconsistency loop-inconsistency root-inconsistency sysmgr cseFailSwCoreNotify Extended upgrade (Optional) Enables IETF Link state down notifications. (Optional) Enables IETF Link state up notifications (Optional) Enables Open Shortest Path First (OSPF) notifications. (Optional) Enables OSPF LSA notifications. (Optional) Enables rate limits on OSPF notifications. The range is from 2 to 60 seconds. The default is 10 seconds. (Optional) Enables port security notifications. (Optional) Enables secure MAC violation notifications. (Optional) Enables VLAN secure MAC violation notifications. (Optional) Enables redundancy framework (RF) SNMP notifications. (Optional) Enables redundancy_framework (RF) Supervisor switchover MIB notifications. (Optional) Enables remote monitoring (RMON) notifications. (Optional) Enables RMON falling alarm notifications. (Optional) Enables RMON high capacity falling alarm notifications. (Optional) Enables RMON high capacity rising alarm notifications. (Optional) Enables RMON rising alarm notifications. (Optional) Enables general SNMP notifications. (Optional) Enables SNMP authentication notifications. (Optional) Enables STPX MIB notifications. (Optional) Enables SNMP STPX MIB InconsistencyUpdate notifications. (Optional) Enables SNMP STPX MIBLoop InconsistencyUpdate notifications. (Optional) Enables SNMP STPX MIB RootInconsistencyUpdate notifications. (Optional) Enables software change notifications. (Optional) Enables software core notifications. (Optional) Enables upgrade notifications.

UpgradeJobStatusNot (Optional) Enables upgrade job status notifications. ify UpgradeOpNotifyOn Completion zone (Optional) Enables upgrade global status notifications. (Optional) Enables default zone change notifications.

default-zone-behavior (Optional) Enables default zone behavior change notifications. -change merge-failure merge-success request-reject1 unsupp-mem (Optional) Enables merge failure notifications. (Optional) Enables merge success notifications. (Optional) Enables request reject notifications. (Optional) Enables unsupported member notifications.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

380

OL-25806-03

S Commands snmp-server enable traps

Defaults

License and SNMP authentication notifications are enabled.

Command Modes

Global configuration mode

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1) 4.0(2) 4.0(3) 5.0(2)

Modification This command was introduced. Added the OSPF rate-limit keyword. Added the eigrp keyword. Added the cfs, config, feature-control, rmon, and zone keywords.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to enable BGP notifications:

switch# configure terminal switch(config) snmp-server enable traps bgp

Related Commands

Command show snmp trap

Description Displays the enable or disable state of all SNMP notifications.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

381

S Commands snmp-server globalEnforcePriv

snmp-server globalEnforcePriv
To globally enforce privacy for all Simple Network Management Protocol (SNMP) users, use the snmp-server globalEnforcePriv command. To disable global privacy, use the no form of this command. snmp-server globalEnforcePriv no snmp-server globalEnforcePriv

Syntax Description

This command has no arguments or keywords.

Defaults

Disabled

Command Modes

Global configuration mode

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

Use the snmp-server globalEnforcePriv command to enforce privacy on all SNMP users. This command does not require a license.

Examples

This example shows how to globally enforce privacy for all SNMP contacts:
switch# configure terminal switch(config)# snmp-server globalEnforcePriv

Related Commands

Command show snmp

Description Displays information about SNMP.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

382

OL-25806-03

S Commands snmp-server host

snmp-server host
To specify the server host to receive Simple Network Management Protocol (SNMP) notifications, use the snmp-server host command. To remove the SNMP server configuration, use the no form of this command. snmp-server host host-name {snmp-name | filter-vrf {vrf-name | default | management}} | informs {snmp-name | version {1 snmp-name | 2c snmp-name | 3 {auth snmp-name | noauth snmp-name | priv snmp-name}}} | source-interface {ethernet number | loopback number | mgmt number | port-channel number | vlan number} | traps {snmp-name | version {1 snmp-name | 2c snmp-name | 3 {auth snmp-name | noauth snmp-name | priv snmp-name}} | use-vrf {vrf-name | default | management} | version {1 snmp-name | 2c snmp-name | 3 {auth snmp-name | noauth snmp-name | priv snmp-name}} udp-port port no snmp-server host host-name {snmp-name | filter-vrf {vrf-name | default | management}} | informs {snmp-name | version {1 snmp-name | 2c snmp-name | 3 {auth snmp-name | noauth snmp-name | priv snmp-name}}} | source-interface {ethernet number | loopback number | mgmt number | port-channel number | vlan number} | traps {snmp-name | version {1 snmp-name | 2c snmp-name | 3 {auth snmp-name | noauth snmp-name | priv snmp-name}} | use-vrf {vrf-name | default | management} | version {1 snmp-name | 2c snmp-name | 3 {auth snmp-name | noauth snmp-name | priv snmp-name}} udp-port port

Syntax Description

host-name snmp-name filter-vrf vrf-name default management informs version 1 2c 3 auth noauth priv source-interface ethernet number

IP4 or IPv6 address or name of the host. SNMP community string or SNMPv3 username. The maximum number of alphanumeric characters is 32. Specifies the virtual routing and forwarding (VRF) instance whose notifications are to be filtered. Name of the VRF. The maximum number of alphanumeric characters is 32. Specifies the default VRF. Specifies the management VRF. Sends SNMP information to this host. Specifies the SNMP version used to send notifications. Specifies SNMPv1. Specifies SNMPv2c. Specifies SNMPv3. Specifies the SNMPv3 authNoPriv security level. Specifies the SNMPv3 noAuthNoPriv security level. Specifies the SNMPv3 authPriv security level. Specifies the source interface used to send SNMP notifications to this host. Specifies the Ethernet IEEE 802.3z slot number and port number in this format: 1/1. The range for the slot number is from 1 to 18, and the range for the port number is from 1 to 128. Specifies the management interface number. The value is 0.

loopback number Specifies the virtual interface number. The range is from 0 to 1023. mgmt number

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

383

S Commands snmp-server host

port-channel number vlan number traps use-vrf udp-port port

Specifies the port-channel number and the subinterface number in this format: 1.1. The range for the port-channel number is from 1 to 4096, and the range for the subinterface number is from 1 to 4093. Specifies the VLAN interface number. The range is from 1 to 4094. Sends SNMP traps to this host. Specifies the name of the VRF on which notifications are to be sent. Specifies the User Datagram Protocol (UDP) port number of the notification host. The range is from 0 to 65535.

Defaults

None

Command Modes

Global configuration mode

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.2(1)

Modification This command was introduced.

Usage Guidelines

The source-interface configuration overrides the global source-interface configuration. This command does not require a license.

Examples

This example shows how to configure an SNMP server host:

switch(config)# snmp-server host 192.0.2.1 traps snmp1 udp-port 1

This example shows how to remove an SNMP server host:

switch(config)# no snmp-server host 192.0.2.1 traps snmp1 udp-port 1 switch(config)#

Related Commands

Command snmp-server community snmp-server contact

Description Configures the SNMP community string. Configures the SNMP contact information.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

384

OL-25806-03

S Commands snmp-server host filter-vrf

snmp-server host filter-vrf

To configure a Simple Network Management Protocol (SNMP) host receiver to gather notifications that occur on a specific virtual routing and forwarding (VRF) instance, use the snmp-server host filter-vrf command. To remove the VRF filter, use the no form of this command. snmp-server host host-address filter-vrf vrf-name [udp-port port] no snmp-server host host-address filter-vrf vrf-name [udp-port port]

Syntax Description

host-address vrf-name udp-port port

Name or IP address of the host (the targeted recipient). Name of the VRF. The name can be any alphanumeric string up to 63 characters. (Optional) Specifies the port UDP port of the host to use. The range is from 0 to 65535. The default is 162.

Defaults

None

Command Modes

Global configuration mode

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure the host receiver to receive notifications from the red VRF.
switch# config terminal switch(config)# snmp-server host 10.1.1.1 filter-vrf red

Related Commands

Command show snmp snmp-server host snmp-server host use-vrf

Description Displays SNMP information. Configures an SNMP host receiver. Configures Cisco NX-OS to send notifications on the specified VRF to communicate with an SNMP host receiver.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

385

S Commands snmp-server host use-vrf

snmp-server host use-vrf

To configure the device to communicate with a Simple Network Management Protocol (SNMP) host receiver on a specific virtual routing and forwarding (VRF) instance, use the snmp-server host use-vrf command. To return to the default, use the no form of this command. snmp-server host host-address use-vrf vrf-name [udp-port port] no snmp-server host host-address use-vrf vrf-name [udp-port port]

Syntax Description

host-address vrf-name udp-port port

Name or IP address of the host (the targeted recipient). Name of the VRF. The name can be any alphanumeric string up to 63 characters. (Optional) Specifies the port UDP port of the host to use. The range is from 0 to 65535. The default is 162.

Defaults

None

Command Modes

Global configuration mode

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure Cisco NX-OS to communicate with the host receiver on the blue VRF.
switch# config terminal switch(config)# snmp-server host 10.1.1.1 use-vrf blue

Related Commands

Command show snmp snmp-server host snmp-server host filter-vrf

Description Displays SNMP information. Configures an SNMP host receiver. Sends only notifications on the specified VRF to the host receiver.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

386

OL-25806-03

S Commands snmp-server location

snmp-server location
To configure the device location used by the Simple Network Management Protocol (SNMP), use the snmp-server location command. To remove the location, use the no form of this command. snmp-server location [location] no snmp-server location [location]

Syntax Description

location

(Optional) System location. The location can be any alphanumeric string up to 255 characters.

Defaults

None

Command Modes

Global configuration mode

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to set the SNMP location:

switch# config terminal switch(config)# snmp-server location SanJose

Related Commands

Command show snmp

Description Displays information about SNMP.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

387

S Commands snmp-server mib community-map

snmp-server mib community-map

To configure the Simple Network Management Protocol (SNMP) version 2c community to context mapping, use the snmp-server mib community-map command. To remove the community to context mapping, use the no form of this command. snmp-server mib community-map community-string context context-name no snmp-server mib community-map community-string context context-name

Syntax Description

community-string context context-name

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

Defaults

None

Command Modes

Global configuration mode

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(2)

Modification This command was introduced.

Usage Guidelines

Use the snmp-server mib community-map command to map between SNMPv2c communities and SNMP contexts. Use the snmp-server context command to map this context to a logical network entity. For more information on context mapping, see the Cisco Nexus 7000 Series NX-OS Security Configuration Guide, Release 6.x. This command does not require a license.

Examples

This example shows how to map the public community to the public1 context:
switch# configure terminal switch(config)# snmp-server mib community-map public context public1

Cisco Nexus 7000 Series NX-OS System Management Command Reference

388

OL-25806-03

S Commands snmp-server mib community-map

Related Commands

Command show snmp context snmp-server context

Description Displays information about SNMP contexts. Maps an SNMP context to a logical network entity.

show snmp community Displays information about SNMP communities.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

389

S Commands snmp-server protocol enable

snmp-server protocol enable

To enable the Simple Network Management Protocol (SNMP), use the snmp-server protocol enable command. To disable SNMP, use the no form of this command. snmp-server protocol enable no snmp-server protocol enable

Syntax Description

This command has no arguments or keywords.

Defaults

Enabled

Command Modes

Global configuration mode

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(3)

Modification This command was introduced.

Usage Guidelines

Use the no snmp protocol enable command to disable SNMP and close any TCP or UDP ports associated with the protocol. This command does not require a license.

Examples

This example shows how to disable SNMP:

switch# configure terminal switch(config)# no snmp-server protocol enable

Cisco Nexus 7000 Series NX-OS System Management Command Reference

390

OL-25806-03

S Commands snmp-server source-interface

snmp-server source-interface
To configure a Simple Network Management Protocol (SNMP) source interface through which notifications are sent, use the snmp-server source-interface command. To remove the SNMP source interface configuration, use the no form of this command. snmp-server source-interface {traps | informs} {ethernet number | loopback number | mgmt number | port-channel number | vlan number} no snmp-server source-interface {traps | informs} {ethernet number | loopback number | mgmt number | port-channel number | vlan number}

Syntax Description

traps informs ethernet number loopback number mgmt number port-channel number vlan number

Sends SNMP traps through the source interface. Sends SNMP information through the source interface. Specifies the Ethernet IEEE 802.3z slot number and port number in this format: 1/1. The range for the slot number is from 1 to 18, and the range for the port number is from 1 to 128. Specifies the virtual interface number. The range is from 0 to 1023. Specifies the management interface number. Specifies the port-channel number and the subinterface number in this format: 1.1. The range for the port-channel number is from 1 to 4096, and the range for the subinterface number is from 1 to 4093. Specifies the VLAN interface number. The range is from 1 to 4094.

Defaults

None

Command Modes

Global configuration mode

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.2(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure an SNMP source interface:

switch(config)# snmp-server source-interface traps ethernet 1/1

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

391

S Commands snmp-server source-interface

This example shows how to remove the SNMP source interface:

switch(config)# no snmp-server source-interface traps ethernet 1/1 switch(config)#

Related Commands

Command snmp-server community snmp-server host

Description Configures the SNMP community string. Configures a host receiver for SNMP notifications.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

392

OL-25806-03

S Commands snmp-server tcp-session

snmp-server tcp-session
To enable one-time authentication for Simple Network Management Protocol (SNMP) over a TCP session, use the snmp-server tcp-session command. To disable one-time authentication for SNMP over a TCP session, use the no form of this command. snmp-server tcp-session [auth] no snmp-server tcp-session [auth]

Syntax Description

auth

(Optional) Enables one-time authentication for SNMP over a TCP session.

Defaults

One-time authentication for SNMP over a TCP session is enabled.

Command Modes

Global configuration mode

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to enable one-time authentication for SNMP over a TCP session.
switch# config t switch(config)# snmp-server tcp-session auth

Related Commands

Command show snmp

Description Displays information about SNMP.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

393

S Commands snmp-server user

snmp-server user
To configure the Simple Network Management Protocol (SNMP) user information, use the snmp-server user command. To disable the configuration or to revert to factory defaults, use the no form of this command. snmp-server user username [group-name] [auth {md5 | sha} password [priv [aes-128] password] [localizedkey] [engineID id] no snmp-server user username [group-name] [auth {md5 | sha} password [priv [aes-128] password] [localizedkey] [engineID id]

Syntax Description

username group-name auth md5 sha password

Name of the user. The name can be any case-sensitive, alphanumeric string up to 32 characters. (Optional) Name of the group. The name can be any case-sensitive, alphanumeric string up to 32 characters. (Optional) Sets authentication parameters for the user. Uses the MD5 algorithm for authentication. Uses the SHA algorithm for authentication. User password. The password can be any case-sensitive, alphanumeric string up to 64 characters. If you configure the localizedkey keyword, the password can be any case-sensitive, alphanumeric string up to 130 characters (Optional) Sets encryption parameters for the user. (Optional) Sets the 128-byte AES algorithm for privacy. (Optional) Sets passwords in the localized key format. If you configure this keyword, the password can be any case-sensitive, alphanumeric string up to 130 characters. (Optional) Configures the SNMP Engine ID for a notification target user. The engineID format is a 12-digit colon-separated decimal number.

priv aes-128 localizedkey

engineID id

Defaults

None

Command Modes

Global configuration mode

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

Use the snmp-server user command to configure user authentication and privacy settings for SNMP. If you use the localizedkey keyword, you cannot port the SNMP user configuration across devices because the user password contains information on the engine ID of the device. If you copy a configuration file

Cisco Nexus 7000 Series NX-OS System Management Command Reference

394

OL-25806-03

S Commands snmp-server user

into the device, the passwords may not be set correctly if the configuration file was generated at a different device. We recommend that you explicitly configure passwords after copying the configuration into the device. SNMP Version 3 is the most secure model, because it allows packet encryption with the priv keyword. To assign multiple roles to a user, configure multiple snmp-server user username group-name commands. The group-name argument is defined by the role name command. If you are configuring an SNMP notification target user, use the engineID keyword to configure the SNMP engine ID for this user. To delete the user or the role associated with that user, use the no form of this command.

Note

You cannot delete the last role for a user. This command does not require a license.

Examples

This example shows how to set the user authentication information for user jane:
switch# config terminal switch(config)# snmp-server user jane network-admin auth sha abcd1234

This example shows how to multiple roles for user sam:

switch# config terminal switch(config)# snmp-server user sam network-admin switch(config)# snmp-server user sam testrole

This example shows how to set user authentication and privacy information for user Juan:
switch# config terminal switch(config)# snmp-server user Juan network-admin auth sha abcd1234 priv abcdefgh

This example shows how to set user authentication and SNMP engine ID for a notification target user:
switch# config terminal switch(config)# snmp-server user notifUser network-admin auth sha abcd1234 engineID 00:12:00:00:09:03:00:05:48:00:74:30

Related Commands

Command role name show snmp snmp-server host

Description Configures role profiles used as SNMP group names. Displays SNMP information. Configures SNMP server host information.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

395

S Commands snmp-server user enforcePriv

snmp-server user enforcePriv

To enforce privacy for a Simple Network Management Protocol (SNMP) user, use the snmp-server user enforcePriv command. To revert to factory defaults, use the no form of this command. snmp-server user username enforcePriv no snmp-server user username enforcePriv

Syntax Description

username

Name of the user. The name can be any case-sensitive, alphanumeric string up to 32 characters.

Defaults

None

Command Modes

Global configuration mode

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to enforce privacy for the user joe:
switch# config terminal switch(config)# snmp-server user joe enforcePriv

Related Commands

Command role name show snmp snmp-server user

Description Configures role profiles used as SNMP group names. Displays SNMP information. Configures SNMP user information.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

396

OL-25806-03

S Commands snmp-trap

snmp-trap
To generate a Simple Network Management Protocol (SNMP) trap when an Embedded Event Manager (EEM) applet is triggered, use the snmp-trap command. snmp-trap [intdata1 integer-data1] [intdata2 integer-data2] [strdata string-data] event-type ev_type policy-name name

Syntax Description

intdata1 integer-data1 intdata2 integer-data2 strdata string-data event-type ev_type policy-name name

(Optional) Specifies an integer to be sent in the SNMP trap message to the SNMP agent. (Optional) Specifies a second integer to be sent in the SNMP trap message to the SNMP agent. (Optional) Specifies a string to be sent in the SNMP trap message to the SNMP agent. If the string contains embedded blanks, enclose it in double quotation marks. Specifies the event type. Event type. Specifies the policy name. Policy name.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to generate an SNMP trap when an EEM applet is triggered:
switch(config)# event manager applet snmp-applet switch(config-applet)# action 1 snmp-trap strdata "EEM detected server failure switch(config-applet)#

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

397

S Commands snmp-trap

Related Commands

Command syslog

Description Configures a syslog message to generate when an Embedded Event Manager (EEM) applet is triggered.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

398

OL-25806-03

S Commands source

source
To configure the NetFlow exporter interface to use to reach the NetFlow collector for the configured destination, use the source command. To remove the source, use the no form of this command. source if-type if-number no source [if-type if-number]

Syntax Description

if-type if-number

Interface type. For more information, use the question mark (?) online help function. Interface or subinterface number. For more information about the numbering syntax for your networking device, use the question mark (?) online help function.

Defaults

None

Command Modes

NetFlow exporter configuration (config-flow-exporter)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure the NetFlow exporter source interface:
switch(config)# flow exporter Netflow-Exporter-1 switch(config-flow-exporter)# source Ethernet3/11 switch(config-flow-exporter)#

This example shows how to remove the Netflow exporter source interface configuration:
switch(config-flow-exporter)# no source Ethernet3/11 switch(config-flow-exporter)#

Related Commands

Command show flow exporter

Description Displays information about NetFlow exporters.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

399

S Commands source

source
To configure sources and the traffic direction in which to copy packets, use the source command. To remove sources, use the no form of this command. source {interface interface_range | vlan vlan_range} [src_dir] no source {interface interface_range | vlan vlan_range} [src_dir]

Syntax Description

interface Specifies interfaces. The range is from 1 to 128. interface_range vlan vlan_range src_dir Specifies the VLAN type. The VLAN range is from 1 to 3967 and 4048 to 4093. (Optional) Source direction. The traffic direction to copy as ingress (tx), egress (tx), or both. By default, the direction is both.

Defaults

None

Command Modes

Config-tx-only-monitor configuration (config- monitor)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

You can configure one or more sources, as either a series of comma-separated entries, or a range of numbers. You can specify up to 128 interfaces. The traffic direction to copy as ingress (tx), egress (tx), or both. By default, the direction is both. This command does not require a license.

Examples

This example shows how to configure sources and the traffic direction in which to copy packets:
switch(config)# monitor session 1 switch(config-monitor)# source vlan 3, 6-10 tx switch(config-monitor)#

This example shows how to remove a source configuration:

switch(config-monitor)# no source vlan 3, 6-10 tx switch(config-monitor)#

Cisco Nexus 7000 Series NX-OS System Management Command Reference

400

OL-25806-03

S Commands source

Related Commands

Command show monitor session copy running-config startup-config

Description Displays the virtual SPAN or ERSPAN configuration. Copies the running configuration to the startup configuration.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

401

S Commands source exception

source exception
To configure the source as an exception Ethernet Switched Port Analyzer (SPAN) or Encapsulated Remote Switched Port Analyzer (ERSPAN) session, use the source exception command. To remove the source as an exception SPAN or ERSPAN session, use the no form of this command. source exception {layer3 | fabricpath | other | all} no source exception {layer3 | fabricpath | other | all}

Syntax Description

layer3 fabricpath other all

Specifies the Layer 3 exception type for F2 Series and M Series modules. Specifies the FabricPath exception type for F Series modules. Specifies exceptions for M Series modules that are dropped through redirect registers programmed with a drop destination interface. Includes all Layer 3, FabricPath, and other exceptions.

Defaults

None

Command Modes

config-monitor mode (for a SPAN session) config-erspan-src mode (for an ERSPAN session)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 6.2(2)

Modification This command was introduced.

Usage Guidelines

M1 and M2 Series modules support exception SPAN only in the nonadministration virtual device context (VDC), and at least one interface of the module must be present for the VDC. This command does not require a license.

Examples

This example shows how to configure the source as an exception SPAN session:
switch(config)# monitor session 1 switch(config-monitor)# source exception all

This example shows how to configure the source as an exception ERSPAN session:
switch(config)# monitor session 3 type erspan-source switch(config-erspan-src)# source exception all

Cisco Nexus 7000 Series NX-OS System Management Command Reference

402

OL-25806-03

S Commands source exception

Related Commands

Command monitor session show monitor session

Description Enters the monitor configuration mode. Displays the virtual SPAN or ERSPAN configuration.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

403

S Commands switchport monitor

switchport monitor
To configure the switchport interface as a Switched Port Analyzer (SPAN) destination, use the switchport monitor command. To disable the configuration, use the no form of this command. switchport monitor [ingress [learning]] no switchport monitor [ingress [learning]]

Syntax Description

ingress

(Optional) Allows the SPAN destination port to inject packets that disrupt a certain TCP packet stream, for example, in networks with an intrusion detection system (IDS). (Optional) Allows the SPAN destination port to inject packets, and allows the learning of MAC addresses, for example, the IDS MAC address.

learning

Defaults

None

Command Modes

Interface configuration mode

Command History

Release 4.1(2)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure the Ethernet interface 7/2 as a SPAN destination:
switch# config t Enter configuration commands, one per line. switch(config)# interface eth 7/2 switch(config-if)# switchport monitor switch(config-if)# End with CNTL/Z.

This example shows how to configure the Ethernet interface 7/2 as a SPAN destination and allow it to inject packets and learn MAC addresses:
switch# config t Enter configuration commands, one per line. End with CNTL/Z. switch(config)# interface eth 7/2 switch(config-if)# switchport monitor ingress learning switch(config-if)#

This example shows how to disable the SPAN destination on Ethernet interface 7/2:
switch# config t Enter configuration commands, one per line. switch(config)# interface eth 7/2 switch(config-if)# no switchport monitor End with CNTL/Z.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

404

OL-25806-03

S Commands switchport monitor

switch(config-if)#

Related Commands

Command monitor session show monitor session

Description Enters the monitor configuration mode for configuring a SPAN session. Displays the SPAN or ERSPAN session configuration.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

405

S Commands system cores

system cores
To configure the destination for the system core, use the system cores command. To revert to the default, use the no form of this command. system cores {slot0: [path] | tftp:/server// [path/]} filename no system cores

Syntax Description

slot0: path/ tftp: /server// filename

Specifies the slot0: external file system. (Optional) Directory path to the file. The directory names in the path are case sensitive. Specifies a TFTP server. Name or IPv4 address of the TFTP server. The server name is case sensitive. Name for the core file. The name is alphanumeric, case sensitive, and has a maximum of 32 characters.

Defaults

None

Command Modes

Global configuration mode

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure a core file:

switch# configure terminal switch(config)# system cores slot0:core_file

This example shows how to disable system core logging:

switch# configure terminal switch(config)# no system cores

Cisco Nexus 7000 Series NX-OS System Management Command Reference

406

OL-25806-03

S Commands system cores

Related Commands

Command clear system cores show system cores

Description Clears the core file. Displays the core filename.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

407

S Commands system hap-reset

system hap-reset
To enable the Supervisor Reset high availability (HA) policy, use the system hap-reset command. system hap-reset

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to enable the Supervisor Reset HA policy:

switch(config)# system hap-reset switch(config)#

Related Commands

Command show system standby manual-boot

Description Displays the status of the system standby manual boot option.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

408

OL-25806-03

S Commands system heartbeat

system heartbeat
To enable heartbeat checks (default) and revert to the factory default, use the system heartbeat command. system heartbeat

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to enable the heartbeat checks (default) and revert to the factory default:
switch(config)# system heartbeat switch(config)#

Related Commands

Command system no hap-reset

Description Disables the heartbeat checks (default) and reverts to the factory default.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

409

S Commands system no hap-reset

system no hap-reset
To disable the Supervisor Reset high availability (HA) policy, use the system no hap-reset command. system no hap-reset

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to disable the Supervisor Reset HA policy:

switch(config)# system no hap-reset switch(config)#

Related Commands

Command system hap-reset

Description Enables the Supervisor Reset HA policy.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

410

OL-25806-03

S Commands system no heartbeat

system no heartbeat
To disable the heartbeat checking (default) and revert to the factory default, use the system no heartbeat command. system no heartbeat

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to disable the heartbeat checks (default) and revert to the factory default:
switch(config)# system no heartbeat switch(config)#

Related Commands

Command system heartbeat

Description Enables the heartbeat checks (default) and reverts to the factory default.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

411

S Commands system no standby manual-boot

system no standby manual-boot

To disable the system standby manual boot option, use the system no standby manual-boot command. system no standby manual-boot

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to disable the system standby manual boot option:
switch(config)# system no standby manual-boot system standby manual-boot option disabled switch(config)#

Related Commands

Command show system standby manual-boot

Description Displays the status of the system standby manual boot option.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

412

OL-25806-03

S Commands system no watchdog

system no watchdog
To disable the watchdog feature, use the system no watchdog command. system no watchdog

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to disable the watchdog feature:

switch(config)# system no watchdog switch(config)#

Related Commands

Command system no watchdog kgdb

Description Prevents the system from entering the Linux KGDB debugger on a watchdog failure.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

413

S Commands system no watchdog kgdb

system no watchdog kgdb

To prevent the system from entering the Linux KGDB debugger on a watchdog failure, use the system no watchdog kgdb command. system no watchdog kgdb

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to prevent the system from entering the Linux KGDB debugger on a watchdog failure:
switch(config)# system no watchdog kgdb switch(config)#

Related Commands

Command system no watchdog

Description Disables the watchdog feature.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

414

OL-25806-03

S Commands system pss shrink

system pss shrink

To shrink Persistent Storage Service (PSS) files on the system, use the system pss shrink command. system pss shrink

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to shrink PSS files on the system:

switch(config)# system pss shrink pss shrink completed switch(config)

Related Commands

Command show system pss shrink status

Description Displays the last PSS shrink status.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

415

S Commands system standby manual-boot

system standby manual-boot

To display the standby manual-boot status, use the system standby manual-boot command. system standby manual-boot

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the standby manual-boot status:

switch(config)# system standby manual-boot system standby manual-boot option enabled switch(config)#

Related Commands

Command system startup-config init

Description Initializes the startup configuration.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

416

OL-25806-03

S Commands system startup-config init

system startup-config init

To initialize the startup configuration, use the system startup-config init command. system startup-config init

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to initialize the startup configuration:

switch(config)# system startup-config init WARNING: This command is going to re-initialize the contents of the startup-conf iguration. Do you want to continue? (y/n) [y]

Related Commands

Command system startup-config unlock

Description Releases the system startup-configuration lock.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

417

S Commands system startup-config unlock

system startup-config unlock

To release a system startup-configuration lock, use the system startup-config unlock command. system startup-config unlock luck-id

Syntax Description

luck-id

Startup-configuration lock ID. The range is from 0 to 65536.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to release a system startup-configuration lock:

switch(config)# system startup-config unlock switch(config)#

Related Commands

Command system startup-config init

Description Initializes the startup configuration.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

418

OL-25806-03

S Commands system test-preupgrade running-ver

system test-preupgrade running-ver

To test the running software version before an upgrade, use the system test-preupgrade running-ver command. system test-preupgrade running-ver version-number target-ver target-number swid id impact impact-number

Syntax Description

version-number Software version number currently running on the system. target-ver target-number swid id impact impact-number Specifies the target version of the software. Target version. Specifies the software ID of the image running on a module: system or kickstart. Software ID. Specifies the impact: 0 for hitless and 1 for hitful. Impact number.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to test the running software version before an upgrade:
switch(config)# system test-preupgrade running-ver 4.2<0.202> target-ver Update swid 4.2.1 impact 0 System will be upgraded according to following table: Module Swid Impact Running-Version New-Version Upg-Required ------ ---------- ---------- -------------------- -------------------- -----------6 4.2.1 hitless 4.2<0.202> Update 1 9 4.2.1 hitless 4.2<0.202> Update 1 11 4.2.1 hitless 4.2<0.202> Update

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

419

S Commands system test-preupgrade running-ver

Final upgrade impact table: Module Impact ------ ---------6 hitless 9 hitless 11 hitless

Message from services: switch(config)#

Related Commands

Command system startup-config unlock system startup-config init

Description Releases a system startup-configuration lock. Initializes the startup configuration.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

420

OL-25806-03

S Commands system switchover

system switchover
To switch over to the standby supervisor, use the system switchover command. system switchover

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to switch over to the standby supervisor:

switch# system switchover switch#

Related Commands

Command

Description

show system redundancy Displays the system redundancy status.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

421

S Commands system trace

system trace
To configure a system trace level, use the system trace command. To remove the system trace level configuration, use the no form of this command. system trace bit-mask no system trace [bit-mask]

Syntax Description

bit-mask

Bit mask to use to change the trace level of the system.

Defaults

None

Command Modes

Global configuration mode (config)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure a system trace level:

switch(config)# system trace switch(config)#

This example shows how to remove the system trace level configuration:
switch(config)# system no trace switch(config)#

Related Commands

Command show cores

Description Displays the system core files.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

422

OL-25806-03

S Commands system watchdog

system watchdog
To enable watchdog checks, use the system watchdog command. system watchdog

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to enable watchdog checks:

switch(config)# system watchdog switch(config)#

Related Commands

Command system no watchdog system no watchdog kgdb

Description Disables the watchdog feature. Prevents the system from entering the Linux KGDB debugger on a watchdog failure.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

423

S Commands system watchdog kgdb

system watchdog kgdb

To configure the system to enter the Linux KGDB debugger on a watchdog failure, use the system watchdog kgdb command. system watchdog kgdb

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure the system to enter the Linux KGDB debugger on a watchdog failure:
switch(config)# system watchdog kgdb switch(config)#

Related Commands

Command system watchdog system no watchdog

Description Enables the watchdog feature. Disables the watchdog feature.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

424

OL-25806-03

Show Commands
This chapter describes the Cisco NX-OS system management show commands.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

425

Show Commands show callhome

show callhome
To display information about the Call Home application, use the show callhome command. show callhome {destination-profile [profile profile_name] | last action status | last merge status | merge status | pending | pending-diff | session status | status | transport-email | user-def-cmds}

Syntax Description

destination-profile profile profile profile_name last action status last merge status merge status pending pending-diff

Displays the name of the destination profile. (Optional) Displays the default profile name. Name of the profile. The name can be the default profile name or the profiles that you created. Displays the status of the last Cisco Fabric Services (CFS) commit/abort operation. Displays the status of the last CFS merge operation for Call Home. Displays the status of the last CFS merge operation for Call Home. Displays the Call Home configuration changes in the pending CFS database. Displays the differences between the pending and running Call Home configuration. These differences would reflect changes made during the current CFS configuration session. Displays the status of the last CFS commit/abort operation for the Call Home configuration. Displays the CFS distribution state (enabled or disabled) for Call Home. Displays the Call Home e-mail transport configuration. Displays the CLI commands configured for each Call Home alert group.

session status status transport-email user-def-cmds

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

426

OL-25806-03

Show Commands show callhome

Examples

This example shows how to display the status of the last CFS operation for the Call Home application:
switch# show callhome last Last Action Time Stamp Last Action Last Action Result Last Action Failure Reason action status : None : None : None : none

This example shows how to display the Call Home destination profile named Noc101:
switch# show callhome destination-profile profile Noc101 Noc101 destination profile information maximum message size:2500000 message format:XML message-level:0 email addresses configured: alert groups configured: all

This example shows how to display the Call Home configuration:

switch# show callhome callhome enabled Callhome Information: contact person name(sysContact):who@where contact person's email:[email protected] contact person's phone number:+1-408-555-9918 street addr:425 E Street, Anytown, CA 95999 site id:8 customer id:987654 contract id:456789 switch priority:7 duplicate message throttling : enabled periodic inventory : enabled periodic inventory time-period : 7 days periodic inventory timeofday : 08:00 (HH:MM) Distribution : Enabled

Related Commands

Command callhome test callhome send callhome show cfs status show tech-support cfs show logging level cfs

Description Sends a test message to all configured destinations. Sends the specified Call Home test message to all configured destinations. Places you into the CLI call Home configuration mode. Displays the status of CFS distribution on the device as well as IP distribution information. Displays information about the CFS configuration required by technical support when resolving a CFS issue. Displays the CFS logging configuration.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

427

Show Commands show callhome transport

show callhome transport

To display the transport-related configuration for Call Home, use the show callhome transport command. show callhome transport

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 5.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the transport-related configuration for Call Home:
switch(config)# show callhome transport http vrf:default from email addr:[email protected] reply to email addr:[email protected] smtp smtp smtp smtp smtp smtp smtp smtp smtp smtp smtp smtp server:10.1.1.174 server port:25 server vrf: server priority:0 server:64.72.101.213 server port:25 server vrf:default server priority:60 server:172.21.34.193 server port:25 server vrf:default server priority:50

Cisco Nexus 7000 Series NX-OS System Management Command Reference

428

OL-25806-03

Show Commands show callhome transport

smtp smtp smtp smtp smtp smtp smtp smtp

server:192.0.2.1 server port:33 server vrf:Neo server priority:1 server:192.0.2.10 server port:25 server vrf:default server priority:4

switch(config)#

Related Commands

Command show callhome

Description Displays the Call Home configuration.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

429

Show Commands show cdp

show cdp
To display the interfaces that have the Cisco Discovery Protocol (CDP) enabled, use the show cdp command. show cdp {all | entry {all | name name} | global | interface interface-type | traffic interface interface-type}

Syntax Description

all entry name name global interface interface-type traffic interface-type

Displays all interfaces in the CDP database. Displays CDP entries in the database. Displays a specific CDP entry that matches a name. Displays CDP global parameters. Displays CDP parameters for an interface. Displays CDP traffic statistics. Type of interface.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the interfaces that have CDP enabled:
switch(config)# show cdp all mgmt0 is up CDP enabled on interface Refresh time is 60 seconds Hold time is 30 seconds Ethernet7/1 is down CDP enabled on interface Refresh time is 60 seconds Hold time is 30 seconds

Cisco Nexus 7000 Series NX-OS System Management Command Reference

430

OL-25806-03

Show Commands show cdp

Ethernet7/2 is down CDP enabled on interface Refresh time is 60 seconds Hold time is 30 seconds Ethernet7/3 is down CDP enabled on interface Refresh time is 60 seconds Hold time is 30 seconds Ethernet7/4 is down CDP enabled on interface Refresh time is 60 seconds Hold time is 30 seconds Ethernet7/5 is down CDP enabled on interface Refresh time is 60 seconds --More--

Related Commands

Command enable cdp

Description Enables CDP on an interface.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

431

Show Commands show cdp neighbors

show cdp neighbors

To display the status of Cisco Discovery Protocol (CDP) neighbors, use the show cdp neighbors command. show cdp neighbors [interface interface]

Syntax Description

interface interface

(Optional) Displays CDP neighbors on an interface.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the status of CDP neighbors:

switch(config)# show cdp neighbors Capability Codes: R - Router, T - Trans-Bridge, B - Source-Route-Bridge S - Switch, H - Host, I - IGMP, r - Repeater, V - VoIP-Phone, D - Remotely-Managed-Device, s - Supports-STP-Dispute Device-ID Switch switch(config)# Local Intrfce Hldtme Capability mgmt0 163 S I Platform Port ID WS-C2960-24TC Fas0/21

Related Commands

Command cdp holdtime

Description Configures the time that CDP holds onto neighbor information before refreshing it.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

432

OL-25806-03

Show Commands show cfs application

show cfs application

To display information about applications that are currently enabled to use Cisco Fabric Services (CFS) distribution, use the show cfs application command. show cfs application [name application_name]

Syntax Description

name application_name

(Optional) Displays the name of a specific application.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.1(2)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display CFS information about applications that are currently enabled to use CFS distribution:
switch# show cfs application ---------------------------------------------Application Enabled Scope ---------------------------------------------ntp No Physical-fc-ip stp Yes Physical-eth vpc Yes Physical-eth igmp Yes Physical-eth l2fm Yes Physical-eth role No Physical-fc-ip radius No Physical-fc-ip callhome Yes Physical-fc-ip Total number of entries = 8

This example shows how to display CFS information about the Call Home application:

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

433

Show Commands show cfs application

switch# show cfs application name callhome Enabled Timeout Merge Capable Scope Region : : : : : Yes 20s Yes Physical-fc-ip 4

Related Commands

Command

Description

show application_name Displays the CFS configuration session status for the application, including the last action, the result, and the reason if there was a failure. session status show cfs internal show cfs lock show cfs merge status name show cfs peers show cfs regions show cfs status show tech-support cfs show logging level cfs Displays information internal to CFS including memory statistics, event history, and so on. Displays all active CFS fabric locks. Displays the merge status for a given CFS application. Displays all the CFS peers in the physical fabric. Displays all the CFS applications with peers and region information. Displays the status of CFS distribution on the device as well as IP distribution information. Displays information about the CFS configuration required by technical support when resolving a CFS issue. Displays the CFS logging configuration.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

434

OL-25806-03

Show Commands show cfs lock

show cfs lock

To display information about locks that are currently in place for an application that uses Cisco Fabric Services (CFS) for distribution, use the show cfs lock command. show cfs lock [name application_name]

Syntax Description

name application_name

(Optional) Displays the name of a specific application.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.1(2)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display a lock that is currently in place for the Call Home application that uses CFS for distribution:
switch(config-callhome)# show cfs lock name callhome Scope : Physical-fc-ip -------------------------------------------------------------------------------Switch WWN IP Address User Name User Type -------------------------------------------------------------------------------20:00:00:22:55:79:a4:c1 172.28.230.85 admin CLI/SNMP v3 switch Total number of entries = 10

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

435

Show Commands show cfs lock

Related Commands

Command

Description

show application_name Displays the CFS configuration session status for the application, including the last action, the result, and the reason if there was a failure. session status show cfs application show cfs internal show cfs merge status name show cfs peers show cfs regions show cfs static show cfs status show tech-support cfs show logging level cfs Displays information about applications that are currently enabled to use CFS distribution. Displays information internal to CFS including memory statistics, event history, and so on. Displays the merge status for a given CFS application. Displays all the CFS peers in the physical fabric. Displays all the CFS applications with peers and region information. Displays all CFS static peers with status. Displays the status of CFS distribution on the device as well as IP distribution information. Displays information about the CFS configuration required by technical support when resolving a CFS issue. Displays the CFS logging configuration.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

436

OL-25806-03

Show Commands show cfs merge status

show cfs merge status

To display the merge status for an application that uses Cisco Fabric Services (CFS) for distribution, use the show cfs merge status command. show cfs merge status [name application_name]

Syntax Description

name application_name

(Optional) Displays the name of a specific application.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.1(2)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the current merge status for the Call Home application that uses CFS for distribution. In this example, the most recent merge for the Call Home application was successful.
switch(config-callhome)# show cfs merge status name callhome Physical-fc-ip Merge Status: Success [ Wed Dec 17 16:34:26 2008 ] Local Fabric -------------------------------------------------------------------------------Switch WWN IP Address -------------------------------------------------------------------------------20:00:00:22:55:79:a4:c1 172.28.230.85 [Merge Master] switch Total number of switches = 10

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

437

Show Commands show cfs merge status

Related Commands

Command

Description

show application_name Displays the CFS configuration session status for the application, including the last action, the result, and the reason if there was a failure. session status show cfs application show cfs internal show cfs lock show cfs peers show cfs regions show cfs static show cfs status show tech-support cfs show logging level cfs Displays information about applications that are currently enabled to use CFS distribution. Displays information internal to CFS including memory statistics, event history, and so on. Displays all active CFS fabric locks. Displays all the CFS peers in the physical fabric. Displays all the CFS applications with peers and region information. Displays all CFS static peers with status. Displays the status of CFS distribution on the device as well as IP distribution information. Displays information about the CFS configuration required by technical support when resolving a CFS issue. Displays the CFS logging configuration.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

438

OL-25806-03

Show Commands show cfs peers

show cfs peers

To display all peers in the physical fabric, use the show cfs peers command. show cfs peers [name application_name]

Syntax Description

name application_name

(Optional) Displays the name of a specific application.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.1(2)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display all peers in the physical fabric for the Call Home application:
switch(config-callhome)# show cfs peers name callhome Scope : Physical-fc-ip ------------------------------------------------------------------------Switch WWN IP Address ------------------------------------------------------------------------20:00:00:22:55:79:a4:c1 172.28.230.85 [Local] switch Total number of entries = 1

Related Commands

Command

Description

show application_name Displays the CFS configuration session status for the application, including the last action, the result, and the reason if there was a failure. session status show cfs application Displays information about applications that are currently enabled to use CFS distribution.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

439

Show Commands show cfs peers

Command show cfs internal show cfs lock show cfs merge status name show cfs regions show cfs static show cfs status show tech-support cfs show logging level cfs

Description Displays information internal to CFS including memory statistics, event history, and so on. Displays all active CFS fabric locks. Displays the merge status for a given CFS application. Displays all the CFS applications with peers and region information. Displays all CFS static peers with status. Displays the status of CFS distribution on the device as well as IP distribution information. Displays information about the CFS configuration required by technical support when resolving a CFS issue. Displays the CFS logging configuration.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

440

OL-25806-03

Show Commands show cfs regions

show cfs regions

To display all Cisco Fabric Services (CFS) applications with peers and region information, use the show cfs regions command. show cfs regions {name application_name | region region_id} show cfs regions brief {name application_name | region region_id}

Syntax Description

name application_name region region_id brief

(Optional) Displays peer and region information for a specified application. Displays peer and region information for a specified region ID. The range is from 1 to 200. Displays configured regions and applications but does not display peers.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.1(2)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display a brief version of all CFS regions:
switch# show cfs regions brief --------------------------------------Region Application Enabled --------------------------------------3 radius yes 4 callhome yes

This example shows how to display a specified CFS region:

switch# show cfs regions region 4

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

441

Show Commands show cfs regions

Region-ID : 4 Application: callhome Scope : Physical-fc-ip ------------------------------------------------------------------------Switch WWN IP Address ------------------------------------------------------------------------20:00:00:22:55:79:a4:c1 172.28.230.85 [Local] switch Total number of entries = 1

Related Commands

Command

Description

show application_name Displays the CFS configuration session status for the application, including the last action, the result, and the reason if there was a failure. session status show cfs application show cfs internal show cfs lock show cfs merge status name show cfs peers show cfs static show cfs status show tech-support cfs show logging level cfs Displays information about applications that are currently enabled to use CFS distribution. Displays information internal to CFS including memory statistics, event history, and so on. Displays all active CFS fabric locks. Displays the merge status for a given CFS application. Displays all the CFS peers in the physical fabric. Displays all CFS static peers with status. Displays the status of CFS distribution on the device as well as IP distribution information. Displays information about the CFS configuration required by technical support when resolving a CFS issue. Displays the CFS logging configuration.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

442

OL-25806-03

Show Commands show cfs status

show cfs status

To display the current state of Cisco Fabric Services (CFS), use the show cfs status command. show cfs status

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.1(2)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the current state of CFS:

switch# show cfs status Distribution : Enabled Distribution over IP : Enabled - mode IPv4 IPv4 multicast address : 239.255.70.83 IPv6 multicast address : ff15::efff:4653 Distribution over Ethernet : Disabled Total number of entries = 8

Related Commands

Command

Description

show application_name Displays the CFS configuration session status for the application, including the last action, the result, and the reason if there was a failure. session status show cfs internal show cfs lock show cfs merge status name Displays information internal to CFS including memory statistics, event history, and so on. Displays all active CFS fabric locks. Displays the merge status for a given CFS application.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

443

Show Commands show cfs status

Command show cfs peers show cfs regions show logging level cfs show tech-support cfs

Description Displays all the CFS peers in the physical fabric. Displays all the CFS applications with peers and region information. Displays the CFS logging configuration. Displays information about the CFS configuration required by technical support when resolving a CFS issue.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

444

OL-25806-03

Show Commands show checkpoint

show checkpoint
To display the contents of the checkpoint file, use the show checkpoint command. show checkpoint [name]

Syntax Description

name

(Optional) Name of the checkpoint file. The name can be any alphanumeric string up to 63 characters.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-operator vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the contents of the checkpoint file:
switch# show checkpoint stable -------------------------------------------------------Name: stable version 4.0(2) power redundancy-mode combined force license grace-period feature vrrp feature tacacs+ feature ospf feature pim feature pim6 feature msdp feature eigrp feature rip feature isis feature pbr feature private-vlan feature port-security feature interface-vlan

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

445

Show Commands show checkpoint

feature feature feature feature

dot1x hsrp lacp glbp

feature dhcp feature cts logging level port-security 5 logging level glbp 6 snmp-server context foo snmp-server community <removed> group vdc-operator snmp-server community <removed> group network-admin snmp-server community <removed> group vdc-admin role feature-group name X role feature-group name x role name x vlan policy deny vrf policy deny permit vrf x permit vrf X role name X username adminbackup password 5 $1$Oip/C5Ci$oOdx7oJSlBCFpNRmQK4na. role vdc-ope rator username adminbackup role network-operator username admin password 5 $1$8GYeC4uW$4WfnImcvtAKI6Uet.ePD.1 role network-admin

Related Commands

Command clear checkpoint database

Description Clears out all the checkpoint files.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

446

OL-25806-03

Show Commands show configuration session

show configuration session

To show information about the configuration sessions, use the show configuration session command. show configuration session [name] [status] [summary]

Syntax Description

name status summary

(Optional) Name of the configuration session, The name can be any case-sensitive, alphanumeric string up to 63 characters. (Optional) Shows the status of the configuration sessions. (Optional) Displays the summary of the active configuration sessions.

Defaults

Display information for all sessions

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display information about a configuration session. Each line represents a CLI command that Cisco NX-OS applies to the device when you commit the session.
switch# show configuration session myACLs config session name myACLs 0001 ip access-list test1 0002 permit tcp any any 0003 statistics

This example shows how to display the status of a configuration session:

switch(config-s)# show configuration session status Session Name : myACLS Last Action : None Last Action Status : Success Last Action Reason : -NALast Action Timestamp : 00:00:00 UTC Jan 01 1970

This example shows how to display a summary of the configuration sessions:

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

447

Show Commands show configuration session

switch(config-s)# show configuration session summary Name Session Owner Creation Time -------------------------------------------------------------------myACLS admin 21:34:39 UTC Apr 27 2008 status admin 00:53:23 UTC Apr 29 2008 a admin 01:47:30 UTC Apr 28 2008 myACLs admin 00:56:46 UTC Apr 29 2008 Number of active configuration sessions = 4 switch(config-s)#

Related Commands

Command show tech-support session-mgr

Description Shows detailed information about the configuration sessions for troubleshooting purposes.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

448

OL-25806-03

Show Commands show configuration session global-info

show configuration session global-info

To display information about the global configuration session, use the show configuration session global-info command. show configuration session global-info

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.1(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display information about the global configuration session:
switch(config)# show configuration session global-info Maximum number of sessions allowed : 32 Maximum number of commands (all ssns) : 102400 Current number of active sessions : 0 Current number of commands (all ssns) : 0 switch(config)#

Related Commands

Command show tech-support session-mgr

Description Displays detailed information about the configuration sessions for troubleshooting purposes.

show configuration session Displays information about the configuration sessions.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

449

Show Commands show cores

show cores
To display the system core files from the virtual device contexts (VDCs), use the show cores command. show cores [vdc-all | {vdc [e-vdc2 | vdc-id | switch]}]

Syntax Description

vdc-all vdc e-vdc2 vdc-id switch

(Optional) Displays core dumps from all VDCs. Displays all core dumps for the VDC. (Optional) VDC ID number of a nondefault VDC. The range is from 1 to 8. (Optional) VDC ID number. The range is from 1 to 8. (Optional) Displays the process core files for VDC number 1.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 6.2(2) 4.0(1)

Modification The switch keyword was added. This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the system core files:

switch(config)# show cores vdc-all VDC No Module-num Instance-num e ------ --------------------1 10 1 1 10 1 1 10 1 switch(config)# Process-name -----------xmlsa xmlsa xmlsa PID --32442 25163 21581 Core-create-tim --------------May 8 15:24 May 9 06:04 May 9 13:25

Cisco Nexus 7000 Series NX-OS System Management Command Reference

450

OL-25806-03

Show Commands show cores

Related Commands

Command show system core

Description Displays information about transferring cores.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

451

Show Commands show diagnostic bootup level

show diagnostic bootup level

To display information about bootup diagnostics, use the show diagnostic bootup level command. show diagnostic bootup level

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display information about the bootup diagnostic level:
switch# show diagnostic bootup level Current bootup diagnostic level: complete switch#

Related Commands

Command

Description

diagnostic bootup level Configures the diagnostic bootup level.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

452

OL-25806-03

Show Commands show diagnostic content module

show diagnostic content module

To display information about the diagnostic test content for a module, use the show diagnostic content module command. show diagnostic content module {all | module_number}

Syntax Description

module_number all

Diagnostic content module number. The range is from 1 to 10. Displays the diagnostic content for all modules.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

Use the show diagnostic content module command to display information about the tests configured on the module and the repeat interval time.

Examples

This example shows how to display information about the diagnostic test content for a module:
switch# show diagnostic content module 6 Module 6: Supervisor module-1X (Active) Diagnostics test suite attributes: B/C/* - Bypass bootup level test / Complete bootup level test / NA P/* - Per port test / NA S/* - Only applicable to standby unit / NA D/N/* - Disruptive test / Non-disruptive test / NA H/* - Always enabled monitoring test / NA F/* - Fixed monitoring interval test / NA X/* - Not a health monitoring test / NA E/* - Sup to line card test / NA L/* - Exclusively run this test / NA T/* - Not an ondemand test / NA A/I/* - Monitoring is active / Monitoring is inactive / NA Testing Interval (hh:mm:ss) _________________

ID ____

Name Attributes __________________________________ ____________

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

453

Show Commands show diagnostic content module

1) 2) 3) 4) 5) 6) 7) 8) 9) 10) 11) 12) 13) 14) switch

ManagementPortLoopback--------> EOBCPortLoopback--------------> ASICRegisterCheck-------------> USB---------------------------> CryptoDevice------------------> NVRAM-------------------------> RealTimeClock-----------------> PrimaryBootROM----------------> SecondaryBootROM--------------> CompactFlash------------------> ExternalCompactFlash----------> PwrMgmtBus--------------------> SpineControlBus---------------> SystemMgmtBus----------------->

C**D**X**T* C**D**X**T* ***N******A C**N**X**T* C**N**X**T* ***N******A ***N******A ***N******A ***N******A ***N******A ***N******A ***N******A ***N******A ***N******A

-NA-NA00:00:20 -NA-NA00:00:30 00:05:00 00:30:00 00:30:00 00:30:00 00:30:00 00:00:30 00:00:30 00:00:30

Related Commands

Command diagnostic start diagnostic stop show diagnostic bootup level show diagnostic description module show diagnostic ondemand setting show diagnostic results module slot

Description Starts on-demand diagnostics. Stops on-demand diagnostics. Displays information about bootup diagnostics. Displays the diagnostic description.

show diagnostic events Displays diagnostic events by error and information event type. Displays information about on-demand diagnostics. Displays information about the results of a diagnostic.

show diagnostic Displays information about a simulated diagnostic. simulation module slot show diagnostic status Displays test status for all tests on a module. module slot show module Displays module information including online diagnostic test status.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

454

OL-25806-03

Show Commands show diagnostic description module

show diagnostic description module

To display information about a diagnostic test for a module, use the show diagnostic description nodule command. show diagnostic description module slot test {test-ID | test-name | all}

Syntax Description

slot test test-ID test-name all

Diagnostic description slot number. The slot range is from 1 to 10. (Optional) Displays the diagnostic test selection. (Optional) Test ID. The range is from 1 to 14. (Optional) Test name. The test name can be any case-sensitive, alphanumeric string up to 32 characters. (Optional) Displays the test description for all tests on all modules.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display a diagnostic description for a module:

switch# show diagnostic description module 6 test 1 ManagementPortLoopback : A bootup test that tests loopback on the management port of the module

Related Commands

Command show diagnostic content

Description Displays diagnostic test names and test IDs.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

455

Show Commands show diagnostic events

show diagnostic events

To display information about diagnostic events, use the show diagnostic events command. show diagnostic events [error | info]

Syntax Description

error info

(Optional) Displays diagnostics by error type. (Optional) Displays diagnostics by information type.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.1(2)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display diagnostic events:

switch# show diagnostic events 1) Event:E_DEBUG, length:114, at 404616 usecs after Wed Jan 7 09:38:46 2009 [104] Event_INFO: TestName->ASICRegisterCheck TestingType->helth monitoring module-> 9 Result->pass Reason->Success

2) Event:E_DEBUG, length:114, at 414835 usecs after Wed Jan 7 09:38:26 2009 [104] Event_INFO: TestName->ASICRegisterCheck TestingType->helth monitoring module-> 9 Result->pass Reason->Success

3) Event:E_DEBUG, length:107, at 294482 usecs after Wed Jan 7 09:38:23 2009 [104] Event_INFO: TestName->PwrMgmtBus TestingType->helth monitoring module->9 Resul t->pass Reason->Success

This example shows how to display diagnostic events by information type:

switch# show diagnostic events info 1) Event:E_DEBUG, length:114, at 934712 usecs after Wed Jan 7 11:40:06 2009

Cisco Nexus 7000 Series NX-OS System Management Command Reference

456

OL-25806-03

Show Commands show diagnostic events

[104] Event_INFO: TestName->ASICRegisterCheck TestingType->helth monitoring module-> 9 Result->pass Reason->Success

2) Event:E_DEBUG, length:110, at 314512 usecs after Wed Jan 7 11:39:53 2009 [104] Event_INFO: TestName->SystemMgmtBus TestingType->helth monitoring module->9 Re sult->pass Reason->Success

This example shows how to display diagnostic events by event type:

switch# show diagnostic events error switch#

Related Commands

Command show diagnostic content

Description Displays diagnostic test names and test IDs.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

457

Show Commands show diagnostic ondemand setting

show diagnostic ondemand setting

To display information about the on-demand diagnostic test for a module, use the show diagnostic ondemand setting command. show diagnostic ondemand setting

Syntax Description

setting

Configures the diagnostic on-demand setting.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display diagnostic on-demand information:

switch# show diagnostic ondemand setting Test iterations = 1 Action on test failure = continue until test failure limit reaches 1

Related Commands

Command diagnostic ondemand setting

Description Configures the diagnostic on-demand setting.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

458

OL-25806-03

Show Commands show diagnostic result

show diagnostic result

To display diagnostic test results for a module, use the show diagnostic result command. show diagnostic result module {slot [test [test-id | test-name]] | all} [detail]

Syntax Description

slot test test-id test-name all detail

Diagnostic result slot number. The module slot range is from 1 to 10. (Optional) Displays the diagnostic test selection. (Optional) Test ID. The range is from 1 to 14. (Optional) Test name. The test name can be any case-sensitive, alphanumeric string up to 32 characters. Displays the test result for all tests on all modules. (Optional) Displays the detailed result.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display a diagnostic test result:

switch# show diagnostic result module 6 test 6 detail Current bootup diagnostic level: complete Module 6: Supervisor module-1X (Active) Diagnostic level at card bootup: complete Test results: (. = Pass, F = Fail, I = Incomplete, U = Untested, A = Abort, E = Error disabled) ______________________________________________________________________ 6) NVRAM-------------------------> . Error code ------------------> DIAG TEST SUCCESS Total run count -------------> 1574 Last test execution time ----> Thu Jun 26 09:28:40 2008 First test failure time -----> n/a

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

459

Show Commands show diagnostic result

Last test failure time ------> Last test pass time ---------> Total failure count ---------> Consecutive failure count ---> Last failure reason ---------> switch#

n/a Thu Jun 26 09:28:41 2008 0 0 No failures yet

Cisco Nexus 7000 Series NX-OS System Management Command Reference

460

OL-25806-03

Show Commands show diagnostic simulation

show diagnostic simulation

To display information about a simulated diagnostic for a module, use the show diagnostic simulation command. show diagnostic simulation module slot

Syntax Description

slot

Diagnostic simulation slot number. The range is from 1 to 10.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display information about simulated diagnostics:

switch# show diagnostic simulation module 6 Card(6): Supervisor module-1X ________________________________________________ -NAswitch#

Related Commands

Command diagnostic test simulation

Description Sets a simulated test result for a diagnostic test.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

461

Show Commands show diagnostic status

show diagnostic status

To display the test status for all tests, use the show diagnostic status command. show diagnostic status module slot

Syntax Description

slot

Diagnostic status slot number. The range is from 1 to 10.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display information about the test status for all tests on a module:
switch# show diagnostic status module 6 <BU>-Bootup Diagnostics, <HM>-Health Monitoring Diagnostics <OD>-OnDemand Diagnostics, <SCH>-Scheduled Diagnostics ============================================== Card:(6) Supervisor module-1X ============================================== Current running test Run by -NA-NACurrently Enqueued Test Run by -NA-NAswitch#

Cisco Nexus 7000 Series NX-OS System Management Command Reference

462

OL-25806-03

Show Commands show diff rollback-patch

show diff rollback-patch

To display the differences between the source and destination, use the show diff rollback-patch command. show diff rollback-patch {checkpoint name | running-config | startup-config}

Syntax Description

checkpoint name running-config startup-config

Displays the checkpoint name as the source configuration. Name of the checkpoint file. The name can be any alphanumeric string up to 63 characters. Displays the running configuration as the destination. Displays the startup configuration as the destination.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the differences between the stable checkpoint file and the running configuration:
switch# show diff rollback-patch checkpoint stable running-config switch#

Related Commands

Command show checkpoint rollback running checkpoint

Description Displays the contents of the checkpoint file. Implements a rollback for the configured checkpoint file.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

463

Show Commands show environment

show environment
To display information about the hardware environment status, use the show environment command. show environment [clock | fan | power | temperature]

Syntax Description

clock fan power temperature

(Optional) Displays information about the clock environment. (Optional) Displays information about the fan environment. (Optional) Displays information about the power environment. (Optional) Displays information about the temperature environment.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin vdc-admin network-operator vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

You can use this command to display information about the status of the hardware on your device. This command does not require a license.

Examples

This example shows how to display information about the hardware environment:
switch# show environment

Clock: ---------------------------------------------------------Clock Model Hw Status ---------------------------------------------------------A Clock Module -NotSupported/None B Clock Module -NotSupported/None

Cisco Nexus 7000 Series NX-OS System Management Command Reference

464

OL-25806-03

Show Commands show environment

Fan: -----------------------------------------------------Fan Model Hw Status -----------------------------------------------------Fan1(sys_fan1) 0.0 Ok Fan2(sys_fan2) 0.0 Ok Fan3(fab_fan1) 0.0 Ok Fan4(fab_fan2) 0.0 Ok Fan_in_PS1 --Ok Fan_in_PS2 --Ok Fan_in_PS3 --Absent Fan Air Filter : Absent

Temperature: -------------------------------------------------------------------Module Sensor MajorThresh MinorThres CurTemp Status (Celsius) (Celsius) (Celsius) -------------------------------------------------------------------2 Crossbar(s5) 105 95 40 Ok 2 CTSdev1 (s6) 115 105 47 Ok 2 CTSdev2 (s7) 115 105 51 Ok 2 CTSdev3 (s8) 115 105 47 Ok 2 CTSdev4 (s9) 115 105 48 Ok 2 CTSdev5 (s10) 115 105 47 Ok 2 CTSdev7 (s12) 115 105 50 Ok 2 CTSdev8 (s13) 115 105 50 Ok 2 CTSdev9 (s14) 115 105 48 Ok 2 CTSdev10(s15) 115 105 48 Ok 2 CTSdev11(s16) 115 105 46 Ok 2 CTSdev12(s17) 115 105 45 Ok 2 QEng1Sn1(s18) 115 105 43 Ok 2 QEng1Sn2(s19) 115 105 42 Ok 2 QEng1Sn3(s20) 115 105 39 Ok 2 QEng1Sn4(s21) 115 105 40 Ok 2 L2Lookup(s22) 115 105 43 Ok 2 L3Lookup(s23) 120 110 54 Ok

Power Supply: Voltage: 50 Volts ----------------------------------------------------PS Model Power Power Status (Watts) (Amp) ----------------------------------------------------1 N7K-AC-6.0KW 0.00 0.00 Ok 2 N7K-AC-6.0KW 6000.00 120.00 Ok 3 -----------0.00 0.00 Absent

Mod Model

--- ------------------2 N7K-M148GT-11 6 N7K-SUP1 Xb1 N7K-C7010-FAB-1

Power Requested (Watts) ------247.00 210.00 123.50

Power Requested (Amp) ---------4.94 4.20 2.47

Power Allocated (Watts) --------247.00 210.00 123.50

Power Allocated (Amp) ---------4.94 4.20 2.47

Status

---------Powered-Up Powered-Up Powered-Up

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

465

Show Commands show environment

Power Usage Summary: -------------------Power Supply redundancy mode: Power Supply redundancy operational mode: Total Power Capacity Power Power Power Power reserved for Supervisor(s) reserved for Fan Module(s) reserved for Fabric Module(s) currently used by Modules

Non-Redundant(combined) Non-Redundant(combined) 6000.00 W 420.00 2184.00 300.00 247.00 W W W W

Total Power Available

------------2849.00 W -------------

This example shows how to display information about the power environment:
switch# show environment power

Power Supply: Voltage: 50 Volts ----------------------------------------------------PS Model Power Power Status (Watts) (Amp) ----------------------------------------------------1 FIORANO 0.00 0.00 Ok 2 FIORANO 6000.00 120.00 Ok 3 -----------0.00 0.00 Absent

Mod Model

--- ------------------2 NURBURGRING 6 CATALUNYA Xb1 Estoril

Power Requested (Watts) ------247.00 210.00 123.50

Power Requested (Amp) ---------4.94 4.20 2.47

Power Allocated (Watts) --------247.00 210.00 123.50

Power Allocated (Amp) ---------4.94 4.20 2.47

Status

---------Powered-Up Powered-Up Powered-Up

Power Usage Summary: -------------------Power Supply redundancy mode: Power Supply redundancy operational mode: Total Power Capacity Power Power Power Power reserved for Supervisor(s) reserved for Fan Module(s) reserved for Fabric Module(s) currently used by Modules

Non-Redundant(combined) Non-Redundant(combined) 6000.00 W 420.00 2184.00 300.00 247.00 W W W W

Total Power Available

------------2849.00 W -------------

Related Commands

Command power redundancy-mode

Description Configures the power supply redundancy mode.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

466

OL-25806-03

Show Commands show environment power

show environment power

To display information about the power capacity and power distribution of the system, use the show environment power command. show environment power [ampere | detail]

Syntax Description

ampere detail

(Optional) Displays information about the power capacity and power distribution in amperes. (Optional) Displays detailed information about the power capacity and power distribution.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.2.(1)

Modification This command was introduced.

Usage Guidelines

By reading information from the power supply, the system displays the power consumption information. The actual power consumed by the system might be more than what is displayed. This command does not require a license.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

467

Show Commands show environment power

Examples

This example shows how to display information about the power capacity and power distribution of the system:
switch(config) show environment power ampere Power Supply: Voltage: 50 Volts Power Actual Total Supply Model Output Capacity (Ampere) (Ampere) ------- ------------------- ----------- ----------1 N7K-AC-6.0KW 29.40 A 120.00 A 2 N7K-AC-6.0KW 0.00 A 0.00 A 3 -----------0.00 A 0.00 A 4 -----------0.00 A 0.00 A

Status -------------Ok Ok Absent Absent

Module ------6 7 8 9 10 Xb1 Xb2 Xb3 Xb4 Xb5 fan1 fan2

Model ------------------N7K-M108X2-12L N7K-M148GS-11 N7K-M148GS-11L supervisor N7K-SUP1 N7K-C7018-FAB-1 xbar xbar xbar xbar N7K-C7018-FAN N7K-C7018-FAN

Actual Power Draw Allocated Status (Ampere) (Ampere) ----------- ----------- -------------371.00 A 17.00 A Powered-Up 254.00 A 9.00 A Powered-Up 247.00 A 8.00 A Powered-Up N/A 4.20 A Absent N/A 4.20 A Powered-Up N/A 2.00 A Powered-Up N/A 2.00 A Absent N/A 2.00 A Absent N/A 2.00 A Absent N/A 2.00 A Absent 4.34 A 14.72 A Powered-Up 3.78 A 10.74 A Powered-Up

N/A - Per module power not available

Power Usage Summary: -------------------Power Supply redundancy mode (configured) Power Supply redundancy mode (operational) Total Power Capacity (based on configured mode) Total Power of all Inputs (cumulative) Total Power Output (actual draw) Total Power Allocated (budget) Total Power Available for additional modules switch(config)#

Non-Redundant(combined) Non-Redundant(combined) 120.00 120.00 29.40 77.00 42.14 A A A A A

Related Commands

Command show environment show hardware capacity

Description Displays information about the hardware environment status. Displays information about the platform hardware resources currently utilized by the system.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

468

OL-25806-03

Show Commands show event manager environment

show event manager environment

To display the name and value of Embedded Event Manager (EEM) environment variables, use the show event manager environment command. show event manager environment {varname | all}

Syntax Description

varname all

Environment variable. Specifies all environment variables

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display all of the EEM environment variables:
switch# show event manager environment all switch#

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

469

Show Commands show event manager event-types

show event manager event-types

To display the Embedded Event Manager (EEM) event types, use the show event manager event-types command. show event manager event-types [detail | event-type-name] [module module]

Syntax Description

detail event-type-name module module

(Optional) Displays details of all event types. (Optional) Name of the event type. (Optional) Displays the events defined for a specific module. The range is from 1 to 10.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the details of the EEM event types:
switch# show event manager event-types detail switch#

Cisco Nexus 7000 Series NX-OS System Management Command Reference

470

OL-25806-03

Show Commands show event manager history events

show event manager history events

To display the Embedded Event Manager (EEM) events that have been triggered, use the show event manager history events command. show event manager history events [detail] [maximum number] [severity severity]

Syntax Description

detail severity severity

(Optional) Displays details of all event types. (Optional) Displays only those events that were of the specified severity.

maximum number (Optional) Specifies the maximum number of history events to display.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the EEM history events that have been triggered that were of severity 7:
switch# show event manager history events severity 7 switch#

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

471

Show Commands show event manager policy

show event manager policy

To display the registered Embedded Event Manager (EEM) policies, use the show event manager policy command. show event manager policy [detail] [policy-name | inactive]

Syntax Description

detail policy-name inactive

(Optional) Displays details of all policies. (Optional) Name of the policy. (Optional) Displays only those policies that are inactive.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the EEM policies:

switch# show event manager policy switch#

Cisco Nexus 7000 Series NX-OS System Management Command Reference

472

OL-25806-03

Show Commands show event manager policy-state

show event manager policy-state

To display the state of the named Embedded Event Manager (EEM) policy, use the show event manager policy-state command. show event manager policy-state name [module module]

Syntax Description

name module module

Name of a policy to display its state. (Optional) Displays the policy state defined for a specific module. The range is from 1 to 10.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the state of an EEM policy:

switch# show event manager policy-state policy42 switch#

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

473

Show Commands show event manager script

show event manager script

To display the script policy of the Embedded Event Manager (EEM), use the show event manager script command. show event manager script system {name | all}

Syntax Description

name all

Script name to display. Displays all the system scripts.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display all the system scripts defined in the EEM:
switch# show event manager script system all switch#

Cisco Nexus 7000 Series NX-OS System Management Command Reference

474

OL-25806-03

Show Commands show event manager system-policy

show event manager system-policy

To display the system policies of the Embedded Event Manager (EEM), use the show event manager system-policy command. show event manager system-policy [all]

Syntax Description

all

(Optional) Displays all policies (including advanced policies and those policies that cannot be overridden).

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

475

Show Commands show event manager system-policy

Examples

This example shows how to display the EEM system policies:

switch# show event manager system-policy Name : __BootupPortLoopback Description : Do CallHome, log error on affected ports after 1 consecutive f ailure of GOLD "BootupPortLoopback" test Overridable : Yes Name Description ted ports after Overridable Name Description ted ports after Overridable : __PortLoopback : Do CallHome, log error and disable further HM testing on affec 10 consecutive failures of GOLD "PortLoopback" test : Yes : __RewriteEngineLoopback : Do CallHome, log error and disable further HM testing on affec 10 consecutive failures of GOLD "RewriteEngineLoopback" test : Yes

Name : __asic_register_check Description : Do CallHome, log error and disable further HM testing for that ASIC device/instance after 20 consecutive failures of GOLD "AsicRegisterCheck" test Overridable : Yes Name : __compact_flash Description : Do CallHome, log error and disable further HM testing after 20 consecutive failures of GOLD "CompactFlash" test Overridable : Yes Name : __crypto_device Description : Do CallHome and log error when GOLD "CryptoDevice" test fails Overridable : Yes Name : __eobc_port_loopback Description : Do CallHome and log error when GOLD "EOBCPortLoopback" test fa ils Overridable : Yes Name : __ethpm_debug_1 Description : Action: none Overridable : Yes Name : __ethpm_debug_2 Description : Action: none Overridable : Yes Name : __ethpm_debug_3 Description : Action: none Overridable : Yes Name : __ethpm_debug_4 Description : Action: none Overridable : Yes Name : __ethpm_link_flap Description : More than 30 link flaps in 420 seconds interval. Action: Error Disable the port Overridable : Yes Name : __external_compact_flash Description : Do CallHome, log error and disable further HM testing after 20 consecutive failures of GOLD "ExternalCompactFlash" test Overridable : Yes switch#

Cisco Nexus 7000 Series NX-OS System Management Command Reference

476

OL-25806-03

Show Commands show flow exporter

show flow exporter

To display the Flexible NetFlow flow exporter status and statistics, use the show flow exporter command. show flow exporter [name exporter-name]

Syntax Description

name exporter-name

(Optional) Specifies the name of a flow exporter. The name can be any case-sensitive, alphanumeric string up to 64 characters.

Defaults

Information for all flow exporters configured on the router is displayed.

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

You must have already enabled traffic monitoring with Flexible NetFlow using an exporter before you can use the show flow exporter command. This command does not require a license.

Examples

This example shows how to display the status and statistics for all of the flow exporters configured on the router:
switch# show flow exporter Flow Exporter NFC-DC-PHOENIX: Export Version 5 Exporter Statistics Number of Flow Records Exported 0 Number of Export Packets Sent 0 Number of Export Bytes Sent 0 Number of Destination Unreachable Events 0 Number of No Buffer Events 0 Number of Packets Dropped (No Route to Host) 0 Number of Packets Dropped (other) 0 Number of Packets Dropped (LC to RP Error) 0 Number of Packets Dropped (Output Drops) 0 Time statistics were last cleared: Never Flow exporter timeout:

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

477

Show Commands show flow exporter

Export Version 5 Exporter Statistics Number of Flow Records Exported 0 Number of Export Packets Sent 0 Number of Export Bytes Sent 0 Number of Destination Unreachable Events 0 Number of No Buffer Events 0 Number of Packets Dropped (No Route to Host) 0 Number of Packets Dropped (other) 0 Number of Packets Dropped (LC to RP Error) 0 Number of Packets Dropped (Output Drops) 0 Time statistics were last cleared: Never Flow exporter test-exporter: Description: test server in San Jose CA Export Version 5 Exporter Statistics Number of Flow Records Exported 0 Number of Export Packets Sent 0 Number of Export Bytes Sent 0 Number of Destination Unreachable Events 0 Number of No Buffer Events 0 Number of Packets Dropped (No Route to Host) 0 Number of Packets Dropped (other) 0 Number of Packets Dropped (LC to RP Error) 0 Number of Packets Dropped (Output Drops) 0 Time statistics were last cleared: Never

Related Commands

Command clear flow exporter destination dscp export-protocol flow exporter option show flow exporter source template transport ttl

Description Clears the statistics for exporters. Configures an export destination for flow exporters. Configures optional differentiated services code point (DSCP) parameters for flow exporters. Configures the export protocol version for flow exporters. Creates a flow exporter. Configure options for flow exporters. Displays flow exporter status and statistics. Configures the source IP address interface for flow exporters. Configures the template resend timeout for flow exporters. Configures the transport protocol for flow exporters. Configures the time-to-live (TTL) value for flow exporters.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

478

OL-25806-03

Show Commands show flow interface

show flow interface

To display the Flexible NetFlow configuration and status for an interface, use the show flow interface command. show flow interface [interface-type number]

Syntax Description

interface-type number

(Optional) Type of interface that you want to view Flexible NetFlow accounting configuration information on.

Defaults

Information for the Flexible NetFlow accounting configuration on the interface is displayed.

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

You must have already enabled traffic monitoring with Flexible NetFlow before you can use the show flow interface command. This command does not require a license.

Examples

This example shows how to display the Flexible NetFlow accounting configuration on interface Ethernet 0/0 and 0/1:
switch# show flow interface ethernet 1/0 Interface Ethernet1/0 FNF: monitor: NFC-DC-PHOENIX direction: Output traffic(ip): on switch# show flow interface ethernet 0/0 Interface Ethernet0/0 FNF: monitor: FLOW-MONITOR-1 direction: Input traffic(ip): sampler SAMPLER-2#

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

479

Show Commands show flow interface

Table 1 describes the significant fields shown in the display.

Table 1 show flow interface Field Descriptions

Field Interface monitor direction:

Description The interface that information is applicable to. The name of the flow monitor that is configured on the interface. The direction of traffic the flow monitor is monitoring. The possible values are as follows:

InputTraffic being received by the interface OutputTraffic being transmitted by the interface

traffic (ip)

Indicates if the flow monitor is in normal mode or sampler mode. The possible values are as follows:

OnThe flow monitor is in normal mode. Sampler The flow monitor is in sampler mode (the name of the sampler is included in the display).

Related Commands

Command show flow sw-monitor

Description Displays flow monitor status and statistics.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

480

OL-25806-03

Show Commands show flow sw-monitor

show flow sw-monitor

To display the status and statistics for a Flexible NetFlow flow monitor, use the show flow monitor command. show flow sw-monitor [name exporter-name] [cache [detailed]]

Syntax Description

name exporter-name cache

(Optional) Specifies the name of a flow exporter. The name can be any case-sensitive, alphanumeric string up to 64 characters. Displays the flow of packets generated by the supervisor. Use this command with the show hardware flow {ip | ipv6} command to get all the flows on the system. (Optional) Displays detailed information about the flow of packets.

detailed

Defaults

Information for all flow exporters configured on the router is displayed.

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

You must have already enabled traffic monitoring with Flexible NetFlow using an exporter before you can use the show flow exporter command. This command does not require a license.

Examples

This example shows how to display the status and statistics for a flow monitor:
switch# show flow sw-monitor NFC-DC-PHOENIX statistics Cache type: Normal Cache size: 4096 Current entries: 4 High Watermark: 6 Flows added: Flows aged: - Active timeout ( - Inactive timeout ( - Event aged 116 112 0 112 0

1800 secs) 15 secs)

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

481

Show Commands show flow sw-monitor

- Watermark aged - Emergency aged

0 0

Table 2 describes the significant fields shown in the display.

Table 2 show flow sw-monitor monitor-name Field Descriptions

Field Cache Type

Description The flow monitor cache type. The possible values are as follows:

NormalFlows are expired normally PermanentFlows are never expired ImmediateFlows are expired immediately

Cache Size Current entries High Watermark Flows added Flows aged Active Timeout Inactive Timeout Event aged

The number of entries in the cache. The number of entries in the cache that are in use. The highest number of cache entries seen. Flows added to the cache since the cache was created. Flows expired from the cache since the cache was created. The current value for the active timeout. The current value for the inactive timeout. The number of flows that have been aged by an event such as using the force-export option for the clear flow monitor command or the counter value wrapped because the maximum number for the counter was reached. The number of flows that have been aged because they exceeded the maximum high watermark value. The number of flows that were aged from the cache to allow new flows to be added.

Watermark aged Emergency aged

This example shows how to display the status for a flow monitor:
switch# show flow sw-monitor NFC-DC-PHOENIX Flow Monitor NFC-DC-PHOENIX: Description: Used for basic traffic analysis Flow Record: netflow-original Flow Exporter: EXP-DC-TOPEKA EXP-DC-PHOENIX Cache: Type: normal Status: allocated Size: 4096 entries / 311316 bytes Inactive Timeout: 15 secs Active Timeout: 1800 secs Update Timeout: 1800 secs

Cisco Nexus 7000 Series NX-OS System Management Command Reference

482

OL-25806-03

Show Commands show flow sw-monitor

Table 3 describes the significant fields shown in the display.

Table 3 show flow sw-monitor monitor-name Field Descriptions

Field Flow Monitor Description Flow Record Flow Exporter Cache Type

Description The name of the flow monitor that you configured. The description that you configured for the monitor, or the default descriptionUser defined. The flow record assigned to the flow monitor. The exporter(s) that are assigned to the flow monitor. Information on the cache for the flow monitor. The flow monitor cache type. The possible values are as follows:

NormalFlows are expired normally PermanentFlows are never expired ImmediateFlows are expired immediately

Status

The status of the flow monitor cache. The possible values are as follows:

AllocatedThe cache is allocated. Being deletedThe cache is being deleted. Not allocatedThe cache is not allocated.

Size Inactive Timeout Active Timeout Update Timeout

The current cache size. The current value for the inactive timeout. The current value for the active timeout. The current value for the update timeout.

This example shows how to display the status and statistics for the flow monitor named NFC-DC-PHOENIX:
switch# show flow sw-monitor NFC-DC-PHOENIX cache Cache type: Normal Cache size: 4096 Current entries: 8 High Watermark: 10 Flows added: Flows aged: - Active timeout ( - Inactive timeout ( - Event aged - Watermark aged - Emergency aged 1560 1552 24 1528 0 0 0

1800 secs) 15 secs)

IP TOS: IP PROTOCOL: IPV4 SOURCE ADDRESS: IPV4 DESTINATION ADDRESS: TRNS SOURCE PORT:

0x00 6 10.10.10.2 172.16.10.2 20

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

483

Show Commands show flow sw-monitor

TRNS DESTINATION PORT: INTERFACE INPUT: FLOW SAMPLER ID: ip source as: ip destination as: ipv4 next hop address: ipv4 source mask: ipv4 destination mask: tcp flags: interface output: counter bytes: counter packets: timestamp first: timestamp last:

20 Et0/0 0 0 0 172.16.7.2 /0 /24 0x00 Et1/0 198520 4963 10564356 12154104

Table 4 describes the significant fields shown in the display.

Table 4 show flow sw-monitor monitor-name Field Descriptions

Field Cache type

Description The flow monitor cache type. The possible values are as follows:

NormalFlows are expired normally PermanentFlows are never expired ImmediateFlows are expired immediately

Cache Size Current entries High Watermark Flows added Flows aged Active timeout Inactive timeout Event aged

The number of entries in the cache. The number of entries in the cache that are in use. The highest number of cache entries seen. Flows added to the cache since the cache was created. Flows expired from the cache since the cache was created. The current value for the inactive timeout. The current value for the active timeout. The number of flows that have been aged by an event such as using the force-export option for the clear flow monitor command. The number of flows that have been aged because they exceeded the maximum high watermark value. The number of flows that were aged from the cache to allow new flows to be added. The IP type of service (ToS) value. The protocol number. The IPv4 source address. The IPv4 destination address. The source port for the transport protocol. The destination port for the transport protocol. The interface that the input is received on. The flow sampler ID number.

Watermark aged Emergency aged IP TOS IP PROTOCOL IPV4 SOURCE ADDRESS IPV4 DESTINATION ADDRESS TRNS SOURCE PORT TRNS DESTINATION PORT INTERFACE INPUT FLOW SAMPLER ID

Cisco Nexus 7000 Series NX-OS System Management Command Reference

484

OL-25806-03

Show Commands show flow sw-monitor

Table 4

show flow sw-monitor monitor-name Field Descriptions (continued)

Field ip source as ip destination as ipv4 next hop address ipv4 source mask ipv4 destination mask tcp flags interface output counter bytes counter packets timestamp first timestamp last

Description The BGP source AS number. The BGP destination AS number. The IPv4 address of the next hop that the packet is forwarded to. The IPv4 source address mask. The IPv4 destination address mask. The value of the TCP flags. The interface that the input is transmitted on. The number of bytes that have been counted. The number of packets that have been counted. The timestamp of the first packet in the flow. The timestamp of the last packet in the flow.

This example shows how to display the status and statistics for the flow monitor named NFC-DC-PHOENIX in a table format:
switch# show flow sw-monitor NFC-DC-PHOENIX cache format table Cache type: Normal Cache size: 4096 Current entries: 4 High Watermark: 6 Flows added: Flows aged: - Active timeout ( - Inactive timeout ( - Event aged - Watermark aged - Emergency aged IP TOS IP PROT ====== ======= 0x00 1 0x00 1 0xC0 17 0x00 6 switch# 90 86 0 86 0 0 0 TRNS SRC PORT ============= 0 0 TRNS DST PORT ============== 02 20484 520 5202 25 252

1800 secs) 15 secs)

IPV4 SRC ADDR =============== 10.251.10.1 10.251.10.1 172.16.6.1 10.10.11.1

IPV4 DST ADDR =============== 172.16.10.2 172.16.10.2 224.0(1).0.9 172.16.10.5

Related Commands

Command cache clear flow monitor exporter flow monitor protocol-distribution record

Description Configures flow cache parameters for flow monitors. Clears the flow monitor. Specifies a flow exporter for flow monitors. Creates a flow monitor. Configures the collection of protocol distribution statistics for flow monitors. Configures a flow record for the flow monitor.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

485

Show Commands show flow sw-monitor

Command show flow sw-monitor size-distribution

Description Displays flow monitor status and statistics. Configures the collection of size distribution statistics for flow monitors.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

486

OL-25806-03

Show Commands show flow record

show flow record

To display the status and statistics of a Flexible NetFlow flow record, use the show flow record command. show flow record [name record-name | netflow ipv4 record | netflow-original]

Syntax Description

name record-name netflow ipv4 record netflow-original

(Optional) Specifies the name of a flow record that you previously configured. (Optional) Configures the flow monitor to use one of the predefined records. See Table 5 for a listing of the available records and their definitions. (Optional) Specifies the Flexible NetFlow implementation of original NetFlow with origin autonomous systems.

Defaults

Information for all flow exporters configured on the router is displayed.

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

You must have already enabled traffic monitoring with Flexible NetFlow using an exporter before you can use the show flow exporter command. Table 5 describes the keywords and descriptions for the record argument.
Table 5 Keywords and Descriptions for the record Argument

original-input original-output protocol-port

Traditional IPv4 input NetFlow. Traditional IPv4 output NetFlow. Protocol ports record.

This command does not require a license.

Examples

This example shows how to display the status and statistics of the original input NetFlow record:

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

487

Show Commands show flow record

switch# show flow record netflow ipv4 original-input Flow record ipv4 original-input: Description: Traditional IPv4 input NetFlow No. of users: 0 Template ID: 0 Fields: match ipv4 source address match ipv4 destination address match ip protocol match ip tos match transport source-port match transport destination-port match interface input collect routing source as collect routing destination as collect routing next-hop address ipv4 collect transport tcp flags collect counter bytes collect counter packets collect timestamp sys-uptime first collect timestamp sys-uptime last collect interface output switch#

Table 6 describes the significant fields shown in the display.

Table 6 show flow record netflow-original Field Descriptions

Field Description No. of users Total field space Fields

Description The description that you configured for the record or the default descriptionUser defined. The number of references to this record in the configuration. The number of bytes required to store these fields for one flow. The fields that are included in this record. For more information on the fields, refer to the match and collect commands.

Related Commands

Command cache clear flow monitor exporter flow monitor protocol-distribution record show flow sw-monitor size-distribution protocol-distribution record

Description Configures flow cache parameters for flow monitors. Clears the flow monitor. Specifies a flow exporter for flow monitors. Creates a flow monitor. Configures the collection of protocol distribution statistics for flow monitors. Configures a flow record for the flow monitor. Displays flow monitor status and statistics. Configures the collection of size distribution statistics for flow monitors. Configures the collection of protocol distribution statistics for flow monitors. Configures a flow record a for flow monitor.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

488

OL-25806-03

Show Commands show flow timeout

show flow timeout

To display the Flexible NetFlow flow cache timeout values, use the show flow timeout command. show flow timeout

Syntax Description

This command has no arguments or keywords.

Defaults

Information for the Flexible NetFlow accounting configuration on the interface is displayed.

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 6.1(1) 4.0(1)

Modification Changed the command output. This command was introduced.

Usage Guidelines

You must have already enabled traffic monitoring with Flexible NetFlow before you can use the show flow timeout command. This command does not require a license.

Examples

This example shows how to display the Flexible NetFlow flow cache timeout values for F2 VDC:
switch# show flow timeout Flow timeout values Active timeout: Inactive timeout: 15 Flush Cache timeout 15 Fast timeout: Session aging timeout: Aggressive aging timeout: switch#

1800 seconds seconds seconds Disabled Disabled Disabled

Related Commands

Command flow timeout

Description Creates a flow timeout.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

489

Show Commands show hardware feature-capability

show hardware feature-capability

To display information about the registered features that are supported by the system, use the show hardware feature-capability command. show hardware feature-capability [detailed]

Syntax Description

detailed

(Optional) Displays detailed information about registered features.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator Release 4.2(1) Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display information about the registered features that are supported by the system:
switch# show hardware feature-capability detailed Hardware Dependent Features: . = supported X = unsupported -- Module -7 12 VPC X X module 7: Device Min num too small for feature module 12: Device Min num too small for feature PVLAN . . switch#

Related Commands

Command show hardware capacity

Description Displays information about the hardware capabilities and current hardware utilization by the system.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

490

OL-25806-03

Show Commands show hardware capacity

show hardware capacity

To display information about the hardware capabilities and current hardware utilization by the system, use the show hardware capacity command. show hardware capacity [eobc | fabric-utilization | forwarding | interface | module | power]

Syntax Description

eobc

(Optional) Displays the Ethernet Out of Band Channel (EOBC) resources, such as packets per second, total packets, and dropped packets, for both ingress (rx) and egress (tx) direction. (Optional) Displays switch fabric resources, such as the channel speed, the percentage of egress data, the percentage of ingress data, packet drops, peak rates, and time stamps. (Optional) Displays Layer 2 and Layer 3 forwarding resources, such as available resources, the percentage of used resources, and the percentage of free resources. (Optional) Displays the chassis, slot, or port number, and the ingress (rx) and egress (tx) packet drop counter against it. (Optional) Displays information about the modules, crossbar resources, and the percentage of total, free, and used Flash and NVRAM resources in each module. (Optional) Displays a summary of the power resources of the system.

fabric-utilization

forwarding interface module power

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.2.(1)

Modification This command was introduced.

Usage Guidelines

You can make network design plans based on the information about hardware capabilities and the current hardware utilization. This command does not require a license.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

491

Show Commands show hardware capacity

Examples

This example shows how to display information about the hardware capabilities and current hardware utilization by the system:
switch(config)# show hardware capacity module Supervisor Redundancy HW Mode(Dual-SUPs): Disabled Redundancy mode: Active with no standby Switching Resources: ------------------Module Model Number Part Number Serial Number --------------------------------------------------------7 N7K-M148GS-11 73-11584-02 JAF1219AGFE 10 N7K-SUP1 73-10877-11 JAF1307ALAT 12 NURBURGRING 73-10098-04 JAB104400P0 XBAR Resources: ------------------XbarNum Model Number Part Number Serial Number --------------------------------------------------------1 N7K-C7018-FAB-1 73-11687-01 JAF1225AGHJ

Flash/NVRAM Resources: -----------------------------------------------------------Usage: Module Device Total(KB) Free(KB) %Used -----------------------------------------------------------10 bootflash 1762048 1383980 21 10 logflash 7997912 6840772 14 10 slot0 2026608 1985436 2 switch(config)#

Related Commands

Command show hardware fabric-utilization show module

Description Displays information about fabric utilizations. Displays information about a module.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

492

OL-25806-03

Show Commands show hardware capacity interface

show hardware capacity interface

To display information about the hardware interface resources, use the show hardware capacity interface command. show hardware capacity interface

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.1(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display information about the hardware interface resources:
switch(config)# show hardware capacity interface Interface Resources Interface Module 7 7 12 12 drops: Total drops Tx: 0 Rx: 0 Tx: 0 Rx: 0

Highest drop ports -

Interface buffer sizes: Module Bytes: Tx buffer 7 6190631 12 6190631 switch#

Rx buffer 7743330 7743330

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

493

Show Commands show hardware capacity interface

Related Commands

Command show hardware flow utilization show hardware fabric-utilization

Description Displays information about NetFlow hardware flow utilization. Displays information about fabric utilization.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

494

OL-25806-03

Show Commands show hardware capacity interface

show hardware capacity interface

To display information about the hardware interface resources, use the show hardware capacity interface command. show hardware capacity interface

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.1(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display information about the hardware interface resources:
switch(config)# show hardware capacity interface Interface Resources Interface Module 7 7 12 12 drops: Total drops Tx: 0 Rx: 0 Tx: 0 Rx: 0

Highest drop ports -

Interface buffer sizes: Module Bytes: Tx buffer 7 6190631 12 6190631 switch#

Rx buffer 7743330 7743330

Related Commands

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

495

Show Commands show hardware capacity interface

Command show hardware flow utilization show hardware fabric-utilization

Description Displays information about NetFlow hardware flow utilization. Displays information about fabric utilization.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

496

OL-25806-03

Show Commands show hardware fabric-utilization

show hardware fabric-utilization

To display the fabric utilization values reported from a 10 millisecond measurement interval that is, the ASIC measures link utilization, use the show hardware fabric-utilization command. show hardware fabric-utilization

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the fabric utilization:

switch(config)# show hardware fabric-utilization -----------------------------------------------Slot Total Fabric Utilization Bandwidth Ingress % Egress % -----------------------------------------------1 220 Gbps 0.00 0.00 2 92 Gbps 0.00 0.00 5 23 Gbps 0.00 0.00 6 23 Gbps 0.00 0.00 7 92 Gbps 0.00 0.00 9 46 Gbps 0.00 0.00 --More--

Related Commands

Command show hardware fabric-utilization

Description Displays information about fabric utilization.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

497

Show Commands show hardware fabric-utilization detail timestamp

show hardware fabric-utilization detail timestamp

To display the time and value of peak utilization timestamp, use the show hardware fabric-utilization detail timestamp command. show hardware fabric-utilization detail timestamp

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 6.1(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the time and value of peak utilization:
switch(config)# show hardware fabric-utilization detail timestamp swN7K148# show hardware fabric-utilization detail timestamp -----------------------------------------------------------------------Fabric Planes: A -- Unicast fabric interface B -- Multicast/Multidestination fabric interface -------------------------PEAK FABRIC UTILIZATION-----------------------I/O |-----FABRIC----| Ingress | Egress Slot |Mod Inst Plane| Util Time | Util Time -----------------------------------------------------------------------2 1 1 A 0% 08-11@19:18:41 0% 08-11@19:18:41 2 1 1 B 0% 08-11@19:18:41 0% 08-11@19:18:41 2 1 1 A 0% 08-11@19:18:41 0% 08-11@19:18:41 2 1 1 B 0% 08-11@19:18:41 0% 08-11@19:18:41 2 2 1 A 0% 08-11@19:18:41 0% 08-11@19:18:41 2 2 1 B 0% 08-11@19:18:41 0% 08-11@19:18:41 2 2 1 A 0% 08-11@19:18:41 0% 08-11@19:18:41 2 2 1 B 0% 08-11@19:18:41 0% 08-11@19:18:41 2 3 1 A 0% 08-11@19:18:41 0% 08-11@19:18:41 2 3 1 B 0% 08-11@19:18:41 0% 08-11@19:18:41 2 3 1 A 0% 08-11@19:18:41 0% 08-11@19:18:41

Cisco Nexus 7000 Series NX-OS System Management Command Reference

498

OL-25806-03

Show Commands show hardware fabric-utilization detail timestamp

1 1 1 1

B A B A

0% 0% 0% 0%

08-11@19:18:41 08-11@19:18:34 08-11@19:18:34 08-11@19:18:34

0% 0% 0% 0%

08-11@19:18:41 08-11@19:18:34 08-11@19:18:34 08-11@19:18:34

5 1 5 1 5 2 --More--

Related Commands

Command show hardware fabric-utilization

Description Displays information about fabric utilization.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

499

Show Commands show hardware flow aging

show hardware flow aging

To display information about NetFlow hardware flow aging, use the show hardware flow aging command. show hardware flow aging [vdc vdc-name] [module slot-number]

Syntax Description

vdc vdc-name module slot-number

(Optional) Specifies the virtual context device (VDC) name. The VDC name can be any case-sensitive, alphanumeric string up to 64 characters. (Optional) Displays information specific to a module.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

You must have already enabled traffic monitoring with Flexible NetFlow before you can use the show hardware flow aging command. This command does not require a license.

Examples

This example shows how to display the NetFlow aging values for module 2:
switch(config)# show hardware flow aging module 2 VDC(1) Aging Information (time unit is second): AgingType Enabled Timeout Period Threshold ----------+----------+----------+----------+---------Active Yes 1800 360 N/A Inactive Yes 15 3 N/A Fast Yes 33 6 22 Aggressive No 90 18 90 Session No 2 5 N/A switch(config)#

Cisco Nexus 7000 Series NX-OS System Management Command Reference

500

OL-25806-03

Show Commands show hardware flow aging

Related Commands

Command flow timeout

Description Creates a flow timeout.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

501

Show Commands show hardware flow entry

show hardware flow entry

To display information about a NetFlow table entry, use the show hardware flow entry command. show hardware flow entry address location type {ip | ipv6} [detail] [module slot-number]

Syntax Description

address location ip ipv6 detail module slot-number

Specifies the NetFlow table address. Address location of the NetFlow table entry, in hexadecimal. The location range is from 0x0 to 0x3fffff. Displays detailed information about the IP flows. Displays detailed information about the IPv6 flows. (Optional) Displays detailed information about the flows. (Optional) Displays information specific to a module.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

You must have already enabled traffic monitoring with Flexible NetFlow before you can use the show hardware flow entry command. This command does not require a license.

Examples

This example show how to display the NetFlow table entry for module 2:
switch(config)# show hardware flow entry address 0x0 type ip module 2 NT Entry Info (dev_id = 0, nt_entry_addr = 0x00000000): protocol profile_id recir_id is_routed from_rp lkup_dir ilif(ovld_a) = = = = = = = 0 (0=IPv4/IPMAC, 1=IPv6, 2=L2, 3=MPLS) 0 0 0 0 0 (0=Ingress, 1=Egress) 0x0

Cisco Nexus 7000 Series NX-OS System Management Command Reference

502

OL-25806-03

Show Commands show hardware flow entry

elif(ovld_b) tos(ovld_e) l4_protocol l4_hdr_vld fragment mpls l4_info(ovld_d) ipv4_sa(ovld_f) ipv4_da(ovld_g) ipmac segment hash_addr icam create_ts sh_plc_idx/sampler_id rdt_tbl_idx ignr_aclo ignr_qoso ignr_acc ignr_agg_qos tcp_rdt_dst copy_policy_idx nf_acos mark_en nf_qos_mode policer_param_idx elam_trig valid sw_entry profile_merged fast_ag_en sw_bits1 dgt_mode adj_ptr/dgt ignr_qosi ignr_acli

= = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = =

0x0 0 0 0 0 0 0x00000000 0.0.0.0 0.0.0.0 0 0 0x0 0 0 0x0 0x0 0 0 0 0 0 0x0 0 0 0 0x0 0 0 0 0 0 0 0 0x0 0 0

NS Entry Info (dev_id = 0, ns_entry_addr = 0x00000000): ack_after_fin tcp_flag mf_ls_ts mf_bkt nf_pkt_cnt nf_byte_cnt nf_byte_cnt_excd ls_used_ts sw_prog/sticky_status = = = = = = = = = 0 0x0 (URG=0, ACK=0, PSH=0, RST=0, SYN=0, FIN=0) 0 0 0000000000 0000000000000 0000000000000 0 0

Related Commands

Command flow

Description Creates a flow.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

503

Show Commands show hardware flow

show hardware flow

To display information about NetFlow hardware IP flows, use the show hardware flow ip command. show hardware flow {ip | ipv6} [interface type number | monitor monitor-name | profile profile-id | vdc vdc-name | vlan vlan-name] [detail] [module module]

Syntax Description

ip ipv6

Displays information about the IP flows. Displays information about the IPv6 flows.

interface interface-type (Optional) Specifies the type of interface that you want to view Flexible number NetFlow accounting configuration information on. monitor monitor-name profile profile-id vdc vdc-name detail module slot-number (Optional) Specifies the name of the flow monitor. The monitor name can be any case-sensitive, alphanumeric string up to 64 characters. (Optional) Specifies the name of the flow profile. The profile ID range is from 0 to 31. (Optional) Specifies the virtual device context (VDC) name. The VDC name can be any case-sensitive, alphanumeric string up to 64 characters. (Optional) Displays detailed information about the flows. (Optional) Displays information specific to a module.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

You must have already enabled traffic monitoring with Flexible NetFlow before you can use the show hardware flow ip command. This command does not require a license.

Examples

This example shows how to display the NetFlow aging values for module 8:
switch(config)# show hardware flow ip module 8

Cisco Nexus 7000 Series NX-OS System Management Command Reference

504

OL-25806-03

Show Commands show hardware flow

D - Direction; L4 Info - Protocol:Source Port:Destination Port IF - Interface: ()ethernet, (S)vi, (V)lan, (P)ortchannel, (T)unnel TCP Flags: Ack, Flush, Push, Reset, Syn, Urgent D IF SrcAddr DstAddr L4 Info PktCnt TCP Flags -+-----+---------------+---------------+---------------+----------+----------I 8/26 007.002.000.002 007.001.000.002 000:00000:00000 0000421885 . . . . . . I 8/25 007.001.000.002 007.002.000.002 000:00000:00000 0000421900 . . . . . . O 8/25 007.002.000.002 007.001.000.002 000:00000:00000 0000422213 . . . . . . O 8/26 007.001.000.002 007.002.000.002 000:00000:00000 0000422228 . . . . . . switch(config)#

Related Commands

Command flow

Description Creates a flow.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

505

Show Commands show hardware flow l2

show hardware flow l2

To display information about NetFlow hardware Layer 2 flows, use the show hardware flow l2 command. show hardware flow l2 [monitor monitor-name | profile profile-id | vdc vdc-id | vlan vlan-id] [detail] [instance instance] [module module]

Syntax Description

monitor monitor-name profile profile-id vdc vdc-id vlan vlan-id detail instance instance slot number

(Optional) Specifies the name of the flow monitor. The monitor name can be any case-sensitive, alphanumeric string up to 64 characters. Optional) Specifies the name of the flow profile. The profile ID range is from 0 to 7. (Optional) Specifies the virtual device context (VDC) name. (Optional) Virtual device context ID. The range is from 1 to 16 alphanumerical string. (Optional) Displays a VLAN. (Optional) Displays VLAN ID. The range is from 1 to 4094. (Optional) Displays detailed information about the flows. (Optional) Displays information about the EARL instance. (Optional) Displays the instance number. The range is from 1 to 2. (Optional) Specifies the slot number. The range is from 1 to 18.

Defaults

None

Command Modes

EXEC mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 5.1(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display detailed output information about the NetFlow Layer 2 flows:
switch(config)# show hardware flow l2 detail D IF SMAC DMAC ET PktCnt TCP Flags DSCP

Cisco Nexus 7000 Series NX-OS System Management Command Reference

506

OL-25806-03

Show Commands show hardware flow l2

-+---------+--------------+--------------+----+----------+-----------+----I V 100 0002.0002.0002 0018.bad7.e995 0800 0000279860 A F P R S U switch#

Related Commands

Command flow

Description Creates a flow.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

507

Show Commands show hardware flow sampler

show hardware flow sampler

To display information about sampled NetFlow hardware flows, use the show hardware flow sampler command. show hardware flow sampler {all | count | index number | name sampler-name | vdc vdc_id} [detail] [module module] [instance instance]

Syntax Description

all count index number name sampler-name vdc vdc-name detail module slot-number instance instance

Specifies all sampled NetFlow hardware flows. Specifies the sampler table utilization. Specifies the sampler table index, in hexidecimal. The range is from 0x0 to 0x3ff. Specifies the sampler name. The name can be any case-sensitive, alphanumeric string up to 64 characters. Specifies the virtual device context (VDC) name. The VDC name can be any case-sensitive, alphanumeric string up to 64 characters. (Optional) Displays detailed information about the flows. (Optional) Displays information that is specific to a module. (Optional) Displays the instance number.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

You must have already enabled traffic monitoring with Flexible NetFlow before you can use the show hardware flow sampler command. This command does not require a license.

Examples

This example shows how to display the NetFlow sampler table utilization for module 2:
switch# show hardware flow sampler count module 2 Sampler Table Utilization: about 0.00% (0/64)

Cisco Nexus 7000 Series NX-OS System Management Command Reference

508

OL-25806-03

Show Commands show hardware flow sampler

Related Commands

Command flow

Description Creates a flow.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

509

Show Commands show hardware flow utilization

show hardware flow utilization

To display information about NetFlow hardware flow utilization, use the show hardware flow utilization command. show hardware flow utilization [module module]

Syntax Description

module slot-number

(Optional) Displays information specific to a module.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

You must have already enabled traffic monitoring with Flexible NetFlow before you can use the show hardware flow utilization command. This command does not require a license.

Examples

This example shows how to display the NetFlow sampler table utilization for module 2:
switch# show hardware flow utilization module 2 Flow Utilization: 0.00% (0/515090) Total number of flows IPv4 flow creation failure IPv6 flow creation failure MPLS flow creation failure L2 flow creation failure IFE flow creation failure OFE flow creation failure IFE CF FIFO full failure OFE CF FIFO full failure IFE NT table full failure OFE NT table full failure NO freelist pointer failure Hash Table(NH) page full failure IPMAC lookup failure L2 ACL deny = = = = = = = = = = = = = = = 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0

Cisco Nexus 7000 Series NX-OS System Management Command Reference

510

OL-25806-03

Show Commands show hardware flow utilization

L3 ACL deny IFE CF flow control OFE CF flow control Fast Aging failure switch#

= = = =

0 0 0 0

Related Commands

Command flow

Description Creates a flow.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

511

Show Commands show interface ethernet capabilities

show interface ethernet capabilities

To show if an interface is Energy Efficient Ethernet (EEE) capable, use the show interface ethernet capabilities command. show interface ethernet slot/chassis capabilities

Syntax Description

slot/chassis capabilities

Slot or chassis number. The range is from 1 to 253. (Optional) Displays clock module information.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 6.1(2)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

512

OL-25806-03

Show Commands show interface ethernet capabilities

Examples

This example shows how to display if an interface is EEE capable:

switch(config-if)# show interface ethernet 16/1 capabilities Ethernet16/1 Model: N7K-F248XT-25 Type (Non SFP): 10g Speed: 1000,10000 Duplex: full Trunk encap. type: 802.1Q FabricPath capable: yes Channel: yes Broadcast suppression: percentage(0-100) Flowcontrol: rx-(off/on/desired),tx-(off/on/desired) Rate mode: dedicated Port mode: Routed,Switched QOS scheduling: rx-(8q4t),tx-(3p5q1t) CoS rewrite: yes ToS rewrite: yes SPAN: yes UDLD: yes MDIX: yes TDR capable: yes Link Debounce: yes Link Debounce Time: yes FEX Fabric: yes dot1Q-tunnel mode: yes Pvlan Trunk capable: yes Port Group Members: 1-4 EEE (efficient-eth): yes PFC capable: yes switch(config-if)#

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

513

Show Commands show interface ethernet

show interface ethernet

To display the Energy Efficient Ethernet (EEE) status on an interface, Use the show interface command. show interface ethernet slot/chassis

Syntax Description

slot/chassis

Slot or chassis number. The range is from 1 to 253.

Defaults

None.

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 6.1(2)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the EEE status on an interface:

switch# show interface ethernet2/6 Ethernet2/6 is down (Link not connected) admin state is up, Dedicated Interface Hardware: 10000 Ethernet, address: 0022.5579.de41 (bia 001b.54c1.af5d) MTU 1500 bytes, BW 10000000 Kbit, DLY 10 usec reliability 255/255, txload 1/255, rxload 1/255 Encapsulation ARPA, medium is broadcast auto-duplex, auto-speed, media type is 10G Beacon is turned off Auto-Negotiation is turned off Input flow-control is off, output flow-control is off Auto-mdix is turned off Rate mode is shared Switchport monitor is off EtherType is 0x8100 EEE (efficient-ethernet) : n/a Last link flapped never Last clearing of "show interface" counters never 0 interface resets 30 seconds input rate 0 bits/sec, 0 packets/sec 30 seconds output rate 0 bits/sec, 0 packets/sec Load-Interval #2: 5 minute (300 seconds)

Cisco Nexus 7000 Series NX-OS System Management Command Reference

514

OL-25806-03

Show Commands show interface ethernet

input rate 0 bps, 0 pps; output rate 0 bps, 0 pps L3 in Switched: ucast: 0 pkts, 0 bytes - mcast: 0 pkts, 0 bytes --More--

Related Commands

Command show lldp tlv-select lldp tlv-select

Description Displays the LLDP TLV configuration. Specifies the TLVs to send and receive in LLDP packets.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

515

Show Commands show interface ethernet counter detailed

show interface ethernet counter detailed

To display the only nonzero counters, use the show interface ethernet counter detailed command. show interface ethernet slot/chassis counter detailed

Syntax Description

slot/chassis

Slot or chassis number.The range is from 1 to 253.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 6.1(2)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the only nonzero counters:

switch# show interface ethernet 10/25 counters detailed Ethernet10/25 Rx Packets: 3635 Rx Unicast Packets: 9788 Rx Multicast Packets: 3631 Rx Bytes: 1062103 Rx Packets from 128 to 255 bytes: 1211 Rx Packets from 256 to 511 bytes: 2420 Rx Packets from 1024 to 1518 bytes: 4 Tx Packets: 39883 Tx Unicast Packets: 9788 Tx Multicast Packets: 39879 Tx Bytes: 3731578 Tx Packets from 65 to 127 bytes: 36247 Tx Packets from 128 to 255 bytes: 1211 Tx Packets from 256 to 511 bytes: 2421 Tx Packets from 1024 to 1518 bytes: 4 Non Fcoe in packets: 13419 Non Fcoe in octets: 2392727 Non Fcoe out packets: 39883 Non Fcoe out octets: 3731578 Tx LPI usecs 74304694529

Cisco Nexus 7000 Series NX-OS System Management Command Reference

516

OL-25806-03

Show Commands show interface ethernet counter detailed

Rx LPI usecs Tx LPI requests Rx LPI indications switch(config)#

74329358769 39865 3628

Related Commands

Command show lldp tlv-select lldp tlv-select

Description Displays the LLDP TLV configuration. Specifies the TLVs to send and receive in LLDP packets.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

517

Show Commands show inventory

show inventory
To display inventory information for the device hardware, use the show inventory command. show inventory [chassis | clock | fans | module | power_supply]

Syntax Description

chassis clock fans module power_supply

(Optional) Displays chassis information. (Optional) Displays clock module information. (Optional) Displays fan information. (Optional) Displays module information. (Optional) Displays power supply information.

Defaults

Displays all hardware inventory information.

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

518

OL-25806-03

Show Commands show inventory

Examples

This example shows how to display configuration incompatibilities:

switch# show inventory NAME: "Chassis", DESCR: "Nexus7000 C7010 (10 Slot) Chassis " PID: N7K-C7010 , VID: , SN: TBM11256507 NAME: "Slot 2", DESCR: "10/100/1000 Mbps Ethernet Module" PID: N7K-M148GT-11 , VID: , SN: JAB104400P0 NAME: "Slot 6", PID: N7K-SUP1 DESCR: "Supervisor module-1X" , VID: TBD , SN: JAB10380101

NAME: "Slot 11", DESCR: "Fabric card module" PID: N7K-C7010-FAB-1 , VID: , SN: JAB104300HM NAME: "Slot 33", PID: FIORANO DESCR: "Nexus7000 C7010 (10 Slot) Chassis Power Supply" , VID: , SN: DTH1117T005

NAME: "Slot 34", DESCR: "Nexus7000 C7010 (10 Slot) Chassis Power Supply" PID: N7K-AC-6.0KW , VID: , SN: DTH1117T009 NAME: "Slot 36", PID: NAME: "Slot 37", PID: NAME: "Slot 38", PID: NAME: "Slot 39", PID: switch# DESCR: "Nexus7000 C7010 (10 Slot) Chassis Fan Module" , VID: V00, SN: DESCR: "Nexus7000 C7010 (10 Slot) Chassis Fan Module" , VID: V00, SN: DESCR: "Nexus7000 C7010 (10 Slot) Chassis Fan Module" , VID: V00, SN: DESCR: "Nexus7000 C7010 (10 Slot) Chassis Fan Module" , VID: V00, SN:

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

519

Show Commands show lldp dcbx interface ethernet

show lldp dcbx interface ethernet

To display the local Data Center Bridging Capability Exchange (DCBX) control status of an interface, use the show lldp dcbx interface ethernet command. show lldp dcbx interface ethernet slot/port-number

Syntax Description

slot/port-number Slot number and port number is in this format: slot/port-number. The range is from 1 to 253.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 5.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the local DCBX control status:
switch(config)# show lldp dcbx interface ethernet 1/5 Local DCBXP Control information: Operation version: 00 Max version: 00 Seq no: 1 Ack no: 1 Type/ Subtype Version En/Will/Adv Config 003/000 000 Y/N/Y 0008 002/000 000 Y/N/Y 1111100032 32000000 00000002 Peer's DCBXP Control information: Operation version: 00 Max version: 00 Seq no: 1 Ack no: 1 Type/ Max/Oper Subtype Version En/Will/Err Config 003/000 000/000 Y/N/N 0008 002/000 000/000 Y/N/N 1111100032 32000000 00000002 switch(config)#

Cisco Nexus 7000 Series NX-OS System Management Command Reference

520

OL-25806-03

Show Commands show lldp dcbx interface ethernet

Related Commands

Command show lldp tlv-select lldp tlv-select

Description Displays the LLDP TLV configuration. Specifies the TLVs to send and receive in LLDP packets.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

521

Show Commands show lldp interface ethernet

show lldp interface ethernet

To display the Link Layer Discovery Protocol (LLDP) configuration on the interface, use the show lldp interface ethernet command. show lldp interface ethernet slot/port-number

Syntax Description

slot/port-number Slot number and port number in this format: slot/port-number. The range is from 1 to 253.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 5.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the LLDP configuration on the interface:
switch(config)# show lldp interface ethernet 6/3 Interface Information: Enable (tx/rx/dcbx): Y/Y/Y Port Mac address: 00:24:f7:19:84:72 switch(config)#

Related Commands

Command show lldp traffic interface ethernet show running-config lldp lldp transmit lldp receive

Description Displays the number of LLDP packets sent and received on the interface. Displays the global LLDP configuration. Enables the transmission of LLDP packets on an interface. Enables the reception of LLDP packets on an interface.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

522

OL-25806-03

Show Commands show lldp neighbors

show lldp neighbors

To display the status of the Link Layer Discovery Protocol (LLDP) neighbor device, use the show lldp neighbors command. show lldp neighbors {detail | interface ethernet slot/port-number}

Syntax Description

detail interface ethernet

Displays LLDP neighbor detail information. Specifies the interface for which you are displaying LLDP infromation.

slot/port-number Slot number and port number in this format: slot/port-number. The range is from 1 to 253.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin vdc-admin network-operator vdc-operator

Command History

Release 5.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the LLDP neighbor device status:
switch(config)# show lldp neighbors detail Capability codes: (R) Router, (B) Bridge, (T) Telephone, (C) DOCSIS Cable Device (W) WLAN Access Point, (P) Repeater, (S) Station, (O) Other Local Intf Chassis ID Port ID Hold-time Capability Eth8/24 0018.bad8.5e45 Eth8/23 120 R Eth8/23 0018.bad8.5e45 Eth8/24 120 R switch(config)#

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

523

Show Commands show lldp neighbors

Related Commands

Command show lldp traffic

Description Displays the LLDP counters, including the number of LLDP packets sent and received by the device, the number of discarded packets, and the number of unrecognized TLVs. Displays the number of LLDP packets sent and received on the interface.

show lldp traffic interface ethernet

Cisco Nexus 7000 Series NX-OS System Management Command Reference

524

OL-25806-03

Show Commands show lldp timers

show lldp timers

To display the Link Layer Discovery Protocol (LLDP) hold time, delay time, and update frequency configuration, use the show lldp timers command. show lldp timers

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 5.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the LLDP hold time, delay time, and update frequency configuration:
switch(config)# show lldp timers LLDP Timers: Holdtime in seconds: 180 Reinit-time in seconds: 6 Transmit interval in seconds: 45 switch(config)#

Related Commands

Command show lldp holdtime lldp reinit lldp timer

Description Specifies the amount of time in seconds that a receiving device should hold the information sent by your device before discarding it. Specifies the delay time in seconds for LLDP to initialize on any interface. Specifies the transmission frequency of LLDP updates in seconds.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

525

Show Commands show lldp tlv-select

show lldp tlv-select

To display the type, length, and value (TLV) configuration for the Link Layer Discovery Protocol (LLDP), use the show lldp tlv-select command. show lldp tlv-select

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 5.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the TLV configuration for LLDP:
switch(config)# show lldp tlv-select access-management dcbx port-description port-vlan system-capabilities system-description system-name switch(config)#

Related Commands

Command show lldp dcbx interface ethernet lldp tlv-select

Description Displays the local DCBX control status. Specifies the TLVs to send and receive in LLDP packets.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

526

OL-25806-03

Show Commands show lldp traffic

show lldp traffic

To display the Link Layer Discovery Protocol (LLDP) counters, including the number of LLDP packets sent and received by the device, the number of discarded packets, and the number of unrecognized TLVs, use the show lldp traffic command. show lldp traffic

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 5.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the LLDP counters:

switch(config)# show lldp traffic LLDP traffic statistics: Total frames transmitted: 323 Total entries aged: 0 Total frames received: 0 Total frames received in error: 0 Total frames discarded: 0 Total unrecognized TLVs: 0 switch(config)#

Related Commands

Command show lldp traffic interface ethernet show running-config lldp

Description Displays the number of LLDP packets sent and received on the interface. Displays the global LLDP configuration.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

527

Show Commands show lldp traffic interface ethernet

show lldp traffic interface ethernet

To display the number of Link Layer Discovery Protocol (LLDP) packets sent and received on the interface, use the show lldp traffic interface ethernet command. show lldp traffic interface ethernet slot/port-number

Syntax Description

slot/port-number Slot number and port number in this format: slot/port-number. The range is from 1 to 253.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 5.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the number of LLDP packets sent and received on the interface:
switch(config)# show lldp traffic interface ethernet 7/1 LLDP interface traffic statistics: Total frames transmitted: 0 Total entries aged: 0 Total frames received: 0 Total frames received in error: 0 Total frames discarded: 0 Total unrecognized TLVs: 0 switch(config)#

Cisco Nexus 7000 Series NX-OS System Management Command Reference

528

OL-25806-03

Show Commands show lldp traffic interface ethernet

Related Commands

Command show lldp traffic

Description Displays the LLDP counters, including the number of LLDP packets sent and received by the device, the number of discarded packets, and the number of unrecognized TLVs. Displays the global LLDP configuration.

show running-config lldp

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

529

Show Commands show locator-led status

show locator-led status

To show the status of locator LEDs on the system, use the show locator-led status command. show locator-led status

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.1(2)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows the locator LED status for the system:
switch# show locator-led status Xbar 1 : Locator LED off Module 7 : Locator LED off Module 9 : Locator LED off Module 12 is not powered up. Chassis Locator LED off PowerSupply 1 : Locator LED off PowerSupply 2 : Locator LED off Fan 1 : Locator LED off Fan 2 : Locator LED off switch(config)#

Related Commands

Command locator-led

Description Blinks an LED on the system.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

530

OL-25806-03

Show Commands show logging console

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.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the console logging configuration:

switch# show logging console Logging console: switch# enabled (Severity: critical)

Related Commands

Command logging console

Description Configures logging to the console.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

531

Show Commands show logging info

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.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

532

OL-25806-03

Show Commands show logging info

Examples

This example shows how to display the logging configuration:

switch# show logging info Logging console: enabled (Severity: critical) Logging monitor: enabled (Severity: notifications) Logging linecard: enabled (Severity: notifications) Logging timestamp: Seconds Logging loopback : disabled Logging server: enabled {172.28.254.254} server severity: notifications server facility: local7 server VRF: default Logging logflash: enabled (Severity: information) Logging logfile: enabled Name - messages: Severity - information Size - 10485760 Facility -------aaa acllog aclmgr auth authpriv bfd --More-Default Severity ---------------3 2 3 0 3 2 Current Session Severity -----------------------5 2 3 0 3 2

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

533

Show Commands show logging ip access-list cache

show logging ip access-list cache

To display information about the logging IP access list cache, use the show logging ip access-list cache command. show logging ip access-list cache

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display information about the logging IP access list cache:
switch# show logging ip access-list cache switch#

Related Commands

Command logging ip access-list

Description Configures logging for access lists.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

534

OL-25806-03

Show Commands show logging last

show logging last

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

Syntax Description

number

Number of lines. The range is from 1 to 9999.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the last 42 lines of the logfile:
switch# show logging last 42 switch#

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

535

Show Commands show logging level

show logging level

To display a logging configuration, use the show logging level command. show logging level [level]

Syntax Description

level

(Optional) Logging configuration to display. The keyword options are listed in the System Message Logging Facilities section on page 715.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1) 4.0(2) 4.1(2)

Modification This command was introduced. Added the interface-vlan, netstack, private-vlan, and ipv6 keywords. Added the cfs keyword.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the current Cisco Fabric Services (CFS) logging configuration:
switch# show logging level cfs Facility Default Severity ----------------------cfs 3 0(emergencies) 3(errors) 6(information) 1(alerts) 4(warnings) 7(debugging) Current Session Severity -----------------------3 2(critical) 5(notifications)

Related Commands

Command logging level

Description Configures the facility logging level.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

536

OL-25806-03

Show Commands show logging logfile

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

(Optional) Specifies to enter 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. (Optional) Specifies to enter 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.

end-time

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

If you do not enter an end time, the current time is used. This command does not require a license.

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 switch#

Related Commands

Command logging logfile

Description Configures logging to a log file.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

537

Show Commands show logging loopback

show logging loopback

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

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the logging loopback configuration:

switch# show logging loopback switch#

Cisco Nexus 7000 Series NX-OS System Management Command Reference

538

OL-25806-03

Show Commands show logging module

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.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the module logging configuration:

switch# show logging module switch#

Related Commands

Command logging module

Description Configures module logging.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

539

Show Commands show logging monitor

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.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the monitor logging configuration:

switch# show logging monitor switch#

Related Commands

Command logging monitor

Description Configures logging on the monitor.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

540

OL-25806-03

Show Commands show logging nvram

show logging nvram

To display the messages in the NVRAM log, use the show logging nvram command. show logging nvram [last number-lines]

Syntax Description

last number-lines

(Optional) Specifies a number of lines to display. The last number-lines is displayed. The range is from 1 to 100 lines.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the last 20 messages in the NVRAM log:
switch# show logging nvram last 20 switch#

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

541

Show Commands show logging onboard

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 | counter-stats | endtime | environmental-history | error-stats | exception-log | interrupt-stats | kernel-trace | module num | obfl-history | obfl-logs | stack-trace | starttime | status}

Syntax Description

boot-uptime device-version counter-stats endtime error-stats exception-log interrupt-stats kernel-trace module num obfl-history obfl-logs stack-trace starttime status

Displays the OBFL boot and uptime information. Displays the OBFL device version information. (Optional) Displays the OBFL counter statistics. Displays the OBFL logs until the specified end time. Displays the OBFL error statistics. Displays the OBFL exception log. Displays the OBFL interrupt statistics. Displays the OBFL kernel trace information. Displays the OBFL information for a specific module. Displays the OBFL history information. Displays the OBFL tech support log information. Displays the OBFL kernel stack trace information. Displays the OBFL logs from the specified start time. Displays the OBFL status enable/disable.

environmental-history Displays the OBFL environmental history.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1) 4.0(2)

Modification This command was introduced. Added the counter-stats keyword.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

542

OL-25806-03

Show Commands show logging onboard

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 bootflash: ftp: scp: sftp: slot0: tftp: volatile:

The valid values for file are as follows:

The valid values for type are as follows:

begin [-i] [-x] [word]Begins with the line that matches the text.
-iIgnores the case difference when comparing the strings. -xPrints only the lines where the match is a whole line. wordSpecifies for the expression.

count [> file | | type]Counts number of lines. egrep | grep print-matchEgrep 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 numPrints the specifies number of lines of context after every matching line. The range is

from 1 to 999.
-B numPrints the specifies number of lines of context before every matching line. The range

is from 1 to 999.
-cPrints a total count of matching lines only. -iIgnores the case difference when comparing the strings. -nPrints each match preceded by its line number. -vPrints only the lines that contain no matches for the word argument. -wPrints only lines where the match is a complete word -xPrints only the lines where the match is a whole line. wordSpecifies for the expression.

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

-iIgnores the case difference when comparing the strings. -xPrints only the lines where the match is a whole line. wordSpecifies 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. The range is from 0 to 2147483647.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

543

Show Commands show logging onboard

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

-iIgnores the case difference when comparing the strings. -xPrints only the lines where the match is a whole line. wordSpecifies for the expression.

last [num]Displays the last lines to print. The optional num specifies the number of lines to print. The range is from 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-moreTurns off pagination for command output. sed commandStream Editor wcCounts 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 |Pipe 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 modules installed in a Cisco router or switch. Data is logged to files that are 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. This command does not require a license.

Examples

This example shows how to display the OBFL boot and uptime information:
switch# show logging onboard module 2 boot-uptime Sat Feb 29 18:11:38 2008: Boot Record ---------------------------------------------------------------Boot Time..........: Sat Feb 29 18:11:38 2008 Slot Number........: 2 Serial Number......: JAB0912026U Bios Version.......: v0.0.8(08/18/07) Alt Bios Version...: v0.0.8(08/18/07) Firmware Version...: 3.0(1) [build 3.0(0.291)] switch#

Cisco Nexus 7000 Series NX-OS System Management Command Reference

544

OL-25806-03

Show Commands show logging onboard

Table 7 describes the significant fields shown in the display.

Table 7 show logging onboard boot-uptime Command Output

Field Boot Time Slot Number Serial Number Bios Version Alt Bios Version Firmware Version

Description Time boot occurred. Slot number Serial number of the module. Primary binary input and output system (BIOS) version. Alternate BIOS version. Firmware version.

This example shows how to display the OBFL logging device information:
switch# show logging onboard module 2 device-version Device Version Records: -----------------------------------------------------------------------Timestamp Device Name Instance Hardware Software Num Version Version -----------------------------------------------------------------------Sat Feb 29 18:11:38 2008 Stratosphere 0 1 1 Sat Feb 29 18:11:38 2008 Stratosphere 1 1 1 Sat Feb 29 18:11:38 2008 Skyline-asic 0 1 1 Sat Feb 29 18:11:38 2008 Tuscany-asic 0 1 0 Sat Feb 29 18:11:38 2008 X-Bus IO 0 6 0 Sat Feb 29 18:11:38 2008 Power Mngmnt Epl 0 6 0 Sat Feb 29 18:42:01 2008 Stratosphere 0 1 1 Sat Feb 29 18:42:01 2008 Stratosphere 1 1 1 Sat Feb 29 18:42:01 2008 Skyline-asic 0 1 1 Sat Feb 29 18:42:01 2008 Tuscany-asic 0 1 0 Sat Feb 29 18:42:01 2008 X-Bus IO 0 6 0 Sat Feb 29 18:42:01 2008 Power Mngmnt Epl 0 6 0 switch#

Table 8 describes the significant fields shown in the display.

Table 8 show logging onboard device-version Command Output

Field Timestamp Device Name Instance Num Hardware Version Software Version

Description Day, date, and time. Device name. Number of instances. Hardware device version. Software device version.

This example shows how to display the OBFL exception log information:
switch# show logging onboard module 2 exception-log Sun Feb 24 00:12:35 2008 : Exception Log Record Device Id : 60 Device Name : DEV_SKYLINE_NI Device Error Code : f(H)

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

545

Show Commands show logging onboard

Device Error Name : SKY_NI_ERR_BM_B1_3_BIST_FAILED Sys Error : Skyline ni module experienced an error Errtype : NON-CATASTROPHIC PhyPortLayer : Fibre Channel Port(s) Affected : 13-18 Error Description : Skyline BM B1_3 BIST for interface 2 timed out during init DSAP : 0 UUID : 0 Time : Sun Feb 24 00:11:25 2008 switch#

Table 9 describes the significant fields shown in the display.

Table 9 show logging onboard exception-log Command Output

Field Sun Feb 24 00:12:35 2008: Device Id: Device Name: Device Error Code Device Error Name: Sys Error: Errtype: PhyPortLayer: Port(s) Affected: Error Description: DSAP: UUID:

Description Date and time the exception was recorded. Device identification number. Device name. Device specific error code. Name of the device error. System error message. Error type. Physical layer type. Number of the ports affected. Description of the error. Destination session announcement protocol (DSAP) identification. Universal unique identifier (UUID).

This example shows how to display the OBFL history information:

switch# show logging onboard module 2 obfl-history OBFL history records: --------------------Sat Feb 29 30 18:09:57 2008 : OBFL all logs cleared Sat Feb 29 18:47:53 2008 : OBFL miscellaneous-error logs cleared Sat Feb 29 20:07:45 2008 : OBFL miscellaneous-error logs cleared switch#

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 module 2 stack-trace ==================== STACK TRACE ==================== Logging time: Sat Feb 29 19:47:38 2008 watchdog timeout: process swapper (0), jiffies 0x169bb Stack: c0006e98 c001721c d195f5b4 c0005424 c0005500 c0003e90 c0005a2c c0005a40 c0001a88 c01bf610 c0000394

Cisco Nexus 7000 Series NX-OS System Management Command Reference

546

OL-25806-03

Show Commands show logging onboard

Call Trace: print_stack2_buf + 0x50 kernel_thread + 0xb94 klm_cctrl + 0x4554 ppc_irq_dispatch_handler + 0x190 do_IRQ + 0x3c ret_from_intercept + 0x0 probe_irq_mask + 0x494 probe_irq_mask + 0x4a8 transfer_to_handler + 0x15c softnet_data + 0x2b0 Registers: NIP: C0005A20 XER: 00000000 LR: C0005A2C SP: C01AA120 REGS: c01aa070 TRAP: 0500 Tainted: PF MSR: 00009000 EE: 1 PR: 0 FP: 0 ME: 1 IR/DR: 00 DEAR: C0029B40, ESR: C01F0000 MCSRR0: 00000000, MCSRR1: 00000000, MCAR: 00000000 MCSR: 00000000 MCAR: 00000000 MCPSUMR: 00000000 TASK = c01a8190[0] 'swapper' Last syscall: 120 last math 00000000 last altivec 00000000 last spe 00000000 GPR00: 00000000 C01AA120 C01A8190 00000000 00000032 C8F1DE28 D1010A9F 00000000 GPR08: 0000180F C01FA39C D1010AA3 C01B8D18 24044244 1003A44C 0FFF6700 10049000 GPR16: 0FFAE1B0 0FFFAC90 00000000 00000000 00000000 00000000 00000000 00000001 GPR24: 00000000 00000000 00001160 007FFEAB 007FFE00 C01F0000 C01F0000 00000000

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.

This example shows how to display the OBFL error statistics:

switch# show logging onboard module 2 error-stats ---------------------------OBFL Data for Module: 2 ----------------------------

-----------------------------------------------------------------------------ERROR STATISTICS INFORMATION FOR DEVICE ID 80 DEVICE Eureka -----------------------------------------------------------------------------| | Time Stamp |In|Port Error Stat Counter Name | Count |MM/DD/YY HH:MM:SS|st|Rang | | |Id|e -----------------------------------------------------------------------------PB2_TX FlwCtrl from conn. ASIC > pe|0x1 |02/04/08 17:07:28|00| riod Intr | | | | PB2_TX FlwCtrl from conn. ASIC > pe|0x1 |02/06/08 10:54:44|00| riod Intr | | | | -----------------------------------------------------------------------------ERROR STATISTICS INFORMATION FOR DEVICE ID 81 DEVICE Lamira -----------------------------------------------------------------------------| | Time Stamp |In|Port Error Stat Counter Name | Count |MM/DD/YY HH:MM:SS|st|Rang | | |Id|e

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

547

Show Commands show logging onboard

-----------------------------------------------------------------------------NF2 Interrupt - NH HIT error |0x1 |02/06/08 10:54:44|00| switch#

Table 10 describes the significant fields shown in the display.

Table 10 show logging onboard error-stats Command Output

Field Error Stat Counter Name Count Time Stamp MM/DD/YY HH:MM:SS Inst Id Port The range is from

Description Name of the error statistics counter. Total interrupt count. Time and date of the error. Instance number. Range of ports affected.

Related Commands

clear logging onboard hw-module logging onboard

Clears the OBFL entries in the persistent log. Enables or disabled OBFL entries based on the error type.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

548

OL-25806-03

Show Commands show logging onboard

show logging onboard

To display the onboard failure log (OBFL), use the show logging onboard command. show logging onboard {boot-uptime | device-version | endtime | environmental-history | error-stats [port number] | exception-log | interrupt-stats | module module | obfl-history | obfl-logs | stack-trace | starttime time [options] | status}

Syntax Description

boot-uptime device-version endtime environmentalhistory error-stats port number exception-log interrupt-stats module module

Displays the OBFL boot and uptime information. Displays the OBFL device version information. Displays the OBFL logs until the end time, in the format mm/dd/yy-HH:MM:SS. Displays the OBFL environmental history. Displays the OBFL error statistics. Optionally, you can provide a port number to view the error statistics for the specified port. (Optional) Displays OBFL error statistics for a port. The range is from 1 to 64. Displays the OBFL exception log. Displays the OBFL interrupt statistics. Displays the OBFL information for the specified module. The range is from 1 to 18. To get more specific information from the selected module, you can optionally provide any of the other arguments for the show logging onboard command.

obfl-history obfl-logs stack-trace starttime status

Displays the OBFL history information. Displays the OBFL Technical Support log. Displays the OBFL stack trace. Displays the OBFL logs from the start time, in the format mm/dd/yy-HH:MM:SS. Displays the OBFL enable/disable status.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

549

Show Commands show logging onboard

Usage Guidelines

This command does not require a license.

Examples

This example shows how to displays the OBFL from March 10, 2008 at 3:45 p.m.:
switch# show logging onboard starttime 03/10/08-15:45:00 switch#

Cisco Nexus 7000 Series NX-OS System Management Command Reference

550

OL-25806-03

Show Commands show logging server

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.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the syslog server configuration:

switch# show logging server switch#

Related Commands

Command logging server

Description Configures a remote syslog server.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

551

Show Commands show logging session status

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.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the logging session status:

switch# show logging session status switch#

Cisco Nexus 7000 Series NX-OS System Management Command Reference

552

OL-25806-03

Show Commands show logging status

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.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the logging status:

switch# show logging status switch#

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

553

Show Commands show logging timestamp

show logging timestamp

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

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the logging time stamp configuration:
switch# show logging timestamp switch#

Related Commands

Command logging timestamp

Description Configures the logging time stamp granularity.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

554

OL-25806-03

Show Commands show module

show module
To display module information, use the show module command. show module [slot {bandwidth-fairness | recovery-steps} | uptime | xbar [xbar-slot]]

Syntax Description

slot bandwidth-fairness recovery-steps uptime xbar xbar-slot

(Optional) Number of the slot for an I/O module or a supervisor module. Displays the status of the bandwidth fairness for the module. Displays the steps to recover the module from a down state. (Optional) Displays the amount of time since the modules were reloaded. (Optional) Displays information about a fabric module. (Optional) Number of the slot for the fabric module.

Defaults

Displays module information for all I/O modules and supervisor modules in the chassis.

Command Modes

Any command mode

SupportedUserRoles

network-admin vdc-admin network-operator vdc-operator

Command History

Release 4.0(1) 4.1(2)

Modification This command was introduced. Output modified to show diagnostic events.

Usage Guidelines

This command does not require a license.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

555

Show Commands show module

Examples

This example shows how to display information for all modules in the chassis:
switch# show module Mod Ports Module-Type --- ----- -------------------------------7 48 1000 Mbps Optical Ethernet Modul 9 0 Supervisor module-1X 12 0 10/100/1000 Mbps Ethernet Module Mod --12 Mod --7 9 Power-Status -----------powered-dn Sw -------------4.1(3) 4.1(3) Model -----------------N7K-M148GS-11 N7K-SUP1 Status -----------ok active * powered-dn

Reason --------------------------Configured Power down Hw -----0.202 0.805

Mod --7 9 Mod --7 9

MAC-Address(es) -------------------------------------00-1b-54-c2-ed-d0 to 00-1b-54-c2-ee-04 00-1b-54-c0-ff-10 to 00-1b-54-c0-ff-18 Online Diag Status -----------------Pass Pass

Serial-Num ---------JAF1219AGFE JAB114000BV

Xbar Ports --- ----1 0

Module-Type Model Status -------------------------------- ------------------ -----------Fabric Module 1 N7K-C7018-FAB-1 ok Hw -----0.101

Xbar Sw --- -------------1 NA

Xbar MAC-Address(es) --- -------------------------------------1 NA * this terminal session switch#

Serial-Num ---------JAF1225AGHJ

Cisco Nexus 7000 Series NX-OS System Management Command Reference

556

OL-25806-03

Show Commands show module

This example shows how to display information for a specific module:

switch# show module 7 Mod Ports Module-Type Model Status --- ----- -------------------------------- ------------------ -----------7 48 1000 Mbps Optical Ethernet Modul N7K-M148GS-11 ok Mod --7 Sw -------------4.1(3) Hw -----0.202

Mod --7 Mod --7

MAC-Address(es) -------------------------------------00-1b-54-c2-ed-d0 to 00-1b-54-c2-ee-04 Online Diag Status -----------------Pass

Serial-Num ---------JAF1219AGFE

Chassis Ejector Support: Enabled Ejector Status: Left ejector CLOSE, Right ejector CLOSE, Module HW does not support ejector based shutdo wn. switch#

This example shows how to display information for the fabric modules:
switch# show module xbar Xbar Ports Module-Type Model Status --- ----- -------------------------------- ------------------ -----------1 0 Fabric Module 1 N7K-C7018-FAB-1 ok Xbar Sw --- -------------1 NA Hw -----0.101

Xbar MAC-Address(es) --- -------------------------------------1 NA * this terminal session switch#

Serial-Num ---------JAF1225AGHJ

Related Commands

Command show hardware show inventory show diagnostic events

Description Displays information about the hardware. Displays hardware inventory information. Displays diagnostic events by error and information event type.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

557

Show Commands show monitor

show monitor
To display information about the Ethernet Switched Port Analyzer (SPAN), use the show monitor command. show monitor

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display information about a SPAN:

switch(config)# show monitor Session State Reason ------- ----------- ---------------------1 down Session admin shut 6 down Session admin shut 8 down Session admin shut 9 down Session admin shut switch(config)# Description -------------------------------

Related Commands

Command show running-config monitor show startup-config monitor

Description Displays the running configuration to the startup configuration. Displays information about the startup SPAN configuration.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

558

OL-25806-03

Show Commands show monitor session

show monitor session

To display information about an Ethernet Switched Port Analyzer (SPAN) or a Encapsulated Remote Switched Port Analyzer (ERSPAN) session for analyzing traffic between ports, use the show monitor session command. show monitor session {all | session_number | range session_range} [brief]

Syntax Description

all session_number range session_range brief

Displays information about all SPAN or ERSPAN sessions. Specified SPAN or ERSPAN session number. Displays information about the specified range of SPAN or ERSPAN sessions. (Optional) Displays a brief summary of the information for the specified SPAN or ERSPAN session.

Defaults

Displays a brief summary of information for all configured SPAN or ERSPAN sessions.

Command Modes

Any command mode

SupportedUserRoles

network-admin vdc-admin network-operator vdc-operator

Command History

Release 6.1(1) 4.0(1)

Modification Changed the command output for ERSPAN-source sessions. This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display information for all configured ERSPAN sessions:
switch(config)# show monitor session 2 session 2 --------------type : erspan-source state : up erspan-id : 100 vrf-name : default acl-name : acl-name not specified ip-ttl : 255 ip-dscp : 0 destination-ip : 10.1.1.2

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

559

Show Commands show monitor session

origin-ip

: 3.3.3.3 (global)

source intf rx

: : Eth7/15
: Eth7/15 : Eth7/15 : : : : : filter not specified

tx both source VLANs rx tx both filter VLANs

Feature Enabled Value Modules Supported Modules Not-Supported ----------------------------------------------------------------------------Rate-limiter No MTU-Trunc No Sampling No MCBE No L3-TX 2 4 5 7 3 10 ERSPAN-ACL 4 7 2 3 5 10 Legend: MCBE = multicast best effort L3-TX = L3 Multicast Egress SPAN

switch(config-erspan-src)# show monitor session 2 session 2 --------------type : erspan-source version : 3 state : up erspan-id : 100 granularity : 100 microseconds vrf-name : default acl-name : acl-name not specified ip-ttl : 255 ip-dscp : 0 destination-ip : 10.1.1.2 origin-ip : 3.3.3.3 (global) source intf : rx : Eth7/15 tx : Eth7/15 both : Eth7/15 source VLANs : rx : tx : both : filter VLANs : filter not specified

Feature Enabled Value Modules Supported Modules Not-Supported ----------------------------------------------------------------------------Rate-limiter No MTU-Trunc No Sampling No MCBE No L3-TX 2 4 5 7 3 10 ERSPAN-ACL 4 7 2 3 5 10 ERSPAN-V3 Yes 2 3 4 10 5 7

Legend: MCBE = multicast best effort

Cisco Nexus 7000 Series NX-OS System Management Command Reference

560

OL-25806-03

Show Commands show monitor session

L3-TX = L3 Multicast Egress SPAN

Related Commands

Command monitor session

Description Places you into monitor configuration mode for configuring a SPAN or ERSPAN session.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

561

Show Commands show ntp access-groups

show ntp access-groups

To display the Network Time Protocol (NTP) access group configuration, use the show ntp access-groups command. show ntp access-groups

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 5.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the NTP access group configuration:
switch(config)# show ntp access-groups -------------------------------------Access List Type -------------------------------------Admin_Group_123 Peer switch(config)#

Related Commands

Command ntp access-group peer

Description Configures an NTP access group.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

562

OL-25806-03

Show Commands show ntp authentication-keys

show ntp authentication-keys

To display the Network Time Protocol (NTP) authentication keys, use the show ntp authentication-keys command. show ntp authentication-keys

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 5.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the NTP authentication keys:

switch(config)# show ntp authentication-keys ----------------------------Auth key MD5 String ----------------------------3 cisco 42 Nice_Key 34567 nexus7k switch(config)#

Related Commands

Command show ntp authentication-status

Description Displays the status of all NTP authentication.

ntp authentication-key Configures one or more keys that a time source must provide in its NTP packets in order for the device to synchronize to it.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

563

Show Commands show ntp authentication-status

show ntp authentication-status

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

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 5.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the NTP authentication status:

switch(config)# show ntp authentication-status Authentication enabled. switch(config)#

Related Commands

Command ntp authenticate show ntp authentication-keys

Description Enables NTP authentication. Displays the configured NTP authentication keys.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

564

OL-25806-03

Show Commands show ntp internal

show ntp internal

To display the Network Time Protocol (NTP) internal information, use the show ntp internal command. show ntp internal {event-history [config | fsm | msgs | rts | tstamp] | mem-stats [detail] | module-info}

Syntax Description

event-history config fsm msgs rts tstmp mem-stats detail module-info

Specifies the event history. (Optional) Specifies the configuration history. (Optional) Specifies the finite state machine (FSM) state transition. (Optional) Specifies the message and transaction service (MTS) message history. (Optional) Specifies the request-to-send (RTS) history. (Optional) Specifies the timestamp update history. Specifies memory allocation statistics of NTP. (Optional) Specifies the memory allocation statistics of NTP in detail. Specifies all line card-related information.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

565

Show Commands show ntp internal

Examples

This example shows how to display the NTP internal information:

switch(config)# show ntp internal module-info Number of Linecards present = 4 Timestamp check (configured) = enabled Timestamp check status = disabled Enable/Disable status --------------------User : not disabled SUP : not disabled Fabric : not disabled switch(config)#

Related Commands

Command show running-config ntp show ntp statistics

Description Displays the NTP information. Displays the NTP statistics.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

566

OL-25806-03

Show Commands show ntp logging-status

show ntp logging-status

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

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 5.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the NTP logging status:

switch(config)# show ntp logging-status NTP logging enabled. switch(config)#

Related Commands

Command ntp logging show ntp authentication-status

Description Enables NTP logging. Displays the status of NTP authentication.

show ntp session status Displays the NTP CFS distribution session information.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

567

Show Commands show ntp peers

show ntp peers

To display the configured Network Time Protocol (NTP) servers and peers, use the show ntp peers command. show ntp peers

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin vdc-admin network-operator vdc-operator

Command History

Release 5.0(1)

Modification This command was introduced.

Usage Guidelines

A domain name is resolved only when you have a domain name server (DNS) server configured. This command does not require a license.

Examples

This example shows how to display all the configured NTP servers and peers:
switch(config)# show ntp peers -------------------------------------------------Peer IP Address Serv/Peer -------------------------------------------------2001:db8::4101 Peer (configured) 192.0.2.10 Server (configured) switch(config)#

Related Commands

Command ntp server ntp peer show ntp peer-status

Description Configures an NTP server. Configures an NTP peer. Displays the status of all the server and peers.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

568

OL-25806-03

Show Commands show ntp peer-status

show ntp peer-status

To do 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.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the peer status for NTP:
switch(config)# show ntp peer-status

Related Commands

Command show ntp peers

Description Displays information about NTP peers.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

569

Show Commands show ntp pending-diff

show ntp pending-diff

To display the differences between the pending Network Time Protocol (NTP) configuration and the active NTP configuration, use the show ntp pending-diff command. show ntp pending-diff

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.1(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the differences between the pending NTP configuration and the active NTP configuration:
switch# show ntp pending-diff switch#

Related Commands

Command show ntp source show ntp peers

Description Displays information about the NTP source. Displays information about NTP peers.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

570

OL-25806-03

Show Commands show ntp pending peers

show ntp pending peers

To display pending Network Time Protocol (NTP) configuration changes on all peers, use the show ntp pending peers command. show ntp pending peers

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.1(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the pending NTP configuration changes on all peers:
switch# show ntp pending peers switch#

Related Commands

Command show ntp source show ntp peers

Description Displays information about the NTP source. Displays information about NTP peers.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

571

Show Commands show ntp session status

show ntp session status

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

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.1(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the NTP session status:

switch# show ntp session status Last Action Time Stamp : Thu Aug 1 16:22:00 20 Last Action : Distribution Enable Last Action Result : Success Last Action Failure Reason : none switch#

Related Commands

Command show ntp source show ntp peers

Description Displays information about the NTP source. Displays information about NTP peers.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

572

OL-25806-03

Show Commands show ntp status

show ntp status

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

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.1(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the NTP distribution status:

switch(config)# show ntp status Distribution : Disabled Last operational state: No session switch(config)#

Related Commands

Command show ntp source show ntp peers

Description Displays information about the NTP source. Displays information about NTP peers.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

573

Show Commands show ntp rts-update

show ntp rts-update

To display if the request to send (RTS) update is enabled, use the show ntp rts-update command. show ntp rts-update

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.1(2)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to view RTS-update information:

switch(config)# show ntp rts-update RTS update is enabled switch(config)#

Related Commands

Command show ntp source-interface

Description Displays information about the NTP source.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

574

OL-25806-03

Show Commands show ntp source

show ntp source

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

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the NTP source information:

switch(config)# show ntp source

Related Commands

Command ntp source

Description Configures the NTP source.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

575

Show Commands show ntp source-interface

show ntp source-interface

To display the Network Time Protocol (NTP) source interface, use the show ntp source-interface command. show ntp source-interface

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.1(3)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the NTP source interface:

switch(config)# show ntp source-interface Source interface loopback1 switch(config)#

Related Commands

Command show startup-config ntp show running-config ntp

Description Displays information about the startup NTP configuration of the switch. Displays information about the NTP configuration that is currently running on the switch.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

576

OL-25806-03

Show Commands show ntp statistics

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 local memory peer

Displays the input-output statistics. Displays the counters maintained by the local NTP. Displays the statistics counters related to the memory code. 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 hex A:B::C:D. name name Displays statistics for one or more named peers.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to displays statistics for NTP:

switch(config)# show ntp statistics local

Related Commands

Command clear ntp statistics

Description Clears NTP statistics.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

577

Show Commands show ntp status

show ntp status

To display the Network Time Protocol (NTP) distribution status, use the show ntp status command. show ntp status [ > | >> | | ]

Syntax Description

> >> |

(Optional) Redirects the command output to a file. (Optional) Redirects the command output to a file in append mode. (Optional) Pipes the command output to a filter.

Defaults

Disabled

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.1(2)

Modification This command was introduced.

Usage Guidelines

This command shows whether Cisco Fabric Services (CFS) is enabled or disabled for the NTP application and whether a fabric lock is in place because a configuration is in progress. This command does not require a license.

Examples

This example shows how to display the CFS distribution status for NTP. In this example, CFS distribution is enabled and the fabric is locked. When a configuration is in progress on a CFS-enabled device, the fabric is locked until the change is committed and the configuration is distributed throughout the fabric. The lock prevents multiple configurations occurring at the same time.
switch(config)# show ntp status Distribution : Enabled Last operational state: Fabric Locked

Cisco Nexus 7000 Series NX-OS System Management Command Reference

578

OL-25806-03

Show Commands show ntp status

Related Commands

Command show cfs status clear ntp session ntp distribute cfs distribute ntp enable

Description Displays the global CFS distribution status (enabled/disabled) for the device. Clears the application configuration session, discards pending changes, and releases the lock on the fabric. Enables the device to receive NTP configuration updates distributed through CFS. Globally enables CFS distribution for all applications on the device, including CFS over IP. Enables NTP on a device. NTP is enabled by default.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

579

Show Commands show ntp trusted-keys

show ntp trusted-keys

To display the configured Network Time Protocol (NTP) trusted keys, use the show ntp trusted-keys command. show ntp trusted-keys

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin vdc-admin network-operator vdc-operator

Command History

Release 5.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display all the configured NTP trusted keys:
switch(config)# show ntp trusted-keys Trusted Keys: 42 switch(config)#

Related Commands

Command ntp trusted-keys

Description Displays the configured NTP authentication keys.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

580

OL-25806-03

Show Commands show platform hardware capacity interface resources

show platform hardware capacity interface resources

To display a summary of current platform hardware resource utilization, use the show platform hardware capacity interface resources command. show platform hardware capacity interface resources

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.1(2)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display a summary of current platform hardware resource utilization:
switch# show platform hardware capacity interface resources Interface Resources Interface drops: Module Total drops: 7

Tx 0

Rx 0

Highest drop port: Tx Rx - -

Interface buffer sizes: Module Bytes: Tx buffer 7 6452775

Rx buffer 7743330

Related Commands

Command

Description

show hardware fabric- Display information about fabric utilization. utilization

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

581

Show Commands show port-monitor

show port-monitor
To display information about the Simple Network Management Protocol (SNMP) port-monitor configuration, use the show port-monitor command. show port-monitor [policy-name]

Syntax Description

policy-name

(Optional) Policy name. The maximum number of alphanumeric characters is 32.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.1(2)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the SNMP port-monitor information:

switch(config)# show port-monitor name pm2 switch(config-port-monitor)# show port-monitor pm2 Policy Name : pm2 Admin status : Not Active Oper status : Not Active Port type : All Ports -----------------------------------------------------------------------------------------Counter Threshold Interval Rising Threshold event Falling Threshold event In Use --------------- -------- ---------------- ----- ------------------ ---- -----Link Loss Delta 60 5 4 1 4 Yes Sync Loss Delta 60 5 4 1 4 Yes Protocol Error Delta 60 1 4 0 4 Yes Signal Loss Delta 60 5 4 1 4

Cisco Nexus 7000 Series NX-OS System Management Command Reference

582

OL-25806-03

Show Commands show port-monitor

Yes Invalid Words Delta 60 1 4 0 4 Yes Invalid CRC's Delta 60 5 4 1 4 Yes RX Performance Delta 60 2147483648 4 524288000 4 Yes TX Performance Delta 60 2147483648 4 524288000 4 Yes -------------------------------------------------------------------------------switch(config-port-monitor)#

Related Commands

Command show port-monitor status show port-monitor active

Description Displays the port-monitor status. Displays active port-monitor policies.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

583

Show Commands show port-monitor active

show port-monitor active

To display information about the active Simple Network Management Protocol (SNMP) port-monitor policies, use the show port-monitor active command. show port-monitor active

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.1(2)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display information about the active SNMP port-monitor policies:
switch(config)# show port-monitor active Policy Name : test Admin status : Active Oper status : Active Port type : All Ports -----------------------------------------------------------------------------------------Counter Threshold Interval Rising Threshold event Falling Threshold e vent In Use --------------- -------- ---------------- ----- ------------------ ---- -----Link Loss Delta 60 5 4 1 4 Yes Sync Loss Delta 60 5 4 1 4 Yes Protocol Error Delta 60 1 4 0 4 Yes Signal Loss Delta 60 5 4 1 4 Yes Invalid Words Delta 60 1 4 0 4

Cisco Nexus 7000 Series NX-OS System Management Command Reference

584

OL-25806-03

Show Commands show port-monitor active

Yes Invalid CRC's Absolute 30 10000000 100 1 4 Yes RX Performance Delta 60 2147483648 4 524288000 4 Yes TX Performance Delta 60 2147483648 4 524288000 4 Yes -----------------------------------------------------------------------------------------switch(config)#

Related Commands

Command show port-monitor status show port-monitor active

Description Displays the port-monitor status. Displays active port-monitor policies.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

585

Show Commands show port-monitor status

show port-monitor status

To display information about the Simple Network Management Protocol (SNMP) port-monitor status, use the show port-monitor status command. show port-monitor status

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.1(2)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the SNMP port-monitor status:

switch(config)# show port-monitor status Port Monitor : Enabled Active Policies : None Last 10 logs : switch(config-port-monitor)#

Related Commands

Command show port-monitor active show port-monitor

Description Displays active port-monitor policies. Displays information about the port-monitor configuration.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

586

OL-25806-03

Show Commands show processes

show processes
To display the process information for a device, use the show processes command. show processes [vdc vdc-number]

Syntax Description

vdc vdc-number

(Optional) Displays process information for a specific virtual device context (VDC).

Defaults

Displays information for all processes in the local device.

Command Modes

Any command mode

SupportedUserRoles

network-admin vdc-admin network-operator vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

You can specify another VDC only from the default VDC. This command does not require a license.

Examples

This example shows how to display the process information for a device:
switch# show processes PID ----1 2 3 4 5 6 7 8 9 10 15 ... State ----S S S S S S S S S S S PC -------b7f9e468 0 0 0 0 0 0 0 0 0 0 Start_cnt ----------1 1 1 1 1 1 1 1 1 1 1 TTY ---Type ---O O O O O O O O O O O Process ------------init migration/0 ksoftirqd/0 desched/0 migration/1 ksoftirqd/1 desched/1 events/0 events/1 khelper kthread

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

587

Show Commands show processes

This example shows how to display the process information for another VDC:
switch# show processes vdc 2 PID ----1 2 3 4 5 6 7 8 9 10 15 ... State ----S S S S S S S S S S S PC -------b7f9e468 0 0 0 0 0 0 0 0 0 0 Start_cnt ----------1 1 1 1 1 1 1 1 1 1 1 TTY ---Type ---O O O O O O O O O O O Process ------------init migration/0 ksoftirqd/0 desched/0 migration/1 ksoftirqd/1 desched/1 events/0 events/1 khelper kthread

Cisco Nexus 7000 Series NX-OS System Management Command Reference

588

OL-25806-03

Show Commands show processes cpu

show processes cpu

To display the CPU utilization information for processes on the device, use the show processes cpu command. show processes cpu

Syntax Description

This command has no arguments or keywords.

Defaults

Displays information for all processes in the local device.

Command Modes

Any command mode

SupportedUserRoles

network-admin vdc-admin network-operator vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the CPU utilization information for the processes:
switch# show processes cpu PID ----1 2 3 4 5 6 7 8 9 10 15 24 102 103 116 ... Runtime(ms) ----------286 302 1586 502 1956 2218 2325 1158 1258 62 0 0 201 276 0 Invoked uSecs 1Sec Process -------- ----- ----- ----------315748 0 0 init 636268 0 0 migration/0 72636726 0 0 ksoftirqd/0 1345165 0 0 desched/0 559740 3 0 migration/1 457761883 0 0 ksoftirqd/1 1469647 1 0 desched/1 794795 1 0 events/0 721210 1 0 events/1 2779 22 0 khelper 30 25 0 kthread 2 5 0 kacpid 286 704 0 kblockd/0 516 535 0 kblockd/1 5 17 0 khubd

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

589

Show Commands show processes cpu history

show processes cpu history

To display information about the CPU utilization by the system processes in the last 60 seconds, 60 minutes, and 72 hours in a graphical format, use the show processes cpu history command. show processes cpu history

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.2.(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display information about the CPU utilization by the system processes for last 60 seconds, 60 minutes, and 72 hours in a graphical format:
switch(config)# show processes cpu history 92 100 90 80 70 60 50 40 30 20 10 5 4 73 474 64 65 575 47 206324551543534226644368135103343343133313901236334538431915 # # # # # # # # # # # # # # # ## # # # # # ## # ## ### # # # # # ### ## ## ### ## # # # ## ### ## ## ### ## ## # # ## ### ## ## ### ## ### ## # # ### ## ### ## ## ### # ### # # 0....5....1....1....2....2....3....3....4....4....5....5.... 0 5 0 5 0 5 0 5 0 5 CPU% per second (last 60 seconds) # = average CPU%

Cisco Nexus 7000 Series NX-OS System Management Command Reference

590

OL-25806-03

Show Commands show processes cpu history

111514221111111211112112121122122522122221222313122122232122 869180309993994069890950889706715227911205311280423925335914 100 90 80 70 60 50 * * 40 * * * 30 * * * * ** * * * * ** 20 *********** ** ********************************* *********** 10 ***#*****************************#************************** 0....5....1....1....2....2....3....3....4....4....5....5.... 0 5 0 5 0 5 0 5 0 5 CPU% per minute (last 60 minutes) * = maximum CPU% # = average CPU%

556655555556565565556566666666665666666566555556555555555555565666656665 100 90 80 70 60 50 40 30 20 10 ************************************************************************ 0....5....1....1....2....2....3....3....4....4....5....5....6....6....7. 0 5 0 5 0 5 0 5 0 5 0 5 0 CPU% per hour (last 72 hours) * = maximum CPU% # = average CPU%

Related Commands

Command show processes cpu

Description Displays the CPU utilization information for processes on the device.

show system resources Displays the system resources.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

591

Show Commands show process cpu sort

show process cpu sort

To display information about CPU processes sorted by CPU utilization, use the show process cpu sort command. show process cpu sort [5sec | 1min | 5min]

Syntax Description

5sec 1min 5min

(Optional) Displays the sorted output based on the processes that use the memory for five seconds. (Optional) Displays the sorted output based on the processes that use the memory for one minute. (Optional) Displays the sorted output based on the processes that use the memory for five minutes.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 6.2(2) 4.1(1)

Modification Added the 5sec, 1min, and 5min keywords. This command was introduced.

Usage Guidelines

The modules perform the polling and send messages to the supervisor module for Simple Network Management Protocol (SNMP) caching. When attached to a module under no load, the CPU spikes approximately every 10 seconds for a short period of time. The name of the process is statsclient. The CPU spike can go up to 100 percent for a few milliseconds. The process is preemptive and it does not block other high priority processes. This command does not require a license.

Examples

This example shows how to display information about CPU processes sorted by CPU utilization:
switch(config)# show process cpu sort PID ----3622 Runtime(ms) ----------2335 Invoked -------6843 uSecs ----341 1Sec Process ------ ----------50.0% pfstat

Cisco Nexus 7000 Series NX-OS System Management Command Reference

592

OL-25806-03

Show Commands show process cpu sort

1 2 3 4 5 6 7 8 9 10 15 24 104 105 118 185 186 187 --More--

2550 13 2091 48 10 21 42 1785 1560 58 0 0 12 4 0 0 139 0

4169 2676 883525 6300 2816 4450597 6416 8581 7426 2731 30 2 201 138 5 4 3010 1

611 4 2 7 3 0 6 208 210 21 25 5 62 33 17 3 46 5

0.0% 0.0% 0.0% 0.0% 0.0% 0.0% 0.0% 0.0% 0.0% 0.0% 0.0% 0.0% 0.0% 0.0% 0.0% 0.0% 0.0% 0.0%

init migration/0 ksoftirqd/0 desched/0 migration/1 ksoftirqd/1 desched/1 events/0 events/1 khelper kthread kacpid kblockd/0 kblockd/1 khubd pdflush pdflush kswapd0

Note

Because the values in the 1Sec column represent a dual-core CPU, the CPU processes may add up to 200 percent. In this example, the pfstat process is consuming 50 percent of one core.

Related Commands

Command show processes cpu

Description Displays the CPU utilization information for processes on the device.

show processes cpu history Displays information about the CPU utilization by the system processes in the last 60 seconds, 60 minutes, and 72 hours in a graphical format.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

593

Show Commands show processes log

show processes log

To display the contents of the process log, use the show processes log command. show processes log [details | pid process-id | vdc-all]

Syntax Description

details pid process-id vdc-all

(Optional) Displays detailed information from the process log. (Optional) Displays detailed information from the process log for a specific process. The range is from 1 to 2147483647. (Optional) Displays process log information for all virtual device contexts (VDCs).

Defaults

Displays summary information for all processes on the device.

Command Modes

Any command mode

SupportedUserRoles

network-admin vdc-admin network-operator vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display summary information from the process log:
switch# show processes log VDC Process PID --- --------------- -----1 aclmgr 3632 1 aclmgr 4182 1 aclmgr 4205 1 adjmgr 4333 1 arbiter 4332 1 arp 3870 1 clis 10005 1 clis 10268 1 clis 1040 ... Normal-exit ----------N N N N N N N N N Stack ----Y Y Y N Y Y Y N Y Core ----N N N N N N N N N Log-create-time --------------Thu Mar 13 21:37:07 Wed Mar 12 13:45:38 Wed Mar 12 13:45:38 Sat Nov 24 06:25:20 Mon Nov 19 10:14:42 Sat Dec 22 12:02:46 Sat Nov 24 03:46:13 Fri Dec 14 09:13:53 Fri Nov 16 13:34:30

2008 2008 2008 2007 2007 2007 2007 2007 2007

Cisco Nexus 7000 Series NX-OS System Management Command Reference

594

OL-25806-03

Show Commands show processes log

This example shows how to display detailed information from the process log:
switch# show processes log details ====================================================== Service: aclmgr Description: ACL Mgr Started at Thu Mar 13 20:34:35 2008 (507163 us) Stopped at Thu Mar 13 20:37:07 2008 (664205 us) Uptime: 2 minutes 32 seconds Start type: SRV_OPTION_RESTART_STATELESS (23) Death reason: SYSMGR_DEATH_REASON_FAILURE_SIGNAL (2) System image name: n7000-s1-dk9.4.0.1.gbin System image version: 4.0(1) S7 PID: 3632 Exit code: signal 11 (core dumped) CWD: /var/sysmgr/work Virtual Memory: CODE DATA BRK STACK TOTAL Register Set: EBX ESI EAX EAX EFL B7D64CD0 41170040 00000401 FFFFFFFF (orig) 00010292 ECX EDI XDS EIP ESP 00000001 00000000 C010007B B7D5BEF2 BFFFD1C0 EDX EBP XES XCS XSS 00000001 BFFFD1C8 0000007B 00000073 0000007B 08048000 - 0811CCF4 0811DCF4 - 0811EBE8 08121000 - 08259000 BFFFE270 47244 KB

Stack: 4272 bytes. ESP BFFFD1C0, TOP BFFFE270 0xBFFFD1C0: 0xBFFFD1D0: 0xBFFFD1E0: 0xBFFFD1F0: 0xBFFFD200: 0xBFFFD210: 0xBFFFD220: 0xBFFFD230: 0xBFFFD240: ... B7D5BEE0 B7D2614C B5542014 B7D08918 B5542014 FF000226 08246A04 B7D6369A 0000C005 B7D64CD0 FF000226 B7D25DE0 B7D2614C 41170034 BFFFD2D0 08230074 00002000 00002000 BFFFD1D8 BFFFD218 000007DE FF000226 08241A54 BFFFD278 BFFFD2D0 00000004 BFFFD278 B7D5C381 B7D232BA B5542014 08241A54 B7D2614C B7D138CE B7D5A24D 00000000 B7D3CF90 .....L.......... La..&........2.. . T..]....... T. ....La..&...T.$. . T.4..AT.$.La.. &.......x....8.. .j$.t.#.....M... .6... .......... ..... ..x.......

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

595

Show Commands show processes log

This example shows how to display detailed information from the process log for a specific process:
switch# show processes pid 3632 ====================================================== Service: arp Description: Address Resolution Protocol (ARP Started at Sat Dec 22 12:02:19 2007 (216828 us) Stopped at Sat Dec 22 12:02:44 2007 (496964 us) Uptime: 25 seconds Start type: SRV_OPTION_RESTART_STATELESS (23) Death reason: SYSMGR_DEATH_REASON_FAILURE_SIGNAL (2) System image version: 4.0(0.788) S16 PID: 3912 Exit code: signal 11 (core dumped) Threads: 3906 3905 4066 3917 3884 3870 CWD: /var/sysmgr/work Virtual Memory: CODE DATA BRK STACK TOTAL Register Set: EBX ESI EAX EAX EFL B7EF4264 B601C003 B8009B1E FFFFFFFF (orig) 00010286 ECX EDI XDS EIP ESP B53F45CA B53F45C8 0000007B B7EDF9AB B53F4560 EDX EBP XES XCS XSS B8009B1E B53F4578 0000007B 00000073 0000007B 08048000 - 08071474 08072474 - 08074794 08075000 - 080DE000 BFFFEB80 107908 KB

Stack: 2688 bytes. ESP B53F4560, TOP BFFFEB80 0xB53F4560: 0xB53F4570: 0xB53F4580: 0xB53F4590: ... B601C003 00000000 B601C003 00000001 00000001 00000000 B53F45CA B53F45C4 F1EC838D B53F45D8 B53F45C8 00000000 B7EF4264 B7EE0C0D B53F45C0 00000001 ............dB.. .........E?..... .....E?..E?..E?. .....E?.........

This example shows how to display process log information for all VDCs on the physical device:
switch# show processes log vdc-all VDC Process PID Normal-exit --- --------------- ------ ----------1 aclmgr 3632 N 1 aclmgr 4182 N 1 aclmgr 4205 N 1 adjmgr 4333 N 1 arbiter 4332 N 1 arp 3870 N 1 clis 10005 N 1 clis 10268 N 1 clis 1040 N 1 clis 10486 N 1 clis 10646 N ... Stack ----Y Y Y N Y Y Y N Y Y Y Core ----N N N N N N N N N N N Log-create-time --------------Thu Mar 13 21:37:07 Wed Mar 12 13:45:38 Wed Mar 12 13:45:38 Sat Nov 24 06:25:20 Mon Nov 19 10:14:42 Sat Dec 22 12:02:46 Sat Nov 24 03:46:13 Fri Dec 14 09:13:53 Fri Nov 16 13:34:30 Fri Nov 16 14:58:59 Fri Nov 16 14:59:45

2008 2008 2008 2007 2007 2007 2007 2007 2007 2007 2007

Cisco Nexus 7000 Series NX-OS System Management Command Reference

596

OL-25806-03

Show Commands show processes memory

show processes memory

To display the memory allocation information for processes, use the show processes memory command. show processes memory [shared | sort]

Syntax Description

shared sort

(Optional) Displays the shared memory allocation. (Optional) Displays the sorted list that is based on the memory usage.

Defaults

Displays memory allocated to the processes.

Command Modes

Any command mode

SupportedUserRoles

network-admin vdc-admin network-operator vdc-operator

Command History

Release 6.2(2) 4.0(1)

Modification Added the sort keyword. This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display information about memory allocation for processes:
switch# show processes memory PID ----1 2 3 4 5 6 7 8 9 10 15 24 ... MemAlloc -------147456 0 0 0 0 0 0 0 0 0 0 0 StackBase/Ptr ----------------bffffda0/bffff890 0/0 0/0 0/0 0/0 0/0 0/0 0/0 0/0 0/0 0/0 0/0 Process ---------------init migration/0 ksoftirqd/0 desched/0 migration/1 ksoftirqd/1 desched/1 events/0 events/1 khelper kthread kacpid

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

597

Show Commands show processes memory

This example shows how to display information about shared memory allocation for processes:
switch# show processes memory shared Component Shared Memory Size Used Available Address (kbytes) (kbytes) (kbytes) smm 0X60000000 1024 3 1021 cli 0X60110000 24576* 13991 10585 am 0X61920000 14336* 14 14322 urib 0X62730000 32768* 648 32120 u6rib-ufdm 0X64740000 320* 188 132 urib-redist 0X647A0000 4096* 0 4096 icmpv6 0X64BB0000 2048 0 2048 ip 0X64DC0000 8192 65 8127 urib-ufdm 0X655D0000 2048* 0 2048 u6rib 0X657E0000 16384* 507 15877 ipv6 0X667F0000 8192 2 8190 u6rib-notify 0X67000000 2048* 681 1367 rpm 0X67210000 2048 6 2042 mrib 0X67420000 40960 2 40958 mrib-mfdm 0X69C30000 5120 0 5120 m6rib 0X6A140000 10240 2 10238 m6rib-mfdm 0X6AB50000 2048 10 2038 igmp 0X6AD60000 8192 0 8192 bgp 0X6B570000 8192 182 8010 Shared memory totals - Size: 189 MB, Used: 16 MB, Available: 173 MB Free Physical Memory: 0 MB kernel, 0 MB user Reference Count 115 84 7 25 2 25 2 23 2 12 9 12 11 3 2 3 2 2 1

Related Commands

Command show processes show startup-config

Description Displays process information. Displays the startup configuration.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

598

OL-25806-03

Show Commands show ptp brief

show ptp brief

To display a brief status of the Precision Time Protocol (PTP) interfaces, use the show ptp brief command. show ptp brief

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 5.2(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display a brief status of the PTP interfaces:
switch# show ptp brief PTP port status ----------------------Port State ------- -------------Eth7/10 Passive Eth7/1 Slave

Related Commands

Command show ptp clock show ptp clocks foreign-masters-record show ptp corrections show ptp parent

Description Displays the properties of the local clock. Displays the state of foreign masters known to the PTP process. Displays the last few PTP corrections. Displays the properties of the PTP parent.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

599

Show Commands show ptp brief

Command show ptp port show ptp time-property

Description Displays the status of the PTP port. Displays the properties of the PTP clock.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

600

OL-25806-03

Show Commands show ptp clock

show ptp clock

To display the Precision Time Protocol (PTP) clock information, use the show ptp clock command. show ptp clock

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 5.2(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the PTP clock information:

switch# show ptp clock PTP Device Type: Boundary clock Clock Identity : 0:18:ba:ff:ff:d8: e:17 Clock Domain: 0 Number of PTP ports: 2 Priority1 : 255 Priority2 : 255 Clock Quality: Class : 248 Accuracy : 254 Offset (log variance) : 65535 Offset From Master : 0 Mean Path Delay : 0 Steps removed : 1 Local clock time:Sun Jan 15 20:57:29 2011

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

601

Show Commands show ptp clock

Related Commands

Command show ptp brief show ptp clocks foreign-masters-record show ptp corrections show ptp parent show ptp port show ptp time-property

Description Displays the PTP status. Displays the state of foreign masters known to the PTP process. Displays the last few PTP corrections. Displays the properties of the PTP parent. Displays the status of the PTP port. Displays the properties of the PTP clock.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

602

OL-25806-03

Show Commands show ptp clock foreign-masters-record

show ptp clock foreign-masters-record

To display information about the state of foreign masters known to the Precision Time Protocol (PTP) process, use the show ptp clocks foreign-masters-record command. show ptp clock foreign-masters-record {interface [ethernet]}

Syntax DescriptionT

interface ethernet

Specifies an interface. (Optional) Specifies an Ethernet interface.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 5.2(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display information about the state of foreign masters known to the PTP process:
switch# show ptp clock foreign-masters-record interface ethernet 7/1 RP/0/0/CPU0:demo#show ptp clocks foreign-masters P1=Priority1, P2=Priority2, C=Class, A=Accuracy, OSLV=Offset-Scaled-Log-Variance, SR=Steps-Removed GM=Is grandmaster --------Interface --------Eth7/10 Eth7/1 ----------------------Clock-ID ------------------------P1 -----P2 ---255 255 ---C ---248 248 --A --254 254 ----OSLV ----65535 65535 -------SR -------0 0 GM GM

0:18:ba:ff:ff:d8: e:16 255 0:18:ba:ff:ff:d8: e:16 255

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

603

Show Commands show ptp clock foreign-masters-record

Related Commands

Command show ptp brief show ptp clock show ptp corrections show ptp parent show ptp port show ptp time-property

Description Displays the PTP status. Displays the properties of the local clock. Displays the last few PTP corrections. Displays the properties of the PTP parent. Displays the status of the PTP port. Displays the properties of the PTP clock.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

604

OL-25806-03

Show Commands show ptp corrections

show ptp corrections

To display the history of the Precision Time Protocol (PTP) clock corrections on the Ethernet interfaces, use the show ptp corrections command. show ptp corrections

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 5.2(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the history of the PTP clock corrections on the Ethernet interfaces:
switch# show ptp corrections PTP corrections -----------------------------------------Slave Port Sup time Corrections(s,ns) ---------- -------------------- -----------Eth7/10 2010 Mar 11 03:14:55 -1 1210900 Eth7/10 2010 Mar 11 03:14:55 -340978

Related Commands

Command show ptp brief show ptp clock show ptp clocks foreign-masters-record show ptp parent

Description Displays the PTP status. Displays the properties of the local clock. Displays the state of foreign masters known to the PTP process. Displays the properties of the PTP parent.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

605

Show Commands show ptp corrections

Command show ptp port show ptp time-property

Description Displays the status of the PTP port. Displays the properties of the PTP clock.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

606

OL-25806-03

Show Commands show ptp parent

show ptp parent

To display information about the parent and grand master of the Precision Time Protocol (PTP) clock, use the show ptp parent command. show ptp parent

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 5.2(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display information about the parent and grand master of the PTP clock:
switch# show ptp parent Parent Clock: Parent Clock Identity: 0:18:ba:ff:ff:d8: e:16 Parent Port Number: 1546 Observed Parent Offset (log variance): N/A Observed Parent Clock Phase Change Rate: N/A Grandmaster Clock: Grandmaster Clock Identity: 0:18:ba:ff:ff:d8: e:16 Grandmaster Clock Quality: Class: 248 Accuracy: 254 Offset (log variance): 65535 Priority1: 255 Priority2: 255

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

607

Show Commands show ptp parent

Related Commands

Command show ptp brief show ptp clock show ptp clocks foreign-masters-record show ptp corrections show ptp port show ptp time-property

Description Displays the PTP status. Displays the properties of the local clock. Displays the state of foreign masters known to the PTP process. Displays the last few PTP corrections. Displays the status of the PTP port. Displays the properties of the PTP clock.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

608

OL-25806-03

Show Commands show ptp port

show ptp port

To display information about the Precision Time Protocol (PTP) port, use the show ptp port command. show ptp port {interface [ethernet]}

Syntax DescriptionT

interface ethernet

Specifies the interface. (Optional) Specifies an Ethernet interface.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 5.2(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display information about the PTP port:
switch# show ptp port PTP Port Dataset: Eth7/1 Port identity: clock identity: 0:18:ba:ff:ff:d8: e:17 Port identity: port number: 1536 PTP version: 2 Port state: Slave Delay request interval(log mean): 2 Announce receipt time out: 3 Peer mean path delay: 0 Announce interval(log mean): 1 Sync interval(log mean): 2 Delay Mechanism: End to End Peer delay request interval(log mean): 0

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

609

Show Commands show ptp port

Related Commands

Command show ptp brief show ptp clock show ptp clocks foreign-masters-record show ptp corrections show ptp parent show ptp time-property

Description Displays the PTP status. Displays the properties of the local clock. Displays the state of foreign masters known to the PTP process. Displays the last few PTP corrections. Displays the properties of the PTP parent. Displays the properties of the PTP clock.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

610

OL-25806-03

Show Commands show ptp time-property

show ptp time-property

To display the Precision Time Protocol (PTP) clock properties, use the show ptp time-property command. show ptp time-property

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 5.2(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the PTP clock properties:

switch# show ptp time-property PTP CLOCK TIME PROPERTY: Current UTC Offset valid: 0 Current UTC Offset: 33 Leap59: 0 Leap61: 0 Time Traceable: 0 Frequency Traceable: 0 PTP Timescale: 0 Time Source: 0xA0(internal Osccilator)

Related Commands

Command show ptp brief show ptp clock show ptp clocks foreign-masters-record

Description Displays the PTP status. Displays the properties of the local clock. Displays the state of foreign masters known to the PTP process.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

611

Show Commands show ptp time-property

Command show ptp corrections show ptp parent show ptp port

Description Displays the last few PTP corrections. Displays the properties of the PTP parent. Displays the status of the PTP port.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

612

OL-25806-03

Show Commands show redundancy status

show redundancy status

To show detailed information about redundancy, use the show redundancy status command. show redundancy status

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to displays redundancy information:

switch# show redundancy status Redundancy mode --------------administrative: HA operational: None This supervisor (sup-6) ----------------------Redundancy state: Active Supervisor state: Active Internal state: Active with no standby Other supervisor (sup-5) -----------------------Redundancy state: Not present Supervisor state: Internal state: System start time: System uptime: N/A N/A Fri Aug 15 15:55:19 2008 3 days, 23 hours, 57 minutes, 22 seconds

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

613

Show Commands show redundancy status

Kernel uptime: Active supervisor uptime:

4 days, 0 hours, 1 minutes, 39 seconds 3 days, 23 hours, 57 minutes, 22 secondss

Cisco Nexus 7000 Series NX-OS System Management Command Reference

614

OL-25806-03

Show Commands show resource monitor-session

show resource monitor-session

To display the resources that are available for a traditional Ethernet Switched Port Analyzer (SPAN) session, use the show resource monitor-session command. show resource monitor-session

Syntax Description

This command has no arguments or keywords

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 6.2(2)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the resources that are available for traditional SPAN sessions:
switch# show resource monitor-session Resource Min Max -------monitor-session --0 --2 Used ---0 Unused Avail ----2

-----0

Related Commands

Command show resource monitor-session-exten ded

Description Displays the resources that are available for an extended SPAN and ERSPAN session.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

615

Show Commands show resource monitor-session-extended

show resource monitor-session-extended

To display the resources that are available for the extended Ethernet Switched Port Analyzer (SPAN) or Encapsulated Remote Switched Port Analyzer (ERSPAN) sessions, use the show resource monitor-session-extended command. show resource monitor-session-extended

Syntax Description

This command has no arguments or keywords

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 6.2(2)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the resources that are available for extended SPAN or ERSPAN sessions:
switch# show resource monitor-session-extended Resource -------monitor-session-extended Min --0 Max --12 Used ---0 Unused -----0 Avail ----12

Related Commands

Command show resource monitor-session

Description Displays the resources that are available for a traditional SPAN session.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

616

OL-25806-03

Show Commands show rmon

show rmon
To display the configuration or onboard logs, use the show rmon command. show rmon {alarms | events | hcalarms | logs | status}

Syntax Description

alarms events hcalarms logs status

Displays the configured 32-bit RMON alarms. Displays the configured RMON events. Displays the configured 64-bit HC (High Capacity) RMON alarms. Displays the RMON event log. Displays the RMON information.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the configured RMON alarms:

switch# show rmon alarms Alarm 20 is active, owned by test Monitors 1.3.6.1.2.1.2.2.1.16.30 every 30 second(s) Taking delta samples, last value was 17 Rising threshold is 15, assigned to event 1 Falling threshold is 0, assigned to event 0 On startup enable rising or falling alarm

This example shows how to display the configured RMON events:

switch# show rmon events Event 4 is active, owned by administrator@london_op_center Description is WARNING(4) Event firing causes log and trap to community public, last fired 03:32:43

This example shows how to display the configured high-capacity RMON alarms:

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

617

Show Commands show rmon

switch# show rmon hcalarms High Capacity Alarm 1 is active, owned by cseSysCPUUtilization.0@test Monitors 1.3.6.1.4.1.9.9.305.1.1.1.0 every 10 second(s) Taking absolute samples, last value was 0 Rising threshold is 60, assigned to event 4 Falling threshold is 59, assigned to event 4 On startup enable rising alarm

This example shows how to display RMON configuration and logged information:
switch# show rmon status Maximum allowed 32 bit or 64 bit alarms : 512 Number of 32 bit alarms configured : 0 Number of 64 bit hcalarms configured : 0 switch#

Related Commands

Command rmon alarm rmon event rmon hcalarm

Description Configures the 32-bit RMON alarm. Configures an RMON event. Configures the 64-bit RMON alarm.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

618

OL-25806-03

Show Commands show running-config cdp

show running-config cdp

To display the Cisco Discovery Protocol (CDP) running configuration, use the show running-config cdp command. show running-config cdp [all]

Syntax Description

all

(Optional) Displays the running configuration with defaults.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the CDP running configuration with defaults:
switch(config)# show running-config cdp all !Command: show running-config cdp all !Time: Fri Jan 15 22:19:20 2010 version 5.0(2) logging level cdp 6 cdp advertise v2 cdp enable cdp holdtime 180 cdp timer 60 cdp format device-id system-name

interface Ethernet6/1 cdp enable interface Ethernet6/2 cdp enable interface Ethernet6/3

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

619

Show Commands show running-config cdp

cdp enable interface Ethernet6/4 cdp enable interface Ethernet6/5 cdp enable interface Ethernet6/6 cdp enable interface Ethernet6/7 cdp enable interface Ethernet6/8 cdp enable interface Ethernet7/1 cdp enable interface Ethernet7/2 cdp enable interface Ethernet7/3 cdp enable interface Ethernet7/4 cdp enable interface Ethernet7/5 cdp enable interface Ethernet7/6 cdp enable interface Ethernet7/7 cdp enable interface Ethernet7/8 cdp enable --More-switch(config)#

Related Commands

Command enable cdp

Description Enables CDP on an interface.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

620

OL-25806-03

Show Commands show running-config diagnostic

show running-config diagnostic

To display the running-configuration diagnostics, use the show running-config diagnostic command. show running-config diagnostic [all]

Syntax Description

all

(Optional) Displays the running-configuration diagnostics with defaults.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the running-configuration diagnostics:

switch(config)# show running-config diagnostic all !Command: show running-config diagnostic all !Time: Fri Jan 15 22:22:01 2010 version 5.0(2) diagnostic bootup level complete

switch(config)#

Related Commands

Command show startup-config diagnostic

Description Displays the startup-configuration diagnostics.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

621

Show Commands show running-config eem

show running-config eem

To display the Embedded Event Manager (EEM) running configuration, use the show running-config eem command. show running-config eem

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows the Embedded Event Manager (EEM) running configuration:
switch# show running-config eem switch(config)# show running-config eem !Command: show running-config eem !Time: Fri Jan 15 22:23:28 2010 version 5.0(2) switch(config)#

Cisco Nexus 7000 Series NX-OS System Management Command Reference

622

OL-25806-03

Show Commands show running-config lldp

show running-config lldp

To display the global Link Layer Discovery Protocol (LLDP) configuration, use the show running-config lldp command. show running-config lldp

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 5.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the global LLDP configuration:

switch(config)# show running-config lldp !Command: show running-config lldp !Time: Mon Jan 11 02:19:29 2010 version 5.0(2) feature lldp logging level lldp 5 switch(config)#

Related Commands

Command feature lldp

Description Enables the LLDP feature globally.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

623

Show Commands show running-config monitor

show running-config monitor

To display information about the running Ethernet Switched Port Analyzer (SPAN) configuration on the system, use the show running-config monitor command. show running-config monitor [all]

Syntax Description

all

(Optional) Displays the running SPAN configuration with defaults.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the running SPAN configuration on the system:
switch(config)# show running-config monitor !Command: show running-config monitor !Time: Fri Jan 15 22:24:43 2010 version 5.0(2) logging level monitor 6 switch(config)#

Related Commands

Command show monitor show startup-config monitor

Description Displays information about the SPAN configuration. Displays information about the startup SPAN configuration.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

624

OL-25806-03

Show Commands show running-config netflow

show running-config netflow

To display the NetFlow configuration that is currently on your switch, use the show running-config netflow command. show running-config netflow [all]

Syntax Description

all

(Optional) Displays the NetFlow configuration with defaults.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

625

Show Commands show running-config netflow

Examples

This example shows how to display the NetFlow configuration that is running on the switch:
switch(config)# show running-config netflow all !Command: show running-config netflow all !Time: Fri Jan 15 22:26:04 2010 version 5.0(2) feature netflow flow timeout active 1800 flow timeout inactive 15 flow exporter new_flow_1 transport udp 9995 dscp 0 version 5 flow exporter new_flow_2 transport udp 9995 dscp 0 version 9 template data timeout 1800 flow exporter test transport udp 9995 dscp 0 version 9 template data timeout 1800 flow exporter Custom-Flow-Exporter-1 transport udp 9995 dscp 0 version 9 template data timeout 1800 option exporter-stats timeout 1200 switch(config)#

Related Commands

Command show startup-config netflow

Description Displays the startup NetFlow configurations.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

626

OL-25806-03

Show Commands show running-config ntp

show running-config ntp

To display the Network Time Protocol (NTP) configuration that is currently running on the system, use the show running-config ntp command. show running-config ntp [all]

Syntax Description

all

(Optional) Displays all of the NTP running configuration.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the NTP configuration that is currently running:
switch(config)# show running-config ntp !Command: show running-config ntp !Time: Fri Jan 15 22:28:34 2010 version 5.0(2) ntp server 190.0.2.10 ntp server 192.0.2.10 prefer use-vrf RED key 786 ntp peer 2001:db8::4101 ntp authentication-key 3 md5 fewhg 7 ntp authentication-key 34567 md5 qabzk7f 7 ntp logging ntp access-group peer abcd*123 switch(config)#

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

627

Show Commands show running-config ntp

Related Commands

Command show ntp source-interface show startup-config ntp

Description Displays information about the NTP source interface. Displays information about the startup NTP configuration of the switch.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

628

OL-25806-03

Show Commands show running-config snmp

show running-config snmp

To display the running Simple Network Management Protocol (SNMP) configuration of a system, use the show running-config snmp command. show running-config snmp [all]

Syntax Description

all

(Optional) Displays the running SNMP configuration with defaults.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the running SNMP configuration of a system:
switch(config)# show running-config snmp !Command: show running-config snmp !Time: Fri Jan 15 22:30:27 2010 version 5.0(2) snmp-server user admin network-admin auth md5 0x1dc65f45a9d8e41dbccd76380946d6c3 priv 0x1dc65f45a9d8e41dbccd76380946d6c3 localizedkey

switch(config)#

Related Commands!

Command show startup-config snmp show port-monitor active

Description Displays the startup SNMP configuration. Displays active port-monitor policies.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

629

Show Commands show sampler

show sampler
To display a NetFlow sampler, use the show sampler command. show sampler [name] [sampler-name]

Syntax Description

name sampler-name

(Optional) Specifies a sampler. (Optional) Sampler name. The maximum number of characters is 32.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

You can create a sampler to define the NetFlow sampling rate for a flow. This command does not require a license.

Examples

This example shows how to display a NetFlow sampler:

switch(config)# show sampler Sampler Netflow-Sampler-1: mode 1 out-of 1000 switch(config)#

Related Commands

Command sampler

Description Configures a sampler to collect data for a user selected packet ratio to preserve hardware resources.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

630

OL-25806-03

Show Commands show scheduler

show scheduler
To display information about scheduled maintenance jobs, use the show scheduler command. show scheduler {config | internal [mem-stats] | job [name jobname] | logfile | schedule [name schedulename]}

Syntax Description

config internal mem-stats job name jobname logfile schedule name schedulename

Displays scheduler configuration information. Provides the internal scheduler information as specified. (Optional) Provides the scheduler internal memory information as specified. Displays job information as specified. (Optional) Displays information for the specified scheduler job name. Displays the scheduler log file as specified. Displays the scheduler timetable as specified. (Optional) Displays the scheduler timetable for the specified schedule name.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

To use this command, the scheduler must already be enabled. To enable the scheduler, use the feature scheduler command. This command does not require a license.

Examples

This example shows how to display the scheduler configuration:

switch# show scheduler config config terminal feature scheduler scheduler logfile size 16

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

631

Show Commands show scheduler

end config terminal scheduler job name test-1 end config terminal scheduler job name test end config terminal scheduler job name test1 end config terminal scheduler job name test2 end switch#

This example shows how to display the specified scheduler timetable:

switch# show scheduler schedule name test Schedule Name : test -----------------------------------User Name : admin Schedule Type : Run once on Tue Aug 10 09:48:00 2008 Last Execution Time: Tue Aug 10 09:48:00 2008 ----------------------------------------------Job Name Status ----------------------------------------------addMem Success (0)

Related Commands

Command scheduler feature scheduler

Description Configures maintenance jobs. Enables the scheduler feature for scheduling maintenance jobs.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

632

OL-25806-03

Show Commands show snmp

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

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

633

Show Commands show snmp

Examples

This example shows how to display the SNMP information:

switch(config)# show snmp sys contact: sys location: anyplace, Anywhere 0 SNMP packets input 0 Bad SNMP versions 0 Unknown community name 0 Illegal operation for community name supplied 0 Encoding errors 0 Number of requested variables 0 Number of altered variables 0 Get-request PDUs 0 Get-next PDUs 0 Set-request PDUs 0 SNMP packets output 0 Too big errors 0 No such name errors 0 Bad values errors 0 General errors

Community --------Comm2 testCommunity com3

Group / Access --------------network-admin vdc-operator vdc-admin

______________________________________________________________ SNMP USERS ______________________________________________________________ User ____ foo Auth ____ md5 Priv(enforce) Groups _____________ ______ aes-128(no) network-operator vdc-admin network-admin no network-operator

User3

md5

admin md5 des(no) network-admin user1 md5 des(no) vdc-admin ______________________________________________________________ NOTIFICATION TARGET USERS (configured for sending V3 Inform) ______________________________________________________________ User ____ foo (EngineID 11:22:33:44:55) foo (EngineID 33:0:33:22:33) Auth ____ md5 Priv ____ no

sha

no

SNMP Tcp Authentication Flag : Enabled.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

634

OL-25806-03

Show Commands show snmp

Related Commands

Command snmp-server community

Description Configures SNMP community strings.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

635

Show Commands show snmp community

show snmp community

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

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

Use the show snmp community command to display a list of SNMP communities configured on a device. In Cisco NX-OS Release 4.0(2) and later releases, the show snmp-community command displays any SNMP contexts that are mapped to SNMPv2c communities. This command does not require a license.

Examples

This example shows how to display the SNMP community strings and any associated SNMP contexts:
switch# show snmp community Community --------testCommunity Comm2 com3 Group / Access -------------vdc-operator network-admin vdc-admin context ------contextB

Cisco Nexus 7000 Series NX-OS System Management Command Reference

636

OL-25806-03

Show Commands show snmp community

Related Commands

Command snmp-server community snmp-server mib community-map

Description Configures SNMP community strings. Maps SNMP community strings to SNMP contexts.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

637

Show Commands show snmp context

show snmp context

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

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(2)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the SNMP context mapping:

switch# show snmp context ------------------------------------------------------------------Context [Protocol instance, VRF, Topology] ------------------------------------------------------------------contextB instance1, vrf1, topo1 -------------------------------------------------------------------r

Related Commands

Command snmp-server context

Description Configures SNMP context mapping.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

638

OL-25806-03

Show Commands show snmp engineID

show snmp engineID

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

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the SNMP engine ID:

switch(config)# show snmp engineID Local SNMP engineID: [Hex] 80000009030005300A0B0C [Dec] 128:000:000:009:003:000:005:048:010:011:012

Related Commands

Command snmp-server user

Description Configures SNMP target notification users.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

639

Show Commands show snmp group

show snmp group

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

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

640

OL-25806-03

Show Commands show snmp group

Examples

This example shows how to display the SNMP groups:

switch(config)# 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

Related Commands

Command role name

Description Configures security roles used as SNMP groups.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

641

Show Commands show snmp host

show snmp host

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

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the SNMP hosts:

switch(config)# show snmp host ------------------------------------------------------------------Host Port Version Level Type SecName ------------------------------------------------------------------192.0.2.1 33 v1 noauth trap Comm2 ------------------------------------------------------------------192.0.2.2 162 v3 auth trap comm3 Use VRF: Blue ------------------------------------------------------------------192.0.2.10 162 v3 auth trap testCommunity Filter VRF: Red -------------------------------------------------------------------

Cisco Nexus 7000 Series NX-OS System Management Command Reference

642

OL-25806-03

Show Commands show snmp host

Related Commands

Command snmp-server host

Description Configures SNMP hosts.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

643

Show Commands show snmp sessions

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.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the SNMP sessions:

switch(config)# show snmp sessions

Related Commands

Command snmp-server user

Description Configures SNMP users.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

644

OL-25806-03

Show Commands show snmp source-interface

show snmp source-interface

To display the Simple Network Management Protocol (SNMP) source interface through which notifications are sent, use the show snmp source-interface command. show snmp source-interface

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.2(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the SNMP source interface through which notifications are sent:
switch(config)# show snmp source-interface ------------------------------------------------------------------Notification source-interface ------------------------------------------------------------------trap lookback1 inform Ethernet1/1 ------------------------------------------------------------------switch(config)#

Related Commands

Command snmp-server sourceinterface

Description Configures an SNMP source interface through which notifications are sent.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

645

Show Commands show snmp trap

show snmp trap

To display the Simple Network Management Protocol (SNMP) notification enable status, use the show snmp trap command. show snmp trap

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the SNMP notification enable status:
switch(config)# show snmp trap Trap type --------aaa server state-change callhome entity fru license snmp authentication vrrp link bridge topologychange bridge newroot stpx inconsistency stpx loop-inconsistency stpx root-inconsistency Enabled ------No No Yes Yes No No No No No No No No

Cisco Nexus 7000 Series NX-OS System Management Command Reference

646

OL-25806-03

Show Commands show snmp trap

Related Commands

Command snmp-server trap enable

Description Enables SNMP notifications.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

647

Show Commands show snmp user

show snmp user

To display the Simple Network Management Protocol (SNMP) users, use the show snmp user command. show snmp user [username [engineID id]]

Syntax Description

username engineID id

(Optional) Name of the user. The name can be any case-sensitive, alphanumeric string up to 32 characters. (Optional) Configures the SNMP Engine ID for a notification target user. The ID is 11 decimal values separated by colons.

Defaults

Displays all users

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

648

OL-25806-03

Show Commands show snmp user

Examples

This example shows how to display the SNMP users:

switch(config)# show snmp user ______________________________________________________________ SNMP USERS ______________________________________________________________ User ____ foo Priv(enforce) Groups _____________ ______ aes-128(no) network-operator vdc-admin network-admin User3 md5 no network-operator admin md5 des(no) network-admin user1 md5 des(no) vdc-admin ______________________________________________________________ NOTIFICATION TARGET USERS (configured for sending V3 Inform) ______________________________________________________________ User ____ foo (EngineID 11:22:33:44:55) Auth ____ md5 Priv ____ no Auth ____ md5

Related Commands

Command snmp-server user

Description Configures SNMP users.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

649

Show Commands show sprom

show sprom
To display the contents of the serial PROM (SPROM) on the device, use the show sprom command. show sprom {all | backplane bp-number | clock clock-number | cmp | fan fan-number | module slot | powersupply ps-number | stby-sup | sup | xbar xbar-number}

Syntax Description

all backplane bp-number clock clock-number cmp fan fan-number module slot powersupply ps-number stby-sup sup xbar xbar-number

Displays the SPROM contents for all components on the physical device. Displays the SPROM contents for a backplane. Displays the SPROM contents for a clock module. Displays the SPROM contents for a Connectivity Management Processor (CMP). Displays the SPROM contents for a fan. Displays the SPROM contents for a I/O module. Displays the SPROM contents for a power supply. Displays the SPROM contents for the standby supervisor module. Displays the SPROM contents for the active supervisor module. Displays the SPROM contents for a fabric module.

Defaults

Displays summary information for all processes on the device.

Command Modes

Any command mode

SupportedUserRoles

network-admin vdc-admin network-operator vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

The SPROM on the physical device components contain detailed information about the hardware, including the serial number, part number, and revision numbered. This command does not require a license.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

650

OL-25806-03

Show Commands show sprom

Examples

This example shows how to display SPROM information for all components on the physical device:
switch# show sprom all DISPLAY active supervisor sprom contents: Common block: Block Signature : 0xabab Block Version : 3 Block Length : 160 Block Checksum : 0x158a EEPROM Size : 65535 Block Count : 3 FRU Major Type : 0x6004 FRU Minor Type : 0x5 OEM String : Cisco Systems, Inc Product Number : N7K-SUP1 Serial Number : JAB10380101 Part Number : 73-10877-03 Part Revision : 09 Mfg Deviation : 0 H/W Version : 0.311 Mfg Bits : 0 Engineer Use : 0 snmpOID : 0.0.0.0.0.0.0.0 Power Consump : -247 RMA Code : 0-0-0-0 CLEI Code : TBD VID : TBD ...

This example shows how to display SPROM information for a backplane:

switch# show sprom backplane 1 DISPLAY backplane sprom contents: Common block: Block Signature : 0xabab Block Version : 3 Block Length : 160 Block Checksum : 0x147e EEPROM Size : 65535 Block Count : 5 FRU Major Type : 0x6001 FRU Minor Type : 0x0 OEM String : Cisco Systems, Inc. Product Number : N7K-C7010 Serial Number : TBM11256507 Part Number : 73-10900-04 Part Revision : 03 Mfg Deviation : H/W Version : 0.403 Mfg Bits : 0 Engineer Use : 0 snmpOID : 0.0.0.0.0.0.0.0 Power Consump : -247 RMA Code : 0-0-0-0 CLEI Code : VID : Chassis specific block: Block Signature : 0x6001 Block Version : 3 Block Length : 39 Block Checksum : 0x3bf Feature Bits : 0x0 HW Changes Bits : 0x0

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

651

Show Commands show sprom

Stackmib OID : 0 MAC Addresses : 00-18-ba-d8-3f-bc Number of MACs : 128 OEM Enterprise : 9 OEM MIB Offset : 5 MAX Connector Power: 1 WWN software-module specific block: Block Signature : 0x6005 Block Version : 1 Block Length : 0 Block Checksum : 0x66 wwn usage bits: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 License software-module specific block: Block Signature : 0x6006 Block Version : 1 Block Length : 16 Block Checksum : 0x77 lic usage bits: 00 00 00 00 00 00 00 00 Second Serial number specific block: Block Signature : 0x6007 Block Version : 1 Block Length : 28 Block Checksum : 0x302 Serial Number : TBM11256507

Cisco Nexus 7000 Series NX-OS System Management Command Reference

652

OL-25806-03

Show Commands show startup-config cdp

show startup-config cdp

To display the Cisco Discovery Protocol (CDP) startup configuration, use the show startup-config cdp command. show startup-config cdp [all]

Syntax Description

all

(Optional) Displays the startup configuration with defaults.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.1(2)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the CDP startup configuration with defaults:
switch(config)# show startup-config cdp all !Command: show startup-config cdp !Time: Tue Feb 2 22:36:26 2010 version 5.0(2) logging level cdp 6 switch(config)#

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

653

Show Commands show startup-config cdp

Related Commands

Command show running-config cdp

Description Displays the running CDP configuration.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

654

OL-25806-03

Show Commands show startup-config diagnostic

show startup-config diagnostic

To display startup-configuration diagnostics, use the show startup-config diagnostic command. show startup-config diagnostic [all]

Syntax Description

all

(Optional) Displays the startup configuration with defaults.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the startup-configuration diagnostics:

switch(config)# show startup-config diagnostic all !Command: show startup-config diagnostic all !Time: Tue Jan 26 22:38:22 2010 !Startup config saved at: Thu Jan 21 08:39:42 2010 version 5.0(2) diagnostic bootup level complete switch(config)#

Related Commands

Command show running-config diagnostic

Description Displays the running-configuration diagnostics.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

655

Show Commands show startup-config cfs

show startup-config cfs

To display information about the Cisco Fabric Services (CFS) startup configuration, use the show startup-config cfs command. show startup-config cfs [all]

Syntax Description

all

(Optional) Displays all of the CFS startup configuration.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.1(2)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the CFS startup configuration:

switch(config)# show startup-config cfs !Command: show startup-config cfs !Time: Tue Feb 2 22:40:47 2010 !Startup config saved at: Thu Jan 21 08:39:42 2010 version 5.0(2) switch(config)#

Related Commands

Command cfs distribute show cfs status

Description Enables CFS distribution for the device globally. Displays the CFS distribution status.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

656

OL-25806-03

Show Commands show startup-config eem

show startup-config eem

To display the Embedded Event Manager (EEM) startup configuration, use the show startup-config eem command. show startup-config eem

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the Embedded Event Manager (EEM) startup configuration:
switch# show startup-config eem !Command: show startup-config eem !Time: Tue Feb 2 22:41:25 2010 !Startup config saved at: Thu Jan 21 08:39:42 2010 version 5.0(2) switch#

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

657

Show Commands show startup-config monitor

show startup-config monitor

To display information about the startup Ethernet Switched Port Analyzer (SPAN) configuration, use the show startup-config monitor command. show startup-config monitor

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display information about the startup Ethernet SPAN configuration:
switch(config)# show startup-config monitor !Command: show startup-config monitor !Time: Tue Feb 2 22:42:07 2010 !Startup config saved at: Thu Jan 21 08:39:42 2010 version 5.0(2) logging level monitor 6 switch(config)#

Related Commands

Command show monitor show running-config monitor

Description Displays information about an Ethernet Switched Port Analyzer (SPAN). Displays the running configuration to the startup configuration.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

658

OL-25806-03

Show Commands show startup-config netflow

show startup-config netflow

To display the startup NetFlow configuration, use the show startup-config netflow command. show startup-config netflow [all]

Syntax Description

all

(Optional) Displays the startup NetFlow configuration with defaults.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the startup NetFlow configuration:

switch# show startup-config netflow !Command: show startup-config monitor !Time: Tue Feb 2 22:42:07 2010 !Startup config saved at: Thu Jan 21 08:39:42 2010 version 5.0(2) logging level monitor 6 switch(config)# show startup-config netflow !Command: show startup-config netflow !Time: Tue Feb 2 22:43:13 2010 !Startup config saved at: Thu Jan 21 08:39:42 2010 version 5.0(2) feature netflow flow exporter new_flow_1 version 5 flow exporter new_flow_2 version 9

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

659

Show Commands show startup-config netflow

flow exporter test version 9 flow exporter Custom-Flow-Exporter-1 version 9 option exporter-stats timeout 1200 switch#

Related Commands

Command show running-config netflow

Description Displays information about the NetFlow configuration that is currently running on the switch.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

660

OL-25806-03

Show Commands show startup-config ntp

show startup-config ntp

To display the Network Time Protocol (NTP) startup configuration, use the show startup-config ntp command. show startup-config ntp [all]

Syntax Description

all

(Optional) Displays all NTP startup configurations.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the NTP startup configuration:

switch(config)# show startup-config ntp !Command: show startup-config ntp !Time: Tue Feb 2 22:45:37 2010 !Startup config saved at: Thu Jan 21 08:39:42 2010 version 5.0(2) ntp server 192.0.2.10 use-vrf Red ntp peer 2001:db8::4101 ntp authenticate ntp authentication-key 42 md5 dJmhwKzd 7 ntp trusted-key 42 ntp logging ntp access-group peer NT_GLOBAL switch(config)#

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

661

Show Commands show startup-config ntp

Related Commands

Command show ntp source-interface show running-config ntp

Description Displays information about the NTP source interface. Displays information about the NTP configuration that is currently running on the switch.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

662

OL-25806-03

Show Commands show startup-config snmp

show startup-config snmp

To display the startup Simple Network Management Protocol (SNMP) configuration of a system, use the show startup-config snmp command. show startup-config snmp [all]

Syntax Description

all

(Optional) Displays the startup SNMP configuration with defaults.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.1(2)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

663

Show Commands show startup-config snmp

Examples

This example shows how to display the startup SNMP configuration of the system:
switch(config)# show startup-config snmp !Command: show startup-config snmp all !Time: Tue Feb 2 22:46:33 2010 !Startup config saved at: Thu Jan 21 08:39:42 2010 version 5.0(2) snmp-server aaa-user cache-timeout 3600 snmp-server protocol enable no snmp-server globalEnforcePriv snmp-server tcp-session auth snmp-server user admin network-admin auth md5 0x1dc65f45a9d8e41dbccd76380946d6c3 priv 0x1dc65f45a9d8e41dbccd76380946d6c3 localizedkey snmp-server enable traps ospf rate-limit 10 7 snmp-server enable traps ospf foo rate-limit 10 7 no snmp-server enable traps bridge topologychange no snmp-server enable traps bridge newroot no snmp-server enable traps stpx inconsistency no snmp-server enable traps stpx loop-inconsistency no snmp-server enable traps stpx root-inconsistency

switch(config-port-monitor)#

Related Commands

Command show running-config snmp show port-monitor active

Description Displays the running SNMP configuration. Displays active port-monitor policies.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

664

OL-25806-03

Show Commands show system cores

show system cores

To display the core filename, use the show system cores command. show system cores

Syntax Description

This command has no arguments or keywords.

Defaults

Displays information for all features.

Command Modes

Any command mode

SupportedUserRoles

network-admin vdc-admin network-operator vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

Use the system cores command to configure the system core filename. This command does not require a license.

Examples

This example shows how to display destination information for the system core files:
switch# show system cores Cores are transferred to slot0:

Related Commands

Command system cores

Description Configures the system core filename.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

665

Show Commands show system error-id

show system error-id

To display the destination information for core files, use the show system error-id command. show system error-id {error-number | list}

Syntax Description

error-id list

Error number. The range is from 0x0 to 0xffffffff. Displays brief information for all the system error messages.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin vdc-admin network-operator vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display detailed information for an error message:
switch# show system error-id 0x1 Error Facility: (null) Error Description: not enough memory

This example shows how to display brief information for all the error messages:
switch# show system error-id list Common errors: 0x00000000 0x00000001 0x00000002 0x00000003 0x00000004 0x00000005 0x00000006 0x00000007 ...

(SYSERR_SUCCESS): "success". (SYSERR_NOMEM): "not enough memory". (SYSERR_PSS_ERROR): "error while accessing PSS". (SYSERR_CMI_NO_RESPOSE_PAYLOAD): "no cmi response payload". (SYSERR_CMI_NULL_RECEIVE_BUF): "null cmi receive buffer". (SYSERR_MGMT_ERROR): "unknown error". (SYSERR_MGMT_NO_ENTRY): "entry not present". (SYSERR_MGMT_NO_OBJECT): "object not present".

Cisco Nexus 7000 Series NX-OS System Management Command Reference

666

OL-25806-03

Show Commands show system memory-status

show system memory-status

To display the memory status information, use the show system memory-status command. show system memory-status

Syntax Description

This command has no arguments or keywords.

Defaults

Displays information for all features.

Command Modes

Any command mode

SupportedUserRoles

network-admin vdc-admin network-operator vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the memory status information:

switch# show system memory-status MemStatus: OK

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

667

Show Commands show system pss shrink status

show system pss shrink status

To display the last Persistent Storage Service (PSS) shrink status, use the show system pss shrink status command. show system pss shrink status

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the last PSS shrink status:
switch(config)# show system pss shrink status Last pss shrink started on: Tue May 12 08:08:30 2009 switch(config)#

Related Commands

Command show system pss shrink status details

Description Displays the last PSS shrink status details.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

668

OL-25806-03

Show Commands show system pss shrink status details

show system pss shrink status details

To display details of the last Persistent Storage Service (PSS) shrink status details, use the show system pss shrink status details command. show system pss shrink status details

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display details of the last PSS shrink status:
switch(config)# show system pss shrink status details Last pss shrink started on: Tue May 12 08:08:30 2009 VDC 1: Service Service Service Service Service Service Service Service Service Service Service Service Service Service Service Service Service

"aaa" in vdc 1: pss shrink completed successfully "cert_enroll" in vdc 1: pss shrink completed successfully "ExceptionLog" in vdc 1: pss shrink completed successfully "psshelper_gsvc" in vdc 1: pss shrink not needed (defaultcb invoked) "platform" in vdc 1: pss shrink completed successfully "R2D2_usd" in vdc 1: pss shrink not needed (defaultcb invoked) "radius" in vdc 1: pss shrink completed successfully "securityd" in vdc 1: pss shrink not needed (defaultcb invoked) "tacacs" in vdc 1: pss shrink completed successfully "eigrp" in vdc 1: pss shrink request not sent "isis" in vdc 1: pss shrink not needed (defaultcb invoked) "isis_dce" in vdc 1: pss shrink request not sent "isis_otv" in vdc 1: pss shrink request not sent "ospf" in vdc 1: pss shrink request not sent "ospfv3" in vdc 1: pss shrink request not sent "rip" in vdc 1: pss shrink request not sent "eigrp" in vdc 1: pss shrink request not sent

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

669

Show Commands show system pss shrink status details

Service "isis" in vdc 1: pss shrink request not sent Service "isis_dce" in vdc 1: pss shrink request not sent Service "ospf" in vdc 1: pss shrink request not sent Service "ospfv3" in vdc 1: pss shrink request not sent Service "rip" in vdc 1: pss shrink request not sent Service "eigrp" in vdc 1: pss shrink request not sent Service "isis" in vdc 1: pss shrink request not sent Service "isis_dce" in vdc 1: pss shrink request not sent Service "ospf" in vdc 1: pss shrink request not sent Service "ospfv3" in vdc 1: pss shrink request not sent Service "rip" in vdc 1: pss shrink request not sent Service "eigrp" in vdc 1: pss shrink request not sent Service "isis" in vdc 1: pss shrink request not sent Service "isis_dce" in vdc 1: pss shrink request not sent Service "ospf" in vdc 1: pss shrink request not sent Service "ospfv3" in vdc 1: pss shrink request not sent Service "rip" in vdc 1: pss shrink request not sent Service "acllog" in vdc 1: pss shrink completed successfully Service "aclmgr" in vdc 1: pss shrink completed successfully Service "adjmgr" in vdc 1: pss shrink not needed (defaultcb invoked) Service "amt" in vdc 1: pss shrink request not sent Service "arbiter" in vdc 1: pss shrink not needed (defaultcb invoked) Service "arp" in vdc 1: pss shrink not needed (defaultcb invoked) Service "ascii-cfg" in vdc 1: pss shrink not needed (defaultcb invoked) Service "babycaesar" in vdc 1: pss shrink not needed (defaultcb invoked) Service "bgp" in vdc 1: pss shrink not needed (defaultcb invoked) Service "bios_daemon" in vdc 1: pss shrink request not sent Service "bootup_test" in vdc 1: pss shrink request not sent Service "bootvar" in vdc 1: pss shrink not needed (defaultcb invoked) Service "callhome" in vdc 1: pss shrink not needed (defaultcb invoked) Service "capability" in vdc 1: pss shrink completed successfully Service "cardclient" in vdc 1: pss shrink not needed (defaultcb invoked) Service "cdp" in vdc 1: pss shrink completed successfully Service "cfs" in vdc 1: pss shrink completed successfully Service "clis" in vdc 1: pss shrink not needed (defaultcb invoked) Service "cmpproxy" in vdc 1: pss shrink completed successfully Service "confcheck" in vdc 1: pss shrink completed successfully --More--

Related Commands

Command show system pss shrink status

Description Displays the last PSS shrink status.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

670

OL-25806-03

Show Commands show system reset-reason

show system reset-reason

To display the reset-reason history for the modules on the device, use the show system reset-reason command. show system reset-reason [module slot | xbar xbar-number]

Syntax Description

module slot xbar xbar-number

(Optional) Displays the restart reason for an I/O module or supervisor module. (Optional) Displays the restart reason for the fabric module.

Defaults

Displays the reset reasons for the supervisor modules.

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

You can use this command only in the default virtual device context (VDC). This command does not require a license.

Examples

This example shows how to display the reset-reason history for the supervisor modules:
switch# show system reset-reason ----- reset reason for Supervisor-module 6 (from Supervisor in slot 6) --1) At 11151 usecs after Fri May 30 14:40:50 2008 Reason: Reset Requested by CLI command reload Service: Version: 4.0(2) 2) At 171083 usecs after Wed May 28 11:40:49 2008 Reason: Reset Requested by CLI command reload Service: Version: 4.0(2) ----- reset reason for Supervisor-module 5 (from Supervisor in slot 6) --1) No time Reason: Unknown Service: Version: 2) No time

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

671

Show Commands show system reset-reason

Reason: Unknown Service: Version:

Related Commands

Command clear system reset-reason

Description Clears the reset reason history for the device.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

672

OL-25806-03

Show Commands show system redundancy

show system redundancy

To display the system redundancy status, use the show system redundancy command. show system redundancy [ha] status

Syntax Description

ha

(Optional) Displays the virtual device context (VDC) redundancy status.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the system redundancy status:

switch# show system redundancy status Redundancy mode --------------administrative: HA operational: None This supervisor (sup-1) ----------------------Redundancy state: Active Supervisor state: Active Internal state: Active with no standby Other supervisor (sup-2) -----------------------Redundancy state: Not present switch#

This example shows how to display the virtual device context (VDC) redundancy status:
switch# show system redundancy ha status VDC No This supervisor -------------------Other supervisor ---------------

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

673

Show Commands show system redundancy

vdc 1 vdc 2 vdc 3 vdc 4 switch#

Active with no standby Active with no standby Active with no standby N/A

N/A N/A N/A N/A

Related Commands

Command system switchover

Description Switches over to the standby supervisor.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

674

OL-25806-03

Show Commands show system resources

show system resources

To display the system resources, use the show system resources command. show system resources

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the system resources:

switch(config)# Load average: Processes : CPU states : Memory usage: switch(config)# show system resources 1 minute: 0.00 5 minutes: 0.00 15 minutes: 0.0 520 total, 1 running 0.0% user, 0.5% kernel, 99.5% idle 4135616K total, 1642556K used, 2493060K free 1188K buffers, 731988K cache

Related Commands

Command show processes cpu

Description Displays the CPU utilization information for processes on the device.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

675

Show Commands show system standby manual-boot

show system standby manual-boot

To display the status of the system standby manual boot option, use the show system standby manual-boot command. show system standby manual-boot

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the status of the system standby manual boot option:
switch(config)# show system standby manual-boot system standby manual-boot option is enabled switch(config)#

Related Commands

Command system hap-reset

Description Enables the Supervisor Reset HA policy.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

676

OL-25806-03

Show Commands show system uptime

show system uptime

To display the amount of time since the last system upload, use the show system uptime command. show system uptime

Syntax Description

This command has no arguments or keywords.

Defaults

Displays information for all features.

Command Modes

Any command mode

SupportedUserRoles

network-admin vdc-admin network-operator vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the amount of time since the last system reload:
switch# show system uptime System start time: System uptime: Kernel uptime: Active supervisor uptime: Fri May 30 14:46:25 2008 16 days, 23 hours, 9 minutes, 22 seconds 16 days, 23 hours, 13 minutes, 29 seconds 16 days, 23 hours, 9 minutes, 22 seconds

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

677

Show Commands show tech-support all binary

show tech-support all binary

To collect logs from across the entire device in binary format, including virtual device contexts (VDCs) and linecards, use the show tech-support all binary command. show tech-support all binary {bootflash: | logflash: | slot0:}

Syntax Description

bootflash: logflash: slot0:

Specifies bootflash as the destination file system used to save the binary output. Specifies logflash as the destination file system used to save the binary output. Specifies slot0 as the destination file system used to save the binary output.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 6.2(2)

Modification This command was introduced.

Usage Guidelines

Binary tech support is a log-collecting framework that collects logs internally from all Cisco NX-OS processes that are running on the device. The show tech-support all binary command collects logs from across the entire device, including VDCs, and line cards. The logs are saved under one tarball that can be easily transferred for later analysis. Binary tech support can either be parsed within the device or moved to an external log server where it can be parsed offline. The tool that is used to parse the logs is called DeBlogger. If a line card fails during the log collection, binary tech support continues to collect logs from all remaining line cards and VDCs.

Note

The output filename is automatically generated and cannot be chosen. This command does not require a license.

Examples

This example shows how to collect logs from across the entire device:
switch(config)# show tech-support all binary bootflash:

Cisco Nexus 7000 Series NX-OS System Management Command Reference

678

OL-25806-03

Show Commands show tech-support all binary

Temporary Storage Space Available: 1345 MB Destination Storage Space Available: 229 MB Waiting for all Modules to dump 'Binary Tech Support'... Response from module: 7 is: 0x0(SUCCESS/Success) Response from module: 4 is: 0x0(SUCCESS/Success) Response from module: 9 is: 0x0(SUCCESS/Success) Response from module: 5 is: 0x0(SUCCESS/Success) Response from module: 6 is: 0x0(SUCCESS/Success) ------------------------------------------------------------Please find the output here: bootflash:binary_show_tech_all_06_12_2013_14_26_05HRS.tar -------------------------------------------------------------

Related Commands

Command bloggerd parse log-buffer

Description Parses logs from binary to ASCII format.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

679

Show Commands show tech-support ascii-cfg

show tech-support ascii-cfg

To display detailed information about the checkpoint feature, use the show tech-support ascii-cfg command. show tech-support ascii-cfg

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to show the detailed information about the checkpoint feature:
switch# show tech-support ascii-cfg `show checkpoint summary` ------------------------------------------------------------------------------Name UserName Created at ------------------------------------------------------------------------------stable admin Tue May 27 13:19:24 2008 `show checkpoint` ------------------------------------------------------------------------------Name: stable version 4.0(2) power redundancy-mode combined force license grace-period feature vrrp feature tacacs+ feature ospf feature pim feature pim6 feature msdp feature eigrp feature rip feature isis

Cisco Nexus 7000 Series NX-OS System Management Command Reference

680

OL-25806-03

Show Commands show tech-support ascii-cfg

feature pbr

Related Commands

Command show checkpoint

Description Displays the contents of the checkpoint file.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

681

Show Commands show tech-support cfs

show tech-support cfs

To display information about the Cisco Fabric Services (CFS) configuration required by technical support, use the show tech-support cfs command. show tech-support cfs {commands | [name application_name {commands}]}

Syntax Description

commands name application_name

Displays all related CFS commands for use when working with technical support on a CFS issue. (Optional) Displays information about the CFS configuration required by technical support for a specific application.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.1(2)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display information about the CFS configuration required by technical support:
switch# show tech-support cfs `show cfs application` ---------------------------------------------Application Enabled Scope ---------------------------------------------ntp No Physical-fc-ip stp Yes Physical-eth vpc Yes Physical-eth igmp Yes Physical-eth l2fm Yes Physical-eth role No Physical-fc-ip radius No Physical-fc-ip callhome Yes Physical-fc-ip

Cisco Nexus 7000 Series NX-OS System Management Command Reference

682

OL-25806-03

Show Commands show tech-support cfs

Total number of entries = 8 `show cfs lock` `show cfs peers` Physical Fabric ------------------------------------------------------------------------Switch WWN IP Address ------------------------------------------------------------------------20:00:00:22:55:79:a4:c1 172.28.230.85 [Local] switch Total number of entries = 1 `show cfs status` Distribution : Enabled Distribution over IP : Enabled - mode IPv4 IPv4 multicast address : 239.255.70.83 IPv6 multicast address : ff15::efff:4653 Distribution over Ethernet : Disabled`show cfs internal event-history errors` Mon Dec 22 12:24:42 2008 : Sending over network failed, retval ffffffff, errno 113 [No route to host] Msg ID: [6e:00:00:00:c0:e0:ff:bf:0:1] vsan: 4097, IP addr: 0.0.0.0

Total number of entries = 8

Related Commands

Command

Description

show application_name Displays the CFS configuration session status for the application, including the last action, the result, and the reason if there was a failure. session status show cfs internal show cfs lock show cfs merge status name show cfs peers show cfs regions show cfs static show cfs status Displays information internal to CFS including memory statistics, event history, and so on. Displays all active CFS fabric locks. Displays the merge status for a given CFS application. Displays all the CFS peers in the physical fabric. Displays all the CFS applications with peers and region information. Displays all CFS static peers with their status. Displays the status of CFS distribution on the device as well as IP distribution information.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

683

Show Commands show tech-support session-mgr

show tech-support session-mgr

To display detailed information about the session manager, which controls configuration sessions, use the show tech-support session-mgr command.

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

Use the show tech-support session-mgr command to gather information about the session manager for troubleshooting purposes. This command displays detailed information about the session manager. The output should be saved to a file and included in any support requests for the session manager. This command does not require a license.

Examples

This example shows how to save the output of the show tech-support session-mgr command to a file:
switch# show tech-support session-mgr > bootflash:output

Related Commands

Command show configuration session

Description Displays information about the configuration sessions.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

684

OL-25806-03

Show Commands show tech-support snmp

show tech-support snmp

To display detailed technical support information for Simple Network Management Protocol (SNMP), use the show tech-support snmp command. show tech-support snmp

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

Use the show tech-support snmp command to gather information about SNMP for troubleshooting purposes. This command displays detailed information about SNMP. The output should be saved to a file and included in any support requests for SNMP. This command does not require a license.

Examples

This example shows how to save the output of the show tech-support snmp command to a file:
switch# show tech-support snmp > bootflash:output

Related Commands

Command snmp-server community

Description Configures SNMP community strings.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

685

Show Commands show xml server status

show xml server status

To display information about the status of the XML server, use the show xml server status command. show xml server status

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display information about the status of the XML server:
switch(config)# show xml server status operational status is enabled maximum session configured is 8 switch(config)#

Cisco Nexus 7000 Series NX-OS System Management Command Reference

686

OL-25806-03

T Commands
This chapter describes the Cisco NX-OS system management commands that begin with the letter T.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

687

T Commands tag

tag
To correlate multiple events in the policy, use the tag command. tag tag {and | andnot | or} tag [and | andnot | or {tag}] {happens occurs in seconds}

Syntax Description

tag and andnot or happens in occurs seconds

Tag name. The tag name can be any 29 alphanumeric characters. (Optional) Specifies to use boolean and logic (Optional) Specifies to use boolean andnot logic (Optional) Specifies to use boolean or logic Specifies the number of occurrences before raising the event. Specifies the number of occurrences must occur within this time period. Numbers of times that the event occurs. The range is from 1 to 4294967295. Amount of time, in seconds, that the next event occurs. The range is from 0 to 4294967295 seconds.

Defaults

None

Command Modes

(config-applet)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 5.2(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to correlate multiple events in the policy:

switch# configuration terminal switch(config)# event manager applet monitorShutdown switch(config-applet)# description Monitors interface shutdown. switch(config-applet)# event cli match shutdown switch(config-applet)# tag one or two happens 1 in 10000 switch(config-applet)# action 1.0 cli show interface e 3/1

Related Commands

Command show flow exporter

Description Displays information about NetFlow exporters.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

688

OL-25806-03

T Commands tag

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

689

T Commands template data timeout

template data timeout

To configure the template data timeout parameter for the NetFlow exporter, use the template data timeout command. To remove the template data timeout parameter, use the no form of this command. template data timeout time no template data timeout [time]

Syntax Description

time

(Optional) Time in seconds. The range is from 1 to 86400.

Defaults

None

Command Modes

NetFlow exporter version 9 configuration (config-flow-exporter-version-9)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure the template data timeout parameter:
switch(config)# flow exporter Netflow-Exporter-1 switch(config-flow-exporter)# version 9 switch(config-flow-exporter-version-9)# template data timeout 120

This example shows how to remove the template data timeout parameter configuration:
switch(config-flow-exporter)# version 9 switch(config-flow-exporter-version-9)# no template data timeout 120

Related Commands

Command show flow exporter

Description Displays information about NetFlow exporters.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

690

OL-25806-03

T Commands terminal event-manager bypass

terminal event-manager bypass

To allow the CLI commands that match an Embedded Event Manager (EEM) policy to continue to run, use the terminal event-manager bypass command. To prevent such commands from running, use the no form of this command. terminal event-manager bypass terminal no event-manager bypass

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.2(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to allow the CLI commands that match an EEM policy to continue to run:
switch# terminal event-manager bypass switch#

This example shows how to prevent the CLI commands that match an EEM policy from running:
switch# terminal no event-manager bypass switch#

Related Commands

Command event manager policy

Description Registers an Embedded Event Manager (EEM) policy with the EEM.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

691

T Commands test watchdog

test watchdog
To test the watchdog feature, use the test watchdog command. test watchdog

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to test the watchdog feature:

switch(config)# test watchdog Warning: This command will reboot the system if watchdog is functioning properly . Do you wish to proceed anyway? (y/n)

Related Commands

Command system watchdog system no watchdog

Description Enables the watchdog feature. Disables the watchdog feature.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

692

OL-25806-03

T Commands transport email mail-server

transport email mail-server

To configure up to five SMTP servers as the domain name server (DNS) names, IPv4 addresses, or IPv6 addresses for Call home, use the transport email mail-server command. transport email mail-server ip-address [port port-number] [priority priority-number] [use-vrf vrf-name]

Syntax Description

ip-address port port-number priority priority-number

Domain name server (DNS) name, IPv4 address, or IPv6 address. (Optional) Specifies the port number. The range is from 1 to 65535. The default port number is 25. (Optional) Specifies the priority of the SMTP server. The range is from 1 to 100, with 1 being the highest priority and 100 the lowest. If you do not specify a priority, the default value of 50 is used.

use-vrf vrf-name (Optional) Specifies the virtual routing and forwarding (VRF) name.

Defaults

None

Command Modes

Call home configuration

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 5.0(1)

Modification This command was introduced.

Usage Guidelines

You can configure up to five SMTP servers for Call home. The VRF specified in the transport email mail-server command is not used to send messages using HTTP. When CFS distribution is enabled, devices that run Release 4.2 or earlier releases accept only the transport email smtp-server command configurations while devices that run Release 5.0(1) or later releases accept both the transport email smtp-server and transport email mail-server command configurations. When a device accepts both the transport email smtp-server and transport email mail-server commands, the transport email smtp-server command has a priority of 0, which is the highest. The server specified by this command is tried first followed by the servers specified by the transport email mail-server commands in order of priority. This command does not require a license.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

693

T Commands transport email mail-server

Examples

This example shows how to configure multiple SMTP servers for Call home messages:
switch(config)# callhome switch(config-callhome)# Red switch(config-callhome)# switch(config-callhome)# switch(config-callhome)# switch(config-callhome)# switch(config-callhome)# switch(config-callhome)# switch(config-callhome)# transport email mail-server 192.0.2.1 port 33 priority 1 use-vrf transport transport transport transport transport transport email email email email email email mail-server 192.0.2.10 priority 4 mail-server 172.21.34.193 smtp-server 10.1.1.174 mail-server 64.72.101.213 priority 60 from [email protected] reply-to [email protected]

Based on the configuration above, the SMTP servers would be tried in this order: 10.1.1.174 (priority 0) 192.0.2.1 (priority 1) 172.21.34.193 (priority 50, which is the default) 64.72.101.213 (priority 60)

Related Commands

Command transport http use-vrf transport email smtp-server

Description Configures a VRF to send Call home messages using HTTP. Distributes the SMTP server configuration to devices that run Release 4.2 or earlier releases.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

694

OL-25806-03

T Commands transport http proxy enable

transport http proxy enable

To enable Smart Call Home to send all HTTP messages through the HTTP proxy server, use the transport http proxy enable command. transport http proxy enable

Syntax Description

This command has no arguments or keywords.

Defaults

Disabled

Command Modes

Call home configuration mode (config-callhome)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 5.2(1)

Modification This command was introduced.

Usage Guidelines

You can use this command only after the proxy server address has been configured. The virtual routing and forwarding (VRF) instance used for transporting messages through the proxy server is the same as that configured using the transport http use-vrf command. This command does not require a license.

Examples

This example shows how to enable Smart Call Home to send all HTTP messages through the HTTP proxy server:
switch# configure terminal switch(config)# callhome switch(config-callhome)# transport http proxy server 192.0.2.1 switch(config-callhome)# transport http proxy enable switch(config-callhome)#

Related Commands

Command transport http proxy server show callhome transport

Description Configures the HTTP proxy server domain name server (DNS) name, IPv4 address, or IPv6 address. Displays the transport-related configuration for Smart Call Home.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

695

T Commands transport http proxy server

transport http proxy server

To configure the HTTP proxy server domain name server (DNS) name, IPv4 address, or IPv6 address, use the transport http proxy server command. transport http proxy server {ip-address | proxy-server-name} [port port-number]

Syntax Description

ip-address proxy-server-name port port-number

IPv4 or IPv6 address of the proxy server. DNS name of the proxy server. (Optional) Specifies the port number. The range is from 1 to 65535. The default port number is 8080.

Defaults

Disabled

Command Modes

Call home configuration mode (config-callhome)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 5.2(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure the HTTP proxy server DNS name, IPv4 address, or IPv6 address:
switch# configure terminal switch(config)# callhome switch(config-callhome)# transport http proxy server http://www.yoursite.com port 5050

Related Commands

Command transport http proxy enable show callhome transport

Description Enables Smart Call Home to send all HTTP messages through the HTTP proxy server. Displays the transport-related configuration for Smart Call Home.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

696

OL-25806-03

T Commands transport http use-vrf

transport http use-vrf

To configure the virtual routing and forwarding (VRF) instance used to send e-mail and other Call home messages over the Hypertext Transfer Protocol (HTTP), use the transport http use-vrf command. transport http use-vrf vrf-name

Syntax Description

vrf-name

Virtual routing and forwarding (VRF) name. The name can any alphanumeric string up to 255 characters.

Defaults

None

Command Modes

Call home configuration

SupportedUserRoles

network-admin vdc-admin

Command History

Release 5.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure a VRF to send Call home messages using HTTP:
switch(config)# callhome switch(config-callhome)# transport http use-vrf Blue switch(config-callhome)#

Related Commands

Command transport email mail-server

Description Configures multiple SMTP servers as the domain name server (DNS) names, IPv4 addresses, or IPv6 addresses for Call home.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

697

T Commands transport udp

transport udp
To configure a NetFlow exporter to transport over UDP, use the transport udp command. To remove the transport configuration, use the no form of this command. transport udp port-number no transport udp [port-number]

Syntax Description

port-number

(Optional) Destination UDP port number.

Defaults

None

Command Modes

NetFlow exporter configuration (config-flow-exporter)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure a NetFlow exporter to transport over UDP:
switch(config)# flow exporter Netflow-Exporter-1 switch(config-flow-exporter)# transport udp 200 switch(config-flow-exporter)#

This example shows how to remove the UDP configuration:

switch(config-flow-exporter)# no transport udp 200 switch(config-flow-exporter)#

Related Commands

Command show flow exporter

Description Displays information about NetFlow exporters.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

698

OL-25806-03

V Commands
This chapter describes the Cisco NX-OS system management commands that begin with the letter V.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

699

V Commands verify

verify
To verify the commands in the configuration session, use the verify command. verify [verbose]

Syntax Description

verbose

(Optional) Verifies the current configuration session and displays more details on the results.

Defaults

None

Command Modes

Session configuration

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to verify a configuration session:

switch# configure session myACLs switch(config-s)# verify switch(config-s)#

Related Commands

Command commit abort

Description Commits the commands in the configuration session. Deletes the session and exists session configuration mode.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

700

OL-25806-03

V Commands version 5

version 5
To configure version 5 for the NetFlow exporter, use the version 5 command. To remove the version 5 configuration, use the no form of this command version 5 no version 5

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

NetFlow exporter configuration (config-flow-exporter)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

The default NetFlow exporter version is 5. If you remove the version 5 configuration, the NetFlow exporter defaults to version 9. This command does not require a license.

Examples

This example shows how to configure the NetFlow exporter version to version 5:
switch(config)# flow exporter Netflow-Exporter-1 switch(config-flow-exporter)# version 5 switch(config-flow-exporter-version-5)#

This example shows how to remove the version 5 configuration, which causes the NetFlow exporter to default to version 9:
switch(config-flow-exporter-version-5)# no version 5 switch(config-flow-exporter)#

Related Commands

Command show flow exporter version 9

Description Displays information about NetFlow exporters. Configures the NetFlow exporter to version 9.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

701

V Commands version 9

version 9
To specify the export version 9 and enter the export version configuration mode, use the version 9 command. version 9 no version 9

Syntax Description

This command has no arguments or keywords.

Defaults

Flow exporters are not present in the configuration until you create them.

Command Modes

Flow export configuration

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

Flow exporters export the data in the flow monitor cache to a remote system, such as a server running NetFlow collector, for analysis and storage. Flow exporters are created as separate entities in the configuration. Flow exporters are assigned to flow monitors to provide data export capability for the flow monitors. You can create several flow exporters and assign them to one or more flow monitors to provide several export destinations. You can create one flow exporter and apply it to several flow monitors. Once you enter the flow exporter configuration mode, the prompt changes to the following:
switch(config-flow-exporter)#

Within the flow exporter configuration mode, you can enter the version 9 keywords. Once you enter the version 9 keywords, the prompt changes to the following:
switch(config-flow-exporter-version-9)#

When entering the no form of this command, the seconds argument is optional. This command does not require a license.

Examples

This example shows how to specify the name of the flow exporter that is created or modified.
switch(config)# flow exporter flow-export-test switch(config-flow-exporter)# version 9 switch(config-flow-exporter-version-9)#

Cisco Nexus 7000 Series NX-OS System Management Command Reference

702

OL-25806-03

V Commands version 9

This example shows how to specify the version 9 exporter statistics option templates and data:
switch(config)# flow exporter flow-export-test switch(config-flow-exporter)# version 9 switch(config-flow-exporter-version-9)# exporter-stats

This example shows how to specify the version 9 interface table option templates and data:
switch(config)# flow exporter flow-export-test switch(config-flow-exporter)# version 9 switch(config-flow-exporter-version-9)# interface-table

This example shows how to specify the version 9 interface table option templates and data:
switch(config)# flow exporter flow-export-test switch(config-flow-exporter)# version 9 switch(config-flow-exporter-version-9)# sampler-table

This example shows how to specify the option resend time in seconds:
switch(config)# flow exporter flow-export-test switch(config-flow-exporter)# version 9 switch(config-flow-exporter-version-9)# timeout 32

This example shows how to specify the data template:

switch(config)# flow exporter flow-export-test switch(config-flow-exporter)# version 9 switch(config-flow-exporter-version-9)# template data

Related Commands

Command flow exporter flow monitor flow record sampler

Description Creates a flow exporter. Creates a flow monitor. Creates a flow record. Creates a flow sampler.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

703

V Commands vrf

vrf
To configure a virtual routing and forwarding (VRF) instance for Encapsulated Remote Switched Port Analyzer (ERSPAN) traffic forwarding in both the source and destination, use the vrf command. vrf {vrf_name} | {[default | foo]}

Syntax Description

vrf_name default foo

Name of the VRF. The VRF name can be any case-sensitive, alphanumeric string up to 32 characters. (Optional) Specifies the VRF name as the default. (Optional) Specifies the VRF name as foo.

Defaults

None

Command Modes

config-erspan-src config-erspan-dst

SupportedUserRoles

network-admin network-operator

Command History

Release 5.1(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure a VRF instance for the ESRSPAN source:
switch# configure terminal switch(config)# monitor session 5 type erspan-source switch(config-erspan-src)# vrf default switch(config-erspan-src)#

This example shows how to configure a VRF instance for the ERSPAN destination:
switch# configure terminal switch(config)# monitor session 2 type erspan-destination switch(config-erspan-dst)# vrf default switch(config-erspan-dst)#

Cisco Nexus 7000 Series NX-OS System Management Command Reference

704

OL-25806-03

V Commands vrf

Related Commands

Command ip ttl monitor-session

Description Applies an access control group to an ERSPAN source session. Enters the monitor configuration mode for configuring an ERSPAN or SPAN session for analyzing traffic between ports.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

705

V Commands vrf

Cisco Nexus 7000 Series NX-OS System Management Command Reference

706

OL-25806-03

X Commands
This chapter describes the Cisco NX-OS system management commands that begin with the letter X.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

707

X Commands xml server max-session

xml server max-session

To configure the number of allowed XML server sessions, use the xml server max-session command. To reset the number to the default, use the no form of this command. xml server max-session max-sessions no xml server max-session max-sessions

Syntax Description

max-sessions

Maximum number of allowed XML server sessions. The range is from 1 to 8. The default is 8.

Defaults

The XML server sessions allowed is 8.

Command Modes

Global configuration mode (config)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure the number of allowed XML server sessions:
switch(config)# xml server max-session 4

This example shows how to reset the number of allowed XML server sessions to the default:
switch(config)# no xml server max-session 4

Related Commands

Command

Description

show xml server status Displays information about the status of the XML server.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

708

OL-25806-03

X Commands xml server terminate session

xml server terminate session

To terminate an XML server session, use the xml server terminate session command. xml server terminate session session_id

Syntax Description

session_id

Session number. The range is from 0 to 2147483647.

Defaults

None

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to terminate an XML server session:

switch(config)# xml server terminate session 3

Related Commands

Command

Description

show xml server status Displays information about the status of the XML server.

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

709

X Commands xml server timeout

xml server timeout

To configure the XML server session timeout, use the xml server timeout command. To reset the timeout to the default, use the no form of this command. xml server timeout timeout [session_id] no xml server timeout timeout [session_id]

Syntax Description

timeout session_id

Timeout in seconds. The range is from 0 to 1200. The default is 1200. (Optional) XML server session number. The range is from 0 to 2147483647.

Defaults

The timeout is 1200 seconds.

Command Modes

Global configuration mode (config)

SupportedUserRoles

network-admin vdc-admin

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

You can apply the XML server timeout only to active sessions. This command does not require a license.

Examples

This example shows how to configure the XML server timeout for active sessions:
switch(config)# xml server timeout 800

This example shows how to reset the timeout to the default:

switch(config)# no xml server timeout 800

Cisco Nexus 7000 Series NX-OS System Management Command Reference

710

OL-25806-03

X Commands xml server validate

xml server validate

To validate XML documents, use the xml server validate command. To disable XML document validation, use the no form of this command. xml server validate {all | session_id} no xml server validate {all | session_id}

Syntax Description

all session_id

Validates all sessions. Session number. The range is from 0 to 2147483647.

Defaults

Disabled

Command Modes

Any command mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 4.0(1)

Modification This command was introduced.

Usage Guidelines

You can validate XML documents only for active sessions. This command does not require a license.

Examples

This example shows how to validate XML documents for all active sessions:
switch(config)# xml server validate all

This example shows how to disable validation of XML documents for all sessions:
switch(config)# no xml server validate all

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

711

X Commands xmlin

xmlin
To install the XMLIN tool on the device and generate equivalent Network Configuration (NETCONF) formats of all CLI commands entered in this mode, use the xmlin command. xmlin

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

EXEC mode

SupportedUserRoles

network-admin network-operator vdc-admin vdc-operator

Command History

Release 6.2(2)

Modification This command was introduced.

Usage Guidelines

The XMLIN tool converts CLI commands to the NETCONF protocol format. NETCONF is a network management protocol that provides mechanisms to install, manipulate, and delete the configuration of network devices. It uses XML-based encoding for configuration data and protocol messages. The Cisco NX-OS implementation of the NETCONF protocol supports the following protocol operations: <get>, <edit-config>, <close-session>, <kill-session>, and <exec-command>. The XMLIN tool converts show, EXEC, and configuration commands to corresponding NETCONF <get>, <exec-command>, and <edit-config> requests. You can enter multiple configuration commands into a single NETCONF <edit-config> instance. Note the following restrictions:

In NETCONF, <edit-config> requests cannot consist of any show commands. In each <get-config> instance, only one show command is allowed.

Note

Although the XMLIN tool is usually capable of generating NETCONF instances of commands even if the corresponding feature sets or the required hardware capabilities are not available on the device, you might have to install some feature sets before entering the xmlin command. The XMLIN tool also converts the output of show commands to XML format by using the show-command | xmlin command. Ensure the XMLIN tool is installed before you use the show-command | xmlin command.

Cisco Nexus 7000 Series NX-OS System Management Command Reference

712

OL-25806-03

X Commands xmlin

Note

XMLIN requires no license. Any feature not included in a license package is bundled with the Cisco NX-OS system images and is provided at no extra charge to you. For a complete explanation of the Cisco NX-OS licensing scheme, see the Cisco NX-OS Licensing Guide.

Examples

This example shows how the XMLIN tool is installed on the device and used to convert a set of configuration commands to an <edit-config> instance:
switch# xmlin ****************************************** Loading the xmlin tool. Please be patient. ****************************************** Cisco Nexus Operating System (NX-OS) Software TAC support: http://www.cisco.com/tac Copyright ) 2002-2013, Cisco Systems, Inc. All rights reserved. The copyrights to certain works contained in this software are owned by other third parties and used and distributed under license. Certain components of this software are licensed under the GNU General Public License (GPL) version 2.0 or the GNU Lesser General Public License (LGPL) Version 2.1. A copy of each such license is available at http://www.opensource.org/licenses/gpl-2.0.php and http://www.opensource.org/licenses/lgpl-2.1.php switch(xmlin)# configure terminal Enter configuration commands, one per line. End with CNTL/Z. switch(config)(xmlin)# interface ethernet 2/1 % Success switch(config-if-verify)(xmlin)# cdp enable % Success switch(config-if-verify)(xmlin)# end <?xml version="1.0"?> <nf:rpc xmlns:nf="urn:ietf:params:xml:ns:netconf:base:1.0" xmlns="http://www.cisco.com/nxos:6.2.2.:configure_" xmlns:m="http://www.cisco.com/nxos:6.2.2.:_exec" xmlns:m1="http://www.cisco.com/nxos:6.2.2.:configure__if-eth-base" message-id="1"> <nf:edit-config> <nf:target> <nf:running/> </nf:target> <nf:config><nf:running/> </nf:target> <nf:config> <m:configure> <m:terminal> <interface> <__XML__PARAM__interface> <__XML__value>Ethernet2/1</__XML__value> <m1:cdp> <m1:enable/> </m1:cdp> </__XML__PARAM__interface> </interface> </m:terminal> </m:configure> </nf:config> </nf:edit-config> </nf:rpc> ]]>]]>

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

713

X Commands xmlin

This example shows how to convert the output of the show interface brief command to XML:
switch# show interface brief | xmlin <?xml version="1.0"?> <nf:rpc xmlns:nf="urn:ietf:params:xml:ns:netconf:base:1.0" xmlns="http://www.cisco.com/nxos:6.2.2.:if_manager" message-id="1"> <nf:get> <nf:filter type="subtree"> <show> <interface> <brief/> </interface> </show> </nf:filter> </nf:get> </nf:rpc> ]]>]]>

Cisco Nexus 7000 Series NX-OS System Management Command Reference

714

OL-25806-03

System Message Logging Facilities

Table A-1 lists the facilities that you can use in system message logging configuration.
Table A-1 System Message Logging Facilities

Facility aaa acllog aclmgr adjmgr all amt arbiter arp ascii-cfg auth authpriv bfd_app bgp bootvar callhome capability cdp cfs clis cmpproxy copp core cron cts daemon

Description AAA manager ACL log manager ACL manager Adjacency manager Keyword that represents all facilities AMT manager Arbiter manager ARP manager ASCII configuration Authorization system Private authorization system Bidirectional Forwarding Detection (BFD) BGP manager Bootvar Call home manager MIG utilities daemon CDP manager Cisco Fabric Services (CFS) CLIS manager CMP proxy manager CoPP manager Core daemon Cron and at scheduling service CTS manager System daemons

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

715

System Message Logging Facilities

Table A-1

System Message Logging Facilities (continued)

Facility dcbx device_test dhcp_snoop diagclient diagmgr dot1x eigrp eltm eou ethdstats ethpm evmc evms feature-mgr fs-daemon ftp glbp hsrp_engine im interface-vlan ip igmp ip msdp ip pim ipconf ipqos ipv6 icmp ipv6 pim isis kernel keystore l2fm l3vm lacp license lisp local0

Description Discovery protocol manager GOLD Device Test DHCP snooping GOLD diagnostic client manager GOLD diagnostic manager 802.1X manager EIGRP manager ELTM manager EOU manager Delta statistics manager Ethernet PM manager EVMC manager EVMS manager Feature manager Fs daemon File transfer system GLBP manager HSRP manager IM manager VLAN interfaces (SVI) manager IGMP manager MSDP manager IPv4 PIM manager IP configuration manager IP QoS manager IPv6 ICMP IPv6 PIM IS-IS manager OS kernel Keystore manager L2 FM manager L3 VM manager LACP manager Licensing manager LISP manager Local use daemon

Cisco Nexus 7000 Series NX-OS System Management Command Reference

716

OL-25806-03

System Message Logging Facilities

Table A-1

System Message Logging Facilities (continued)

Facility local1 local2 local3 local4 local5 local6 local7 lpr mail mfdm module monitor mvsh netstack news nfm ntp ospf ospfv3 pfstat pixm platform pltfm_config plugin port-security port_lb private-vlan qengine radius res_mgr rip routing ipv6 multicast routing multicast rpm sal scheduler

Description Local use daemon Local use daemon Local use daemon Local use daemon Local use daemon Local use daemon Local use daemon Line printer system Mail system MFDM manager Module manager Ethernet SPAN manager MVSH manager IP/IPv6 network stack USENET news NFM manager NTP manager OSPF manager OSPF manager PFSTAT manager PIXM manager Platform manager PLTFM configuration manager Plug-in manager Port security manager Diagnostic port loopback test manager Private VLAN manager Q engine manager RADIUS manager Resource manager RIP manager IP, IPv4 multicast routing manager IPv6 multicast routing manager RPM manager SAL manager Scheduler

Cisco Nexus 7000 Series NX-OS System Management Command Reference OL-25806-03

717

System Message Logging Facilities

Table A-1

System Message Logging Facilities (continued)

Facility security session-mgr smm snmpd spanning-tree syslog sysmgr tacacs+ track tunnel u2 u6rib udld ufdm urib user uucp vdc_mgr vlan_mgr vmm vrrp_cfg vshd xbar_client xml server

Description Security manager Session manager Shared memory manager SNMP daemon STP manager Internal syslog manager System manager TACACS+ manager Track manager Tunnel manager U2 manager U6RIB manager UDLD manager UFDM manager URIB manager User process UNIX-to-UNIX copy system VDC manager VLAN manager VMM manager VRRP engine and configuration manager VSHD manager XBAR client manager XML agent

Cisco Nexus 7000 Series NX-OS System Management Command Reference

718

OL-25806-03