Allied Telesis AlliedWare Plus 5.2.1 Software Reference Manual

AlliedWare Plus™ Operating System

x900-12XT/S

x900-24XS

x900-24XT x900-24XT-N

Switchblade x908

Software Reference

Software Version 5.2.1

C613-50003-00 Rev E

ii AlliedWare Plus

TM

Operating System Software Reference C613-50003-00 REV E Software Version 5.2.1

Acknowledgements

This product includes software developed by the University of California, Berkeley and its

contributors. Copyright

This product includes software licensed under the GNU General Public License available from:

http://www.gnu.org/licenses/gpl2.html

Source code for all GPL licensed software in this product can be obtained from the

Allied Telesis GPL Code Download Centre at:

http://www.alliedtelesis.com/support/default.aspx

This documentation is subject to change without notice. No part of this publication may be

reproduced, stored in a retrieval system, or transmitted in any form or any means electronic or

mechanical, including photocopying and recording for any purpose other than the purchaser’s

internal use without the written permission of Allied Telesis, Inc.

Allied Telesis and AlliedWare Plus are trademarks or registered trademarks in the United States

and elsewhere of Allied Telesis, Inc. Adobe, Acrobat, and Reader are either registered

trademarks or trademarks of Adobe Systems Incorporated in the United States and/or other

countries. Additional brands, names and products mentioned herein may be trademarks of

their respective companies.

Getting the most from this manual

Although you can view this document using Acrobat version 5, to get the best from

this manual, we recommend using Adobe Acrobat Reader version 8.

You can download Acrobat Reader 8 free from http://www.adobe.com/

Software Version 5.2.1 AlliedWare Plus

TM

Operating System Software Reference C613-50003-00 REV E iii

Table of Contents

Setup Reference 1. Getting Started

Introduction...............................................................................................................................................................1.2

How to get command help .............................................................................................................................1.3

How to work with command modes........................................................................................................1.6

How to see the current configuration.......................................................................................................1.9

Default settings.....................................................................................................................................................1.10

The default configuration script..................................................................................................................1.11

How to change the password.....................................................................................................................1.12

How to set a management IP address ...................................................................................................1.12

How to save and boot from the current configuration................................................................1.13

How to return to the factory defaults....................................................................................................1.15

How to see system information.................................................................................................................1.16

How to set system parameters ..................................................................................................................1.18

How to set the time and date ....................................................................................................................1.20

How to add and remove users ..................................................................................................................1.22

How to undo settings ......................................................................................................................................1.24

How to upgrade the firmware....................................................................................................................1.25

Controlling “show” command output ....................................................................................................1.26

Commands available in each mode .........................................................................................................1.28

2. Command Syntax Conventions in this Software Reference

3. Startup Sequence

AlliedWare Plus™ Start-up..............................................................................................................................3.2

Diagnostic menu.....................................................................................................................................................3.3

Bootloader menu...................................................................................................................................................3.5

Start-up sequence...............................................................................................................................................3.10

4. CLI Navigation Commands

Introduction...............................................................................................................................................................4.2

5. User Access Commands

Introduction...............................................................................................................................................................5.2

6. Creating and Managing Files

Introduction...............................................................................................................................................................6.2

Working with files..................................................................................................................................................6.2

Creating and Using Configuration Files.....................................................................................................6.7

Copying Files To and From Your Device ................................................................................................6.9

7. File Management Commands

Introduction...............................................................................................................................................................7.2

8. System Configuration and Monitoring Commands

Introduction...............................................................................................................................................................8.2

9. Debugging and Logging

Introduction...............................................................................................................................................................9.2

Debugging ..................................................................................................................................................................9.2

Logging .........................................................................................................................................................................9.3

iv AlliedWare Plus

TM

Operating System Software Reference C613-50003-00 REV E Software Version 5.2.1

10. Logging Commands

11. Scripting Commands

12. Interface Commands

Introduction............................................................................................................................................................12.2

13. Interface Testing Commands

Introduction............................................................................................................................................................13.2

Switching

Reference

14. Switching Introduction

Introduction............................................................................................................................................................14.2

Physical Layer Information..............................................................................................................................14.3

The Layer 2 Switching Process....................................................................................................................14.7

Layer 2 Filtering .................................................................................................................................................14.10

Channel Groups (Link Aggregation) .....................................................................................................14.10

Storm Control....................................................................................................................................................14.13

Support for Jumbo Frames .........................................................................................................................14.13

Port Mirroring.....................................................................................................................................................14.14

Port Security........................................................................................................................................................14.14

Virtual Local Area Networks (VLANs) ...............................................................................................14.15

Generic VLAN Registration Protocol (GVRP)................................................................................14.17

VLAN Double Tagging (VLAN Stacking)...........................................................................................14.18

Quality of Service.............................................................................................................................................14.21

IGMP Snooping..................................................................................................................................................14.22

15. Switching Commands

16. VLAN Commands

VLAN Commands..............................................................................................................................................16.2

17. GVRP Commands

