Yamaha L2 Installation manual

Yamaha L2 Switch
Intelligent L2 PoE SWR2311P-10G
Command Reference
Rev.2.02.09

Contents
Preface: Introduction ............................................................................................12
Chapter 1: How to read the command reference ...............................................13
1.1 Applicable firmware revision .....................................................................................................................13
1.2 How to read the command reference ..........................................................................................................13
1.3 Interface names ...........................................................................................................................................13
1.4 Input syntax for commands starting with the word "no" ............................................................................14
Chapter 2: How to use the commands .................................................................15
2.1 Operation via console .................................................................................................................................15
2.1.1 Access from a console terminal ...................................................................................................15
2.1.2 Access from a TELNET client ....................................................................................................15
2.1.3 Access from an SSH client ..........................................................................................................16
2.1.4 Console terminal/VTY settings ...................................................................................................16
2.2 Operation via configuration (config) files ..................................................................................................17
2.2.1 Access from a TFTP client ..........................................................................................................17
2.2.2 Reading/writing a configuration file ...........................................................................................17
2.3 Login ...........................................................................................................................................................18
2.4 Command input mode ................................................................................................................................18
2.4.1 Command input mode basics .......................................................................................................18
2.4.2 individual configuration mode ....................................................................................................19
2.4.3 Command prompt prefix .............................................................................................................19
2.4.4 Executing commands of a different input mode ..........................................................................19
2.5 Keyboard operations when using the console ............................................................................................20
2.5.1 Basic operations for console input ..............................................................................................20
2.5.2 Command help .............................................................................................................................20
2.5.3 Input command completion and keyword candidate list display ................................................21
2.5.4 Entering command abbreviations ................................................................................................21
2.5.5 Command history ........................................................................................................................21
2.6 Commands that start with the word "show" ...............................................................................................21
2.6.1 Modifiers .....................................................................................................................................21
Chapter 3: Configuration .....................................................................................23
3.1 Manage setting values ................................................................................................................................23
3.2 Default setting values .................................................................................................................................23
Chapter 4: Maintenance and operation functions .............................................26
4.1 Passwords ...................................................................................................................................................26
4.1.1 Set password for unnamed user ...................................................................................................26
4.1.2 Set administrator password ..........................................................................................................26
4.1.3 Encrypt password ........................................................................................................................27
4.1.4 Allow login with special password ..............................................................................................27
4.2 User account maintenance ..........................................................................................................................28
4.2.1 Set user password ........................................................................................................................28
4.2.2 Show login user information .......................................................................................................29
4.2.3 Set banner ....................................................................................................................................30
4.3 Configuration management ........................................................................................................................31
4.3.1 Save running configuration .........................................................................................................31
4.3.2 Save running configuration .........................................................................................................31
4.3.3 Show the running configuration ..................................................................................................32
4.3.4 Show startup configuration ..........................................................................................................32
2 | Command Reference | TOC

4.3.5 Erase startup configuration ..........................................................................................................33
4.3.6 Copy startup configuration ..........................................................................................................34
4.3.7 Set description for startup config ................................................................................................34
4.3.8 Select startup config ....................................................................................................................35
4.4 Manage boot information ...........................................................................................................................35
4.4.1 Show boot information ................................................................................................................35
4.4.2 Clear boot information ................................................................................................................36
4.4.3 Set SD card boot ..........................................................................................................................36
4.4.4 Show the SD card boot setting information ................................................................................36
4.5 Show unit information ................................................................................................................................37
4.5.1 Show inventory information ........................................................................................................37
4.5.2 Show operating information ........................................................................................................37
4.5.3 Show currently-executing processes ...........................................................................................38
4.5.4 Show technical support information ............................................................................................38
4.5.5 Save technical support information .............................................................................................39
4.6 Time management ......................................................................................................................................40
4.6.1 Set clock manually ......................................................................................................................40
4.6.2 Set time zone ...............................................................................................................................40
4.6.3 Show current time ........................................................................................................................41
4.6.4 Set NTP server .............................................................................................................................41
4.6.5 Synchronize time from NTP server (one-shot update) ................................................................42
4.6.6 Synchronize time from NTP server (update interval) .................................................................42
4.6.7 Show NTP server time synchronization settings .........................................................................42
4.7 Terminal settings ........................................................................................................................................43
4.7.1 Move to line mode (console terminal) .........................................................................................43
4.7.2 Set VTY port and move to line mode (VTY port) ......................................................................43
4.7.3 Set terminal login timeout ...........................................................................................................44
4.7.4 Change the number of lines displayed per page for the terminal in use ......................................44
4.7.5 Set the number of lines displayed per page on the terminal ........................................................45
4.8 Management ...............................................................................................................................................45
4.8.1 Set management VLAN ..............................................................................................................45
4.9 SYSLOG .....................................................................................................................................................46
4.9.1 Set log notification destination (SYSLOG server) ......................................................................46
4.9.2 Set log output level (debug) ........................................................................................................46
4.9.3 Set log output level (informational) ............................................................................................47
4.9.4 Set log output level (error) ..........................................................................................................47
4.9.5 Set log console output .................................................................................................................47
4.9.6 Set log output in event units ........................................................................................................48
4.9.7 Back up log ..................................................................................................................................48
4.9.8 Set log backup to SD card ...........................................................................................................49
4.9.9 Clear log ......................................................................................................................................49
4.9.10 Show log ....................................................................................................................................49
4.10 SNMP .......................................................................................................................................................50
4.10.1 Set host that receives SNMP notifications ................................................................................50
4.10.2 Set notification type to transmit ................................................................................................51
4.10.3 Set system contact .....................................................................................................................52
4.10.4 Set system location ....................................................................................................................52
4.10.5 Set SNMP community ...............................................................................................................53
4.10.6 Set SNMP view .........................................................................................................................53
4.10.7 Set SNMP group ........................................................................................................................54
4.10.8 Set SNMP user ..........................................................................................................................55
4.10.9 Show SNMP community information .......................................................................................56
Command Reference | TOC | 3

