SFTOS CLI v2.1.4
SFTOS CLI v2.1.4
SFTOS CLI v2.1.4
Guide
Version 2.1.4
May 2005
100-00029-02
Trademarks
Copyright 2005 by Force10 Networks, Inc. All rights reserved. Force10, the Force10 logo, E1200, E600, E300, EtherScale, TeraScale and
FTOS are trademarks of Force10 Networks, Inc. All other brand and product names are registered trademarks or trademarks of their
respective holders.
Statement of Conditions
In the interest of improving internal design, operational function, and/or reliability, Force10 Networks reserves the right to make changes to
products described in this document without notice.
Force10 Networks does not assume any liability that may occur due to the use or application of the product(s) described herein.
USA
Federal Communications Commission (FCC) Statement
This equipment has been tested and found to comply with the limits for a Class A digital device, pursuant to Part 15 of the FCC rules. These
limits are designated to provide reasonable protection against harmful interference when the equipment is operated in a commercial
environment. This equipment generates, uses, and can radiate radio frequency energy. If it is not installed and used in accordance to the
instructions, it may cause harmful interference to radio communications.
Operation of this equipment in a residential area is likely to cause harmful interference, in which case users will be required to take whatever
measures necessary to correct the interference at their own expense.
This is Class A product based on the standard of the Voluntary Control Council For Interference by Information Technology Equipment
(VCCI). If this equipment is used in a domestic environment, radio disturbance may arise. When such trouble occurs, the user may be
required to take corrective actions.
Caution: This device is a Class A product. In a domestic environment, this device can cause radio
interference, in which case, the user may be required to take appropriate measures.
Contents
Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Chapter 1
About This Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Why the Document was Created . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
How to Use This Document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Objectives . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Addresses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Annotations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Special Characters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Related Documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Products and Services Liability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Contact and Patents Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Chapter 4
SFTOS Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Scope . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Chapter 5
Supported Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Chapter 6
Quick Start-up . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Quick Starting the Switch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
System Info and System Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Physical Port Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
User Account Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
IP Address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
Uploading from Switch to Out-of-Band PC (Only XMODEM) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Downloading from Out-of-Band PC to Switch (Only XMODEM) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Downloading from TFTP Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
Factory Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
Chapter 7
Stacking Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Dedicated-port Stacking . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
show switch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
show switch [unit] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
show supported switchtype . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
show supported switchtype [switchindex] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
member . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
stack . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
switch priority . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
switch renumber . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
movemanagement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
archive copy-sw . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
archive download-sw . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
Slot and Card Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
slot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
set slot disable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
set slot power . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
show slot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
show slot <unit/slot/port> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
show supported cardtype . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
show supported cardtype [cardindex] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Reset and Port Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
reload . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Front Panel Stacking . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
stack-port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
qos-mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
show stack-port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
show stack-port counters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
show stack-port diag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Chapter 8
Using the Web Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Configuring for Web Access . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Web Page Layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Starting the Web Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Command Buttons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Chapter 9
Mode-based Command Line Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Mode-based Topology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
Mode-based Command Hierarchy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
No Form of a Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
Contents
Chapter 10
Switching Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
System Information and Statistics Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
show arp switch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
show eventlog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
show hardware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
show interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
show interface ethernet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
show logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
show mac-addr-table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
show msglog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
show running-config . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
show sysinfo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
snmp-server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
Chapter 11
System Management Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
telnet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
transport input telnet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
transport output telnet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
session-limit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
session-timeout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
bridge aging-time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
mtu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
network mac-address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
network mac-type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
network parms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
network protocol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
telnetcon maxsessions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
telnetcon timeout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
remotecon maxsessions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
remotecon timeout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
serial baudrate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
serial timeout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
set prompt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
show telnet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
show forwardingdb agetime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
show network . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
show telnetcon . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
show serial . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
SNMP Community Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
show snmpcommunity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
show snmptrap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
show trapflags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
snmp-server community . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
no snmp-server community . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
snmp-server community ipaddr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
snmp-server community mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
snmp-server community ro . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
snmp-server community rw . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
snmp-server enable traps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
snmp-server enable traps bcaststorm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
snmp-server enable traps multiusers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
snmp-server enable traps stpmode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
snmptrap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
snmptrap ipaddr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
snmptrap mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
telnet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
snmp trap link-status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
snmp trap link-status all . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
Management VLAN Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
network mgmt_vlan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
Chapter 12
System Configuration Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
addport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
auto-negotiate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
auto-negotiate all . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
deleteport (interface config) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
deleteport (global config) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
monitor session mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
monitor session 1 source interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
no monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
no monitor session 1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
show monitor session 1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
shutdown . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
shutdown all . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
speed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
storm-control broadcast . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
storm-control flowcontrol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
show mac-address-table multicast . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
show mac-address-table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
show monitor session 1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .110
show port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .110
Contents
Chapter 13
System Log. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
logging buffered . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
logging buffered wrap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
logging console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
logging persistent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
logging host . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
logging host remove . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
logging port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
logging syslog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
show logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
show logging persistent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
show logging buffered . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
show logging hosts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
Chapter 14
User Account Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
disconnect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
show loginsession . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
show users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
users name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
users passwd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139
users snmpv3 accessmode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139
users snmpv3 authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139
users snmpv3 encryption . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
Chapter 15
SNTP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
sntp broadcast client poll-interval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
sntp client mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
sntp client port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
sntp unicast client poll-interval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
sntp unicast client poll-timeout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
sntp unicast client poll-retry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
Contents
Chapter 16
DHCP Server Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
client-identifier . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
client-name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
default-router . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
dns-server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
hardware-address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
host . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
ip dhcp excluded-address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
ip dhcp ping packets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
ip dhcp pool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
lease . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
network . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
service dhcp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
bootfile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
domain-name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
ip dhcp bootp automatic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
ip dhcp conflict logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
netbios-name-server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
netbios-node-type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
next-server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
show ip dhcp binding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
show ip dhcp global configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
show ip dhcp pool configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156
show ip dhcp server statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156
show ip dhcp conflict . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
clear ip dhcp binding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
clear ip dhcp server statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
clear ip dhcp conflict . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
Chapter 17
Double VLAN Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
dvlan-tunnel etherType . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
mode dot1q-tunnel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
mode dvlan-tunnel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160
show dot1q-tunnel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160
Chapter 18
Provisioning (IEEE 802.1p) Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
classofservice dot1pmapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
show classofservice dot1pmapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
vlan port priority all . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
vlan priority . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
Chapter 19
GARP Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165
set garp timer join . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165
set garp timer join all . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165
set garp timer leave . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
set garp timer leave all . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167
set garp timer leaveall . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167
set garp timer leaveall all . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168
show garp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168
GARP VLAN Registration Protocol (GVRP) Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
set gvrp adminmode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
set gvrp interfacemode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
set gvrp interfacemode all . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
show gvrp configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
GARP Multicast Registration Protocol (GMRP) Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
set gmrp adminmode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
set gmrp interfacemode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
set gmrp interfacemode all . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172
show gmrp configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172
show mac-address-table gmrp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
Chapter 20
IGMP Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175
set igmp (system) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
set igmp (interface) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
set igmp groupmembershipinterval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
set igmp interfacemode all . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
set igmp maxresponse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
set igmp mcrtrexpiretime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178
show igmpsnooping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178
show mac-address-table igmpsnooping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179
set igmp groupmembershipinterval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179
10
Contents
Chapter 21
Link Aggregation (LAG)/Port-Channel (802.1AD) Commands. . . . . . . . . . . . . . . . . . . . . . 187
port-channel staticcapability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187
port lacpmode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187
port lacpmode all . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188
port-channel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188
port-channel adminmode all . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188
port-channel linktrap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
port-channel name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
show port-channel brief . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
show port-channel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190
show port-channel summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191
Chapter 22
Spanning Tree (STP) Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193
spanning-tree . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193
spanning-tree configuration name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194
spanning-tree configuration revision . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194
spanning-tree edgeport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194
spanning-tree forceversion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
spanning-tree forward-time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
spanning-tree hello-time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
spanning-tree max-age . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196
spanning-tree mst . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196
no spanning-tree mst . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197
spanning-tree mst instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198
spanning-tree mst priority . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198
spanning-tree mst vlan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199
spanning-tree port mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199
spanning-tree port mode all . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199
spanning-tree . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200
11
Chapter 23
Security Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207
Port Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207
port-security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207
port-security max-dynamic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208
port-security max-static . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208
port-security mac-address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208
port-security mac-address move . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209
snmp-server enable traps violation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209
show port-security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209
show port-security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
show port-security dynamic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
show port-security static . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
show port-security violation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .211
Port Based Network Access Control (IEEE 802.1X) Commands . . . . . . . . . . . . . . . . . . . . . . . . . . .211
authentication login . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .211
clear dot1x statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212
clear radius statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212
dot1x defaultlogin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212
dot1x initialize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213
dot1x login . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213
dot1x max-req . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213
dot1x port-control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214
dot1x port-control All . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214
dot1x re-authenticate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215
dot1x re-authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215
dot1x system-auth-control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215
dot1x timeout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216
dot1x user . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217
show accounting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217
show authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218
show authentication users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218
12
Contents
Chapter 24
Quality of Service (QoS) Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
Access Control List (ACL) Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
mac access-list extended . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234
mac access-list extended rename . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234
{deny|permit} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235
mac access-group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235
show mac access-list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236
show mac access-lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237
access-list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237
ip access-group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238
ip access-group all . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238
show ip access-lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239
13
Chapter 25
Differentiated Services (DiffServ) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241
Class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241
Policy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241
Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241
diffserv . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242
Class Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243
class-map . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243
class-map rename . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244
match ethertype . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244
match any . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244
match class-map . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245
match cos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245
match destination-address mac . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246
match dstip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246
match dstl4port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246
match ip dscp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247
match ip precedence . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247
match ip tos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248
match protocol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248
match source-address mac . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249
match srcip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249
match srcl4port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249
match vlan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250
Policy Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250
assign-queue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251
drop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251
redirect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252
conform-color . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252
class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252
mark cos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253
mark ip-dscp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253
mark ip-precedence . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253
police-simple . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254
policy-map . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255
policy-map rename . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255
Service Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255
service-policy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256
Show Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257
show class-map . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257
show diffserv . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258
show policy-map . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259
show diffserv service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261
14
Contents
Chapter 26
Class of Service (CoS) Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265
classofservice dot1p-mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265
classofservice ip-dscp-mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265
classofservice ip-precedence-mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266
classofservice trust . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266
cos-queue min-bandwidth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266
cos-queue strict . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267
random-detect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267
random-detect exponential-weighting-constant . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267
random-detect queue-parms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268
tail-drop queue-parms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268
traffic-shape . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268
show classofservice dot1p-mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269
show classofservice ip-precedence-mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269
show classofservice trust . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270
show interfaces cos-queue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270
show interfaces random-detect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271
show interfaces tail-drop-threshold . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272
Chapter 27
Routing Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273
Address Resolution Protocol (ARP) Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273
arp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273
arp cachesize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274
ip proxy-arp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274
arp dynamicrenew . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274
arp purge . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275
arp resptime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275
arp retries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275
arp timeout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276
clear arp-cache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276
show arp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276
show arp brief . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277
IP Routing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278
routing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278
ip routing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278
ip address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279
ip route . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279
15
16
Contents
Chapter 28
OSPF Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299
enable (OSPF) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299
ip ospf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299
1583compatibility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300
area authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300
area default-cost . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300
area nssa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301
area nssa default-info-originate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301
area nssa no-redistribute (OSPF) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301
area nssa no-summary (OSPF) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301
area nssa translator-role (OSPF) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302
area nssa translator-stab-intv . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302
area range . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302
area stub . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303
area stub summarylsa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303
area virtual-link . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303
area virtual-link authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304
area virtual-link dead-interval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304
area virtual-link hello-interval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 305
area virtual-link retransmit-interval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 305
area virtual-link transmit-delay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 305
default-information originate (OSPF) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306
default-metric (OSPF) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306
distance ospf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307
distribute-list out . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307
exit-overflow-interval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307
external-lsdb-limit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308
ip ospf areaid . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308
ip ospf authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309
ip ospf cost . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309
ip ospf dead-interval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 310
ip ospf hello-interval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 310
ip ospf priority . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .311
ip ospf retransmit-interval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .311
ip ospf transmit-delay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312
ip ospf mtu-ignore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312
router-id . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312
redistribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313
maximum-paths . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313
17
Chapter 29
IP Multicast Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331
ip mcast boundary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331
ip multicast . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331
ip multicast staticroute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332
ip multicast ttl-threshold . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332
disable ip multicast mdebug mtrace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333
mrinfo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333
mstat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334
mtrace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334
no ip mcast mroute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335
18
Contents
Chapter 30
PIM-DM Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353
ip pimdm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353
ip pimdm mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353
ip pimdm query-interval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 354
show ip pimdm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 354
19
Glossary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 375
20
Contents
Chapter 1
This document describes configuration commands for SFTOS software. The commands can
be accessed from the CLI, Telnet, and web interface.
This chapter covers the following topics:
21
Chapter 4, SFTOS Overview introduces the SFTOS software at a very high level.
details the procedure to quickly become acquainted with the SFTOS software.
Chapter 9, Mode-based Command Line Interface describes the mapping between
the current CLI commands and the previous SFTOS commands.
Note: Refer to the release notes for the SFTOS application level code. The release
notes detail the platform specific functionality of the Switching, Routing, SNMP,
Config, Management, and Bandwidth Provisioning packages. The suite of features
supported by the SFTOS packages are not available on all the platforms to which
SFTOS has been ported.
Objectives
This document provides configuration instructions and examples for the S-Series. It includes
information on the protocols and features found in SFTOS. Background on networking
protocols is included to describe the capabilities of SFTOS.
For more complete information on protocols, refer to other documentation and IETF RFCs.
Audience
This document is intended for system administrators who are responsible for configuring or
maintaining networks. This guide assumes you are knowledgeable in Layer-2 and Layer-3
networking technologies.
Conventions
The Command Line Interface (CLI) syntax, conventions and terminology are described in
this section. Each CLI command referenced in this document is illustrated using the structure
outlined below.
This document uses the following conventions to describe command syntax:
22
Convention
Description
keyword
parameter
Parameters are in italics and require a number or word to be entered in the CLI. Also
shown in brackets: <parameter>
{X}
[X]
x|y
The command name is displayed in this document in bold font and must be typed exactly
as shown.
Once you have entered enough letters of a command name to uniquely identify the
command, hitting the space bar or Tab key will cause the system to complete the word.
Entering Ctrl-Z will return you to the root level command prompt.
Format
Some commands, such as show inventory or clear vlan, do not require parameters.
Other commands, such as network parms, have parameters for which you must supply a
value. Parameters are positional you must type the values in the correct order. Optional
parameters follow required parameters. For example:
network parms ipaddr netmask [gateway]
clear vlan
Parameters
23
{parameter}curly braces indicate that a parameter must be chosen from the list of
choices.
Values
ipaddrThis parameter is a valid IP address. Presently the IP address can be entered in
following formats:
a (32 bits)
a.b (8.24 bits)
a.b.c (8.8.16 bits)
a.b.c.d (8.8.8.8)
In addition to these formats, decimal, hexidecimal and octal formats are supported through
the following input formats (where n is any valid hexidecimal, octal or decimal number):
zeros)
macaddrThe MAC address format is six hexadecimal numbers separated by colons, for
example 00:06:29:32:81:40.
areaidArea IDs may be entered in dotted-decimal notation (for example, 0.0.0.1). An area
ID of 0.0.0.0 is reserved for the backbone. Area IDs have the same form as IP addresses, but
are distinct from IP addresses. The IP network number of the sub-netted network may be used
for the area ID.
routeridThe value of <router id> must be entered in 4-digit dotted-decimal notation (for
24
Addresses
Network addresses are used to define a link to a remote host, workstation or network.
Network addresses are shown using the following syntax:
Table 1 Network Address Syntax
Address Type
Format
Range
ipaddr
192.165.11.110
0.0.0.0 to 255.255.255.255
(decimal)
macaddr
A7:C9:89:DD:A9:B3
Double quotation marks such as "System Name with Spaces" set off user defined strings. If
the operator wishes to use spaces as part of a name parameter then it must be enclosed in
double quotation marks.
Empty strings () are not valid user defined strings.
Command completion finishes spelling the command when enough letters of a command are
typed to uniquely identify the command word. The command may be executed by typing
<enter> (command abbreviation) or the command word may be completed by typing the
<tab> or <space bar> (command completion).
The value 'Err' designates that the requested value was not internally accessible. This should
never happen and indicates that there is a case in the software that is not handled correctly.
The value of '-----' designates that the value is unknown.
Annotations
The CLI allows the user to type single-line annotations at the command prompt for use when
writing test or configuration scripts and for better readability. The exclamation point (!)
character flags the beginning of a comment. The comment flag character can begin a word
anywhere on the command line and all input following this character is ignored. Any
command line that begins with the character ! is recognized as a comment line and ignored
by the parser.
Some examples are provided below:
! Script file for displaying the ip interface
! Display information about interfaces
show ip interface 1/0/1 !Displays the information about the first interface
! Display information about the next interface
show ip interface 1/0/2
! End of the script file
25
Special Characters
Certain special key combinations speed up use of the CLI. They are listed in this section.
Also, help is available for the CLI by typing HELP:
DEL, BSdelete previous character
Ctrl-Ago to beginning of line
Ctrl-Ego to end of line
Ctrl-Fgo forward one character
Ctrl-Bgo backward one character
Ctrl-Ddelete current character
Ctrl-Hdisplay command history or retrieve a command
Ctrl-U, Xdelete to beginning of line
Ctrl-Kdelete to end of line
Ctrl-Wdelete previous word
Ctrl-Ttranspose previous character
Ctrl-Pgo to previous line in history buffer
Ctrl-Ngo to next line in history buffer
Ctrl-Zreturn to root command prompt
Tab, <SPACE>command-line completion
Exitgo to next lower command prompt
Related Documents
For more information about the Force10 Networks SFTOS software, refer to the S50
Hardware Installation Guide.
The Command Line Interface (CLI) syntax, conventions and terminology are described in
this section. Each CLI command referenced in this document is illustrated using the structure
outlined below.
26
program, or service that does not infringe on any of Force10 's intellectual property rights
may be used instead of the Force10 product, program, or service. Evaluation and verification
of operation in conjunction with other products, except those expressly designated by
Force10, are the user's responsibility.
27
28
Chapter 4
SFTOS Overview
Scope
SFTOS software encompasses both hardware and software support. SFTOS is partitioned to
run in the following processors:
CPU
This code runs the switch management portfolio and controls the overall switch
hardware. It also assists in frame forwarding, as needed and specified. This code is
designed to run on multiple platforms with minimal changes from platform to platform.
Switching processor
This code does the majority of the packet switching, usually at wire speed. This code is
platform dependent, and substantial changes may exist across products.
Overview
Fast Ethernet (FEN) and Gigabit Ethernet (GEN) switching continues to evolve from
high-end backbone applications to desktop switching applications. The price of the
technology continues to decline, while performance and feature sets continue to improve.
Devices that are capable of switching Layers 2, 3, and 4 are increasingly in demand. SFTOS
provides a flexible solution to these ever-increasing needs.
The exact functionality provided by each switch on which the SFTOS software base runs
varies depending upon the platform and requirements of Force10.
SFTOS provides the network administrator with a set of comprehensive management
functions for managing both SFTOS and the network. The network administrator has a choice
of three easy-to-use management methods:
SFTOS Command Line Interface Reference, Version 2.1.4
29
Web-based
VT100 interface
Note: When configuring a device by use of a configuration file, the maximum number of
configuration file command lines is 2000.
Each of the SFTOS management methods enables the network administrator to configure,
manage, and control SFTOS locally or remotely using in-band or out-of-band mechanisms.
Management is standards-based, with configuration parameters and a private MIB providing
control for functions not completely specified in the MIBs.
30
SFTOS Overview
Chapter 5
Supported Features
(*) Denotes Pre-Production Feature
Table 2 Supported Features (NOTE: Layer 3 Package includes all features of Layer 2 Package)
Features
Package Group
Hardware Features
48 GigE ports - Copper
Layer 2
Layer 2
Layer 2
Layer 2
1 Serial Port
Layer 2
Layer 3
Layer 3
Layer 3
Layer 2
Layer 2
Layer 2
Layer 2
IP (RFC 791)
Layer 2
Layer 2
Layer 2
Layer 3
Layer 3
Layer 2
Layer 2
Layer 2
31
Table 2 Supported Features (NOTE: Layer 3 Package includes all features of Layer 2 Package)
Features
Package Group
Layer 3
Layer 2
Layer 2
Layer 2
IEEE 802.3ad
Layer 2
Layer 2
Layer 2
Layer 3
QOS
Priority Queues
Layer 2 (*)
Layer 2 classification
Layer 2 (*)
Layer 2 (*)
Layer 3 DSCP
Layer 2 (*)
Layer 2 (*)
Layer 2 (*)
Layer 2 (*)
VLANS
Supported number of VLANs
Layer 2
Layer 2
Layer 2
Layer 2 (*)
Layer 2 (*)
Layer 2 (*)
Layer 3
Layer 3
Static Routes
Layer 3
32
Supported Features
Table 2 Supported Features (NOTE: Layer 3 Package includes all features of Layer 2 Package)
Features
Package Group
Multicast Protocols
IGMP v1/v2 (RFC 1112, 2236)
Layer 3
IGMP snooping
Layer 2 (*)
PIM-SM-edge
Layer 3
DVMRP
Layer 3
PIM-DM
Layer 3
Layer 2
Layer 2 (*)
Layer 2
RADIUS
Layer 2
IEEE 802.1x
Layer 2 (*)
Layer 2 (*)
Port Mirroring
Layer 2
Layer 2
DOS Protection
Layer 2
Layer 2 (*)
Management Features
Telnet (RFC 854)
Layer 2
SSHv2
Layer 2
Layer 2
Syslog
Layer 2
SNMP v1/v2c
Layer 2
RMON Groups
Layer 2
Layer 2
ECMP
Layer 3
Layer 2
SNTP
Layer 2
HTTPS/SSL
Layer 2
33
Table 2 Supported Features (NOTE: Layer 3 Package includes all features of Layer 2 Package)
Features
Package Group
Stacking
Stacking Multiple Unitsk
Layer 2
Layer 2
Layer 2
Layer 2
Auto configuration
Layer 2
34
Supported Features
Chapter 6
Quick Start-up
The CLI Quick Start-up chapter details procedures to quickly become acquainted with the
SFTOS software.
This chapter covers the following topics:
Quick Starting the Switch on page 35
System Info and System Setup on page 36
Physical Port Data on page 36
User Account Management on page 37
IP Address on page 37
Uploading from Switch to Out-of-Band PC (Only XMODEM) on page 39
Downloading from Out-of-Band PC to Switch (Only XMODEM) on page 39
Downloading from TFTP Server on page 40
Factory Defaults on page 40
35
Command Mode
Purpose
Privileged EXEC
Command Mode
Purpose
Privileged EXEC
unit/slot/port
Type - Indicates if the port is a special type of port
Admin Mode - Selects the Port Control
Administration State
Physical Mode - Selects the desired port speed and
duplex mode
Physical Status - Indicates the port speed and
duplex mode
Link Status - Indicates whether the link is up or
down
Link Trap - Determines whether or not to send a
trap when link status changes
LACP Mode - Displays whether LACP is enabled or
disabled on this port.
36
Quick Start-up
Command Mode
Purpose
show users
Privileged EXEC
show loginsession
User EXEC
Global Config
copy system:running-config
nvram:startup-config
Privileged EXEC
logout
IP Address
To view the network parameters the operator can access the device by the following three
methods.
Simple Network Management Protocol (SNMP)
Telnet
Web browser
SFTOS Command Line Interface Reference, Version 2.1.4
37
Command Syntax
Command Mode
Purpose
show network
User EXEC
network parms
Privileged EXEC
38
Quick Start-up
Command Mode
Purpose
copy
{nvram:startup-config |
nvram:errorlog |
nvram:msglog | nvram:traplog}
<tftp://<ip address>/>
Privileged EXEC
Command Mode
Purpose
Privileged EXEC
xmodem:filepath/fileName
For example:
If the user is using HyperTerminal, the user must
specify which file is to be sent to the switch.
The switch will restart automatically once the code
has been downloaded.
39
Command Mode
Purpose
Privileged EXEC
tftp://ipAddr/filepath/fileName.
The nvram:startup-config option downloads the
configuration file using tftp and system:image option
downloads the code file.
Factory Defaults
To help configure factory defaults, use the following commands:
Command Syntax
Command Mode
Purpose
clear config
Privileged EXEC
copy system:running-config
nvram:startup-config
Privileged EXEC
Privileged EXEC
40
Quick Start-up
41
42
Quick Start-up
Chapter 7
Stacking Commands
This chapter provides a detailed explanation of the Stacking commands. The following
Stacking commands are available in the SFTOS Platform.
Dedicated-port Stacking
This section provides detailed explanations of the dedicated-port stacking commands. The
commands are divided into two functional groups:
show switch
This command displays information about all units in the stack.
Syntax
Mode
show switch
User Exec
SwitchThis field displays the unit identifier assigned to the switch.
Management StatusThis field indicates whether the switch is the Primary Management Unit, a stack
member, or the status is unassigned.
Preconfigured Model IdentifierThis field displays the model identifier of a preconfigured switch ready
to join the stack. The Model Identifier is a 32-character field assigned by the device manufacturer to
identify the device.
Plugged-In Model IdentifierThis field displays the model identifier of the switch in the stack. Model
Identifier is a 32-character field assigned by the device manufacturer to identify the device.
Switch StatusThis field indicates the switch status. Possible values for this state are: OK, Unsup
ported, CodeMismatch, ConfigMismatch, or NotPresent.
43
Code TypeThis field indicates the detected version of code on this switch.
User Exec
SwitchThis field displays the unit identifier assigned to the switch.
Management StatusThis field indicates whether the switch is the Primary Management Unit a , stack
member, or the status is unassigned.
Hardware Management PreferenceThis field indicates the hardware management preference of the
switch. The hardware management preference can be disabled or unassigned.
Admin Management PreferenceThis field indicates the administrative management preference value
assigned to the switch. This preference value indicates how likely the switch is to be chosen as the
CODE TYPEPrimary Management Unit.
Switch TypeThis field displays the 32-bit numeric switch type.
Model IdentifierThis field displays the model identifier for this switch. Model Identifier is a 32-character
field assigned by the device manufacturer to identify the device.
Switch StatusThis field displays the switch status. Possible values are OK, Unsupported, Code
Mismatch, Config Mismatch, or Not Present.
Switch DescriptionThis field displays the switch description.
Expected Code TypeThis field indicates the expected code type.
Detected Code VersionThis field displays the version of code running on this switch. If the switch is
not present and the data is from pre-configuration, then the code version is None.
Detected Code in FlashThis field displays the version of code that is currently stored in FLASH
memory on the switch. This code will execute after the switch is reset. If the switch is not present and
the data is from pre-configuration, then the code version is None.
Up TimeThis field displays the system up time.
44
Stacking Commands
Syntax
Mode
User Exec
Switch Index (SID)This field displays the index into the database of supported switch types. This
index is used when preconfiguring a member to be added to the stack.
Model IdentifierThis field displays the model identifier for the supported switch type.
Management PreferenceThis field indicates the management preference value of the switch type.
Code TypeThis field displays the code load target identifier of the switch type.
User Exec
Switch TypeThis field displays the 32-bit numeric switch type for the supported switch.
Model IdentifierThis field displays the model identifier for the supported switch type.
Switch DescriptionThis field displays the description for the supported switch type.
member
This command configures a switch. The unit is the switch identifier of the switch to be
added/removed from the stack. The switchindex is the index into the database of the
supported switch types, indicating the type of the switch being preconfigured. The switch
index is a 32-bit integer. This command is executed on the Primary Management Unit.
The no version of this command removes a switch from the stack. The unit is the switch
identifier of the switch to be removed from the stack. This command is executed on the
Primary Management Unit.
Syntax
Mode
45
stack
stack
This command allows user to enter Config-stack mode.
Syntax
Mode
stack
Global Config
switch priority
This command configures the ability of a switch to become the Primary Management Unit.
The unit is the switch identifier. The value is the preference parameter that allows the user
to specify, priority of one backup switch over another. The range for priority is 1 to 15. The
switch with the highest priority value will be chosen to become the Primary Management
Unit if the active Primary Management Unit fails. The switch priority defaults to the
hardware management preference value 1. Switches that do not have the hardware capability
to become the Primary Management Unit are not eligible for management.
Default
enable
Syntax
Mode
Global Config
switch renumber
This command changes the switch identifier for a switch in the stack. The oldunit is the
current switch identifier on the switch whose identifier is to be changed. The newunit is the
updated value of the switch identifier. Upon execution, the switch is configured with the
configuration information for the new switch, if any. The old switch configuration
information is retained, however the old switch is operationally unplugged. This command is
executed on the Primary Management Unit.
Syntax
46
movemanagement
Mode
Global Config
movemanagement
This command moves the Primary Management Unit functionality from one switch to
another. The fromunit is the switch identifier on the current Primary Management Unit. The
tounit is the switch identifier on the new Primary Management Unit. Upon execution, the
entire stack (including all interfaces in the stack) will be unconfigured and reconfigured with
the configuration on the new Primary Management Unit. After the reload is complete, all
stack management capability must be performed on the new Primary Management Unit. To
preserve the current configuration across a stack move, execute the copyconfig command
before performing the stack move. A stack move will cause all routes and layer 2 addresses to
be lost. This command is executed on the Primary Management Unit. The administrator is
prompted to confirm the management move.
Syntax
Mode
archive copy-sw
This command replicates the STK file from the Primary Management Unit to the other
switch(es) in the stack. The code is loaded on the destination system unit, if specified,
otherwise the code is loaded on all switches in the stack. Switch(es) must be reset for the new
code to start running.
Syntax
Mode
archive download-sw
This command downloads the STK file to the switch. The url is the transfer mode. The
switch must be reset for the new code to start running.
Syntax
Mode
47
slot
slot
This command configures a slot in the system. The unit/slot/port is the slot identifier of the
slot. The cardindex is the index into the database of the supported card types, indicating the
type of the card being preconfigured in the specified slot. The card index is a 32-bit integer. If
a card is currently present in the slot that is unconfigured, the configured information will be
deleted and the slot will be re-configured with default information for the card.
The no version of this command removes configured information from an existing slot in the
system.
Syntax
Mode
Global Config
48
Stacking Commands
The no version of this command unconfigures the administrative mode of the slot(s). If all is
specified the command removes the configuration from all slots, otherwise the configuration
is removed from the slot identified by slot/port.
If a card or other module is present in the slot, this administrative mode removes the
configuration from the contents of the slot. If the slot is empty, this administrative mode
removes the configuration from any module inserted into the slot. If a card is disabled, all the
ports on the device are operationally disabled and shown as unplugged on management
screens.
Syntax
Mode
Global Config
Global Config
show slot
This command displays information about all the slots in the system.
49
Syntax
Mode
show slot
User Exec
SlotThis field displays the slot identifier in a slot/port format.
Slot StatusThis field indicates whether the slot is empty, full, or has encountered an error.
Admin StateThis field displays the slot administrative mode as enabled or disabled.
Power StateThis field displays the slot power mode as enabled or disabled.
Configured Card Model IdentifierThis field displays the model identifier of the card preconfigured in
the slot. Model Identifier is a 32-character field used to identify a card.
PluggableThis field indicates whether cards are pluggable or non-pluggable in the slot.
Power DownThis field indicates whether the slot can be powered down.
User Exec
SlotThis field displays the slot identifier. In a stacking environment this field is displayed in a unit/
slot/port format.
Slot StatusThis field indicates whether the slot is empty, full, or errored.
Admin StateThis field displays the slot administrative mode as enabled or disabled.
Power StateThis field displays the slot power mode as enabled or disabled.
Inserted Card Model IdentifierThis field displays the model identifier of the card inserted in the slot.
Model Identifier is a 32-character field used to identify a card. This field is displayed only if the slot is full.
Inserted Card DescriptionThis field displays the card description. This field is displayed only if the slot
is full.
Configured Card Model IdentifierThis field displays the model identifier of the card preconfigured in
the slot. Model Identifier is a 32-character field used to identify a card. This field is displayed only if the
slot is preconfigured.
Configured Card DescriptionThis field displays the card description. This field is displayed only if the
slot is preconfigured.
PluggableThis field indicates whether cards are pluggable or non-pluggable in the slot.
50
Stacking Commands
Power DownThis field indicates whether the slot can be powered down.
User Exec
Card Index (CID)This field displays the index into the database of the supported card types. This
index is used when preconfiguring a slot.
Card Model IdentifierThis field displays the model identifier for the supported card type.
User Exec
Card TypeThis field displays the 32-bit numeric card type for the supported card.
Model IdentifierThis field displays the model identifier for the supported card type.
Card DescriptionThis field displays the description for the supported card type.
reload
This command resets the entire stack or the identified [unit]. The administrator is prompted
to confirm that the reset should proceed.
51
stack-port
Syntax
reload [unit]
Mode
Global Config
stack-port
This command sets front panel stacking per port to either stack or ethernet mode.
Default
stack
Syntax
Mode
qos-mode
This command enables QOS mode for front panel stacking.
The no version of this command disables QOS mode for front panel stacking.
Default
enabled
Syntax
[no] qos-mode
Mode
52
Stacking Commands
show stack-port
show stack-port
This command displays summary stack-port information for all interfaces.
Syntax
Mode
show stack-port
Privileged Exec
QOS ModeFront Panel Stacking QOS Mode for all Interfaces
Privileged Exec
UnitUnit
InterfaceSlot/Port
Tx Data RateTrasmit data rate in megabits per second on the stacking port.
Tx Error RatePlatform-specific number of transmit errors per second.
Tx Total ErrorPlatform-specific number of total transmit errors since power-up.
Rx Data RateReceive data rate in megabits per second on the stacking port.
Rx Error RatePlatform-specific number of receive errors per second.
Rx Total ErrorsPlatform-specific number of total receive errors since power-up.
53
Privileged Exec
UnitUnit
InterfaceSlot/Port
Diagnostic Entry180 character string used for dianostics.
Diagnostic Entry80 character string used for dianostics.
Diagnostic Entry380 character string used for dianostics.
54
Stacking Commands
Chapter 8
This chapter is a brief introduction to the web. You can manage your switch through a Web
browser and Internet connection. This is referred to as Web-based management. To access the
switch, the Web browser must support:
This section explains how to access the switch Web-based management panels to configure
and manage the switch.
It is important to note that there are equivalent functions in the Web interface as in the
terminal interface (that is, there are usually the same menus to accomplish a task). For
example, when you log in, there is a Main Menu with the same functions available, and so on.
To terminate the Web login session, close the web browser.
There are several differences between the Web and terminal interfaces. For example, on the
Web interface the entire forwarding database can be displayed, and the terminal interface only
displays 10 entries starting at specified addresses.
This chapter covers the following topics:
55
1. Enter the IP address of the switch in the Web browser address field.
2. When the Login panel is displayed, enter the appropriate User Name and Password. The User Name and associated password are the same ones used for the terminal interface. Click on the Login button. The navigation tree is displayed in
Frame 2, and the System Description Menu is displayed in Frame 3.
3. Make your selection by clicking on the appropriate item in the navigation tree in
Frame 2.
Command Buttons
The following command buttons are used throughout the Web interface panels for the switch:
SaveImplements and saves the changes you just made. Some settings may require you to
reset the system in order for them to take effect.
RefreshThe Refresh button that appears next to the Apply button in Web interface panels
refreshes the data on the panel.
56
SubmitSend the updated configuration to the switch. Configuration changes take effect
immediately. These changes will not be retained across a power cycle unless a save is
performed.
57
58
Chapter 9
The Command Line Interface (CLI) groups all the commands in appropriate modes according
to the nature of the commands. Sample of the CLI command modes are described below.
Each of the command modes supports specific SFTOS software commands.
The Command Mode table captures the command modes, the prompts visible in that mode
and the exit method from that mode.
Table 3 Command Mode
Command Mode
Access Method
Prompt
Switch>
Privileged Exec
Mode
Switch#
VLAN Mode
Switch (Vlan) #
Global Config
Mode
Switch (Config)#
Interface Config
Mode
Switch (line) #
Switch
(Config-policy-map)#
Switch
(Config-policy-classma
p)#
Switch
(Config-classmap)#
59
Access Method
Prompt
Router OSPF
Config Mode
Switch
(Config-router)#
Switch
From the Global Config
mode, enter the router rip (Config-router)#
command
Bwprovisioning
Config Mode
Switch (Config-bwp)#
bwprovisioning
command.
Bwprovisioning Trafficclass Config
Mode
Switch
(Config-bwp-trafficcla
ss)#
Switch
(Config-dhcp-pool)#
pool <pool-name>
command.
Stack Global
Config Mode
Mode-based Topology
The CLI tree is built on a mode concept where the commands are available according to the
interface. Some of the modes are depicted in the mode-based CLI Figure 1.
60
ROOT
User Exec
Enable
No
Passwd
Correc
Correct
t
?
Yes
Privileged Exec
VLAN
Global Config
DHCP Pool
Bwprovisioning
Interface Config
Policy Map
Config
Router OSPF
Class Map
Line Config
Policy Class
Bwp
bwallocation
Config
Router RIP
Stacking
Config
Config
Access to all commands in the Privileged Exec mode and below are restricted through a
password.
61
The commands available to the operator at any point in time depend upon the mode. Entering
a question mark (?) at the CLI prompt, displays a list of the available commands and
descriptions of the commands.
The CLI provides the following modes:
User Exec ModeWhen the operator logs into the CLI, the User Exec mode is the initial mode. The
User Exec mode contains a limited set of commands. The command prompt shown at this level is:
Command Prompt: $#
VLAN ModeThis mode groups all the commands pertaining to VLANs. The command prompt shown
at this level is:
From the Global Config mode, the operator may enter the following configuration modes:
Interface Config ModeMany features are enabled for a particular interface. The Interface commands
enable or modify the operation of an interface.
In this mode, a physical port is set up for a specific logical connection operation. The Interface Config
mode provides access to the router interface configuration commands. The command prompt at this
level is:
The resulting prompt for the interface configuration command entered in the Global
Configuration mode is shown below:
$(Config)# interface 1/2/1
$(Interface 1/2/1)#+
Line Config ModeThis mode allows the operator to configure the console interface. The operator may
configure the interface from the directly connected console or the virtual terminal used with Telnet. The
command prompt at this level is:
62
Policy Map ModeUse the policy-map <policy-name>command to access the QoS policy map
configuration mode to configure the QoS policy map.
Class Map Mode:This mode consists of class creation/deletion and matching commands. The class
match commands specify layer 2, layer 3 and general match criteria. Use the class-map
class-map-name commands to access the QoS class map configuration mode to configure QoS class
maps.
Router OSPF Config Mode: In this mode, the operator is allowed to access the router OSPF
configuration commands. The command prompt at this level is:
Router RIP Config Mode: In this mode, the operator is allowed to access the router RIP configuration
commands. The command prompt at this level is:
Bwprovisioning Config ModeUse the bwprovisioning command to access the Bandwidth provisioning
Config Mode to configure bandwidth provisioning.
$(Config)# bwprovisioning
Command Prompt: $(Config-bwp)#
Bwprovisioning Trafficclass ModeUse the traffic-class command to access the Bandwidth provisioning
Config Mode to configure bandwidth traffic class.
63
MAC Access-List Config ModeUse the MAC Access-List Config mode to create a MAC access-List
and to enter the mode containing mac access-list configuration commands.
The operator logs into the CLI session and enters the User Exec mode. In the User Exec mode
the $(exec)> prompt is displayed on the screen.
The parsing process is initiated whenever the operator types a command and presses
<ENTER>. The command tree is searched for the command of interest. If the command is not
found, the output message indicates where the offending entry begins. For instance, command
node A has the command show arp brief but the operator attempts to execute the command
show arpp brief then the output message would be $(exec)> show arpp brief^.
$%Invalid input detected at '^' marker. If the operator has given an invalid input
parameter in the command, then the message conveys to the operator an invalid input was
detected. The layout of the syntax error message output is depicted below:
(exec) #show arpp brief
^
%Invalid input detected at ^ marker.
After all the mandatory parameters are entered, any additional parameters entered are treated
as optional parameters. If any of the parameters are not recognized a syntax error message
will be displayed.
1. After the command is successfully parsed and validated, the control of execution
goes to the corresponding CLI callback function.
2. For mandatory parameters, the command tree extends till the mandatory parameters make the leaf of the branch. The callback function is only invoked when all
the mandatory parameters are provided. For optional parameters, the command
tree extends till the mandatory parameters and the optional parameters make the
leaf of the branch. However, the call back function is associated with the node
where the mandatory parameters are fetched. The call back function then takes
care of the optional parameters.
3. Once the control has reached the callback function, the callback function has
complete information about the parameters entered by the operator.
64
No Form of a Command
No is a specific form of an existing command and does not represent a new or distinct
command. Only the configuration commands are available in the no form. The behavior
and the support details of the no form is captured as part of the mapping sheets.
65
66
Chapter 10
Switching Commands
This chapter provides detailed explanation of the Switching commands. The commands are
divided into five functional groups:
67
Privileged EXEC
MAC AddressA unicast MAC address for which the switch has forwarding and/or filtering information.
The format is 6 two-digit hexadecimal numbers that are separated by colons, for example
01:23:45:67:89:AB
IP AddressThe IP address assigned to each interface.
show eventlog
This command displays the event log, which contains error messages from the system. The
event log is not cleared on a system reset.
Syntax
show eventlog
Mode
Privileged EXEC
FileThe file in which the event originated.
68
Switching Commands
show hardware
show hardware
This command displays inventory information for the switch.
Syntax
show hardware
Mode
Privileged EXEC
Switch DescriptionText used to identify the product name of this switch.
Machine TypeSpecifies the machine model as defined by the Vital Product Data.
Machine ModelSpecifies the machine model as defined by the Vital Product Data.
Serial NumberThe unique box serial number for this switch.
FRU NumberThe field replaceable unit number.
Part NumberManufacturing part number.
Maintenance LevelIndicates hardware changes that are significant to software.
ManufacturerManufacturer descriptor field.
Burned in MAC AddressUniversally assigned network address.
Software VersionThe release.version.revision number of the code currently running on the switch.
Operating SystemThe operating system currently running on the switch.
Network Processing ElementThe type of the processor microcode.
Additional PackagesThis displays the additional packages that are incorporated into this system, such
as SFTOS Multicast.
69
show interface
show interface
This command displays a summary of statistics for a specific port or a count of all CPU traffic
based upon the argument.
Syntax
Mode
Privileged EXEC
The display parameters, when the argument is unit/slot/port, is as follows:
Packets Received Without ErrorThe total number of packets (including broadcast packets and
multicast packets) received by the processor.
Packets Received With ErrorThe number of inbound packets that contained errors preventing them
from being deliverable to a higher-layer protocol.
Broadcast Packets ReceivedThe total number of packets received that were directed to the broadcast
address. Note that this does not include multicast packets.
Packets Transmitted Without ErrorThe total number of packets transmitted out of the interface.
Transmit Packets ErrorsThe number of outbound packets that could not be transmitted because of
errors.
Collisions FramesThe best estimate of the total number of collisions on this Ethernet segment.
Time Since Counters Last ClearedThe elapsed time, in days, hours, minutes, and seconds since the
statistics for this port were last cleared.
The display parameters, when the argument is switchport, is as follows:
Packets Received Without ErrorThe total number of packets (including broadcast packets and
multicast packets) received by the processor.
Broadcast Packets ReceivedThe total number of packets received that were directed to the broadcast
address. Note that this does not include multicast packets.
Packets Received With ErrorThe number of inbound packets that contained errors preventing them
from being deliverable to a higher-layer protocol.
Packets Transmitted Without ErrorThe total number of packets transmitted out of the interface.
Broadcast Packets TransmittedThe total number of packets that higher-level protocols requested to
be transmitted to the Broadcast address, including those that were discarded or not sent.
Transmit Packet ErrorsThe number of outbound packets that could not be transmitted because of
errors.
Address Entries Currently In UseThe total number of Forwarding Database Address Table entries
now active on the switch, including learned and static entries.
VLAN Entries Currently In UseThe number of VLAN entries presently occupying the VLAN table.
Time Since Counters Last ClearedThe elapsed time, in days, hours, minutes, and seconds since the
statistics for this switch were last cleared.
70
Switching Commands
Privileged EXEC
The display parameters, when the argument is unit/slot/port, are as follows:
Packets Received
Octets ReceivedThe total number of octets of data (including those in bad packets) received on the
network (excluding framing bits but including Frame Check Sequence (FCS) octets). This object can be
used as a reasonable estimate of ethernet utilization. If greater precision is desired, the etherStatsPkts
and etherStatsOctets objects should be sampled before and after a common interval. ----- The result of
this equation is the value Utilization which is the percent utilization of the ethernet segment on a scale of
0 to 100 percent.
Packets Received < 64 OctetsThe total number of packets (including bad packets) received that were
< 64 octets in length (excluding framing bits but including FCS octets).
Packets Received 64 OctetsThe total number of packets (including bad packets) received that were
64 octets in length (excluding framing bits but including FCS octets).
Packets Received 65-127 OctetsThe total number of packets (including bad packets) received that
were between 65 and 127 octets in length inclusive (excluding framing bits but including FCS octets).
Packets Received 128-255 OctetsThe total number of packets (including bad packets) received that
were between 128 and 255 octets in length inclusive (excluding framing bits but including FCS octets).
Packets Received 256-511 OctetsThe total number of packets (including bad packets) received that
were between 256 and 511 octets in length inclusive (excluding framing bits but including FCS octets).
Packets Received 512-1023 OctetsThe total number of packets (including bad packets) received that
were between 512 and 1023 octets in length inclusive (excluding framing bits but including FCS octets).
Packets Received 1024-1518 OctetsThe total number of packets (including bad packets) received
that were between 1024 and 1518 octets in length inclusive (excluding framing bits but including FCS
octets).
Packets Received 1519-1522 OctetsThe total number of packets (including bad packets) received
that were between 1519 and 1522 octets in length inclusive (excluding framing bits but including FCS
octets).
Packets Received > 1522 OctetsThe total number of packets received that were longer than 1522
octets (excluding framing bits, but including FCS octets) and were otherwise well formed.
Packets Received
Successfully
71
Broadcast Packets ReceivedThe total number of good packets received that were directed to the
broadcast address. Note that this does not include multicast packets.
Packets
Received with
MAC Errors
TotalThe total number of inbound packets that contained errors preventing them from being
deliverable to a higher-layer protocol.
Jabbers ReceivedThe total number of packets received that were longer than 1518 octets (excluding
framing bits, but including FCS octets), and had either a bad Frame Check Sequence (FCS) with an
integral number of octets (FCS Error) or a bad FCS with a non-integral number of octets (Alignment
Error). Note that this definition of jabber is different than the definition in IEEE-802.3 section 8.2.1.5
(10BASE5) and section 10.3.1.4 (10BASE2). These documents define jabber as the condition where
any packet exceeds 20 ms. The allowed range to detect jabber is between 20 ms and 150 ms.
Fragments/Undersize ReceivedThe total number of packets received that were less than 64 octets in
length (excluding framing bits but including FCS octets).
Alignment ErrorsThe total number of packets received that had a length (excluding framing bits, but
including FCS octets) of between 64 and 1518 octets, inclusive, but had a bad Frame Check Sequence
(FCS) with a non-integral number of octets.
Rx FCS ErrorsThe total number of packets received that had a length (excluding framing bits, but
including FCS octets) of between 64 and 1518 octets, inclusive, but had a bad Frame Check Sequence
(FCS) with an integral number of octets
OverrunsThe total number of frames discarded as this port was overloaded with incoming packets,
and could not keep up with the inflow.
Received Packets
not forwarded
TotalA count of valid frames received which were discarded (i.e. filtered) by the forwarding process.
Local Traffic FramesThe total number of frames dropped in the forwarding process because the
destination address was located off of this port.
802.3x Pause Frames ReceivedA count of MAC Control frames received on this interface with an
opcode indicating the PAUSE operation. This counter does not increment when the interface is
operating in half-duplex mode.
Unacceptable Frame TypeThe number of frames discarded from this port due to being an
unacceptable frame type.
VLAN Membership MismatchThe number of frames discarded on this port due to ingress filtering.
VLAN Viable DiscardsThe number of frames discarded on this port when a lookup on a particular
VLAN occurs while that entry in the VLAN table is being modified, or if the VLAN has not been
configured.
Multicast Tree Viable DiscardsThe number of frames discarded when a lookup in the multicast tree for
a VLAN occurs while that tree is being modified.
Reserved Address DiscardsThe number of frames discarded that are destined to an IEEE 802.1
reserved address and are not supported by the system.
Broadcast Storm RecoveryThe number of frames discarded that are destined for FF:FF:FF:FF:FF:FF
when Broadcast Storm Recovery is enabled.
CFI DiscardsThe number of frames discarded that have CFI bit set and the addresses in RIF are in
non-canonical format.
Upstream ThresholdThe number of frames discarded due to lack of cell descriptors available for that
packet's priority level.
72
Switching Commands
Packets
Transmitted
Octets
Total BytesThe total number of octets of data (including those in bad packets) received on the network
(excluding framing bits but including FCS octets). This object can be used as a reasonable estimate of
ethernet utilization. If greater precision is desired, the etherStatsPkts and etherStatsOctets objects
should be sampled before and after a common interval. ----Packets Transmitted 64 OctetsThe total number of packets (including bad packets) received that were
64 octets in length (excluding framing bits but including FCS octets).
Packets Transmitted 65-127 OctetsThe total number of packets (including bad packets) received that
were between 65 and 127 octets in length inclusive (excluding framing bits but including FCS octets).
Packets Transmitted 128-255 OctetsThe total number of packets (including bad packets) received
that were between 128 and 255 octets in length inclusive (excluding framing bits but including FCS
octets).
Packets Transmitted 256-511 OctetsThe total number of packets (including bad packets) received that
were between 256 and 511 octets in length inclusive (excluding framing bits but including FCS octets).
Packets Transmitted 512-1023 OctetsThe total number of packets (including bad packets) received
that were between 512 and 1023 octets in length inclusive (excluding framing bits but including FCS
octets).
Packets Transmitted 1024-1518 OctetsThe total number of packets (including bad packets) received
that were between 1024 and 1518 octets in length inclusive (excluding framing bits but including FCS
octets).
Packets Transmitted 1519-1522 OctetsThe total number of packets (including bad packets) received
that were between 1519 and 1522 octets in length inclusive (excluding framing bits but including FCS
octets).
Max InfoThe maximum size of the Info (non-MAC) field that this port will receive or transmit.
Packets
Transmitted
Successfully
TotalThe number of frames that have been transmitted by this port to its segment.
Unicast Packets TransmittedThe total number of packets that higher-level protocols requested be
transmitted to a subnetwork-unicast address, including those that were discarded or not sent.
Multicast Packets TransmittedThe total number of packets that higher-level protocols requested be
transmitted to a Multicast address, including those that were discarded or not sent.
Broadcast Packets TransmittedThe total number of packets that higher-level protocols requested be
transmitted to the Broadcast address, including those that were discarded or not sent.
Transmit Errors
Transmit
Discards
Total DiscardsThe sum of single collision frames discarded, multiple collision frames discarded, and
excessive frames discarded.
73
Single Collision FramesA count of the number of successfully transmitted frames on a particular
interface for which transmission is inhibited by exactly one collision.
Multiple Collision FramesA count of the number of successfully transmitted frames on a particular
interface for which transmission is inhibited by more than one collision.
Excessive CollisionsA count of frames for which transmission on a particular interface fails due to
excessive collisions.
Port MembershipThe number of frames discarded on egress for this port due to egress filtering being
enabled.
VLAN Viable DiscardsThe number of frames discarded on this port when a lookup on a particular
VLAN occurs while that entry in the VLAN table is being modified, or if the VLAN has not been
configured.
Protocol
Statistics
BPDU's receivedThe count of BPDU's (Bridge Protocol Data Units) received in the spanning tree
layer.
BPDU's TransmittedThe count of BPDU's (Bridge Protocol Data Units) transmitted from the spanning
tree layer.
802.3x Pause Frames ReceivedA count of MAC Control frames received on this interface with an
opcode indicating the PAUSE operation. This counter does not increment when the interface is
operating in half-duplex mode.
GVRP PDU's ReceivedThe count of GVRP PDU's received in the GARP layer.
GVRP PDU's TransmittedThe count of GVRP PDU's transmitted from the GARP layer.
GVRP Failed RegistrationsThe number of times attempted GVRP registrations could not be
completed.
GMRP PDU's receivedThe count of GMRP PDU's received in the GARP layer.
GMRP PDU's TransmittedThe count of GMRP PDU's transmitted from the GARP layer.
GMRP Failed RegistrationsThe number of times attempted GMRP registrations could not be
completed.
STP BPDUs TransmittedSpanning Tree Protocol Bridge Protocol Data Units sent
STP BPDUs ReceivedSpanning Tree Protocol Bridge Protocol Data Units received
RST BPDUs TransmittedRapid Spanning Tree Protocol Bridge Protocol Data Units sent
RSTP BPDUs ReceivedRapid Spanning Tree Protocol Bridge Protocol Data Units received
MSTP BPDUs TransmittedMultiple Spanning Tree Protocol Bridge Protocol Data Units sent
MSTP BPDUs ReceivedMultiple Spanning Tree Protocol Bridge Protocol Data Units received
Dot1x Statistics
EAPOL Frames Received The number of valid EAPOL frames of any type that have been received
by this authenticator.
EAPOL Frames TransmittedThe number of EAPOL frames of any type that have been transmitted by
this authenticator.
74
Switching Commands
Time Since Counters Last ClearedThe elapsed time, in days, hours, minutes, and seconds since the
statistics for this port were last cleared.
75
show logging
VLAN DeletesThe number of VLANs on this switch that have been created and then deleted since the
last reboot.
Time Since Counters Last ClearedThe elapsed time, in days, hours, minutes, and seconds, since the
statistics for this switch were last cleared.
show logging
This command displays the trap log maintained by the switch. The trap log contains a
maximum of 256 entries that wrap.
Syntax
Mode
show logging
Privileged EXEC
Number of Traps since last resetThe number of traps that have occurred since the last reset of this
device.
Number of Traps since log last displayedThe number of traps that have occurred since the traps were
last displayed. Getting the traps by any method (terminal interface display, Web display, upload file from
switch etc.) will result in this counter being cleared to 0.
LogThe sequence number of this trap.
System Up TimeThe relative time since the last reboot of the switch at which this trap occurred.
TrapThe relevant information of this trap.
show mac-addr-table
This command displays the forwarding database entries. If the command is entered with no
parameter, the entire table is displayed. This is the same as entering the optional all
parameter. Alternatively, the administrator can enter a MAC Address to display the table
entry for the requested MAC address and all entries following the requested MAC address.
Syntax
Mode
Privileged EXEC
Mac AddressA unicast MAC address for which the switch has forwarding and or filtering information.
The format is 6 or 8 two-digit hexadecimal numbers that are separated by colons, for example
01:23:45:67:89:AB. In a system the MAC address will be displayed as 8 bytes.
76
Switching Commands
show msglog
show msglog
This command displays the message log maintained by the switch. The message log contains
system trace information.
The trap log contains a maximum of 256 entries that wrap.
Syntax
Mode
Message
show msglog
Privileged EXEC
The message that has been logged.
Note: Message log information is not retained across a switch reset.
show running-config
This command is used to display/capture the current setting of different protocol packages
supported on switch. This command displays/captures only commands with settings/
configurations with values that differ from the default value. The output is displayed in script
format, which can be used to configure another switch with the same configuration.
SFTOS Command Line Interface Reference, Version 2.1.4
77
show sysinfo
When a script name is provided, the output is redirected to a configuration script. The option
[all] will also enable the display/capture of all commands with settings/configurations that
include values that are same as the default values. If the optional <scriptname> is provided
with a file name extension of .scr, the output will be redirected to a script file.
Syntax
Mode
Privileged EXEC
If static capability is enabled:
port-channel staticcapabilityThe device has static capability enabled.
show sysinfo
This command displays switch information.
Syntax
Mode
show sysinfo
Privileged EXEC
Switch DescriptionText used to identify this switch.
System NameName used to identify the switch.
System LocationText used to identify the location of the switch. May be up to 31 alpha-numeric
characters. The factory default is blank.
System ContactText used to identify a contact person for this switch. May be up to 31 alpha-numeric
characters. The factory default is blank.
System ObjectIDThe base object ID for the switchs enterprise MIB.
System Up TimeThe time in days, hours and minutes since the last switch reboot.
MIBs SupportedA list of MIBs supported by this agent.
snmp-server
This command sets the name and the physical location of the switch, and the organization
responsible for the network.The range for name, location and contact is from 1 to 31
alphanumeric characters.
Default
78
None
Switching Commands
snmp-server
Syntax
Mode
Global Config
79
snmp-server
80
Switching Commands
Chapter 11
System Management
Commands
These commands manage the switch and show current management settings. The commands
are divided into two functional groups:
telnet on page 82
transport input telnet on page 82
transport output telnet on page 83
session-limit on page 83
bridge aging-time on page 84
mtu on page 84
network mac-address on page 85
network mac-type on page 85
network parms on page 86
network protocol on page 86
telnetcon maxsessions on page 86
telnetcon timeout on page 87
remotecon maxsessions on page 87
remotecon timeout on page 88
serial baudrate on page 88
serial timeout on page 88
set prompt on page 89
show forwardingdb agetime on page 90
show network on page 90
show telnetcon on page 91
show serial on page 91
show snmpcommunity on page 92
show snmptrap on page 93
81
telnet
telnet
This command establishes a new outbound telnet connection to a remote host. The host value
must be a valid IP address. Valid values for port should be a valid decimal integer in the range
of 0 to 65535, where the default value is 23. If [debug] is used, the current telnet options
enabled is displayed. The optional line parameter sets the outbound telnet operational mode
as linemode, where by default, the operational mode is character mode. The noecho option
disables local echo.
Syntax
Modes
82
The no version of this command disables telnet sessions. If sessions are disabled, no new
telnet sessions are established.
Default
enabled
Syntax
Mode
Line Config
enabled
Syntax
Mode
Line Config
session-limit
This command specifies the maximum number of simultaneous outbound telnet sessions. A
value of 0 indicates that no outbound telnet session can be established.
The no version of this command sets the maximum number of simultaneous outbound telnet
sessions to the default value.
Default
Syntax
session-limit <0-5>
Mode
Line Config
83
session-timeout
session-timeout
This command sets the outbound telnet session timeout value.The timeout value unit of time
is minutes. A value of 0 indicates that a session remains active indefinitely.
The no version of this command sets the outbound telnet session timeout value to the default.
The timeout value unit of time is minutes.
Default
Syntax
Mode
Line Config
bridge aging-time
This command configures the forwarding database address aging timeout in seconds. In an
system, the [fdbid | all] parameter is required.
The no version of this command sets the forwarding database address aging timeout to 300
seconds. In a system, the [all] parameter is required.
Default
300
Syntax
Mode
Global Config
SecondsThis parameter must be within the range of 10 to 1,000,000 seconds.
Forwarding Database IDFdbid (Forwarding database ID) indicates which forwarding database's aging
timeout is being configured.
allUsed to configure all forwarding database's agetime.
mtu
This command sets the maximum transmission unit (MTU) size (in bytes) for physical and
port-channel (LAG) interfaces. For the standard implementation, the range of <mtusize> is a
valid integer between 1518-9216.
84
network mac-address
The no version of this command sets the default maximum transmission unit (MTU) size (in
bytes) for the interface.
Default
1518
NOTE: The hardware on the 1 Gig ports automatically compensates for the tags on tagged
packets. For a 1 Gig port, the default setting of 1518, allows 1518 byte untagged and 1522
byte tagged packets. Likewise, set to the maximum, a setting of 9216 will allow for tagged
packets up to 9220 bytes.
10 Gig ports use a different chipset that does not automatically allow for the length of a tag.
For 10 Gig ports, the default setting of 1518 means 1518 untagged or tagged. The maximum
is 9216 bytes.
Syntax
Mode
mtu 1518-9216
Interface Config
network mac-address
This command sets locally administered MAC addresses. The following rules apply:
Syntax
Mode
Bit 6 of byte 0 (called the U/L bit) indicates whether the address is universally
administered (b'0') or locally administered (b'1').
Bit 7 of byte 0 (called the I/G bit) indicates whether the destination address is an
individual address (b'0') or a group address (b'1').
The second character, of the twelve character macaddr, must be 2, 6, A or E.
A locally administered address must have bit 6 On (b'1') and bit 7 Off (b'0').
Privileged EXEC
network mac-type
This command specifies whether the burned in MAC address or the locally-administered
MAC address is used.
The no version of this command resets the value of MAC address to its default.
Default
burnedin
85
network parms
Syntax
Mode
Privileged EXEC
network parms
This command sets the IP Address, subnet mask and gateway of the router. The IP Address
and the gateway must be on the same subnet.
Syntax
Mode
Privileged EXEC
network protocol
This command specifies the network configuration protocol to be used. If you modify this
value change is effective immediately. The parameter bootp indicates that the switch
periodically sends requests to a Bootstrap Protocol (BootP) server or a dhcp server until a
response is received. none indicates that the switch should be manually configured with IP
information.
Default
None
Syntax
Mode
Privileged EXEC
telnetcon maxsessions
This command specifies the maximum number of telnet connection sessions that can be
established. A value of 0 indicates that no telnet connection can be established. The range is 0
to 5.
The no version of this command sets the maximum number of telnet connection sessions that
can be established to the default value.
Default
86
5
System Management Commands
telnetcon timeout
Syntax
Mode
Privileged EXEC
telnetcon timeout
This command sets the telnet connection session timeout value, in minutes. A session is
active as long as the session has been idle for the value set. A value of 0 indicates that a
session remains active indefinitely. The time is a decimal value from 0 to 160.
The no version of this command sets the telnet connection session timeout value, in minutes,
to the default.
Note: Changing the timeout value for active sessions does not
become effective until the session is reaccessed. Any keystroke will
also activate the new timeout duration.
Default
Syntax
Mode
Privileged EXEC
remotecon maxsessions
This command specifies the maximum number of remote connection sessions that can be
established. A value of 0 indicates that no remote connection can be established. The range is
0 to 5.
The no version of this command sets the maximum number of remote connection sessions
that can be established to the default value.
Default
Syntax
Mode
Privileged EXEC
87
remotecon timeout
remotecon timeout
This command sets the remote connection session timeout value, in minutes. A session is
active as long as the session has been idle for the value set. A value of 0 indicates that a
session remains active indefinitely. The time is a decimal value from 0 to 160.
The no version of this command sets the remote connection session timeout value, in
minutes, to the default.
Note: Changing the timeout value for active sessions does not
become effective until the session is reaccessed. Any keystroke will
also activate the new timeout duration.
Default
Syntax
Mode
Privileged EXEC
serial baudrate
This command specifies the communication rate of the terminal interface. The supported
rates are 1200, 2400, 4800, 9600, 19200, 38400, 57600, 115200.
The no version of this command sets the communication rate of the terminal interface.
Default
9600
Syntax
serial baudrate {1200 | 2400 | 4800 | 9600 | 19200 | 38400 | 57600 | 115200}
no serial baudrate
Mode
Line Config
serial timeout
This command specifies the maximum connect time (in minutes) without console activity. A
value of 0 indicates that a console can be connected indefinitely. The time range is 0 to 160.
88
set prompt
The no version of this command sets the maximum connect time (in minutes) without
console activity.
Default
Syntax
Mode
Line Config
set prompt
This command changes the name of the prompt. The length of name may be up to 64
alphanumeric characters.
Syntax
Mode
Privileged EXEC
show telnet
This command displays the current outbound telnet settings.
Syntax
show telnet
Modes
89
All
Syntax
Mode
Privileged EXEC
Forwarding DB IDFdbid (Forwarding database ID) indicates the forwarding database whose aging
timeout is to be shown. The all option is used to display the aging timeouts associated with all
forwarding databases. This field displays the forwarding database ID in a system.
AgetimeIn an IVL system, this parameter displays the address aging timeout for the associated
forwarding database.
show network
This command displays configuration settings associated with the switch's network interface.
The network interface is the logical interface used for in-band connectivity with the switch
via any of the switch's front panel ports. The configuration parameters associated with the
switch's network interface do not affect the configuration of the front panel ports through
which traffic is switched or routed.
Syntax
Mode
show network
90
show telnetcon
MAC Address TypeSpecifies which MAC address should be used for in-band connectivity. The
choices are the burned in or the Locally Administered address. The factory default is to use the burned
in MAC address.
Network Configuration Protocol CurrentIndicates which network protocol is being used. The options
are bootp | dhcp | none.
Java ModeSpecifies if the switch should allow access to the Java applet in the header frame. Enabled
means the applet can be viewed. The factory default is disabled.
Management VLAN IDSpecifies the management VLAN ID.
show telnetcon
This command displays telnet settings.
Syntax
Mode
show telnetcon
show serial
This command displays serial communication settings for the switch.
Syntax
Mode
show serial
91
show snmpcommunity
show snmpcommunity
This command displays SNMP community information. Six communities are supported. You
can add, change, or delete communities. The switch does not have to be reset for changes to
take effect.
The SNMP agent of the switch complies with SNMP Version 1 (for more about the SNMP
specification, see the SNMP RFCs). The SNMP agent sends traps through TCP/IP to an
external SNMP manager based on the SNMP configuration (the trap receiver and other
SNMP community parameters).
Syntax
Mode
show snmpcommunity
Privileged EXEC
SNMP Community NameThe community string to which this entry grants access. A valid entry is a
case-sensitive alphanumeric string of up to 16 characters. Each row of this table must contain a unique
community name.
Client IP AddressAn IP address (or portion thereof) from which this device will accept SNMP packets
with the associated community. The requesting entity's IP address is ANDed with the Subnet Mask
before being compared to the IP Address. Note: that if the Subnet Mask is set to 0.0.0.0, an IP Address
of 0.0.0.0 matches all IP addresses. The default value is 0.0.0.0
Client IP MaskA mask to be ANDed with the requesting entity's IP address before comparison with IP
Address. If the result matches with IP Address then the address is an authenticated IP address. For
example, if the IP Address = 9.47.128.0 and the corresponding Subnet Mask = 255.255.255.0 a range
of incoming IP addresses would match, i.e. the incoming IP Address could equal 9.47.128.0 9.47.128.255. The default value is 0.0.0.0
Access ModeThe access level for this community string.
StatusThe status of this community access entry.
92
show snmptrap
show snmptrap
This command displays SNMP trap receivers. Trap messages are sent across a network to an
SNMP Network Manager. These messages alert the manager to events occurring within the
switch or on the network. Six trap receivers are simultaneously supported.
Syntax
Mode
show snmptrap
Privileged EXEC
SNMP Trap NameThe community string of the SNMP trap packet sent to the trap manager. This may
be up to 16 alphanumeric characters. This string is case sensitive.
IP AddressThe IP address to receive SNMP traps from this device. Enter four numbers between 0
and 255 separated by periods.
StatusIndicates the receiver's status (enabled or disabled).
show trapflags
This command displays trap conditions. Configure which traps the switch should generate by
enabling or disabling the trap condition. If a trap condition is enabled and the condition is
detected, the switch's SNMP agent sends the trap to all enabled trap receivers. The switch
does not have to be reset to implement the changes. Cold and warm start traps are always
generated and cannot be disabled.
Note: The DVMRP, OSPF, and PIM traps are not supported in the L2
image.
Syntax
show trapflags
Mode
Privileged EXEC
Authentication FlagMay be enabled or disabled. The factory default is enabled. Indicates whether
authentication failure traps will be sent.
Link Up/Down FlagMay be enabled or disabled. The factory default is enabled. Indicates whether link
status traps will be sent.
Multiple Users FlagMay be enabled or disabled. The factory default is enabled. Indicates whether a
trap will be sent when the same user ID is logged into the switch more than once at the same time
(either via telnet or serial port).
Spanning Tree FlagMay be enabled or disabled. The factory default is enabled. Indicates whether
spanning tree traps will be sent.
Broadcast Storm FlagMay be enabled or disabled. The factory default is enabled. Indicates whether
broadcast storm traps will be sent.
93
snmp-server community
DVMRP TrapsMay be enabled or disabled. The factory default is disabled. Indicates whether DVMRP
traps will be sent.
OSPF TrapsMay be enabled or disabled. The factory default is disabled. Indicates whether OSPF
traps will be sent.
PIM TrapsMay be enabled or disabled. The factory default is disabled. Indicates whether PIM traps
will be sent.
snmp-server community
This command adds (and names) a new SNMP community. A community name is a name
associated with the switch and with a set of SNMP managers that manage it with a specified
privileged level. The length of name can be up to 16 case-sensitive characters.
Note: Community names in the SNMP community table must be
unique. When making multiple entries using the same community
name, the first entry is kept and processed and all duplicate entries
are ignored.
Default
Two default community names: Public and Private. You can replace these default community
names with unique identifiers for each community. The default values for the remaining four
community names are blank.
Syntax
Mode
Global Config
no snmp-server community
This command removes this community name from the table. The name is the community
name to be deleted.
Syntax
Mode
94
Global Config
0.0.0.0
Syntax
Mode
Global Config
The default private and public communities are enabled by default. The four undefined
communities are disabled by default.
Syntax
Mode
Global Config
snmp-server community ro
This command restricts access to switch information. The access mode is read-only (also
called public).
SFTOS Command Line Interface Reference, Version 2.1.4
95
snmp-server community rw
Syntax
Mode
Global Config
snmp-server community rw
This command restricts access to switch information. The access mode is read/write (also
called private).
Syntax
Mode
enabled
Syntax
Mode
Global Config
enabled
Syntax
Mode
96
Global Config
System Management Commands
enabled
Syntax
Mode
Global Config
enabled
Syntax
Mode
Global Config
snmptrap
This command adds an SNMP trap name. The maximum length of name is 16 case-sensitive
alphanumeric characters.
The no version of this command deletes trap receivers for a community.
Default
The default name for the six undefined community names is Delete.
Syntax
Mode
Global Config
97
snmptrap ipaddr
snmptrap ipaddr
This command assigns an IP address to a specified community name. The maximum length of
name is 16 case-sensitive alphanumeric characters.
Note: IP addresses in the SNMP trap receiver table must be unique. If you make
multiple entries using the same IP address, the first entry is retained and processed.
All duplicate entries are ignored.
Syntax
Mode
Global Config
snmptrap mode
This command activates or deactivates an SNMP trap. Enabled trap receivers are active (able
to receive traps). Disabled trap receivers are inactive (not able to receive traps).
The no version of this command deactivates an SNMP trap. Disabled trap receivers are
inactive (not able to receive traps).
Syntax
Mode
Global Config
telnet
This command regulates new telnet sessions. If sessions are enabled, new telnet sessions can
be established until there are no more sessions available. If sessions are disabled, no new
telnet sessions are established. An established session remains active until the session is
ended or an abnormal network error ends it.
The no version of this command disables telnet sessions. If sessions are disabled, no new
telnet sessions are established.
Default
enabled
Syntax
[no] telnet
Mode
98
Privileged EXEC
Interface Config
Global Config
network mgmt_vlan
This command configures the Management VLAN ID.
Default
Syntax
99
network mgmt_vlan
Mode
100
Privileged EXEC
System Configuration
Commands
Chapter 12
This chapter provides a detailed explanation of the System configuration commands. The
commands are divided into two functional groups:
101
102
addport
addport
This command adds one port to the port-channel (LAG). The first interface is a logical unit,
slot and port slot and port number of a configured port-channel.
Note: Before adding a port to a port-channel, set the physical mode of the port. See
speed command.
Syntax
Mode
Interface Config
auto-negotiate
This command enables automatic negotiation on a port. The default value is enable.
The no version of this command disables automatic negotiation on a port.
Note: Automatic sensing is disabled when automatic negotiation is disabled.
Syntax
Mode
[no] auto-negotiate
Interface Config
auto-negotiate all
This command enables automatic negotiation on all ports. The default value is enable.
The no version of this command disables automatic negotiation on all ports.
Syntax
103
Mode
Global Config
Interface Config
Global Config
104
Default
disabled
Syntax
Mode
Global Config
None
Format
Mode
Global config
no monitor
This command removes all the source ports and a destination port and restores the default
value for mirroring session mode for all the configured sessions.
This is a stand-alone no command. This command does not have a normal form.
Default
enabled
Format
no monitor
Mode
Global config
105
no monitor session 1
This command removes all the source ports and a destination port of the mirroring
session and restore the default value for mirroring session mode.
The 1 or <session-id> parameter is an integer value used to identify the session.
In the current version of the software, the <session-id> parameter is always 1.
This is a stand-alone no command. This command does not have a normal
form. This command can be issued without regard for the session status (enabled
or disabled).
Default
enabled
Format
no monitor session 1
Mode
Global config
Privileged EXEC
The following is the explanation of the output parameters for this command:
Session IDIt is an integer value used to identify the session. Its value can be
anything between 1 and L7_MIRRORING_MAX_SESSIONS.
Monitor Session ModeIt indicates whether the Port Mirroring feature is enabled
or disabled for the session identified with <session-id>. The possible values are
Enabled and Disabled.
Probe PortIt is the probe port (destination port) for the session identified with
<session-id>. If probe port is not set then this field is blank.
List of source PortsIt is the list of ports, which are configured as mirrored ports
(source ports) for the session identified with <session-id>. If no source port is
configured for the session then this field is blank.
106
shutdown
shutdown
This command disables a port.
The no version of this command enables a port.
Default
enabled
Syntax
[no] shutdown
Mode
Interface Config
shutdown all
This command disables all ports.
The no version of this command enables all ports.
Default
enabled
Syntax
Mode
Global Config
speed
This command sets the speed and duplex setting for all interfaces.
Syntax
Mode
speed
Global Config
storm-control broadcast
This command enables broadcast storm recovery mode. If the mode is enabled, broadcast
storm recovery with high and low thresholds is implemented.
107
High
Low
10M
20
10
100M
1000M
The no version of this command disables broadcast storm recovery mode. The
threshold implementation follows a percentage pattern. If the broadcast traffic on
any Ethernet port exceeds the high threshold percentage (as represented in
Broadcast Storm Recovery Thresholds table) of the link speed, the switch
discards the broadcasts traffic until the broadcast traffic returns to the low
threshold percentage or less. The full implementation is depicted in the
Broadcast Storm Recovery Thresholds table.
Syntax
Mode
Global Config
storm-control flowcontrol
This command enables 802.3x flow control for the switch.
The no version of this command disables 802.3x flow control for the switch.
Note: This command only applies to full-duplex mode ports.
Note: 802.3x flow control works by pausing a port when the port becomes
oversubscribed and dropping all traffic for small bursts of time during the congestion
condition. This can lead to high-priority and/or network control traffic loss.
Default
disabled
Syntax
Mode
108
Global Config
Privileged EXEC
MAC AddressA multicast MAC address for which the switch has forwarding and or filtering
information. The format is two-digit hexadecimal numbers that are separated by colons, for example
01:23:45:67:89:AB. In a system the MAC address will be displayed as a MAC address and VLAN ID
combination of 8 bytes.
TypeThis displays the type of the entry. Static entries are those that are configured by the end user.
Dynamic entries are added to the table as a result of a learning process or protocol.
ComponentThe component that is responsible for this entry in the Multicast Forwarding Database.
Possible values are IGMP Snooping, GMRP, and Static Filtering.
DescriptionThe text description of this multicast table entry.
InterfacesThe list of interfaces that are designated for forwarding (Fwd:) and filtering (Flt:).
Forwarding InterfacesThe resultant forwarding list is derived from combining all the components
forwarding interfaces and removing the interfaces that are listed as the static filtering interfaces.
show mac-address-table
This command displays the Multicast Forwarding Database (MFDB) statistics.
Format
Mode
Privileged EXEC
gmrpDisplay GMRP entries in the MFDB table.
igmpsnoopingDisplay IGMP Snooping entries in the MFDB table.
multicastDisplay Multicast Forwarding Database Table information.
statsDisplay MFDB statistics.
109
Most MFDB Entries Ever UsedThis displays the largest number of entries that
have been present in the Multicast Forwarding Database table. This value is also
known as the MFDB high-water mark.
Current EntriesThis displays the current number of entries in the Multicast
ForwardingDatabase table.
Privileged EXEC
Port Monitor Modeindicates whether the Port Monitoring feature is enabled or disabled.
The possible values are enable and disable.
Probe Port unit/slot/portis the unit/slot/port configured as the probe port. If this
value has not been configured, 'Not Configured' will be displayed.
Monitored Port unit/slot/portis the unit/slot/port configured as the monitored
port. If this value has not been configured, 'Not Configured' will be displayed.
show port
This command displays port information.
Syntax
Mode
Privileged EXEC
Unit/Slot/PortValid unit, slot and port number separated by forward slashes.
TypeIf not blank, this field indicates that this port is a special type of port. The possible
values are:
Monthis port is a monitoring port. Look at the Port Monitoring screens to find out more
information.
Lagthis port is a member of a port-channel (LAG).
Probethis port is a probe port.
110
Admin ModeSelects the Port control administration state. The port must be enabled in order for it to
be allowed into the networkMay be enabled or disabled. The factory default is enabled.
Physical ModeSelects the desired port speed and duplex mode. If auto-negotiation support is
selected, then the duplex mode and speed will be set from the auto-negotiation process. Note that the
port's maximum capability (full duplex -100M) will be advertised. Otherwise, this object will determine
the port's duplex mode and transmission rate. The factory default is Auto.
Physical StatusIndicates the port speed and duplex mode.
Link StatusIndicates whether the Link is up or down.
Link TrapThis object determines whether or not to send a trap when link status changes. The factory
default is enabled.
LACP ModeDisplays whether LACP is enabled or disabled on this port.
Privileged EXEC
Group NameThis field displays the group name of an entry in the Protocol-based VLAN table.
Group IDThis field displays the group identifier of the protocol group.
Protocol(s)This field indicates the type of protocol(s) for this group.
VLANThis field indicates the VLAN associated with this Protocol Group.
Interface(s)This field lists the unit/slot/port interface(s) that are associated with this Protocol
Group.
show storm-control
This command displays switch configuration information.
Syntax
Mode
show storm-control
Privileged EXEC
Broadcast Storm Recovery ModeMay be enabled or disabled. The factory default is disabled.
111
802.3x Flow Control ModeMay be enabled or disabled. The factory default is disabled.
enabled
Syntax
Mode
Global Config
enabled
Syntax
Mode
Global Config
112
vlan
The no version of this command sets a client IP mask for an SNMP community to 0.0.0.0.
The name is the applicable community name. The community name may be up to 16
alphanumeric characters.
Default
0.0.0.0
Syntax
Mode
Global Config
vlan
This command creates a new VLAN and assigns it an ID. The ID is a valid VLAN
identification number (ID 1 is reserved for the default VLAN). VLAN range is 2-1024.
The no version of this command deletes an existing VLAN. The ID is a valid VLAN
identification number (ID 1 is reserved for the default VLAN). VLAN range is 2-1024.
Syntax
Mode
VLAN database
vlan acceptframe
This command sets the frame acceptance mode per interface. For VLAN Only mode,
untagged frames or priority frames received on this interface are discarded. For Admit All
mode, untagged frames or priority frames received on this interface are accepted and assigned
the PVID value set for that interface. With either option, VLAN tagged frames are forwarded
in accordance with the IEEE 802.1Q VLAN Specification.
The no version of this command sets the frame acceptance mode per interface to Admit All.
For Admit All mode, untagged frames or priority frames received on this interface are
accepted and assigned the value of the interface VLAN ID for this port. With either option,
VLAN tagged frames are forwarded in accordance with the IEEE 802.1Q VLAN
Specification.
Default
admit all
113
Syntax
Mode
Interface Config
vlan ingressfilter
This command enables ingress filtering. If ingress filtering is disabled, frames
received with VLAN IDs that do not match the VLAN membership of the
receiving interface are admitted and forwarded to ports that are members of that
VLAN.
The no version of this command disables ingress filtering.
If ingress filtering is disabled, frames received with VLAN IDs that do not match
the VLAN membership of the receiving interface are admitted and forwarded to
ports that are members of that VLAN.
Default
disabled
Syntax
Mode
Interface Config
vlan makestatic
This command changes a dynamically created VLAN (one that is created by
GVRP registration) to a static VLAN (one that is permanently configured and
defined). The ID is a valid VLAN identification number. VLAN range is 2-4094.
Syntax
Mode
VLAN database
vlan name
This command changes the name of a VLAN. The name is an alphanumeric string
of up to 32 characters, and the ID is a valid VLAN identification number. ID range
is 2-3965.
114
vlan participation
The no version of this command sets the name of a VLAN to a blank string. The VLAN ID is
a valid VLAN identification number. ID range is 2-3965.
Default
The name for VLAN ID 1 is always Default. The name for other VLANs is defaulted to a
blank string.
Syntax
Mode
VLAN database
vlan participation
This command configures the degree of participation for a specific interface in a VLAN. The
ID is a valid VLAN identification number, and the interface is a valid interface number.
Syntax
Mode
Interface Config
Participation options are:
includeThe interface is always a member of this VLAN. This is equivalent to registration fixed.
excludeThe interface is never a member of this VLAN. This is equivalent to registration forbidden.
autoThe interface is dynamically registered in this VLAN by GVRP. The interface will not participate in
this VLAN unless a join request is received on this interface. This is equivalent to registration normal.
Global Config
Participation options are:
includeThe interface is always a member of this VLAN. This is equivalent to registration fixed.
excludeThe interface is never a member of this VLAN. This is equivalent to registration forbidden.
115
autoThe interface is dynamically registered in this VLAN by GVRP. The interface will not
participate in this VLAN unless a join request is received on this interface. This is
equivalent to registration normal.
Admit All
Syntax
Mode
Global Config
disabled
Syntax
Mode
116
Global Config
Syntax
Mode
Global Config
Global Config
Global Config
117
None
Syntax
Mode
Global Config
Global Config
protocol group
This command attaches a vlanid to the protocol-based VLAN identified by
groupid. A group may only be associated with one VLAN at a time, however
the VLAN association can be changed.
The referenced VLAN should be created prior to the creation of the
protocol-based VLAN except when GVRP is expected to create the VLAN.
The no version of this command removes the <vlanid> from this protocol-based
VLAN group that is identified by this groupid.
Default
118
None
Syntax
Mode
VLAN database
None
Syntax
Mode
Interface Config
None
Syntax
119
Mode
Global Config
vlan pvid
This command changes the VLAN ID per interface.
The no version of this command sets the VLAN ID per interface to 1.
Default
Syntax
Mode
Interface Config
vlan tagging
This command configures the tagging behavior for a specific interface in a VLAN
to enabled. If tagging is enabled, traffic is transmitted as tagged frames. If tagging
is disabled, traffic is transmitted as untagged frames. The ID is a valid VLAN
identification number.
The no version of this command configures the tagging behavior for a specific
interface in a VLAN to disabled. If tagging is disabled, traffic is transmitted as
untagged frames. The ID is a valid VLAN identification number.
Syntax
Mode
Interface Config
show vlan
This command displays detailed information, including interface information, for
a specific VLAN. The ID is a valid VLAN identification number
Syntax
Mode
120
VLAN IDThere is a VLAN Identifier (VID) associated with each VLAN. The range of the VLAN ID is 1
to 4094.
VLAN NameA string associated with this VLAN as a convenience. It can be up to 32 alphanumeric
characters long, including blanks. The default is blank. VLAN ID 1 always has a name of `Default`. This
field is optional.
VLAN TypeType of VLAN, which can be Default, (VLAN ID = 1), a static (one that is configured and
permanently defined), or Dynamic (one that is created by GVRP registration).
Unit/Slot/PortValid unit, slot and port number separated by forward slashes. It is possible to set the
parameters for all ports by using the selectors on the top line.
CurrentDetermines the degree of participation of this port in this VLAN.
The permissible values are:
IncludeThis port is always a member of this VLAN. This is equivalent to registration fixed in the IEEE
802.1Q standard.
ExcludeThis port is never a member of this VLAN. This is equivalent to registration forbidden in the
IEEE 802.1Q standard.
AutodetectSpecifies to allow the port to be dynamically registered in this VLAN via GVRP. The port
will not participate in this VLAN unless a join request is received on this port. This is equivalent to
registration normal in the IEEE 802.1Q standard.
ConfiguredDetermines the configured degree of participation of this port in this VLAN. The
permissible values are:
IncludeThis port is always a member of this VLAN. This is equivalent to registration fixed in the IEEE
802.1Q standard.
ExcludeThis port is never a member of this VLAN. This is equivalent to registration forbidden in the
IEEE 802.1Q standard.
AutodetectSpecifies to allow the port to be dynamically registered in this VLAN via GVRP. The port
will not participate in this VLAN unless a join request is received on this port. This is equivalent to
registration normal in the IEEE 802.1Q standard.
TaggingSelect the tagging behavior for this port in this VLAN.
Taggedspecifies to transmit traffic for this VLAN as tagged frames.
Untaggedspecifies to transmit traffic for this VLAN as untagged frames.
121
VLAN IDThere is a VLAN Identifier (vlanid )associated with each VLAN. The range of the VLAN ID is
1 to 4094.
VLAN NameA string associated with this VLAN as a convenience. It can be up to 32 alphanumeric
characters long, including blanks. The default is blank. VLAN ID 1 always has a name of `Default`. This
field is optional.
VLAN TypeType of VLAN, which can be Default, (VLAN ID = 1), a static (one that is configured and
permanently defined), or a Dynamic (one that is created by GVRP registration).
122
traceroute
traceroute
This command is used to discover the routes that packets actually take when traveling to their
destination through the network on a hop-by-hop basis. <ipaddr> should be a valid IP
address. [port] should be a valid decimal integer in the range of 0(zero) to 65535. The default
value is 33434.
The optional port parameter is the UDP port used as the destination of packets sent as part of
the traceroute. This port should be an unused port on the destination system.
Syntax
Mode
Privileged EXEC
clear config
This command resets the configuration to the factory defaults without powering off the
switch. The switch is automatically reset when this command is processed. You are prompted
to confirm that the reset should proceed.
Syntax
Mode
clear config
Privileged EXEC
clear counters
This command clears the stats for a specified <unit/slot/port>or for all the ports or for the
entire switch based upon the argument.
Syntax
Mode
Privileged EXEC
clear igmpsnooping
This command clears the tables managed by the IGMP Snooping function and will attempt to
delete these entries from the Multicast Forwarding Database.
123
clear pass
Syntax
Mode
clear igmpsnooping
Privileged EXEC
clear pass
This command resets all user passwords to the factory defaults without powering off the
switch. You are prompted to confirm that the password reset should proceed.
Syntax
Mode
clear pass
Privileged EXEC
enable passwd
This command changes the Privileged EXEC password. First type the command then hit the
enter or the return key.
Syntax
enable passwd
Mode
Privileged EXEC
clear port-channel
This command clears all port-channels (LAGs).
Syntax
Mode
clear port-channel
Privileged EXEC
clear traplog
This command clears the trap log.
Syntax
124
clear traplog
clear vlan
Mode
Privileged EXEC
clear vlan
This command resets VLAN configuration parameters to the factory defaults.
Syntax
Mode
clear vlan
Privileged EXEC
logout
This command closes the current telnet connection or resets the current serial connection.
Note: Save configuration changes before logging out.
Syntax
Mode
logout
Privileged EXEC
ping
This command checks if another computer is on the network and listens for connections. To
use this command, configure the switch for network (in-band) connection (as described in the
SFTOS 2402/4802 Hardware User Guide). The source and target devices must have the ping
utility enabled and running on top of TCP/IP. The switch can be pinged from any IP
workstation with which the switch is connected through the default VLAN (VLAN 1), as long
as there is a physical path between the switch and the workstation. The terminal interface
sends, three pings to the target station.
Syntax
Mode
ping ipaddr
125
reload
reload
This command resets the switch without powering it off. Reset means that all network
connections are terminated and the boot code executes. The switch uses the stored
configuration to initialize the switch. You are prompted to confirm that the reset should
proceed. A successful reset is indicated by the LEDs on the switch.
Syntax
Mode
reload
Privileged EXEC
copy
This command uploads and downloads to/from the switch. Local URLs can be specified
using tftp or xmodem. The following can be specified as the source file for uploading from
the switch: startup configuration (nvram:startup-config), error log (nvram:errorlog),
message log (nvram:msglog) and trap log (nvram:traplog). A URL is specified for the
destination.
The command can also be used to download the startup configuration or code image by
specifying the source as a URL and destination as nvram:startup-config or .system:image
respectively.
The command can be used to the save the running configuration to nvram by specifying the
source as system:running-config and the destination as nvram:startup-config. In a
stacking environment, the running configuration is saved in all units of the stack.
The command can also be used to download ssh key files as nvram:sshkey-rsa,
nvram:sshkey-rsa2, and nvram:sshkey-dsa and http secure-server certificates as
nvram:sslpem-root, nvram:sslpem-server, nvram:sslpem-dhweak, and
nvram:sslpem-dhstrong.
126
Default
None
Syntax
copy
copy
copy
copy
copy
copy
copy
copy
copy
copy
copy
copy
copy (clibanner)
copy
copy
copy
copy
copy
Mode
<tftp://<ip
<tftp://<ip
<tftp://<ip
<tftp://<ip
<tftp://<ip
address>/>
address>/>
address>/>
address>/>
address>/>
<filename>
<filename>
<filename>
<filename>
<filename>
nvram:sslpem-dhstrong
nvram:sshkey-rsa1
nvram:sshkey-rsa2
nvram:sshkey-dsa
nvram:clibanner
Privileged EXEC
Pre-login Banner
This section provides a detailed explanation of the Pre-login Banner command.
copy (clibanner)
The copy command (See copy on page 126.) includes the clibanner option. This
command uploads and downloads to/from the switch. Local URLs can be specified using tftp
or xmodem.
Default
none
Syntax
Mode
Privileged EXEC
logging cli-command
This command enables the CLI command Logging feature.The Command Logging
component enables the FASTPATH software to log all Command Line Interface (CLI)
commands issued on the system.
Default
enabled
Syntax
Mode
Global Config
127
Configuration Scripting
Configuration Scripting
Configuration Scripting allows the user to generate text-formatted script files representing the
current configuration. These configuration script files can be uploaded to a PC and edited,
downloaded to the system and applied to the system. Configuration scripts can be applied to
one or more switches with no/minor modifications.
Use the show running-config command to capture the running configuration into a script.
Use the copy command (See copy on page 126. ) to transfer the configuration script to/
from the switch.
Note: The file extension must be .scr. A maximum of ten scripts are allowed on the
switch. The combined size of all script files on the switch shall not exceed 500 KB.
Note: Configuration script files are not distributed across the stack, and only live in
the unit that is the master unit at the time of the file download.
Note: The file extension must be .scr.
Note: A maximum of ten scripts are allowed on the switch.
Note: The combined size of all script files on the switch shall not exceed 500 KB.
configscript apply
This command applies the commands in the configuration script to the switch. The apply
command backs up the running configuration and then starts applying the commands in the
script file. Application of the commands stops at the first failure of a command. The
<scriptname> parameter is the name of the script to be applied.
Syntax
Mode
Global Config
configscript delete
This command deletes a specified script where the <scriptname> parameter is the name of
the script to be deleted. The all option deletes all the scripts present on the switch.
Syntax
Mode
128
Global Config
configscript list
configscript list
This command lists all scripts present on the switch as well as the total number of files
present.
Syntax
Mode
configscript list
Global Config
Configuration ScriptName of the configuration script.
SizeSize of the configuration script.
configscript show
This command displays the contents of a script file. The parameter <scriptname> is the name
of the script file.
Syntax
Mode
Global Config
The format of display is: Line <no>: <Line contents>
configscript validate
This command validates a configuration script file by parsing each line in the script file where
<scriptname> is the name of the script to be validated. The validation will stop at the first
failure of a command.
Syntax
Mode
Global Config
129
configscript validate
130
Chapter 13
System Log
This section provides a detailed explanation of the Syslog commands. The commands are
divided into two functional groups:
Show commands display spanning tree settings, statistics, and other information.
Configuration Commands configure features and options of the device. For every
configuration command there is a show command that displays the configuration setting.
logging buffered
This command enables logging to in-memory log where up to 128 logs are kept. The
<severitylevel> value is specified as either an integer from 0 to 7 or symbolically through one
of the following keywords: emergency (0), alert (1), critical (2), error (3), warning (4), notice
(5), informational (6), debug (7).
The no version of this command disables logging to in-memory log.
Default
disabled; critical
Syntax
Mode
Global Config
wrap
131
logging console
Syntax
Mode
Privileged EXEC
logging console
This command enables logging to the console. The <severitylevel> value is specified as
either an integer from 0 to 7 or symbolically through one of the following keywords:
emergency (0), alert (1), critical (2), error (3), warning (4), notice (5), informational (6),
debug (7).
The no version of this command disables logging to the console.
Default
disabled; critical
Syntax
Mode
Global Config
logging persistent
This command enables logging of system startup and system operation logs to storage. The
<severitylevel> value is specified as either an integer from 0 to 7 or symbolically through
one of the following keywords: EMERGENCY (0), ALERT (1), CRITICAL (2), ERROR (3),
WARNING (4), NOTICE (5), INFORMATIONAL (6), DEBUG (7).
The no version of this command disables logging. It does not clear the contents of the log.
Default
Syntax
Mode
Global Config
logging host
This command enables logging to a host where up to eight hosts can be configured.
AddressType can be ipv4 or dns, port can be of a value from
132
System Log
Default
Syntax
Mode
Global Config
Global Config
logging port
This command sets the local port number of the LOG client for logging messages. The
<portid> can be in the range from 1 to 65535.
The no version of this command resets the local logging port to the default.
Default
514
Syntax
Mode
Global Config
logging syslog
This command enables syslog logging.
The no version of this command disables syslog logging.
Default
disabled; local0
Syntax
Mode
Global Config
133
show logging
show logging
This command displays logging.
Syntax
Mode
show logging
Privileged EXEC
Client Local PortThe port on the collector/relay to which syslog messages are sent
Console Logging Administrative ModeThe mode for console logging.
Console Logging Severity FilterThe minimum severity to log to the console log. Messages with an
equal or lower numerical severity are logged.
Buffered Logging Administrative ModeThe mode for buffered logging.
Buffered Logging Severity FilterThe minimum severity to log to the buffered log. Messages with an
equal or lower numerical severity are logged.
Historical Logging Administrative ModeThe mode for historical logging.
Historical Logging Severity FilterThe minimum severity to log to the historical log. Messages with an
equal or lower numerical severity are logged.
Syslog Logging Administrative ModeThe mode for logging to configured syslog hosts. If set to disable
logging stops to all syslog hosts.
Log Messages ReceivedThe number of messages received by the log process. This includes
messages that are dropped or ignored
Log Messages DroppedThe number of messages that could not be processed.
Privileged EXEC
Persistent Logging Administrative ModeThe mode for historical logging.
Persistent Logging Severity FilterThe minimum severity to log to the historical log. Messages with an
equal or lower numerical severity are logged.
Persistent Log Count:The number of messages received by the log process. This includes messages
that are dropped or ignored
134
System Log
Privileged EXEC
Admin StatusThe current state of the in-memory log.
Severity Level FilterThe minimum severity to log to the in memory log. Messages with an equal or
lower numerical severity are logged.
Component FilterThe component(s) from which received messages are to be logged to the in memory
log. Either a single component id or "all components" may be specified.
Wrapping BehaviorThe behavior of the In Memory log when faced with a log full situation.
Log CountThe count of valid entries in the buffered log.
Privileged EXEC
Host Index (used for deleting)
Host IP AddressIP Address of the configured server.
Address TypeAddress Type of Server.
Severity LevelThe minimum severity to log to the specified address.
PortServer Port Number.This is the port on the local host from which syslog messages are sent.
Host StatusThe state of logging to configured syslog hosts. If the status is disable, no logging occurs.
135
136
System Log
Chapter 14
These commands manage user accounts. The commands are divided into two functional
groups:
disconnect
This command closes a telnet session.
Syntax
Mode
Privileged EXEC
show loginsession
This command displays current telnet and serial port connections to the switch.
Syntax
show loginsession
Mode
Privileged EXEC
ID
Login Session ID
Parameters
User NameThe name the user will use to login using the serial port or Telnet. A new user may be
added to the switch by entering a name in a blank entry. The user name may be up to 8 characters, and
is not case sensitive. Two users are included as the factory default, admin and guest.
Connection FromIP address of the telnet client machine or EIA-232 for the serial port connection.
Idle TimeTime this session has been idle.
Session TimeTotal time this session has been connected.
137
show users
show users
This command displays the configured user names and their settings. This command is only
available for users with Read/Write privileges. The SNMPv3 fields will only be displayed if SNMP is
available on the system.
Syntax
Mode
Parameters
show users
Privileged EXEC
User NameThe name the user will use to login using the serial port, Telnet or Web. A new user may
be added to the switch by entering a name in a blank entry. The user name may be up to eight
characters, and is not case sensitive. Two users are included as the factory default, admin and guest
Access ModeShows whether the operator is able to change parameters on the switch (Read/Write) or
is only able to view them (Read Only). As a factory default, the admin user has Read/Write access and
the guest has Read Only access. There can only be one Read/Write user and up to five Read Only
users.
SNMPv3 Access ModeThis field displays the SNMPv3 Access Mode. If the value is set to
ReadWrite, the SNMPv3 user will be able to set and retrieve parameters on the system. If the value
is set to ReadOnly, the SNMPv3 user will only be able to retrieve parameter information. The
SNMPv3 access mode may be different than the CLI and Web access mode.
SNMPv3 AuthenticationThis field displays the authentication protocol to be used for the specified
login user.
SNMPv3 EncryptionThis field displays the encryption protocol to be used for the specified login user.
users name
This command adds a new user (account) if space permits. The account username can be up
to eight characters in length. The name may be comprised of alphanumeric characters as well
as the dash (-) and underscore (_). The username is not case-sensitive.
Six user names can be defined.
The no version of this command removes an operator.
Note: The admin user account cannot be deleted.
Syntax
Mode
138
Global Config
users passwd
users passwd
This command is used to change a password. The password should not be more than eight
alphanumeric characters in length. If a user is authorized for authentication or encryption is
enabled, the password must be at least eight alphanumeric characters in length. The username
and password are not case-sensitive. When a password is changed, a prompt will ask for the
former password. If none, press enter.
The no version of this command sets the password of an existing operator to blank. When a
password is changed, a prompt will ask for the operator's former password. If none, press
enter.
Default
no password
Syntax
Mode
Global Config
Syntax
Mode
Global Config
139
The no version of this command sets the authentication protocol to be used for the specified
login user to none. The username is the login user name for which the specified
authentication protocol will be used.
Default
no authentication
Syntax
Mode
Global Config
no encryption
Syntax
Mode
140
Global Config
Chapter 15
SNTP
This section provides a detailed explanation of the Simple Network Tim Protocol (SNTP)
commands. The commands are divided into two functional groups:
Show commands display spanning tree settings, statistics, and other information.
Configuration Commands configure features and options of the switch. For every
configuration command there is a show command that displays the configuration setting.
Syntax
Mode
Global Config
141
Default
Disabled
Syntax
Mode
Global Config
123
Syntax
Mode
Global Config
Syntax
Mode
142
Global Config
SNTP
Syntax
Mode
Global Config
Syntax
Mode
Global Config
Syntax
143
sntp server
no sntp multicast client poll-interval
Mode
Global Config
sntp server
This command configures an SNTP server (with a maximum of three) where the server
address can be an ip address or a domain name and the address type either ipv4 or dns. The
optional priority can be a value of 1-3, the version a value of 1-4, and the port id a value of
1-65535.
The no version of this command deletes an server from the configured SNTP servers.
Syntax
Mode
Global Config
show sntp
This command is used to display SNTP settings and status.
Syntax
Mode
show sntp
Privileged Exec
Last Update TimeTime of last clock update.
Last Attempt TimeTime of last transmit query (in unicast mode).
Last Attempt StatusStatus of the last SNTP request (in unicast mode) or unsolicited message (in
broadcast mode).
Broadcast CountCurrent number of unsolicited broadcast messages that have been received and
processed by the SNTP client since last reboot.
Multicast CountCurrent number of unsolicited multicast messages that have been received and
processed by the SNTP client since last reboot
144
SNTP
Privileged Exec
Client Supported ModesSupported SNTP Modes (Broadcast, Unicast, or Multicast).
SNTP VersionThe highest SNTP version the client supports
PortSNTP Client Port
Client Mode:Configured SNTP Client Mode
Poll IntervalPoll interval value for SNTP clients in seconds as a power of two.
Poll TimeoutPoll timeout value in seconds for SNTP clients.
Poll RetryPoll retry value for SNTP clients.
Privileged Exec
Server IP AddressIP Address of configured SNTP Server
Server TypeAddress Type of Server.
Server StratumClaimed stratum of the server for the last received valid packet.
Server Reference IDReference clock identifier of the server for the last received valid packet.
Server ModeSNTP Server mode.
Server Max EntriesTotal number of SNTP Servers allowed.
Server Current EntriesTotal number of SNTP configured.
145
146
SNTP
Chapter 16
These commands configure the Dynamic Host Configuration Protocol (DHCP) Server
parameters and address pools. The commands are divided by functionality into these different
groups:
Configuration Commands are used to configure features and options of the switch. For
every configuration command there is a show command that will display the
configuration setting.
Show commands are used to display switch settings, statistics and other information.
Clear commands clear some or all of the settings to factory defaults.
client-identifier
This command specifies the unique identifier for a DHCP client. Unique-identifier is a valid
notation in hexadecimal format. In some systems, such as Microsoft DHCP clients, the client
identifier is required instead of hardware addresses. The unique-identifier is a concatenation
of the media type and the MAC address. For example, the Microsoft client identifier for
Ethernet address c819.2488.f177 is 01c8.1924.88f1.77 where 01 represents the Ethernet
media type. Refer to the "Address Resolution Protocol Parameters" section of RFC 1700,
Assigned Numbers for a list of media type codes.
The no version of this command deletes the client identifier.
Default
None
Syntax
Mode
147
client-name
client-name
This command specifies the name for a DHCP client. Name is a string consisting of standard
ASCII characters.
The no version of this command removes the client name.
Default
None
Syntax
client-name name
no client-name
Mode
default-router
This command specifies the default router list for a DHCP client. {address1, address2
address8} are valid IP addresses, each made up of four decimal bytes ranging from 0 to 255.
IP address 0.0.0.0 is invalid.
The no version of this command removes the default router list.
Default
None
Syntax
Mode
dns-server
This command specifies the IP servers available to a DHCP client. Address parameters are
valid IP addresses; each made up of four decimal bytes ranging from 0 to 255. IP address
0.0.0.0 is invalid.
The no version of this command removes the DNS Server list.
148
Default
none
Syntax
hardware-address
no dns-server
Mode
hardware-address
This command specifies the hardware address of a DHCP client.
Hardware-address is the MAC address of the hardware platform of the client consisting of 6
bytes in dotted hexadecimal format.
Type indicates the protocol of the hardware platform. It is 1 for 10 MB Ethernet and 6 for
IEEE 802.
The no version of this command removes the hardware address of the DHCP client.
Default
ethernet
Syntax
Mode
host
This command specifies the IP address and network mask for a manual binding to a DHCP
client. Address and Mask are valid IP addresses; each made up of four decimal bytes ranging
from 0 to 255. IP address 0.0.0.0 is invalid.
The prefix-length is an integer from 0 to 32.
The no version of this command removes the IP address of the DHCP client.
Default
none
Syntax
Mode
149
ip dhcp excluded-address
ip dhcp excluded-address
This command specifies the IP addresses that a DHCP server should not assign to DHCP
clients. Low-address and high-address are valid IP addresses; each made up of four decimal
bytes ranging from 0 to 255. IP address 0.0.0.0 is invalid.
The no version of this command removes the excluded IP addresses for a DHCP client.
Low-address and high-address are valid IP addresses; each made up of four decimal bytes
ranging from 0 to 255. IP address 0.0.0.0 is invalid.
Default
none
Syntax
Mode
Global Config
Syntax
Mode
Global Config
ip dhcp pool
This command configures a DHCP address pool name on a DHCP server and enters DHCP
pool configuration mode.
The no version of this command removes the DHCP address pool. The name should be
previously configured pool name.
150
Default
none
Syntax
lease
Mode
lease
This command configures the duration of the lease for an IP address that is assigned from a
DHCP server to a DHCP client. The overall lease time should be between 1-86400 minutes. If
infinite is specified, lease is set for 60 days. Days is an integer from 0 to 59. Hours is an
integer from 0 to 1439. Minutes is an integer from 0 to 86399.
The no version of this command restores the default value of the lease time for DHCP Server.
Default
1 (day)
Syntax
Mode
network
This command is used to configure the subnet number and mask for a DHCP address pool on
the server. Network-number is a valid IP address, made up of four decimal bytes ranging from
0 to 255. IP address 0.0.0.0 is invalid. Mask is the IP subnet mask for the specified address
pool. The prefix-length is an integer from 0 to 32.
The no version of this command removes the subnet number and mask.
Default
none
Syntax
Mode
service dhcp
This command enables the DHCP server and relay agent features on the router.
The no version of this command disables the DHCP server and relay agent features.
Default
disabled
151
bootfile
Syntax
service dhcp
Mode
Global Config
bootfile
The command specifies the name of the default boot image for a DHCP client. The filename
specifies the boot image file.
The no version of this command deletes the boot image name.
Default
none
Syntax
bootfile filename
no bootfile
Mode
domain-name
This command specifies the domain name for a DHCP client. The domain specifies the
domain name string of the client.
The no version of this command removes the domain name.
Default
none
Syntax
domain-name domain
Mode
152
disable
Syntax
Mode
Global Config
enabled
Syntax
Mode
Global Config
netbios-name-server
This command configures NetBIOS Windows Internet Naming Service (WINS) name servers
that are available to DHCP clients.
One IP address is required, although one can specify up to eight addresses in one command
line. Servers are listed in order of preference (address1 is the most preferred server, address2
is the next most preferred server, and so on).
The no version of this command
Default
none
Syntax
Mode
netbios-node-type
The command configures the NetBIOS node type for Microsoft Dynamic Host Configuration
Protocol (DHCP) clients.type Specifies the NetBIOS node type. Valid types are:
b-nodeBroadcast
p-nodePeer-to-peer
153
next-server
m-nodeMixed
h-nodeHybrid (recommended)
none
Syntax
netbios-node-type type
Mode
next-server
This command configures the next server in the boot process of a DHCP client.
Address is the IP address of the next server in the boot process, which is typically a Trivial
File Transfer Protocol (TFTP) server.
The no version of this command removes the boot server list.
Default
If the next-server command is not used to configure a boot server list, the DHCP Server uses
inbound interface helper addresses as boot servers.
Syntax
next-server address
no next-server
Mode
option
The command configures DHCP Server options. Code specifies the DHCP option code. Ascii
string specifies an NVT ASCII character string. ASCII character strings that contain white
space must be delimited by quotation marks. Hex string specifies hexadecimal data. in
hexadecimal character strings is two hexadecimal digitseach byte can be separated by a
period, colon, or white space.
Example :a3:4f:22:0c / a3 4f 22 0c / a34f.220c.9fed The address specifies an IP address.
The no version of this command removes the options.
Default
154
none
Syntax
Mode
155
156
none
Syntax
157
Mode
Privileged EXEC
Privileged EXEC
none
Syntax
Mode
158
Privileged EXEC
Chapter 17
This chapter provides a detailed explanation of the Double VLAN (dvlan) commands. The
commands are divided into two functional groups:
dvlan-tunnel etherType
This command configures the ether-type for the specified interface. The ether-type may have
the values of 802.1Q, vMAN, or custom. If the ether-type has a value of custom, the optional
value of the custom ether type must be set to a value from 0 to 65535.
The no version of this command configures the ether-type for the specified interface to its
default value.
Default
vman
Syntax
Mode
Interface Config
mode dot1q-tunnel
This command is used to enable Double VLAN Tunneling on the specified interface. By
default, Double VLAN Tunneling is disabled. This command is synonymous with mode
dvlan-tunnel.
The no version of this command is used to disable Double VLAN Tunneling on the specified
interface. By default, Double VLAN Tunneling is disabled.
Default
disabled
159
mode dvlan-tunnel
Syntax
Mode
mode dot1q-tunnel
Interface Config
mode dvlan-tunnel
This command is used to enable Double VLAN Tunneling on the specified interface. By
default, Double VLAN Tunneling is disabled.This command is synonymous with mode
dot1q-tunnel.
The no version of this command is used to disable Double VLAN Tunneling on the specified
interface. By default, Double VLAN Tunneling is disabled.
Default
disabled
Syntax
mode dvlan-tunnel
Mode
Interface Config
show dot1q-tunnel
This command displays all interfaces enabled for Double VLAN Tunneling.
Syntax
Mode
show dot1q-tunnel
160
show dvlan-tunnel
Customer IdThis is a 12-bit customer ID which will be used as the last 12 bits of the Double VLAN
Tunnel. The valid range for a customer ID is 0 to 4095.
EtherTypeThis field represents a 2-byte hex EtherType to be used as the first 16 bits of the DVLAN
tunnel. There are three different EtherType tags. The first is 802.1Q, which represents the commonly
used value of 0x8100. The second is vMAN, which represents the commonly used value of 0x88A8. If
EtherType is not one of these two values, then it is a custom tunnel value, representing any value in the
range of 0 to 65535.
show dvlan-tunnel
This command displays all interfaces enabled for Double VLAN Tunneling.
Syntax
Mode
show dvlan-tunnel
161
162
Chapter 18
This chapter provides a detailed explanation of the Provisioning commands. The commands
are divided into two functional groups:
classofservice dot1pmapping
This command maps an 802.1p priority to an internal traffic class for a device when in
Global Config mode. The number of available traffic classes may vary with the platform.
Userpriority and trafficclass can both be the range from 0-7. The command is only available
on platforms that support priority to traffic class mapping on a per-port basis, and the
number of available traffic classes may vary with the platform.
Syntax
Mode
Platforms that do not support priority to traffic class mapping on a per-port basis:
SFTOS Command Line Interface Reference, Version 2.1.4
163
Syntax
Mode
Global Config
vlan priority
This command configures the default 802.1p port priority assigned for untagged packets for a
specific interface. The range for the priority is 0-7
Default
Syntax
Mode
164
Interface Config
Chapter 19
GARP Commands
This chapter provides a detailed explanation of the General Attribute Registration Protocol
(GARP) commands. The commands are divided into two functional groups:
20
Syntax
Mode
Interface Config
165
This command has an effect only when GVRP is enabled. The time is from 10 to 100
(centiseconds). The value 20 centiseconds is 0.2 seconds.
The no version of this command sets the GVRP join time for all ports and per GARP to 20
centiseconds (0.2 seconds). This command has an effect only when GVRP is enabled.
Default
20
Syntax
Mode
Global Config
The no version of this command sets the GVRP leave time per port to 60 centiseconds (0.6
seconds).
Note: This command has an effect only when GVRP is enabled.
Default
60
Syntax
Mode
166
Interface Config
GARP Commands
The no version of this command sets the GVRP leave time for all ports to the default 60
centiseconds (0.6 seconds).
Note: This command has an effect only when GVRP is enabled.
Default
60
Syntax
Mode
Global Config
The no version of this command sets how frequently Leave All PDUs are generated per port to
1000 centiseconds (10 seconds).
Note: This command has an effect only when GVRP is enabled.
167
Default
1000
Syntax
Mode
Interface Config
Default
1000
Syntax
Mode
Global Config
show garp
This command displays Generic Attributes Registration Protocol (GARP) information.
Syntax
Mode
show garp
168
GARP Commands
disabled
Syntax
Mode
Privileged EXEC
disabled
Syntax
Mode
Interface Config
169
Default
disabled
Syntax
Mode
Global Config
170
GARP Commands
Privileged EXEC
disabled
Syntax
Mode
Interface Config
171
disabled
Syntax
Mode
Global Config
172
GARP Commands
Port GMRP ModeIndicates the GMRP administrative mode for the port. It may be enabled or
disabled. If this parameter is disabled, Join Time, Leave Time and Leave All Time have no effect. The
factory default is disabled.
Port GVRP ModeIndicates the GVRP administrative mode for the port. It may be enabled or disabled.
If this parameter is disabled, Join Time, Leave Time and Leave All Time have no effect. The factory
default is disabled.
Privileged EXEC
Mac AddressA unicast MAC address for which the switch has forwarding and or filtering information.
The format is 6 or 8 two-digit hexadecimal numbers that are separated by colons, for example
01:23:45:67:89:AB. In a system the MAC address will be displayed as 8 bytes.
TypeThis displays the type of the entry. Static entries are those that are configured by the end user.
Dynamic entries are added to the table as a result of a learning process or protocol.
DescriptionThe text description of this multicast table entry.
InterfacesThe list of interfaces that are designated for forwarding (Fwd:) and filtering (Flt:).
173
174
GARP Commands
Chapter 20
IGMP Commands
This chapter provides a detailed explanation of the IGMP commands. The commands are
divided into two functional groups:
175
Syntax
Mode
Global Config
disabled
Syntax
Mode
Interface Config
176
IGMP Commands
Default
260
Syntax
Mode
Global Config
disabled
Syntax
Mode
Global Config
10
Syntax
Mode
Global Config
177
Syntax
Mode
Global Config
show igmpsnooping
This command displays IGMP Snooping information. Configured information is displayed
whether or not IGMP Snooping is enabled. Status information is only displayed when IGMP
Snooping is enabled.
Syntax
Mode
show igmpsnooping
Privileged EXEC
Admin ModeThis indicates whether or not IGM
This displays the IGMP Query Interval Time. This is the amount of time a switch will wait for a report for
a particular group on a particular interface before it sends a query on that interface. This value may be
configured
Max Response TimeThis displays the amount of time the switch will wait after sending a query on an
interface because it did not receive a report for a particular group on that interface. This value may be
configured.
Multicast Router Present Expiration TimeIf a query is not received on an interface within this amount
of time, the interface is removed from the list of interfaces with multicast routers attached. This value
may be configured.
Interfaces Enabled for IGMP SnoopingThis is the list of interfaces on which IGMP Snooping is
enabled.
Multicast Control Frame CountThis displays the number of multicast control frames that are
processed by the CPU.
178
IGMP Commands
Privileged EXEC
Mac AddressA multicast MAC address for which the switch has forwarding and or filtering information.
The format is two-digit hexadecimal numbers that are separated by colons, for example
01:23:45:67:89:AB. In a system the MAC address will be displayed as a MAC address and VLAN ID
combination of 8 bytes.
TypeThis displays the type of the entry. Static entries are those that are configured by the end user.
Dynamic entries are added to the table as a result of a learning process or protocol.
DescriptionThe text description of this multicast table entry.
InterfacesThe list of interfaces that are designated for forwarding (Fwd:) and filtering (Flt:).
260 seconds
Syntax
Mode
Interface Config
179
260 seconds
Syntax
Mode
Global Config
10 seconds
Syntax
Mode
180
Interface Config
IGMP Commands
10 seconds
Syntax
Mode
Global Config
Syntax
Mode
Interface Config
181
Syntax
Mode
Global Config
disable
Syntax
Mode
182
Interface Config
IGMP Commands
disable
Syntax
Mode
Interface Config
Interface Config
show igmpsnooping
This command displays IGMP Snooping information. Configured information is displayed
whether or not IGMP Snooping is enabled.
Syntax
Mode
Privileged EXEC
This display parameters when the optional argument unit/slot/port is not used are as
follows:
Admin ModeThis indicates whether or not IGMP Snooping is active on the switch.
Interfaces Enabled for IGMP SnoopingThis is the list of interfaces on which IGMP Snooping is
enabled.
183
Multicast Control Frame CountThis displays the number of multicast control frames that are
processed by the CPU.
Data Frames Forwarded by the CPUThis displays the number of data frames that are forwarded by
the CPU.
Privileged EXEC
Fast-Leave Admin ModeThis indicates whether or not IGMP Snooping Fast-leave is active on the
interface.
Privileged EXEC
unit/slot/portThe port on which multicast router information is being displayed.
Multicast Router AttachedThis indicates whether or not multicast router is statically enabled on the
interface.
184
IGMP Commands
185
186
IGMP Commands
Chapter 21
This section provides a detailed explanation of the LAG commands. The commands are
divided into two functional groups:
port-channel staticcapability
This command enables the support of port-channels (static link aggregations - LAGs) on the
device. By default, the static capability for all port-channels is disabled.
The no version of this command disables the support of static port-channels (link
aggregations - LAGs) on the device.
Default
disabled
Syntax
Mode
Global Config
port lacpmode
This command enables Link Aggregation Control Protocol (LACP) on a port.
The no version of this command disables Link Aggregation Control Protocol (LACP) on a
port.
Default
disabled
187
Syntax
Mode
Interface Config
Global Config
port-channel
This command configures a new port-channel (LAG) and generates a logical unit/slot/port
number for the port-channel. The <name> field is a character string which allows the dash '-'
character as well as alphanumeric characters. Display this number using the show
port-channel.
The no version of this command deletes a port-channel (LAG).
Note: Before including a port in a port-channel, set the port physical mode. See
speed command.
Syntax
Mode
Global Config
188
port-channel linktrap
The no version of this command disables a port-channel (LAG). The interface is a logical
unit/slot/port for a configured port-channel. The option all sets every configured
port-channel with the same administrative mode setting.
Syntax
Mode
Global Config
port-channel linktrap
This command enables link trap notifications for the port-channel (LAG). The interface is a
logical unit/slot/port for a configured port-channel. The option all sets every configured
port-channel with the same administrative mode setting.
The no version of this command disables link trap notifications for the port-channel (LAG).
The interface is a logical unit, slot and port slot and port for a configured port-channel. The
option all sets every configured port-channel with the same administrative mode setting.
Default
enabled
Syntax
Mode
Global Config
port-channel name
This command defines a name for the port-channel (LAG). The interface is a logical unit/
slot/port for a configured port-channel, and name is an alphanumeric string up to 15
characters. This command is used to modify the name that was associated with the
port-channel when it was created.
Syntax
Mode
Global Config
189
show port-channel
Syntax
Mode
show port-channel
This command displays an overview of all port-channels (LAGs) on the switch.
Syntax
Mode
Privileged EXEC
Logical unit/slot/portValid unit, slot and port number separated by forward slashes.
Lag NameThe name of this port-channel (LAG). You may enter any string of up to 15 alphanumeric
characters.
Link StateIndicates whether the Link is up or down.
Admin ModeMay be enabled or disabled. The factory default is enabled.
Link Trap ModeThis object determines whether or not to send a trap when link status changes. The
factory default is enabled.
STP ModeThe Spanning Tree Protocol Administrative Mode associated with the port or port-channel
(LAG). The possible values are:
Disable - Spanning tree is disabled for this port.
Enable - Spanning tree is enabled for this port.
Mbr PortsA listing of the ports that are members of this port-channel (LAG), in unit/slot/port
notation. There can be a maximum of eight ports assigned to a given port-channel (LAG).
Port SpeedSpeed of the port-channel port.
TypeThis field displays the status designating whether a particular port-channel (LAG) is statically or
dynamically maintained.
190
show port-channel
Privileged EXEC
Static Capabilitywhether the device has static capability enabled.
Port-channel/LAG Summary:
Lag NameThe name of the lag.
Link StateIndicates whether the Link is up or down.
Mbr PortsA listing of the ports that are members of this lag, in slot.port notation.
Active PortsA listing of ports that are actively participating in the LAG.
191
192
Chapter 22
This chapter provides a detailed explanation of the Spanning Tree commands. The commands
are divided into two functional groups:
spanning-tree
This command sets the spanning-tree operational mode to enabled.
The no version of this command sets the spanning-tree operational mode to disabled. While
disabled, the spanning-tree configuration is retained and can be changed, but is not activated.
Default
disabled
Syntax
[no] spanning-tree
Mode
Global Config
193
The base MAC address displayed using hexadecimal notation as specified in IEEE 802
standard.
Syntax
Mode
Global Config
Syntax
Mode
Global Config
spanning-tree edgeport
This command specifies that this port is an Edge Port within the common and internal
spanning tree. This will allow this port to transition to Forwarding State without delay.
The no version of this command specifies that this port is not an Edge Port within the
common and internal spanning tree.
Syntax
Mode
194
Interface Config
spanning-tree forceversion
spanning-tree forceversion
This command sets the Force Protocol Version parameter to a new value. The Force Protocol
Version can be one of the following:
802.1d - STP BPDUs are transmitted rather than MST BPDUs (IEEE 802.1d
functionality supported)
802.1w - RST BPDUs are transmitted rather than MST BPDUs (IEEE 802.1w
functionality supported)
802.1s - MST BPDUs are transmitted (IEEE 802.1s functionality supported)
The no version of this command sets the Force Protocol Version parameter to the default
value, in other words, 802.1s.
Default
802.1s
Syntax
Mode
Global Config
spanning-tree forward-time
This command sets the Bridge Forward Delay parameter to a new value for the common and
internal spanning tree. The forward-time value is in seconds within a range of 4 to 30, with
the value being greater than or equal to "(Bridge Max Age / 2) + 1".
The no version of this command sets the Bridge Forward Delay parameter for the common
and internal spanning tree to the default value, in other words, 15.
Default
15
Syntax
Mode
Global Config
spanning-tree hello-time
This command sets the Admin Hello Time parameter to a new value for the common and
internal spanning tree. The hellotime <value> is in whole seconds within a range of 1 to 10
with the value being less than or equal to "(Bridge Max Age / 2) - 1".
195
spanning-tree max-age
The no version of this command sets the admin Hello Time parameter for the common and
internal spanning tree to the default value.
Default
Syntax
Mode
Interface Config
spanning-tree max-age
This command sets the Bridge Max Age parameter to a new value for the common and
internal spanning tree. The max-age value is in seconds within a range of 6 to 40, with the
value being less than or equal to "2 times (Bridge Forward Delay - 1)".
The no version of this command sets the Bridge Max Age parameter for the common and
internal spanning tree to the default value, in other words, 20.
Default
20
Syntax
Mode
Global Config
spanning-tree mst
This command sets the Path Cost or Port Priority for this port within the multiple spanning
tree instance or in the common and internal spanning tree. If the <mstid> parameter
corresponds to an existing multiple spanning tree instance, then the configurations are done
for that multiple spanning tree instance. If however 0 (defined as the default CIST ID) is
passed as the <mstid>, then the configurations are performed for the common and internal
spanning tree instance.
If the cost token is specified, this command sets the path cost for this port within a multiple
spanning tree instance or the common and internal spanning tree instance, depending on the
<mstid> parameter. The pathcost can be specified as a number in the range of 1 to 200000000
or auto. If "auto" is specified, the pathcost value will be set based on Link Speed.
196
no spanning-tree mst
If the external-cost token is specified, this command sets the external-path cost for MST
instance 0 in other words, CIST instance. The external pathcost can be specified as a
number in the range of 1 to 200000000 or auto. If "auto" is specified, the external pathcost
value will be set based on Link Speed.
If the port-priority token is specified, this command sets the priority for this port within a
specific multiple spanning tree instance or the common and internal spanning tree instance,
depending on the <mstid> parameter. The port-priority value is a number in the range of 0 to
240 in increments of 16.
Default
Syntax
Mode
Interface Config
no spanning-tree mst
This command sets the Path Cost or Port Priority for this port within the multiple spanning
tree instance or in the common and internal spanning tree to the respective default values. If
the <mstid> parameter corresponds to an existing multiple spanning tree instance, then the
configurations are done for that multiple spanning tree instance. If however 0 (defined as the
default CIST ID) is passed as the <mstid>, then the configurations are performed for the
common and internal spanning tree instance.
If the cost token is specified, this command sets the path cost for this port within a multiple
spanning tree instance or the common and internal spanning tree instance, depending on the
<mstid> parameter, to the default value, in other words, a pathcost value based on the Link
Speed.
If the external-cost token is specified, this command sets the external path cost for this port
for mst 0 instance, to the default value, in other words, a pathcost value based on the Link
Speed.
If the port-priority token is specified, this command sets the priority for this port within a
specific multiple spanning tree instance or the common and internal spanning tree instance,
depending on the <mstid> parameter, to the default value, in other words, 128.
Syntax
Mode
Interface Config
197
Mode
Global Config
The no version of this command sets the bridge priority for a specific multiple spanning tree
instance to the default value, in other words, 32768. The instance <mstid> is a number that
corresponds to the desired existing multiple spanning tree instance.
If 0 (defined as the default CIST ID) is passed as the <mstid>, then this command sets the
Bridge Priority parameter for the common and internal spanning tree to the default value, in
other words, 32768.
Default
32768
Syntax
Mode
198
Global Config
Mode
Global Config
disabled
Syntax
Mode
Interface Config
disabled
Syntax
199
spanning-tree
Mode
Global Config
spanning-tree
This command sets the STP mode for a specific port-channel (LAG). This is the value
specified for STP Mode on the Port Configuration Menu. 802.1D mode is the default. The
interface is a logical unit, slot and port slot and port for a configured port-channel. The all
option sets all configured port-channels (LAGs) with the same option.
Syntax
Mode
Global Config
The mode is one of the following:
802.1dIEEE 802.1D-compliant STP mode is used
fastFast STP mode is used
offSTP is turned off
spanning-tree bpdumigrationcheck
This command enables BPDU migration check on a given interface. The all option enables
BPDU migration check on all interfaces.
The no version of this command disables BPDU migration check on a given interface. The
all option disables BPDU migration check on all interfaces.
Syntax
Mode
Global Config
show spanning-tree
This command displays spanning tree settings for the common and internal spanning tree,
when the optional parameter brief is not included in the command. The following details
are displayed.
Syntax
200
show spanning-tree
Mode
When the brief optional parameter is included, this command displays spanning tree
settings for the bridge. In this case, the following details are displayed.
Bridge PrioritySpecifies the bridge priority for the spanning tree.
Bridge IdentifierThe bridge identifier for the selected instance.
Bridge Max AgeSpecifies the bridge maximum age for the spanning tree.
Hello TimeConfigured value of the parameter for the common spanning tree.
Bridge Forwarding DelaySpecifies the time spent in Listening and Learning mode before forwarding
packets. Bridge Forwarding Delay must be greater or equal to (Bridge Max Age/2) + 1. The time range
is from 4 seconds to 30 seconds. The default value is 15.
Bridge Hold TimeMinimum time between transmission of Configuration Bridge Protocol Data Units
(BPDUs).
201
202
Designated RootIdentifier of the Regional Root for this multiple spanning tree instance.
Root Path CostPath Cost to the Designated Root for this multiple spanning tree instance.
Root Port IdentifierPort to access the Designated Root for this multiple spanning tree instance.
Associated FIDsList of forwarding database identifiers associated with this instance.
Associated VLANsList of VLAN IDs associated with this instance.
If 0 (defined as the default CIST ID) is passed as the <mstid>, then this command displays the
settings and parameters for a specific switch port within the common and internal spanning
tree. The <unit/slot/port> is the desired switch port. In this case, the following are
displayed.
Port IdentifierThe port identifier for this port within the CST.
Port PriorityThe priority of the port within the CST.
Port Forwarding StateThe forwarding state of the port within the CST.
203
204
Mode
205
spanning-tree max-hops
This command sets the MSTP Max Hops parameter to a new value for the common and
internal spanning tree. The max-hops value is in a range of 1 to 127.
The no version of this command sets the Bridge Max Hops parameter for the common and
internal spanning tree to the default value.
Default
20
Syntax
Mode
206
Global Config
Chapter 23
Security Commands
This section provides a detailed explanation of the Security commands. The commands are
divided into the following groups:
Configuration commands are used to configure features and options of the switch. For
every configuration command there is a show command that will display the
configuration setting.
Show commands are used to display switch settings, statistics and other information.
Port Security
This section provides a detailed explanation of the Port Security commands. The commands
are divided into the following groups:
Configuration commands are used to configure features and options of the switch. For
every configuration command there is a show command that will display the
configuration setting.
Show commands are used to display switch settings, statistics and other information.
port-security
This command enables port locking at the system level (Global Config) or port level
(Interface Config).
The no version of this command disables port locking at the system level (Global Config) or
port level (Interface Config).
Default
Disabled
Syntax
[no] port-security
Modes
207
port-security max-dynamic
port-security max-dynamic
This command sets the maximum of dynamically locked MAC addresses allowed on a
specific port.
The no version of this command resets the maximum of dynamically locked MAC addresses
allowed on a specific port to its default value.
Default
600
Syntax
Mode
Interface Config
port-security max-static
This command sets the maximum number of statically locked MAC addresses allowed on a
specific port.
The no version of this command resets the maximum of statically locked MAC addresses
allowed on a specific port to its default value.
Default
20
Syntax
Mode
Interface Config
port-security mac-address
This command adds a MAC address to the list of statically locked MAC addresses. The <vid>
is the VLAN ID.
The no version of this command removes a MAC address from the list of statically locked
MAC addresses.
Syntax
208
Security Commands
Interface Config
Interface Config
Disabled
Syntax
Mode
Interface Config
show port-security
This command displays the port-security settings for the entire system.
Syntax
Mode
show port-security
Privileged EXEC
Admin ModePort Locking mode for the entire system
209
show port-security
show port-security
This command displays the port-security settings for a particular interface or all interfaces.
Syntax
Mode
Privileged EXEC
Interface Admin ModePort Locking mode for the Interface.
Dynamic LimitMaximum dynamically allocated MAC Addresses.
Static LimitMaximum statically allocated MAC Addresses.
Violation Trap ModeWhether violation traps are enabled.
Privileged EXEC
MAC Address of dynamically locked MAC.
Privileged EXEC
MAC AddressMAC Address of statically locked MAC.
210
Security Commands
Privileged EXEC
MAC AddressMAC Address of discarded packet on locked port.
Configuration commands are used to configure features and options of the switch. For
every configuration command there is a show command that will display the
configuration setting.
Show commands are used to display switch settings, statistics and other information.
authentication login
This command creates an authentication login list. The listname is up to 15 alphanumeric
characters and is not case sensitive. Up to 10 authentication login lists can be configured on
the switch. When a list is created, the authentication method local is set as the first method.
When the optional parameters Option1, Option2 and/or Option3 are used, an ordered
list of methods are set in the authentication login list. If the authentication login list does not
exist, a new authentication login list is first created and then the authentication methods are
set in the authentication login list. The maximum number of authentication login methods is
three. The possible method values are local, radius and reject.
The value of local indicates that the users locally stored ID and password are used for
authentication. The value of radius indicates that the users ID and password will be
authenticated using the RADIUS server. The value of reject indicates the user is never
authenticated.
To authenticate a user, the authentication methods in the users login will be attempted in
order until an authentication attempt succeeds or fails.
The no version of this command deletes the specified authentication login list. The attempt to
delete will fail if any of the following conditions are true:
SFTOS Command Line Interface Reference, Version 2.1.4
211
The login list name is invalid or does not match an existing authentication login list
The specified authentication login list is assigned to any user or to the non configured
user for any component
The login list is the default login list included with the default configuration and was not
created using authentication login. The default login list cannot be deleted.
Note: The default login list included with the default configuration can not be changed.
Syntax
Mode
Global Config
Privileged EXEC
Privileged EXEC
dot1x defaultlogin
This command assigns the authentication login list to use for non-configured users for 802.1x
port security. This setting is over-ridden by the authentication login list assigned to a specific
user if the user is configured locally. If this value is not configured, users will be
authenticated using local authentication only.
Syntax
212
dot1x initialize
Mode
Global Config
dot1x initialize
This command begins the initialization sequence on the specified port. This command is only
valid if the control mode for the specified port is 'auto'. If the control mode is not 'auto' an
error will be returned.
Syntax
Mode
Privileged EXEC
dot1x login
This command assigns the specified authentication login list to the specified user for 802.1x
port security. The user parameter must be a configured user and the listname parameter
must be a configured authentication login list.
Syntax
Mode
Global Config
dot1x max-req
This command sets the maximum number of times the authenticator state machine on this
port will transmit an EAPOL EAP Request/Identity frame before timing out the supplicant.
The count value must be in the range 1 - 10.
The no version of this command sets the maximum number of times the authenticator state
machine on this port will transmit an EAPOL EAP Request/Identity frame before timing out
the supplicant.
Default
Syntax
Mode
Interface Config
213
dot1x port-control
dot1x port-control
This command sets the authentication mode to be used on the specified port. The control
mode may be one of the following.
Force-unauthorizedThe authenticator PAE unconditionally sets the controlled port to
unauthorized.
Force-authorizedThe authenticator PAE unconditionally sets the controlled port to
authorized.
AutoThe authenticator PAE sets the controlled port mode to reflect the outcome of the
authentication exchanges between the supplicant, authenticator and the authentication server.
The no version of this command sets the authentication mode to be used on the specified port
to 'auto'.
Default
auto
Syntax
Mode
Interface Config
auto
Syntax
Mode
214
Global Config
Security Commands
dot1x re-authenticate
dot1x re-authenticate
This command begins the re-authentication sequence on the specified port. This command is
only valid if the control mode for the specified port is 'auto'. If the control mode is not 'auto'
an error will be returned.
Syntax
Mode
Privileged EXEC
dot1x re-authentication
This command enables re-authentication of the supplicant for the specified port.
The no version of this command disables re-authentication of the supplicant for the specified
port.
Default
disabled
Syntax
dot1x re-authentication
Mode
Interface Config
dot1x system-auth-control
This command is used to enable the dot1x authentication support on the switch. By default,
the authentication support is disabled. While disabled, the dot1x configuration is retained and
can be changed, but is not activated.
The no version of this command is used to disable the dot1x authentication support on the
switch.
Default
disabled
Syntax
dot1x system-auth-control
Mode
Global Config
215
dot1x timeout
dot1x timeout
This command sets the value, in seconds, of the timer used by the authenticator state machine
on this port. Depending on the token used and the value (in seconds) passed, various timeout
configurable parameters are set. The following tokens are supported.
The no version of this command sets the value, in seconds, of the timer used by the
authenticator state machine on this port to the default values. Depending on the token used,
the corresponding default values are set.
Parameters
reauth-periodSets the value, in seconds, of the timer used by the authenticator state machine on this
port to determine when re-authentication of the supplicant takes place. The reauth-period must be a
value in the range 1 - 65535.
quiet-periodSets the value, in seconds, of the timer used by the authenticator state machine on this
port to define periods of time in which it will not attempt to acquire a supplicant. The quiet-period must
be a value in the range 0 - 65535.
tx-periodSets the value, in seconds, of the timer used by the authenticator state machine on this port
to determine when to send an EAPOL EAP Request/Identity frame to the supplicant. The quiet-period
must be a value in the range 1 - 65535.
supp-timeoutSets the value, in seconds, of the timer used by the authenticator state machine on this
port to timeout the supplicant. The supp-timeout must be a value in the range 1 - 65535.
server-timeoutSets the value, in seconds, of the timer used by the authenticator state machine on this
port to timeout the authentication server. The supp-timeout must be a value in the range 1 - 65535.
Default
Syntax
Mode
216
Interface Config
Security Commands
dot1x user
dot1x user
This command adds the specified user to the list of users with access to the specified port or
all ports. The user parameter must be a configured user.
The no version of this command removes the user from the list of users with access to the
specified port or all ports.
Syntax
Mode
Global Config
show accounting
This command is used to display the configured RADIUS accounting mode, accounting
server and the statistics for the configured accounting server.
Syntax
Mode
Privileged EXEC
If the optional token statistics ipaddr is not included, then only the accounting mode and
the RADIUS accounting server details are displayed.
Mode
Parameters
Enabled or disabled
IP AddressThe configured IP address of the RADIUS accounting server
PortThe port in use by the RADIUS accounting server
Secret ConfiguredYes or No
If the optional token statistics ipaddr is included, the statistics for the configured RADIUS
accounting server are displayed. The IP address parameter must match that of a previously
configured RADIUS accounting server. The following information regarding the statistics of
the RADIUS accounting server is displayed.
Accounting Server IP AddressIP Address of the configured RADIUS accounting server
Round Trip TimeThe time interval, in hundredths of a second, between the most recent
Accounting-Response and the Accounting-Request that matched it from the RADIUS accounting server.
RequestsThe number of RADIUS Accounting-Request packets sent to this accounting server. This
number does not include retransmissions.
RetransmissionThe number of RADIUS Accounting-Request packets retransmitted to this RADIUS
accounting server.
ResponsesThe number of RADIUS packets received on the accounting port from this server.
217
show authentication
show authentication
This command displays the ordered authentication methods for all authentication login lists.
Syntax
Mode
show authentication
Privileged EXEC
Authentication Login ListThis displays the authentication login listname.
Method 1This displays the first method in the specified authentication login list, if any.
Method 2This displays the second method in the specified authentication login list, if any.
Method 3This displays the third method in the specified authentication login list, if any.
Privileged EXEC
UserThis field displays the user assigned to the specified authentication login list.
218
Security Commands
show dot1x
ComponentThis field displays the component (User or 802.1x) for which the authentication login list is
assigned.
show dot1x
This command is used to show a summary of the global dot1x configuration, summary
information of the dot1x configuration for a specified port or all ports, the detailed dot1x
configuration for a specified port and the dot1x statistics for a specified port - depending on
the tokens used.
Syntax
Mode
Privileged EXEC
If none of the optional parameters are used, the global dot1x configuration summary is
displayed.
Administrative modeIndicates whether authentication control on the switch is enabled or disabled.
If the optional parameter summary {unit/slot/port | all} is used, the dot1x configuration
for the specified port or all ports are displayed.
PortThe interface whose configuration is displayed.
Control ModeThe configured control mode for this port. Possible values are force-unauthorized |
force-authorized | auto
Operating Control ModeThe control mode under which this port is operating. Possible values are
authorized | unauthorized
Reauthentication EnabledIndicates whether re-authentication is enabled on this port
Key Transmission EnabledIndicates if the key is transmitted to the supplicant for the specified port
If the optional parameter detail unit/slot/port is used, the detailed dot1x configuration for
the specified port are displayed.
PortThe interface whose configuration is displayed
Protocol VersionThe protocol version associated with this port. The only possible value is 1,
corresponding to the first version of the dot1x specification.
PAE CapabilitiesThe port access entity (PAE) functionality of this port. Possible values are
Authenticator or Supplicant.
Authenticator PAE StateCurrent state of the authenticator PAE state machine. Possible values are
Initialize, Disconnected, Connecting, Authenticating, Authenticated, Aborting, Held, ForceAuthorized,
and ForceUnauthorized.
219
show dot1x
Backend Authentication StateCurrent state of the backend authentication state machine. Possible
values are Request, Response, Success, Fail, Timeout, Idle, and Initialize.
Quiet PeriodThe timer used by the authenticator state machine on this port to define periods of time in
which it will not attempt to acquire a supplicant. The value is expressed in seconds and will be in the
range 0 and 65535.
Transmit PeriodThe timer used by the authenticator state machine on the specified port to determine
when to send an EAPOL EAP Request/Identity frame to the supplicant. The value is expressed in
seconds and will be in the range of 1 and 65535.
Supplicant TimeoutThe timer used by the authenticator state machine on this port to timeout the
supplicant. . The value is expressed in seconds and will be in the range of 1 and 65535.
Server TimeoutThe timer used by the authenticator on this port to timeout the authentication server.
The value is expressed in seconds and will be in the range of 1 and 65535.
Maximum RequestsThe maximum number of times the authenticator state machine on this port will
retransmit an EAPOL EAP Request/Identity before timing out the supplicant. The value will be in the
range of 1 and 10.
Reauthentication PeriodThe timer used by the authenticator state machine on this port to determine
when reauthentication of the supplicant takes place. The value is expressed in seconds and will be in
the range of 1 and 65535.
Reauthentication EnabledIndicates if reauthentication is enabled on this port. Possible values are
True or False.
Key Transmission Enabled Indicates if the key is transmitted to the supplicant for the specified port.
Possible values are True or False.
Control DirectionIndicates the control direction for the specified port or ports. Possible values are
both or in.
If the optional parameter statistics unit/slot/port is used, the dot1x statistics for the
specified port are displayed.
PortThe interface whose statistics are displayed.
EAPOL Frames ReceivedThe number of valid EAPOL frames of any type that have been received by
this authenticator.
EAPOL Frames TransmittedThe number of EAPOL frames of any type that have been transmitted by
this authenticator.
EAPOL Start Frames ReceivedThe number of EAPOL start frames that have been received by this
authenticator.
EAPOL Logoff Frames ReceivedThe number of EAPOL logoff frames that have been received by this
authenticator.
Last EAPOL Frame VersionThe protocol version number carried in the most recently received EAPOL
frame.
Last EAPOL Frame SourceThe source MAC address carried in the most recently received EAPOL
frame.
220
Security Commands
EAP Response/Id Frames ReceivedThe number of EAP response/identity frames that have been
received by this authenticator.
EAP Response Frames ReceivedThe number of valid EAP response frames (other than resp/id
frames) that have been received by this authenticator.
EAP Request/Id Frames TransmittedThe number of EAP request/identity frames that have been
transmitted by this authenticator.
EAP Request Frames TransmittedThe number of EAP request frames (other than request/identity
frames) that have been transmitted by this authenticator.
Invalid EAPOL Frames ReceivedThe number of EAPOL frames that have been received by this
authenticator in which the frame type is not recognized.
EAP Length Error Frames ReceivedThe number of EAPOL frames that have been received by this
authenticator in which the frame type is not recognized.
Privileged EXEC
UserUsers configured locally to have access to the specified port.
Privileged EXEC
UserThis field lists every user that has an authentication login list assigned.
System LoginThis field displays the authentication login list assigned to the user for system login.
802.1x Port SecurityThis field displays the authentication login list assigned to the user for 802.1x port
security.
221
users defaultlogin
users defaultlogin
This command assigns the authentication login list to use for non-configured users when
attempting to log in to the system. This setting is overridden by the authentication login list
assigned to a specific user if the user is configured locally. If this value is not configured,
users will be authenticated using local authentication only.
Syntax
Mode
Global Config
users login
This command assigns the specified authentication login list to the specified user for system
login. The user must be a configured user and the listname must be a configured login list.
If the user is assigned a login list that requires remote authentication, all access to the
interface from all CLI, web, and telnet sessions will be blocked until the authentication is
complete.
Note that the login list associated with the admin user can not be changed to prevent
accidental lockout from the switch.
Syntax
Mode
Global Config
222
Configuration commands are used to configure features and options of the switch. For
every configuration command there is a show command that will display the
configuration setting.
Show commands are used to display switch settings, statistics and other information.
Security Commands
disabled
Syntax
Mode
Global Config
223
Mode
Global Config
Global Config
Global Config
224
Global Config
Security Commands
10
Syntax
Mode
Global Config
Syntax
Mode
Global Config
show radius
This command is used to display the various RADIUS configuration items for the switch as
well as the configured RADIUS servers. If the optional token 'servers' is not included, the
following RADIUS configuration items will be displayed.
Syntax
225
Mode
Privileged EXEC
Primary Server IP AddressIndicates the configured server currently in use for authentication
Number of configured serversThe configured IP address of the authentication server
Max number of retransmitsThe configured value of the maximum number of times a request packet is
retransmitted
Timeout DurationThe configured timeout value, in seconds, for request re-transmissions
Accounting ModeYes or No
If the optional token 'servers' is included, the following information regarding the configured
RADIUS servers is displayed.
IP AddressIP Address of the configured RADIUS server
PortThe port in use by this server
TypePrimary or secondary
Secret ConfiguredYes / No
Privileged EXEC
If ip address is not specified than only Invalid Server Address field is displayed. Otherwise
other listed fields are displayed.
Invalid Server AddressesThe number of RADIUS Access-Response packets received from unknown
addresses.
Server IP AddressIP address of the server.
Round Trip TimeThe time interval, in hundredths of a second, between the most recent Access-Reply
| Access-Challenge and the Access-Request that matched it from the RADIUS authentication server.
Access RequestsThe number of RADIUS Access-Request packets sent to this server. This number
does not include retransmissions.
Access RetransmissionThe number of RADIUS Access-Request packets retransmitted to this
RADIUS authentication server.
226
Security Commands
ip ssh
Access AcceptsThe number of RADIUS Access-Accept packets, including both valid and invalid
packets, which were received from this server.
Access RejectsThe number of RADIUS Access-Reject packets, including both valid and invalid
packets, which were received from this server.
Access ChallengesThe number of RADIUS Access-Challenge packets, including both valid and
invalid packets, which were received from this server.
Malformed Access ResponsesThe number of malformed RADIUS Access-Response packets
received from this server. Malformed packets include packets with an invalid length. Bad authenticators
or signature attributes or unknown types are not included as malformed access responses.
Bad AuthenticatorsThe number of RADIUS Access-Response packets containing invalid
authenticators or signature attributes received from this server.
Pending RequestsThe number of RADIUS Access-Request packets destined for this server that have
not yet timed out or received a response.
TimeoutsThe number of authentication timeouts to this server.
Unknown TypesThe number of RADIUS packets of unknown types, which were received from this
server on the authentication port.
Packets DroppedThe number of RADIUS packets received from this server on the authentication port
and dropped for some other reason.
Configuration commands are used to configure features and options of the switch. For
every configuration command there is a show command that will display the
configuration setting.
Show commands are used to display switch settings, statistics and other information.
ip ssh
This command is used to enable SSH.
The no version of this command is used to disable SSH.
Default
disabled
Syntax
ip ssh
no ip ssh
Mode
Privileged EXEC
227
show ip ssh
show ip ssh
This command displays the ssh settings.
Syntax
Mode
show ip ssh
Privileged EXEC
Administrative ModeThis field indicates whether the administrative mode of SSH is enabled or
disabled.
Protocol LevelThe protocol level may have the values of version 1, version 2 or both versions 1 and
version 2.
ConnectionsThis field specifies the current ssh connections.
ip ssh protocol
This command is used to set or remove protocol levels (or versions) for SSH. Either SSH1
(1), SSH2 (2), or both SSH 1 and SSH 2 (1 and 2) can be set.
Default
1 and 2
Syntax
Mode
Privileged EXEC
sshcon maxsessions
This command specifies the maximum number of SSH connection sessions that can be
established. A value of 0 indicates that no ssh connection can be established. The range is 0 to
5.
The no command sets the maximum number of SSH connection sessions that can be
established to the default value.
Default
Syntax
Mode
228
Privileged EXEC
Security Commands
sshcon timeout
sshcon timeout
This command sets the SSH connection session timeout value, in minutes. A session is active
as long as the session has been idle for the value set. A value of 0 indicates that a session
remains active indefinitely. The time is a decimal value from 0 to 160.
Changing the timeout value for active sessions does not become effective until the session is
reaccessed. Any keystroke will also activate the new timeout duration.
The no version of this command sets the SSH connection session timeout value, in minutes,
to the default.
Changing the timeout value for active sessions does not become effective until the session is
reaccessed. Any keystroke will also activate the new timeout duration.
Default
Syntax
Mode
Privileged EXEC
Configuration commands are used to configure features and options of the switch. For
every configuration command there is a show command that will display the
configuration setting.
Show commands are used to display switch settings, statistics and other information.
ip http secure-port
This command is used to set the sslt port where port can be 1-65535 and the default is port
443.
The no version of this command is used to reset the sslt port to the default value.
Default
443
Syntax
229
ip http secure-protocol
Mode
Privileged EXEC
ip http secure-protocol
This command is used to set protocol levels (versions). The protocol level can be set to TLS1,
SSL3 or to both TLS1 and SSL3.
Default
Syntax
Mode
Privileged EXEC
ip http secure-server
This command is used to enable the secure socket layer for secure HTTP.
The no version of this command is used to disable the secure socket layer for secure HTTP.
Default
disabled
Syntax
Mode
Privileged EXEC
ip http server
This command enables access to the switch through the Web interface. When access is
enabled, the user can login to the switch from the Web interface. When access is disabled, the
user cannot login to the switch's Web server.
Disabling the Web interface takes effect immediately. All interfaces are effected.
The no version of this command disables access to the switch through the Web interface.
When access is disabled, the user cannot login to the switch's Web server.
230
Default
enabled
Syntax
ip http server
Security Commands
show ip http
Mode
Privileged EXEC
show ip http
This command displays the http settings for the switch.
Syntax
Mode
show ip http
Privileged EXEC
Secure-Server Administrative ModeThis field indicates whether the administrative mode of secure
HTTP is enabled or disabled.
Secure Protocol LevelThe protocol level may have the values of SSL3, TSL1, or both SSL3 and
TSL1.
Secure PortThis field specifies the port configured for SSLT.
HTTP ModeTHis field indicates whether the HTTP mode is enabled or disabled.
231
show ip http
232
Security Commands
Chapter 24
This chapter provides a detailed explanation of the Quality of Service (QOS) commands. The
following QOS commands are available in the FASTPATH software QOS module.
The commands are divided into these different groups:
Show commands are used to display device settings, statistics and other information.
Configuration Commands are used to configure features and options of the switch. For
every configuration command there is a show command that will display the
configuration setting.
233
The no version of this command deletes a MAC ACL identified by <name> from the system.
Syntax
Mode
Global Config
234
Global Config
{deny|permit}
{deny|permit}
This command creates a new rule for the current MAC access list. Each rule is appended to
the list of configured rules for the list. Note that an implicit 'deny all' MAC rule always
terminates the access list.
Note: The 'no' form of this command is not supported, as the rules within an ACL
cannot be deleted individually. Rather, the entire ACL must be deleted and
re-specified.
A rule may either deny or permit traffic according to the specified classification fields. At a
minimum, the source and destination MAC value and mask pairs must be specified, each of
which may be substituted using the keyword any to indicate a match on any value in that
field. The bpdu keyword may be specified for the destination MAC value/mask pair
indicating a well-known BPDU MAC value of 01-80-c2-xx-xx-xx (hex), where 'xx' indicates
a don't care. The remaining command parameters are all optional.
The Ethertype may be specified as either a keyword or a four-digit hexadecimal value from
0x0600-0xFFFF. The currently supported <ethertypekey> values are: appletalk, arp,
ibmsna, ipv4, ipv6, ipx, mplsmcast, mplsucast, netbios, novell, pppoe, rarp. Each of these
translates into its equivalent Ethertype value(s).
The assign-queue parameter allows specification of a particular hardware queue for handling
traffic that matches this rule. The allowed <queue-id> value is 0-(n-1), where n is the number
of user configurable queues available for the hardware platform. The redirect parameter
allows the traffic matching this rule to be forwarded to the specified <unit/slot/port>. The
assign-queue and redirect parameters are only valid for a 'permit' rule.
Syntax
Note: The special command form {deny|permit} any any is used to match all
Ethernet layer 2 packets, and is the equivalent of the IP access list "match every"
rule.
Mode
Mac-Access-List Config
mac access-group
This command attaches a specific MAC Access Control List (ACL) identified by <name> to
an interface in a given direction. The <name> parameter must be the name of an exsiting
MAC ACL.
SFTOS Command Line Interface Reference, Version 2.1.4
235
An optional sequence number may be specified to indicate the order of this access list relative
to other access lists already assigned to this interface and direction. A lower number indicates
higher precedence order. If a sequence number is already in use for this interface and
direction, the specified access list replaces the currently attached access list using that
sequence number. If the sequence number is not specified for this command, a sequence
number that is one greater than the highest sequence number currently in use for this interface
and direction will be used.
This command specified in 'Interface Config' mode only affects a single interface, whereas
the 'Global Config' mode setting is applied to all interfaces. The 'Interface Config' mode
command is only available on platforms that support independent per-port class of service
queue configuration.
The no version of this command removes a MAC ACL identified by <name> from the
interface in a given direction.
Syntax
Modes
Privileged EXEC
Rule NumberThe ordered rule number identifier defined within the ACL.
ActionDisplays the action associated with each rule. The possible values are Permit or Deny.
Source MAC AddressDisplays the source MAC address for this rule.
Source MAC MaskDisplays the source MAC mask for this rule.
Destination MAC AddressDisplays the destination MAC address for this rule.
Destination MAC MaskDisplays the destination MAC mask for this rule.
EthertypeDisplays the Ethertype keyword or custom value for this rule.
VLAN IDDisplays the VLAN identifier value or range for this rule.
COSDisplays the COS (802.1p) value for this rule.
236
Secondary VLAN IDDisplays the Secondary VLAN identifier value or range for this rule.
Secondary COSDisplays the Secondary COS (802.1p) value for this rule.
Assign QueueDisplays the queue identifier to which packets matching this rule are assigned.
Redirect InterfaceDisplays the unit/slot/port to which packets matching this rule are forwarded.
Privileged EXEC
NameThe name of the MAC access list.
Number of RulesThe number of user-configured rules defined for this ACL.
This does not include the implicit 'deny all' rule defined at the end of every MAC ACL.
InterfacesDisplays the list of interfaces (unit/slot/port) to which this MAC ACL is attached in a
given direction.
DirectionDenotes the direction in which this MAC ACL is attached to the set of interfaces listed. The
possible values are Inbound or Outbound.
access-list
This command creates an Access Control List (ACL) that is identified by the parameter
accesslistnumber. The ACL number is an integer from 1 to 199. The range 1 to 99 is for
normal ACL List and 100 to 199 is extended ACL List. The ACL rule is created with the
option of permit or deny . The protocol to filter for an ACL rule is specified by giving the
protocol to be used like cmp,igmp,ip,tcp,udp. The command specifies a source ipaddress
and source mask for match condition of the ACL rule specified by the srcip and srcmask
parameters.The source layer 4 port match condition for the ACL rule are specified by the port
value parameter.The startport and endport parameters identify the first and last ports that
are part of the port range. They have values from 0 to 65535. The ending port must have a
value equal or greater than the starting port. The starting port, ending port, and all ports in
between will be part of the destination port range.The portvalue parameter uses a single
keyword notation and currently has the values of domain, echo, ftp, ftpdata, http, smtp,
snmp, telnet, tftp, and www. Each of these values translates into its equivalent port number,
237
ip access-group
which is used as both the start and end of a port range. The command specifies a destination
ipaddress and destination mask for match condition of the ACL rule specified by the dstip
and dstmask parameters.The command specifies the TOS for an ACL rule depending on a
match of precedence or DSCP values using the parameters tos, tosmask ,dscp.
The no version of this command deletes an ACL that is identified by the parameter
accesslistnumber from the system.
Default
none
Syntax
access-list {( 1-99 {deny | permit} srcip srcmask) | ( {100-199 {deny | permit} {evry |
{{icmp | igmp | ip | tcp | udp | number} srcip srcmask [{eq {portkey | portvalue} |
range startport endport}] dstip dstmask [{eq {portkey | portvalue} | range startport
endport}] [precedence precedence] [tos tos tosmask] [dscp dscp]}})}
no access-list accesslistnumber
Mode
Global Config
ip access-group
This command attach a specified access-control list to an interface.
Default
none
Syntax
Mode
Interface Config
ip access-group all
This command attach a specified access-control list to all interfaces.
Default
none
Syntax
Mode
238
Global Config
show ip access-lists
show ip access-lists
This command displays an Access Control List (ACL) and all of the rules that are defined for
the ACL. The accesslistnumber is the number used to identify the ACL.
Syntax
Mode
239
show ip access-lists
240
Chapter 25
Differentiated Services
(DiffServ)
This chapter contains the CLI commands used for the QOS Differentiated Services (DiffServ)
package.
The user configures DiffServ in several stages by specifying:
Class
adding and removing a policy to/from a directional (i.e., inbound, outbound) interface
Policy
Service
Packets are filtered and processed based on defined criteria. The filtering criteria is defined
by a class. The processing is defined by a policy's attributes. Policy attributes may be
defined on a per-class instance basis, and it is these attributes that are applied when a match
occurs.
Packet processing begins by testing the match criteria for a packet. A policy is applied to a
packet when a class match within that policy is found.
Note that the type of class - all, any, or acl - has a bearing on the validity of match criteria
specified when defining the class. A class type of 'any' processes its match rules in an ordered
sequence; additional rules specified for such a class simply extend this list. A class type of
acl obtains its rule list by interpreting each ACL rule definition at the time the Diffserv class
is created. Differences arise when specifying match criteria for a class type 'all', since only
one value for each non-excluded match field is allowed within a class definition. If a field is
SFTOS Command Line Interface Reference, Version 2.1.4
241
diffserv
already specified for a class, all subsequent attempts to specify the same field fail, including
the cases where a field can be specified multiple ways through alternative formats. The
exception to this is when the 'exclude' option is specified, in which case this restriction does
not apply to the excluded fields.
The following class restrictions are imposed by the FASTPATH DiffServ design:
Regarding nested classes, referred to here as class references, a given class definition can
contain at most one reference to another class, which can be combined with other match
criteria. The referenced class is truly a reference and not a copy, since additions to a
referenced class affect all classes that reference it. Changes to any class definition currently
referenced by any other class must result in valid class definitions for all derived classes
otherwise the change is rejected. A class reference may be removed from a class definition.
The user can display summary and detailed information for classes, policies and services. All
configuration information is accessible via the CLI, Web, and SNMP user interfaces.
diffserv
This command sets the DiffServ operational mode to active. While disabled, the DiffServ
configuration is retained and can be changed, but it is not activated. When enabled, Diffserv
services are activated.
The no version of this command sets the DiffServ operational mode to inactive. While
disabled, the DiffServ configuration is retained and can be changed, but it is not activated.
When enabled, Diffserv services are activated.
242
Syntax
[no] diffserv
Mode
Global Config
class-map
Class Commands
The class command set is used in DiffServ to define:
Traffic ClassificationSpecify Behavior Aggregate (BA), based on DSCP, and Multi-Field
(MF) classes of traffic (name, match criteria)
Service LevelsSpecify the BA forwarding classes / service levels. Conceptually, DiffServ
is a two-level hierarchy of classes: 1. Service/PHB, 2. Traffic Class
This set of commands consists of class creation/deletion and matching, with the class match
commands specifying layer 3, layer 2, and general match criteria. The class match criteria are
also known as class rules, with a class definition consisting of one or more rules to identify
the traffic belonging to the class. Note that once a class match criterion is created for a class,
it cannot be changed or deleted - the entire class must be deleted and re-created.
The CLI command root is class-map.
class-map
This command defines a new DiffServ class of type match-all, match-any or
match-access-group. The <classname> parameter is a case sensitive alphanumeric string
from 1 to 31 characters uniquely identifying the class (Note: the class name 'default' is
reserved and must not be used here).
When used without any match condition, this command enters the class-map mode. The
<classname> is the name of an existing DiffServ class (note: the class name 'default' is
reserved and is not allowed here)
The class type of match-all indicates all of the individual match conditions must be true for a
packet to be considered a member of the class.
This command may be used without specifying a class type to enter the Class-Map Config
mode for an existing DiffServ class.
Note: The CLI mode is changed to Class-Map Config when this command is
successfully executed.
The no version of this command eliminates an existing DiffServ class. The <classname> is
the name of an existing DiffServ class ( Note: the class name 'default' is reserved and is not
allowed here). This command may be issued at any time; if the class is currently referenced
by one or more policies or by any other class, this deletion attempt shall fail.
Syntax
243
class-map rename
no class-map <classname>
Mode
Global Config
class-map rename
This command changes the name of a DiffServ class. The <classname> is the name of an
existing DiffServ class. The <newclassname> parameter is a case-sensitive alphanumeric
string from 1 to 31 characters uniquely identifying the class (Note: the class name default is
reserved and must not be used here).
Default
none
Syntax
Mode
Global Config
match ethertype
This command adds to the specified class definition a match condition based on the value of
the ethertype. The <ethertype> value is specified as one of the following keywords:
appletalk, arp, ibmsna, ipv4, ipv6, ipx, mplsmcast, mplsucast, netbios, novell,
pppoe, rarp or as a custom ethertype value in the range of 0x0600-0xFFFF.
Syntax
Mode
Class-Map Config
match any
This command adds to the specified class definition a match condition whereby all packets
are considered to belong to the class.
Default
none
Syntax
match any
Mode
244
Class-Map Config
match class-map
match class-map
This command adds to the specified class definition the set of match conditions defined for
another class. The <refclassname> is the name of an existing DiffServ class whose match
conditions are being referenced by the specified class definition.
The no version of this command removes from the specified class definition the set of match
conditions defined for another class. The <refclassname> is the name of an existing DiffServ
class whose match conditions are being referenced by the specified class definition.
Default
none
Syntax
Mode
Restrictions
Class-Map Config
The class types of both <classname> and <refclassname> must be identical (i.e., any vs. any, or all
vs. all). A class type of acl is not supported by this command.
Cannot specify <refclassname> the same as <classname> (i.e., self-referencing of class name not
allowed).
At most one other class may be referenced by a class.
Any attempt to delete the <refclassname> class while still referenced by any <classname> shall
fail.
The combined match criteria of <classname> and <refclassname> must be an allowed
combination based on the class type. Any subsequent changes to the <refclassname> class match
criteria must maintain this validity, or the change attempt shall fail.
The total number of class rules formed by the complete reference class chain (includes both
predecessor and successor classes) must not exceed a platform-specific maximum.
In some cases, each removal of a refclass rule reduces the maximum number of available rules in the
class definition by one.
match cos
This command adds to the specified class definition a match condition for the Class of
Service value (the only tag in a single tagged packet or the first or outer 802.1Q tag of a
double VLAN tagged packet). The value may be from 0 to 7.
Default
none
Syntax
Mode
Class-Map Config
245
none
Syntax
Mode
Class-Map Config
match dstip
This command adds to the specified class definition a match condition based on the
destination IP address of a packet. The <ipaddr> parameter specifies an IP address. The
<ipmask> parameter specifies an IP address bit mask; note that although similar to a standard
subnet mask, this bit mask need not be contiguous.
Default
none
Syntax
Mode
Class-Map Config
match dstl4port
This command adds to the specified class definition a match condition based on the
destination layer 4 port of a packet using a single keyword or numeric notation or a numeric
range notation.
To specify the match condition as a single keyword, the value for <portkey> is one of the
supported port name keywords. The currently supported <portkey> values are: domain,
echo, ftp, ftpdata, http, smtp, snmp, telnet, tftp, www. Each of these translates into its
equivalent port number, which is used as both the start and end of a port range.
To specify the match condition using a numeric notation, one layer 4 port number is required.
The port number is an integer from 0 to 65535.
246
match ip dscp
To specify the match condition using a numeric range notation, two layer 4 port numbers are
required and together they specify a contiguous port range. Each port number is an integer
from 0 to 65535, but with the added requirement that the second number be equal to or greater
than the first.
Default
none
Syntax
Mode
Class-Map Config
match ip dscp
This command adds to the specified class definition a match condition based on the value of
the IP DiffServ Code Point (DSCP) field in a packet, which is defined as the high-order six
bits of the Service Type octet in the IP header (the low-order two bits are not checked).
The <dscpval> value is specified as either an integer from 0 to 63, or symbolically through
one of the following keywords: af11, af12, af13, af21, af22, af23, af31, af32, af33,
af41, af42, af43, be, cs0, cs1, cs2, cs3, cs4, cs5, cs6, cs7, ef.
Note: The ip dscp, ip precedence, and ip tos match conditions are alternative ways to specify
a match criterion for the same Service Type field in the IP header, but with a slightly different
user notation.
Default
none
Syntax
Mode
Class-Map Config
match ip precedence
This command adds to the specified class definition a match condition based on the value of
the IP Precedence field in a packet, which is defined as the high-order three bits of the Service
Type octet in the IP header (the low-order five bits are not checked). The precedence value is
an integer from 0 to 7.
Note: The IP DSCP, IP precedence, and IP TOS match conditions are alternative
ways to specify a match criterion for the same Service Type field in the IP header, but
with a slightly different user notation.
Default
none
247
match ip tos
Syntax
Mode
Class-Map Config
match ip tos
This command adds to the specified class definition a match condition based on the value of
the IP TOS field in a packet, which is defined as all eight bits of the Service Type octet in the
IP header. The value of <tosbits> is a two-digit hexadecimal number from 00 to ff. The value
of <tosmask> is a two-digit hexadecimal number from 00 to ff.
The <tosmask> denotes the bit positions in <tosbits> that are used for comparison against
the IP TOS field in a packet. For example, to check for an IP TOS value having bits 7 and 5
set and bit 1 clear, where bit 7 is most significant, use a <tosbits> value of a0 (hex) and a
<tosmask> of a2 (hex).
Note: The IP DSCP, IP precedence, and IP TOS match conditions are alternative
ways to specify a match criterion for the same Service Type field in the IP header,
but with a slightly different user notation.
Note: In essence, this the free form version of the IP DSCP/Precedence/TOS
match specification in that the user has complete control of specifying which bits
of the IP Service Type field are checked.
Default
none
Syntax
Mode
Class-Map Config
match protocol
This command adds to the specified class definition a match condition based on the value of
the IP Protocol field in a packet using a single keyword notation or a numeric value notation.
To specify the match condition using a single keyword notation, the value for
<protocol-name> is one of the supported protocol name keywords. The currently supported
values are: icmp, igmp, ip, tcp, udp. Note that a value of ip is interpreted to match all
protocol number values.
To specify the match condition using a numeric value notation, the protocol number is a
standard value assigned by IANA and is interpreted as an integer from 0 to 255. Note: This
command does not validate the protocol number value against the current list defined by
IANA.
248
Default
none
Syntax
Mode
Class-Map Config
none
Syntax
Mode
Class-Map Config
match srcip
This command adds to the specified class definition a match condition based on the source IP
address of a packet. The <ipaddr> parameter specifies an IP address. The <ipmask>
parameter specifies an IP address bit mask; note that although it resembles a standard subnet
mask, this bit mask need not be contiguous.
Default
none
Syntax
Mode
Class-Map Config
match srcl4port
This command adds to the specified class definition a match condition based on the source
layer 4 port of a packet using a single keyword or numeric notation or a numeric range
notation.
To specify the match condition as a single keyword notation, the value for <portkey> is one
of the supported port name keywords (listed below).
249
match vlan
The currently supported <portkey> values are: domain, echo, ftp, ftpdata, http, smtp,
snmp, telnet, tftp, www. Each of these translates into its equivalent port number, which is
used as both the start and end of a port range.
To specify the match condition as a numeric value, one layer 4 port number is required. The
port number is an integer from 0 to 65535.
To specify the match condition as a range, rwo layer 4 port numbers are required and together
they specify a contiguous port range. Each port number is an integer from 0 to 65535, but
with the added requirement that the second number be equal to or greater than the first.
Default
None
Syntax
Mode
Class-Map Config
match vlan
This command adds to the specified class definition a match condition based on the value of
the layer 2 VLAN Identifier field (the only tag in a single tagged packet or the first or outer
tag of a double VLAN tagged packet). The VLAN ID is an integer from 1 to 4094.
Default
None
Syntax
Mode
Class-Map Config
Policy Commands
The policy command set is used in DiffServ to define:
Traffic ConditioningSpecify traffic conditioning actions (policing, marking, shaping) to
apply to traffic classes
Service ProvisioningSpecify bandwidth and queue depth management requirements of
service levels (EF, AF, etc.)
The policy commands are used to associate a traffic class, which was defined by the class
command set, with one or more QoS policy attributes. This association is then assigned to an
interface to form a service. The user specifies the policy name when the policy is created.
250
assign-queue
The DiffServ CLI does not necessarily require that users associate only one traffic class to
one policy. In fact, multiple traffic classes can be associated with a single policy, each
defining a particular treatment for packets that match the class definition. When a packet
satisfies the conditions of more than one class, preference is based on the order in which the
classes were added to the policy, with the foremost class taking highest precedence.
This set of commands consists of policy creation/deletion, class addition/removal, and
individual policy attributes. Note that the only way to remove an individual policy attribute
from a class instance within a policy is to remove the class instance and re-add it to the policy.
The values associated with an existing policy attribute can be changed without removing the
class instance.
Class instances are always added to the end of an existing policy. While existing class
instances may be removed, their previous location in the policy is not reused, so the number
of class instance additions/removals is limited. In general, significant changes to a policy
definition require that the entire policy be deleted and re-created with the desired
configuration.
The CLI command root is policy-map.
assign-queue
This command modifies the queue id to which the associated traffic stream is assigned. The
queueid is an integer from 0 to n-1, where n is the number of egress queues supported by the
device.
Syntax
Mode
assign-queue <queueid>
Policy-Class-Map Config
drop
This command specifies that all packets for the associated traffic stream are to be dropped at
ingress.
Syntax
Mode
drop
Policy-Class-Map Config
251
redirect
redirect
This command specifies that all incoming packets for the associated traffic stream are
redirected to a specific egress interface (physical port or port-channel).
Syntax
redirect <unit/slot/port>
Mode
Policy-Class-Map Config
conform-color
This command is used to enable color-aware traffic policing and define the conform-color
and exceed-color class maps used. Used in conjunction with the police command where the
fields for the conform level (for simple, single-rate, and two-rate policing) and optionally the
exceed level (for single-rate and two-rate policing) are specified. The <class-map-name>
parameter is the name of an existing Diffserv class map, where different ones must be used
for the conform and exceed colors.
The no version of this command disables the color-aware traffic policing and mapping.
Syntax
Mode
Policy-Class-Map Config
class
This command creates an instance of a class definition within the specified policy for the
purpose of defining treatment of the traffic class through subsequent policy attribute
statements. The <classname> is the name of an existing DiffServ class. Note that this
command causes the specified policy to create a reference to the class definition.
Note: The CLI mode is changed to Policy-classmap Config when this
command is successfully executed.
The no version of this command deletes the instance of a particular class and its defined
treatment from the specified policy. <classname> is the names of an existing DiffServ class.
Note that this command removes the reference to the class definition for the specified policy.
Syntax
Mode
252
Policy-Map Config
mark cos
mark cos
This command marks all packets for the associated traffic stream with the specified class of
service value in the priority field of the 802.1p header. If the packet does not already contain
this header, one is inserted. The CoS value is an integer from 0 to 7.
Default
Syntax
Mode
Policy Type
Policy-class-Map Config
In
mark ip-dscp
This command marks all packets for the associated traffic stream with the specified IP DSCP
value.
The <dscpval> value is specified as either an integer from 0 to 63, or symbolically through
one of the following keywords: af11, af12, af13, af21, af22, af23, af31, af32, af33,
af41, af42, af43, be, cs0, cs1, cs2, cs3, cs4, cs5, cs6, cs7, ef.
Syntax
Mode
Policy Type
Incompatibilities
Policy-classmap Config
In
Mark IP Precedence, Police (all forms)
mark ip-precedence
This command marks all packets for the associated traffic stream with the specified IP
Precedence value. The IP Precedence value is an integer from 0 to 7.
Syntax
Mode
Policy Type
Incompatibilities
In
Mark IP DSCP, Police (all forms)
253
police-simple
police-simple
This command is used to establish the traffic policing style for the specified class. The simple
form of the police command uses a single data rate and burst size, resulting in two outcomes:
conform and nonconform. The conforming data rate is specified in kilobits-per-second
(Kbps) and is an integer from 1 to 4294967295. The conforming burst size is specified in
kilobytes (KB) and is an integer from 1 to 128.
For each outcome, the only possible actions are drop, set-cos-transmit,
set-sec-cos-transmit, set-dscp-transmit, set-prec-transmit, or transmit. In this
simple form of the police command, the conform action defaults to transmit and the violate
action defaults to drop. These actions can be set with this command once the style has been
configured.
For set-dscp-transmit, a <dscpval> value is required and is specified as either an integer from
0 to 63, or symbolically through one of the following keywords: af11, af12, af13, af21,
af22, af23, af31, af32, af33, af41, af42, af43, be, cs0, cs1, cs2, cs3, cs4, cs5, cs6,
cs7, ef.
Mode
Policy-classmap Config
Restrictions
Only one style of police command (simple, singlerate, tworate) is allowed for a given class
instance in a particular policy.
Policy Type
In
Incompatibilities
254
policy-map
policy-map
This command establishes a new DiffServ policy. The <policyname> parameter is a
case-sensitive alphanumeric string from 1 to 31 characters uniquely identifying the policy.
The type of policy is specific to either the inbound or outbound traffic direction as indicated
by the {in | out} parameter.
Note: The policy type dictates which of the individual policy attribute commands are
valid within the policy definition.
Note: The CLI mode is changed to Policy-Map Config when this command is
successfully executed.
The no version of this command eliminates an existing DiffServ policy. The <policyname>
parameter is the name of an existing DiffServ policy. This command may be issued at any
time; if the policy is currently referenced by one or more interface service attachments, this
deletion attempt shall fail.
Syntax
Mode
Global Config
policy-map rename
This command changes the name of a DiffServ policy. The <policyname> is the name of an
existing DiffServ class. The <newpolicyname> parameter is a case-sensitive alphanumeric
string from 1 to 31 characters uniquely identifying the policy.
Syntax
Mode
Global Config
Service Commands
The service command set is used in DiffServ to define:
Traffic ConditioningAssign a DiffServ traffic conditioning policy (as specified by the policy commands)
to an interface in the incoming direction
Service ProvisioningAssign a DiffServ service provisioning policy (as specified by the policy
commands) to an interface in the outgoing direction
255
service-policy
The service commands attach a defined policy to a directional interface. Only one policy may
be assigned at any one time to an interface in a particular direction. The policy type (in, out)
must match the interface direction to which it is attached.
This set of commands consists of service addition/removal.
The CLI command root is service-policy.
service-policy
This command attaches a policy to an interface in a particular direction. The command can be
used in the Interface Config mode to attach a policy to a specific interface. Alternatively, the
command can be used in the Global Config mode to attach this policy to all system interfaces.
The direction value is either in or out. The <policyname> parameter is the name of an
existing DiffServ policy, whose type must match the interface direction. Note that this
command causes a service to create a reference to the policy.
Note: This command effectively enables DiffServ on an interface (in a particular
direction). There is no separate interface administrative 'mode' command for
DiffServ.
Note: This command shall fail if any attributes within the policy definition exceed
the capabilities of the interface. Once a policy is successfully attached to an
interface, any attempt to change the policy definition such that it would result in a
violation of said interface capabilities shall cause the policy change attempt to fail.
The no version of this command detaches a policy from an interface in a particular direction.
The command can be used in the Interface Config mode to detach a policy from a specific
interface. Alternatively, the command can be used in the Global Config mode to detach this
policy from all system interfaces to which it is currently attached. The direction value is either
in or out. The <policyname> parameter is the name of an existing DiffServ policy. Note that
this command causes a service to remove its reference to the policy.
Note: This command effectively disables DiffServ on an interface (in a
particular direction). There is no separate interface administrative
'mode' command for DiffServ.
Syntax
Modes
Restrictions
256
Only a single policy may be attached to a particular interface in a particular direction at any
one time.
show class-map
Show Commands
The 'show' command set is used in DiffServ to display configuration and status information
for:
Classes
Policies
Services
This information can be displayed in either summary or detailed formats. The status
information is only shown when the DiffServ administrative mode is enabled; it is suppressed
otherwise.
There is also a show command for general DiffServ information that is available at any time.
show class-map
This command displays all configuration information for the specified class. The
is the name of an existing DiffServ class.
<classname>
Syntax
Mode
If the Class Name is not specified, this command displays a list of all defined DiffServ
classes. The following fields are displayed:
257
show diffserv
Class NameThe name of this class. (Note that the order in which classes are displayed is not
necessarily the same order in which they were created.)
Class TypeThe class type (all, any, or acl) indicating how the match criteria are evaluated for this
class. A class type of all means every match criterion defined for the class is evaluated simultaneously
they must all be true to indicate a class match.For a type of any each match criterion is evaluated
sequentially and only one need be true to indicate a class match. Class type acl rules are evaluated in a
hybrid manner, with those derived from each ACL Rule grouped and evaluated simultaneously, while
each such grouping is evaluated sequentially.
ACL NumberThe ACL number used to define the class match conditions at the time the class was
created. This field is only meaningful if the class type is acl. (Note that the contents of the ACL may have
changed since this class was created.)
Ref Class NameThe name of an existing DiffServ class whose match conditions are being referenced
by the specified class definition.
show diffserv
This command displays the DiffServ General Status Group information, which includes the
current administrative mode setting as well as the current and maximum number of rows in
each of the main DiffServ private MIB tables. This command takes no options.
Syntax
Mode
show diffserv
Privileged EXEC
DiffServ Admin modeThe current value of the DiffServ administrative mode.
Class Table SizeThe current number of entries (rows) in the Class Table.
Class Table MaxThe maximum allowed entries (rows) for the Class Table.
Class Rule Table SizeThe current number of entries (rows) in the Class Rule Table.
Class Rule Table MaxThe maximum allowed entries (rows) for the Class Rule Table.
Policy Table SizeThe current number of entries (rows) in the Policy Table.
Policy Table MaxThe maximum allowed entries (rows) for the Policy Table.
Policy Instance Table SizeThe current number of entries (rows) in the Policy Instance Table.
Policy Instance Table MaxThe maximum allowed entries (rows) for the Policy Instance Table.
Policy Attribute Table SizeThe current number of entries (rows) in the Policy Attribute Table.
Policy Attribute Table MaxThe maximum allowed entries (rows) for the Policy Attribute Table.
Service Table SizeThe current number of entries (rows) in the Service Table.
Service Table MaxThe maximum allowed entries (rows) for the Service Table.
258
show policy-map
show policy-map
This command displays all configuration information for the specified policy. The
<policyname> is the name of an existing DiffServ policy.
Syntax
Mode
Policy-classmap Config
Conform COSThe action to be taken on conforming packets per the policing metrics.
Conform Secondary COSThe action to be taken on packets conforming with the secondary class of
service value per the policing metrics.
Exceed COSThe action to be taken on excess packets per the policing metrics.
Exceed Secondary COSThe action to be taken on excess packets conforming with the secondary
class of service value per the policing metrics.
Non-Conform COSThe action to be taken on violating packets per the policing metric.
Non-Conform Secondary COSThe action to be taken on violating packets conforming with the
secondary class of service per the policing metric.
Assign QueueDirects traffic stream to the specified QoS queue. This allows a traffic classifier to
specify which one of the supported hardware queues are used for handling packets belonging to the
class.
DropDrop a packet upon arrival. This is useful for emulating access control list operation using
DiffServ, especially when DiffServ and ACL cannot co-exist on the same interface.
RedirectForces a classified traffic stream to a specified egress port (physical or LAG). This can occur
in addition to any marking or policing action. It may also be specified along with a QoS queue
assignment.
The following information is repeated for each class associated with this policy (only those
policy attributes actually configured are displayed):
Class NameThe name of this class.
Mark CoSDenotes the class of service value that is set in the 802.1p header of outbound packets.
This is not displayed if the mark cos was not specified.
Mark IP DSCP
Denotes the mark/re-mark value used as the DSCP for traffic matching this class. This is not displayed
if mark ip description is not specified using the police-two-rate command, or if policing is in use for the
class under this policy.
259
show policy-map
Mark IP Precedence
Denotes the mark/re-mark value used as the IP Precedence for traffic matching this class. This is not
displayed if precedence is not specified using police-two-rate command, or if either mark DSCP or
policing is in use for the class under this policy.
Policing StyleThis field denotes the style of policing, if any, used (simple, single rate, or two rate).
Committed Rate (Kbps)This field displays the committed rate, used in simple policing, single-rate
policing, and two-rate policing.
Committed Burst Size (KB)This field displays the committed burst size, used in simple policing,
single-rate policing, and two-rate policing.
Excess Burst Size (KB)This field displays the excess burst size, used in single-rate policing.
Peak Rate (Kbps)This field displays the peak rate, used in two-rate policing.
Peak Burst Size (KB)This field displays the peak burst size, used in two-rate policing.
Conform ActionThe current setting for the action taken on a packet considered to conform to the
policing parameters. This is not displayed if policing is not in use for the class under this policy.
Conform DSCP ValueThis field shows the DSCP mark value if the conform action is markdscp.
Conform IP Precedence ValueThis field shows the IP Precedence mark value if the conform action is
markprec.
Exceed ActionThe current setting for the action taken on a packet considered to exceed to the
policing parameters. This is not displayed if policing not in use for the class under this policy.
Exceed DSCP ValueThis field shows the DSCP mark value if this action is markdscp.
Exceed IP Precedence ValueThis field shows the IP Precedence mark value if this action is markprec.
Non-Conform ActionThe current setting for the action taken on a packet considered to not conform to
the policing parameters. This is not displayed if policing not in use for the class under this policy.
Non-Conform DSCP ValueThis field displays the DSCP mark value if this action is markdscp.
Non-Conform IP Precedence ValueThis field displays the IP Precedence mark value if this action is
markprec.
BandwidthThis field displays the minimum amount of bandwidth reserved in either percent or
kilobits-per-second.
Expedite Burst Size (KBytes)This field displays the maximum guaranteed amount of bandwidth
reserved in either percent or kilobits-per-second format.
Shaping AverageThis field is displayed if average shaping is in use. Indicates whether average or
peak rate shaping is in use, along with the parameters used to form the traffic shaping criteria, such as
CIR and PIR. This is not displayed if shaping is not configured for the class under this policy.
Shape Committed Rate (Kbps)This field is displayed if average or peak rate shaping is in use. It
displays the shaping committed rate in kilobits-per-second.
Shape Peak Rate (Kbps)This field is displayed if peak rate shaping is in use. It displays the shaping
peak rate in kilobits-per-second.
260
Random Drop Minimum ThresholdThis field displays the RED minimum threshold.This is not
displayed if the queue depth management scheme is not RED.
Random Drop Maximum ThresholdThis field displays the RED maximum threshold.This is not
displayed if the queue depth management scheme is not RED.
Random Drop Maximum Drop ProbabilityThis field displays the RED maximum drop probability.This is
not displayed if the queue depth management scheme is not RED.
Random Drop Sampling RateThis field displays the RED sampling rate.This is not displayed if the
queue depth management scheme is not RED.
Random Drop Decay ExponentThis field displays the RED decay exponent.This is not displayed if the
queue depth management scheme is not RED.
If the Policy Name is not specified this command displays a list of all defined DiffServ
policies. The following fields are displayed:
Policy NameThe name of this policy. (Note that the order in which the policies are displayed is not
necessarily the same order in which they were created.)
Policy TypeThe policy type, namely whether it is an inbound or outbound policy definition.
Class MembersList of all class names associated with this policy.
Privileged EXEC
DiffServ Admin ModeThe current setting of the DiffServ administrative mode. An attached policy is
only in effect on an interface while DiffServ is in an enabled mode.
InterfaceValid unit, slot and port number separated by forward slashes.
DirectionThe traffic direction of this interface service, either in or out
Operational StatusThe current operational status of this DiffServ service interface.
Policy NameThe name of the policy attached to the interface in the indicated direction.
Policy DetailsAttached policy details, whose content is identical to that described for the show
policy-map <policymapname> command (content not repeated here for brevity).
261
Privileged EXEC
DiffServ ModeThe current setting of the DiffServ administrative mode. An attached policy is only
active on an interface while DiffServ is in an enabled mode.
The following information is repeated for interface and direction (only those interfaces
configured with an attached policy are shown):
InterfaceValid unit, slot and port number separated by forward slashes.
DirectionThe traffic direction of this interface service, either in or out
OperStatusThe current operational status of this DiffServ service interface.
Policy NameThe name of the policy attached to the interface in the indicated direction.
262
show service-policy
Interface Sent Octets/PacketsA cumulative count of the octets/packets forwarded by this service
interface in the specified direction after the defined DiffServ treatment was applied. In this case,
forwarding means the traffic stream was passed to the next functional element in the data path, such as
the switching or routing function or an outbound link transmission element.
The following information is repeated for each class instance within this policy:
Class NameThe name of this class instance.
In Offered Octets/PacketsA count of the octets/packets offered to this class instance before the
defined DiffServ treatment is applied. Only displayed for the 'in' direction.
In Discarded Octets/PacketsA count of the octets/packets discarded for this class instance for any
reason due to DiffServ treatment of the traffic class. Only displayed for the 'in' direction.
Tail Dropped Octets/PacketsA count of the octets/packets discarded due to tail dropping from a
transmission queue, typically due to the effects of traffic shaping. These counts may not be supported
on all platforms. Only displayed for the 'out' direction.
Random Dropped Octets/PacketsA count of the octets/packets discarded due to WRED active queue
depth management, typically due to the effects of traffic shaping. These counts are only applicable for a
class instance whose policy attributes includes random dropping, and may not be supported on all
platforms. Only displayed for the 'out' direction.
Shape Delayed Octets/PacketsA count of the octets/packets that were delayed due to traffic shaping.
These counts are only applicable for a class instance whose policy attributes includes shaping, and may
not be supported on all platforms. Only displayed for the 'out' direction.
Sent Octets/PacketsA count of the octets/packets forwarded for this class instance after the defined
DiffServ treatment was applied. In this case, forwarding means the traffic stream was passed to the next
functional element in the data path, such as the switching or routing function or an outbound link
transmission element. Only displayed for the 'out' direction.
Note: None of the counters listed here are guaranteed to be supported on all
platforms. Only supported counters are shown in the display output.
show service-policy
This command displays a summary of policy-oriented statistics information for all interfaces
in the specified direction. The direction parameter indicates the interface direction of interest.
This command enables or disables the route reflector client. A route reflector client relies on a
route reflector to re-advertise its routes to the entire AS. The possible values for this field are
enable and disable.
Syntax
Mode
Privileged EXEC
The following information is repeated for each interface and direction (only those interfaces
configured with an attached policy are shown):
263
show service-policy
264
Chapter 26
This chapter provides a detailed explanation of the QoS CoS commands. The following
commands are available in the QOS module.
The commands are divided into these different groups:
Configuration Commands are used to configure features and options of the switch. For
every configuration command there is a show command that will display the
configuration setting.
Show commands are used to display device settings, statistics and other information.
Note: The 'Interface Config' mode only affects a single interface, whereas the
'Global Config' mode is applied to all interfaces.
classofservice dot1p-mapping
This command maps an 802.1p priority to an internal traffic class. The userpriority and
trafficclass can both range from 0-7, although the actual number of available traffic classes
depends on the platform. The 'no' form of this command is not supported.
Syntax
Modes
classofservice ip-dscp-mapping
This command maps an IP DSCP value to an internal traffic class. The ipdscp range is from
0-63 and the trafficclass range is from 0-7, although the actual number of available traffic
classes depends on the platform. The 'no' form of this command is not supported.
Syntax
265
classofservice ip-precedence-mapping
Modes
classofservice ip-precedence-mapping
This command maps an IP precedence value to an internal traffic class. The ipprecedence
and trafficclass can both range from 0-7, although the actual number of available traffic
classes depends on the platform. The 'no' form of this command is not supported.
Syntax
Modes
classofservice trust
This command sets the class of service trust mode of an interface. The mode can be set to
trust one of the Dot1p (802.1p), IP Precedence, or IP DSCP packet markings.
The no version of this command sets the interface mode to untrusted.
Syntax
Mode
cos-queue min-bandwidth
This command specifies the minimum transmission bandwidth guarantee for each interface
queue. The total number of queues supported per interface is platform specific.
The no version of this command restores the default for each queue's minimum bandwidth
value.
Syntax
Modes
266
cos-queue strict
cos-queue strict
This command activates the strict priority scheduler mode for each specified queue.
The no version of this command restores the default weighted scheduler mode for each
specified queue.
Syntax
Modes
random-detect
This command is used to enable WRED for the interface as a whole, and is only available
when per-queue WRED activation control is not supported by the device. Specific WRED
parameters are configured using the 'random-detect queue-parms' and the 'random-detect
exponential-weighting-constant' commands.
The no version of this command disables WRED, thereby restoring the default tail drop
operation for all queues on the interface.
Syntax
[no] random-detect
Modes
random-detect exponential-weighting-constant
This command sets the decay exponent used by the WRED average queue depth calculation
for the interface.
The no version of this command restores the default value.
Syntax
Modes
267
random-detect queue-parms
random-detect queue-parms
This command sets the WRED parameters for each drop precedence level supported by a
queue. The actual number of queue drop precedence levels is platform-specific. Use the 'no'
form of this command to restore the default values for the queue WRED parameters.
Syntax
Modes
tail-drop queue-parms
This command sets the tail drop threshold parameter for each drop precedence level
supported by a queue. The total number of queue drop precedence levels is platform-specific.
Use the 'no' form of this command to restore the default values for the queue tail drop
threshold parameters.
Syntax
Modes
traffic-shape
This command specifies the maximum transmission bandwidth limit for the interface as a
whole. Also known as rate shaping, this has the effect of smoothing temporary traffic bursts
over time so that the transmitted traffic rate is bounded. Use the 'no' form of this command to
restore the default interface shaping rate value.
Syntax
traffic-shape <bw>
no traffic-shape
Modes
268
Privileged EXEC
The following information is repeated for each user priority.
User PriorityThe 802.1p user priority value.
Traffic ClassThe traffic class internal queue identifier to which the user priority value is mapped.
Privileged EXEC
The following information is repeated for each user priority.
IP PrecedenceThe IP Precedence value.
Traffic ClassThe traffic class internal queue identifier to which the IP Precedence value is mapped.
269
Privileged EXEC
Non-IP Traffic:
ClassThe traffic class used for non-IP traffic. This is only displayed when the COS trust mode is set to
either 'trust ip-dscp' or 'trust ip-precedence'.
Untrusted Traffic ClassThe traffic class used for all untrusted traffic. This is only displayed when the
COS trust mode is set to 'untrusted'.
Privileged EXEC
InterfaceThis displays the unit/slot/port of the interface. If displaying the global configuration, this
output line is replaced with a Global Config indication.
Intf Shaping RateThe maximum transmission bandwidth limit for the interface as a whole. It is
independent of any per-queue maximum bandwidth value(s) in effect for the interface. This is a
configured value.
Queue Mgmt TypeThe queue depth management technique used for all queues on this interface,
either tail drop or weighted random early discard (WRED). This is a configured value.
WRED Decay ExponentThe weighted random early discard (WRED) average queue length
calculation decay exponent. This is a configured value.
270
Privileged EXEC
InterfaceThis displays the unit/slot/port of the interface. If displaying the global configuration, this
output line is replaced with a Global Config indication.
An interface supports n queues numbered 0 to (n-1). The number n is platform dependent and
corresponds to the number of supported queues (traffic classes).
The following information is repeated for each drop precedence level defined for the
preceding Queue Id.
Drop Precedence LevelThe drop precedence level for this queue, from 1 to p. The specific p value is
platform dependent.
WRED Minimum ThresholdThe WRED minimum threshold value for this drop precedence level,
expressed in sixteenths of the overall device queue size (e.g., 0/16, 1/16, 2/16, 16/16). This is a
configured value.
271
WRED Maximum ThresholdThe WRED maximum threshold value for this drop precedence level,
expressed in sixteenths of the overall device queue size (e.g., 0/16, 1/16, 2/16, 16/16). This is a
configured value.
WRED Drop Probability ScaleThe WRED drop probability scale factor expressed as an integer. This
value, S, specifies that one out of every (2**S) packets are dropped by WRED when the average queue
length reaches its maximum threshold value. This is a configured value.
Privileged EXEC
InterfaceThis displays the unit/slot/port of the interface. If displaying the global configuration, this
output line is replaced with a Global Config indication.
An interface supports n queues numbered 0 to (n-1). The number n is platform dependent and
corresponds to the number of supported queues (traffic classes).
The following information is repeated for each drop precedence level defined for the
preceding Queue Id.
Drop Precedence LevelThe drop precedence level for this queue, from 1 to p. The specific p value is
platform dependent.
Tail Drop ThresholdThe tail drop queue threshold value for this drop precedence level, expressed in
sixteenths of the overall device queue size (e.g., 0/16, 1/16, 2/16, 16/16). This is a configured value.
272
Chapter 27
Routing Commands
Show commands are used to display switch settings, statistics and other information.
Configuration Commands are used to configure features and options of the switch. For
every configuration command there is a show command that will display the
configuration setting.
Copy commands are used to transfer configuration and informational files to and from the
switch.
arp
This command creates an ARP entry. The value for ipaddress is the IP address of a device on
a subnet attached to an existing routing interface. macaddr is a unicast MAC address for that
device.
The format is 6 two-digit hexadecimal numbers that are separated by colons, for example
00:06:29:32:81:40.
The no version of this command deletes an ARP entry. The value for arpentry is the IP
address of the interface. The value for ipaddress is the IP address of a device on a subnet
attached to an existing routing interface. macaddr is a unicast MAC address for that device.
Syntax
Mode
Global Config
273
arp cachesize
arp cachesize
This command configures the ARP cache size. The value for cachesize is a platform
specific integer value.
Syntax
Mode
Global Config
ip proxy-arp
This command enables proxy ARP on a router interface.
Without proxy ARP, a device only responds to an ARP request if the target IP address is an
address configured on the interface where the ARP request arrived. With proxy ARP, the
device may also respond if the target IP address is reachable. The device only responds if all
next hops in its route to the destination are through interfaces other than the interface that
received the ARP request.
The no version of this command disables proxy ARP on a router interface.
Default
enabled
Syntax
[no] ip proxy-arp
Mode
Interface Config
arp dynamicrenew
This command enables ARP component to automatically renew ARP entries of type dynamic
when they age out.
The no version of this command disables ARP component from automatically renewing ARP
entries of type dynamic when they age out.
Syntax
Mode
274
Privileged Exec
Routing Commands
arp purge
arp purge
This command causes the specified IP address to be removed from the ARP cache. Only
entries of type dynamic or gateway are affected by this command.
Syntax
Mode
Privileged EXEC
arp resptime
This command configures the ARP request response timeout.
The value for seconds is a valid positive integer, which represents the IP ARP entry response
timeout time in seconds. The range for seconds is between 1-10 seconds.
The no version of this command configures the default ARP request response timeout.
Default
Syntax
Mode
Global Config
arp retries
This command configures the ARP count of maximum request for retries.
The value for retries is an integer, which represents the maximum number of request for
retries. The range for retries is an integer between 0-10 retries.
The no version of this command configures the default ARP count of maximum request for
retries.
Default
Syntax
Mode
Global Config
275
arp timeout
arp timeout
This command configures the ARP entry ageout time.
The value for seconds is a valid positive integer, which represents the IP ARP entry ageout
time in seconds. The range for seconds is between 15-21600 seconds.
The no version of this command configures the default ARP entry ageout time.
Default
1200
Syntax
Mode
Global Config
clear arp-cache
This command causes all ARP entries of type dynamic to be removed from the ARP cache. If
the gateway parameter is specified, the dynamic entries of type gateway are purged as well.
Syntax
Mode
Privileged Exec
show arp
This command displays the Address Resolution Protocol (ARP) cache. The displayed results
are not the total ARP entries. To view the total ARP entries, the operator should view the
show arp results in conjunction with the show arp switch results.
Syntax
Mode
show arp
Privileged EXEC
Age Time (seconds)Is the time it takes for an ARP entry to age out. This value was configured into the
unit. Age time is measured in seconds.
Response Time (seconds)Is the time it takes for an ARP request timeout. This value was configured
into the unit. Response time is measured in seconds.
RetriesIs the maximum number of times an ARP request is retried. This value was configured into the
unit.
Cache SizeIs the maximum number of entries in the ARP table. This value was configured into the
unit.
276
Routing Commands
Dynamic Renew ModeDisplays whether the ARP component automatically attempts to renew
dynamic ARP entries when they age out.
Total Entry Count Current / PeakField listing the total entries in the ARP table and the peak entry
count in the ARP table.
Static Entry Count Current / MaxField listing the static entry count in the ARP table and maximum
static entry count in the ARP table.
Mode
Privileged EXEC
Age Time (seconds)Is the time it takes for an ARP entry to age out. This value was configured into the
unit. Age time is measured in seconds.
Response Time (seconds)Is the time it takes for an ARP request timeout. This value was configured
into the unit. Response time is measured in seconds.
RetriesIs the maximum number of times an ARP request is retried. This value was configured into the
unit.
Cache SizeIs the maximum number of entries in the ARP table. This value was configured into the
unit.
Dynamic Renew ModeDisplays whether the ARP component automatically attempts to renew
dynamic ARP entries when they age out.
Total Entry Count Current / PeakField listing the total entries in the ARP table and the peak entry
count in the ARP table.
Static Entry Count Current / MaxField listing the static entry count in the ARP table and maximum
static entry count in the ARP table.
277
routing
IP Routing
This chapter provides a detailed explanation of the IP Routing commands. The commands are
divided by functionality into the following different groups:
Show commands are used to display switch settings, statistics and other information.
Configuration Commands are used to configure features and options of the switch. For
every configuration command there is a show command that will display the
configuration setting.
Copy commands are used to transfer configuration and informational files to and from the
switch.
routing
This command enables routing for an interface.
The current value for this function is displayed under "show ip interface" labeled as "Routing
Mode".
The no version of this command disables routing for an interface. The current value for this
function is displayed under show ip interface labeled as "Routing Mode".
Default
disabled
Syntax
[no] routing
Mode
Interface Config
ip routing
This command enables the IP Router Admin Mode for the master switch.
The no version of this command disables the IP Router Admin Mode for the master switch.
Syntax
Mode
278
[no] ip routing
Global Config
Routing Commands
ip address
ip address
This command configures an IP address on an interface. The IP address may be a secondary
IP address.
The value for <ipaddr> is the IP Address of the interface.
The value for <subnetmask> is a 4-digit dotted-decimal number which represents the
Subnet Mask of the interface. This changes the label "IP address" in show ip interface.
The no version of this command deletes an IP address from an interface.
The value for <ipaddr> is the IP Address of the interface.
The value for <subnetmask> is a 4-digit dotted-decimal number which represents the
Subnet Mask of the interface.
Syntax
Mode
Interface Config
ip route
This command configures a static route. The ip_addr is a valid ip address. The
subnet_mask is a valid subnet mask. The nextHopRtr is a valid IP address of the next hop
router. The preference is an integer value from 1 to 255.
The no version of this command deletes all next hops to a destination static route. If the
optional nextHopRtr parameter is designated, the next hop is deleted and if the optional
preference value is designated, the preference value of the static route is reset to its default.
Default
preference - 1
Syntax
Mode
Global Config
279
ip route default
ip route default
This command configures the default route. The value for nextHopRtr is a valid IP address of
the next hop router. The preference is an integer value from 1 to 255.
The no version of this command deletes all configured default routes. If the optional
nextHopRtr parameter is designated, the specific next hop is deleted from the configured
default route and if the optional preference value is designated, the preference of the
configured default route is reset to its default.
Default
preference - 1
Syntax
Mode
Global Config
ip route distance
This command sets the default distance for static routes. Lower route preference values are
preferred when determining the best route. The "ip route" and "ip route default" commands
allow you to optionally set the distance of an individual static route. The default distance is
used when no distance is specified in these commands. Changing the default distance does
not update the distance of existing static routes, even if they were assigned the original default
distance. The new default distance will only be applied to static routes created after invoking
the "ip route distance" command.
The no version of this command sets the default static route preference value in the router.
Lower route preference values are preferred when determining the best route.
Default
Syntax
Mode
Global Config
ip forwarding
This command enables forwarding of IP frames.
280
Routing Commands
ip netdirbcast
enabled
Syntax
[no] ip forwarding
Mode
Global Config
ip netdirbcast
This command enables the forwarding of network-directed broadcasts. When enabled,
network directed broadcasts are forwarded. When disabled they are dropped.
The no version of this command disables the forwarding of network-directed broadcasts.
When disabled, network directed broadcasts are dropped.
Default
disabled
Syntax
[no] ip netdirbcast
Mode
Interface Config
ip mtu
This command sets the IP Maximum Transmission Unit (MTU) on a routing interface. The IP
MTU is the size of the largest IP packet that can be transmitted on the interface without
fragmentation. SFTOS currently does not fragment IP packets.
Packets originated on the router, such as OSPF packets, may be fragmented by the IP stack.
The IP stack uses its default IP MTU and ignores the value set using the ip mtu command.
OSPF advertises the IP MTU in the Database Description packets it sends to its neighbors
during database exchange. If two OSPF neighbors advertise different IP MTUs, they will not
form an adjacency (unless OSPF has been instructed to ignore differences in IP MTU with the
ip ospf mtu-ignore command.)
281
show ip brief
The no version of this command resets the ip mtu to the default value.
Default
1500 bytes
Syntax
Mode
Interface Config
show ip brief
This command displays all the summary information of the IP. This command takes no
options.
Syntax
Mode
show ip brief
show ip interface
This command displays all pertinent information about the IP interface.
Syntax
Mode
282
Routing Commands
show ip route
This command displays the entire route table. This commands takes no options.
Syntax
show ip route
283
Mode
Privileged EXEC
Network AddressIs an IP address identifying the network on the specified interface.
Subnet MaskIs a mask of the network and host portion of the IP address for the router interface.
ProtocolTells which protocol added the specified route. The possibilities are: local, static, OSPF or
RIP.
Total Number of RoutesThe total number of routes.
Privileged EXEC
Network AddressIs an IP route prefix for the destination.
Subnet MaskIs a mask of the network and host portion of the IP address for the specified interface.
ProtocolTells which protocol added the specified route. The possibilities are: local, static, OSPF or
RIP.
Total Number of RoutesThe total number of routes in the route table.
Routing Commands
Syntax
Mode
Privileged EXEC
Network AddressIs a valid network address identifying the network on the specified interface.
Subnet Mask
Is a mask of the network and host portion of the IP address for the attached network.
ProtocolTells which protocol added the specified route. The possibilities are: local, static, OSPF or
RIP.
285
show ip stats
show ip stats
This command displays IP statistical information. Refer to RFC 1213 for more information
about the fields that are displayed. This command takes no options.
Syntax
Mode
show ip stats
encapsulation
This command configures the link layer encapsulation type for the packet. Acceptable values
for encapstype are Ethernet and SNAP. The default is Ethernet.
Syntax
Mode
Interface Config
RestrictionsRouted frames are always Ethernet encapsulated when a frame is routed to a VLAN.
Show commands are used to display switch settings, statistics and other information.
Configuration Commands are used to configure features and options of the switch. For
every configuration command there is a show command that will display the
configuration setting.
Copy commands are used to transfer configuration and informational files to and from the
switch.
bootpdhcprelay cidoptmode
This command enables the circuit ID option mode for BootP/DHCP Relay on the system.
The no version of this command disables the circuit ID option mode for BootP/DHCP Relay
on the system.
286
Routing Commands
bootpdhcprelay enable
Default
disabled
Syntax
Mode
Global Config
bootpdhcprelay enable
This command enables the forwarding of relay requests for BootP/DHCP Relay on the
system.
The no version of this command disables the forwarding of relay requests for BootP/DHCP
Relay on the system.
Default
disabled
Syntax
Mode
Global Config
bootpdhcprelay maxhopcount
This command configures the maximum allowable relay agent hops for BootP/DHCP Relay
on the system. The hops parameter has a range of 1 to 16.
The no version of this command configures the default maximum allowable relay agent hops
for BootP/DHCP Relay on the system.
Default
Syntax
Mode
Global Config
287
bootpdhcprelay minwaittime
bootpdhcprelay minwaittime
This command configures the minimum wait time in seconds for BootP/DHCP Relay on the
system. When the BOOTP relay agent receives a BOOTREQUEST message, it MAY use the
seconds-since-client-began-booting field of the request as a factor in deciding whether to
relay the request or not. The parameter has a range of 0 to 100 seconds.
The no version of this command configures the default minimum wait time in seconds for
BootP/DHCP Relay on the system.
Default
Syntax
Mode
Global Config
bootpdhcprelay serverip
This command configures the server IP Address for BootP/DHCP Relay on the system. The
ipaddr parameter is an IP address in a 4-digit dotted decimal format.
The no version of this command configures the default server IP Address for BootP/DHCP
Relay on the system.
Default
0.0.0.0
Syntax
Mode
Global Config
show bootpdhcprelay
This command displays the BootP/DHCP Relay information.
Syntax
Mode
show bootpdhcprelay
288
Routing Commands
Show commands are used to display switch settings, statistics and other information.
Configuration Commands are used to configure features and options of the switch. For
every configuration command there is a show command that will display the
configuration setting.
Copy commands are used to transfer configuration and informational files to and from the
switch.
ip irdp
This command enables Router Discovery on an interface.
The no version of this command disables Router Discovery on an interface.
Default
enabled
Syntax
[no] ip irdp
Mode
Interface Config
289
ip irdp address
ip irdp address
This command configures the address to be used to advertise the router for the interface. The
valid values for ipaddr are 224.0.0.1 and 255.255.255.255.
The no version of this command configures the default address to be used to advertise the
router for the interface.
Default
224.0.0.1
Syntax
Mode
Interface Config
ip irdp holdtime
This command configures the value, in seconds, of the holdtime field of the router
advertisement sent from this interface. The range is the maxadvertinterval to 9000 seconds.
The no version of this command configures the default value, in seconds, of the holdtime
field of the router advertisement sent from this interface.
Default
3 * maxinterval
Syntax
Mode
Interface Config
ip irdp maxadvertinterval
This command configures the maximum time, in seconds, allowed between sending router
advertisements from the interface. The range for maxadvertinterval is 4 to 1800 seconds.
The no version of this command configures the default maximum time, in seconds.
Default
600
Syntax
Mode
290
Interface Config
Routing Commands
ip irdp minadvertinterval
ip irdp minadvertinterval
This command configures the minimum time, in seconds, allowed between sending router
advertisements from the interface. The range for minadvertinterval is 3 to the value of
maxadvertinterval.
The no version of this command configures the default minimum time, in seconds.
Default
0.75 * maxadvertinterval
Syntax
Mode
Interface Config
ip irdp preference
This command configures the preferability of the address as a default router address, relative
to other router addresses on the same subnet. The range is -2147483648 to -1 to 0 to 1 to
2147483647.
The no version of this command configures the default preferability of the address as a
default router address, relative to other router addresses on the same subnet.
Default
Syntax
Mode
Interface Config
show ip irdp
This command displays the router discovery information for all interfaces, or a specified
interface.
Syntax
Mode
291
vlan routing
Ad ModeDisplays the advertise mode which indicates whether router discovery is enabled or disabled
on this interface.
Max IntDisplays the maximum advertise interval which is the maximum time allowed between sending
router advertisements from the interface in seconds.
Min IntDisplays the minimum advertise interval which is the minimum time allowed between sending
router advertisements from the interface in seconds.
Adv LifeDisplays advertise lifetime which is the value of the lifetime field of the router advertisement
sent from the interface in seconds.
PreferencesDisplays the preference of the address as a default router address, relative to other router
addresses on the same subnet.
Show commands are used to display switch settings, statistics and other information.
Configuration Commands are used to configure features and options of the switch. For
every configuration command there is a show command that will display the
configuration setting.
Copy commands are used to transfer configuration and informational files to and from the
switch.
vlan routing
This command creates routing on a VLAN. The vlanid value has a range from 1 to 4094.
The no version of this command deletes routing on a VLAN. The vlanid value has a range
from 1 to 4094.
Syntax
Mode
VLAN Database
show ip vlan
This command displays the VLAN routing information for all VLANs with routing enabled
in the system.
292
Routing Commands
ip vrrp
Syntax
Mode
show ip vlan
Show commands are used to display switch settings, statistics and other information.
Configuration Commands are used to configure features and options of the switch. For
every configuration command there is a show command that will display the
configuration setting.
Copy commands are used to transfer configuration and informational files to and from the
switch.
ip vrrp
This command sets the virtual router ID on an interface for Virtual Router configuration in
the router. This commands also designates the configured virtual router IP address as a
secondary IP address on an interface. The parameter <vrID> is the virtual router ID which has
an integer value range from 1 to 255.
The no version of this command removes all VRRP configuration details of the virtual router
configured on a specific interface. This command also removes a virtual rourter IP address as
a secondary IP address on an interface. The parameter <vrID> is the virtual router ID which
has an integer value ranges from 1 to 255.
Default
none
Syntax
Mode
Interface Config
293
ip vrrp
ip vrrp
This command enables the administrative mode of VRRP in the router. This command also
designates the configured virtual router IP address as a secondary IP address on an interface.
The no version of this command disables the default administrative mode of VRRP in the
router.
Default
enabled
Syntax
Mode
Global Config
ip vrrp mode
This command enables the virtual router configured on the specified interface. Enabling the
status field starts a virtual router. The parameter vrID is the virtual router ID which has an
integer value ranging from 1 to 255.
The no version of this command disables the virtual router configured on the specified
interface. Disabling the status field stops a virtual router.
Default
disabled
Syntax
Mode
Interface Config
ip vrrp ip
This command sets the ipaddress value for a virtual router. The value for ipaddr is the IP
Address which is to be configured on that interface for VRRP. The parameter vrID is the
virtual router ID which has an integer value range from 1 to 255.
Default
none
Syntax
Mode
294
Interface Config
Routing Commands
ip vrrp authentication
ip vrrp authentication
This command sets the authorization details value for the virtual router configured on a
specified interface. The parameter {none | simple} specifies the authorization type for virtual
router configured on the specified interface. The parameter [key ] is optional, it is only
required when authorization type is simple text password. The parameter vrID is the virtual
router ID which has an integer value ranges from 1 to 255.
The no version of this command sets the default authorization details value for the virtual
router configured on a specified interface.
Default
no authorization
Syntax
Mode
Interface Config
ip vrrp preempt
This command sets the preemption mode value for the virtual router configured on a specified
interface. The parameter vrID is the virtual router ID which has an integer value range from 1
to 255.
The no version of this command sets the default preemption mode value for the virtual router
configured on a specified interface.
Default
enabled
Syntax
Mode
Interface Config
ip vrrp priority
This command sets the priority value for the virtual router configured on a specified interface.
The priority of the interface is a priority integer from 1 to 254. The parameter vrID is the
virtual router ID which has an integer value ranges from 1 to 255.
The no version of this command sets the default priority value for the virtual router
configured on a specified interface.
Default
100
295
Syntax
Mode
Interface Config
Syntax
Mode
Interface Config
296
Routing Commands
show ip vrrp
IP TTL errorsRepresents the total number of VRRP packets received by the virtual router with IP TTL
(time to live) not equal to 255.
Zero Priority Packets ReceivedRepresents the total number of VRRP packets received by virtual
router with a priority of '0'.
Zero Priority Packets SentRepresents the total number of VRRP packets sent by the virtual router
with a priority of '0'
Invalid Type Packets ReceivedRepresents the total number of VRRP packets received by the virtual
router with invalid 'type' field.
Address List ErrorsRepresents the total number of VRRP packets received for which address list
does not match the locally configured list for the virtual router.
Invalid Authentication TypeRepresents the total number of VRRP packets received with unknown
authentication type.
Authentication Type MismatchRepresents the total number of VRRP advertisements received for
which 'auth type' not equal to locally configured one for this virtual router.
Packet Length ErrorsRepresents the total number of VRRP packets received with packet length less
than length of VRRP header
show ip vrrp
This command displays whether VRRP functionality is enabled or disabled on the SFTOS
switch. It also displays some global parameters which are required for monitoring This
command takes no options.
Syntax
Mode
show ip vrrp
297
298
Routing Commands
enable (OSPF)
Chapter 28
OSPF Commands
This chapter provides a detailed explanation of the Open Shortest Path First (OSPF)
commands. The commands are divided by functionality into the following different groups:
Show commands are used to display switch settings, statistics and other information.
Configuration Commands are used to configure features and options of the switch. For
every configuration command there is a show command that will display the
configuration setting.
Copy commands are used to transfer configuration and informational files to and from the
switch.
enable (OSPF)
This command resets the default administrative mode of OSPF in the router (active).
The no version of this command sets the administrative mode of OSPF in the router to
inactive.
Default
enabled
Syntax
[no] enable
Mode
ip ospf
This command enables OSPF on a router interface.
The no version of this command disables OSPF on a router interface.
Default
disabled
Syntax
[no] ip ospf
Mode
Interface Config
299
1583compatibility
1583compatibility
This command enables OSPF 1583 compatibility.
The no version of this command disables OSPF 1583 compatibility.
Note: 1583 compatibility mode is enabled by default. If all OSPF routers in
the routing domain are capable of operating according to RFC 2328, OSPF
1583 compatibility mode should be disabled.
Default
enabled
Syntax
[no] 1583compatibility
Mode
area authentication
This command specifies the authentication type to be used for the specified area id.
The no version of this command sets the default authentication type to be used for the
specified area id.
Default
none
Syntax
Mode
area default-cost
This command configures the monetary default cost for the stub area. The operator must
specify the area id and an integer value between 1-16777215.
Syntax
Mode
300
OSPF Commands
area nssa
area nssa
This command configures the specified areaid to function as an NSSA.
The no version of this command disables nssa from the specified area id.
Syntax
Mode
Mode
301
area range
This command creates a specified area range for a specified NSSA. The <ipaddr> is a valid IP
address. The <subnetmask> is a valid subnet mask. The lsdb type must be specified by either
summarylink or nssaexternallink, and the advertising of the area range can be optionally
allowed or suppressed.
The no version of this command deletes a specified area range.
Syntax
Mode
302
OSPF Commands
area stub
area stub
This command creates a stub area for the specified area ID. A stub area is characterized by the
fact that AS External LSAs are not propagated into the area. Removing AS External LSAs
and Summary LSAs can significantly reduce the link state database of routers within the stub
area.
The no version of this command deletes a stub area for the specified area ID.
Syntax
Mode
disabled
Syntax
Mode
area virtual-link
This command creates the OSPF virtual interface for the specified <areaid> and <neighbor>.
The <neighbor> parameter is the Router ID of the neighbor.
The no version of this command deletes the OSPF virtual interface from the given interface,
identified by <areaid> and <neighbor>. The <neighbor> parameter is the Router ID of the
neighbor.
Syntax
Mode
303
none
Syntax
Mode
40
Syntax
Mode
304
OSPF Commands
10
Syntax
Mode
Syntax
Mode
305
The no version of this command configures the default transmit delay for the OSPF virtual
interface on the virtual interface identified by <areaid> and <neighbor>. The <neighbor>
parameter is the Router ID of the neighbor.
Default
Syntax
Mode
metricunspecified; type2
Syntax
Mode
default-metric (OSPF)
This command is used to set a default for the metric of distributed routes.
The no version of this command is used to set a default for the metric of distributed routes.
Syntax
default-metric <1-16777215>
no default-metric
Mode
306
OSPF Commands
distance ospf
distance ospf
This command sets the route preference value of OSPF in the router. Lower route preference
values are preferred when determining the best route. The type of OSPF can be intra, inter,
type-1, or type-2. The OSPF specification (RFC 2328) requires that preferences must be
given to the routes learned via OSPF in the following order: intra < inter < type-1 < type-2.
The range of preference is 0 to 255.
The no version of this command sets the default route preference value of OSPF in the router.
The type of OSPF can be intra, inter, type-1, or type-2. Syntax
Default
Syntax
Mode
distribute-list out
This command is used to specify the access list to filter routes received from the source
protocol.
The no version of this command is used to specify the access list to filter routes received
from the source protocol.
Syntax
Mode
exit-overflow-interval
This command configures the exit overflow interval for OSPF. It describes the number of
seconds after entering Overflow state that a router will wait before attempting to leave the
Overflow State. This allows the router to again originate non-default AS-external-LSAs.
When set to 0, the router will not leave Overflow State until restarted. The range for
<seconds> is 0 to 2147483647 seconds.
The no version of this command configures the default exit overflow interval for OSPF.
307
external-lsdb-limit
Default
Syntax
exit-overflow-interval <0-2147483647>
no exit-overflow-interval
Mode
external-lsdb-limit
This command configures the external LSDB limit for OSPF. If the value is -1, then there is
no limit. When the number of non-default AS-external-LSAs in a router's link-state database
reaches the external LSDB limit, the router enters overflow state. The router never holds
more than the external LSDB limit non-default AS-external-LSAs in it database. The external
LSDB limit MUST be set identically in all routers attached to the OSPF backbone and/or any
regular OSPF area. The range for <limit> is -1 to 2147483647.
The no version of this command configures the default external LSDB limit for OSPF.
Default
-1
Syntax
external-lsdb-limit <-1-2147483647>
no external-lsdb-limit
Mode
ip ospf areaid
This command sets the OSPF area to which the specified router interface belongs. The value
for <areaid> is an IP address, formatted as a 4-digit dotted-decimal number that uniquely
identifies the area to which the interface connects. Assigning an area id, which does not exist
on an interface, causes the area to be created with default values.
Syntax
Mode
308
Interface Config
OSPF Commands
ip ospf authentication
ip ospf authentication
This command sets the OSPF Authentication Type and Key for the specified interface.
The value of <type> is either none, simple or encrypt. The [key] is composed of standard
displayable, non-control keystrokes from a Standard 101/102-key keyboard. The
authentication key must be 8 bytes or less if the authentication type is simple. If the type is
encrypt, the key may be up to 256 bytes. If the type is encrypt a <keyid> in the range of 0 and
255 must be specified.
The no version of this command sets the default OSPF Authentication Type for the specified
interface.
Default
Default
The default password key is not configured. Unauthenticated interfaces do not need an
authentication key.
Default
The default keyid is not configured. Unauthenticated interfaces do not need an authentication
key id.
Syntax
Mode
Interface Config
ip ospf cost
This command configures the cost on an OSPF interface. The <cost> parameter has a range
of 1 to 65535.
The no version of this command configures the default cost on an OSPF interface. The
<cost> parameter has a range of 1 to 65535.
Default
10
Syntax
Mode
Interface Config
309
ip ospf dead-interval
ip ospf dead-interval
This command sets the OSPF dead interval for the specified interface.
The value for <seconds> is a valid positive integer, which represents the length of time in
seconds that a router's Hello packets have not been seen before its neighbor routers declare
that the router is down. The value for the length of time must be the same for all routers
attached to a common network. This value should be some multiple of the Hello Interval (i.e.
4).
Valid values range for <seconds> is from 1 to 2147483647.
The no version of this command sets the default OSPF dead interval for the specified
interface.
Default
40
Syntax
Mode
Interface Config
ip ospf hello-interval
This command sets the OSPF hello interval for the specified interface.
The value for <seconds> is a valid positive integer, which represents the length of time in
seconds. The value for the length of time must be the same for all routers attached to a
network.
Valid values range from 1 to 65535.
The no version of this command sets the default OSPF hello interval for the specified
interface.
Default
10
Syntax
Mode
310
Interface Config
OSPF Commands
ip ospf priority
ip ospf priority
This command sets the OSPF priority for the specified router interface. The priority of the
interface is a priority integer from 0 to 255.
A value of '0' indicates that the router is not eligible to become the designated router on this
network.
The no version of this command sets the default OSPF priority for the specified router
interface.
Default
Syntax
Mode
Interface Config
ip ospf retransmit-interval
This command sets the OSPF retransmit Interval for the specified interface. The retransmit
interval is specified in seconds.
The value for <seconds> is the number of seconds between link-state advertisement
retransmissions for adjacencies belonging to this router interface. This value is also used
when retransmitting database and link-state request packets.
Valid values range from 0 to 3600 (1 hour).
The no version of this command sets the default OSPF retransmit Interval for the specified
interface.
Default
Syntax
Mode
Interface Config
311
ip ospf transmit-delay
ip ospf transmit-delay
This command sets the OSPF Transit Delay for the specified interface. The transmit delay is
specified in seconds. In addition, it sets the estimated number of seconds it takes to transmit a
link state update packet over this interface.
Valid values for <seconds> range from 1 to 3600 (1 hour).
The no version of this command sets the default OSPF Transit Delay for the specified
interface.
Default
Syntax
Mode
Interface Config
ip ospf mtu-ignore
This command disables OSPF maximum transmission unit (MTU) mismatch detection.
OSPF Database Description packets specify the size of the largest IP packet that can be sent
without fragmentation on the interface. When a router receives a Database Description
packet, it examines the MTU advertised by the neighbor. By default, if the MTU is larger than
the router can accept, the Database Description packet is rejected and the OSPF adjacency is
not established.
The no version of this command enables the OSPF MTU mismatch detection.
Default
Enabled
Syntax
Mode
Interface Config
router-id
This command sets a 4-digit dotted-decimal number uniquely identifying the router ospf id.
The <ipaddress> is a configured value.
Syntax
312
router-id <ipaddress>
OSPF Commands
redistribute
Mode
redistribute
This command configures OSPF protocol to redistribute routes from the specified source
protocol/routers.
The no version of this command configures OSPF protocol to redistribute routes from the
specified source protocol/routers.
Default
Syntax
Mode
maximum-paths
This command sets the number of paths that OSPF can report for a given destination where
maxpaths is platform dependent.
The no version of this command resets the number of paths that OSPF can report for a given
destination back to its default value.
Default
Syntax
maximum-paths <maxpaths>
no maximum-paths
Mode
show ip ospf
This command displays information relevant to the OSPF router. This command takes no
options.
313
show ip ospf
Syntax
Mode
show ip ospf
Privileged EXEC
Router IDIs a 32 bit integer in dotted decimal format identifying the router, about which information is
displayed. This is a configured value.
OSPF Admin ModeThe administrative mode of OSPF in the router. This is a configured value.
ASBR ModeReflects whether the ASBR mode is enabled or disabled. Enable implies that the router is
an autonomous system border router. Router automatically becomes an ASBR when it is configured to
redistribute routes learnt from other protocol. The possible values for the ASBR status is enabled (if the
router is configured to re-distribute routes learnt by other protocols) or disabled (if the router is not
configured for the same).
RFC 1583 CompatibilityReflects whether 1583 compatibility is enabled or disabled. This is a
configured value.
Default-metricRDefault value for redistributed routes.
SourceSource protocol/routes that are being redistributed.
Metric-valueMetric of the routes being redistributed.
Type-valueExternal Type 1 or External Type 2 routes.
Tag-valueDecimal value attached to each external route.
SubnetsFor redistributing routes into OSPF, the scope of redistribution for the specified protocol.
Distribute-listTAccess list used to filter redistributed routes.
Default-info originateIndicates whether the default routes received from other source protocols are
advertised or not
314
OSPF Commands
Import Summary
LSAs
Metric ValueIs a number representing the Metric Value for the specified area.
Metric TypeIs the Default Metric Type for the specified Area.
315
LS IDIs a number that "uniquely identifies an LSA that a router originates from all other self originated
LSA's of the same LS type."
AgeIs a number representing the age of the link state advertisement in seconds.
SequenceIs a number that represents which LSA is more recent.
ChecksumIs to total number LSA checksum.
OptionsThis is an integer. It indicates that the LSA receives special handling during routing
calculations.
OSPF Commands
OSPF Interface TypeBroadcast LANs, such as Ethernet and IEEE 802.5, take the value 'broadcast'.
The OSPF Interface Type will be 'broadcast'.
StateThe OSPF Interface States are: down, loopback, waiting, point-to-point, designated router, and
backup designated router. This is the state of the OSPF interface.
Designated RouterIs the router ID representing the designated router.
Backup Designated RouterIs the router ID representing the backup designated router.
Number of Link EventThe number of link events.
Metric CostIs the cost of the ospf interface. This is a configured value.
317
318
The number of times this neighbor relationship has changed state, or an error has occurred.
PermanenceThis variable displays the status of the entry, either dynamic or permanent. This refers to
how the neighbor became known.
Hellos SuppressedThis indicates whether Hellos are being suppressed to the neighbor. The types are
enabled and disabled.
Retransmission Queue LengthIs an integer representing the current length of the retransmission
queue of the specified neighbor router Id of the specified interface.
319
320
321
trapflags
Syntax
Mode
trapflags
This command enables OSPF traps.
The no version of this command disables OSPF traps.
Default
enabled
Syntax
[no] trapflags
Mode
322
Show commands are used to display switch settings, statistics and other information.
Configuration Commands are used to configure features and options of the switch. For
every configuration command there is a show command that will display the
configuration setting.
Copy commands are used to transfer configuration and informational files to and from the
switch.
OSPF Commands
enable (RIP)
enable (RIP)
This command resets the default administrative mode of RIP in the router (active).
The no version of this command sets the administrative mode of RIP in the router to inactive.
Default
enabled
Syntax
[no] enable
Mode
ip rip
This command enables RIP on a router interface.
The no version of this command disables RIP on a router interface.
Default
disabled
Syntax
[no] ip rip
Mode
Interface Config
auto-summary
This command enables the RIP auto-summarization mode.
The no version of this command disables the RIP auto-summarization mode.
Default
enabled
Syntax
[no] auto-summary
Mode
323
default-metric (RIP)
This command is used to set a default for the metric of distributed routes.
The no version of this command is used to reset the default metric of distributed routes to its
default value.
Syntax
default-metric <0-15>
no default-metric
Mode
distance rip
This command sets the route preference value of RIP in the router. Lower route preference
values are preferred when determining the best route.
The no version of this command sets the default route preference value of RIP in the router.
Default
15
Syntax
Mode
324
OSPF Commands
distribute-list out
distribute-list out
This command is used to specify the access list to filter routes received from the source
protocol.
The no version of this command is used to specify the access list to filter routes received
from the source protocol.
Default
Syntax
Mode
no default-information originate
This command is used to control the advertisement of default routes.
Syntax
Mode
no default-information originate
ip rip authentication
This command sets the RIP Version 2 Authentication Type and Key for the specified
interface. The value of <type> is either none, simple, or encrypt.
The value for authentication key [key] must be 16 bytes or less. The [key] is composed of
standard displayable, non-control keystrokes from a Standard 101/102-key keyboard. If the
value of <type> is encrypt, a keyid in the range of 0 and 255 must be specified.
The no version of this command sets the default RIP Version 2 Authentication Type.
Default
Default
The default password key is an empty string. Unauthenticated interfaces do not need an
authentication key.
Default
The default key id is not defined. Unauthenticated interfaces do not need an authentication
key id.
Syntax
325
Interface Config
both
Syntax
Mode
Interface Config
rip2
Syntax
326
OSPF Commands
hostroutesaccept
Mode
Interface Config
hostroutesaccept
This command enables the RIP hostroutesaccept mode.
The no version of this command disables the RIP hostroutesaccept mode.
Default
enabled
Syntax
[no] hostroutesaccept
Mode
split-horizon
This command sets the RIP split horizon mode.
The no version of this command sets the default RIP split horizon mode.
Default
simple
Syntax
Mode
redistribute
This command configures RIP protocol to redistribute routes from the specified source
protocol/routers. There are five possible match options. When you submit the command
redistribute ospf match <match-type> the match-type or types specified are added to any
match types presently being redistributed. Internal routes are redistributed by default.
The no version of this command de-configures RIP protocol to redistribute routes from the
specified source protocol/routers.
Default
metricnot-configured; matchinternal
327
show ip rip
show ip rip
This command displays information relevant to the RIP router.
The no version of this command
Syntax
Mode
show ip rip
Privileged
RIP Admin ModeSelect enable or disable from the pulldown menu. If you select enable RIP will be
enabled for the switch. The default is disable.
Split Horizon ModeSelect none, simple or poison reverse from the pulldown menu. Split horizon is a
technique for avoiding problems caused by including routes in updates sent to the router from which the
route was originally learned. The options are: None - no special processing for this case. Simple - a
route will not be included in updates sent to the router from which it was learned. Poisoned reverse - a
route will be included in updates sent to the router from which it was learned, but the metric will be set to
infinity. The default is simple
Auto Summary ModeSelect enable or disable from the pulldown menu. If you select enable groups of
adjacent routes will be summarized into single entries, in order to reduce the total number of entries The
default is enable.
Host Routes Accept ModeSelect enable or disable from the pulldown menu. If you select enable the
router will be accept host routes. The default is enable.
Global Route ChangesThe number of route changes made to the IP Route Database by RIP. This
does not include the refresh of a route's age.
Global queriesThe number of responses sent to RIP queries from other systems.Default Metric
Sets a default for the metric of redistributed routes.This field displays the default metric if one has
already been set or blank if not configured earlier. The valid values are (1 to 15)
Default MetricSets a default for the metric of redistributed routes.This field displays the default metric
if one has already been set or blank if not configured earlier. The valid values are (1 to 15)
Default Route AdvertiseThe default route.
328
OSPF Commands
329
Default MetricA number which represents the metric used for default routes in RIP updates originated
on the specified interface. This is a configured value.
330
OSPF Commands
Chapter 29
IP Multicast Commands
This chapter provides a detailed explanation of the IP Multicast commands. The following IP
Multicast CLI commands are available in the SFTOS software IP Multicast module.
ip mcast boundary
This command adds an administrative scope multicast boundary specified by groupipaddr
and mask for which this multicast administrative boundary is applicable. groupipaddr is a
group IP address and mask is a group IP mask.
The no version of this command deletes an administrative scope multicast boundary
specified by groupipaddr and mask for which this multicast administrative boundary is
applicable. groupipaddr is a group IP address and mask is a group IP mask.
Syntax
Mode
Interface Config
ip multicast
This command sets the administrative mode of the IP multicast forwarder in the router to
active . For multicast routing to become operational, IGMP must be currently enabled. An
error message will be displayed on the CLI if multicast routing is enabled while IGMP is
disabled. However, the IP multicast mode configuration is stored in the multicast
configuration file and is automatically enabled once IGMP is enabled.
The no version of this command sets the administrative mode of the IP multicast forwarder in
the router to inactive . For multicast routing to become operational, IGMP must be currently
enabled. An error message will be displayed on the CLI if multicast routing is enabled while
IGMP is disabled. However, the IP multicast mode configuration is stored in the multicast
configuration file and is automatically enabled once IGMP is enabled.
SFTOS Command Line Interface Reference, Version 2.1.4
331
ip multicast staticroute
Default
disabled
Syntax
[no] ip multicast
Mode
Global Config
ip multicast staticroute
This command creates a static route which is used to perform RPF checking in multicast
packet forwarding. The combination of the sourceipaddr and the mask fields specify the
network IP address of the multicast packet source. The groupipaddr is the IP address of the
next hop toward the source. The metric is the cost of the route entry for comparison with
other routes to the source network and is a value in the range of 0 and 255. The current
incoming interface is used for RPF checking for multicast packets matching this multicast
static route entry.
The no version of this command deletes a static route in the static mcast table. The
sourceipaddr is the IP address of the multicast packet source.
Default
none
Syntax
Mode
Global Config
ip multicast ttl-threshold
This command applies the given ttlthreshold to a routing interface. The ttlthreshold is the
TTL threshold which is to be applied to the multicast Data packets which are to be forwarded
from the interface. The value for ttlthreshold has range from 0 to 255.
The no version of this command applies the default ttlthreshold to a routing interface. The
ttlthreshold is the TTL threshold which is to be applied to the multicast Data packets which
are to be forwarded from the interface.
Default
Syntax
332
IP Multicast Commands
Mode
Interface Config
none
Syntax
Mode
Global Config
mrinfo
This command is used to query the neighbor information of a multicast-capable router
specified by [ipaddr]. The default value is the IP address of the system at which the
command is issued. The mrinfo command can take up to 2 minutes to complete. Only one
mrinfo command may be in process at a time. The results of this command will be available
in the results bufferpool which can be displayed by using show mrinfo.
Default
none
Syntax
mrinfo [ipaddr]
Mode
Privileged EXEC
333
mstat
mstat
This command is used to find the packet rate and loss information path from a source to a
receiver (unicast router id of the host running mstat). The results of this command will be
available in the results bufferpool which can be displayed by using show mstat. If a debug
command is already in progress, a message is displayed and the new request fails.
The source is the IP Address of the remote multicast-capable source. The [receiver] is the IP
address of the receiver. The default value is the IP address of system at which the command is
issued. The [group] is a multicast address of the group to be displayed. Default value is
224.2.0.1
Default
none
Syntax
Mode
Privileged EXEC
mtrace
This command is used to find the multicast path from a source to a receiver (unicast router ID
of the host running mtrace). A trace query is passed hop-by-hop along the reverse path from
the receiver to the source, collecting hop addresses, packet counts, and routing error
conditions along the path, and then the response is returned to the requestor. The results of
this command will be available in the results buffer pool which can be displayed by using
show mtrace.
The source is the IP Address of the remote multicast-capable source. The [receiver] is the
IP address of the receiver. The default value is the IP address of system at which the
command is issued. The [group] is the multicast address of the group to be displayed. The
default value is 224.2.0.1
If a debug command is already in execution, a message is displayed and the new request fails.
Default
none
Syntax
Mode
334
Privileged EXEC
IP Multicast Commands
no ip mcast mroute
no ip mcast mroute
This command is used to clear entries in the mroute table. The all parameters is used to clear
all entries.
The source parameter is used to clear the routes in the mroute table entries containing the
specified sourceipaddr or sourceipaddr [groupipaddr] pair. The source address is the
source IP address of the multicast packet. The group address is the Group Destination IP
address of the multicast packet.
The group parameter is used to clear the routes in the mroute table entries containing the
specified groupipaddr. The group address is the Group Destination IP address of the
multicast packet.
Default
none
Syntax
Mode
Global Config
show ip mcast
This command displays the system-wide multicast information.
Syntax
Mode
show ip mcast
335
336
IP Multicast Commands
337
Mode
338
IP Multicast Commands
show mrinfo
show mrinfo
This command is used to display the neighbor information of a multicast-capable router from
the results buffer pool of the router subsequent to the execution/completion of a mrinfo
[ipaddr] command. The results subsequent to the completion of the latest mrinfo will be
available in the bufferpool after a maximum duration of two minutes after the completion of
the show mrinfo command. A subsequent issue mrinfo will overwrite the contents of the
buffer pool with fresh results.
Default
none
Syntax
show mrinfo
Mode
Privileged EXEC
Router InterfaceThe IP address of this neighbor
NeighborThe neighbor associated with the router interface
MetricThe metric value associated with this neighbor
TTLThe TTL threshold associated with this neighbor
FlagsStatus of the neighbor
show mstat
This command is used to display the results of packet rate and loss information from the
results buffer pool of the router, subsequent to the execution/completion of a mstat source
[group] [receiver] command. Within two minutes of the completion of the mstat
command, the results will be available in the buffer pool. The next issuing of mstat would
overwrite the buffer pool with fresh results.
Default
none
Syntax
show mstat
Mode
Privileged EXEC
339
show mtrace
show mtrace
This command is used to display results of multicast trace path from the results bufferpool of
the router, subsequent to the execution/completion of a mtrace source [group] [receiver]
command. The results subsequent to the completion of the mtrace will be available in the
bufferpool within two minutes and thereafter. A subsequent mtrace command would
overwrite the results in the bufferpool.
Default
none
Syntax
show mtrace
Mode
Show commands are used to display device settings, statistics and other information.
Configuration commands are used to configure features and options of the switch. For
every configuration command there is a show command that will display the
configuration setting.
ip dvmrp
This command sets administrative mode of DVMRP in the router to active. IGMP must be
enabled before DVMRP can be enabled.
The no version of this command sets administrative mode of DVMRP in the router to
inactive. IGMP must be enabled before DVMRP can be enabled.
340
IP Multicast Commands
ip dvmrp metric
Default
disabled
Syntax
[no] ip dvmrp
Mode
Global Config
ip dvmrp metric
This command configures the metric for an interface. This value is used in the DVMRP
messages as the cost to reach this network. This field has a range of 1 to 63.
The no version of this command resets the metric for an interface to the default value. This
value is used in the DVMRP messages as the cost to reach this network.
Default
Syntax
Mode
Interface Config
ip dvmrp trapflags
This command enables the DVMRP trap mode.
The no version of this command disables the DVMRP trap mode.
Default
disabled
Syntax
Mode
Global Config
ip dvmrp
This command sets administrative mode of DVMRP on an interface to active.
The no version of this command sets administrative mode of DVMRP on an interface to
inactive.
341
show ip dvmrp
Default
disabled
Syntax
[no] ip dvmrp
Mode
Interface Config
show ip dvmrp
This command displays the system-wide information for DVMRP.
Syntax
Mode
show ip dvmrp
342
IP Multicast Commands
The following fields are displayed only if DVMRP is enabled on this interface.
Received Bad PacketsThis is the number of invalid packets received.
Received Bad RoutesThis is the number of invalid routes received.
Sent RoutesThis is the number of routes that have been sent on this interface.
343
344
ip igmp version
Source AddressThis field displays the multicast address of the source group.
Source MaskThis field displays the IP Mask for the source group.
Upstream NeighborThis field indicates the IP Address of the neighbor which is the source for the
packets for a specified multicast address.
InterfaceThis field displays the interface used to receive the packets sent by the sources.
MetricThis field displays the distance in hops to the source subnet. This field has a different meaning
than the Interface Metric field.
Expiry Time(secs)This field indicates the expiry time in seconds. This is the time remaining for this
route to age out.
Up Time(secs)This field indicates the time when a specified route was learnt, in seconds.
Show commands are used to display device settings, statistics and other information.
Configuration commands are used to configure features and options of the switch. For
every configuration command there is a show command that will display the
configuration setting.
ip igmp version
This command configures the version of IGMP for an interface. The value for <version> is
either 1, 2 or 3.
The no version of this command resets the version of IGMP for this interface.The version is
reset to the default value.
Default
Syntax
Mode
Interface Config
345
ip igmp
ip igmp
This command sets the administrative mode of IGMP in the router to active.
The no version of this command sets the administrative mode of IGMP in the router to
inactive.
Default
disabled
Syntax
[no] ip igmp
Mode
Global Config
ip igmp last-member-query-count
This command sets the number of Group-Specific Queries sent before the router assumes that
there are no local members on the interface. The range for count is 1 to 20.
The no version of this command resets the number of Group-Specific Queries to the default
value.
Syntax
Mode
Interface Config
ip igmp last-member-query-interval
This command configures the Maximum Response Time being inserted into Group-Specific
Queries sent in response to Leave Group messages on the interface. The range for seconds is
0 to 255 tenths of a second.
The no version of this command resets the Maximum Response Time being inserted into
Group-Specific Queries sent in response to Leave Group messages on the interface to the
default value.
Default
Syntax
346
IP Multicast Commands
ip igmp query-interval
Mode
Interface Config
ip igmp query-interval
This command configures the query interval for the specified interface. This is the frequency
at which IGMP Host-Query packets are transmitted on this interface. The range for
queryinterval is 1 to 3600 seconds.
The no version of this command resets the query interval for the specified interface to the
default value. This is the frequency at which IGMP Host-Query packets are transmitted on
this interface.
Default
125 seconds
Syntax
Mode
Interface Config
ip igmp query-max-response-time
This command configures the maximum response time interval for the specified interface,
which is the maximum query response time advertised in IGMPv2 queries on this
interface.The time interval is specified in tenths of a second. The range for maxresptime is
0 to 255 tenths of a second.
The no version of this command resets the maximum response time interval for the specified
interface, which is the maximum query response time advertised in IGMPv2 queries on this
interface to the default value. The maximum response time interval is reset to the default
time.
Default
100
Syntax
Mode
Interface Config
347
ip igmp robustness
ip igmp robustness
This command configures the robustness that allows tuning of the interface. The robustness is
the tuning for the expected packet loss on a subnet. If a subnet is expected to have a lot of
loss, the Robustness variable may be increased for the interface. The range for robustness is
1 to 255.
The no version of this command sets the robustness value to default.
Default
Syntax
Mode
Interface Config
ip igmp startup-query-count
This command sets the number of Queries sent out on startup, separated by the Startup Query
Interval on the interface. The range for count is 1 to 20.
The no version of this command resets the number of Queries sent out on startup, separated
by the Startup Query Interval on the interface to the default value.
Default
Syntax
Mode
Interface Config
ip igmp startup-query-interval
This command sets the interval between General Queries sent by a Querier on startup on the
interface. The time interval value is in seconds. The range for interval is 1 to 300 seconds.
The no version of this command resets the interval between General Queries sent by a
Querier on startup on the interface to the default value.
Default
348
31
IP Multicast Commands
Syntax
Mode
Interface Config
The following fields are not displayed if the interface is not enabled.
Querier StatusThis displays whether the interface has IGMP in Querier mode or Non-Querier mode.
GroupsThis displays the list of multicast groups that are registered on this interface.
349
show ip igmp
show ip igmp
This command displays the system-wide IGMP information.
Syntax
Mode
show ip igmp
350
IP Multicast Commands
Last Member Query IntervalThis value indicates the Maximum Response Time inserted into
Group-Specific Queries sent in response to Leave Group messages. This is a configured value.
Last Member Query CountThis value is the number of Group-Specific Queries sent before the router
assumes that there are no local members. This is a configured value.
Privileged EXEC
InterfaceValid unit, slot and port number separated by forward slashes.
Interface IPThis displays the IP address of the interface participating in the multicast group.
StateThis displays whether the interface has IGMP in Querier mode or Non-Querier mode.
Group Compatibility ModeThe group compatibility mode (v1, v2 or v3) for the specified group on this
interface.
Source Filter ModeThe source filter mode (Include/Exclude) for the specified group on this interface.
This is ----- for IGMPv1 and IGMPv2 Membership Reports.
351
352
IP Multicast Commands
Chapter 30
PIM-DM Commands
Show commands are used to display device settings, statistics and other information.
Configuration commands are used to configure features and options of the switch. For
every configuration command there is a show command that will display the
configuration setting.
ip pimdm
This command enables the administrative mode of PIM-DM in the router.
The no version of this command disables the administrative mode of PIM-DM in the router.
IGMP must be enabled before PIM-DM can be enabled.
Default
disabled
Syntax
[no] ip pimdm
Mode
Global Config
ip pimdm mode
This command sets administrative mode of PIM-DM on an interface to enabled.
The no version of this command sets administrative mode of PIM-DM on an interface to
disabled.
Default
disabled
Syntax
353
ip pimdm query-interval
Mode
Interface Config
ip pimdm query-interval
This command configures the transmission frequency of hello messages between PIM
enabled neighbors. This field has a range of 10 to 3600 seconds.
The no version of this command resets the transmission frequency of hello messages between
PIM enabled neighbors to the default value.
Default
30
Syntax
Mode
Interface Config
show ip pimdm
This command displays the system-wide information for PIM-DM.
Syntax
Mode
show ip pimdm
354
PIM-DM Commands
355
ip pimsm cbsrpreference
Show commands are used to display device settings, statistics and other information.
Configuration commands are used to configure features and options of the switch. For
every configuration command there is a show command that will display the
configuration setting.
ip pimsm cbsrpreference
This command is used to configure the CBSR preference for a particular PIM-SM interface.
The range of CBSR preference is 1 to 255.
The no version of this command is used to reset the CBSR preference for a particular
PIM-SM interface to the default value.
Default
Syntax
Mode
Interface Config
ip pimsm cbsrhashmasklength
This command is used to configure the CBSR hash mask length to be advertised in bootstrap
messages for a particular PIM-SM interface. This hash mask length will be used in the hash
algorithm for selecting the RP for a particular group. The valid range is 0 - 32. The default
value is 30.
The no version of this command is used to reset the CBSR hash mask length for a particular
PIM-SM interface to the default value.
356
PIM-DM Commands
ip pimsm crppreference
Default
30
Syntax
Mode
Interface Config
ip pimsm crppreference
This command is used to configure the Candidate Rendezvous Point (CRP) for a particular
PIM-SM interface. The valid values are from (1 to 255), and the value of -1 is used to indicate
that the local interface is not a Candidate RP interface.
The active router interface, with the highest IP Address and crppreference greater than -1, is
chosen as the CRP for the router. The default value is 0.
In the CRP advertisements sent to the bootstrap router (BSR), the router interface advertises
itself as the CRP for the group range 224.0.0.0 mask 240.0.0.0.
The no version of this command is used to reset the Candidate Rendezvous Point (CRP) for a
particular PIM-SM interface to the default value.
Default
Syntax
Mode
Interface Config
ip pimsm datathreshrate
This command is used to configure the data Threshold rate for the PIM-SM router. The rate is
specified in Kilobytes per second. The possible values are 0 to 2000.
The no version of this command is used to reset the data Threshold rate for the PIM-SM
router to the defaule value.
Default
50
Syntax
357
ip pimsm message-interval
no ip pimsm datathreshrate
Mode
Global Config
ip pimsm message-interval
This command is used to configure the global join/prune interval for PIM-SM router. The
join/prune interval is specified in seconds. This parameter can be configured to a value from
10 to 3600.
The no version of this command is used to reset the global join/prune interval for PIM-SM
router to the default value.
Default
60
Syntax
Mode
Global Config
ip pimsm
This command sets administrative mode of PIM-SM multicast routing across the router to
enabled. IGMP must be enabled before PIM-SM can be enabled.
The no version of this command sets administrative mode of PIM-SM multicast routing
across the router to disabled. IGMP must be enabled before PIM-SM can be enabled.
Default
disabled
Syntax
[no] ip pimsm
Mode
Global Config
ip pimsm mode
This command sets administrative mode of PIM-SM multicast routing on a routing interface
to enabled.
358
PIM-DM Commands
ip pimsm query-interval
The no version of this command sets administrative mode of PIM-SM multicast routing on a
routing interface to disabled.
Default
disabled
Syntax
Mode
Interface Config
ip pimsm query-interval
This command configures the transmission frequency of hello messages in seconds between
PIM enabled neighbors. This field has a range of 10 to 3600 seconds.
The no version of this command resets the transmission frequency of hello messages between
PIM enabled neighbors to the default value.
Default
30
Syntax
Mode
Interface Config
ip pimsm spt-threshold
This command is used to configure the Threshold rate for the RP router to switch to the
shortest path. The rate is specified in Kilobytes per second. The possible values are 0 to 2000.
The no version of this command is used to reset the Threshold rate for the RP router to switch
to the shortest path to the default value.
Default
50
Syntax
Mode
Global Config
359
ip pim-trapflags
ip pim-trapflags
This command enables the PIM trap mode for both Sparse Mode (SM) and Dense Mode.
(DM).
The no version of this command disables the PIM trap mode.
Default
disabled
Syntax
[no] ip pim-trapflags
Mode
Global Config
ip pimsm staticrp
This command is used to create RP IP address for the PIM-SM router. The parameter
ipaddress is the IP address of the RP. The parameter groupaddress is the group address
supported by the RP. The parameter groupmask is the group mask for the group address.
The no version of this command is used to delete RP IP address for the PIM-SM router. The
parameter ipaddress is the IP address of the RP. The parameter groupaddress is the group
address supported by the RP. The parameter groupmask is the group mask for the group
address.
Default
disabled
Syntax
Mode
Global Config
360
PIM-DM Commands
show ip pimsm
This command displays the system-wide information for PIM-SM.
The no version of this command
Syntax
Mode
show ip pimsm
361
362
PIM-DM Commands
363
show ip pimsm rp
show ip pimsm rp
This command displays the PIM information for candidate Rendezvous Points (RPs) for all
IP multicast groups or for the specific groupaddress groupmask provided in the command.
The information in the table is displayed for each IP multicast group.
The no version of this command
Syntax
Mode
364
PIM-DM Commands
Glossary
Numerics
802.1D. The IEEE designator for Spanning Tree Protocol
(STP). STP, a link management protocol, is part of the
802.1D standard for media access control bridges. Using
the spanning tree algorithm, STP provides path
redundancy while preventing endless loops in a network.
An endless loop is created by multiple active paths
between stations where there are alternate routes between
hosts. To establish path redundancy, STP creates a logical
tree that spans all of the switches in an extended network,
forcing redundant paths into a standby, or blocked, state.
STP allows only one active path at a time between any two
network devices (this prevents the loops) but establishes
the redundant links as a backup if the initial link should
fail. If STP costs change, or if one network segment in the
STP becomes unreachable, the spanning tree algorithm
reconfigures the spanning tree topology and reestablishes
the link by activating the standby path. Without spanning
tree in place, it is possible that both connections may be
simultaneously live, which could result in an endless loop
of traffic on the LAN.
802.1P. The IEEE protocol designator for Local Area
Network (LAN). This Layer 2 network standard improves
support of time critical traffic, and limits the extent of high
bandwidth multicast traffic within a bridged LAN. To do
this, 802.1P defines a methodology for introducing traffic
class priorities. The 802.1P standard allows priority to be
defined in all 802 MAC protocols (Ethernet, Token Bus,
Token Ring), as well as in FDDI. For protocols (such as
Ethernet) that do not contain a priority field, 802.1P
specifies a method for indicating frame priority based on
the new fields defined in the 802.1Q (VLAN) standard.
802.1Q VLAN. The IEEE protocol designator for Virtual
Local Area Network (VLAN). This standard provides
VLAN identification and quality of service (QoS) levels.
Four bytes are added to an Ethernet frame to allow eight
priority levels (QoS) and to identify up to 4096 VLANs.
See VLAN on page 373 for more information.
A
ABR. See Area Border Router on page 365.
Access Control List. An ACL is a database that an
Operating System uses to track each users access rights to
system objects (such as file directories and/or files).
365
366
Glossary
D
DAPI. See Device Application Programming Interface
on page 367.
Device Application Programming Interface. DAPI is
the software interface that facilitates communication of
both data and control information between the Application
Layer and HAPI, with support from System Support.
DHCP. See Dynamic Host Configuration Protocol. on
page 367.
Differentiated Services. Diffserv is a protocol for
specifying and controlling network traffic by class so that
certain types of traffic get precedence - for example, voice
traffic, which requires a relatively uninterrupted flow of
data, might get precedence over other kinds of traffic.
Differentiated Services is the most advanced method for
managing traffic in terms of what is called Class of
Service (CoS). Unlike the earlier mechanisms of 802.1P
tagging and Type of Service (ToS), Differentiated Services
avoids simple priority tagging and depends on more
complex policy or rule statements to determine how to
forward a given network packet. An analogy is made to
travel services, in which a person can choose among
different modes of travel - train, bus, airplane - degree of
comfort, the number of stops on the route, standby status,
the time of day or period of year for the trip, and so forth.
For a given set of packet travel rules, a packet is given one
of 64 possible forwarding behaviors - known as per hop
behaviors (PHBs). A six-bit field, known as the
Differentiated Services Code Point (DSCP), in the Internet
Protocol (Internet Protocol) header specifies the per hop
behavior for a given flow of packets. Differentiated
Services and the Class of Service approach provide a way
to control traffic that is both more flexible and more
scalability than the Quality of Service approach.
Diffserv. See Differentiated Services. on page 367..
Distance-Vector Multicast Routing Protocol. DVMRP
is a distance vector routing protocol used between routers
in an intranet. This hop-based protocol describes a method
of building multicast trees from the multicast source to all
the receivers (or leaves) of the tree.
DVMRP. See Distance-Vector Multicast Routing
Protocol. on page 367.
Dynamic Host Configuration Protocol. DHCP is a
protocol for assigning dynamic IP addresses to devices on
a network. With dynamic addressing, a device can have a
different IP address every time it connects to the network.
In some systems, the device's IP address can even change
while it is still connected. DHCP also supports a mix of
E
EEPROM. See Electronically Erasable Programmable
Read Only Memory on page 367.
Electronically Erasable Programmable Read Only
Memory. EEPROM is also known as Flash memory. This
is re-programmable memory.
F
Fast STP. A high-performance Spanning Tree Protocol.
See STP on page 372 for more information.
FIFO. First In First Out.
Flash Memory. See EEPROM on page 367.
Flow Control. The process of adjusting the flow of data
from one network device to another to ensure that the
receiving device can handle all of the incoming data. This
is particularly important where the sending device is
capable of sending data much faster than the receiving
device can receive it. There are many flow control
mechanisms. One of the most common flow control
protocols for asynchronous communication is called xonxoff. In this case, the receiving device sends a an xoff
message to the sending device when its buffer is full. The
sending device then stops sending data. When the
receiving device is ready to receive more data, it sends an
xon signal.
Forwarding. When a frame is received on an input port
on a switch, the address is checked against the lookup
table. If the lookup table has recorded the destination
address, the frame is automatically forwarded on an output
port.
Frame Check Sequence. The extra characters added to a
frame for error detection and correction. FCS is used in
X.25, HDLC, Frame Relay, and other data link layer
protocols.
G
GARP. See Generic Attribute Registration Protocol. on
page 368.
367
H
.h file. Header file in C code. Contains function and
coding definitions.
368
I
ICMP. See Internet Control Message Protocol on
page 368.
IGMP. See Internet Group Management Protocol on
page 368.
IGMP Snooping. A series of operations performed by
intermediate systems to add logic to the network to
optimize the flow of multicast traffic; these intermediate
systems (such as Layer 2 switches) listen for IGMP
messages and build mapping tables and associated
forwarding filters, in addition to reducing the IGMP
protocol traffic. See Internet Group Management
Protocol on page 368 for more information.
Internet Control Message Protocol. ICMP is an
extension to the Internet Protocol (IP) that supports
packets containg error, control, and informational
messages. The PING command, for example, uses ICMP
to test an Internet connection.
Internet Group Management Protocol. IGMP is the
standard for IP Multicasting on the Internet. IGMP is used
to establish host memberships in particular multicast
groups on a single network. The mechanisms of the
protocol allow a host to inform its local router, using Host
Membership Reports, that it wants to receive messages
addressed to a specific multicast group. All hosts
conforming to Level 2 of the IP Multicasting specification
require IGMP.
IP. See Internet Protocol on page 368.
IP Multicasting. Sending out data to distributed servers
on the MBone (Multicast Backbone). For large amounts of
data, IP Multicast is more efficient than normal Internet
transmissions because the server can broadcast a message
to many recipients simultaneously. Unlike traditional
Internet traffic that requires separate connections for each
source-destination pair, IP Multicasting allows many
recipients to share the same source. This means that just
one set of packets is transmitted for all the destinations.
Internet Protocol. The method or protocol by which data
is sent from one computer to another on the Internet. Each
Glossary
J
Joint Test Action Group. An IEEE group that specifies
test framework standards for electronic logic components.
JTAG. See Joint Test Action Group on page 369.
L
LAN. See Local Area Network on page 369.
LDAP. See Lightweight Directory Access Protocol on
page 369.
Lightweight Directory Access Protocol. A set of
protocols for accessing information directories. LDAP is
M
MAC. (1) Medium Access Control. In LANs, the
sublayer of the data link control layer that supports
medium-dependent functions and uses the services of the
physical layer to provide services to the logical link
control (LLC) sublayer. The MAC sublayer includes the
method of determing when a device has access to the
transmission medium. (2) Message Authentication Code.
In computer security, a value that is a part of a message or
accompanies a message and is used to determine that the
contents, origin, author, or other attributes of all or part of
the message are as they appear to be. (IBM Glossary of
Computing Terms)
Management Information Base. When SNMP devices
send SNMP messages to the management console (the
device managing SNMP messages), it stores information
in the MIB.
MBONE. See Multicast Backbone on page 370.
MDC. Management Data Clock.
MDI. Management Data Interface.
369
N
NAT. See Network Address Translation on page 370.
Network Address Translation. Sometimes referred to as
Transparent Proxying, IP Address Overloading, or IP
Masquerading. Involves use of a device called a Network
Address Translator, which assigns a contrived, or logical,
IP address and port number to each node on an
organization's internal network and passes packets using
these assigned addresses.
NM. Network Module.
nm. Nanometer (1 x 10e9) meters.
non-stub area. Resource-intensive OSPF area that
carries a default route, static routes, intra-area routes,
interarea routes, and external routes. Non-stub areas are
the only OSPF areas that can have virtual links configured
across them, and are the only areas that can contain an
ASBR. Compare with stub area. See also ASAM and
OSPF.
Glossary
O
Open Shortest Path First. A link- state (algorithm used
by the router to determine the current topology of a
network), Interior Gateway (distributes routing
information between routers belonging to a single
Autonomous System) routing protocol. This protocol's
algorithm determines the shortest path from its router to all
the other routers in the network. This protocol is rapidly
replacing RIP on the Internet.
Open Systems Interconnection. OSI is a seven (7) layer
architecture model for communications systems developed
by the ISO for the interconnection of data communications
systems. Each layer uses and builds on the services
provided by those below it.
Operating System Application Programming
Interface. OSAPI is a module within the System Support
software that provides a set of interfaces to OS support
functions.
R
Real-Time Operating System. RTOS is a component of
the OSAPI module that abstracts operating systems with
which other systems can interface.
Resource Reservation Setup Protocol. RSVP is a new
Internet protocol being developed to enable the Internet to
support specified Qualities-of-Service (QoS). Using
RSVP, an application will be able to reserve resources
along a route from source to destination. RSVP-enabled
routers will then schedule and prioritize packets to meet
the prioritization assigned by QoS. RSVP is a chief
component of a new type of Internet being developed,
known broadly as an integrated services Internet. The
general idea is to enhance the Internet to support
transmission of real-time data.
371
372
stub area. OSPF area that carries a default route, intraarea routes, and interarea routes, but does not carry
external routes. Virtual links cannot be configured across a
stub area, and they cannot contain an ASBR. Compare
with non-stub area. See also ASAM and OSPF.
SX. See SimpleX signaling on page 372.
SYSAPI. See Systems Application Programming
Interface on page 372.
Systems Application Programming Interface. SYSAPI
is a module within the System Support software that
provides system-wide routines for network and mbuf
support and provides the interface into the system registry.
T
TBI. Ten Bit Interface.
Glossary
U
UPM. User Programmable Machine.
UPMA. The first of two UPMs in Motorola's MPC855T
processor.
UPMB. The second of two UPMs in Motorola's
MPC855T processor.
USP. An abbreviation that represents Unit, Slot, Port.
V
Virtual Local Area Network. Operating at the Data Link
Layer (Layer 2 of the OSI model), the VLAN is a means
of parsing a single network into logical user groups or
organizations, as if they physically resided on a dedicated
LAN segment of their own. In reality, this virtually
defined community may have individual members
peppered across a large, extended LAN. The VLAN
identifier is part of the 802.1Q tag, which is added to an
Ethernet frame by an 802.1Q-compliant switch or router.
Devices recognizing 802.1Q-tagged frames maintain
appropriate tables to track VLANs. The first three bits of
the 802.1Q tag are used by 802.1P to establish priority for
the packet.
Virtual Router Redundancy Protocol. VRRP specifies
an election protocol that dynamically assigns
responsibility for a virtual router to one of the VRRP
routers on a LAN. The VRRP router controlling the IP
address(es) associated with a virtual router is called the
Master, and forwards packets sent to these IP addresses.
The election process provides dynamic fail-over in the
forwarding responsibility should the Master become
unavailable. This allows any of the virtual router IP
W
WAN. See Wide Area Network on page 373.
Web. Also known as World-Wide Web (WWW) or W3.
An Internet client-server system to distribute information,
based upon the hypertext transfer protocol (HTTP).
Wide Area Network. A WAN is a computer network that
spans a relatively large geographical area. Typically, a
WAN consists of two or more local-area networks
(LANs).
X
X.500. A directory standard that enables applications like
e-mail to access information that can either be central or
distributed. The benefit of a directory is the ability to
minimize the impact on the user of changes to a network.
The standard is broken down under subsequent standards,
as follows:
X.501 Models
X.509 Authentication framework
X.511 Abstract service definition
X.518 Procedures for distributed operation
X.519 Protocol specifications
X.520 Selected attribute types
X.521 Selected object types
XModem. One of the most popular file transfer protocols
(FTPs). Xmodem is fairly effective at detecting errors. It
sends blocks of data together with a checksum and then
waits for acknowledgment of the block's receipt. The
waiting slows down the rate of data transmission
considerably, but it ensures accurate transmission.
Xmodem can be implemented either in software or in
hardware. Many modems, and almost all communications
software packages, support Xmodem. However, it is
373
374
Glossary
Index
Numerics
1583compatibility
194
access-list 135
addport 49
aggregate-address 221
area authentication 194
area default-cost 194
area nssa 195
area nssa default-info-originate 195
area nssa no-redistribute (OSPF) 195
area nssa no-summary (OSPF) 195
area nssa translator-role (OSPF) 195
area nssa translator-stab-intv 196
area range 196
area stub 196
area stub summarylsa 197
area virtual-link 197
area virtual-link authentication 197
area virtual-link dead-interval 198
area virtual-link hello-interval 198
area virtual-link retransmit-interval 199
area virtual-link transmit-delay 199
areaid 6
arp 171
arp cachesize 171
arp dynamicrenew 172
arp purge 172
arp resptime 172
arp retries 172
arp timeout 173
authentication login 75
auto-negotiate 49
auto-negotiate all 50
auto-summary 214
class 155
class-map rename 148
classofservice dot1pmapping
clear arp-cache 173
clear config 66
clear counters 66
clear dot1x statistics 76
clear igmpsnooping 66
clear pass 67
clear port-channel 67
clear radius statistics 76
clear trap log 67
clear vlan 67
105
external-lsdb-limit
H
hostroutesaccept
202
218
ip access-group 136
ip access-group all 136
ip address 193
ip dvmrp 258, 259
ip dvmrp metric 259
ip dvmrp trapflags 259
ip forwarding 177
ip http secure-port 88
ip http secure-protocol 88
ip http secure-server 89
ip http server 89
ip igmp 262
ip igmp last-member-query-count 263
ip igmp last-member-query-interval 263
ip igmp query-interval 263
ip igmp query-max-response-time 264
ip igmp robustness 264
ip igmp startup-query-count 265
ip igmp startup-query-interval 265
ip igmp version 265
ip irdp 183
ip irdp address 184
ip irdp holdtime 184
ip irdp maxadvertinterval 184
ip irdp minadvertinterval 185
ip irdp preference 185
ip mcast boundary 271
ip multicast 251
ip multicast staticroute 252
ip multicast ttl-threshold 252
ip netdirbcast 177
ip ospf 193, 214
ip ospf areaid 202
ip ospf authentication 202
ip ospf cost 203
ip ospf dead-interval 203
ip ospf hello-interval 204
ip ospf priority 204
ip ospf retransmit-interval 204
ip ospf transmit-delay 205
ip pimdm 271
ip pimdm mode 271
ip pimdm query-interval 272
ip pimsm 275
ip pimsm cbsrpreference 273
ip pimsm datathreshrate 275
ip pimsm message-interval 275
376
L
logical unit/slot/port
macaddr 6
mark cos 156
mark ip-dscp 157
mark ip-precedence 157
match any 148
match class-map 148
match cos 149
match destination-address mac 149
match dstip 150
match dstl4port 150
match ip dscp 150
match ip precedence 151
match ip tos 151
match protocol 152
match source-address mac 152
match srcip 152
match srcl4port 153
match vlan 153
maxbandwidth 140
minbandwidth 140
mode dvlan-tunnel 102
monitor session 52
monitor session mode 52
mrinfo 253
mstat 254
mtrace 254
mtu 35
Index
ping 68
police-simple 157
police-single-rate 158
police-two-rate 158
policy-map 159
policy-map rename 160
port 140
port lacpmode 119
port lacpmode all 119
port-channel 120
port-channel adminmode 120
port-channel linktrap 121
port-channel name 121
protocol group 53
protocol vlan group 63
protocol vlan group all 63
remotecon timeout 37
route-aggregation 242
routereflect 242
router-id 185
routerid 6
routing 175
serial baudrate 38
serial timeout 38
service-policy 161
set garp timer join all 107
set garp timer leave 108
set garp timer leave all 108
set garp timer leaveall 109
set garp timer leaveall all 109
set gmrp adminmode 112
set gmrp interfacemode all 113
set gvrp adminmode 49, 110
set gvrp interfacemode 110
set gvrp interfacemode all 111
set igmp 115
set igmp groupmembershipinterval 116
set igmp interfacemode all 116
set igmp maxresponse 116
set igmp mcrtrexpiretime 117
set prompt 39
shape bps-average 160
shape bps-peak 161
show accounting 80
show arp 173
show arp brief 174
show arp switch 25
show authentication 80
show authentication users 81
show bwp-bwallocation detailed 142
show bwp-bwallocation summary 142
show bwp-trafficclass allocatedbw 141
show bwp-trafficclass detailed 141
show bwp-trafficclass summary 141
show class-map 162
show classofservice dot1pmapping 105
show diffserv 163
show diffserv service 165
show diffserv service brief 166
show dot1x 81
show dot1x users 82
show dvlan-tunnel 103
show dvlan-tunnel interface 103
show eventlog 26
show forwardingdb agetime 39
show gmrp configuration 113
show hardware 26
377
shutdown 53, 58
shutdown all 53
unit/slot/port 6
snmp-server 34
snmp-server community 43
snmp-server community ipaddr 43
snmp-server community ipmask 44
snmp-server community mode 44
snmp-server community ro 44
snmp-server community rw 45
snmp-server enable traps 45
snmp-server enable traps bcaststorm 45
snmp-server enable traps multiusers 46
snmp-server enable traps stpmode 46
snmptrap 46
snmptrap ipaddr 47
snmptrap mode 47
spanning-tree 123, 129
spanning-tree bpdumigrationcheck 129
spanning-tree configuration name 124
spanning-tree configuration revision 124
spanning-tree edgeport 124
spanning-tree forceversion 125
spanning-tree forward-time 125
spanning-tree hello-time 125
spanning-tree max-age 126
spanning-tree mst instance 125, 127
spanning-tree mst priority 127
spanning-tree mst vlan 128
spanning-tree port mode 128
spanning-tree port mode all 129
speed 53
speed all 54
splithorizon 213, 218
storm-control broadcast 54
storm-control flowcontro 55
T
telnet
traffic-class 142
trapflags 213, 249
users defaultlogin 83
users login 83
users name 72
users passwd 72
users snmpv3 accessmode 73
users snmpv3 authentication 73
users snmpv3 encryption 73
W
weight
62
143
47
379
380
Index