CLI Manual Product Model: Release 1 DES-3800 Series Layer 3 Stackable Fast Ethernet Managed Switch ©Copyright 2005. All rights reserved. August 2005 651ES3828015G RECYCLABLE Table of Contents INTRODUCTION ......................................................................................................................... 1 USING THE CONSOLE CLI ........................................................................................................ 4 COMMAND SYNTAX .................................................................................................................. 9 BASIC SWITCH COMMANDS .................................................................................................. 12 SWITCH PORT COMMANDS ................................................................................................... 23 PORT SECURITY COMMANDS ............................................................................................... 26 NETWORK MANAGEMENT (SNMP) COMMANDS ................................................................. 29 SWITCH UTILITY COMMANDS................................................................................................ 52 NETWORK MONITORING COMMANDS.................................................................................. 61 MULTIPLE SPANNING TREE PROTOCOL (MSTP) COMMANDS.......................................... 74 FORWARDING DATABASE COMMANDS............................................................................... 87 BROADCAST STORM CONTROL COMMANDS ..................................................................... 96 QOS COMMANDS .................................................................................................................... 99 PORT MIRRORING COMMANDS........................................................................................... 108 VLAN COMMANDS................................................................................................................. 111 LINK AGGREGATION COMMANDS ...................................................................................... 117 IP-MAC BINDING .................................................................................................................... 123 BASIC IP COMMANDS ........................................................................................................... 127 IGMP COMMANDS ................................................................................................................. 130 IGMP SNOOPING COMMANDS ............................................................................................. 133 DHCP RELAY.......................................................................................................................... 143 802.1X COMMANDS ............................................................................................................... 149 ACCESS CONTROL LIST (ACL) COMMANDS ..................................................................... 160 CPU PROTECTION COMMANDS .......................................................................................... 183 TRAFFIC SEGMENTATION COMMANDS ............................................................................. 185 TIME AND SNTP COMMANDS............................................................................................... 187 ARP COMMANDS ...................................................................................................................193 VRRP COMMANDS................................................................................................................. 197 ROUTING TABLE COMMANDS ............................................................................................. 204 ROUTE REDISTRIBUTION COMMANDS............................................................................... 208 DNS COMMANDS ...................................................................................................................214 RIP COMMANDS .................................................................................................................... 218 DVMRP COMMANDS.............................................................................................................. 221 PIM COMMANDS .................................................................................................................... 226 IP MULTICASTING COMMANDS ........................................................................................... 230 MD5 COMMANDS ...................................................................................................................232 OSPF CONFIGURATION COMMANDS.................................................................................. 235 MAC NOTIFICATION COMMANDS ........................................................................................ 253 ACCESS AUTHENTICATION CONTROL COMMANDS ........................................................ 257 SSH COMMANDS ...................................................................................................................282 SSL COMMANDS ...................................................................................................................290 JUMBO FRAME COMMANDS ................................................................................................ 296 D-LINK SINGLE IP MANAGEMENT COMMANDS................................................................. 298 COMMAND HISTORY LIST .................................................................................................... 309 POE ......................................................................................................................................... 312 MODIFY BANNER AND PROMPT COMMANDS ................................................................... 317 TECHNICAL SPECIFICATIONS ............................................................................................. 320 xStack DES-3800 Series Layer 3 Stackable Fast Ethernet Managed Switch CLI Manual 1 Introduction The DES-3800 series is a member of the D-Link xStack switch family. xStack is a complete family of stackable devices that ranges from edge 10/100Mbps switches to core Gigabit switches. xStack provides unsurpassed performance, fault tolerance, scalable flexibility, robust security, standard-based interoperability and an impressive support for 10Gigabit technology to future-proof departmental and enterprise network deployments with an easy migration path. The 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 Manual. 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 o refresh the console screen. Figure 1-1. Initial CLI screen 1 xStack DES-3800 Series Layer 3 Stackable Fast Ethernet Managed Switch CLI Manual There is no initial username or password. Just press the Enter key twice to display the CLI input cursor - DES-3800:4#. This is the command line where all commands are input. 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. 2. 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. 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 xStack DES-3800 Series Layer 3 Stackable Fast Ethernet Managed Switch CLI Manual Figure 1-3. Assigning an IP Address In the above example, the Switch was assigned an IP address of 10.41.44.254 with a subnet mask of 255.0.0.0. The system message Success indicates that the command was executed successfully. The Switch can now be configured and managed via Telnet, SNMP MIB browser and the CLI or via the Webbased management agent using the above IP address to connect to the Switch. 3 xStack DES-3800 Series Layer 3 Stackable Fast Ethernet Managed Switch CLI Manual 2 Using the Console CLI The Switch 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 9600 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. 4 xStack DES-3800 Series Layer 3 Stackable Fast Ethernet Managed Switch CLI Manual After the Switch reboots and you have logged in, the console looks like this: Figure 2- 1. Initial Console Screen after logging in Commands are entered at the command prompt, DES-3800: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 When you enter a command without its required parameters, the CLI will prompt you with a Next possible completions: message. 5 xStack DES-3800 Series Layer 3 Stackable Fast Ethernet Managed Switch CLI Manual Figure 2- 3. Example Command Parameter Help In this case, the command config account was entered with the parameter . The CLI will then prompt you to enter the 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 subcommands, in sequential order, by repeatedly pressing the Tab key. To re-enter the previous command at the command prompt, press the up arrow cursor key. The previous command will appear at the comma ...