4.10.10 Show SNMP view settings ......................................................................................................56
4.10.11 Show SNMP group settings .....................................................................................................57
4.10.12 Show SNMP user settings .......................................................................................................57
4.11 RMON ......................................................................................................................................................57
4.11.1 Set RMON function ...................................................................................................................57
4.11.2 Set RMON Ethernet statistical information group ....................................................................58
4.11.3 Set RMON history group ...........................................................................................................59
4.11.4 Set RMON event group .............................................................................................................60
4.11.5 Set RMON alarm group .............................................................................................................60
4.11.6 Show RMON function status .....................................................................................................62
4.11.7 Show RMON Ethernet statistical information group status ......................................................63
4.11.8 Show RMON history group status ............................................................................................64
4.11.9 Show RMON event group status ...............................................................................................64
4.11.10 Show RMON alarm group status ............................................................................................64
4.11.11 Clear counters of the RMON Ethernet statistical information group ......................................65
4.12 Telnet server .............................................................................................................................................65
4.12.1 Start Telnet server and change listening port number ...............................................................65
4.12.2 Show Telnet server settings .......................................................................................................66
4.12.3 Set host that can access the Telnet server ..................................................................................66
4.12.4 Restrict access to the TELNET server according to the IP address of the client ......................67
4.13 Telnet client ..............................................................................................................................................68
4.13.1 Start Telnet client ......................................................................................................................68
4.13.2 Enable Telnet client ...................................................................................................................68
4.14 TFTP server ..............................................................................................................................................68
4.14.1 Start TFTP server and change listening port number ................................................................69
4.14.2 Show TFTP server settings ........................................................................................................69
4.14.3 Set hosts that can access the TFTP server .................................................................................69
4.15 HTTP server .............................................................................................................................................70
4.15.1 Start HTTP server and change listening port number ...............................................................70
4.15.2 Start secure HTTP server and change listening port number ....................................................70
4.15.3 Show HTTP server settings .......................................................................................................71
4.15.4 Set hosts that can access the HTTP server ................................................................................71
4.15.5 Restrict access to the HTTP server according to the IP address of the client ...........................72
4.15.6 Web GUI display language .......................................................................................................73
4.15.7 Set log-in timeout time for HTTP server ...................................................................................73
4.16 HTTP Proxy ..............................................................................................................................................74
4.16.1 Enable HTTP Proxy function ....................................................................................................74
4.16.2 Set HTTP Proxy function timeout .............................................................................................74
4.16.3 Show HTTP Proxy function settings .........................................................................................74
4.17 SSH server ................................................................................................................................................75
4.17.1 Start SSH server and change listening port number ..................................................................75
4.17.2 Show SSH server settings ..........................................................................................................75
4.17.3 Set host that can access the SSH server .....................................................................................76
4.17.4 Set client that can access the SSH server ..................................................................................76
4.17.5 Generate SSH server host key ...................................................................................................77
4.17.6 Clear SSH server host key .........................................................................................................78
4.17.7 Show SSH server public key .....................................................................................................78
4.17.8 Set SSH client alive checking ....................................................................................................79
4.18 SSH client .................................................................................................................................................80
4.18.1 Start SSH client .........................................................................................................................80
4.18.2 Enable SSH client ......................................................................................................................80
4.18.3 Clear SSH host information .......................................................................................................81
4 | Command Reference | TOC

4.19 LLDP ........................................................................................................................................................81
4.19.1 Enable LLDP function ...............................................................................................................81
4.19.2 Set system description ...............................................................................................................82
4.19.3 Set system name ........................................................................................................................82
4.19.4 Create LLDP agent ....................................................................................................................83
4.19.5 Set automatic setting function by LLDP ...................................................................................83
4.19.6 Set LLDP transmission/reception mode ....................................................................................84
4.19.7 Set type of management address ...............................................................................................84
4.19.8 Set basic management TLVs .....................................................................................................85
4.19.9 Set IEEE-802.1 TLV .................................................................................................................85
4.19.10 Set IEEE-802.3 TLV ...............................................................................................................86
4.19.11 Set LLDP-MED TLV ..............................................................................................................86
4.19.12 Set LLDP frame transmission interval ....................................................................................86
4.19.13 Set LLDP frame transmission interval for high speed transmission period ............................87
4.19.14 Set time from LLDP frame transmission stop until re-initialization .......................................87
4.19.15 Set multiplier for calculating time to live (TTL) of device information .................................88
4.19.16 Set number of LLDP frames transmitted during the high speed transmission period .............88
4.19.17 Set maximum number of connected devices manageable by a port ........................................89
4.19.18 Show interface status ...............................................................................................................89
4.19.19 Show information for connected devices of all interfaces ......................................................92
4.19.20 Clear LLDP frame counters .....................................................................................................93
4.20 L2MS (Layer 2 management service) settings .........................................................................................93
4.20.1 Move to L2MS mode .................................................................................................................93
4.20.2 Set L2MS function ....................................................................................................................94
4.20.3 Set role of L2MS function .........................................................................................................94
4.20.4 Set L2MS slave watch interval ..................................................................................................95
4.20.5 Set number of times that is interpreted as L2MS slave down ...................................................95
4.20.6 Set terminal management function ............................................................................................96
4.20.7 Set the device information acquisition time interval .................................................................96
4.20.8 Set L2MS control frame transmit/receive .................................................................................97
4.20.9 Reset slave management ............................................................................................................98
4.20.10 Show L2MS information .........................................................................................................98
4.20.11 Set the device information acquisition time interval for downstream of a wireless AP .........99
4.20.12 Set event monitoring function ...............................................................................................100
4.20.13 Set event information acquisition time interval .....................................................................100
4.20.14 Set whether to use the L2MS slave's zero config function ....................................................101
4.21 Snapshot .................................................................................................................................................101
4.21.1 Set snapshot function ...............................................................................................................101
4.21.2 Set whether to include terminals in the snapshot comparison .................................................102
4.21.3 Create snapshot ........................................................................................................................102
4.21.4 Delete snapshot ........................................................................................................................103
4.22 Firmware update .....................................................................................................................................103
4.22.1 Set firmware update site ..........................................................................................................103
4.22.2 Execute firmware update .........................................................................................................103
4.22.3 Set firmware download timeout duration ................................................................................104
4.22.4 Allow revision-down ...............................................................................................................104
4.22.5 Show firmware update function settings .................................................................................105
4.22.6 Update firmware from SD card ...............................................................................................105
4.22.7 Set firmware update reload time ..............................................................................................106
4.23 General maintenance and operation functions .......................................................................................106
4.23.1 Set host name ...........................................................................................................................106
4.23.2 Reload system ..........................................................................................................................107
Command Reference | TOC | 5