GVRP Commands...............................................................................................................................................17.2

18. Spanning Tree Introduction: STP, RSTP, MSTP

Introduction............................................................................................................................................................18.2

Overview of Spanning Trees........................................................................................................................18.2

Spanning Tree Protocol (STP).....................................................................................................................18.5

Configuring STP....................................................................................................................................................18.6

Rapid Spanning Tree Protocol (RSTP) ...................................................................................................18.7

Configuring RSTP ................................................................................................................................................18.8

Multiple Spanning Tree Protocol (MSTP)..........................................................................................18.10

Configuring MSTP ............................................................................................................................................18.18

19. Spanning Tree Commands

Introduction............................................................................................................................................................19.2

20. Link Aggregation Configuration

Introduction............................................................................................................................................................20.2

Configuring LACP ...............................................................................................................................................20.2

21. Link Aggregation Commands

Introduction............................................................................................................................................................21.2

Routing

Reference

22. Internet Protocol (IP) Addressing and Protocols

Introduction............................................................................................................................................................22.2

Address Resolution Protocol (ARP) ........................................................................................................22.3

Domain Name System (DNS) ....................................................................................................................22.6

Internet Control Message Protocol (ICMP) ........................................................................................22.8

ICMP Router Discovery Protocol (IRDP).............................................................................................22.9

Checking IP Connections.............................................................................................................................22.12

23. IP Addressing and Protocol Commands

Introduction............................................................................................................................................................23.2

Software Version 5.2.1 AlliedWare Plus

TM

Operating System Software Reference C613-50003-00 REV E v

24. Routing Protocol Overview

Introduction............................................................................................................................................................24.2

RIP................................................................................................................................................................................24.2

OSPF...........................................................................................................................................................................24.2

PIM-SM......................................................................................................................................................................24.3

VRRP...........................................................................................................................................................................24.3

25. Route Selection

Introduction............................................................................................................................................................25.2

Types of Routes...................................................................................................................................................25.2

RIB and FIB Routing Tables............................................................................................................................25.4

26. Routing Commands

Introduction............................................................................................................................................................26.2

27. RIP Configuration

Introduction............................................................................................................................................................27.2

Enabling RIP ............................................................................................................................................................27.2

Specifying the RIP version...............................................................................................................................27.3

RIPv2 authentication (single key)................................................................................................................27.4

RIPv2 text authentication (multiple keys)..............................................................................................27.5

RIPv2 md5 authentication (multiple keys) ............................................................................................27.8

28. RIP Commands

Introduction............................................................................................................................................................28.2

29. OSPF Configuration

Introduction............................................................................................................................................................29.2

Terminology ...........................................................................................................................................................29.2

Enabling OSPF on an Interface....................................................................................................................29.3

Setting priority.......................................................................................................................................................29.5

Configuring an Area Border Router.........................................................................................................29.7

Redistributing routes into OSPF.................................................................................................................29.8

OSPF Cost ..............................................................................................................................................................29.9

Configuring Virtual Links...............................................................................................................................29.11

OSPF Authentication .....................................................................................................................................29.12

30. OSPF Commands

Introduction ............................................................................................................................................................30.3

31. BGP Commands

Introduction............................................................................................................................................................31.4

32. Route Map Commands

Introduction............................................................................................................................................................32.2

Multicast

Reference

33. IGMP Snooping Configuration

Introduction............................................................................................................................................................33.2

Configuring Switch 1 .........................................................................................................................................33.3

34. IGMP Multicast Commands

Introduction............................................................................................................................................................34.2

35. Common Multicast Commands

Introduction............................................................................................................................................................35.2

36. PIM-SM Configuration

Introduction............................................................................................................................................................36.2

37. PIM-SM Commands

Introduction............................................................................................................................................................37.2

vi AlliedWare Plus

TM

Operating System Software Reference C613-50003-00 REV E Software Version 5.2.1

Traffic and

Security

Reference

38. Access Control List (ACL) Commands

Introduction ............................................................................................................................................................38.2

39. Quality of Service (QoS)

Introduction............................................................................................................................................................39.2

QoS Packet Information..................................................................................................................................39.3

Applying QoS on Your Switch ....................................................................................................................39.7

Premarking your Traffic.................................................................................................................................39.11

Policing (Metering) Your Data..................................................................................................................39.15

Remarking Your Data ....................................................................................................................................39.19

Configuring the Egress Queues................................................................................................................39.20

Egress Queue Shaping...................................................................................................................................39.22

Storm Protection..............................................................................................................................................39.33

QoS and the Switching Fabric...................................................................................................................39.34

40. QoS Commands

Introduction............................................................................................................................................................40.3

41. 802.1x Configuration

Introduction............................................................................................................................................................41.2

The 802.1x Implementation..........................................................................................................................41.2

Configuring 802.1x .............................................................................................................................................41.2

42. 802.1x and RADIUS Commands

Introduction............................................................................................................................................................42.2

43. Secure Shell (SSH) Introduction

