DGS-3212SR
Command Line Interface Reference Manual
First Edition (August 2003)
………….
DGS-3212SR Switch CLI Reference
Wichtige Sicherheitshinweise
1.Bitte lesen Sie sich diese Hinweise sorgfältig durch.
2.Heben Sie diese Anleitung für den spätern Gebrauch auf.
3.Vor jedem Reinigen ist das Gerät vom Stromnetz zu trennen. Vervenden Sie keine Flüssigoder Aerosolreiniger. Am besten dient ein angefeuchtetes Tuch zur Reinigung.
4.Um eine Beschädigung des Gerätes zu vermeiden sollten Sie nur Zubehörteile verwenden, die vom Hersteller zugelassen sind.
5.Das Gerät is vor Feuchtigkeit zu schützen.
6.Bei der Aufstellung des Gerätes ist auf sichern Stand zu achten. Ein Kippen oder Fallen könnte Verletzungen hervorrufen. Verwenden Sie nur sichere Standorte und beachten Sie die Aufstellhinweise des Herstellers.
7.Die Belüftungsöffnungen dienen zur Luftzirkulation die das Gerät vor Überhitzung schützt. Sorgen Sie dafür, daß diese Öffnungen nicht abgedeckt werden.
8.Beachten Sie beim Anschluß an das Stromnetz die Anschlußwerte.
9.Die Netzanschlußsteckdose muß aus Gründen der elektrischen Sicherheit einen Schutzleiterkontakt haben.
10.Verlegen Sie die Netzanschlußleitung so, daß niemand darüber fallen kann. Es sollete auch nichts auf der Leitung abgestellt werden.
11.Alle Hinweise und Warnungen die sich am Geräten befinden sind zu beachten.
12.Wird das Gerät über einen längeren Zeitraum nicht benutzt, sollten Sie es vom Stromnetz trennen. Somit wird im Falle einer Überspannung eine Beschädigung vermieden.
13.Durch die Lüftungsöffnungen dürfen niemals Gegenstände oder Flüssigkeiten in das Gerät gelangen. Dies könnte einen Brand bzw. Elektrischen Schlag auslösen.
14.Öffnen Sie niemals das Gerät. Das Gerät darf aus Gründen der elektrischen Sicherheit nur von authorisiertem Servicepersonal geöffnet werden.
15.Wenn folgende Situationen auftreten ist das Gerät vom Stromnetz zu trennen und von einer qualifizierten Servicestelle zu überprüfen:
16.Netzkabel oder Netzstecker sint beschädigt.
17.Flüssigkeit ist in das Gerät eingedrungen.
18.Das Gerät war Feuchtigkeit ausgesetzt.
19.Wenn das Gerät nicht der Bedienungsanleitung ensprechend funktioniert oder Sie mit Hilfe dieser Anleitung keine Verbesserung erzielen.
20.Das Gerät ist gefallen und|oder das Gehäuse ist beschädigt.
21.Wenn das Gerät deutliche Anzeichen eines Defektes aufweist.
22.Bei Reparaturen dürfen nur Orginalersatzteile bzw. den Orginalteilen entsprechende Teile verwendet werden. Der Einsatz von ungeeigneten Ersatzteilen kann eine weitere Beschädigung hervorrufen.
23.Wenden Sie sich mit allen Fragen die Service und Repartur betreffen an Ihren Servicepartner. Somit stellen Sie die Betriebssicherheit des Gerätes sicher.
24.Zum Netzanschluß dieses Gerätes ist eine geprüfte Leitung zu verwenden, Für einen Nennstrom bis 6A und einem Gerätegewicht grőßer 3kg ist eine Leitung nicht leichter als H05VV-F, 3G, 0.75mm2 einzusetzen.
ii
DGS-3212SR Switch CLI Reference
WARRANTIES EXCLUSIVE
IF THE D-LINK PRODUCT DOES NOT OPERATE AS WARRANTED ABOVE, THE CUSTOMER'S SOLE REMEDY SHALL BE, AT D-LINK'S OPTION, REPAIR OR REPLACEMENT. THE FOREGOING WARRANTIES AND REMEDIES ARE EXCLUSIVE AND ARE IN LIEU OF ALL OTHER WARRANTIES, EXPRESSED OR IMPLIED, EITHER IN FACT OR BY OPERATION OF LAW, STATUTORY OR OTHERWISE, INCLUDING WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. D-LINK NEITHER ASSUMES NOR AUTHORIZES ANY OTHER PERSON TO ASSUME FOR IT ANY OTHER LIABILITY IN CONNECTION WITH THE SALE, INSTALLATION MAINTENANCE OR USE OF D-LINK'S PRODUCTS
D-LINK SHALL NOT BE LIABLE UNDER THIS WARRANTY IF ITS TESTING AND EXAMINATION DISCLOSE THAT THE ALLEGED DEFECT IN THE PRODUCT DOES NOT EXIST OR WAS CAUSED BY THE CUSTOMER'S OR ANY THIRD PERSON'S MISUSE, NEGLECT, IMPROPER INSTALLATION OR TESTING, UNAUTHORIZED ATTEMPTS TO REPAIR, OR ANY OTHER CAUSE BEYOND THE RANGE OF THE INTENDED USE, OR BY ACCIDENT, FIRE, LIGHTNING OR OTHER HAZARD.
LIMITATION OF LIABILITY
IN NO EVENT WILL D-LINK BE LIABLE FOR ANY DAMAGES, INCLUDING LOSS OF DATA, LOSS OF PROFITS, COST OF COVER OR OTHER INCIDENTAL, CONSEQUENTIAL OR INDIRECT DAMAGES ARISING OUT THE INSTALLATION, MAINTENANCE, USE, PERFORMANCE, FAILURE OR INTERRUPTION OF A D- LINK PRODUCT, HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY. THIS LIMITATION WILL APPLY EVEN IF D-LINK HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
IF YOU PURCHASED A D-LINK PRODUCT IN THE UNITED STATES, SOME STATES DO NOT ALLOW THE LIMITATION OR EXCLUSION OF LIABILITY FOR INCIDENTAL OR CONSEQUENTIAL DAMAGES, SO THE ABOVE LIMITATION MAY NOT APPLY TO YOU.
Limited Warranty Hardware:
D-Link warrants each of its hardware products to be free from defects in workmanship and materials under normal use and service for a period commencing on the date of purchase from D-Link or its Authorized Reseller and extending for the length of time stipulated by the Authorized Reseller or D-Link Branch Office nearest to the place of purchase.
This Warranty applies on the condition that the product Registration Card is filled out and returned to a D-Link office within ninety (90) days of purchase. A list of D-Link offices is provided at the back of this manual, together with a copy of the Registration Card.
If the product proves defective within the applicable warranty period, D-Link will provide repair or replacement of the product. D-Link shall have the sole discretion whether to repair or replace, and replacement product may be new or reconditioned. Replacement product shall be of equivalent or better specifications, relative to the defective product, but need not be identical. Any product or part repaired by D-Link pursuant to this warranty shall have a warranty period of not less than 90 days, from date of such repair, irrespective of any earlier expiration of original warranty period. When D-Link provides replacement, then the defective product becomes the property of D-Link.
Warranty service may be obtained by contacting a D-Link office within the applicable warranty period, and requesting a Return Material Authorization (RMA) number. If a Registration Card for the product in question has not been returned to D-Link, then a proof of purchase (such as a copy of the dated purchase invoice) must be provided. If Purchaser's circumstances require special handling of warranty correction, then at the time of requesting RMA number, Purchaser may also propose special procedure as may be suitable to the case.
After an RMA number is issued, the defective product must be packaged securely in the original or other suitable shipping package to ensure that it will not be damaged in transit, and the RMA number must be prominently marked on the outside of the package. The package must be mailed or otherwise shipped to D-Link with all costs of mailing|shipping|insurance prepaid. D-Link shall never be responsible for any software, firmware, information, or memory data of Purchaser contained in, stored on, or integrated with any product returned to D-Link pursuant to this warranty.
Any package returned to D-Link without an RMA number will be rejected and shipped back to Purchaser at Purchaser's expense, and D-Link reserves the right in such a case to levy a reasonable handling charge in addition mailing or shipping costs.
iii
DGS-3212SR Switch CLI Reference
Software:
Warranty service for software products may be obtained by contacting a D-Link office within the applicable warranty period. A list of D-Link offices is provided at the back of this manual, together with a copy of the Registration Card. If a Registration Card for the product in question has not been returned to a D-Link office, then a proof of purchase (such as a copy of the dated purchase invoice) must be provided when requesting warranty service. The term "purchase" in this software warranty refers to the purchase transaction and resulting license to use such software.
D-Link warrants that its software products will perform in substantial conformance with the applicable product documentation provided by D-Link with such software product, for a period of ninety (90) days from the date of purchase from D-Link or its Authorized Reseller. D-Link warrants the magnetic media, on which D-Link provides its software product, against failure during the same warranty period. This warranty applies to purchased software, and to replacement software provided by D-Link pursuant to this warranty, but shall not apply to any update or replacement which may be provided for download via the Internet, or to any update which may otherwise be provided free of charge.
D-Link's sole obligation under this software warranty shall be to replace any defective software product with product which substantially conforms to D-Link's applicable product documentation. Purchaser assumes responsibility for the selection of appropriate application and system|platform software and associated reference materials. D-Link makes no warranty that its software products will work in combination with any hardware, or any application or system|platform software product provided by any third party, excepting only such products as are expressly represented, in D-Link's applicable product documentation as being compatible. D-Link's obligation under this warranty shall be a reasonable effort to provide compatibility, but D-Link shall have no obligation to provide compatibility when there is fault in the third-party hardware or software. D-Link makes no warranty that operation of its software products will be uninterrupted or absolutely errorfree, and no warranty that all defects in the software product, within or without the scope of D-Link's applicable product documentation, will be corrected.
D-Link Offices for Registration and Warranty Service
The product's Registration Card, provided at the back of this manual, must be sent to a D-Link office. To obtain an RMA number for warranty service as to a hardware product, or to obtain warranty service as to a software product, contact the D-Link office nearest you. An address|telephone|fax|e-mail|Web site list of D-Link offices is provided in the back of this manual.
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.
iv
DGS-3212SR Switch CLI Reference
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.
VCCI Warning
v
|
Table of Contents |
Introduction ............................................................................................... |
1 |
Using the Console CLI .............................................................................. |
3 |
Command Syntax ..................................................................................... |
7 |
Basic Switch Commands .......................................................................... |
9 |
Switch Port Commands .......................................................................... |
30 |
SNMP Commands .................................................................................. |
35 |
Download|Upload Commands ................................................................ |
70 |
Network Monitoring Commands ............................................................. |
73 |
MAC Notification ..................................................................................... |
89 |
Spanning Tree Commands..................................................................... |
96 |
Forwarding Database Commands ........................................................ |
105 |
Broadcast Storm Control Commands ................................................... |
115 |
QOS Commands................................................................................... |
118 |
802.1X COMMANDS ............................................................................ |
127 |
Access Control List (ACL) Commands ................................................. |
142 |
Traffic Segmentation............................................................................. |
151 |
Stacking ................................................................................................ |
154 |
Port Mirroring Commands..................................................................... |
157 |
VLAN Commands ................................................................................. |
163 |
Link Aggregation Commands ............................................................... |
173 |
IP Interface Commands ........................................................................ |
180 |
Routing Table Commands .................................................................... |
183 |
IGMP Snooping Commands ................................................................. |
187 |
Command History List........................................................................... |
197 |
Technical Specifications ....................................................................... |
202 |
DGS-3212SR Switch CLI Reference
1
INTRODUCTION
The switch can be managed through the switch’s serial port, Telnet, or the Webbased 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.
The switch’s serial port’s default settings are as follows:
•9600 baud
•no parity
•8 data bits
•1 stop bit
A computer running a terminal emulation program capable of emulating a VT-100 terminal and a serial port configured as above is then connected to the switch’s serial port via an RS-232 DB-9 cable.
With the serial port properly connected to a management computer, the following screen should be visible. If this screen does not appear, try pressing Ctrl+r to refresh the console screen.
Figure 1-1. Initial Console screen.
There is no initial username or password. Just press the Enter key twice to display the CLI input cursor − DGS-3212SR:4#. This is the command line where all commands are input.
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 from the initial boot console screen
– shown below.
1
DGS-3212SR Switch CLI Reference
Figure 1-2. Boot Screen
The switch’s MAC address can also be found from 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 Webbased 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:
Starting at the command line prompt, enter the commands config ipif System ipaddress xxx.xxx.xxx.xxx|yyy.yyy.yyy.yyy. Where the x’s represent the IP address to be assigned to the IP interface named System and the y’s represent the corresponding subnet mask.
Alternatively, you can enter config ipif System ipaddress xxx.xxx.xxx.xxx/z. Where the x’s represent the IP address to be assigned to the IP interface named System and the z represents the corresponding number of subnets in CIDR notation.
Introduction
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.
Figure 1-3. Assigning the Switch an IP Address
In the above example, the switch was assigned an IP address of 10.42.73.100 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.
2
DGS-3212SR Switch CLI Reference
|
|
• |
VT-100 compatible |
|
|
2 |
|||
|
• |
9,600 baud |
||
|
|
• |
8 data bits |
|
USING THE CONSOLE CLI |
||||
• |
No parity |
|||
The DGS-3212SR supports a console management interface that allows the user |
• |
One stop bit |
||
• |
No flow control |
|||
to connect to the switch’s management agent via a serial port and a terminal or a |
||||
You can also access the same functions over a Telnet interface. Once you have set |
||||
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 |
an IP address for your Switch, you can use a Telnet program (in VT-100 |
|||
used to configure the switch to use an SNMP-based network management |
compatible terminal mode) to access and control the Switch. All of the screens are |
|||
software over the network. |
identical, whether accessed from the console port or from a Telnet interface. |
|||
This chapter describes how to use the console interface to access the switch, |
After the switch reboots and you have logged in, the console looks like this: |
|||
change its settings, and monitor its operation. |
|
|
Note: 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.
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.
Figure 2-1. Initial Console Screen
Commands are entered at the command prompt, DGS-3212SR:4#.
Your terminal parameters will need to be set to:
Using the Console CLI |
3 |
DGS-3212SR Switch CLI Reference
There are a number of helpful features included in the CLI. Entering the ? command will display a list of all of the top-level commands.
Figure 2-2. The ? Command
The dir command has the same function as the ? command.
When you enter a command without its required parameters, the CLI will prompt you with a Next possible completions: message.
Using the Console CLI
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.
In addition, after typing any given command plus one space, you can see all of the next possible sub-commands, in sequential order, by repeatedly pressing the Tab key.
To re-enter the previous command at the command prompt, press the up arrow cursor key. The previous command will appear at the command prompt.
4
DGS-3212SR Switch CLI Reference
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 reexecuted.
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.
Using the Console CLI
Figure 2-5. The Next 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.
5
DGS-3212SR Switch CLI Reference
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.
Using the Console CLI |
6 |
DGS-3212SR Switch CLI Reference
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.
<angle brackets>
Purpose |
Encloses a variable or value that must be |
|
specified. |
Syntax |
create ipif System ipaddress |
|
<network_address> |
Description |
In the above syntax example, you must type |
|
create ipif System followed by the network |
|
address in the <network_address> space. Do |
|
not type the angle brackets. |
Example |
create ipif System ipaddress |
Command |
10.24.22.5/55.0.0.0 |
[square brackets]
|
Encloses a required value or set of required |
|
Purpose |
arguments. One or more values or arguments |
|
|
can be specified. |
|
Syntax |
create account [admin|user] |
|
|
In the above syntax example, you must specify |
|
Description |
either an admin or a user level account to be |
|
|
created. Do not type the square brackets. |
|
Example |
create account admin |
|
Command |
||
|
| vertical bar
Purpose |
Separates two or more mutually exclusive items |
|
|
in a list − one of which must be entered. |
|
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 backslash. |
|
Example |
show snmp community |
|
Command |
||
|
7
DGS-3212SR Switch CLI Reference
{braces}
Purpose |
Encloses an optional value or set of optional |
|
|
arguments. |
|
Syntax |
config igmp [<ipif_name>|all] {version |
|
|
<value>|query_interval |
|
|
<sec>|max_response_time <sec>| |
|
|
robustness_variable |
|
|
<value>|last_member_query_interval |
|
|
<value>|state [enable|disable]} |
|
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 |
|
|
[enable|disable] are all optional arguments. You |
|
|
can specify any or all of the arguments |
|
|
contained by braces. Do not type the braces. |
|
Example |
config igmp all version 2 |
|
command |
||
|
Line Editing Key Usage
Delete |
Deletes 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 shifts the remaining characters in the line to |
|
the left. |
Left Arrow |
Moves the cursor to the left. |
Up Arrow |
Displays the previous command |
Down Arrow |
Displays the next possible command list, one- |
|
by-one. |
Right Arrow |
Moves the cursor to the right. |
Tab |
Shifts the cursor to the next field to the left. |
Multiple Page Display |
Control Keys |
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. |
q |
Stops the display of remaining pages when |
|
multiple pages are to be displayed. |
r |
Refreshes the pages currently displaying. |
a |
Displays the remaining pages without pausing |
|
between pages. |
Enter |
Displays the next line or table entry. |
Command Syntax |
8 |
DGS-3212SR Switch CLI Reference
4
BASIC SWITCH COMMANDS
The basic switch commands in the Command Line Interface (CLI) are listed (along with the appropriate parameters) in the following table.
Command |
Parameters |
create account |
[admin|user] |
|
<username> |
config account |
<username> |
show account |
|
show session |
|
show switch |
|
show serial_port |
|
config serial_port |
baud_rate [9600|19200|38400|115200] |
|
auto_logout [never|2_minutes|5_minutes |
|
|10_minutes|15_minutes] |
enable clipaging |
|
disable clipaging |
|
enable telnet |
<tcp_port_number> |
disable telnet |
|
enable web |
<tcp_port_number> |
disable web |
|
save |
|
reboot |
|
reset |
{config|system} |
Basic Switch Commands |
|
Command Parameters
login
logout
Each command is listed, in detail, in the following sections.
9
DGS-3212SR Switch CLI Reference
create account
Purpose |
Used to create user accounts |
Syntax |
create [admin|user] <username> |
Description |
The create account command is used to create |
|
user accounts that consist of a username of 1 to |
|
15 characters and a password of 0 to 15 |
|
characters. Up to 8 user accounts can be |
|
created. |
Parameters |
Admin <username> |
|
User <username> |
Restrictions |
Only Administrator-level users can issue this |
|
command. |
|
Usernames can be between 1 and 15 |
|
characters. |
|
Passwords can be between 0 and 15 |
|
characters. |
Basic Switch Commands
Example Usage:
To create an administrator-level user account with the username “dlink”.
DGS-3212SR:4#create account admin dlink
Command: create account admin dlink
Enter a case-sensitive new password:****
Enter the new password again for confirmation:****
Success.
DGS-3212SR:4#
10
DGS-3212SR Switch CLI Reference
config account
Purpose |
Used to configure user accounts |
Syntax |
config account <username> |
Description |
The config account command configures a |
|
user account that has been created using the |
|
create account command. |
Parameters |
<username> |
Restrictions |
Only Administrator-level users can issue this |
|
command. |
|
Usernames can be between 1 and 15 |
|
characters. |
|
Passwords can be between 0 15 characters. |
Basic Switch Commands
Example Usage:
To configure the user password of “dlink” account:
DGS-3212SR:4#config account dlink
Command: config account dlink
Enter a old password:****
Enter a case-sensitive new password:****
Enter the new password again for confirmation:****
Success.
DGS-3212SR:4#
11
DGS-3212SR Switch CLI Reference
show account
Purpose |
Used to display user accounts |
Syntax |
show account |
Description |
Displays all user accounts created on the |
|
switch. Up to 8 user accounts can exist on the |
|
switch at one time. |
Parameters |
None. |
Restrictions |
None. |
|
|
Basic Switch Commands
Example Usage:
To display the accounts that have been created:
DGS-3212SR:4#show account
Command: show account
Current Accounts:
Username |
Access Level |
--------------- |
------------ |
dlink |
Admin |
DGS-3212SR:4# |
|
12
DGS-3212SR Switch CLI Reference
delete account
Purpose |
Used to delete an existing user account |
Syntax |
delete account <username> |
Description |
The delete account command deletes a user |
|
account that has been created using the create |
|
account command. |
Parameters |
<username> |
Restrictions |
Only Administrator-level users can issue this |
|
command. |
Basic Switch Commands
Example Usage:
To delete the user account “System”:
DGS-3212SR:4#delete account System
Command: delete account System
Success.
DGS-3212SR:4#
13
DGS-3212SR Switch CLI Reference
show session
Purpose |
Used to display a list of currently logged-in |
|
users. |
Syntax |
show session |
Description |
This command displays a list of all the users |
|
that are logged-in at the time the command is |
|
issued. |
Parameters |
None |
Restrictions |
None. |
Basic Switch Commands
Example Usage:
To display the way that the users logged in:
DGS-3212SR:4#show session |
|
|
|
|
||
ID |
Login Time |
Live Time |
From |
Level |
Name |
|
-- |
-------------------------- |
------------ ------------ |
----- |
--------- |
||
8 |
0000 days 00:05:54 |
0:17:16.2 |
Serial Port |
4 |
Anonymous |
|
|
|
|
|
|
|
|
14
DGS-3212SR Switch CLI Reference
show serial_port
Purpose |
Used to display the current serial port settings. |
Syntax |
show serial_port |
Description |
This command displays the current serial port |
|
settings. |
Parameters |
None. |
Restrictions |
None |
Basic Switch Commands
Example Usage:
To display the serial port setting:
DGS-3212SR:4#show serial_port
Command: show serial_port
Baud Rate |
: 9600 |
Data Bits |
: 8 |
Parity Bits |
: None |
Stop Bits |
: 1 |
Auto-Logout |
: 10 mins |
DGS-3212SR:4#
15
DGS-3212SR Switch CLI Reference
show switch
Purpose |
Used to display information about the switch. |
Syntax |
show switch |
Description |
This command displays information about the |
|
switch. |
Parameters |
None. |
Restrictions |
None. |
Basic Switch Commands
Example Usage:
To display the switch information:
DGS-3212SR:4#show switch
Command: show switch
Device Type |
: DGS-3212SR Fast-Ethernet Switch |
Module Type |
: DES-332GS 1-port GBIC Gigabit Ethernet |
and 1 Stacking Port |
|
Unit ID |
: 1 |
MAC Address |
: 00-80-C8-12-35-40 |
IP Address |
: 10.1.1.33 (Manual) |
VLAN Name |
: default |
Subnet Mask |
: 255.0.0.0 |
Default Gateway |
: 0.0.0.0 |
Boot PROM Version : Build 1.00.005 |
|
Firmware Version |
: Build 3.00-B24 |
Hardware Version |
: 1A1 |
Device S|N |
: |
System Name |
: |
System Location |
: |
System Contact |
: |
Spanning Tree |
: Disabled |
GVRP |
: Disabled |
IGMP Snooping |
: Disabled |
RIP |
: Disabled |
DVMRP |
: Disabled |
PIM-DM |
: Disabled |
OSPF |
: Disabled |
TELNET |
: Enable (TCP 23) |
WEB |
: Enable (TCP 80) |
RMON |
: Disabled |
DGS-3212SR:4# |
|
16
DGS-3212SR Switch CLI Reference
show serial_port
Purpose |
Used to display the current serial port settings. |
Syntax |
show serial_port |
Description |
This command displays the current serial port |
|
settings. |
Parameters |
None. |
Restrictions |
None |
Basic Switch Commands
Example Usage:
To display the serial port setting:
DGS-3212SR:4#show serial_port
Command: show serial_port
Baud Rate |
: 9600 |
Data Bits |
: 8 |
Parity Bits |
: None |
Stop Bits |
: 1 |
Auto-Logout |
: 10 mins |
DGS-3212SR:4#
17
DGS-3212SR Switch CLI Reference
config serial_port
Purpose |
Used to configure the serial port. |
Syntax |
config serial_port |
|
{baud_rate[9600|19200|38400|115200]|auto_logout |
|
[never|2_minutes|5_minutes|10_minutes| |
|
15_minutes]} |
Description |
This command is used to configure the serial port’s |
|
baud rate and auto logout settings. |
Parameters |
[9600|19200|38400|115200] − The serial bit rate that |
|
will be used to communicate with the management |
|
host. |
|
never − No time limit on the length of time the console |
|
can be open with no user input. |
|
2_minutes − The console will log out the current user if |
|
there is no user input for 2 minutes. |
|
5_minutes − The console will log out the current user if |
|
there is no user input for 5 minutes. |
|
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. |
Restrictions |
Only administrator-level users can issue this |
|
command. |
Example Usage:
To configure baud rate:
DGS-3212SR:4#config serial_port baud_rate 9600 Command: config serial_port baud_rate 9600
Success.
DGS-3212SR:4#
Basic Switch Commands |
18 |
DGS-3212SR Switch CLI Reference
enable clipaging
Purpose |
Used to pause the scrolling of the console |
|
screen when the show command displays more |
|
than one page. |
Syntax |
enable clipaging |
Description |
This command is used when issuing the show |
|
command will cause the console screen to |
|
rapidly scroll through several pages. This |
|
command will cause the console to pause at the |
|
end of each page. The default setting is enable. |
Parameters |
None. |
Restrictions |
Only administrator-level users can issue this |
|
command. |
Basic Switch Commands
Example Usage:
To enable pausing of the screen display when show command output reaches the end of the page:
DGS-3212SR:4#enable clipaging
Command: enable clipaging
Success.
DGS-3212SR:4#
19
DGS-3212SR Switch CLI Reference
disable clipaging
Purpose |
Used to disable the pausing of the console |
|
screen scrolling at the end of each page when |
|
the show command would display more than |
|
one screen of information. |
Syntax |
disable clipaging |
Description |
This command is used to disable the pausing of |
|
the console screen at the end of each page |
|
when the show command would display more |
|
than one screen of information. |
Parameters |
None. |
Restrictions |
Only administrator-level users can issue this |
|
command. |
Basic Switch Commands
Example Usage:
To disable pausing of the screen display when show command output reaches the end of the page:
DGS-3212SR:4#disable clipaging
Command: disable clipaging
Success.
DGS-3212SR:4#
20
DGS-3212SR Switch CLI Reference
enable telnet
Purpose |
Used to enable communication with and |
|
management of the switch using the Telnet |
|
protocol. |
Syntax |
enable telnet <tcp_port_number> |
Description |
This command is used to enable the Telnet |
|
protocol on the switch. The user can specify the |
|
TCP or UDP port number the switch will use to |
|
listen for Telnet requests. |
Parameters |
<tcp_port_number> − The TCP port number. |
|
TCP ports are numbered between 1 and 65535. |
|
The “well-known” TCP port for the Telnet |
|
protocol is 23. |
Restrictions |
Only administrator-level users can issue this |
|
command. |
Example Usage:
To enable Telnet and configure port number:
DGS-3212SR:4#enable telnet 23
Command: enable telnet 23
Success.
DGS-3212SR:4#
Basic Switch Commands |
21 |
DGS-3212SR Switch CLI Reference
disable telnet
Purpose |
Used to disable the Telnet protocol on the |
|
switch. |
Syntax |
disable telnet |
Description |
This command is used to disable the Telnet |
|
protocol on the switch. |
Parameters |
None. |
Restrictions |
Only administrator-level users can issue this |
|
command. |
Basic Switch Commands
Example Usage:
To disable the Telnet protocol on the switch:
DGS-3212SR:4#disable telnet
Command: disable telnet
Success.
DGS-3212SR:4#
22
DGS-3212SR Switch CLI Reference
enable web
Purpose |
Used to enable the HTTP-based management |
|
software on the switch. |
Syntax |
enable web <tcp_port_number> |
Description |
This command is used to enable the Web- |
|
based management software on the switch. |
|
The user can specify the TCP port number the |
|
switch will use to listen for Telnet requests. |
Parameters |
<tcp_port_number> − The TCP port number. |
|
TCP ports are numbered between 1 and 65535. |
|
The “well-known” port for the Web-based |
|
management software is 80. |
Restrictions |
Only administrator-level users can issue this |
|
command. |
Example Usage:
To enable HTTP and configure port number:
DGS-3212SR:4#enable web 80
Command: enable web 80
Success.
DGS-3212SR:4#
Basic Switch Commands |
23 |
DGS-3212SR Switch CLI Reference
disable web
Purpose |
Used to disable the HTTP-based management |
|
software on the switch. |
Syntax |
disable web |
Description |
This command disables the Web-based |
|
management software on the switch. |
Parameters |
None. |
Restrictions |
Only administrator-level users can issue this |
|
command. |
Example Usage:
To disable HTTP:
DGS-3212SR:4#disable web Command: disable web
Success.
DGS-3212SR:4#
Basic Switch Commands |
24 |