4.23.3 Initialize settings ......................................................................................................................107
4.23.4 Mount SD card ........................................................................................................................107
4.23.5 Unmount SD card ....................................................................................................................107
4.23.6 Set default LED mode .............................................................................................................108
4.23.7 Show LED mode .....................................................................................................................108
4.23.8 Show port error LED status .....................................................................................................109
4.23.9 Backup system information .....................................................................................................109
4.23.10 Restore system information ...................................................................................................110
Chapter 5: Interface control ..............................................................................111
5.1 Interface basic settings .............................................................................................................................111
5.1.1 Set description ...........................................................................................................................111
5.1.2 Shutdown ...................................................................................................................................111
5.1.3 Set speed and duplex mode .......................................................................................................111
5.1.4 Set MRU ....................................................................................................................................112
5.1.5 Set cross/straight automatic detection .......................................................................................113
5.1.6 Set EEE ......................................................................................................................................113
5.1.7 Show EEE capabilities ..............................................................................................................114
5.1.8 Show EEE status ........................................................................................................................114
5.1.9 Set port mirroring ......................................................................................................................115
5.1.10 Show port mirroring status ......................................................................................................116
5.1.11 Show interface status ...............................................................................................................116
5.1.12 Show brief interface status ......................................................................................................119
5.1.13 Show frame counter .................................................................................................................120
5.1.14 Clear frame counters ................................................................................................................122
5.1.15 Show SFP module status .........................................................................................................122
5.1.16 Set SFP module optical reception level monitoring ................................................................123
5.2 Link aggregation .......................................................................................................................................123
5.2.1 Set static logical interface ..........................................................................................................123
5.2.2 Show static logical interface status ............................................................................................124
5.2.3 Set LACP logical interface ........................................................................................................125
5.2.4 Show LACP logical interface status ..........................................................................................126
5.2.5 Set LACP system priority order ................................................................................................127
5.2.6 Show LACP system priority ......................................................................................................128
5.2.7 Set LACP timeout ......................................................................................................................128
5.2.8 Clear LACP frame counters ......................................................................................................129
5.2.9 Show LACP frame counter .......................................................................................................129
5.2.10 Set load balance function rules ................................................................................................130
5.2.11 Show protocol status of LACP logical interface .....................................................................130
5.2.12 Set LACP port priority order ...................................................................................................132
5.3 Port authentication ....................................................................................................................................133
5.3.1 Configuring the IEEE 802.1X authentication function for the entire system ...........................133
5.3.2 Configuring the MAC authentication function for the entire system ........................................133
5.3.3 Configuring the Web authentication function for the entire system .........................................134
5.3.4 Set operation mode for the IEEE 802.1X authentication function ............................................134
5.3.5 Set for forwarding control on an unauthenticated port for IEEE 802.1X authentication ..........135
5.3.6 Set the EAPOL packet transmission count ................................................................................135
5.3.7 Set the MAC authentication function ........................................................................................136
5.3.8 Set MAC address format during MAC authentication ..............................................................136
5.3.9 Set the Web authentication function ..........................................................................................137
5.3.10 Set host mode ..........................................................................................................................137
5.3.11 Set re-authentication ................................................................................................................138
5.3.12 Set dynamic VLAN .................................................................................................................139
6 | Command Reference | TOC

