D-link DGS3100 Reference Guide
D-Link™ DGS-3100 Series
Gigabit Stackable Managed Switch
CLI Manual
V1.00
DGS-3100 Series Gigabit Stackable Managed Switch CLI Manual
Information in this document is subject to change without notice.
© 2007 D-Link Computer Corporation. All rights reserved.
Reproduction in any manner whatsoever without the written permission of D-Link Computer Corporation is
strictly forbidden.
Trademarks used in this text: D-Link and the D-Link logo are trademarks of D-Link Computer Corporation;
Microsoft and Windows are registered trademarks of Microsoft Corporation.
Other trademarks and trade names may be used in this document to refer to either the entities claiming the
marks and names or their products. D-Link Computer Corporation disclaims any proprietary interest in
trademarks and trade names other than its own.
FCC Warning
This equipment has been tested and found to comply with the limits for a Class A digital device, pursuant to Part
15 of the FCC Rules. These limits are designed to provide reasonable protection against harmful interference
when the equipment is operated in a commercial environment. This equipment generates, uses, and can radiate
radio frequency energy and, if not installed and used in accordance with this user’s guide, may cause harmful
interference to radio communications. Operation of this equipment in a residential area is likely to cause harmful
interference in which case the user will be required to correct the interference at his own expense.
CE Mark Warning
This is a Class A product. In a domestic environment, this product may cause radio interference in which case
the user may be required to take adequate measures.
Warnung!
Dies ist ein Produkt der Klasse A. Im Wohnbereich kann dieses Produkt Funkstoerungen verursachen. In
diesem Fall kann vom Benutzer verlangt werden, angemessene Massnahmen zu ergreifen.
Precaución!
Este es un producto de Clase A. En un entorno doméstico, puede causar interferencias de radio, en cuyo case,
puede requerirse al usuario para que adopte las medidas adecuadas.
Attention!
Ceci est un produit de classe A. Dans un environnement domestique, ce produit pourrait causer des
interférences radio, auquel cas l`utilisateur devrait prendre les mesures adéquates.
Attenzione!
Il presente prodotto appartiene alla classe A. Se utilizzato in ambiente domestico il prodotto può causare
interferenze radio, nel cui caso è possibile che l`utente debba assumere provvedimenti adeguati.
VCCI Warning
March 2007
i
DGS-3100 Series Gigabit Stackable Managed Switch CLI Manual
Table of Contents
INTRODUCTION ......................................................................................................................................................1
USING THE CONSOLE CLI.....................................................................................................................................4
COMMAND SYNTAX...............................................................................................................................................8
BASIC SWITCH COMMANDS...............................................................................................................................11
create account...................................................................................................................................................................... 12
config account..................................................................................................................................................................... 12
show account....................................................................................................................................................................... 12
show session........................................................................................................................................................................ 13
show switch......................................................................................................................................................................... 14
show serial_port .................................................................................................................................................................. 14
config serial_port ................................................................................................................................................................ 15
enable clipaging .................................................................................................................................................................. 15
disable clipaging ................................................................................................................................................................. 16
delete account...................................................................................................................................................................... 16
enable web .......................................................................................................................................................................... 17
disable web.......................................................................................................................................................................... 17
save ..................................................................................................................................................................................... 18
reboot .................................................................................................................................................................................. 18
reset..................................................................................................................................................................................... 18
login .................................................................................................................................................................................... 19
logout .................................................................................................................................................................................. 19
ping ..................................................................................................................................................................................... 19
show cpu utilization ............................................................................................................................................................ 20
show configuration.............................................................................................................................................................. 21
enable jumbo_frame............................................................................................................................................................ 21
disable jumbo_frame........................................................................................................................................................... 22
show jumbo_frame.............................................................................................................................................................. 22
locate................................................................................................................................................................................... 22
SWITCH PORT COMMANDS................................................................................................................................24
config ports ......................................................................................................................................................................... 24
show ports ........................................................................................................................................................................... 25
config ports description....................................................................................................................................................... 26
delete ports description ....................................................................................................................................................... 26
show ports description ........................................................................................................................................................ 26
NETWORK MANAGEMENT (SNMP) COMMANDS .............................................................................................28
create snmp user.................................................................................................................................................................. 29
delete snmp user.................................................................................................................................................................. 30
show snmp user................................................................................................................................................................... 30
create snmp view................................................................................................................................................................. 31
delete snmp view................................................................................................................................................................. 31
show snmp view.................................................................................................................................................................. 32
create snmp community ...................................................................................................................................................... 33
delete snmp community ...................................................................................................................................................... 33
show snmp community ....................................................................................................................................................... 34
config snmp engineID......................................................................................................................................................... 34
ii
DGS-3100 Series Gigabit Stackable Managed Switch CLI Manual
show snmp engineID........................................................................................................................................................... 35
create snmp group ............................................................................................................................................................... 35
delete snmp group ............................................................................................................................................................... 37
show snmp groups............................................................................................................................................................... 37
create snmp host.................................................................................................................................................................. 39
delete snmp host.................................................................................................................................................................. 40
show snmp host................................................................................................................................................................... 40
create trusted_host............................................................................................................................................................... 41
show trusted_host................................................................................................................................................................ 41
delete trusted_host............................................................................................................................................................... 42
enable snmp traps................................................................................................................................................................ 42
disable snmp traps............................................................................................................................................................... 43
enable snmp authenticate trap ............................................................................................................................................. 43
disable snmp authenticate trap ............................................................................................................................................ 43
show snmp traps.................................................................................................................................................................. 44
config snmp system_contact ............................................................................................................................................... 44
config snmp system_location.............................................................................................................................................. 45
config snmp system_name.................................................................................................................................................. 45
DOWNLOAD/UPLOAD COMMANDS...................................................................................................................46
download............................................................................................................................................................................. 46
upload.................................................................................................................................................................................. 47
NETWORK MONITORING COMMANDS..............................................................................................................48
show packet ports................................................................................................................................................................ 48
show error ports .................................................................................................................................................................. 49
show utilization................................................................................................................................................................... 50
clear counters ...................................................................................................................................................................... 50
clear log............................................................................................................................................................................... 51
show log.............................................................................................................................................................................. 51
enable syslog....................................................................................................................................................................... 52
disable syslog...................................................................................................................................................................... 52
show syslog......................................................................................................................................................................... 53
create syslog host ................................................................................................................................................................ 53
config syslog host................................................................................................................................................................ 55
delete syslog host ................................................................................................................................................................ 57
show syslog host ................................................................................................................................................................. 58
SPANNING TREE COMMANDS............................................................................................................................59
config stp............................................................................................................................................................................. 59
config stp ports.................................................................................................................................................................... 60
config stp version................................................................................................................................................................ 61
enable stp ............................................................................................................................................................................ 62
disable stp............................................................................................................................................................................ 62
show stp .............................................................................................................................................................................. 63
show stp ports ..................................................................................................................................................................... 64
show stp instance_id ........................................................................................................................................................... 64
show stp mst_config_id ...................................................................................................................................................... 65
config stp instance_id.......................................................................................................................................................... 66
config stp priority................................................................................................................................................................ 67
iii
DGS-3100 Series Gigabit Stackable Managed Switch CLI Manual
config stp mst_config_id..................................................................................................................................................... 67
config stp mst_ports............................................................................................................................................................ 68
FORWARDING DATABASE COMMANDS...........................................................................................................70
create fdb............................................................................................................................................................................. 70
create multicast_fdb ............................................................................................................................................................ 71
config multicast_fdb ........................................................................................................................................................... 71
config fdb aging_time ......................................................................................................................................................... 72
delete fdb............................................................................................................................................................................. 72
clear fdb .............................................................................................................................................................................. 73
show multicast_fdb ............................................................................................................................................................. 73
show fdb.............................................................................................................................................................................. 74
BROADCAST STORM CONTROL COMMANDS.................................................................................................76
config traffic control ........................................................................................................................................................... 76
show traffic control ............................................................................................................................................................. 77
QOS COMMANDS.................................................................................................................................................78
config scheduling ................................................................................................................................................................ 78
show scheduling.................................................................................................................................................................. 79
config 802.1p user_priority................................................................................................................................................. 80
show 802.1p user_priority................................................................................................................................................... 80
config 802.1p default_priority ............................................................................................................................................ 81
show 802.1p default_priority .............................................................................................................................................. 82
config scheduling_mechanism............................................................................................................................................ 82
show scheduling_mechanism.............................................................................................................................................. 83
config rate_limit.................................................................................................................................................................. 84
show rate_limit.................................................................................................................................................................... 84
PORT MIRRORING COMMANDS.........................................................................................................................86
config mirror ....................................................................................................................................................................... 86
delete mirror........................................................................................................................................................................ 87
show mirror......................................................................................................................................................................... 87
VLAN COMMANDS ...............................................................................................................................................88
create vlan ........................................................................................................................................................................... 88
delete vlan ........................................................................................................................................................................... 89
config vlan .......................................................................................................................................................................... 89
config gvrp.......................................................................................................................................................................... 90
enable gvrp.......................................................................................................................................................................... 90
disable gvrp......................................................................................................................................................................... 91
show vlan ............................................................................................................................................................................ 91
show gvrp............................................................................................................................................................................ 92
LINK AGGREGATION COMMANDS ....................................................................................................................93
create link_aggregation ....................................................................................................................................................... 93
delete link_aggregation ....................................................................................................................................................... 94
config link_aggregation ...................................................................................................................................................... 94
show link_aggregation ........................................................................................................................................................ 95
BASIC IP COMMANDS..........................................................................................................................................96
config ipif system................................................................................................................................................................ 96
show ipif.............................................................................................................................................................................. 97
IGMP SNOOPING COMMANDS............................................................................................................................98
iv
DGS-3100 Series Gigabit Stackable Managed Switch CLI Manual
config igmp_snooping......................................................................................................................................................... 98
config router_port ............................................................................................................................................................... 99
enable igmp_snooping ........................................................................................................................................................ 99
disable igmp_snooping ..................................................................................................................................................... 100
show igmp_snooping ........................................................................................................................................................ 100
show igmp_snooping group .............................................................................................................................................. 101
show igmp_snooping forwarding...................................................................................................................................... 101
show router_port ............................................................................................................................................................... 102
802.1X COMMANDS............................................................................................................................................103
enable 802.1x .................................................................................................................................................................... 103
disable 802.1x ................................................................................................................................................................... 104
show 802.1x auth_state ..................................................................................................................................................... 104
show 802.1x auth_configuration....................................................................................................................................... 105
config 802.1x auth_parameter ports.................................................................................................................................. 106
config 802.1x init .............................................................................................................................................................. 107
config 802.1x auth_protocol ............................................................................................................................................. 108
config 802.1x reauth ......................................................................................................................................................... 108
config radius add............................................................................................................................................................... 109
config radius delete ........................................................................................................................................................... 109
config radius...................................................................................................................................................................... 110
show radius ....................................................................................................................................................................... 110
config 802.1x auth_mode.................................................................................................................................................. 111
config guest_vlan .............................................................................................................................................................. 111
config guest_vlan ports ..................................................................................................................................................... 112
show guest_vlan................................................................................................................................................................ 112
PORT SECURITY COMMANDS..........................................................................................................................113
config port_security .......................................................................................................................................................... 113
show port_security ............................................................................................................................................................ 114
TIME AND SNTP COMMANDS...........................................................................................................................115
config sntp......................................................................................................................................................................... 115
show sntp .......................................................................................................................................................................... 116
enable sntp ........................................................................................................................................................................ 116
disable sntp........................................................................................................................................................................ 117
config time date................................................................................................................................................................. 117
config time_zone............................................................................................................................................................... 118
config dst........................................................................................................................................................................... 118
show time.......................................................................................................................................................................... 120
ROUTING TABLE COMMANDS .........................................................................................................................121
create iproute..................................................................................................................................................................... 121
delete iproute..................................................................................................................................................................... 121
show iproute...................................................................................................................................................................... 122
ARP COMMANDS................................................................................................................................................123
create arpentry................................................................................................................................................................... 123
config arpentry.................................................................................................................................................................. 123
delete arpentry................................................................................................................................................................... 124
show arpentry.................................................................................................................................................................... 125
config arp_aging time ....................................................................................................................................................... 125
v
DGS-3100 Series Gigabit Stackable Managed Switch CLI Manual
clear arptable..................................................................................................................................................................... 126
COMMAND HISTORY LIST COMMANDS..........................................................................................................127
?......................................................................................................................................................................................... 127
show command_history .................................................................................................................................................... 128
dir ...................................................................................................................................................................................... 128
config command_history................................................................................................................................................... 129
SSH COMMANDS................................................................................................................................................130
enable ssh.......................................................................................................................................................................... 130
disable ssh ......................................................................................................................................................................... 131
config ssh authmode.......................................................................................................................................................... 131
show ssh authmode ........................................................................................................................................................... 131
config ssh server................................................................................................................................................................ 132
show ssh server ................................................................................................................................................................. 132
show ssh algorithm............................................................................................................................................................ 133
config ssh crypto ............................................................................................................................................................... 133
show ssh crypto................................................................................................................................................................. 134
delete ssh crypto................................................................................................................................................................ 134
SSL COMMANDS................................................................................................................................................136
enable ssl........................................................................................................................................................................... 136
disable ssl.......................................................................................................................................................................... 137
show ssl............................................................................................................................................................................. 137
show ssl cachetimeout....................................................................................................................................................... 138
crypto certificate (generate) .............................................................................................................................................. 138
crypto certificate (request) ................................................................................................................................................ 139
crypto certificate (import) ................................................................................................................................................. 140
config ssl certificate .......................................................................................................................................................... 140
show crypto certificate mycertificate ................................................................................................................................ 141
ACCESS AUTHENTICATION CONTROL COMMANDS....................................................................................142
create authen_login method_list_name............................................................................................................................. 143
config authen_login........................................................................................................................................................... 143
delete authen_login method_list_name............................................................................................................................. 144
show authen_login ............................................................................................................................................................ 145
create authen_enable method_list_name........................................................................................................................... 145
config authen_enable ........................................................................................................................................................ 146
delete authen_enable method_list_name........................................................................................................................... 147
show authen_enable .......................................................................................................................................................... 148
config authen application .................................................................................................................................................. 148
show authen application.................................................................................................................................................... 149
create authen server_host.................................................................................................................................................. 150
config authen server_host ................................................................................................................................................. 151
delete authen server_host.................................................................................................................................................. 152
show authen server_host ................................................................................................................................................... 152
local_enable admin ........................................................................................................................................................... 153
config admin local_enable ................................................................................................................................................ 153
LACP COMMANDS .............................................................................................................................................155
config lacp port_priority ................................................................................................................................................... 155
show lacp .......................................................................................................................................................................... 155
vi
DGS-3100 Series Gigabit Stackable Managed Switch CLI Manual
STACKING COMMANDS ....................................................................................................................................157
config box_id .................................................................................................................................................................... 157
show stack_information .................................................................................................................................................... 157
POE COMMANDS................................................................................................................................................159
config poe.......................................................................................................................................................................... 159
config poe ports................................................................................................................................................................. 160
show poe ........................................................................................................................................................................... 160
ACCESS CONTROL LIST COMMANDS ............................................................................................................162
create access_profile (Ethernet) ........................................................................................................................................ 162
create access_profile (IP) .................................................................................................................................................. 163
config access_profile (Ethernet) ....................................................................................................................................... 164
config access_profile (IP) ................................................................................................................................................. 166
config access_profile......................................................................................................................................................... 168
delete access_profile ......................................................................................................................................................... 168
show access_profile .......................................................................................................................................................... 169
TRAFFIC SEGMENTATION COMMANDS..........................................................................................................171
config traffic_segmentation .............................................................................................................................................. 171
show traffic_segmentation ................................................................................................................................................ 171
DEVICE SPECIFICATIONS.................................................................................................................................173
vii
1
INTRODUCTION
The DGS-3100 is a member of the D-Link DGS-3100 switch family. The DGS 3100 product range consists of 24
/ 48 -port 10/100/1000Base-T PoE / NonPoE L2 Stackable Management Switches with 4 Combo SFPs.
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. For detailed information on
installing hardware please refer also to the Manual.
Accessing the Switch via the Serial Port
The Switch’s serial port’s default settings are as follows:
• 9600 bps
• 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
The initial username is admin (lower case). Press the Enter key twice to display the CLI input cursor. 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.
1
DGS-3100 Gigabit Ethernet Switch Manual
Figure 1–2. Boot Screen
The Switch’s MAC address can also be found in the Web management program on the Device Information
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 vlan default 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 and subnet mask which can then
be used to connect a management s d management agent.
Switch can be assigned an IP address
tation to the Switch’s Telnet or Web-base
Figure 1–3. Assigning an IP Address
In the above example, the Switch was assigned an IP address of 10.53.13.26 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
2 3
configured and managed via Telnet, SNMP MIB browser and the CLI or via the Web-based manage agent
using the above IP address to connect to the Switch.
NOTE: The DGS-3100 series of switches have the pability to be config d for an IP addre
of 0.0.0.0, or, in essence, have no IP address. Th
functions of the Switch. When the IP address is s
only be managed through the console port or SIM. Other management applications such as
Telnet, Web-based and SNMP cannot be used to manage the Switch when its IP address is
0.0.0.0.
ca ure ss
is function maybe used to disable Layer 3
et to 0.0.0.0 (invalid IP address), the Switch can
ment
DGS-3100 Gigabit Ethernet Switch 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 (for example, the HyperTerminal program included with the Windows
operating system) using an RS-232C serial cable.
• VT-100 compatible
• 9600 bps
• 8 data bits
• No parity
• One stop bit
• No flow control
Users may 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-10
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:
Your terminal parameters will need to be set to:
0 compatible terminal mode) to access and control the Switch.
Figure 2–1. Initial Console Screen after Logging In
4
Commands are entered at the command prompt, DGS3100#.
There are a number of helpful features ommand will display a list of all of the included in the CLI. Entering the ? c
top-level commands.
Figure 2–2. The ? Command
When entering a comma rompt: command: config nd without its required parameters, the CLI displays the p
account message and the options listed below.
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 to enter the <username> with the message, command: config account. 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, users can see all of the next possible subcommands, in sequential order, by pressing the ? key.
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.
5
DGS-3100 Gigabit Ethernet Switch Manual
Figure
2–4. Using the Up Arrow to Re-enter a Command
In the above rameter <username>,
the CLI returned the command: l key was pressed to re-enter
the previou config a be entered
and the con ommand
All command function in this way. In additi the help prompts are the same as
presented in this manual angle lue or character string. The < > can also
indicate a W mber fo character allowed.
a command is entered that is unrecognized by the CLI, the top-level commands will be displayed under the
If
Available c
example, the command config account was entered without the required pa
config account prompt. The up arrow cursor contro
s command (
fig account c
s in the CLI
ccount) at the command prompt. Now the appropriate username can
re-executed.
on, the syntax of
brackets < > indicate a numerical va
ord with nu
ommands: prompt.
Figure 2–5. Available Commands
The top-level ands consist of co commands require one or
more param narrow the t t? or config what? Where the
what? is the
For example, entering the show meters, the CLI will then display all of the
possible next para
comm
eters to
next parameter.
meters.
mmands such as show or config. Most of these
op-level command. This is equivalent to show wha
command with no additional para
6
Figure 2–6. Next possible completions: Show Command
In the above meters for the show command are displayed. At the next
command w was used to re-enter the show command, followed by the
example, all of the possible next para
prompt in the example, the up arro
account parameter. The CLI then displays the user accounts configured on the Switch.
7
DGS-3100 Gigabit Ethernet Switch 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 console interface uses
the same syntax.
NOTE: All commands are case-sensitive. Be sure to disable Caps Lock or any other unwanted
function that changes text case.
<angle brackets>
Purpose Encloses a variable or value that must be specified.
Syntax
Description In the above syntax example, users must supply a username in the
Example
Command
create account [admin | user] <username 15>
<username> space. Do not type the angle brackets.
create account admin newadmin1
[square brackets]
Purpose Encloses a required value or set of required arguments. One value
or argument can be specified.
Syntax
Description In the above syntax example, you must specify either an admin or a
Example
Command
create account [admin | user] <username 15>
user level account to be created. Do not type the square brackets.
create account user newuser1
| vertical bar
Purpose Separates two or more mutually exclusive items in a list, one of
which must be entered.
Syntax
Description In the above syntax example, users must specify either admin, or
Example
Command
All commands are case-sensitive. Be sure to disable Caps Lock or any other unwanted function that changes
text case.
create account [admin | user] <username 15>
user. Do not type the vertical bar.
create account user newuser1
8
{braces}
Purpose Encloses an optional value or set of optional arguments.
Syntax reset {[config | system]}
Description In the above syntax example, users have the option to specify config
or system. It is not ne
however the effect of the system
value is specified. Therefore, with this example there are three
possible outcomes of performing a
chapter, Basic Com
command.
Example reset config
command
cessary to specify either optional value,
reset is dependent on which, if any,
system reset. See the following
mands for more details about the reset
Line Editing Key Usage
Delete Deletes the character under the cursor and then shifts the
remaining characters in the line to the left.
Backspace Deletes the character to the left of the cursor and then shifts the
remaining characters in the line to the left.
Insert or Ctrl+R Toggle on and off. When toggled on, inserts text and shifts previous
text to the right.
Left Arrow Moves the cursor to the left.
Right Arrow Moves the cursor to the right.
Up Arrow Repeats the previously entered command. Each time the up arrow
is pressed, the command previous to that displayed appears. This
way it is possible to review
session. Us
through the command history list.
Down Arrow The down arrow will display the next command in the command
history entered in the current session. This displays each command
sequentially as it was entered. Use the up arrow to review previous
commands.
Tab Shifts the cursor to the next field to the left.
e the down arrow to progress sequentially forward
the command history for the current
Multiple Pag ntrol Keys e Display Co
Space Displays the next page.
CTRL+c Stops the display of remaining pages when multiple pages are to be
displayed.
ESC Stops the display of remaining pages when multiple pages are to be
displayed.
n Displays the next page.
p Displays the previous page.
9
DGS-3100 Gigabit Ethernet Switch Manual
q s the display of remaining pages when multiple pages are to be
Stop
disp
layed.
r Re y displayed. freshes the pages currentl
a Displays the remaining pages without pausing between pages.
Enter Displays the next line or table entry.
10
4
SWITCH COMMANDS BASIC
The Basic S nds in mand Line Interface (CLI) are listed (along with the appropriate
parameters) in the following table.
witch comma the Com
Command Parameter
create account [admin | user] <username 15>
config account <username 15>
show account
show session
show switch
show serial_port
config serial_port
enable clipaging
disable clipaging
delete acc <userount name 15>
enable we <tcp_p 5535> b ort_number 1-6
{baud_ra
10_minutes | 15_minutes]}
te [9600 | 19200 | 38400] auto_logout [never | 2_minutes | 5_minutes|
disable web
save
reboot <box_id 1-6>
reset
login
logout
ping es <value 1-255>} {timeout <sec 1-99>} <ipaddr> {tim
show cpu utilization
show configuration [running | startup]
enable jumbo_frame
disable jumbo_frame
show jumbo_frame
locate
Each command is listed in detail, as follows:
11
DGS-3100 Gigabit Ethernet Switch Manual
create account
Purpose To create user accounts.
Syntax
Description
Parameters admin − creates an administrator account.
Restrictions Only Administrator-level users can issue this command.
Example usage:
To create an administrator-level user account with the username “dlink”:
create account [admin | user] <username 15>
The create account command creates an administrator or user
account that consists of a username and an optional password. Up
to 31 accounts can be created. The system prompts for the
account’s password, which may be between 0 and 15 characters.
user −
<userna
15 characters.
DGS3100# create account admin dlink
Enter a case-sensitive password:****
Enter the password again for confirm
Success.
DGS3100#
creates a user account.
me 1-15> − The account username may be between 1 and
ation:****
config account
Purpose ccount. To change the password for an existing user a
Syntax
Description mmand changes the password for a user
Parameters sername. <username 1-15> − the account u
Restrictions ly Administrator-level users can issue this command. On
Example usage:
To configure the user password of “dlink” account:
config account <usern
The config account co
account that has been c
The system prompts for
between 0 and 15 chara
DGS3100# co
Enter a case-s
Enter the **
Succes
DGS3 #
100
nfig account dlink
ensitive new password:****
new password again for confirmation:**
s.
ame 15>
reated using the create account command.
the account’s new password, which may be
cters.
show account
Purpose n about all user accounts on the Switch. To display informatio
12
Syntax
Description ount command displays all account usernames and
Parameters None.
Restrictions None.
Example usage:
To display the accounts that have been created:
show account
The show acc
their access
can exist on the
DGS3100# show account
Username
------------ Dlin
adm
Total Ent
DGS3
----------- -------------------k User
in Admin
ries: 2
100
#
levels created on the Switch. Up to 31 user accounts
Access Level
Switch at one time.
show session
Purpose To display information about currently logged-in users.
Syntax
Description and displays a list of all the users that are
Parameters None.
Restrictions None.
Example usage:
To display the way
show session
The show session comm
logged-in at the time the command is issued. The information
includes the session ID (0 for the first logge
logged-in user, etc.), the Protocol used to connect to the Switch, the
user’s IP address, the user’s access Level (1=user, 15=admin), and
the account name on the S
users logged in:
DGS3100#
ID Pr
------- ------------------- ------ --------------- -------- ---------------- 0 HTTP 10.6.10.43 15 admin
1 HTTP
2 Tel
DGS3100
show session
otocol From Level Name
10.6.10.43 15 admin
net 10.6.60.13 15 admin
#
witch.
d-in user, 1 for the next
13
DGS-3100 Gigabit Ethernet Switch Manual
show switch
Purpose To display information about the Switch.
Syntax
Description The show switch command displays information about the Switch
Parameters None.
Restrictions None.
Example usage:
To display the Switch n:
show switch
settings, including Device Type, MAC Address, IP configurat
Hardware/Software version, System information, and Sw
Network configuratio
informatio
DGS3100# show switch
Device Type
MAC Add
IP Addres
VLAN Na : default
Subnet M 55.255.224
De ateway : 10.6.41.97
fault G
Boot PRO
Firmware
Hardware
S
ystem Name : DGS-3100
Sy ocation : 7th_flr_east_cabinet
stem L
System Contact : Julius_Erving_212-555-6666
Spanning Tree : Enabled
GVRP : Disable
IG
MP Snooping : Disabled
TELNET
W
EB
DGS3100#
: DGS-3100 Gigabit-Ethernet Switch
ress : DA-10-21-00-00-01
s : 10.6.41.104
me
ask : 255.2
M Version : 1.0.0.03
Version : 1.00.29
Version : 00.00.01
: Enabled
: Enabled (TCP 80)
n.
d
ion,
itch
show serial_port
Purpose To display the current serial port settings.
Syntax
Description The show serial_port command displays the current serial port
Parameters None.
Restrictions None.
Example usage:
To display the serial port settings:
show serial_port
settings.
DGS3100# show serial_port
14
Baud Rate : 9600
D
ata Bits : 8
Parity Bits
S
top Bits : 1
Auto-Logou
DGS3100#
: None
t : 10 mins
config serial_port
Purpose To configure the serial port.
Example usa
To co e baud rate:
Syntax
Description The show serial_port command configures the serial port’s baud
Parameters − The serial bit rate used to
Restrictions Only administrator-level users can issue this command.
ge:
nfigure th
config serial_port {baud_rate [9600 | 19200 | 38400] auto_logou t
[never | 2_minutes | 5_minutes| 10_minutes |
rate and auto logout settings.
baud rate [9600 | 19200 | 38400]
communicate with the management host.
auto_logout - The amount of time the Switch’s serial port can be idle
before automatically logging out. The possible v
never − There is no time limit on the length of
be open with no us
2_minutes − The console will log out the current user if there is no
r input for 2 minutes.
use
5_minutes − The console will log out the current user if there is no
er input for 5 minutes.
us
10_minutes − The console will log out the current user if there is no
user input for 10 minutes.
15_minutes − The console will log out the current user if there is no
user input for 15 minutes.
er input.
15_minutes]}
alues are:
time the console can
DGS3100
Succes
DGS3100#
# config serial_port baud_rate 9600
s.
enable clipaging
Purpose To pause the scrolling of the console screen after each page when a
sh
ow command displays more than one page.
Syntax
Description The enable clipaging command pauses the scrolling of the console
enable clipaging
screen at the end of each page when issuing a command which
15
DGS-3100 Gigabit Ethernet Switch Manual
would display more than one screen of information. The default
setting is enabled.
Parameters None.
Restrictions Only dministrator-level users can issue this command. a
Example usa
To enable pausing of the scree
ge:
n display when the show command output reaches the end of the page:
100 e clipaging
DGS3 # enabl
Succes
DGS3100#
s.
disable clipaging
Purpose disable the pausing of the console screen scrolling at the end of
Syntax
Description The disable clipaging command disables the pausing of the
Parameters None.
To
each page when the command displays more than one screen of
information.
disable clipaging
console screen at the end of each page when issuing a command
which would display more than one screen of information. This
causes the console screen to rapidly scroll through several pages.
Example usa
To di f the scre :
Example usa
To delete
Restrictions Only administrator-level users can issue this command.
ge:
sable pausing o en display when a command output reaches the end of the page
DGS3100# disable clipaging
Success
GS3100#
D
.
delete account
Purpose To delete an existing user account.
Syntax
Description The delete account command deletes a user account that has been
Parameters
Restrictions
ge:
the user account “System”:
delete account <username 15>
created using the create account command.
<username 1-15> − the account username.
Only Administrator-level users can issue this command.
DGS3100# delete account System
16
A
re you sure to delete the last administrator account?(y/n)
Success.
DGS3100#
enable web
Purpose To enable the HTTP-based management software on the Switch.
Syntax
Description The enable web command enables the Web-based management
Parameters <tcp_port_number 1-65535> − The TCP port number. TCP ports are
Restrictions Only administrator-level users can issue this command.
Example usage:
To enable HTTP a figure the TCP port number to listen for Telnet requests:
disable web
Purpose P-based management software on the Switch. To disable the HTT
nd con
DGS3100# e
Success.
DGS3100#
enable web <tcp_port_number 1-65535>
software on the Switch. The user can specify the T
the Swi
numbered between 1 and 65535. The “well-known” port for the Webbased management software is 80.
tch will use to listen for Telnet requests.
nable web 80
CP port number
Syntax
Description The disable web command disables the Web-based management
Parameters None.
Restrictions Only inistrator-level users can issue this command. adm
Example usage:
To disable HTTP-based management software on the Switch:
disable web
software on the Switch.
DGS3100# disable web
Success.
DGS3 #
100
17
DGS-3100 Gigabit Ethernet Switch Manual
save
Purpose To save changes in the Switch’s configuration to non-volatile RAM.
Exampl
Syntax
Description The save command saves the current switch configuration to non-
Parameters None.
Restrictions Only administrator-level users can issue this command.
e usage:
To save the Switch M:
’s current configuration to non-volatile RA
DGS3100# save
Saving all configurations to NV-RAM... Done.
DGS3100#
save
volatile RAM. The saved switch configuration will be loaded into the
Switch’s memory each time the Switch is restarted.
reboot
Purpose To restart the Switch. If the Switch is a member of a stack, it may be
rebooted individually, without affecting the other members of the
stack.
Syntax
Description The reboot command restarts the Switch.
Parameters ox_id 1-6> − The unit’s current stack membership number. <b
Restrictions Only Administrator-level users can issue this command.
Example usage:
start the Switch unit 1: To re
reset
Purpose To reset the Switch to the factory default settings.
Syntax
Description The reset command restores the Switch’s configuration to the
Parameters None.
DGS3100
DGS3100
reboot <box_id 1-6>
# reboot 1
#
reset
default settings assigne
command through
membership number.
the CLI retains the unit’s current stack
d from the factory. Execution of the reset
Restrictions Only ministrator-level users can issue this command. ad
Example usage:
To restore all of th eters to their default values: e Switch’s param
18
DGS3100# reset
Are you sure to p
Success.
DGS3100
#
roceed with system reset?(y/n)
login
Purpose To log in a user to the Switch’s console.
Example usa
To in e:
Syntax
Description The login command initiates the login procedure. The user is
Parameters None.
Restrictions None.
ge:
itiate the login procedur
DGS
UserName:
login
prompted for
3100# login
the Username and Password.
logout
Purpose To log out a user from the Switch’s console.
Syntax
Description The logout command terminates the current user’s session on the
Logout
Switch’s console.
Example usa
To te e current user’
Parameters None.
Restrictions None.
ge:
rminate th s console session:
100
DGS3 # logout
ping
Purpose To test the connectivity between network devices.
Syntax
Description The ping command sends Internet Control Message Protocol
ping <ipaddr> {times <v
(ICMP)
address will then “echo
confirm connectivity between the Switch and the remote device.
echo messages to a remote IP address. The remote IP
alue 1-255>} {timeout <sec 1-99>}
” or return the message. This is used to
19
DGS-3100 Gigabit Ethernet Switch Manual
Parameters <ipaddr> - The IP address of the host.
times <value 1-255> - The number of individual ICMP echo
messages
Pinging an
target device an infinite number of times.
timeout <sec 1-99> -
response from the remo
specified. The default is 1 second.
Restrictions None.
to be sent. The maximum value is 255. The default is 0.
IP address without the times parameter will ping the
The time-out period while waiting for a
te device. A value of 1 to 99 seconds can be
Example usa
To pi ss 10.6.15 e times:
ge:
ng the IP addre 0.34 thre
DGS3100# ping 10.6.150.34 times 3
Pinging
6 bytes from 10.6.150.34: icmp_seq=1. time=0 ms
5
56 bytes fr
5
6 bytes from 10.6.150.34: icmp_seq=3. time=0 ms
----10.6.150.34 PING Statistics---3 packets transmitted, 3 packets received, 0% packet loss
round-trip (ms) m
Succes
DGS3 #
10.6.150.34 with 56 bytes of data:
om 10.6.150.34: icmp_seq=2. time=0 ms
s.
100
in/avg/max = 0/0/0
show cpu utilization
Purpose tion. To measure CPU utiliza
Syntax
Description lization command displays information about
Parameters None.
Restrictions None.
Example usage:
To show CPU utilization information:
show cpu utilization
The show cpu uti
CPU utilization.
DGS3100# show cpu utilization
CPU utilization service is on.
CPU utili
-------------five seco
DGS3100
zation
-------nds:2% ;one minute:1% ;five minutes:1%
#
20
show configuration
Purpose To display the current or saved version of the configuration settings
of the Sw
itch.
Syntax
Description The show configuration command displays the current or saved
Parameters running – Displays the current configuration.
Restrictions None.
Example usage:
To show current configuration information:
DGS3100# show configuration running
config snmp system_name DGS-3100
create vlan 2 tag 2
enable 802.1x
config 802.1x auth_protocol radius
config radius add 10.6.41.226 key 123456 auth_port 1812 acct_port 1813 priori
ty first
config ports (1-2,4-7) enable_reauth enable
config ports 3 port_control auto enable_reauth enable
config 802.1x auth_mode ports (1-7) mac_based
config guest_vlan 2 state enable
config guest_vlan ports 3
config ipif system dhcp
DGS3100#
show configuration [running | startup]
rsion of the configuration settings of the Switch.
ve
startup – Displays the configuration saved in NV-RAM.
enable jumbo_frame
Purpose To enable jumbo frames on the device.
Syntax
Description The enable jumbo_frame command enables jumbo frames on the
Parameters None.
Restrictions None.
Example usage:
To enable jumbo frames:
enable jumbo_frame
device.
DGS3100# enable jumbo_frame
Success.
DGS3100#
21
DGS-3100 Gigabit Ethernet Switch Manual
disable jumbo_frame
Purpose To disable jumbo frames on the device.
Syntax
Description The disable jumbo_frame command disables jumbo frames on the
Parameters None.
Restrictions None.
Ex
ample usage:
To disable jumbo_fram
show jumbo_frame
Purpose To display the jumbo frame configuration.
Syntax
Description e The show jumbo_frame command displays the jumbo fram
disable jumbo_frame
device.
es:
DG ble jumbo_frame
S3100# disa
c
Su cess.
S3100#
G
D
show jumbo_frame
configuration.
Example usa
To show the jumbo_frames co
Parameters None.
Restrictions None.
ge:
nfiguration status on the device:
DGS3100
Jumbo frame r
Jumbo frames w
DGS3100#
# show jumbo_frame
s a e disabled.
ill be enabled after save and restart.
locate
Purpose To enable the user to locate the device he is working on.
Syntax
Description The cate command causes the seven segment display of the
locate
lo
currently active switch with Master ID to blink the lett
seconds.
er L for 20
22
Loading...