D-link DGS-3212SR User Manual

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.

Accessing the Switch via the Serial Port

The switch’s serial port’s default settings are as follows:

•9600 baud

•no parity

•8 data bits

•1 stop bit

A computer running a terminal emulation program capable of emulating a VT-100 terminal and a serial port configured as above is then connected to the switch’s serial port via an RS-232 DB-9 cable.

With the serial port properly connected to a management computer, the following screen should be visible. If this screen does not appear, try pressing Ctrl+r to refresh the console screen.

Introduction

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.

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 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.

Connecting to the Switch

The console interface is used by connecting the Switch to a VT100-compatible terminal or a computer running an ordinary terminal emulator program (e.g., the HyperTerminal program included with the Windows operating system) using an RS-232C serial cable.

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

Command Syntax

[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