5.3.13 Set the guest VLAN .................................................................................................................139
5.3.14 Suppression period settings following failed authentication ...................................................140
5.3.15 Set reauthentication interval ....................................................................................................140
5.3.16 Set the reply wait time for the RADIUS server overall ...........................................................141
5.3.17 Set supplicant reply wait time .................................................................................................141
5.3.18 Set RADIUS server host ..........................................................................................................142
5.3.19 Set the reply wait time for each RADIUS server ....................................................................142
5.3.20 Set number of times to resend requests to RADIUS server ....................................................143
5.3.21 Set RADIUS server shared password ......................................................................................143
5.3.22 Set time of RADIUS server usage prevention .........................................................................144
5.3.23 Show port authentication information .....................................................................................144
5.3.24 Show supplicant information ...................................................................................................145
5.3.25 Show statistical information ....................................................................................................146
5.3.26 Clear statistical information ....................................................................................................146
5.3.27 Show RADIUS server setting information ..............................................................................147
5.3.28 Settings for redirect destination URL following successful Web authentication ....................147
5.3.29 Clear the authentication state ...................................................................................................148
5.3.30 Setting the time for clearing the authentication state (system) ................................................148
5.3.31 Setting the time for clearing the authentication state (interface) .............................................148
5.3.32 Locate the file for customizing the Web authentication screen ...............................................149
5.3.33 Delete the file for customizing the Web authentication screen ...............................................150
5.4 Port security ..............................................................................................................................................150
5.4.1 Set port security function ...........................................................................................................150
5.4.2 Register permitted MAC addresses ...........................................................................................151
5.4.3 Set operations used for security violations ................................................................................151
5.4.4 Show port security information .................................................................................................151
5.5 Error detection function ............................................................................................................................152
5.5.1 Set automatic recovery from errdisable state ............................................................................152
5.5.2 Show error detection function information ...............................................................................153
5.6 PoE ...........................................................................................................................................................153
5.6.1 Set PoE power supply function (system) ...................................................................................153
5.6.2 Set PoE power supply function (interface) ................................................................................154
5.6.3 Set description of PoE port ........................................................................................................154
5.6.4 Set PoE port power supply priority ...........................................................................................155
5.6.5 Show PoE power supply information ........................................................................................155
Chapter 6: Layer 2 functions .............................................................................157
6.1 FDB (Forwarding Data Base) ...................................................................................................................157
6.1.1 Set MAC address acquisition function ......................................................................................157
6.1.2 Set dynamic entry ageing time ..................................................................................................157
6.1.3 Clear dynamic entry ..................................................................................................................158
6.1.4 Set static entry ...........................................................................................................................158
6.1.5 Show MAC address table ..........................................................................................................159
6.2 VLAN .......................................................................................................................................................160
6.2.1 Move to VLAN mode ................................................................................................................160
6.2.2 Set VLAN interface ...................................................................................................................160
6.2.3 Set private VLAN ......................................................................................................................161
6.2.4 Set secondary VLAN for primary VLAN .................................................................................161
6.2.5 Set access port (untagged port) ..................................................................................................162
6.2.6 Set associated VLAN of an access port (untagged port) ...........................................................163
6.2.7 Set trunk port (tagged port) .......................................................................................................163
6.2.8 Set associated VLAN for trunk port (tagged port) ....................................................................164
6.2.9 Set native VLAN for trunk port (tagged port) ...........................................................................165
Command Reference | TOC | 7

6.2.10 Set private VLAN port type ....................................................................................................166
6.2.11 Set private VLAN host port .....................................................................................................166
6.2.12 Set promiscuous port for private VLAN .................................................................................167
6.2.13 Set voice VLAN ......................................................................................................................168
6.2.14 Set CoS value for voice VLAN ...............................................................................................169
6.2.15 Set DSCP value for voice VLAN ............................................................................................169
6.2.16 Show VLAN information ........................................................................................................170
6.2.17 Show private VLAN information ............................................................................................170
6.3 STP (Spanning Tree Protocol) ..................................................................................................................171
6.3.1 Set spanning tree for the system ................................................................................................171
6.3.2 Set forward delay time ...............................................................................................................171
6.3.3 Set maximum aging time ...........................................................................................................172
6.3.4 Set bridge priority ......................................................................................................................172
6.3.5 Set spanning tree for an interface ..............................................................................................173
6.3.6 Set spanning tree link type ........................................................................................................173
6.3.7 Set interface BPDU filtering .....................................................................................................174
6.3.8 Set interface BPDU guard .........................................................................................................174
6.3.9 Set interface path cost ................................................................................................................175
6.3.10 Set interface priority ................................................................................................................175
6.3.11 Set edge port for interface .......................................................................................................176
6.3.12 Show spanning tree status .......................................................................................................176
6.3.13 Show spanning tree BPDU statistics .......................................................................................179
6.3.14 Clear protocol compatibility mode ..........................................................................................180
6.3.15 Move to MST mode .................................................................................................................180
6.3.16 Generate MST instance ...........................................................................................................181
6.3.17 Set VLAN for MST instance ...................................................................................................181
6.3.18 Set priority of MST instance ...................................................................................................182
6.3.19 Set MST region name ..............................................................................................................182
6.3.20 Set revision number of MST region ........................................................................................182
6.3.21 Set MST instance for interface ................................................................................................183
6.3.22 Set interface priority for MST instance ...................................................................................183
6.3.23 Set interface path cost for MST instance .................................................................................184
6.3.24 Show MST region information ................................................................................................185
6.3.25 Show MSTP information .........................................................................................................185
6.3.26 Show MST instance information .............................................................................................186
6.4 Loop detection ..........................................................................................................................................187
6.4.1 Set loop detection function (system) .........................................................................................187
6.4.2 Set loop detection function (interface) ......................................................................................188
6.4.3 Set port blocking for loop detection ..........................................................................................188
6.4.4 Reset loop detection status ........................................................................................................189
6.4.5 Show loop detection function status ..........................................................................................189
Chapter 7: Layer 3 functions .............................................................................191
7.1 IPv4 address management ........................................................................................................................191
7.1.1 Set IPv4 address ........................................................................................................................191
7.1.2 Show IPv4 address ....................................................................................................................191
7.1.3 Automatically set IPv4 address by DHCP client .......................................................................192
7.1.4 Show DHCP client status ..........................................................................................................193
7.1.5 Set auto IP function ...................................................................................................................193
7.2 IPv4 route control .....................................................................................................................................194
7.2.1 Set static IPv4 route ...................................................................................................................194
7.2.2 Show IPv4 Forwarding Information Base .................................................................................195
7.2.3 Show IPv4 Routing Information Base .......................................................................................195
8 | Command Reference | TOC

