D-Link DES-3828, DES-3828P, DES-3828DC Cli Manual
CLI Manual
Product Model: DES-3800 Series
Layer 3 Stackable Fast Ethernet Managed Switch
Release 4. 5
©Copyright 2008. All rights reserved.
July 2008
651ES3800055G
RECYCLABLE
.
Table of Contents
INTRODUCTION ..........................................................................................................................................................1
USING THE CONSOLE CLI .........................................................................................................................................3
COMMAND SYNTAX ...................................................................................................................................................7
BASIC SWITCH COMMANDS .....................................................................................................................................9
SWITCH PORT COMMANDS ....................................................................................................................................27
SNMP V3 ....................................................................................................................................................................31
POE COMMANDS......................................................................................................................................................45
NETWORK MANAGEMENT COMMANDS ................................................................................................................50
SWITCH UTILITY COMMANDS.................................................................................................................................58
NETWORK MONITORING COMMANDS ..................................................................................................................69
LAYER 2 FDB COMMANDS ......................................................................................................................................82
PACKET STORM CONTROL COMMANDS ..............................................................................................................90
QOS COMMANDS......................................................................................................................................................94
MIRROR CONFIGURATION COMMANDS .............................................................................................................102
VLAN COMMANDS ..................................................................................................................................................105
LINK AGGREGATION COMMANDS........................................................................................................................119
IGMP SNOOPING COMMANDS..............................................................................................................................123
802.1X COMMANDS (INCLUDING GUEST VLANS) ..............................................................................................131
ACCESS CONTROL LIST (ACL) COMMANDS.......................................................................................................144
TRAFFIC SEGMENTATION COMMANDS ..............................................................................................................164
COMMAND LIST HISTORY .....................................................................................................................................166
BASIC IP COMMANDS (FOR LAYER 3) .................................................................................................................169
ARP COMMANDS ....................................................................................................................................................174
ROUTING TABLE COMMANDS ..............................................................................................................................178
ROUTE REDISTRIBUTION COMMANDS ...............................................................................................................181
RIP COMMANDS......................................................................................................................................................187
IGMP COMMANDS ..................................................................................................................................................191
AUTO CONFIG COMMANDS V3 .............................................................................................................................195
DNS RELAY COMMANDS.......................................................................................................................................197
DVMRP COMMANDS ..............................................................................................................................................201
IP MULTICASTING COMMANDS ............................................................................................................................206
MD5 COMMANDS....................................................................................................................................................209
OSPF CONFIGURATION COMMANDS ..................................................................................................................211
TIME AND SNTP COMMANDS................................................................................................................................228
PORT SECURITY COMMANDS ..............................................................................................................................234
MAC NOTIFICATION COMMANDS.........................................................................................................................238
SSH COMMANDS ....................................................................................................................................................242
JUMBO FRAME COMMANDS .................................................................................................................................250
ACCESS AUTHENTICATION CONTROL COMMANDS .........................................................................................252
D-LINK SINGLE IP MANAGEMENT COMMANDS..................................................................................................275
MULTIPLE SPANNING TREE PROTOCOL (MSTP) COMMANDS ........................................................................285
SSL COMMANDS.....................................................................................................................................................297
VRRP COMMANDS .................................................................................................................................................303
SYSTEM SEVERITY ................................................................................................................................................312
DHCP RELAY...........................................................................................................................................................314
IP-MAC BINDING COMMANDS...............................................................................................................................320
LACP CONFIGURATION COMMANDS...................................................................................................................334
CPU INTERFACE FILTERING (SOFTWARE ACL) COMMANDS ..........................................................................336
MODIFY PROMPT AND BANNER COMMANDS ....................................................................................................344
SAFEGUARD ENGINE.............................................................................................................................................347
WRED COMMAND LIST ..........................................................................................................................................349
WEB-BASED ACCESS CONTROL (WAC) COMMANDS .......................................................................................353
DOUBLE VLAN COMMAND LIST............................................................................................................................359
LIMITED MULTICAST IP ADDRESS COMMANDS.................................................................................................364
ROUTE PREFERENCE COMMANDS .....................................................................................................................369
MAC-BASED ACCESS CONTROL COMMANDS ...................................................................................................372
PIM COMMANDS .....................................................................................................................................................381
LOOPBACK INTERFACE COMMANDS ..................................................................................................................398
DHCP SERVER COMMAND LIST ...........................................................................................................................401
MLD SNOOPING COMMANDS ...............................................................................................................................417
LOOPBACK DETECTION COMMANDS..................................................................................................................424
PASSWORD RECOVERY COMMANDS .................................................................................................................429
MULTICAST VLAN COMMANDS.............................................................................................................................432
CPU FILTERING COMMANDS LIST .......................................................................................................................435
BROADCAST SEGMENTATION COMMANDS .......................................................................................................437
TECHNICAL SPECIFICATIONS ..............................................................................................................................439
ARP PACKET CONTENT ACL.................................................................................................................................441
xStack DES-3800 Series Layer 3 Stackable Fast Ethernet Managed Switch CLI Manual
1
INTRODUCTION
The DES-3800 series is a member of the D-Link xStack switch family. xStack is a complete family of stackable devices that ranges
from edge 10/100Mbps switches to core Gigabit switches. xStack provides unsurpassed performance, fault tolerance, scalable
flexibility, robust security, standard-based interoperability and an impressive support for 10Gigabit technology to future-proof
departmental and enterprise network deployments with an easy migration path.
The Switch can be managed through the Switch’s serial port, Telnet, or the Web-based management agent. The Command Line
Interface (CLI) can be used to configure and manage the Switch via the serial port or Telnet interfaces.
This manual provides a reference for all of the commands contained in the CLI. Configuration and management of the Switch via the
Web-based management agent is discussed in the Manual.
Accessing the Switch via the Serial Port
The Switch’s serial port’s default settings are as follows:
• 9600 baud
• no parity
• 8 data bits
• 1 stop bit
A computer running a terminal emulation program capable of emulating a VT-100 terminal and a serial port configured as above is
then connected to the Switch’s serial port via an RS-232 DB-9 cable.
With the serial port properly connected to a management computer, the following screen should be visible. If this screen does not
appear, try pressing Ctrl+r o refresh the console screen.
Figure 1-1. Initial CLI screen
There is no initial username or password. Just press the Enter key twice to display the CLI input cursor − DES-3800:admin#. 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
xStack DES-3800 Series Layer 3 Stackable Fast Ethernet Managed Switch CLI Manual
Figure 1-2. Boot Screen
The Switch’s MAC address can also be found in the Web management program on the Switch Information (Basic Settings) window
on the Configuration menu.
The IP address for the Switch must be set before it can be managed with the Web-based manager. The Switch IP address can be
automatically set using BOOTP or DHCP protocols, in which case the actual address assigned to the Switch must be known.
The IP address may be set using the Command Line Interface (CLI) over the console serial port as follows:
1. Starting at the command line prompt, enter the commands config ipif System ipaddress xxx.xxx.xxx.xxx/yyy.yyy.yyy.yyy.
Where the x’s represent the IP address to be assigned to the IP interface named System and the y’s represent the
corresponding subnet mask.
2. Alternatively, you can enter config ipif System ipaddress xxx.xxx.xxx.xxx/z. Where the x’s represent the IP address to be
assigned to the IP interface named System and the z represents the corresponding number of subnets in CIDR notation.
The IP interface named System on the Switch can be assigned an IP address and subnet mask which can then be used to connect a
management station to the Switch’s Telnet or Web-based management agent.
Figure 1-3. Assigning an IP Address
In the above example, the Switch was assigned an IP address of 10.53.13.83 with a subnet mask of 255.0.0.0. The system message
Success indicates that the command was executed successfully. The Switch can now be configured and managed via Telnet, SNMP
MIB browser and the CLI or via the Web-based management agent using the above IP address to connect to the Switch.
2
xStack DES-3800 Series Layer 3 Stackable Fast Ethernet Managed Switch CLI Manual
2
USING THE CONSOLE CLI
The Switch supports a console management interface that allows the user to connect to the Switch’s management agent via a serial
port and a terminal or a computer running a terminal emulation program. The console can also be used over the network using the
TCP/IP Telnet protocol. The console program can be used to configure the Switch to use an SNMP-based network management
software over the network.
This chapter describes how to use the console interface to access the Switch, change its settings, and monitor its operation.
Note: Switch configuration settings are saved to non- volatile RAM u sing 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 w ill be
loaded.
Connecting to the Switch
The console interface is used by connecting the Switch to a VT100-compatible terminal or a computer running an ordinary terminal
emulator program (e.g., the HyperTerminal program included with the Windows operating system) using an RS-232C serial cable.
Your terminal parameters will need to be set to:
• VT-100 compatible
• 9600 baud
• 8 data bits
• No parity
• One stop bit
• No flow control
You can also access the same functions over a Telnet interface. Once you have set an IP address for your Switch, you can use a Telnet
program (in VT-100 compatible terminal mode) to access and control the Switch. All of the screens are identical, whether accessed
from the console port or from a Telnet interface.
3
xStack DES-3800 Series Layer 3 Stackable Fast Ethernet Managed Switch CLI Manual
After the Switch reboots and you have logged in, the console looks like this:
Figure 2- 1. Initial Console Screen after logging in
Commands are entered at the command prompt, DES-3800:admin#.
There are a number of helpful features included in the CLI. Entering the ? command will display a list of all of the top-level
commands.
Figure 2- 2. The ? Command
When you enter a command without its required parameters, the CLI will prompt you with a Next possible completions: message.
4
xStack DES-3800 Series Layer 3 Stackable Fast Ethernet Managed Switch CLI Manual
Figure 2- 3. Example Command Parameter Help
In this case, the command config account was entered with the parameter <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.
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 username can be entered and the config account command re-
executed.
All commands in the CLI function in this way. In addition, the syntax of the help prompts are the same as presented in this manual −
angle brackets < > indicate a numerical value or character string, braces { } indicate optional parameters or a choice of parameters,
and brackets [ ] indicate required parameters.
5
If a command is entered that is unrecognized by the CLI, the top-level commands will be displayed under the Available commands:
prompt.
xStack DES-3800 Series Layer 3 Stackable Fast Ethernet Managed Switch CLI Manual
Figure 2- 5. Available Commands
The top-level commands consist of commands such as 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.
Figure 2- 6. Next possible completions: Show Command
In the above example, all of the possible next parameters for the show command are displayed.
6
xStack DES-3800 Series Layer 3 Stackable Fast Ethernet Managed Switch CLI 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
create ipif <ipif_name 12> <network_address> (<ip_addr/n etmask>)
<vlan_name 32> {secondary | state [enable | disable]} | proxy _arp [en able
| disable]}
Description In the above syntax example, you must supply an IP interface name in the
<ipif_name> space, a VLAN name in the <vlan_name 32> space, and the
network address, including the netmask, in the <network_address>
(<ip_addr/netmask>) space. Do not type the angle brackets.
Example
Command
create ipif Engineering 10.24.22.5/255.0.0.0 Design
[square brackets]
Purpose Encloses a required value or set of required arguments. One value or argument
can be specified.
Syntax
create account [admin | operator | user] <username 15>
Description In the above syntax example, you must specify either an admin, operator or a
user level account to be created. Do not type the square brackets.
Example
Command
create account admin Darren
| vertical bar
Purpose Separates two or more mutually exclusive items in a list, one of which must be
entered.
Syntax
create account [admin | operator | user] <username 15>
Description In the above syntax example, you must specify either admin, operator or
user. Do not type the backslash.
Example
Command
create account admin Darren
7
xStack DES-3800 Series Layer 3 Stackable Fast Ethernet Managed Switch CLI Manual
8
{braces}
Purpose Encloses an optional value or set of optional arguments.
Syntax
reset {[config | system]}
Description In the above syntax example, you have the option to specify config or detail. It
is not necessary to specify either optional value, however the effect of the
system reset is dependent on which, if any, value is specified. Therefore, with
this example there are three possible outcomes of performing a system reset.
See the following chapter, Basic Commands for more details about the reset
command.
Example
command
reset config
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 the command history for the current session. Use the down arrow to
progress sequentially forward 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.
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 displayed.
a Displays the remaining pages without pausing between pages.
Enter Displays the next line or table entry.
xStack DES-3800 Series Layer 3 Stackable Fast Ethernet Managed Switch CLI Manual
9
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 | operator | user] <username 15>
config account <username>
show account
delete account <username>
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 1-65535>
disable telnet
enable web <tcp_port_number 1-65535>
disable web
enable snmp
disable snmp
save config <config_id1-2>
reboot
reset [config | system]
login
logout
show config [ current_config | config_in_nvram <config_ id 1-2> | information]
config configuration <config_id 1-2> [active | delete | boot_up]
telnet <ipaddr> {tcp_port <value 0-65535>}
config terminal line
show terminal line
Each command is listed, in detail, in the following sections.
xStack DES-3800 Series Layer 3 Stackable Fast Ethernet Managed Switch CLI Manual
10
create account
Purpose
Used to create user accounts.
Syntax crea te account [admin | operator | user] <username 15>
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
The administrator can choose one of the following three levels of
privileges available on the Switch.
admin – Select this parameter to create an administrator-level
account for the Switch. admin accounts have access and
configuration rights to all components of the software of the Switch.
Switch administrators must first create an admin-level account
before an operator or user account can be created. Only admin level
users can create other user accounts.
operator – Select this parameter to create a operator-level user
account for the Switch. Operator-level users will have rights to switch
configurations, network monitoring commands, community strings
and trap stations, and system utilities. All security commands, user
account commands and the factory reset command will be denied
from this privilege level.
user – Select this parameter to create a user-level account on the
Switch. User-level accounts have read-only rights to configuration
commands, network monitoring commands and commands for
community stations and trap strings.
• <username 15> - Enter a username of no more than 15
alphanumeric characters to identify the account created
here.
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.
Example usage:
To create an administrator-level user account with the username “dlink”.
DES-3800:admin#create account admin dlink
Command: create account admin dlink
Enter a case-sensitive new password:****
Enter the new password again for confirmation:****
Success.
DES-3800:admin#
xStack DES-3800 Series Layer 3 Stackable Fast Ethernet Managed Switch CLI Manual
11
To create an operator-level user account with the username “oper”.
DES-3800:admin#create account operator oper
Command: create account operator oper
Enter a case-sensitive new password:****
Enter the new password again for confirmation:****
Success.
DES-3800:admin#
To create an user-level user account with the username “system”.
DES-3800:admin#create account user system
Command: create account user system
Enter a case-sensitive new password:****
Enter the new password again for confirmation:****
Success.
DES-3800:admin#
xStack DES-3800 Series Layer 3 Stackable Fast Ethernet Managed Switch CLI Manual
The following table summarizes the Admin, Operator and User privileges:
Management Admin Operator User
Configuration Yes Yes Read-only
Network Monitoring Yes Yes Read-only
Community Strings and Trap Stations Yes Yes Read-only
Update Firmware and Configuration Files Yes No No
System Utilities Yes Yes No
Factory Reset Yes No No
User Account Management
Add/Update/Delete User Accounts Yes No No
View User Accounts Yes No No
NOTE: One admin-level account must be created before other user accounts can be set.
When a user logs in to the Switch, the default command prompt will display the level of
privilege assigned. (DES-3800:admin#, DES-3800:oper#, DES-3800:user#). For more
information regarding user accounts, see the DES-3800 Series Layer 3 Stackable Fast
Ethernet Managed Switch User Manual.
config account
Purpose
Used to configure user accounts.
Syntax config ac count <username>
Description
The config account command configures a user account that has
been created using the create account command.
Parameters
<username > - Name of the account. The account must already be
defined.
Restrictions
Only Administrator-level users can issue this command.
Example usage:
To configure the user password of “dlink” account:
DES-3800:admin#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.
DES-3800:admin#
12
xStack DES-3800 Series Layer 3 Stackable Fast Ethernet Managed Switch CLI Manual
13
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 at one time.
Parameters
None.
Restrictions
Only Administrator-level users can issue this command.
Example usage:
To display the accounts that have been created:
DES-3800:admin#show account
Command: show account
Current Accounts:
Username Access Level
--------------- -----------dlink Admin
Total Entries: 1
DES-3800:admin#
delete account
Purpose
Used to delete an existing account.
Syntax
delete account <username> {force_agree}
Description
The delete account command deletes an existing account.
Parameters
<username> - Name of the user who will be deleted.
force_agree - When force_agree is specified, the delete account
command will be executed immediatedly without further
confirmation.
Restrictions
Only Administrator-level users can issue this command. One
active admininstrator-level user must exist.
Example usage:
To delete the user account “System”:
DES-3800:admin#delete account System
Command: delete account System
Success.
DES-3800:admin#
xStack DES-3800 Series Layer 3 Stackable Fast Ethernet Managed Switch CLI Manual
14
show session
Purpose
Used to display a list of currently logged-in users.
Syntax sho w 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
Only Administrator or Operator-level users can issue this command.
Example usage:
To display the way that the users are logged in:
DES-3800:admin# show session
Command: show session
ID Login Time Live Time From Level Name
-- ------------------- ----------- ------------ ----- ---------*0 2008/06/19 09:15:00 0:4:45.300 10.11.22.33 5 Anonymous
8
DES-3800:admin#
xStack DES-3800 Series Layer 3 Stackable Fast Ethernet Managed Switch CLI Manual
15
show switch
Purpose
Used to display general information about the Switch.
Syntax show switch
Description
This command displays information about the Switch.
Parameters
None.
Restrictions
None.
Example usage:
To display the Switch’s information:
DES-3800:admin#show switch
Command: show switch
Device Type : DES-3800 Fast-Ethernet Switch
Combo Port Type : 1000Base-TX + 1000Base-TX
MAC Address : 00-00-53-13-00-00
IP Address : 10.9.68.90 (Manual)
VLAN Name : default
Subnet Mask : 255.0.0.0
Default Gateway : 0.0.0.0
Boot PROM Version : Build 0.00.010
Firmware Version : Build 4.50.B10
Hardware Version : A2
Serial Number : N/A
Power Status : Main - Abnormal, Redundant - Not Present
System Name :
System Location :
System Contact :
Spanning Tree : Enabled
GVRP : Disabled
IGMP Snooping : Disabled
TELNET : Enabled (TCP 23)
SSH : Enabled (TCP 22)
WEB : Enabled (TCP 80)
RMON : Disabled
RIP : Disabled
DVMRP : Disabled
PIM : Disabled
OSPF : Disabled
SNMP : Disabled
DES-3800:admin#
show serial_port
Purpose
Used to display the current serial port settings.
Syntax sho w serial_port
Description
This command displays the current serial port settings.
Parameters
None.
Restrictions
None.
Example usage:
To display the serial port setting:
xStack DES-3800 Series Layer 3 Stackable Fast Ethernet Managed Switch CLI Manual
16
DES-3800:admin#show serial_port
Command: show serial_port
Baud Rate : 9600
Data Bits : 8
Parity Bits : None
Stop Bits : 1
Auto-Logout : 10 mins
DES-3800:admin#
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
baud_rate [9600 | 19200 | 38400 | 115200]− The serial bit rate that will be
used to communicate with the management host. There are four options:
9600, 19200, 38400, 115200.
auto_logout [never | 2_minutes | 5_minutes |10_minutes | 15_minutes
Restrictions
Only Administrator-level users can issue this command.
Example usage:
To configure baud rate:
DES-3800:admin#config serial_port baud_rate 9600
Command: config serial_port baud_rate 9600
Success.
DES-3800:admin#
enable clipaging
Purpose
Used to enable the feature that pauses the scrolling of the console
screen when the show command displays more than one page.
Syntax enable clipaging
Description
This command enables the screen to be paused when the show
command output reaches the end of the page. The default setting is
enable.
Parameters
None.
Restrictions
Only Administrator or Operator-level users can issue this command.
Example usage:
To enable the feature that allows the screen to be paused when the show command output reaches the end of the page:
DES-3800:admin#enable clipaging
Command: enable clipaging
Success.
xStack DES-3800 Series Layer 3 Stackable Fast Ethernet Managed Switch CLI Manual
17
DES-3800:admin#
disable clipaging
Purpose
Used to disable the feature that pauses the scrolling of the console
screen when the show command displays more than one page.
Syntax disable clipaging
Description
This command is used to disable the pausing of the console screen
at the end of each page when a command displays more than one
screen of information.
Parameters
None.
Restrictions
Only Administrator or Operator-level users can issue this command.
Example usage:
To disable pausing of the screen display when the show command output reaches the end of the page:
DES-3800:admin#disable clipaging
Command: disable clipaging
Success.
DES-3800:admin#
enable telnet
Purpose
This feature enables the Switch to be managed via TELNET based
management software and also allows you to specify the port
number that will be used to manage the Switch via TELNET.
Syntax enable telnet <tcp_por t_number 1-65535>
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 1-65535> − 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 or Operator-level users can issue this command.
Example usage:
To enable Telnet and configure port number:
DES-3800:admin#enable telnet 23
Command: enable telnet 23
Success.
DES-3800:admin#
xStack DES-3800 Series Layer 3 Stackable Fast Ethernet Managed Switch CLI Manual
18
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 or Operator-level users can issue this command.
Example usage:
To disable the Telnet protocol on the Switch:
DES-3800:admin#disable telnet
Command: disable telnet
Success.
DES-3800:admin#
enable web
Purpose
Used to enable the HTTP-based management software on the
Switch.
Syntax enable web <tcp_port_number 1-65535>
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 1-65535> − The TCP port number. TCP ports are
numbered between 1 and 65535. The “well-known” port for the Webbased management software is 80.
Restrictions
Only Administrator or Operator-level users can issue this command.
Example usage:
To enable HTTP and configure port number:
DES-3800:admin#enable web 80
Command: enable web 80
Success.
DES-3800:admin#
disable web
Purpose
Used to disable the HTTP-based management software on the
Switch.
Syntax disable web
Description
This command disables use of the Web-based management
software on the Switch.
Parameters
None.
Restrictions
Only Administrator or Operator-level users can issue this command.
xStack DES-3800 Series Layer 3 Stackable Fast Ethernet Managed Switch CLI Manual
19
Example usage:
To disable HTTP:
DES-3800:admin#disable web
Command: disable web
Success.
DES-3800:admin#
enable snmp
Purpose
Used to enable SNMP on the switch, so that it can be managed via
SNMP based manafement software.
Syntax enable snmp
Description
The enable snmp command enables SNMP.
Parameters
None.
Restrictions
Only Administrator or Operator-level users can issue this command.
Example usage:
To enable SNMP:
DES-3800:admin#enable snmp
Command: enable snmp
Success.
DES-3800:admin#
disable snmp
Purpose
Used to disable SNMP on the switch.
Syntax disable snmp
Description
The disable snmp command disables SNMP.
Parameters
None.
Restrictions
Only Administrator or Operator-level users can issue this command.
Example usage:
To disable SNMP:
DES-3800:admin#disable snmp
Command: disable snmp
Success.
DES-3800:admin#
xStack DES-3800 Series Layer 3 Stackable Fast Ethernet Managed Switch CLI Manual
20
save
Purpose
Used to save changes in the Switch’s configuration to non-volatile
RAM.
Syntax save {config <config_id 1-2>}
Description
This command is used to enter the current switch configuration into
non-volatile RAM. The saved switch configuration will be loaded into
the Switch’s memory each time the Switch is restarted.
Parameters
config <config_id 1-2> - Choose this parameter to save the current
switch configuration to a file located on the memory of the Switch.
The user may enter 1 or 2 to identify this configuration file. If no
config_id is specified, changes in the switch configuration will be
saved to the current and active switch configuration file.
Restrictions
Only Administrator or Operator-level users can issue this command.
Example usage:
To save the Switch’s current configuration to non-volatile RAM:
DES-3800:admin#save
Command: save
Saving all configurations to NV-RAM... Done.
DES-3800:admin#
Example usage:
To save the Switch’s current configuration to config_id 1 in the non-volatile RAM:
DES-3800:admin#save config 1
Command: save
Saving all configurations to NV-RAM... Done.
DES-3800:admin#
reboot
Purpose
Used to restart the Switch.
Syntax reboo t {force_agree}
Description
The reboot command restarts the switch.
Parameters
force_agree - When force_agree is specified, the reboot command
will be executed immediatedly without further confirmation.
Restrictions
Only Administrator-level users can issue this command.
Example usage:
To restart the Switch:
DES-3800:admin#reboot
Command: reboot
Are you sure to proceed with t
h
e system
reboot?(y/n)
Please wait, the switch is rebooting...
xStack DES-3800 Series Layer 3 Stackable Fast Ethernet Managed Switch CLI Manual
21
reset
Purpose
Used to reset all switch parameters.
Syntax reset {[co nfig | system]} {force_agree}
Description
The reset command resets all switch parameters to the factory
defaults.
Parameters
config − If you specify the ‘config’ keyword , all parameters are reset
to default settings. But device will not do save neither reboot.
system − If you specify the ‘system’ keyword, all parameters are
reset to default settings. Then the switch will do factory reset, save
and reboot
If no keyword is specified, all parameters will be reset to default
settings except the IP address, user account and history log. But
device will not save or reboot.
force_agree - When force_agree is specified, the reset command will
be executed immediatedly without further confirmation.
Restrictions
Only Administrator-level users can issue this command.
Example usage:
To restore all of the Switch’s parameters to its default values:
DES-3800:admin#reset
Command: reset
Are you sure to proceed with system reset
except IP address?(y/n)
Success.
DES-3800:admin#
DES-3800:admin#reset config
Command: reset config
Are you sure to proceed with system reset?(y/n)
Success.
DES-3800:admin#
DES-3800:admin#reset system
Command: reset system
Are you sure to proceed with system reset, save
and reboot?(y/n)
Loading factory default configuration... Done.
xStack DES-3800 Series Layer 3 Stackable Fast Ethernet Managed Switch CLI Manual
22
Saving all configurations to NV-RAM... Done.
Please wait, the switch is rebooting...
login
Purpose
Used to to initiate the login procedure to the Switch’s console.
Syntax Login
Description
This command is used to initiate the login procedure. The user will be
prompted for a Username and Password.
Parameters
None.
Restrictions
None.
Example usage:
To initiate the login procedure:
DES-3800:admin#login
Command: login
UserName:
logout
Purpose
Used to log out a user from the Switch’s console.
Syntax logout
Description
This command terminates the current user’s session on the Switch’s
console.
Parameters
None.
Restrictions
None.
Example usage:
To terminate the current user’s console session:
DES-3800:admin#logout
xStack DES-3800 Series Layer 3 Stackable Fast Ethernet Managed Switch CLI Manual
23
show config
Purpose
Used to collect and show all system configurations in a single CLI
command..
Syntax show config
Description
This command displays all system configurations. The continuous
displaying configuration can be aborted via by interrupt key, which
may be a sequence of keying processes or a single key. The display
format should be same as CLI configuration command.
Parameters current_config
config_in_nvram <config_id 1-2>
information
Restrictions
None.
Example usage:
To show all system configurations from DRAM database:
DES-3800:admin#show config config_in_nvram
Command: show config config_in_nvram
# BASIC
config serial_port baud_rate 9600 auto_logout never
enable telnet 23
enable web 80
disable jumbo_frame
# STP
config stp maxage 20 hellotime 2 forwarddelay 15
priority 32768 version rstp txholdcount 3 fbpdu
enabled
disable stp
config stp ports 1-
2
4 cost auto priority 128 edge
false p2p auto state enabled
# LACP
config link_aggregation algorithm mac_source
config lac
xStack DES-3800 Series Layer 3 Stackable Fast Ethernet Managed Switch CLI Manual
24
config configuration
Purpose
Used to activate, delete or set a configuration as an active
configuration.
Syntax config co nfiguration
Description
The config configuration command actives, deletes or set as
boot_up configuration of the device.
Parameters <config_id 1-2>
active
delete
boot_up
Restrictions
Only Administrator-level users can issue this command.
Example usage:
To activate configuration 1:
DES-3800:admin#config configuration 1 active
Command: config configuration 1 active
Success.
DES-3800:admin#
Example usage:
To delete configuration 2:
DES-3800:admin#config configuration 2 delete
Command: config configuration 2 delete
Success.
DES-3800:admin#
Example usage:
To apply configuration 1:
DES-3800:admin#config configuration 1 apply
Command: config configuration 1 apply
Success.
DES-3800:admin#
xStack DES-3800 Series Layer 3 Stackable Fast Ethernet Managed Switch CLI Manual
25
telnet
Purpose
Used to Telnet another device on the network.
Syntax telnet <ipaddr> {tcp_port <value 0-65535>}
Description
This command is used to connect to another device’s management
through Telnet.
Parameters
<ipaddr> - Enter the IP address of the device to connect through,
using Telnet.
tcp_port <value 0-65535> - Enter the TCP port number used to
connect through. The common TCP port number for telnet is 23.
Restrictions
None.
Example usage:
To connect to a device through telnet with a IP address of 10.53.13.99:
DES-3800:admin#telnet 10.53.13.99 tcp_port 23
Command: telnet 10.53.13.99 tcp_port 23
config terminal line
Purpose
Used to configure the number of rows which can be displayed at a
screen.
Syntax config terminal_line [default | <value 20-80>]
Description
Used to configure the number of rows which can be displayed on the
screen.
Default value is 24.
Parameters
None.
Restrictions
Only Administrator or Operator-level users can issue this command.
Example usage:
To configure a terminal_line:
DES-3800:admin# config terminal_line 30
Command: config terminal_line 30
Success.
DES-3800:admin#
show terminal line
Purpose
Used to display the number of rows which can be displayed at a
screen.
Syntax show terminal_line
Description
Used to display the number of rows which can be displayed on the
screen.
Parameters
None.
Restrictions
None.
Example usage:
xStack DES-3800 Series Layer 3 Stackable Fast Ethernet Managed Switch CLI Manual
26
To show a terminal_line:
DES-3800:admin# show terminal_line
Command: show terminal_line
Current terminal line number : 30
DES-3800:admin#
show device_status
Purpose
Used to display the current status of the hardware of the Switch.
Syntax show device_status
Description
This command displays the current status of the Switch’s physical
elements.
Parameters
None.
Restrictions
None.
Example usage:
To show the current hardware status of the Switch:
DES-3800:admin#show device_status
Command: show device_status
Internal Power External power Side Fan Back Fan
-------------- -------------- -------- -------Active Fail
O
K None
DES-3800:admin#
Loading...