Introduction............................................................................................................................................................43.2

Configuring the SSH Server ..........................................................................................................................43.3

Configuring the SSH Client............................................................................................................................43.8

44. SSH Configuration

Configuring the SSH Server .........................................................................................................................44.2

45. Secure Shell Commands

High Availability

Reference

46. VRRP Introduction

Introduction............................................................................................................................................................46.2

Virtual Router Redundancy Protocol.......................................................................................................46.3

VRRP Configuration...........................................................................................................................................46.4

47. VRRP Commands

Introduction............................................................................................................................................................47.2

Typical command sequences........................................................................................................................47.2

VRRP Commands ...............................................................................................................................................47.3

48. EPSR Introduction

Introduction............................................................................................................................................................48.2

Ring Components and Operation.............................................................................................................48.2

Fault Detection and Recovery.....................................................................................................................48.4

Configuration Examples...................................................................................................................................48.6

49. EPSR Commands

Management

Reference

50. NTP Configuration

Introduction............................................................................................................................................................50.2

Overview .................................................................................................................................................................50.2

NTP on the Switch.............................................................................................................................................50.3

Troubleshooting...................................................................................................................................................50.3

Configuration Example.....................................................................................................................................50.4

Software Version 5.2.1 AlliedWare Plus

TM

Operating System Software Reference C613-50003-00 REV E vii

51. NTP Commands

52. Dynamic Host Configuration Protocol (DHCP) Introduction

Introduction............................................................................................................................................................52.2

Configuring the DHCP Server.....................................................................................................................52.3

Configuring the DHCP Relay Agent ........................................................................................................52.5

Configuring the DHCP Client......................................................................................................................52.7

53. Dynamic Host Configuration Protocol (DHCP) Commands

54. SNMP Introduction

Introduction............................................................................................................................................................54.2

Network Management Framework ..........................................................................................................54.2

Structure of Management Information ...................................................................................................54.4

The SNMP Protocol..........................................................................................................................................54.8

SNMPv1 and SNMPv2c on the Switch ...............................................................................................54.13

SNMPv3 ...............................................................................................................................................................54.16

55. SNMP Commands

56. SNMP MIBs

Introduction............................................................................................................................................................56.2

MIB-II MIB ................................................................................................................................................................56.3

TCP MIB ...................................................................................................................................................................56.5

UDP MIB..................................................................................................................................................................56.6

IP Forwarding Table MIB.................................................................................................................................56.7

Ethernet-like Interface Types MIB..............................................................................................................56.8

Medium Attachment Unit (MAU) MIB...................................................................................................56.9

Host Resources MIB.......................................................................................................................................56.11

Bridge MIB ............................................................................................................................................................56.13

RMON MIB .........................................................................................................................................................56.15

57. SMTP Commands

58. RMON Commands

Introduction............................................................................................................................................................58.2

59. Triggers Introduction

Introduction............................................................................................................................................................59.2

Configuring a Trigger.........................................................................................................................................59.2

Troubleshooting Triggers................................................................................................................................59.4

60. Triggers Configuration

Introduction............................................................................................................................................................60.2

Restrict Internet Access...................................................................................................................................60.2

Capturing Unusual CPU and RAM Activity .........................................................................................60.3

Seeing Daily Statistics ........................................................................................................................................60.4

Link Status................................................................................................................................................................60.5

61. Trigger Commands

62. Ping Polling Introduction

Introduction............................................................................................................................................................62.2

How Ping Polling Works.................................................................................................................................62.2

Configuring Ping Polling ...................................................................................................................................62.4

Interaction with Other Protocols...............................................................................................................62.6

63. Ping Polling Commands

Introduction............................................................................................................................................................63.2

Stacking

Reference

64. Stacking Introduction

Introduction............................................................................................................................................................64.4

Stack Formation ...................................................................................................................................................64.7

VCS Fault Tolerance.......................................................................................................................................64.10

65. Stacking Commands

Introduction............................................................................................................................................................65.2

Appendix l

Command List

Setup Reference

This part includes the following chapters:

■ Chapter 1, Getting Started

■ Chapter 2, Command Syntax Conventions in this Software Reference

■ Chapter 3, Startup Sequence

■ Chapter 4, CLI Navigation Commands

■ Chapter 5, User Access Commands

■ Chapter 6, Creating and Managing Files

■ Chapter 7, File Management Commands

■ Chapter 8, System Configuration and Monitoring Commands

■ Chapter 9, Debugging and Logging

■ Chapter 10, Logging Commands

■ Chapter 11, Scripting Commands

■ Chapter 12, Interface Commands

■ Chapter 13, Interface Testing Commands

Software Version 5.2.1 AlliedWare Plus

TM

Operating System Software Reference C613-50003-00 REV E 1.1

Software Version 5.2.1 AlliedWare Plus

TM

Operating System Software Reference C613-50003-00 REV E 1.1

1 Getting Started

Introduction...............................................................................................................................................................1.2

How to log in...........................................................................................................................................................1.2