7.2.4 Show summary of the route entries registered in the IPv4 Routing Information Base .............196
7.3 ARP ..........................................................................................................................................................196
7.3.1 Show ARP table ........................................................................................................................196
7.3.2 Clear ARP table .........................................................................................................................196
7.3.3 Set static ARP entry ...................................................................................................................197
7.3.4 Set ARP timeout ........................................................................................................................197
7.4 IPv4 ping ..................................................................................................................................................197
7.4.1 IPv4 ping ...................................................................................................................................197
7.4.2 Check IPv4 route .......................................................................................................................198
7.5 IPv6 address management ........................................................................................................................199
7.5.1 Set IPv6 .....................................................................................................................................199
7.5.2 Set IPv6 address ........................................................................................................................199
7.5.3 Set RA for IPv6 address ............................................................................................................200
7.5.4 Show IPv6 address ....................................................................................................................200
7.6 IPv6 route control .....................................................................................................................................201
7.6.1 Set IPv6 static route ...................................................................................................................201
7.6.2 Show IPv6 Forwarding Information Base .................................................................................201
7.6.3 Show IPv6 Routing Information Base .......................................................................................202
7.6.4 Show summary of the route entries registered in the IPv6 Routing Information Base .............202
7.7 Neighbor cache .........................................................................................................................................203
7.7.1 Set static neighbor cache entry ..................................................................................................203
7.7.2 Show neighbor cache table ........................................................................................................203
7.7.3 Clear neighbor cache table ........................................................................................................204
7.8 IPv6 ping ..................................................................................................................................................204
7.8.1 IPv6 ping ...................................................................................................................................204
7.8.2 Check IPv6 route .......................................................................................................................205
7.9 Set DNS lookup function ..........................................................................................................................205
7.10 Set DNS server list .................................................................................................................................206
7.11 Set default domain name ........................................................................................................................206
7.12 Set search domain list .............................................................................................................................207
7.13 Show DNS client information ................................................................................................................207
Chapter 8: IP multicast control .........................................................................209
8.1 IP multicast basic settings ........................................................................................................................209
8.1.1 Set processing method for unknown multicast frames ..............................................................209
8.2 IGMP snooping ........................................................................................................................................209
8.2.1 Set enable/disable IGMP snooping ...........................................................................................209
8.2.2 Set IGMP snooping fast-leave ...................................................................................................210
8.2.3 Set multicast router connection destination ...............................................................................210
8.2.4 Set query transmission function ................................................................................................211
8.2.5 Set IGMP query transmission interval ......................................................................................211
8.2.6 Set TTL value verification function for IGMP packets .............................................................212
8.2.7 Set IGMP version ......................................................................................................................212
8.2.8 Show multicast router connection port information ..................................................................213
8.2.9 Show IGMP group membership information ............................................................................213
8.2.10 Show an interface's IGMP-related information .......................................................................214
8.2.11 Clear IGMP group membership entries ...................................................................................215
Chapter 9: Traffic control ..................................................................................216
9.1 ACL ..........................................................................................................................................................216
9.1.1 Generate IPv4 access list ...........................................................................................................216
9.1.2 Add comment to IPv4 access list ...............................................................................................218
9.1.3 Apply IPv4 access list ...............................................................................................................218
Command Reference | TOC | 9

9.1.4 Generate IPv6 access list ...........................................................................................................219
9.1.5 Add comment to IPv6 access list ...............................................................................................220
9.1.6 Apply IPv6 access list ...............................................................................................................220
9.1.7 Generate MAC access list .........................................................................................................221
9.1.8 Add comment to MAC access list .............................................................................................222
9.1.9 Apply MAC access list ..............................................................................................................223
9.1.10 Show generated access list ......................................................................................................223
9.1.11 Clear counters ..........................................................................................................................224
9.1.12 Show access list applied to interface .......................................................................................224
9.1.13 Set VLAN access map and move to VLAN access map mode ...............................................224
9.1.14 Set access list for VLAN access map ......................................................................................225
9.1.15 Set VLAN access map filter ....................................................................................................225
9.1.16 Show VLAN access map .........................................................................................................226
9.1.17 Show VLAN access map filter ................................................................................................226
9.2 QoS (Quality of Service) ..........................................................................................................................226
9.2.1 Enable/disable QoS ...................................................................................................................227
9.2.2 Set default CoS ..........................................................................................................................227
9.2.3 Set trust mode ............................................................................................................................228
9.2.4 Show status of QoS function setting .........................................................................................229
9.2.5 Show QoS information for LAN/SFP port ................................................................................229
9.2.6 Show egress queue usage ratio ..................................................................................................230
9.2.7 Set CoS - egress queue ID conversion table ..............................................................................231
9.2.8 Set DSCP - egress queue ID conversion tabl ............................................................................232
9.2.9 Set port priority order ................................................................................................................232
9.2.10 Specify egress queue of frames transmitted from the switch itself .........................................233
9.2.11 Generate class map (traffic category conditions) ....................................................................233
9.2.12 Associate class map .................................................................................................................234
9.2.13 Set traffic classification conditions (access-list) .....................................................................235
9.2.14 Set traffic classification conditions (CoS) ...............................................................................235
9.2.15 Set traffic classification conditions (TOS precedence) ...........................................................236
9.2.16 Set traffic classification conditions (DSCP) ............................................................................236
9.2.17 Set traffic classification conditions (Ethernet Type) ...............................................................237
9.2.18 13.2.22 Set traffic classification conditions (VLAN ID) ........................................................237
9.2.19 Set traffic classification conditions (VLAN ID range) ............................................................237
9.2.20 Show class map information ...................................................................................................238
9.2.21 Generate policy map for received frames ................................................................................239
9.2.22 Apply policy map for received frames ....................................................................................239
9.2.23 Set pre-marking (CoS) .............................................................................................................240
9.2.24 Set pre-marking (TOS precedence) .........................................................................................241
9.2.25 Set pre-marking (DSCP) ..........................................................................................................241
9.2.26 Set individual policers (single rate) .........................................................................................242
9.2.27 Set individual policers (twin rate) ...........................................................................................243
9.2.28 Set remarking of individual policers .......................................................................................245
9.2.29 Generate aggregate policer ......................................................................................................246
9.2.30 Set aggregate policer (single rate) ...........................................................................................246
9.2.31 Set aggregate policer (twin rate) ..............................................................................................247
9.2.32 Set remarking of aggregate policers ........................................................................................248
9.2.33 Show aggregate policers ..........................................................................................................249
9.2.34 Apply aggregate policer ..........................................................................................................250
9.2.35 Show metering counters ..........................................................................................................251
9.2.36 Clear metering counters ...........................................................................................................251
9.2.37 Set egress queue (CoS-Queue) ................................................................................................252
10 | Command Reference | TOC

