DGS-3024 Layer 2 Switch Command Line Interface Reference Manual First Edition (December 2004) 6DGS3024C.01 Printed In Taiwan RECYCLABLE Table of Contents Introduction ...................................................................................................................................................................................... 1 Using the Console CLI..................................................................................................................................................................... 4 Command Syntax ............................................................................................................................................................................. 9 Basic Switch Commands................................................................................................................................................................ 11 Switch Port Commands .................................................................................................................................................................. 23 Network Management (SNMP) Commands .................................................................................................................................. 25 MAC Notification Commands ....................................................................................................................................................... 47 Download/Upload Commands ....................................................................................................................................................... 51 Network Monitoring Commands.................................................................................................................................................... 54 Spanning Tree Commands ............................................................................................................................................................. 66 Forwarding Database Commands .................................................................................................................................................. 72 Broadcast Storm Control Commands............................................................................................................................................. 78 QoS Commands.............................................................................................................................................................................. 80 Port Mirroring Commands ............................................................................................................................................................. 86 VLAN Commands.......................................................................................................................................................................... 89 Link Aggregation Commands ........................................................................................................................................................ 95 Basic IP Commands ....................................................................................................................................................................... 99 IGMP Snooping Commands ........................................................................................................................................................ 101 802.1X Commands....................................................................................................................................................................... 108 Time and SNTP Commands......................................................................................................................................................... 120 Routing Table Commands............................................................................................................................................................ 126 ARP Commands........................................................................................................................................................................... 128 Command History List ................................................................................................................................................................. 132 Technical Specifications .............................................................................................................................................................. 136 DGS-3024 Layer 2 Switch CLI Reference Manual 1 INTRODUCTION The DGS-3024 Switch can be managed through the Switch's serial port, Telnet, or the Web-based management agent. The Command Line Interface (CLI) can be used to configure and manage the Switch via the serial port or Telnet interfaces. This manual provides a reference for all of the commands contained in the CLI. Configuration and management of the Switch via the Web-based management agent is discussed in the User's Guide. Accessing the Switch via the Serial Port The Switch's serial port's default settings are as follows: · · · · 9600 baud no parity 8 data bits 1 stop bit A computer running a terminal emulation program capable of emulating a VT-100 terminal and a serial port configured as above is then connected to the Switch's serial port via an RS-232 DB-9 cable. With the serial port properly connected to a management computer, the following screen should be visible. If this screen does not appear, try pressing Ctrl+r to refresh the console screen. Figure 1-1. Initial CLI screen There is no initial username or password. Just press the Enter key twice to display the CLI input cursor - DGS-3024:4#. This is the command line where all commands are input. 1 DGS-3024 Layer 2 Switch CLI Reference Manual Setting the Switch's IP Address Each switch must be assigned its own IP Address, which is used for communication with an SNMP network manager or other TCP/IP application (for example BOOTP, TFTP). The Switch's default IP address is 10.90.90.90. You can change the default Switch IP address to meet the specification of your networking address scheme. The Switch is also assigned a unique MAC address by the factory. This MAC address cannot be changed, and can be found on the initial boot console screen ­ shown below. Figure 1-2. Boot Screen The Switch's MAC address can also be found in the Web management program on the Switch Information (Basic Settings) window on the Configuration menu. The IP address for the Switch must be set before it can be managed with the Web-based manager. The Switch IP address can be automatically set using BOOTP or DHCP protocols, in which case the actual address assigned to the Switch must be known. The IP address may be set using the Command Line Interface (CLI) over the console serial port as follows: 1. Starting at the command line prompt, enter the commands config ipif System ipaddress xxx.xxx.xxx.xxx/yyy.yyy.yyy.yyy. Where the x's represent the IP address to be assigned to the IP interface named System and the y's represent the corresponding subnet mask. Alternatively, you can enter config ipif System ipaddress xxx.xxx.xxx.xxx/z. Where the x's represent the IP address to be assigned to the IP interface named System and the z represents the corresponding number of subnets in CIDR notation. 2. The IP interface named System on the Switch can be assigned an IP address and subnet mask which can then be used to connect a management station to the Switch's Telnet or Web-based management agent. 2 DGS-3024 Layer 2 Switch CLI Reference Manual Figure 1-3. Assigning an IP Address In the above example, the Switch was assigned an IP address of 10.53.13.111 with a subnet mask of 255.0.0.0 (8 in CIDR from). The system message Success indicates that the command was executed successfully. The Switch can now be configured and managed via Telnet and the CLI or via the Web-based management agent using the above IP address to connect to the Switch. 3 DGS-3024 Layer 2 Switch CLI Reference Manual 2 USING THE CONSOLE CLI The DGS-3024 supports a console management interface that allows the user to connect to the Switch's management agent via a serial port and a terminal or a computer running a terminal emulation program. The console can also be used over the network using the TCP/IP Telnet protocol. The console program can be used to configure the Switch to use an SNMP-based network management software over the network. This chapter describes how to use the console interface to access the Switch, change its settings, and monitor its operation. Note: Switch configuration settings are saved to non-volatile RAM using the save command. The current configuration will then be retained in the Switch's NV-RAM, and reloaded when the Switch is rebooted. If the Switch is rebooted without using the save command, the last configuration saved to NV-RAM will be loaded. Connecting to the Switch The console interface is used by connecting the Switch to a VT100-compatible terminal or a computer running an ordinary terminal emulator program (e.g., the HyperTerminal program included with the Windows operating system) using an RS-232C serial cable. Your terminal parameters will need to be set to: · · · · · · VT-100 compatible 9,600 baud 8 data bits No parity One stop bit No flow control You can also access the same functions over a Telnet interface. Once you have set an IP address for your Switch, you can use a Telnet program (in VT-100 compatible terminal mode) to access and control the Switch. All of the screens are identical, whether accessed from the console port or from a Telnet interface. After the Switch reboots and you have logged in, the console looks like this: 4 DGS-3024 Layer 2 Switch CLI Reference Manual Figure 2-1. Console Screen after login Commands are entered at the command prompt, DGS-3024:4#. There are a number of helpful features included in the CLI. Entering the ? command will display a list of all of the top-level commands. Figure 2-2. The ? Command The dir command has the same function as the ? command. When you enter a command without its required parameters, the CLI will prompt you with a Next possible completions: message. 5 DGS-3024 Layer 2 Switch CLI Reference Manual Figure 2-3. Example Command Parameter Help In this case, the command show was entered without a parameter. The CLI will then prompt you to enter the next possible completions with the message, Next possible completions:. Every command in the CLI has this feature, and complex commands have several layers of parameter prompting. In addition, after typing any given command plus one space, you can see all of the next possible sub-commands, in sequential order, by repeatedly pressing the Tab key. To re-enter a previously entered command at the command prompt, press the up arrow cursor key. The previous command will appear at the command prompt. Figure 2-4. Using the Up Arrow to Re-enter a Command In the above example, the command config account was entered without the required parameter , the CLI returned the Next possible completions: prompt. The up arrow cursor control key was pressed to re-enter the previous command (config account) at the command prompt. Now the appropriate user name can be entered and the config account command re-executed. 6 DGS-3024 Layer 2 Switch CLI Reference Manual All commands in the CLI function in this way. In addition, the syntax of the help prompts are the same as presented in this manual - angle brackets < > indicate a numerical value or character string, braces { } indicate optional parameters or a choice of parameters, and brackets [ ] indicate required parameters. If a command is entered that is unrecognized by the CLI, the top-level commands will be displayed under the Available commands: prompt. Figure 2-5. The Next Available Commands Prompt The top-level commands consist of commands such as show or config. Most of these commands require one or more parameters to narrow the top-level command. This is equivalent to show what? or config what? Where the what? is the next parameter. For example, if you enter the show command with no additional parameters, the CLI will then display all of the possible next parameters. Figure 2-6. Next possible completions: show command 7 DGS-3024 Layer 2 Switch CLI Reference Manual In the above example, all of the possible next parameters for the show command are displayed. At the next command prompt, the up arrow was used to re-enter the show command, followed by the account parameter. The CLI then displays the user accounts configured on the Switch. 8 DGS-3024 Layer 2 Switch CLI Reference Manual 3 COMMAND SYNTAX The following symbols are used to describe how command entries are made and values and arguments are specified in this manual. The online help contained in the CLI and available through the consol ...