Management Software AT-S63 ◆ Stack Command Line Interface User’s Guide AT-9400 Basic Layer 3 Gigabit Ethernet Switches Version 3.0.0 613-000777 Rev.
Copyright © 2007 Allied Telesis, Inc. All rights reserved. No part of this publication may be reproduced without prior written permission from Allied Telesis, Inc. Allied Telesis and the Allied Telesis logo are trademarks of Allied Telesis, Incorporated. Microsoft and Internet Explorer are registered trademarks of Microsoft Corporation. Netscape Navigator is a registered trademark of Netscape Communications Corporation.
Contents Preface ............................................................................................................................................................ 11 How This Guide is Organized........................................................................................................................... 13 Product Documentation .................................................................................................................................... 14 Where to Go First ....
Contents Chapter 2: Starting a Command Line Management Session ..................................................................... 49 Starting a Local Management Session ............................................................................................................. 50 Remote Telnet Management ............................................................................................................................ 52 Planning for Remote Management...........................................
AT-S63 Stack Command Line Interface User’s Guide Chapter 7: Port Statistics Commands ....................................................................................................... 123 RESET SWITCH PORT COUNTER............................................................................................................... 124 SHOW SWITCH MODULE COUNTER .......................................................................................................... 125 SHOW SWITCH PORT COUNTER ..............
Contents Chapter 13: Event Log and Syslog Client Commands .............................................................................197 ADD LOG OUTPUT ........................................................................................................................................198 CREATE LOG OUTPUT .................................................................................................................................200 DESTROY LOG OUTPUT ...............................................
AT-S63 Stack Command Line Interface User’s Guide Section V: Internet Protocol Routing .................................................................... 275 Chapter 18: Routing Interface Commands ................................................................................................ 277 ADD IP ARP ................................................................................................................................................... 278 ADD IP INTERFACE ................................
Contents 8
Tables Table 1. Maximum Number of Switches in a Stack .............................................................................................................28 Table 2. Module Variable .....................................................................................................................................................92 Table 3. File Extensions and File Types ............................................................................................................................
Tables 10
Preface This guide explains how to configure the operating parameters of the AT-9400 Basic Layer 3 Gigabit Ethernet Switches when the units are installed as a stack with the AT-StackXG Stacking Module. Note A stack does not support all the features of the AT-S63 Management Software. For information, refer to “Supported Features” on page 26. Note A stack must be managed from the command line interface. The menus interface and the web browser interface are not supported in a stack.
Preface Caution The software described in this documentation contains certain cryptographic functionality and its export is restricted by U.S. law. As of this writing, it has been submitted for review as a “retail encryption item” in accordance with the Export Administration Regulations, 15 C.F.R. Part 730-772, promulgated by the U.S. Department of Commerce, and conditionally may be exported in accordance with the pertinent terms of License Exception ENC (described in 15 C.F.R. Part 740.17).
AT-S63 Stack Command Line Interface User’s Guide How This Guide is Organized This guide has the following sections and chapters: Section I: Basic Operations Chapter 1, “Overview” on page 23 Chapter 2, “Starting a Command Line Management Session” on page 49 Chapter 3, “Basic Command Line Commands” on page 59 Chapter 4, “Stacking Commands” on page 67 Chapter 5, “Basic Stack Commands” on page 73 Chapter 6, “Port Parameter Commands” on page 101 Chapter 7, “Port Statistics Commands” on page 123 Chapter 8, “M
Preface Product Documentation For overview information on the features of the AT-9400 Switch and the AT-S63 Management Software, refer to: AT-S63 Management Software Features Guide (PN 613-000801) For instructions on starting a local or remote management session, refer to: Starting an AT-S63 Management Session Guide (PN 613-000817) For instructions on installing or managing stand-alone switches, refer to: AT-9400 Gigabit Ethernet Switch Installation Guide (PN 613-000357) AT-S63 Management So
AT-S63 Stack Command Line Interface User’s Guide Where to Go First Allied Telesis recommends that you read Chapter 1, Overview, in the AT-S63 Management Software Features Guide before you begin to manage the switch for the first time. There you will find a variety of basic information about the unit and the management software, like the two levels of manager access levels and the different types of management sessions.
Preface Starting a Management Session For instructions on how to start a local or remote management session on a stack, refer to the Starting an AT-S63 Management Session Guide or Chapter 2, “Starting a Command Line Management Session” on page 49 in this guide.
AT-S63 Stack Command Line Interface User’s Guide Document Conventions This document uses the following conventions: Note Notes provide additional information. Caution Cautions inform you that performing or omitting a specific action may result in equipment damage or loss of data. Warning Warnings inform you that performing or omitting a specific action may result in bodily injury.
Preface Where to Find Web-based Guides The installation and user guides for all Allied Telesis products are available in portable document format (PDF) on our web site at www.alliedtelesis.com. You can view the documents online or download them onto a local workstation or server.
AT-S63 Stack Command Line Interface User’s Guide Contacting Allied Telesis This section provides Allied Telesis contact information for technical support as well as sales and corporate information. Online Support You can request technical support online by accessing the Allied Telesis Knowledge Base: www.alliedtelesis.com/support/kb.aspx. You can use the Knowledge Base to submit questions to our technical support staff and review answers to previously asked questions.
Preface 20
Section I Basic Operations The chapters in this section include: Section I: Basic Operations Chapter 1, “Overview” on page 23 Chapter 2, “Starting a Command Line Management Session” on page 49 Chapter 3, “Basic Command Line Commands” on page 59 Chapter 4, “Stacking Commands” on page 67 Chapter 5, “Basic Stack Commands” on page 73 Chapter 6, “Port Parameter Commands” on page 101 Chapter 7, “Port Statistics Commands” on page 123 Chapter 8, “MAC Address Table Commands” on pag
Section I: Basic Operations
Chapter 1 Overview This chapter has the following sections: “Introduction” on page 24 “AT-S63 Management Software” on page 25 “Supported Models” on page 25 “Supported Features” on page 26 “AT-StackXG Stacking Module” on page 27 “Maximum Number of Switches in a Stack” on page 28 “Management Interfaces” on page 28 “Management Access Methods” on page 28 “Enhanced Stacking” on page 29 “Stack Topology” on page 30 “Discovery Process” on page 32 “Master and Member S
Chapter 1: Overview Introduction The switches in the AT-9400 Series are divided into the Layer 2+ group and the Basic Layer 3 group. The switches of the two groups share many of the same features, but there are a number of significant differences, such as Internet Protocol version 4 packet routing and Virtual Router Redundancy Protocol, which only the Basic Layer 3 switches support. Three models in the Basic Layer 3 series support an additional feature called stacking.
AT-S63 Stack Command Line Interface User’s Guide AT-S63 Management Software Stacking requires Version 3.0.0 or later of the AT-S63 Management Software. Note Version 3.0.0 is only supported on the AT-9424Ts, AT-9424Ts/XP, AT-9448T/SP, and AT-9448Ts/XP Basic Layer 3 Switches. Do not install it on the AT-9408LC/SP, AT-9424T/GB, and AT-9424T/SP Layer 2+ Switches.
Chapter 1: Overview Supported Features A stack supports the following AT-S63 Management Software features: Port configuration – Port status (enabled or disabled) – Auto-Negotiation – Speed – Duplex-mode – Flow control and backpressure – MDI or MDI-X setting – Packet filtering and rate limiting Port statistics Remote Telnet management Static port trunks Port mirroring Event log Syslog client Class of Service Spanning tree protocol (STP) Rapid spanning tree
AT-S63 Stack Command Line Interface User’s Guide AT-StackXG Stacking Module The AT-9400 Switch must have the AT-StackXG Stacking Module, shown in Figure 1, to be part of a stack. You install the module in the switch’s expansion slot on the back panel. For installation instructions, refer to the AT-9400 Stack Installation Guide. AATT-L-S X4ta4cC kPXUG CVR Stack Port 1 Stack Port 2 1240 Figure 1.
Chapter 1: Overview Maximum Number of Switches in a Stack Table 1 lists the maximum number of switches that a stack can support. A stack can have up to five 48-port AT-9448Ts/XP Switches or eight 24-port AT-9424Ts or AT-9424Ts/XP Switches. A stack of both 24-port switches and 48-port switches models can have up to eight units. For instance, a stack can have five 24-port switches and three 48-port switches. Table 1.
AT-S63 Stack Command Line Interface User’s Guide Enhanced Stacking If you have prior experience with Allied Telesis products, you might already be familiar with a feature that happens to have a similar name to the feature discussed in this manual. The feature is enhanced stacking and what it allows you to do is manage the different Allied Telesis switches in your network from one management session by redirecting the management session from switch to switch.
Chapter 1: Overview Stack Topology The switches of a stack are cabled with the AT-StackXG Stacking Module and its two full-duplex, 12-Gbps stacking ports. There are two supported topologies. The first topology is the duplex-chain topology, where a port on one stacking module is connected to a port on the stacking module in the next switch, which is connected to the next switch, and so on. The connections must crossover to different numbered ports on the modules.
AT-S63 Stack Command Line Interface User’s Guide AT-StackXG RPS INPUT STACK PORT 1 STACK PORT 2 STACK PORT 1 STACK PORT 2 STACK PORT 1 STACK PORT 2 STACK PORT 1 STACK PORT 2 AT-StackXG RPS INPUT AT-StackXG RPS INPUT AT-StackXG RPS INPUT 1247 Figure 3. Duplex-ring Topology Both topologies offer the same in terms of network speed and performance. But the duplex-ring topology adds redundancy by providing a secondary path through the stacking modules.
Chapter 1: Overview Discovery Process When the switches of a stack are powered on or reset, they synchronize their operating software in a two phase process before they begin to forward network traffic through their ports. In the first phase the switches initialize their AT-S63 Management Software. It takes about one minute for a switch to fully initialize its software.
AT-S63 Stack Command Line Interface User’s Guide Master and Member Switches A stack must have a master switch to coordinate the activity of the devices. There can be only one master switch, but it can be any unit. In a stack with different AT-9400 Switch models, the master switch can be any model. The master switch is selected during the discovery process and is based on the module ID numbers of the units, as explained in “Module ID Numbers” on page 36. The master switch has module ID 1.
Chapter 1: Overview Active Configuration File The parameter settings of the stack are stored in the active configuration file in the master switch’s file system. In the file are the commands that reestablish the current configuration of the ports and switches in the stack. The file is used by the master switch whenever the stack performs the discovery process, such as after a reset or a power cycle, or a change to a stack’s composition.
AT-S63 Stack Command Line Interface User’s Guide By having two standard configuration files, a switch can retain its prior configuration settings when converted from a stand-alone configuration to a stack member, or vice versa. This saves you the trouble of having to reconfigure the device. It should be noted, however, that the parameter settings from a standalone configuration file cannot be transferred to a stack configuration file.
Chapter 1: Overview Module ID Numbers A switch has to have a unique module ID number in the range of 1 to 5 or 1 to 8 to be a member of a stack. The two ranges happen to correspond to the maximum size of a stack, as explained in “Maximum Number of Switches in a Stack” on page 28. The switch assigned module ID number 1 becomes the stack’s master switch. The switches of a stack are identified in the boot configuration file on the master switch by their module ID numbers.
AT-S63 Stack Command Line Interface User’s Guide The switches should be numbered starting with ID number 1. The switch assigned ID number 1 will be the master switch of the stack. Any switch can be the master switch, but it should be either the top or bottom switch in the rack to make it easy to identify.
Chapter 1: Overview If you do decide to use the dynamic method for assigning module ID numbers, there is a way for controlling the ID numbers assignments by assigning each switch a stack priority value with the SET STACK command. A switch can have only one stack priority value. The lower the number, the higher the priority. The switch with the lowest stack priority is assigned module ID 1 and becomes the master switch. The switch with the next lowest priority is assigned module ID 2, and so on.
AT-S63 Stack Command Line Interface User’s Guide Guidelines Section I: Basic Operations Here are the guidelines for module ID numbers: Each switch must have a unique module ID number. The module ID numbers are set with the SET STACK command and displayed with the SHOW STACK command. The SET STACK command should only be used when a switch is operating as a standalone device. Setting a switch’s module ID number while it is part of a stack can have unpredictable results.
Chapter 1: Overview Port Numbers in Commands Some of the commands in the AT-S63 Management Software are used to configure or display the settings of the individual ports on the switches in the stack. The ports are designated with the PORT parameter. Because a stack has more than one switch, entering just a port number will obviously not be enough. Instead, a port number must be preceded by the corresponding module ID number of a switch in the stack with the port.
AT-S63 Stack Command Line Interface User’s Guide The following is an example of the PORT parameter in the CREATE SWITCH TRUNK command, which creates static port trunks. The example creates a static port trunks of ports 3 to 5 on module 2 and ports 7 and 8 on module 4: create switch trunk=load22 port=2.3-2.5,4.7-4.
Chapter 1: Overview Stack IP Address A stack does not need an IP address to forward network packets through the ports of the switches.
AT-S63 Stack Command Line Interface User’s Guide Upgrading the AT-S63 Management Software The AT-9400 Switch must have Version 3.0.0 of the AT-S63 Management Software to be a member of a stack. To update the management software on an existing stack for versions after Version 3.0.0, you must disconnect the stacking cables and update the switches individually, either locally through the Terminal Port on the units or over the network using a TFTP server.
Chapter 1: Overview Powering On a Stack The switches of a stack can be powered on in any order. The units initialize their management software, which takes about one minute to complete, and afterwards perform the discovery process. The length of the discovery process can vary from fifteen seconds to several minutes, depending on the size of the stack and the number of the commands in the active configuration file on the master switch.
AT-S63 Stack Command Line Interface User’s Guide In the final stage the master switch configures the devices with the commands in the active configuration file in its file system. If this is the first time the stack is booted up, you will see the messages in Figure 6. Configuring the Stack............................. done! Reinitializing Software Modules .................. done! Configuration file "stack.cfg" not found! Loading default configuration ........ done! Figure 6.
Chapter 1: Overview Troubleshooting the Discovery Process The easiest way to troubleshoot a stack that is unable to complete the discovery process is to watch for error messages on the Terminal Port of the master switch. Here are the steps: 1. Connect a terminal or a personal computer with a terminal emulation program to the Terminal Port on the master switch, as explained in “Starting a Local Management Session” on page 50. 2. Power on all the switches in the stack.
AT-S63 Stack Command Line Interface User’s Guide If the master switch successfully completes the discovery process but the SHOW STACK command displays only one switch or a subset of the switches of the stack, try the following: Section I: Basic Operations Verify that all the switches are powered on. Verify that all the switches are using the same version of the AT-S63 Management Software. For instructions, refer to AT-9400 Stack Installation Guide.
Chapter 1: Overview 48 Section I: Basic Operations
Chapter 2 Starting a Command Line Management Session This chapter contains the following sections: “Starting a Local Management Session” on page 50 “Remote Telnet Management” on page 52 “Quitting a Management Session” on page 54 “Command Line Interface Features” on page 55 “Command Formatting” on page 56 “Redundant Twisted Pair Ports” on page 57 49
Chapter 2: Starting a Command Line Management Session Starting a Local Management Session Note A stack does not need an IP address for local management. To start a local management session, perform the following procedure: 1. Identify the master switch of the stack. (Local management sessions must be conducted through the master switch.) If you followed the instructions in the AT-9400 Stack Installation Guide, the switches should have labels with their module ID numbers.
AT-S63 Stack Command Line Interface User’s Guide Stop bits: 1 Flow control: None Note The port settings are for a DEC VT100 or ANSI terminal, or an equivalent terminal emulator program. 5. Press Enter. You are prompted for a user name and password. 6. Enter a user name and password. The stack comes with two standard user accounts: manager and operator. The manager account lets you configure the stack’s settings while the operator account only lets you view them.
Chapter 2: Starting a Command Line Management Session Remote Telnet Management Planning for Remote Management Before you can remotely manage a stack with a Telnet client from a network workstation, you must assign an IP address to the stack, as outlined in the steps here: 1. Create a virtual LAN (VLAN) on the stack. The VLAN must include the port(s) through which the stack and the remote Telnet clients will conduct the management sessions.
AT-S63 Stack Command Line Interface User’s Guide Note A stack can support one manager session and eight operator sessions simultaneously. After you have logged on, the command line interface (CLI) prompt is displayed, as shown in Figure 8 on page 51. If the stack has a name, the name is displayed below the master switch’s model name. 3. You can now begin to manage the stack with the commands detailed in this guide.
Chapter 2: Starting a Command Line Management Session Quitting a Management Session To quit a local management session, type EXIT. You should always exit from a management session at the completion of a session. This can prevent an unauthorized individual from making changes to a stack’s configuration in the event you leave your management station unattended.
AT-S63 Stack Command Line Interface User’s Guide Command Line Interface Features The following features are supported in the command line interface: Section I: Basic Operations Command history - Use the up and down arrow keys. Context-specific help - Press the question mark key at any time to see a list of legal next parameters. Keyword abbreviations - Any keyword can be recognized by typing an unambiguous prefix, for example, “sh” for “show”.
Chapter 2: Starting a Command Line Management Session Command Formatting The following formatting conventions are used in this manual: screen text font - This font illustrates the format of a command and command examples. 56 screen text font - Italicized screen text indicates a variable for you to enter. [ ] - Brackets indicate optional parameters. | - Vertical line separates parameter options for you to choose from.
AT-S63 Stack Command Line Interface User’s Guide Redundant Twisted Pair Ports The twisted pair ports 21R to 24R on the AT-9424Ts and AT-9424Ts/XP Switches are paired with four SFP slots. Follow these guidelines when using these ports and slots: Only one port in a pair — either the twisted pair port or the corresponding SFP module — can be active at a time.
Chapter 2: Starting a Command Line Management Session 58 Section I: Basic Operations
Chapter 3 Basic Command Line Commands This chapter contains the following commands: “CLEAR SCREEN” on page 60 “EXIT” on page 61 “HELP” on page 62 “LOGOFF, LOGOUT and QUIT” on page 63 “SAVE CONFIGURATION” on page 64 “SET PROMPT” on page 65 “SHOW USER” on page 66 Note Remember to save your changes with the SAVE CONFIGURATION command.
Chapter 3: Basic Command Line Commands CLEAR SCREEN Syntax clear screen Parameters None. Description This command clears the screen.
AT-S63 Stack Command Line Interface User’s Guide EXIT Syntax exit Parameters None. Description This command ends a management session. Example exit Equivalent Commands logoff logout quit For information, see “LOGOFF, LOGOUT and QUIT” on page 63.
Chapter 3: Basic Command Line Commands HELP Syntax help Parameters None. Description This command lists the CLI keywords. Each keyword has a brief description.
AT-S63 Stack Command Line Interface User’s Guide LOGOFF, LOGOUT and QUIT Syntax logoff logout quit Parameters None. Description These three commands end a management session.
Chapter 3: Basic Command Line Commands SAVE CONFIGURATION Syntax save configuration Parameters None. Description This command saves your changes to the parameter settings of the stack in the master switch’s active boot configuration file for permanent storage. Changes to the operating parameters of a stack, such as the creation of a new virtual LAN or static port trunk, are initially stored in temporary memory, where they will be lost the next time the stack is reset or power cycle.
AT-S63 Stack Command Line Interface User’s Guide SET PROMPT Syntax set prompt="prompt" Parameter prompt Specifies the command line prompt. The prompt can be from one to 12 alphanumeric characters. Spaces and special characters are allowed. The prompt must be enclosed in quotes. Description This command changes the command line prompt. Assigning each stack a different command prompt can make them easier to identify.
Chapter 3: Basic Command Line Commands SHOW USER Syntax show user Parameter None. Description Displays the user account used to log on to manage the stack.
Chapter 4 Stacking Commands This chapter contains the following commands: “SET STACK” on page 68 “SHOW STACK” on page 70 67
Chapter 4: Stacking Commands SET STACK Syntax set stack moduleid=value newmoduleid=auto|static|value priority=value Parameters mymoduleid Specifies the switch’s current ID number. To view this number, refer to “SHOW STACK” on page 70. newmoduleid Specifies a new stack ID number for the switch. Options are: priority auto Sets the switch’s ID dynamically, based on the device’s MAC address or stack priority number. static Converts the switch’s current dynamic module ID into a static ID.
AT-S63 Stack Command Line Interface User’s Guide You must reset or power cycle the unit after performing this command to activate a switch’s new ID number. You do not have to issue the SAVE CONFIGURATION command with this command. A device’s new ID number is automatically stored in a hidden system file in the unit’s file system. Note All of the switches of a stack must have the same type of stack ID number of static or dynamic.
Chapter 4: Stacking Commands SHOW STACK Syntax show stack Parameters None. Description This command displays the module ID number of a switch. The command displays different information depending on whether the switch is a standalone unit or the master switch of a functioning stack. Figure 9 is an example of the information from a stand-alone switch. This information is useful when setting or changing a switch’s ID number, which should only be performed when the device is not connected to a stack.
AT-S63 Stack Command Line Interface User’s Guide Figure 10 is an example of the command when it is performed on the master switch of a functioning stack. The switches in the stack and their module ID numbers are displayed in a table.
Chapter 4: Stacking Commands Priority - The priority number of a switch. The range is 1 to 16. The lower the number, the higher the priority. To set this value, refer to “SET STACK” on page 68. This value only applies when the ID numbers are set automatically. Mac Address - The MAC address of a switch. For information on module ID numbers, refer to “Module ID Numbers” on page 36.
Chapter 5 Basic Stack Commands This chapter contains the following commands: “DISABLE TELNET” on page 74 “ENABLE TELNET” on page 75 “PING” on page 76 “RESET SWITCH” on page 77 “RESET SYSTEM” on page 78 “RESTART REBOOT” on page 79 “RESTART SWITCH” on page 80 “SET ASYN” on page 82 “SET DATE” on page 83 “SET PASSWORD MANAGER” on page 84 “SET PASSWORD OPERATOR” on page 85 “SET SWITCH CONSOLETIMER” on page 86 “SET SYSTEM” on page 87 “SET TELNET INSERTNULL”
Chapter 5: Basic Stack Commands DISABLE TELNET Syntax disable telnet Parameters None. Description This command disables the Telnet server on the master switch. You might disable the server to prevent anyone from managing the stack with the Telnet application protocol or in the event you decide to use the Secure Shell protocol for remote management. The default setting for the Telnet server is enabled.
AT-S63 Stack Command Line Interface User’s Guide ENABLE TELNET Syntax enable telnet Parameters None. Description This command activates the Telnet server on the master switch. When the server is activated, you can remotely manage the stack using the Telnet application protocol. To disable the server, refer to “DISABLE TELNET” on page 74. The default setting for the Telnet server is enabled.
Chapter 5: Basic Stack Commands PING Syntax ping ipaddress Parameter ipaddress Specifies the IP address of an end node to be pinged. Description This command instructs the stack to ping an end node. You can use this command to determine whether an active link exists between the stack and another network device. Follow these guidelines when using this command: The stack must have a routing interface. It uses the IP address of the interface as its source address when pinging a device.
AT-S63 Stack Command Line Interface User’s Guide RESET SWITCH Syntax reset switch [module=id] Parameters id Specifies the ID number of a switch in the stack. You can specify only one switch at a time. To view the ID numbers of the switches, refer to “SHOW STACK” on page 70. Description This command does the following: Performs a soft reset on all of the ports on a switch or in a stack. The reset takes less than a second to complete. The ports retain their current operating parameter settings.
Chapter 5: Basic Stack Commands RESET SYSTEM Syntax reset system [name] [contact] [location] Parameters name Deletes the switch’s name. contact Deletes the switch’s contact. location Deletes the switch’s location. Description This command delete’s the stack’s name, the name of the network administrator responsible for managing it, and its location. To set these parameters, refer to “SET SYSTEM” on page 87. To view the current settings, refer to “SHOW SYSTEM” on page 98.
AT-S63 Stack Command Line Interface User’s Guide RESTART REBOOT Syntax restart reboot Parameters None. Description This command resets the entire stack. The switches run their internal diagnostics, load the AT-S63 Management Software, and perform the discovery process. The reset can take several minutes to complete. For further information, refer to “Discovery Process” on page 32. Note The switches of a stack do not forward traffic during the reset process. Some network traffic may be lost.
Chapter 5: Basic Stack Commands RESTART SWITCH Syntax restart switch config=none|filename.cfg Parameters config Specifies the configuration file. The file must already exist on the master switch. The NONE option returns all of the parameter settings in the stack to the default values. Description This command can load a different configuration file on the stack or return the stack’s parameter settings to their default values. This command can also be used to reset a stack.
AT-S63 Stack Command Line Interface User’s Guide Note For a list of default values, refer to Appendix A, “AT-S63 Default Settings” in the AT-S63 Management Software Features Guide. Your local or remote management session ends when you reset the stack. You must reestablish the session to continue managing it. Examples The following command configures the stack using the configuration file named stack12.cfg: restart switch config=stack12.
Chapter 5: Basic Stack Commands SET ASYN Syntax set asyn [speed=1200|2400|4800|9600|19200|38400| 57600|115200] [prompt=”prompt”] Parameters speed Sets the speed (baud rate) of the serial terminal port on the master switch. The default is 9600 bps. prompt Specifies the command line prompt. The prompt can be from one to 12 alphanumeric characters. Spaces and special characters are allowed. The prompt must be enclosed in double quotes. This parameter performs the same function as “SET PROMPT” on page 65.
AT-S63 Stack Command Line Interface User’s Guide SET DATE Syntax set date=dd-mm-yyyy Parameter date Specifies the date for the stack in day-month-year format. Description This command manually sets the date on the stack. You can use this command to set the stack’s date if you are not using an SNTP server. The date and time are maintained even when a switch is powered off because the unit has an onboard battery.
Chapter 5: Basic Stack Commands SET PASSWORD MANAGER Syntax set password manager Parameters None. Description This command sets the manager’s password. The manager account allows you to view and change all of the stack parameters. The default password is “friend.” The password can be from 0 to 16 alphanumeric characters. Allied Telesis recommends that you avoid special characters, such as spaces, asterisks, or exclamation points because some web browsers do not accept them in passwords.
AT-S63 Stack Command Line Interface User’s Guide SET PASSWORD OPERATOR Syntax set password operator Parameters None. Description This command sets the operator’s password. Logging in as operator allows you to only view the parameter settings in a stack. The default password is “operator.” The password can be from 0 to 16 alphanumeric characters.
Chapter 5: Basic Stack Commands SET SWITCH CONSOLETIMER Syntax set switch consoletimer=value Parameter consoletimer Specifies the console timer in minutes. The range is 1 to 60 minutes. The default is 10 minutes. Description This command sets the console timer, which the management software uses to end inactive management sessions.
AT-S63 Stack Command Line Interface User’s Guide SET SYSTEM Syntax set system [name="name"] [contact="contact"] [location="location"] Parameters name Specifies the name of the stack. The name can be from 1 to 39 alphanumeric characters in length and must be enclosed in double quotes (“ “). Spaces are allowed. contact Specifies the name of the network administrator responsible for managing the stack. The contact can be from 1 to 39 alphanumeric characters in length and must be enclosed in double quotes.
Chapter 5: Basic Stack Commands SET TELNET INSERTNULL Syntax set telnet insertnull=on|off Parameters insertnull Controls whether the Telnet server inserts a NULL character after each CR sent to the remote client. Options are: on Sends a NULL character after each CR sent to the remote client. off Specifies that no NULL character is sent to the remote client. This is the default setting.
AT-S63 Stack Command Line Interface User’s Guide SET TIME Syntax set time=hh:mm:ss Parameter time Specifies the hour, minute, and second for the stack’s time in 24-hour format. Description This command manually sets the time on the stack. You can use this command to set the stack’s time if you are not using an SNTP server. The date and time are maintained even when the switch is powered off because the unit has an onboard battery.
Chapter 5: Basic Stack Commands SET USER PASSWORD Syntax set user manager|operator password=password Parameter password Specifies the password. Description This command sets the manager or operator’s password. The default manager password is “friend.” The default operator password is “operator.” The password can be from 0 to 16 alphanumeric characters.
AT-S63 Stack Command Line Interface User’s Guide SHOW ASYN Syntax show asyn Parameters None. Description This command displays the settings for the serial terminal port on the master switch. The port is used for local management of the stack. An example of the display is shown in Figure 11. Asynchronous Port (Console) Information: Baud Rate ................................. Parity .................................... Data bits ................................. Stop bits .................................
Chapter 5: Basic Stack Commands SHOW CONFIG DYNAMIC Syntax show config dynamic[=module] Parameters module Displays the settings of a specific module in the management software. You can specify only one module at a time. For a list of modules, refer to Table 2. Description This command displays the parameter settings of the stack that have been changed from their default values, including those not yet saved to the active boot configuration file.
AT-S63 Stack Command Line Interface User’s Guide Table 2.
Chapter 5: Basic Stack Commands SHOW CONFIG INFO Syntax show config info Parameters None. Description This command displays all of the parameter settings on a stack, including those not yet saved to the active boot configuration file.
AT-S63 Stack Command Line Interface User’s Guide SHOW SWITCH Syntax show switch module=id Parameters id Specifies the ID number of a switch in the stack. You can specify only one switch at a time. To view the module ID numbers, refer to “SHOW STACK” on page 70. Description This command displays a variety of information and parameter settings about the switches in a stack. You can only view one switch at a time.
Chapter 5: Basic Stack Commands MAC address - The MAC address of the switch. This value cannot be changed. VLAN mode - The stack’s VLAN mode. The three possible VLAN modes are: User configured (for creating your own port-based and tagged VLANs) 802.1Q-compliant Non-802.1Q-compliant The default is user configured VLANs. Version 3.0.0 of the management software does not support 802.1Q-compliant or non802.1Q-compliant in a stack.
AT-S63 Stack Command Line Interface User’s Guide information correctly. When OFF, the default setting, no NULL character is set after a CR. To set this feature, see “SET TELNET INSERTNULL” on page 88. MAC address aging time - The current value for the MAC address aging timer. The switch uses the aging timer to delete inactive dynamic MAC addresses from the MAC address table. To set this value, refer to “SET SWITCH AGINGTIMER|AGEINGTIMER” on page 135.
Chapter 5: Basic Stack Commands SHOW SYSTEM Syntax show system Parameters None. Description This command displays the following information about the master switch of a stack: MAC Address The MAC address of the master switch. Model Name The model name of the master switch. Serial Number The serial number of the master switch. IP Address The IP address of the local interface. Subnet Mask The subnet mask of the local interface. Default Gateway For a stack, this field displays the default gateway address.
AT-S63 Stack Command Line Interface User’s Guide Administrator The name of the network administrator responsible for managing the stack. Location The location of the stack, (for example, 4th Floor - rm 402B). Note To configure the name, administrator, and location parameters, refer to “SET SYSTEM” on page 87. Power Information The status of the main power supply, the redundant power supply (if present), and internal power consumption in the master switch. Temperature (Deg.
Chapter 5: Basic Stack Commands SHOW TIME Syntax show time Parameters None. Description This command shows the stack’s current date and time.
Chapter 6 Port Parameter Commands This chapter contains the following commands: “DISABLE SWITCH PORT” on page 102 “DISABLE SWITCH PORT FLOW” on page 103 “ENABLE SWITCH PORT” on page 104 “ENABLE SWITCH PORT FLOW” on page 105 “PURGE SWITCH PORT” on page 106 “RESET SWITCH PORT” on page 107 “SET SWITCH PORT” on page 108 “SET SWITCH PORT FILTERING” on page 112 “SET SWITCH PORT RATELIMITING” on page 115 “SHOW SWITCH PORT” on page 118 Note Remember to save your changes with
Chapter 6: Port Parameter Commands DISABLE SWITCH PORT Syntax disable switch port=port Parameter port Specifies the port to disable. You can specify more than one port at a time. Port numbers are entered in the following format: module ID.port number For instructions, refer to “Port Numbers in Commands” on page 40. Description This command disables a port. A disabled port does not forward traffic. You might disable unused ports on the stack to prevent them from being used by unauthorized individuals.
AT-S63 Stack Command Line Interface User’s Guide DISABLE SWITCH PORT FLOW Syntax disable switch port=port flow=pause Parameter port Specifies the port where flow control is to be disabled. You can specify more than one port at a time. Port numbers are entered in the following format: module ID.port number For instructions, refer to “Port Numbers in Commands” on page 40. Description This command deactivates flow control on a port. Flow control only applies to ports operating in full duplex mode.
Chapter 6: Port Parameter Commands ENABLE SWITCH PORT Syntax enable switch port=port Parameter port Specifies the port to enable. You can specify more than one port at a time. Port numbers are specified in the following format: module ID.port number For instructions, refer to “Port Numbers in Commands” on page 40. Description This command enables a port. When a port is enabled, it forwards traffic. The default setting for a port is enabled. Example The following command enables ports 2.1 to 2.
AT-S63 Stack Command Line Interface User’s Guide ENABLE SWITCH PORT FLOW Syntax enable switch port=port flow=pause Parameter port Specifies the port where you want to active flow control. You can specify more than one port at a time. Port numbers are specified in the following format: module ID.port number For instructions, refer to “Port Numbers in Commands” on page 40. Description This command activates flow control on a port. Flow control applies to ports operating in full duplex mode.
Chapter 6: Port Parameter Commands PURGE SWITCH PORT Syntax purge switch port=port Parameters port Specifies the port whose parameter settings are to be returned to the default values. You can specify more than one port at a time. Port numbers are specified in the following format: module ID.port number For instructions, refer to “Port Numbers in Commands” on page 40. Description This command returns all of the parameter settings of a port to the factory default values.
AT-S63 Stack Command Line Interface User’s Guide RESET SWITCH PORT Syntax reset switch port=port Parameter port Specifies the port to reset. You can specify more than one port at a time. Port numbers are specified in the following format: module ID.port number For instructions, refer to “Port Numbers in Commands” on page 40. Description This command resets a port. The reset takes less that a second to complete.
Chapter 6: Port Parameter Commands SET SWITCH PORT Syntax set switch port=port [description=”description”] [status=enabled|disabled] [speed=autonegotiate|10mhalf|10mfull|100mhalf|100mfull| 1000mfull] [mdimode=mdi|mdix|auto] [flowcontrol=disable|enable|auto] [fctrllimit=value] [backpressure=yes|no|on|off|true|false|enabled| disabled] [bplimit=value] [holbplimit=value] [renegotiation=auto] [softreset] Parameters port Specifies the port to be configured. You can configure more than one port at a time.
AT-S63 Stack Command Line Interface User’s Guide 10mhalf 10 Mbps and half-duplex mode. 10mfull 10 Mbps and full-duplex mode. 100mhalf 100 Mbps and half-duplex mode. 100mfull 100 Mbps and full-duplex mode. 1000mfull 1000 Mbps and full-duplex mode. (Applies only to 1000Base SFP and GBIC modules. This selection should not be used. An SFP or GBIC module should use Auto-Negotiation to set its speed and duplex mode.
Chapter 6: Port Parameter Commands backpressure Controls backpressure on the port. Backpressure applies only to ports operating in half-duplex mode. The options are: yes, on, true, enabled Activates backpressure on the port. These options are equivalent. no, off, false, disabled Deactivates backpressure on the port. This is the default. These options are equivalent. bplimit Specifies the number of cells for back pressure. A cell represents 128 bytes. The range is 1 to 7935 cells.
AT-S63 Stack Command Line Interface User’s Guide The following command sets the speed on ports 1.2 to 1.6 to 100 Mbps, the duplex mode to full duplex, the wiring configuration to MDI-X, and flow control to enabled: set switch port=1.2-1.6 speed=100mfull mdimode=mdix flowcontrol=enabled The following command resets port 5.5: set switch port=5.5 softreset Equivalent Commands disable switch port=port For information, see “DISABLE SWITCH PORT” on page 102.
Chapter 6: Port Parameter Commands SET SWITCH PORT FILTERING Syntax set switch port=port [bcastfiltering=yes|no|on|off|true|false|enabled| disabled] [bcastegressfiltering=yes|no|on|off|true|false|enabled| disabled] [unkmcastfiltering=yes|no|on|off|true|false] [unkmcastegressfiltering=yes|no|on|off|true|false] [unkucastfiltering=yes|no|on|off|true|false] [unkucastegressfiltering=yes|no|on|off|true|false] Parameters port Specifies the port you want to configure.
AT-S63 Stack Command Line Interface User’s Guide unkmcastfiltering Controls the unknown ingress multicast frame filter. The options are: yes, on, true, enabled The port discards all unknown ingress multicast frames. These options are equivalent. no, off, false, disabled The port forwards all unknown ingress multicast frames. This is the default. These options are equivalent. unkmcastegressfiltering Controls the unknown egress multicast frame filter.
Chapter 6: Port Parameter Commands no, off, false, disabled The port forwards all unknown egress unicast frames. This is the default. These options are equivalent. Description This command discards ingress and egress broadcast packets as well as unknown unicast and multicast packets on a port. When you activate this feature on a port, the port discards all ingress or egress packets of the type specified. The default setting for each type of packet filter is disabled.
AT-S63 Stack Command Line Interface User’s Guide SET SWITCH PORT RATELIMITING Syntax set switch port=port [bcastratelimiting=yes|no|on|off|true|false|enabled| disabled] [bcastrate=value] [mcastratelimiting=yes|no|on|off|true|false|enabled| disabled] [mcastrate=value] [unkucastratelimiting=yes|no|on|off|true|false|enabled| disabled] [unkucastrate=value] Parameters port Specifies the port to be configured. You can specify more than one port at a time, but the ports must be of the same medium type.
Chapter 6: Port Parameter Commands mcastratelimiting mcastrate Enables or disables a rate limit for ingress multicast packets. The options are: yes, on, true, enabled Activates multicast packet rate limit on the port. The options are equivalent. no, off, false, disabled Deactivates multicast packet rate limit on the port. This is the default. The options are equivalent. Specifies the maximum number of ingress multicast packets a port accepts each second. The range is 0 to 262,134 packets.
AT-S63 Stack Command Line Interface User’s Guide Examples This command activates rate limiting for ingress broadcast and multicast packets on port 1.6. It sets a threshold of 20,000 packets per second for broadcast packets and 100,000 for multicast packets: set switch port=1.6 bcastratelimiting=yes bcastrate=20000 mcastratelimiting=yes mcastrate=100000 This command sets a threshold of 150,000 packets per second for unknown ingress unicast packets on ports 2.15 and 2.17: set switch port=2.15,2.
Chapter 6: Port Parameter Commands SHOW SWITCH PORT Syntax show switch port[=port] Parameter port Specifies the port whose parameter settings you want to view. You can specify more than one port at a time. Omitting this parameter displays all ports. Port numbers are entered in the following format: module ID.port number For instructions, refer to “Port Numbers in Commands” on page 40. Description This command displays a port’s current operating specifications, such as speed and duplex mode.
AT-S63 Stack Command Line Interface User’s Guide displays N/A, because the MDI/MDIX setting is set automatically on the port. A value only appears in this field if you disable AutoNegotiation on a twisted pair port and set MDI/MDIX manually. This field does not apply to a fiber optic port. To adjust a port’s MDI/MDIX setting, refer to “SET SWITCH PORT” on page 108. Section I: Basic Operations Actual Speed/Duplex - Displays the current operating speed and duplex mode of a port.
Chapter 6: Port Parameter Commands 120 Unknown Multicast Ingress Filtering - Displays the status of unknown ingress multicast filtering. If enabled, the port discards all unknown ingress multicast packets. The default is disabled. To configure this parameter, refer to “SET SWITCH PORT FILTERING” on page 112. Unknown Multicast Egress Filtering - Displays the status of unknown egress multicast filtering. If enabled, the port discards all unknown egress multicast packets. The default is disabled.
AT-S63 Stack Command Line Interface User’s Guide Q1 egress queue. To set this parameter, refer to “SET SWITCH PORT PRIORITY OVERRIDEPRIORITY” on page 226. Override Priority - Displays whether the Class of Service priority level in ingress tagged packets is ignored when determining the egress queue for storing the packets. If this parameter is displaying Yes the stack ignores the priority level in tagged packets and uses the priority level assigned to the port to determine the egress queue.
Chapter 6: Port Parameter Commands Port #11 Information: Port Description ..................... Port Type ............................ Status ............................... Link State ........................... Configured Speed/Duplex .............. Configured MDI Crossover ............. Actual Speed/Duplex .................. Actual MDI Crossover ................. Flow Control Status .................. Flow Control Threshold ............... Backpressure Status .................. Backpressure Threshold ..
Chapter 7 Port Statistics Commands This chapter contains the following commands: “RESET SWITCH PORT COUNTER” on page 124 “SHOW SWITCH MODULE COUNTER” on page 125 “SHOW SWITCH PORT COUNTER” on page 128 123
Chapter 7: Port Statistics Commands RESET SWITCH PORT COUNTER Syntax reset switch port=port counter Parameter port Specifies the port whose statistics counters are to be returned to zero. You can specify more than one port at a time. Port numbers are specified in the following format: module ID.port number For instructions, refer to “Port Numbers in Commands” on page 40. Description This command returns a port’s statistics counters to zero.
AT-S63 Stack Command Line Interface User’s Guide SHOW SWITCH MODULE COUNTER Syntax show switch module=id counter Parameters id Specifies the ID number of a switch in the stack. You can specify only one switch at a time. To view the ID numbers of the switches, refer to “SHOW STACK” on page 70. Description This command displays the operating statistics, such as the number of ingress and egress packets, of a switch in a stack. An example is shown in Figure 15. Module: 2 Port: All Bytes Rx .........
Chapter 7: Port Statistics Commands Bcast Frames Rx Number of broadcast frames received by the switch. Bcast Frames Tx Number of broadcast frames transmitted by the switch. Mcast Frames Rx Number of multicast frames received by the switch. Mcast Frames Tx Number of multicast frames transmitted by the switch. Frames 64 Frames 65-127 Frames 128-255 Frames 256-511 Frames 512-1023 Frames 1024-1518 Frames 1519-1522 Number of frames transmitted from the port, grouped by size.
AT-S63 Stack Command Line Interface User’s Guide Dropped Frames Number of frames successfully received and buffered by the switch, but discarded and not forwarded.
Chapter 7: Port Statistics Commands SHOW SWITCH PORT COUNTER Syntax show switch port[=port] counter Parameter port Specifies the port whose statistics you want to view. You can specify more than one port at a time. To view all ports, do not specify a port. Port numbers are entered in the following format: module ID.port number For instructions, refer to “Port Numbers in Commands” on page 40. Description This command displays the operating statistics for a port on the switch.
Chapter 8 MAC Address Table Commands This chapter contains the following commands: “ADD SWITCH FDB|FILTER” on page 130 “DELETE SWITCH FDB|FILTER” on page 132 “RESET SWITCH FDB” on page 134 “SET SWITCH AGINGTIMER|AGEINGTIMER” on page 135 “SHOW SWITCH AGINGTIMER|AGEINGTIMER” on page 136 “SHOW SWITCH FDB” on page 137 Note Remember to save your changes with the SAVE CONFIGURATION command.
Chapter 8: MAC Address Table Commands ADD SWITCH FDB|FILTER Syntax add switch fdb|filter destaddress|macaddress=macaddress port=port vlan=name|vid Note The FDB and FILTER keywords are equivalent. Parameters destaddress or macaddress Specifies the static unicast or multicast address to be added to the stack’s MAC address table. The parameters are equivalent. The address can be entered in either of the following formats: xxxxxxxxxxxx or xx:xx:xx:xx:xx:xx port Specifies the port(s) for the MAC address.
AT-S63 Stack Command Line Interface User’s Guide Examples This command adds the static MAC address 00:A0:D2:18:1A:11 to port 1.7 in the Default_VLAN: add switch fdb macaddress=00A0D2181A11 port=1.7 vlan=default_vlan This command adds the multicast MAC address 01:00:51:00:00 10 to ports 2.1 to 2.5 in the Engineering VLAN: add switch fdb macaddress=010051000010 port=2.1-2.
Chapter 8: MAC Address Table Commands DELETE SWITCH FDB|FILTER Syntax delete switch fdb|filter macaddress|destaddress=macaddress vlan=name|vid type|status=static|staticunicast|staticmulticast|dynamic| dynamicunicast|dynamicmulticast Note The FDB and FILTER keywords are equivalent. Parameters macaddress or Deletes a dynamic or static unicast or multicast MAC destaddress address from the MAC address table.
AT-S63 Stack Command Line Interface User’s Guide Description This command deletes dynamic and static unicast and multicast addresses from the stack’s MAC address table. Note You cannot delete a stack’s MAC address, an STP BPDU MAC address, or a broadcast address. Examples The following command deletes the static MAC address 00:A0:D2:18:1A:11 from the table.
Chapter 8: MAC Address Table Commands RESET SWITCH FDB Syntax reset switch fdb [port=port] Parameter port Specifies the port whose dynamic MAC addresses are to be deleted from the MAC address table. You can specify more than one port at a time. Port numbers must be specified in the following format: module ID.port number For instructions, refer to “Port Numbers in Commands” on page 40. Description This command deletes all of the dynamic MAC addresses learned by the entire stack or on a specific port.
AT-S63 Stack Command Line Interface User’s Guide SET SWITCH AGINGTIMER|AGEINGTIMER Syntax set switch agingtimer|ageingtimer=value Parameter agingtimer or ageingtimer Specifies the aging timer for the MAC address table. The value is in seconds. The range is 0 to 1048575. The default is 300 seconds (5 minutes). The parameters are equivalent. Description The stack uses the aging timer to delete inactive dynamic MAC addresses from the MAC address table in the master switch.
Chapter 8: MAC Address Table Commands SHOW SWITCH AGINGTIMER|AGEINGTIMER Syntax show switch agingtimer|ageingtimer Parameters None. Description This command displays the current setting for the aging timer. The stack uses the aging timer to delete inactive dynamic MAC addresses from the MAC address table. To set the aging timer, refer to “SET SWITCH AGINGTIMER|AGEINGTIMER” on page 135. Figure 16 illustrates the information displayed by this command. Aging interval: 300 second(s) Figure 16.
AT-S63 Stack Command Line Interface User’s Guide SHOW SWITCH FDB Syntax show switch fdb [macaddress|destaddress=macaddress] [port=port] [type|status=static|staticunicast| staticmulticast|dynamic|dynamicunicast|dynamicmulticast] [vlan=name] Parameters address Specifies a MAC address. Use this parameter to determine the port on the stack where a particular MAC address was learned (dynamic) or assigned (static).
Chapter 8: MAC Address Table Commands Note You can specify more than one parameter at a time with this command. Description This command displays the unicast and multicast MAC addresses learned or assigned to the ports on the stack and stored in the stack’s MAC address table. Figure 17 is an example. Switch Forwarding Database Total Number of MAC Addresses: 121 VLAN ID MAC Address Port Status -----------------------------------------------------------0 01:80:C1:00:02:01 1.
AT-S63 Stack Command Line Interface User’s Guide Figure 18 is an example of a multicast address. Multicast Switch Forwarding Database Total Number of MCAST MAC Addresses: 1 MAC Address VLANID Type Port Maps (U:Untagged T:Tagged) ---------------------------------------------------------------01:00:51:00:00:01 1 Static U:2.1-2.4 T: Figure 18. SHOW SWITCH FDB Command - Multicast Addresses The columns are defined here: MAC Address - The static or dynamic unicast MAC address.
Chapter 8: MAC Address Table Commands The following command displays the MAC addresses learned on the ports in the Sales VLAN: show switch fdb vlan=sales The following command displays the static MAC addresses on port 2.17: show switch fdb port=2.
Chapter 9 Static Port Trunking Commands This chapter contains the following commands: “Overview” on page 142 “ADD SWITCH TRUNK” on page 144 “CREATE SWITCH TRUNK” on page 146 “DELETE SWITCH TRUNK” on page 148 “DESTROY SWITCH TRUNK” on page 149 “SET SWITCH TRUNK” on page 150 “SHOW SWITCH TRUNK” on page 151 Note Remember to save your changes with the SAVE CONFIGURATION command.
Chapter 9: Static Port Trunking Commands Overview A static port trunk is a group of two to eight ports that function as a single virtual link between the stack and another network device. A static port trunk distributes the traffic across its ports to improve performance and enhance reliability by reducing the reliance on a single physical link. A static port trunk is easy to configure. You simply designate the ports of the trunk and the management software automatically groups them together.
AT-S63 Stack Command Line Interface User’s Guide Section I: Basic Operations The switch selects the lowest numbered port in the trunk to handle broadcast packets and packets of unknown destination. For example, a trunk of ports 2.11 to 2.15 would use port 2.11 for broadcast packets.
Chapter 9: Static Port Trunking Commands ADD SWITCH TRUNK Syntax add switch trunk=name [tgid=id_number] port=port Parameters trunk Specifies the name of the static port trunk to be modified. tgid Specifies the ID number of the static port trunk to be modified. The range is 1 to 6. This parameter is optional. port Specifies the port to be added to the port trunk. You can add more than one port at a time. Port numbers are specified in the following format: module ID.
AT-S63 Stack Command Line Interface User’s Guide Note A port that already belongs to a static port trunk must be removed from its current assignment before it can be added to another port trunk. To remove a port from a trunk, see “DELETE SWITCH TRUNK” on page 148. Example The following command adds port 1.5 to a port trunk called load22: add switch trunk=load22 port=1.
Chapter 9: Static Port Trunking Commands CREATE SWITCH TRUNK Syntax create switch trunk=name port=ports [select=macsrc|macdest|macboth|ipsrc|ipdest|ipboth] Parameters trunk Specifies the name of the trunk. The name can be up to 16 alphanumeric characters. No spaces or special characters are allowed. port Specifies the ports to be added to the port trunk. Port numbers are specified in the following format: module ID.port number For instructions, refer to “Port Numbers in Commands” on page 40.
AT-S63 Stack Command Line Interface User’s Guide Caution Do not connect the cables to the trunk ports on the devices until after you have created the trunk in the management software. Connecting the cables before configuring the software will create a loop in your network topology. Data loops can result in broadcast storms and poor network performance. Note Before creating a static port trunk, examine the speed, duplex mode, and flow control settings of the lowest numbered port to be in the trunk.
Chapter 9: Static Port Trunking Commands DELETE SWITCH TRUNK Syntax delete switch trunk=name port=port Parameters trunk Specifies the name of the static port trunk to be modified. port Specifies the port to be removed from the existing port trunk. You can specify more than one port at a time. Port numbers are specified in the following format: module ID.port number For instructions, refer to “Port Numbers in Commands” on page 40. Description This command removes ports from a static port trunk.
AT-S63 Stack Command Line Interface User’s Guide DESTROY SWITCH TRUNK Syntax destroy switch trunk=name Parameter trunk Specifies the name of the trunk to be deleted. Description This command deletes a static port trunk from a stack. After a port trunk has been deleted, the ports that made up the trunk can be connected to different end nodes. Caution Disconnect the cables from the port trunk on the stack before destroying the trunk.
Chapter 9: Static Port Trunking Commands SET SWITCH TRUNK Syntax set switch trunk=name select=macsrc|macdest|macboth|ipsrc|ipdest|ipboth Parameters trunk Specifies the name of the static port trunk. select Specifies the load distribution method. Options are: macsrc Source MAC address. macdest Destination MAC address. macboth Source address/destination MAC address. ipsrc Source IP address. ipdest Destination IP address. ipboth Source address/destination IP address.
AT-S63 Stack Command Line Interface User’s Guide SHOW SWITCH TRUNK Syntax show switch trunk Parameters None. Description This command displays the names, ports, and load distribution methods of the static port trunks on the stack. An example of the command is shown in Figure 19. Trunk group ID ............ Trunk status ........... Trunk group name ....... Trunk method ........... Ports .................. 2 UP Server11 SRC/DST MAC 2.12-2.16 Figure 19.
Chapter 9: Static Port Trunking Commands Example The following command displays port trunking information: show switch trunk 152 Section I: Basic Operations
Chapter 10 Port Mirroring Commands This chapter contains the following commands: “Overview” on page 154 “SET SWITCH MIRROR” on page 155 “SET SWITCH PORT MIRROR” on page 156 “SHOW SWITCH MIRROR” on page 157 Note Remember to save your changes with the SAVE CONFIGURATION command.
Chapter 10: Port Mirroring Commands Overview The port mirror feature allows you to unobtrusive monitor the ingress or egress traffic on one or more ports on a stack by copying the traffic to another stack port. By connecting a network analyzer to the port where the traffic is being copied to, you can monitor the traffic on the other ports without impacting network performance or speed. The port(s) whose traffic you want to mirror is called the source port(s).
AT-S63 Stack Command Line Interface User’s Guide SET SWITCH MIRROR Syntax set switch mirror=port Parameter mirror Specifies the destination port for the port mirror, where the traffic from the source ports is copied. A stack can have only one destination port. To stop port mirroring and free the destination port for use as a normal networking port, specifying “0” (zero) as the destination port. Port numbers are specified in the following format: module ID.
Chapter 10: Port Mirroring Commands SET SWITCH PORT MIRROR Syntax set switch port=port mirror=none|rx|tx|both Parameters port Specifies the source port of a port mirror. You can specify more than one port. Port numbers are specified in the following format: module ID.port number For instructions, refer to “Port Numbers in Commands” on page 40. mirror Specifies which traffic on the source ports is to be mirrored to the destination port. The options are: rx Specifies ingress mirroring.
AT-S63 Stack Command Line Interface User’s Guide SHOW SWITCH MIRROR Syntax show switch mirror Parameters None. Description This command displays the source and destination ports of a port mirror on the stack. An example is shown in Figure 20. Port Mirroring: Mirroring State ..................... Mirror-To (Destination) Port ........ Ingress (Rx) Mirror (Source) Ports .. Egress (Tx) Mirror (Source) Ports ... Enabled 1.22 2.1,2.3 2.1,2.3,5.11-5.13 Figure 20.
Chapter 10: Port Mirroring Commands 158 Section I: Basic Operations
Section II Advanced Operations The chapters in this section include: Section II: Advanced Operations Chapter 11, “File System Commands” on page 161 Chapter 12, “File Download and Upload Commands” on page 177 Chapter 13, “Event Log and Syslog Client Commands” on page 197 Chapter 14, “Class of Service (CoS) Commands” on page 225 159
Section II: Advanced Operations
Chapter 11 File System Commands This chapter contains the following commands: “Overview” on page 162 “COPY” on page 163 “CREATE CONFIG” on page 165 “DELETE FILE” on page 166 “FORMAT DEVICE” on page 167 “RENAME” on page 168 “SET CFLASH DIR” on page 170 “SET CONFIG” on page 171 “SHOW CFLASH” on page 173 “SHOW CONFIG” on page 174 “SHOW FILE” on page 175 “SHOW FLASH” on page 176 Note The master switch’s file system is the only active file system in a stack.
Chapter 11: File System Commands Overview You can use the commands in this chapter to manage the files in the file system in the master switch of the stack. For example, you might create a backup copy of an configuration file or delete obsolete files. The file systems on the member switches of a stack are inactive and cannot be accessed with these command. For further information about the switch’s file system, refer to the AT-S63 Management Software Features Guide.
AT-S63 Stack Command Line Interface User’s Guide COPY Syntax copy [cflash:]sourcefile.ext [cflash:]destinationfile.ext Parameters sourcefile.ext Specifies the name of the source file. If the file is stored on a compact memory flash card, precede the name with “cflash:”. If the filename contains spaces, enclose it in double quotes. Otherwise, the quotes are optional. destinationfile.ext Specifies the name of the destination file.
Chapter 11: File System Commands Table 3. File Extensions and File Types Extension File Type .csr Certificate enrollment request .key Public encryption key .log Event log Examples The following command creates a copy of the configuration file “admin.cfg” in the master switch’s file system and names the copy “admin2.cfg”: copy admin.cfg admin2.cfg The following command creates a copy of the configuration file “stack 12.cfg” in the file system and names the copy “backup.cfg”: copy "stack 12.
AT-S63 Stack Command Line Interface User’s Guide CREATE CONFIG Syntax create config=[cflash:]filename.cfg Parameter config Specifies the name of a new configuration file. If the filename contains spaces, enclose it in double quotes. Otherwise, the quotes are optional. To store the configuration file on a flash memory card, precede the name with “cflash:”. Description This command creates a new configuration file in the file system of the master switch.
Chapter 11: File System Commands DELETE FILE Syntax delete file=[cflash:]filename Parameter file Specifies the name of the file to be deleted. A name with spaces must be enclosed in double quotes. Otherwise, the quotes are optional. If the file is stored on a compact memory flash card, precede the name with “cflash:”. Description This command deletes a file from the file system or from a compact flash memory card in the master switch.
AT-S63 Stack Command Line Interface User’s Guide FORMAT DEVICE Syntax format device=flash Parameter device Specifies the device to format. The only option is “Flash” for the master switch’s file system. Description This command formats the flash memory in the master switch. Caution Formatting the flash memory deletes ALL files from the file system in the master switch, including the active configuration file and encryption keys.
Chapter 11: File System Commands RENAME Syntax rename [cflash:]filename1.ext [cflash:]filename2.ext Parameters filename1.ext Specifies the name of the file to be renamed. If the name contains spaces, enclose it in double quotes. Otherwise, the quotes are optional. If the file is stored on a compact memory card, precede the name with “cflash:”. filename2.ext Specifies the new name for the file. The filename can be from 1 to 16 alphanumeric characters, not including the filename extension.
AT-S63 Stack Command Line Interface User’s Guide system to “Stack 44a.cfg”: rename Stack12.cfg "Stack 44a.cfg" This command renames the file “sales_stack.cfg” on a flash memory card in the master switch to “sales 5 stack.cfg”: rename cflash:sales_stack.cfg cflash:”sales 5 stack.
Chapter 11: File System Commands SET CFLASH DIR Syntax set cflash dir=directory Parameter dir Specifies the directory path. Description This command changes the current directory on the compact flash card in the master switch. Note You cannot create directories on a compact flash card with the AT-S63 Management Software.
AT-S63 Stack Command Line Interface User’s Guide SET CONFIG Syntax set config=[cflash:]filename.cfg|none Parameter config Specifies the name of the configuration file to act as the active configuration file on the stack. The name can be from 1 to 16 alphanumeric characters, not including the extension “.cfg”. If the filename contains spaces, enclose it in double quotes. Description This command specifies the active configuration file on the master switch.
Chapter 11: File System Commands – To be able to save configuration changes again, you must assign a new active boot configuration file. If the master switch has a flash memory card, you can specify a configuration file on a flash card as the active boot configuration file. However, the configuration file is not copied to the master switch’s file system, but is instead used and updated directly from the card.
AT-S63 Stack Command Line Interface User’s Guide SHOW CFLASH Syntax show cflash Parameter None Description This command displays information about the compact flash card in the master switch. The information includes the current directory, the number of files, how much space is used, and amount of space available. An example is shown in Figure 21. Compact Flash: --------------------------------------------------Current Directory: \ Number of files ............ 6 Number of directories ......
Chapter 11: File System Commands SHOW CONFIG Syntax show config [dynamic] Parameter dynamic Displays the stack’s parameter settings in command line format. Description This command, when used without the DYNAMIC parameter, displays two pieces of information. An example is shown in Figure 22. Boot configuration file .............. "SalesSt4a.cfg" (Exists) Current configuration ................ "SalesSt4a.cfg" Figure 22.
AT-S63 Stack Command Line Interface User’s Guide SHOW FILE Syntax show file[=[cflash:]filename.ext] Parameter file Specifies the name of the file to be displayed. Use double quotes to enclose the name if it contains spaces. Otherwise, the quotes are optional. To view a file on a flash memory card, precede the name with “cflash”. If you do not specify a file name, the command displays a list of all files in flash memory as well as on the compact flash card.
Chapter 11: File System Commands SHOW FLASH Syntax show flash Parameter None Description This command displays information about the file system in the master switch. The information includes the number of files, how much space is used, and the amount of space available. An example is shown in Figure 23. Flash: --------------------------------------------------------Files .............. 12288 bytes (5 files) Free .............. 8211456 bytes Total ..............
Chapter 12 File Download and Upload Commands This chapter contains the following commands: “LOAD METHOD=LOCAL” on page 178 “LOAD METHOD=TFTP” on page 180 “LOAD METHOD=XMODEM” on page 185 “UPLOAD METHOD=LOCAL” on page 189 “UPLOAD METHOD=TFTP” on page 191 “UPLOAD METHOD=XMODEM” on page 194 177
Chapter 12: File Download and Upload Commands LOAD METHOD=LOCAL Syntax load method=local destfile=appblock srcfile|file=[cflash:]filename Parameters method Specifies a local download. destfile Specifies the application block (APPBLOCK) of the switch’s flash memory. This is the area of memory reserved for the switch’s active AT-S63 image file. srcfile or file Specifies the filename of the AT-S63 image file in the file system to be downloaded into the application block.
AT-S63 Stack Command Line Interface User’s Guide Use the SRCFILE or FILE parameter to specify the name of the AT-S63 image file in the switch’s file system or on the compact flash card. The current configuration of a switch is retained when a new AT-S63 software image is copied to the application block. After downloading an image file into the application block, you can delete the image file from the file system or compact flash card to free up space for other files.
Chapter 12: File Download and Upload Commands LOAD METHOD=TFTP Syntax load method=tftp destfile=[cflash:]filename|appblock server=ipaddress srcfile|file=filename Parameters method Specifies a TFTP download. destfile Specifies the destination filename for the file. This is the name given to the file when it is stored in the switch’s file system. The name can be from 1 to 15 alphanumeric characters, not including the three-letter extension. If the name includes spaces, enclose it in double quotes.
AT-S63 Stack Command Line Interface User’s Guide The DESTFILE parameter specifies a name for the file when it is stored in the file system or a flash memory card in the switch. Enclose the name in double quotes if it contains a space. When specifying the new name of a downloaded file, be sure to give it the correct three-letter extension that corresponds to its file type. The extensions are shown in Table 4. Table 4. File Name Extensions - Downloading Files Extension File Type .
Chapter 12: File Download and Upload Commands You should start the TFTP server software before performing the download command. For AT-9400 Switches running AT-S63 version 2.0.0 or later, the switch must have a routing interface on the local subnet from where it reaches the TFTP server. The switch uses the interface’s IP address as its source address during the file transfer with the server.
AT-S63 Stack Command Line Interface User’s Guide Note Downloading an AT-S63 image file into a switch’s file system rather than into the application block should be perform with care. The file will take up 2 megabytes of space in the file system. If you download a file onto a flash memory card in the switch and later want to copy the file from the card to a switch’s file system, refer to “COPY” on page 163.
Chapter 12: File Download and Upload Commands Since the file is downloaded to the switch’s file system and not to the application block, it is not used as the switch’s active image file. If at some point in the future you want to make it the active image file, refer to “UPLOAD METHOD=LOCAL” on page 189. This command downloads a configuration file called “sw12.cfg onto a flash memory card in the switch. The configuration file retains the same name when stored on the card.
AT-S63 Stack Command Line Interface User’s Guide LOAD METHOD=XMODEM Syntax load method=xmodem destfile=[cflash:]filename|appblock Parameters method Specifies an Xmodem download. destfile Specifies the destination filename for the file. This is the name given to the file when it is stored in the switch’s file system. The name can be from 1 to 15 alphanumeric characters, not including the three-letter extension. If the name includes spaces, enclose it in double quotes.
Chapter 12: File Download and Upload Commands The APPBLOCK option of the DESTFILE parameter refers to the switch’s application block, which is the portion of flash memory reserved for the active AT-S63 image. This option downloads a new version of the AT-S63 image file into the application block, making it the active image file on the switch. Note The APPBLOCK option should only be used when downloading a new AT-S63 image file, and not with any other file type.
AT-S63 Stack Command Line Interface User’s Guide configuration. If the switch has a static address, the interface is assigned the same address. If the unit obtained its IP configuration from a DHCP or BOOTP server, the interface is created with its DHCP or BOOTP client activated. The interface is given the interface number 0 and assigned to the preexisting management VLAN. Furthermore, the interface is designated as the local interface on the switch.
Chapter 12: File Download and Upload Commands load method=xmodem destfile=cflash:product_sw.cfg The following command downloads a new version of the AT-S63 image file to the switch’s file system instead of the application block. It does this by replacing the APPBLOCK option with a filename, in this case “ats63v1_2_0.img”. The image file is stored in the switch’s file system with this name: load method=xmodem destfile=ats63v1_2_0.
AT-S63 Stack Command Line Interface User’s Guide UPLOAD METHOD=LOCAL Syntax upload method=local destfile=[cflash:]filename srcfile|file=appblock Parameters method Specifies a local upload. destfile Specifies a filename for the AT-S63 image file. If the name contains spaces, enclose the name in quotes. To upload the active image file to a flash memory card in the switch, precede the name with “cflash:”.
Chapter 12: File Download and Upload Commands upload method=local destfile=cflash:s63.
AT-S63 Stack Command Line Interface User’s Guide UPLOAD METHOD=TFTP Syntax upload method=tftp destfile=filename server=ipaddress srcfile|file=switchcfg|[cflash:]filename|appblock Parameters method Specifies a TFTP upload. destfile Specifies a filename for the uploaded file. This is the name given the file when it is stored on the TFTP server. If the name contains spaces, enclose it in quotes. server Specifies the IP address of the network node containing the TFTP server software.
Chapter 12: File Download and Upload Commands Start the TFTP server software before you perform the command. The switch must have a routing interface on the local subnet from where it is reaching the TFTP server. The switch uses the interface’s IP address as its source address during the file transfer with the server. The server can be located on any interface on the switch, not just the local interface.
AT-S63 Stack Command Line Interface User’s Guide Examples The following command uses TFTP to upload a configuration file called “sw22 boot.cfg” from the switch’s file system to a TFTP server with an IP address of 149.88.88.88. The command stores the file on the server with the same name that it has on the switch: upload method=tftp destfile="sw22 boot.cfg" server=149.88.88.88 srcfile="sw22 boot.
Chapter 12: File Download and Upload Commands UPLOAD METHOD=XMODEM Syntax upload method=xmodem srcfile|file=switchcfg|[cflash:]filename|appblock Parameters method Specifies an Xmodem upload. srcfile or file Specifies the file to be uploaded. Options are: switchcfg Uploads the switch’s active boot configuration file. filename Specifies the name of a file to upload from the switch’s file system or compact flash card. If the file is stored on a compact flash card, precede the name with “cflash:”.
AT-S63 Stack Command Line Interface User’s Guide filename - Uploads a file from the switch’s file system or a compact flash memory card. This differs from the SWITCHCFG parameter in that the latter can upload just the active boot configuration file, while this parameter can upload any file on the switch. If the file is stored on a flash memory card in the switch, precede the filename with “cflash:”. APPBLOCK - Uploads the switch’s active AT-S63 image file.
Chapter 12: File Download and Upload Commands 196 Section II: Advanced Operations
Chapter 13 Event Log and Syslog Client Commands This chapter contains the following commands: “ADD LOG OUTPUT” on page 198 “CREATE LOG OUTPUT” on page 200 “DESTROY LOG OUTPUT” on page 204 “DISABLE LOG” on page 205 “DISABLE LOG OUTPUT” on page 206 “ENABLE LOG” on page 207 “ENABLE LOG OUTPUT” on page 208 “PURGE LOG” on page 209 “SAVE LOG” on page 210 “SET LOG FULLACTION” on page 212 “SET LOG OUTPUT” on page 213 “SHOW LOG” on page 216 “SHOW LOG OUTPUT” on pa
Chapter 13: Event Log and Syslog Client Commands ADD LOG OUTPUT Syntax add log output=output-id module=[all|module] severity=[all|severity] Parameters output Specifies the output definition ID number. module Specifies what AT-S63 events to filter. The available options are: severity all Sends events for all modules. This is the default. module Sends events for specific module(s). You can select more than one module at a time, for example, MAC,PACCESS.
AT-S63 Stack Command Line Interface User’s Guide The second step is to customize the definition by specifying which event messages are to be sent. This is accomplished with this command. You can customize the definition so that the stack sends all of its event messages or just events from particular modules in the AT-S63 Management Software. An alternative method to configuring a definition is with “SET LOG OUTPUT” on page 213.
Chapter 13: Event Log and Syslog Client Commands CREATE LOG OUTPUT Syntax create log output=output-id destination=syslog server=ipaddress [facility=default|local1|local2|local3|local4|local5|local6 |local7] [syslogformat=extended|normal] Parameters output destination Specifies an ID number that identifies the output definition. The possible output IDs are: 0 Reserved for permanent (nonvolatile) storage. You cannot change or delete this ID. 1 Reserved for temporary (dynamic) storage.
AT-S63 Stack Command Line Interface User’s Guide syslogformat Specifies the format of the generated messages. The possible options are: extended Messages include the date, time, and system name. This is the default. normal Messages do not include the date, time, and system name. Description This command creates a new output definition. The stack uses the definition to send event messages to a device on your network. You can create up to nineteen output definitions.
Chapter 13: Event Log and Syslog Client Commands The FACILITY parameter adds a numerical code to the entries as they are sent to the syslog server so that the entries are grouped on the server according to the source device. This is of particular value when a syslog server is collecting events from several difference network devices. You can specify only one facility level for a syslog server definition. There are two approaches to using this parameter. The first is to use the DEFAULT option.
AT-S63 Stack Command Line Interface User’s Guide Table 7. Numerical Code and Facility Level Mappings Facility Level Setting Numerical Code LOCAL1 17 LOCAL2 18 LOCAL3 19 LOCAL4 20 LOCAL5 21 LOCAL6 22 LOCAL7 23 The SYSLOGFORMAT parameter defines the content of the events. Examples The following command creates a definition for a syslog server with the IP address 149.65.10.22.
Chapter 13: Event Log and Syslog Client Commands DESTROY LOG OUTPUT Syntax destroy log output=output-id Parameters output Specifies the output definition ID number. Description This command deletes an output definition. To disable the output definition without deleting it, see “DISABLE LOG OUTPUT” on page 206.
AT-S63 Stack Command Line Interface User’s Guide DISABLE LOG Syntax disable log Parameters None. Description This command disables the event log module. When the log module is disabled, the AT-S63 Management Software stops storing events in the event logs and sending events to output definitions. The default setting for the event logs is enabled. Note The event log module, even when disabled, still logs all AT-S63 initialization events that occur when the stack is reset or power cycled.
Chapter 13: Event Log and Syslog Client Commands DISABLE LOG OUTPUT Syntax disable log output[=output-id] Parameters output Specifies the output definition ID number to disable. Not specifying an output definition disables all definitions. Description This command disables an output definition. When disabled, no event messages are sent to the specified device, although the definition still exists. To permanently remove an output definition, see “DESTROY LOG OUTPUT” on page 204.
AT-S63 Stack Command Line Interface User’s Guide ENABLE LOG Syntax enable log Parameters None. Description This command activates the event logs. After the log is activated, the switch immediately starts to store events in the event logs and send events to defined outputs. The default setting for the event log is enabled.
Chapter 13: Event Log and Syslog Client Commands ENABLE LOG OUTPUT Syntax enable log output[=output-id] Parameters output Specifies the output definition ID number to enable. The range is 2 to 20. Description This command enables an output definition that was disabled using “DISABLE LOG OUTPUT” on page 206.
AT-S63 Stack Command Line Interface User’s Guide PURGE LOG Syntax purge log[=permanent|temporary] Parameter log Specifies the event log to be purged. The options are: permanent Permanent (nonvolatile) memory. Deletes all of the events in the event log in nonvolatile memory, which can contain up to 2,000 events. temporary Temporary memory. Deletes all of the events in the event log in temporary memory, which can contain up to 4,000 events.
Chapter 13: Event Log and Syslog Client Commands SAVE LOG Syntax save log[=permanent|temporary] filename=filename.log [full] [module=module] [reverse] [severity=all|severity] [overwrite] Parameters log Specifies the source of the events you want to save to the log file. The options are: permanent Permanent (nonvolatile) memory. Saves events stored in nonvolatile memory, which can contain up to 2,000 events. temporary Temporary memory.
AT-S63 Stack Command Line Interface User’s Guide severity overwrite Saves events of a particular severity. Choices are I for Informational, E for Error, W for Warning, and D for Debug. You can select more than one severity at a time (for example, E,W). For a definition of the severity levels, see Table 9, “Event Log Severity Levels” on page 219. The default is E, W, I. Overwrites the file if it already exists.
Chapter 13: Event Log and Syslog Client Commands SET LOG FULLACTION Syntax set log fullaction [temporary=halt|wrap] [permanent=halt|wrap] Parameters fullaction Specifies what happens when a log reaches maximum capacity. You can set the action separately for each log. The possible actions are: halt The log stops storing new events. wrap The log deletes the oldest entries as new ones are added. This is the default.
AT-S63 Stack Command Line Interface User’s Guide SET LOG OUTPUT Syntax set log output=output-id [destination=syslog] server=ipaddress [facility=default|local1|local2|local3|local4|local5|local6 |local7] [syslogformat=extended|normal] [module=all|module] [severity=all|severity-list] Parameters output destination Specifies an ID number that identifies the output definition to be modified. The possible output IDs are: 0 Reserved for permanent (nonvolatile) storage. You cannot change or delete this ID.
Chapter 13: Event Log and Syslog Client Commands syslogformat module severity Specifies the format of the generated messages. The possible options are: extended Messages include the date, time, and system name. This is the default. normal Messages do not include the date, time, and system name. Specifies what AT-S63 events to filter. The available options are: all Sends events for all modules. This is the default. module Sends events for specific module(s).
AT-S63 Stack Command Line Interface User’s Guide Examples The following command changes the IP address for output definition number 5 to 149.55.55.55: set log output=5 server=149.55.55.55 The following command modifies output definition number 6 to only send messages from the RADIUS module of all severity levels: set log output=6 module=radius severity=all The following command changes the facility level and message format for output definition 4.
Chapter 13: Event Log and Syslog Client Commands SHOW LOG Syntax show log[=permanent|temporary] [full] [module=module] [reverse] [severity=severity] Parameters log 216 Specifies which of the two event logs you want to view. The options are: permanent Displays the events stored in permanent memory. temporary Displays the events stored in temporary memory. This is the default. full Specifies the amount of information displayed by the log.
AT-S63 Stack Command Line Interface User’s Guide Description This command displays the entries stored in an event log. An event log can display entries in two modes: normal and full. In the normal mode, a log displays the time, module, severity, and description for each entry. In the full mode, a log also displays the filename, line number, and event ID. If you want to view the entries in the full mode, use the FULL parameter. To view entries in the normal mode, omit the parameter.
Chapter 13: Event Log and Syslog Client Commands Table 8.
AT-S63 Stack Command Line Interface User’s Guide Table 9. Event Log Severity Levels Value Severity Level Description E Error Stack operation is severely impaired. W Warning An issue may require manager attention. I Informational Useful information that can be ignored during normal operation. D Debug Messages intended for technical support and software development. An example of the event log is shown in Figure 24. The example uses the full display mode.
Chapter 13: Event Log and Syslog Client Commands Examples The following command displays all the entries in the event log stored in permanent memory: show log=permanent The following command displays the events stored in temporary memory in the full display mode, which adds more information: show log=temporary full The following command displays only those entries stored in temporary memory and associated with the AT-S63 modules FILE and QOS: show log=permanent module=file,qos The following command disp
AT-S63 Stack Command Line Interface User’s Guide SHOW LOG OUTPUT Syntax show log output[=output-id] [full] Parameters output Specifies the output definition ID number. If an output ID number is not specified, all output definitions on the stack are displayed. full Displays the details of the output definition. If not specified, only a summary is displayed. Description This command displays output definition details. An example of the information displayed by this command is shown in Figure 25.
Chapter 13: Event Log and Syslog Client Commands An example of the information displayed by this command with the FULL parameter is shown in Figure 26. Output ID .................... Output Type .................. Status ....................... Server IP Address ............ Message Format ............... Facility Level ............... Event Severity ............... Event Module ................. 2 Syslog Enabled 149.88.88.88 Extended DEFAULT E,W,I All Figure 26.
AT-S63 Stack Command Line Interface User’s Guide SHOW LOG STATUS Syntax show log status Parameter None. Description This command displays information about the event log feature. Figure 27 is an example of the information displayed by this command. Event Log Configuration: Event Logging .................... Enabled Number of Output Definitions ..... 4 Figure 27. SHOW LOG STATUS Command The Event Logging field indicates whether the feature is enabled or disabled.
Chapter 13: Event Log and Syslog Client Commands 224 Section II: Advanced Operations
Chapter 14 Class of Service (CoS) Commands This chapter contains the following command: “SET SWITCH PORT PRIORITY OVERRIDEPRIORITY” on page 226 Note Remember to save your changes with the SAVE CONFIGURATION command.
Chapter 14: Class of Service (CoS) Commands SET SWITCH PORT PRIORITY OVERRIDEPRIORITY Syntax set switch port=port [priority=value] [overridepriority=yes|no|on|off|true|false] Parameters port Specifies the port to be configured. You can specify more than one port at a time, but the ports must be of the same medium type (either all twisted pair ports or all fiber optic ports). Port numbers are specified in the following format: module ID.
AT-S63 Stack Command Line Interface User’s Guide This command allows you to override the priority level mappings at the port level by assigning the packets a temporary priority. Note that this assignment is made when a packet is received on the ingress port and before the frame is forwarded to the egress port. Consequently, you need to configure this feature on the ingress port.
Chapter 14: Class of Service (CoS) Commands 228 Section II: Advanced Operations
Section III Spanning Tree Protocols The chapters in this section contain the commands for the spanning tree protocols.
Section III: Spanning Tree Protocols
Chapter 15 Spanning Tree Protocol Commands This chapter contains the following commands: “ACTIVATE STP” on page 232 “DISABLE STP” on page 233 “ENABLE STP” on page 234 “PURGE STP” on page 235 “SET STP” on page 236 “SET STP PORT” on page 239 “SET SWITCH MULTICASTMODE” on page 241 “SHOW STP” on page 243 Note Remember to save your changes with the SAVE CONFIGURATION command.
Chapter 15: Spanning Tree Protocol Commands ACTIVATE STP Syntax activate stp Parameters None. Description This command designates STP as the active spanning tree on the stack. You cannot enable STP or configure its parameters until you have designated it as the active spanning tree with this command. Only one spanning tree protocol, STP, RSTP, or MSTP, can be active on the stack at a time.
AT-S63 Stack Command Line Interface User’s Guide DISABLE STP Syntax disable stp Parameters None. Description This command disables the Spanning Tree Protocol on the stack. The default setting for STP is disabled. To view the current status of STP, refer to “SHOW STP” on page 243.
Chapter 15: Spanning Tree Protocol Commands ENABLE STP Syntax enable stp Parameters None. Description This command enables the Spanning Tree Protocol on the stack. The default setting for STP is disabled. To view the current status of STP, refer to “SHOW STP” on page 243. Note You cannot enable STP until after you have activated it with “ACTIVATE STP” on page 232.
AT-S63 Stack Command Line Interface User’s Guide PURGE STP Syntax purge stp Parameters None. Description This command returns all STP bridge and port parameters to the default settings. STP must be disabled in order for you to use this command. To disable STP, see “DISABLE STP” on page 233. Example purge stp Equivalent Command set stp default For information, see “SET STP” on page 236.
Chapter 15: Spanning Tree Protocol Commands SET STP Syntax set stp [default] [priority=priority] [hellotime=hellotime] [forwarddelay=forwarddelay] [maxage=maxage] Parameters default Disables STP and returns all bridge and port STP settings to the default values. This parameter cannot be used with any other command parameter and can only be used when STP is disabled. (This parameter performs the same function as the PURGE STP command.) priority Specifies the priority number for the bridge.
AT-S63 Stack Command Line Interface User’s Guide hellotime Specifies the time interval between generating and sending configuration messages by the bridge. This parameter can be from 1 to 10 seconds. The default is 2 seconds. forwarddelay Specifies the waiting period before a bridge changes to a new state, for example, becomes the new root bridge after the topology changes. If the bridge transitions too soon, all links may not have had time to adapt to the change, resulting in network loops.
Chapter 15: Spanning Tree Protocol Commands Examples This command sets the stack’s bridge priority value to 45,056 (increment 11): set stp priority=11 This command sets the hello time to 7 seconds and the forwarding delay to 25 seconds: set stp hellotime=7 forwarddelay=25 This command returns all of the stack’s STP parameters to the default values: set stp default Equivalent Command purge stp For information, see “PURGE STP” on page 235.
AT-S63 Stack Command Line Interface User’s Guide SET STP PORT Syntax set stp port=port [pathcost|portcost=auto|portcost] [portpriority=portpriority] Parameters port Specifies the port you want to configure. You can configure more than one port at a time. Port numbers must be specified in the following format: module ID.port number For instructions, refer to “Port Numbers in Commands” on page 40. pathcost or portcost Specifies the port’s cost. The parameters are equivalent.
Chapter 15: Spanning Tree Protocol Commands portpriority Specifies the port’s priority. This parameter is used as a tie breaker when two or more ports are determined to have equal costs to the root bridge. The range is 0 to 240 in increments of 16, for a total of 16 increments as shown in Table 13. You specify the increment of the desired value. The default is 128 (increment 8). Table 13.
AT-S63 Stack Command Line Interface User’s Guide SET SWITCH MULTICASTMODE Syntax set switch multicastmode=[a|b|c|d] Parameter multicast mode Specifies the multicast mode. The options are: a Discards all ingress spanning tree BPDU and 802.1x EAPOL packets on all ports. b Forwards ingress spanning tree BPDU and 802.1x EAPOL packets across all VLANs and ports. c Forwards ingress BPDU and EAPOL packets only among the untagged ports of the VLAN where the ingress port is a member.
Chapter 15: Spanning Tree Protocol Commands B - Forwards ingress spanning tree BPDU and 802.1x EAPOL packets across all VLANs and ports. This is the default setting. The stack behaves as follows: If STP, RSTP, and MSTP are disabled, ingress BPDUs are flooded on all ports. If STP, RSTP, MSTP, and 802.1x are disabled on the stack, BPDUs and EAPOL packets are flooded on all ports. If the stack is running STP or RSTP and 802.
AT-S63 Stack Command Line Interface User’s Guide SHOW STP Syntax show stp [port=port] Parameter port Specifies the port whose STP parameters you want to view. You can view more than one port at a time.Port numbers must be specified in the following format: module ID.port number For instructions, refer to “Port Numbers in Commands” on page 40. Description This command displays the current values for the STP parameters. An example of the display is shown in Figure 28. Status ......................
Chapter 15: Spanning Tree Protocol Commands The root bridge parameter specifies the bridge identifier of the root bridge of the spanning tree domain. The identifier consists of the bridge priority value and MAC address of the root switch, separated by a slash (/). This parameter only appears when STP is activated on the stack. The root path cost parameter displays the path cost from the stack to the root bridge of the spanning tree domain. If the stack is the root bridge, the path cost is 0.
Chapter 16 Rapid Spanning Tree Protocols Commands This chapter contains the following commands: “ACTIVATE RSTP” on page 246 “DISABLE RSTP” on page 247 “ENABLE RSTP” on page 248 “PURGE RSTP” on page 249 “SET RSTP” on page 250 “SET RSTP PORT” on page 253 “SHOW RSTP” on page 256 Note Remember to save your changes with the SAVE CONFIGURATION command. Note For overview information on the rapid spanning tree protocol (RSTP), refer to the AT-S63 Management Software Features Guide.
Chapter 16: Rapid Spanning Tree Protocols Commands ACTIVATE RSTP Syntax activate rstp Parameters None. Description This command designates RSTP as the active spanning tree on the stack. After selecting RSTP as the active spanning tree, you can enable or disable it with the ENABLE RSTP and DISABLE RSTP commands. RSTP is active on a stack only after you have designated it as the active spanning tree with this command and enabled it with the ENABLE RSTP command.
AT-S63 Stack Command Line Interface User’s Guide DISABLE RSTP Syntax disable rstp Parameters None. Description This command disables the Rapid Spanning Tree Protocol on the stack. To view the current status of RSTP, use “SHOW RSTP” on page 256.
Chapter 16: Rapid Spanning Tree Protocols Commands ENABLE RSTP Syntax enable rstp Parameters None. Description This command enables the Rapid Spanning Tree Protocol on the stack. The default setting for RSTP is disabled. To view the current status of RSTP, use “SHOW RSTP” on page 256. You cannot enable RSTP until you have activated it with the ACTIVATE RSTP command.
AT-S63 Stack Command Line Interface User’s Guide PURGE RSTP Syntax purge rstp Parameters None. Description This command returns all RSTP bridge and port parameters to the default settings. RSTP must be disabled before you can use this command. To disable RSTP, refer to “DISABLE RSTP” on page 247. Example The following command resets RSTP: purge rstp Equivalent Command set rstp default For information, refer to “SET RSTP” on page 250.
Chapter 16: Rapid Spanning Tree Protocols Commands SET RSTP Syntax set rstp [default] [priority=priority] [hellotime=hellotime] [forwarddelay=forwarddelay] [maxage=maxage] [rstptype|forceversion=stpcompatible| forcestpcompatible|normalrstp] Parameters default Returns all bridge and port RSTP settings to the default values. This parameter cannot be used with any other command parameter and only when RSTP is disabled. (This parameter performs the same function as the PURGE RSTP command.
AT-S63 Stack Command Line Interface User’s Guide hellotime Specifies the time interval between generating and sending configuration messages by the bridge. This parameter can be from 1 to 10 seconds. The default is 2 seconds. forwarddelay Specifies the waiting period before a bridge changes to a new state, for example, becomes the new root bridge after the topology changes. If the bridge transitions too soon, not all links may have yet adapted to the change, resulting in network loops.
Chapter 16: Rapid Spanning Tree Protocols Commands Forwarding delay Maximum age time Port priority Force version of STP or normal RSTP This command can also return the RSTP parameters to their default settings. Note You can use this command only if RSTP is the active spanning tree protocol on the stack. See “ACTIVATE RSTP” on page 246.
AT-S63 Stack Command Line Interface User’s Guide SET RSTP PORT Syntax set rstp port=port [pathcost|portcost=cost|auto] [portpriority=portpriority] [edgeport=yes|no|on|off|true|false] [ptp|pointtopoint=yes|no|on|off|true|false|autoupdate] [migrationcheck=yes|no|on|off|true|false] Parameters port Specifies the port you want to configure. You can specify more than one port at a time. Port numbers are specified in the following format: module ID.
Chapter 16: Rapid Spanning Tree Protocols Commands Table 16 lists the RSTP port costs with Auto-Detect when the port is part of a port trunk. Table 16. RSTP Auto-Detect Port Trunk Costs portpriority Port Speed Port Cost 10 Mbps 20,000 100 Mbps 20,000 1000 Mbps 2,000 Specifies the port’s priority. This parameter is used as a tie breaker when two or more ports are determined to have equal costs to the root bridge.
AT-S63 Stack Command Line Interface User’s Guide ptp or pointtopoint migrationcheck Defines whether the port is functioning as a pointto-point port. The parameters are equivalent. This type of port is connected to a device operating at full-duplex mode. The options are: yes, on, true The port is an point-to-point port. The options are equivalent. no, off, false The port is not an point-to-point port. The parameters are equivalent. are equivalent.
Chapter 16: Rapid Spanning Tree Protocols Commands SHOW RSTP Syntax show rstp [portconfig=port|portstate=port] Parameters portconfig Displays the RSTP port settings. You can specify more than one port at a time. portstate Displays the RSTP port status. You can specify more than one port at a time. Description You can use this command to display the RSTP parameter settings. An example of the display is shown in Figure 30. Status ....................... Force Version ................ Bridge Priority ...
AT-S63 Stack Command Line Interface User’s Guide The root bridge identifier parameter displays the bridge priority value and MAC address of the root switch of the spanning tree domain. The values are separated by a slash (/). This parameter only appears when RSTP is activated on the stack. The root path cost parameter displays the path cost from the stack to the root bridge of the spanning tree domain. If the stack is the root bridge, the path cost is 0.
Chapter 16: Rapid Spanning Tree Protocols Commands The information displayed by the command is as follows: Port — The port number. State — The RSTP state of the port. The possible states for a port connected to another device running RSTP are Discarding and Forwarding. The possible states for a port connected to a device running STP are Listening, Learning, Forwarding, and Blocking. The possible states for a port not being used or where spanning tree is not activated is Disabled.
Section IV Virtual LANs The chapter in this section contains the commands for managing virtual LANs.
Section IV: Virtual LANs
Chapter 17 Port-based and Tagged VLAN Commands This chapter contains the following commands: “ADD VLAN” on page 262 “CREATE VLAN” on page 264 “DELETE VLAN” on page 267 “DESTROY VLAN” on page 270 “SET SWITCH INFILTERING” on page 271 “SET VLAN” on page 272 “SHOW VLAN” on page 273 Note Remember to use the SAVE CONFIGURATION command to save your changes on the stack. Note For overview information on port-based and tagged VLANs, refer to the AT-S63 Management Software Features Guide.
Chapter 17: Port-based and Tagged VLAN Commands ADD VLAN Syntax 1 add vlan=name [vid=vid] ports=ports|all frame=untagged|tagged Syntax 2 add vlan=name [vid=vid] taggedports=ports|all untaggedports=ports|all Parameters vlan Specifies the name of the VLAN to modify. vid Specifies the VID of the VLAN you want to modify. This parameter is optional. ports Specifies the ports to be added to the VLAN. Port numbers are entered in the following format: module ID.
AT-S63 Stack Command Line Interface User’s Guide This command has two syntaxes. Either syntax can be used to add ports to a VLAN. The difference between the two is that Syntax 1 can add only one type of port, tagged or untagged, at a time to a VLAN, while Syntax 2 can add both in the same command. This is illustrated in Examples below.
Chapter 17: Port-based and Tagged VLAN Commands CREATE VLAN Syntax 1 create vlan=name vid=vid [type=port] ports=ports|all frame=untagged|tagged Syntax 2 create vlan=name vid=vid [type=port] taggedports=ports|all untaggedports=ports|all Parameters vlan Specifies a name of up to 20 alphanumeric characters for the new VLAN. A VLAN must have a name. It should reflect the function of the member nodes of the VLAN (for example, Sales or Accounting).
AT-S63 Stack Command Line Interface User’s Guide ports Specifies the ports on the stack that are tagged or untagged members of the new VLAN. This parameter must be followed by the FRAME parameter. Port numbers are specified in the following format: module ID.port number For instructions, refer to “Port Numbers in Commands” on page 40. frame Specifies whether the ports of the VLAN are to be tagged or untagged. This parameter must be used with the PORTS parameter.
Chapter 17: Port-based and Tagged VLAN Commands assignments. Examples The following command uses Syntax 1 to create a port-based VLAN called Sales with a VID of 3. The VLAN consists of ports 1.4 to 1.8 and ports 2.12 to 2.16. All ports will be untagged ports in the VLAN: create vlan=Sales vid=3 ports=1.4-1.8,2.12-2.16 frame=untagged The following command uses Syntax 2 to create the same VLAN: create vlan=Sales vid=3 untaggedports=1.4-1.8,2.12-2.
AT-S63 Stack Command Line Interface User’s Guide DELETE VLAN Syntax 1 delete vlan=name [vid=vid] ports=ports frame=untagged|tagged Syntax 2 delete vlan=name [vid=vid] taggedports=ports untaggedports=ports Parameters vlan Specifies the name of the VLAN to be modified. vid Specifies the VID of the VLAN to be modified. This parameter is optional. ports Specifies the ports to be removed from the VLAN. This parameter must be used with the FRAME parameter.
Chapter 17: Port-based and Tagged VLAN Commands Note To delete a VLAN, see “DESTROY VLAN” on page 270. Note You cannot change a VLAN’s name or VID. When you remove an untagged port from a VLAN, the following happens: The port is returned to the Default_VLAN as an untagged port. If the port is also a tagged member of other VLANS, those VLAN assignments are not changed. The port remains a tagged member of the other VLANs.
AT-S63 Stack Command Line Interface User’s Guide delete vlan=Service ports=5.6-5.8 frame=untagged Using Syntax 2, you can do the whole thing with just one command: delete vlan=Service untaggedports=5.6-5.8 taggedports=1.
Chapter 17: Port-based and Tagged VLAN Commands DESTROY VLAN Syntax destroy vlan=name|vid|all Parameters vlan Specifies the name or VID of the VLAN to be deleted. To delete all VLANs, use the ALL option. Description This command deletes port-based VLANs from the stack. You can use the command to delete selected VLANs or all the VLANs on the stack. Note the following before using this command: You cannot delete the Default_VLAN. You cannot delete a VLAN if it has a routing interface.
AT-S63 Stack Command Line Interface User’s Guide SET SWITCH INFILTERING Syntax set switch infiltering=yes|no|on|off|true|false Parameters infiltering Specifies the operating status of ingress filtering. The options are: yes, on, true Activates ingress filtering. The options are equivalent. This is the default setting. no, off, false Deactivates ingress filtering. The options are equivalent. Description This command controls the status of ingress filtering.
Chapter 17: Port-based and Tagged VLAN Commands SET VLAN Syntax set vlan=name|vid port=ports frame=tagged|untagged Parameters vlan Specifies the name or VID of the VLAN to be modified. ports Specifies the port whose VLAN type is to be changed. You can specify more than one port at a time. Port numbers are specified in the following format: module ID.port number For instructions, refer to “Port Numbers in Commands” on page 40. frame Identifies the new VLAN type for the port.
AT-S63 Stack Command Line Interface User’s Guide SHOW VLAN Syntax show vlan[=name|vid] Parameter vlan Specifies the name or VID of the VLAN. Description This command displays the VLANs on the stack. An example of the information displayed by this command for port-based and tagged VLANs is shown in Figure 33. VLAN Name ............................ VLAN ID .............................. VLAN Type ............................ Protected Ports ...................... Untagged Port(s) Configured ..............
Chapter 17: Port-based and Tagged VLAN Commands – Actual: The current untagged ports of the VLAN. This applies to 802.1x port-based network access control. Since version 3.0.0 of the AT-S63 Management Software does not support this feature in a stack, you can ignore this field. The ports in the Configured and Actual fields will always be the same. Tagged port(s) - The tagged ports of the VLAN. A tagged port can belong to more than one VLAN at a time.
Section V Internet Protocol Routing The chapters in this section are: Section V: Internet Protocol Routing Chapter 18, “Routing Interface Commands” on page 277 275
Section V: Internet Protocol Routing
Chapter 18 Routing Interface Commands This chapter contains the following commands: “ADD IP ARP” on page 278 “ADD IP INTERFACE” on page 280 “DELETE IP ARP” on page 282 “DELETE IP INTERFACE” on page 283 “PURGE IP” on page 284 “SET IP ARP” on page 285 “SET IP ARP TIMEOUT” on page 287 “SET IP INTERFACE” on page 288 “SET IP LOCAL INTERFACE” on page 290 “SHOW IP ARP” on page 291 “SHOW IP COUNTER” on page 293 “SHOW IP INTERFACE” on page 295 Note Remember to save yo
Chapter 18: Routing Interface Commands ADD IP ARP Syntax add ip arp=ipaddress interface=interface port=port ethernet=macaddress Parameters arp Specifies the IP address of the host. The IP address must be a member of a local subnet or network that has a routing interface on the stack. interface Specifies the name of the interface from where the host is reached. An interface name consists of “VLAN” followed by a VID or VLAN name and an interface number, separated by a dash (e.g., vlan4-0).
AT-S63 Stack Command Line Interface User’s Guide This command adds a static ARP entry for a host with an IP address of 149.124.85.14 and a MAC address of 00:06:7A:22:11:A4. The host is located on port 6 in the VLAN14-1 interface: add ip arp=149.124.85.
Chapter 18: Routing Interface Commands ADD IP INTERFACE Syntax add ip interface=interface ipaddress=ipaddress|dhcp|bootp [mask|netmask=subnetmask] Parameters interface Specifies a name for the new routing interface. An interface name consists of “VLAN” followed by the ID (VID) or name of the VLAN where the interface is to be assigned and an interface number, separated by a dash (e.g., vlan4-0). The range of the interface number is 0 to 15. ipaddress Specifies an IP address for the interface.
AT-S63 Stack Command Line Interface User’s Guide Description This command creates an IPv4 routing interface on the stack. A stack does not support the IPv4 routing feature of the AT-S63 Management Software, which routes IP packets between different subnets. (If you want to use that feature, you must install the switches as stand-alone devices.) However, the management software does allow you to create one routing interface on a stack so that you can assign it an IP address.
Chapter 18: Routing Interface Commands DELETE IP ARP Syntax delete ip arp=ipaddress Parameters arp Specifies the IP address of the host to be deleted from the ARP cache. Description This command deletes static and dynamic ARP entries from the ARP cache. This command can delete only one ARP entry at a time. To view the entries in the cache, refer to “SHOW IP ARP” on page 291. Example This command deletes the ARP entry for a host with the IP address 149.42.67.8: delete ip arp=149.42.67.
AT-S63 Stack Command Line Interface User’s Guide DELETE IP INTERFACE Syntax delete ip interface=interface Parameters interface Specifies the name of the interface to be deleted from the stack. An interface name consists of “VLAN” followed by the ID (VID) or name of the VLAN and an interface number, separated by a dash (e.g., vlan4-0). Description This command deletes an interface from the stack. To display the name of the existing interface, refer to “SHOW IP INTERFACE” on page 295.
Chapter 18: Routing Interface Commands PURGE IP Syntax purge ip Parameters None. Description This command deletes all routing interfaces. Since a stack supports only one interface, this command deletes just that one interface.
AT-S63 Stack Command Line Interface User’s Guide SET IP ARP Syntax set ip arp=ipaddress [interface=interface] [port=port] [ethernet=macaddress] Parameters arp Specifies the IP address of the static route entry to be modified. interface Specifies a new interface where the host is located. An interface name consists of “VLAN” followed by the ID (VID) or name of the VLAN where the interface is to be assigned and an interface number, separated by a dash (e.g., vlan4-0).
Chapter 18: Routing Interface Commands This command changes the MAC address for the static ARP entry with the IP address 149.124.85.14: set ip arp=149.124.85.
AT-S63 Stack Command Line Interface User’s Guide SET IP ARP TIMEOUT Syntax set ip arp timeout=integer Parameter timeout Specifies the ARP cache timeout value The range is 150 to 260000 seconds. The default setting is 600 seconds. Description This command sets the ARP cache timeout value. The timer prevents the ARP table from becoming full with inactive entries. An entry that is not used for the length of the timeout period is designated as inactive and deleted from the table.
Chapter 18: Routing Interface Commands SET IP INTERFACE Syntax set ip interface=interface|eth0 [ipaddress=ipaddress|dhcp|bootp] [mask|netmask=subnetmask] Parameters interface Specifies the name of the routing interface to be modified. An interface name consists of “VLAN” followed by the ID (VID) or name of the VLAN and an interface number, separated by a dash (e.g., vlan4-0). The “eth0” value can be used in place of the interface name to identify the local interface.
AT-S63 Stack Command Line Interface User’s Guide Note the following before performing this command: To change an interface’s VID or interface number, you must delete it and recreate it. You can specify the local interface two ways, by its interface name (for example, VLAN5-1) or the “eth0” value. The “0” in the value is not a VID, as in an interface name. Rather, the “eth0” value signifies the local interface.
Chapter 18: Routing Interface Commands SET IP LOCAL INTERFACE Syntax set ip local interface=interface|none Parameters interface Specifies the name of the interface to act as the local interface on the stack. An interface name consists of “VLAN” followed by the ID (VID) or name of the VLAN and an interface number, separated by a dash (e.g., vlan4-0). Use the NONE option to remove the currently assigned local interface without assigning a new one. The default is no local interface.
AT-S63 Stack Command Line Interface User’s Guide SHOW IP ARP Syntax show ip arp Parameters None. Description This command displays the entries in the ARP cache. The ARP cache contains mappings of IP addresses to physical addresses for hosts where the stack has recently routed packets. Figure 34 is an example of the information displayed by this command.
Chapter 18: Routing Interface Commands Example This command displays the entries in the ARP cache: show ip arp 292 Section V: Internet Protocol Routing
AT-S63 Stack Command Line Interface User’s Guide SHOW IP COUNTER Syntax show ip counter [port=ports|all] Parameters port Specifies the ports whose IP statistics are to be displayed. Port numbers are specified in the following format: module ID.port number For instructions, refer to “Port Numbers in Commands” on page 40. Description This command displays Layer 3 counters for the individual ports on a stack. Figure 35 is an example of the information displayed by this command. Port 1.1 IPInUcastPkts ....
Chapter 18: Routing Interface Commands Examples This command displays the statistics for all the ports: show ip counter This command displays the statistics for ports 1.1 to 1.4: show ip counter port=1.1-1.
AT-S63 Stack Command Line Interface User’s Guide SHOW IP INTERFACE Syntax show ip interface[=interface|eth0] Parameters interface Specifies an interface name. An interface name consists of “VLAN” followed by the ID (VID) or name of the VLAN and an interface number, separated by a dash (e.g., vlan4-0). If no interface value is specified, the command displays all the interfaces. The “eth0” value can be used to designate the local interface.
Chapter 18: Routing Interface Commands NetMask - The interface’s subnet mask. The subnet mask is assigned manually to the interface or automatically by a DHCP or BOOTP server. If the mask is 0.0.0.0, the DHCP or BOOTP server has not responded. RipMet - The interface’s hop count when routing packets with RIP. Since a stack does not support RIP, this column can be ignored.
Index A ACTIVATE RSTP command 246 ACTIVATE STP command 232 ADD IP ARP command 278 ADD IP INTERFACE command 280 ADD LOG OUTPUT command 198 ADD SWITCH FDB|FILTER command 130 ADD SWITCH TRUNK command 144 ADD VLAN command 262 Address Resolution Protocol (ARP) adding entries 278 deleting entries 282 displaying entries 291 modifying entries 285 setting cache timeout 287 aging timer 135 AT-S63 software image downloading 178, 180, 185 uploading 189, 191, 194 AT-S63 software, resetting to factory defaults 79 AT-Sta
Index ENABLE TELNET command 75 enhanced stacking 29 event log configuring 212 disabling 205 displaying 216, 223 enabling 207 resetting to defaults 209 saving 210 EXIT command 61 log output adding 198 creating 200 destroying 204 disabling 206 displaying 221 enabling 208 modifying 213 LOGOFF command 63 LOGOUT command 63 F M factory defaults 79 files copying 163 deleting 166 displaying file list 175 downloading 180, 185 renaming 168 uploading 191, 194 flash memory configuration file in 171 copying files 1
AT-S63 Management Software Web Browser Interface User’s Guide enabling 104 flow control disabling 103 enabling 105 head of line blocking 110 negotiation 108 packet filitering 112 priority 239, 253 rate limit 115 resetting 107, 110 speed, setting 108 statistics counter displaying 128 resetting 124 status, specifying 108 port mirror described 154 destination port 154 destination port, setting 155 displaying 157 setting 156 source port 154 port trunk adding 144 creating 146 deleting 148 destroying 149 display
Index SHOW CONFIG INFO command 94 SHOW FILE command 175 SHOW IP ARP command 291 SHOW IP COUNTER command 293 SHOW IP INTERFACE command 295 SHOW LOG command 216 SHOW LOG OUTPUT command 221 SHOW LOG STATUS command 223 SHOW RSTP command 256 SHOW STACK command 70 SHOW STP command 243 SHOW SWITCH AGINGTIMER|AGEINGTIMER command 136 SHOW SWITCH command 95 SHOW SWITCH FDB command 137 SHOW SWITCH MIRROR command 157 SHOW SWITCH MODULE COUNTER command 125 SHOW SWITCH PORT command 118 SHOW SWITCH PORT COUNTER command 1