9.2.38 Set egress queue (DSCP-Queue) .............................................................................................252
9.2.39 Show policy map information .................................................................................................253
9.2.40 Show map status ......................................................................................................................254
9.2.41 Set egress queue scheduling ....................................................................................................256
9.2.42 Set traffic shaping (individual port) ........................................................................................256
9.2.43 Set traffic-shaping (queue units) .............................................................................................257
9.3 Flow control ..............................................................................................................................................258
9.3.1 Set flow control (IEEE 802.3x PAUSE send/receive) (system) ................................................258
9.3.2 Set flow control (IEEE 802.3x PAUSE send/receive) (interface) .............................................258
9.3.3 Show flow control operating status ...........................................................................................259
9.4 Storm control ............................................................................................................................................260
9.4.1 Set storm control ........................................................................................................................260
9.4.2 Show storm control reception upper limit .................................................................................260
Command Reference | TOC | 11

Preface
Introduction
• Unauthorized reproduction of this document in part or in whole is prohibited.
•The contents of this document are subject to change without notice.
• Yamaha disclaims all responsibility for any damages caused by loss of data or other problems resulting from the use of this
product.
The warranty is limited to this physical product itself. Please be aware of these points.
• The information contained in this document has been carefully checked and is believed to be reliable. However, if you find
some of the contents to be missing or have questions regarding the contents, please contact us.
• Ethernet is a registered trademark of Fuji Xerox Corporation.
• Microsoft and Windows are registered trademarks of Microsoft Corporation USA in the United States and in other
countries.
12 | Command Reference | Introduction

Chapter 1
How to read the command reference
1.1 Applicable firmware revision
This command reference applies to firmware Yamaha Intelligent L2 Switch SWR2311P of Rev.2.02.09.
For the latest firmware released after printing of this command reference, manuals, and items that differ, access the following
URL and see the information in the WWW server.
http://www.rtpro.yamaha.co.jp
1.2 How to read the command reference
This command reference describes the commands that you enter from the console of the Yamaha Intelligent L2 Switch
SWR2311P.
Each command is described by a combination of the following items.
[Syntax]
Explains the command input syntax. Key input can use either
uppercase or lowercase characters.
Command names are shown in bold (Bold face).
The parameter portion is shown in italic (Italic face).
Keywords are shown in normal characters.
Parameters that can be omitted are enclosed in square
brackets ( [ ] ).
[Keywords] Explains the type and significance of keywords that can be
specified for the command.
[Parameters] Explains the type and significance of parameters that can be
specified for the command.
[Default setting] Indicates the factory-set state of the command.
[Input mode] Indicates the modes in which the command can be executed.
[Description] Explains the command.
[Notes] Explains points that you should be aware of when using the
command.
[Examples] Provides specific examples of the command.
1.3 Interface names
In the command input syntax, interface names are used to specify each interface of the switch.
The following interface names are handled by the SWR2311P.
Interface type Prefix Description Examples
LAN/SFP port port
Used to specify a physical
port. Specify "stack ID" + "."
+ "port number" after the port
number. * The SWR2311P is
fixed as stack ID=1.
When specifying LAN port
#1 on LAN port stack #1 :
port1.1
VLAN interface vlan
Used to specify a VLAN.
Specify vlan followed by the
"VLAN ID".
To specify VLAN #1:vlan1
static logical interface sa Used to specify link
aggregation that combines
multiple LAN/SFP port.
Specify sa or po followed by
"logical interface ID".
o specify static logical
interface #1: sa1
LACP logical interface po To specify LACP logical
interface #2: po2
Command Reference | How to read the command reference | 13

1.4 Input syntax for commands starting with the word "no"
Many commands also have a form in which the command input syntax starts with the word no. If you use a syntax that with
begins with the word no, the settings of that command are deleted and returned to the default value, unless explained otherwise.
14 | Command Reference | How to read the command reference

Chapter 2
How to use the commands
The SWR2311P lets you perform command operations in the following two ways.
Type of operation Method of operation Description
Operation via console
• Access from a console terminal
•Access from a TELNET client
• Access from a SSH client
Issue commands one by one to
interactively make settings or perform
operations.
Operation via a config file
• File transfer via TFTP
• File transfer via GUI operation
• File copy via SD card
A file containing a set of necessary
commands (called a configuration or
"config" file) is used to specify multiple
settings, or to obtain multiple settings from
the SWR2311P, in a single operation.
This chapter explains how to use each method.
2.1 Operation via console
2.1.1 Access from a console terminal
Use a USB cable or RJ-45/DB-9 console cable (YRC-RJ45) when making settings from a terminal that is connected to the
CONSOLE port of SWR2311P. For the USB cable connected to the mini-USB CONSOLE port, use a USB cable that supports
data communication between a USB Type A connector and a mini-USB Type B (5-pin) connector. Cables for recharging only
cannot be used. If you are using a computer as a console terminal (serial terminal), you'll need a terminal program to control the
computer's serial (COM) port. Set the communication settings of the console terminal as follows.
Setting item Value
Baud rate 9600bps
Data 8-bit
Parity none
Stop bit 1-bit
Flow control Xon/Xoff
For settings related to the console terminal, use the line con command to move to line mode.
2.1.2 Access from a TELNET client
You can use a TELNET client on a computer to connect to the TELNET server of the SWR2311P and control it. In order to
make settings using TELNET, you must first set up a connection environment (IP network) and then make TELNET server
settings.
The IP address settings of the SWR2311P are as follows.
•The default IPv4 address setting is ip address dhcp for VLAN #1.
• To change the IPv4 address, use the ip address command.
The TELNET server settings of the SWR2311P are as follows.
• With the default settings of the TELNET server function, it runs on the default port (TCP port 23) and allows access only
from VLAN #1 (vlan0.1).
• To change the reception port number, use the telnet-server command.
• Access to the TELNET server can be controlled in VLAN units, and can be specified by the telnet-server interface
command.
A virtual communication port by which a TELNET client connects is called a "virtual terminal (VTY: Virtual TYpewriter)
port." The maximum number of simultaneous TELNET client connections depends on the number of VTY ports of the
SWR2311P. The VTY ports of the SWR2311P are as follows.
• With the default VTY port settings, eight VTY ports (ID: 0--7) can be used.
• To check the number of VTY ports, use the show running-config | include line vty command.
• To change the number of VTY ports, use the line vty command. (maximum 8 (ID: 0--7))
Command Reference | How to use the commands | 15

