D-Link DGS-3224TGR - Switch User manual

i
DGS-3224TGR
Layer 2 Switch
Command Line Interface
Reference Manual
First Edition (October 2003)
6S24TGRCLI01
Printed In China
RECYCLABLE

ii
Trademarks
Copyright 2003 D-Link Corporation.
Contents subject to change without prior notice.
D-Link is a registered trademark of D-Link Corporation/D-Link
Systems, Inc. All other trademarks belong to their respective
proprietors.
Copyright Statement
No part of this publication may be reproduced in any form or by any
means or used to make any derivative such as translation,
transformation, or adaptation without permission from D-Link
Corporation/D-Link Systems Inc., as stipulated by the United States
Copyright Act of 1976.

iii
Table of Contents
Introduction ............................................................................ 1
Using the Console CLI .............................................................6
Command Syntax.................................................................. 14
Basic Switch Commands....................................................... 19
Switch Port Commands .........................................................44
Network Management Commands ......................................... 49
Download/Upload Commands ..............................................66
Network Monitoring Commands ............................................70
Spanning Tree Commands ....................................................78
Layer 2 Forwarding Database Commands .............................87
Broadcast Storm Control Commands ....................................97
ARP Commands .................................................................. 101
QOS Commands ................................................................. 106
Port Mirroring Commands................................................... 121
VLAN Commands ................................................................ 128

iv
Link Aggregation Commands............................................... 141
IP Interface Commands ....................................................... 149
IGMP Snooping Commands................................................. 154
Routing Table Commands ................................................... 168
802.1X Commands ............................................................. 173
Access Control List (ACL) Commands .................................. 197
SSH Commands .................................................................. 213
Command History List ........................................................ 224
Technical Specifications ...................................................... 230

DGS-3224TGR Layer 2 Gigabit Ethernet Switch User’s Guide
1
1
INTRODUCTION
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
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.

DGS-3224TGR Layer 2 Gigabit Ethernet Switch User’s Guide
2
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 Console screen.
There is no initial username or password. Just press the Enter
key twice to display the CLI input cursor −DGS-3224TGR: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 or 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.

DGS-3224TGR Layer 2 Gigabit Ethernet Switch User’s Guide
3
The switch is also assigned a unique MAC address by the
factory that cannot be changed.
Figure 1-2. Boot Screen
The switch’s MAC address can be found from the console
program under the Switch Information menu item, as shown
below.
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.
By default, an IP interface named System is configured on the
switch and contains all of the ports on the switch. The System
interface can be used initially to assign a range of IP addresses
to the switch. Later, when you configure VLANs and IP
interfaces on the switch, the ports you assign to these VLANs
and IP interfaces will be removed from the System interface.

DGS-3224TGR Layer 2 Gigabit Ethernet Switch User’s Guide
4
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 DGS-
3224TGR:4# −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. Alternaltively, you can enter DGS3224TGR:4# −
enter the commands 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 zrepresents 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.

DGS-3224TGR Layer 2 Gigabit Ethernet Switch User’s Guide
5
Figure 1-3. Assigning the Switch an IP Address
In the above example, the switch was assigned an IP address of
10.24.22.9 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 and the CLI or via the Web-based management agent
using the above IP address to connect to the switch.

DGS-3224TGR Layer 2 Gigabit Ethernet Switch User’s Guide
6
2
USING THE CONSOLE
CLI
The DGS-3224TGR 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.
Switch configuration settings are saved to non-
volatile RAM using 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

DGS-3224TGR Layer 2 Gigabit Ethernet Switch User’s Guide
7
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:

DGS-3224TGR Layer 2 Gigabit Ethernet Switch User’s Guide
8
Figure 2-1. Initial Console Screen
Commands are entered at the command prompt, DGS-
3224TGR: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.

DGS-3224TGR Layer 2 Gigabit Ethernet Switch User’s Guide
9
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.

DGS-3224TGR Layer 2 Gigabit Ethernet Switch User’s Guide
10
Figure 2-3. Example Command Parameter Help
In this case, the command config account was entered with the
parameter <username>. The CLI will then prompt you to enter
the <username> with the message, Next possible
completions:. Every command in the CLI has this feature, and
complex commands have several layers of parameter prompting.
To re-enter the previous command at the command prompt,
press the up arrow cursor key. The previous command will
appear at the command prompt.

DGS-3224TGR Layer 2 Gigabit Ethernet Switch User’s Guide
11
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 <username>, the CLI
returned the Next possible completions: <username> 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.
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.

DGS-3224TGR Layer 2 Gigabit Ethernet Switch User’s Guide
12
Figure 2-5. The Available Commands Prompt
The top-level commands consist of commands like 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.

DGS-3224TGR Layer 2 Gigabit Ethernet Switch User’s Guide
13
Figure 2-6. Next possible completions: Show Command
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.

DGS-3224TGR Layer 2 Gigabit Ethernet Switch User’s Guide
14
3
COMMAND SYNTAX
The following symbols are used in this manual 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 console interface uses the same
syntax.
<angle brackets>
Purpose Encloses a variable or value that must be
specified.
Example Syntax config ipif System ipaddress
<network_address>
Description In the above syntax example, you must
supply the network address in the
<network_address> space. Do not type the
angle brackets.
Example
Command
config ipif System ipaddress
10.24.22.9/255.0.0.0

DGS-3224TGR Layer 2 Gigabit Ethernet Switch User’s Guide
15
[square brackets]
Purpose Encloses a required value or set of required
arguments. One or more values or
arguments can be specified.
Example Syntax create account [admin|user]
Description In the above syntax example, you must
specify either an admin or a user level
account to be created. Do not type the
square brackets.
Example
Command
create account admin
| vertical bar
Purpose Separates two or more mutually exclusive
items in a list −one of which must be
entered.
Example Syntax show snmp [community|trap
receiver|detail]
Description In the above syntax example, you must
specify either community, trap receiver,
or detail. Do not type the vertical bar.
Example
Command
show snmp community

DGS-3224TGR Layer 2 Gigabit Ethernet Switch User’s Guide
16
{braces}
Purpose Encloses an optional value or set of
optional arguments.
Example Syntax config igmp [<ipif_name>|all] {version
<value>|query_interval
<sec>|max_response_time <sec>|
robustness_variable
<value>|last_member_query_interval
<value>|state [enabled|disabled]}
Description In the above syntax example, you must
choose to enter an IP interface name in the
<ipif_name> space or all, but version
<value>, query_interval <sec>,
max_response_time <sec>,
robustness_variable <value>,
last_member_query_interval <value>,
and state [enabled|disabled] are all
optional arguments. You can specify any or
all of the arguments contained by braces.
Do not type the braces.
Example
command
config igmp all version 2
Line Editing Key Usage
Delete Deletes character under the cursor and
then shifts the remaining characters in the
line to the left.
Backspace Delete the character to the left of the cursor
and shifts the remainin
g
characters in the