To make VTY port settings, use the line vty command to specify the target VTY port, and then move to line mode. ID
management for virtual terminal ports is handled within the SWR2311P, but since login session and ID assignments depend on
the connection timing, you should normally make the same settings for all VTY ports.
2.1.3 Access from an SSH client
You can use an SSH client on a computer to connect to the SSH server of the SWR2311P and control it. In order to make
settings using SSH, you must first set up a connection environment (IP network) and then make SSH server settings.
The IP address settings of the SWR2311P are as follows.
•The default IPv4 address setting is ip address dhcp for VLAN #1.
• To change the IPv4 address, use the ip address command.
The following settings on the SWR2311P must be made beforehand when accessing from an SSH client.
• Generate a host key on the SSH server using the ssh-server host key generate command.
• Enable the SSH server functions using the ssh-server command.
• Register the user name and password using the username command.
The SSH server settings of the SWR2311P are as follows.
• Access to an SSH server can be controlled for each VLAN, and is set using the ssh-server interface command.
• Note that the following functions are not supported.
• SSH protocol version 1
• User authentication aside from password authentication (host response authentication, public key authentication, challenge-
response authentication, GSSAPI authentication)
• Port forwarding (X11/TCP forwarding)
• Gateway Ports (Port relay)
• Permitting blank passwords
A virtual communication port by which an SSH client connects is called a "virtual terminal (VTY: Virtual TYpewriter) port."
The maximum number of simultaneous SSH client connections depends on the number of VTY ports of the SWR2311P. The
VTY ports of the SWR2311P are as follows.
• With the default VTY port settings, eight VTY ports (ID: 0--7) can be used.
• To check the number of VTY ports, use the show running-config | include line vty command.
• To change the number of VTY ports, use the line vty command. (maximum 8 (ID: 0--7))
To make VTY port settings, use the line vty command to specify the target VTY port, and then move to line mode. ID
management for virtual terminal ports is handled within the SWR2311P, but since login session and ID assignments depend on
the connection timing, you should normally make the same settings for all VTY ports.
2.1.4 Console terminal/VTY settings
The SWR2311P lets you make the following settings for console terminals and VTY.
1. Timeout duration interpreted as no operation
2. Number of lines shown in one page of the terminal screen
Setting item Content of setting
Timeout duration interpreted as no operation
Specifies the time after which the login session is forcibly
ended when there has been no key input from the terminal.
With the default setting, the session is forcibly disconnected
after ten minutes.
To make this setting, use the exec-timeout command of the
line mode; this takes effect from the next session.
Number of lines shown in one page of the terminal screen
Specifies the number of lines shown on one page of the
terminal screen.
This can be set as 0--512 lines/page, and the default setting is
24 lines/page.
When displaying in this state, 23 lines are displayed, then "---
More---" is displayed and the system waits for key input.
There are two types of this setting, and they are applied to the
system starting with the upper type.
1) unprivileged EXEC mode terminal length command
2) global configuration mode service terminal-length
16 | Command Reference | How to use the commands

Setting item Content of setting
command
Setting 1) is a function that temporarily applies to the user
who is using the terminal, and is applied as soon as the
command is executed.
Setting 2) applies starting with the next session.
2.2 Operation via configuration (config) files
A file containing a set of needed commands is called a configuration (config) file.
The settings that have been made on the SWR2311P can be read as a configuration file by a host on the LAN via TFTP. A
configuration file on the host can also be loaded into the SWR2311P to specify its settings.
A configuration file contains all the settings for the entire unit; it is not possible to partially read or write only the settings for a
specific area. The configuration file is a text file consisting of ASCII + line-return (CRLF or LF).
The commands and parameters in a configuration file must be in the correct syntax. If the syntax or content are incorrect, that
content is ignored and is not applied to operation.
2.2.1 Access from a TFTP client
In order to transfer a configuration file via TFTP, you must first set up a connection environment (IP network) and then make
TFTP server settings.
The IP address settings of the SWR2311P are as follows.
•The default IPv4 address setting is ip address dhcp for VLAN #1.
• To change the IPv4 address, use the ip address command.
The TFTP server settings of the SWR2311P are as follows.
• With the default settings of the TFTP server function, it is running on the default port (UDP port 69) and does not allow
access from anywhere.
• The reception port number cannot be changed.
• Access to the TFTP server can be controlled in VLAN units, and can be specified by the tftp-server interface command.
Specify the VLAN ID for which access is allowed.
2.2.2 Reading/writing a configuration file
Reading/writing a configuration file is performed by executing a TFTP command from the host on the LAN. The following
configuration files are read or written.
•Config file
Applicable config file Description Remarks
running-config Setting values for current operation
startup-config #0, #1, #2, #3, #4 Saved setting values #0, #1, #2, #3, #4 Setting values of startup-config select
command
The command syntax used depends on the OS of that host (TFTP client). Keep the following points in mind when executing
commands.
•IP address of theSWR2311P
• Use "binary mode" as the transmission mode.
• Specify the following as the remote path of the configuration file read (GET) or write (PUT) destination.
Remote path Applicable config file Load (GET) Save (PUT) Renarks
config running-config ✓ ✓
config0 startup-config #0 ✓ ✓
config1 startup-config #1 ✓ ✓
config2 startup-config #2 ✓ ✓
config3 startup-config #3 ✓ ✓
config4 startup-config #4 ✓ ✓
• If an administrator password is set on the SWR2311P, you must specify the administrator password after the remote path in
the format "/PASSWORD".
Command Reference | How to use the commands | 17

• If you PUT (write) with "config" specified as the remote path, the changes are added or overwritten to the current operating
settings. Settings that you do not add or change will remain as the current operating settings. Since the setting values are not
saved, you must use the write command etc. if you want to save them.
•The encrypted password (password 8 or enable password 8 command format) is not applied to the settings even if it is
PUT to running-config via TFTP. And, users are not actually registered when making settings for users that include
encrypted passwords (username command).
2.3 Login
When the SWR2311P has finished starting up, a login screen is displayed.
If a user is configured, enter the user name and password. If a user is not configured, omit the user name by pressing the Enter
key, and enter the login password instead to log in as an unknown user.
When authentication is successful, the command prompt appears. Since no user password is specified with the default settings,
you will be able to log in without a password.
•Login screen
Username:
Password:
•Console screen following login
SWR2311P Rev.2.02.06 (Tue Mar 13 08:41:39 2018)
Copyright (c) 2018 Yamaha Corporation. All Rights Reserved.
SWR2311P>
2.4 Command input mode
2.4.1 Command input mode basics
In order to change the settings of the SWR2311P or to reference the status, you must move to the appropriate command input
mode and then execute the command. Command input mode is divided into hierarchical levels as shown below, and the
commands that can be entered in each mode are different. By noting the prompt, the user can see which mode they are currently
in.
18 | Command Reference | How to use the commands

The basic commands related to moving between command input modes are described below. For commands that move from
global configuration mode mode to individual configuration mode, refer to "individual configuration mode."
•exit command
•logout command
•enable command
•disable command
•configure terminal command
•end command
2.4.2 individual configuration mode
individual configuration mode is the overall name for the mode in which you can make detailed settings for specific items such
as LAN/SFP port, VLAN interface, and QoS. To enter individual configuration mode, issue the command for transitioning to
the respective mode from global configuration mode.
On SWR2311P, individual configuration mode contains the following modes. Some of the modes within individual
configuration mode have a hierarchy. For example, policy map mode → policy map class mode.
individual configuration mode Transition command Prompt
interface mode interface command SWR2311P(config-if)#
line mode line con command
line vty command
SWR2311P(config-line)#
VLAN mode vlan database command SWR2311P(config-vlan)#
VLAN access map mode vlan access-map command SWR2311P(config-vlan-access-map)#
MST mode spanning-tree mst configuration
command SWR2311P(config-mst)#
class map mode class-map command SWR2311P(config-cmap)#
policy map mode policy-map command SWR2311P(config-pmap)#
policy map class mode class command SWR2311P(config-pmap-c)#
L2MS mode l2ms configuration command SWR2311P(config-l2ms)#
LLDP agent mode lldp-agent command SWR2311P(lldp-agent)#
2.4.3 Command prompt prefix
he command prompt prefix indicates the host name. In the default state, the host name is the model name "SWR2311P". This
indication can be changed by using the hostname command to specify the host name. In cases where multiple SWR2311P units
are used, management will be easier if separate names are assigned to each switch.
Changing the host name
SWR2311P(config)# hostname Switch-012
Switch-012(config)#
2.4.4 Executing commands of a different input mode
Because the commands that can be used on the SWR2311P differ depending on the mode, you must transition to the mode in
which a command can be executed before you execute that command. The do command is provided as a way to avoid this
requirement.
By using the do command you can execute priviledged EXEC mode commands from any configuration mode. This allows you
to reference the current configuration or save settings from any configuration mode without having to transition to priviledged
EXEC mode.
However, since the completion function cannot be used with do, you must enter the command that follows either in its full
spelling or in its abbreviated form.
•Entry in full spelling
SWR2311P(config)#do show running-config
•Entry in abbreviated form
SWR2311P(config)#do sh ru
Command Reference | How to use the commands | 19

2.5 Keyboard operations when using the console
2.5.1 Basic operations for console input
The SWR2311P allows the following operations in the command line.
•Moving the cursor
Keyboard operation Description and notes
→ Move right one character
← Move left one character
Press Esc, then F Move right one word (move to the character following the
end of the word at the cursor location)
Press Esc, then B Move left one word (move to the first character of the word
at the cursor location)
Ctrl + A Move to the beginning of the line
Ctrl + E Move to the end of the line
• Deleting an input character
Keyboard operation Description and notes
Backspace
Delete the character at the left of the cursor
Ctrl + H
Ctrl + D
Delete the character at the cursor.
If this operation is performed when the command line is
empty, the result is the same as the exit command.
Press Esc, then D Delete from the cursor position until immediately before the
first space
Ctrl + K Delete from the cursor position until the end of the line
Ctrl + U Delete all characters that are being entered
• Other
Keyboard operation Description and notes
Ctrl + T
Exchange the character at the cursor position with the
preceding character.
If the cursor is at the end of the line, exchange the preceding
character with the character that precedes it.
Ctrl + C
In unprivileged EXEC mode and priviledged EXEC mode,
discard the command being entered and move to the next
line.
In individual configuration mode, discard the command line
being entered and move to priviledged EXEC mode.
Command processing that is currently being executed will
be stopped. (ex: ping command)
Ctrl + Z
Move from individual configuration mode to priviledged
EXEC mode.
This is the same operation as the end command.
2.5.2 Command help
By entering '?' in the command line you can search for the available commands or parameters.
SWR2311P#show vlan ?
<1-4094> VLAN id
access-map Show VLAN Access Map
brief VLAN information for all bridges (static and dynamic)
filter Show VLAN Access Map Filter
private-vlan private-vlan information
20 | Command Reference | How to use the commands