D-link DGS-3600 Reference Guide
2
CLI Manual
Product Model: DGS-3600 Series
Layer 3 Gigabit Ethernet Managed Switch
Release
.4
©Copyright 2008. All rights reserved.
Table of Contents
INTRODUCTION ..........................................................................................................................................................1
USING THE CONSOLE CLI.........................................................................................................................................3
COMMAND SYNTAX...................................................................................................................................................7
BASIC SWITCH COMMANDS.....................................................................................................................................9
SWITCH PORT COMMANDS....................................................................................................................................22
PORT SECURITY COMMANDS................................................................................................................................25
STACKING COMMANDS ..........................................................................................................................................28
NETWORK MANAGEMENT (SNMP) COMMANDS .................................................................................................32
SWITCH UTILITY COMMANDS (INCLUDING FILE SYSTEM COMMANDS) .........................................................55
NETWORK MONITORING COMMANDS..................................................................................................................71
MULTIPLE SPANNING TREE PROTOCOL (MSTP) COMMANDS .........................................................................86
FORWARDING DATABASE COMMANDS...............................................................................................................98
BROADCAST STORM CONTROL COMMANDS...................................................................................................105
QOS COMMANDS ...................................................................................................................................................109
PORT MIRRORING COMMANDS...........................................................................................................................118
VLAN COMMANDS .................................................................................................................................................121
PROTOCOL VLAN GROUP COMMANDS..............................................................................................................132
LINK AGGREGATION COMMANDS.......................................................................................................................137
IP-MAC-PORT BINDING (IMPB).............................................................................................................................142
IP COMMANDS (INCLUDING IP MULTINETTING)................................................................................................150
IPV6 NEIGHBOR DETECTION COMMANDS.........................................................................................................156
IGMP COMMANDS (INCLUDING IGMP V3)...........................................................................................................162
IGMP SNOOPING COMMANDS..............................................................................................................................165
MLD SNOOPING COMMANDS...............................................................................................................................176
DHCP RELAY...........................................................................................................................................................184
DHCP SERVER COMMANDS.................................................................................................................................190
LIMITED IP MULTICAST ADDRESS.......................................................................................................................204
802.1X COMMANDS................................................................................................................................................210
ACCESS CONTROL LIST (ACL) COMMANDS......................................................................................................227
TIME RANGE COMMANDS.....................................................................................................................................246
ACL FLOW METERING COMMANDS....................................................................................................................248
SFLOW.....................................................................................................................................................................252
TIME AND SNTP COMMANDS...............................................................................................................................262
POLICY ROUTE COMMANDS................................................................................................................................268
SAFEGUARD ENGINE COMMANDS......................................................................................................................271
TRAFFIC SEGMENTATION COMMANDS..............................................................................................................274
ARP AND GRATUITOUS ARP COMMANDS .........................................................................................................276
VRRP COMMANDS .................................................................................................................................................284
ROUTING TABLE COMMANDS..............................................................................................................................291
ROUTE REDISTRIBUTION COMMANDS...............................................................................................................296
DNS COMMANDS....................................................................................................................................................301
RIP COMMANDS .....................................................................................................................................................305
DVMRP COMMANDS ..............................................................................................................................................308
PIM COMMANDS.....................................................................................................................................................313
IP MULTICASTING COMMANDS............................................................................................................................328
MD5 COMMANDS....................................................................................................................................................330
OSPF CONFIGURATION COMMANDS..................................................................................................................332
ROUTE PREFERENCE COMMANDS.....................................................................................................................349
MAC NOTIFICATION COMMANDS........................................................................................................................352
WEB-BASED ACCESS CONTROL (WAC) COMMANDS......................................................................................356
ACCESS AUTHENTICATION CONTROL COMMANDS........................................................................................363
SSH COMMANDS....................................................................................................................................................383
SSL COMMANDS ....................................................................................................................................................390
JUMBO FRAME COMMANDS ................................................................................................................................395
LLDP COMMANDS..................................................................................................................................................397
D-LINK SINGLE IP MANAGEMENT COMMANDS.................................................................................................413
COMMAND HISTORY LIST.....................................................................................................................................423
TECHNICAL SPECIFICATIONS..............................................................................................................................426
xStack DGS-3600 Series Layer 3 Gigabit Ethernet Managed Switch CLI Manual
1
INTRODUCTION
The Switch can be managed through the Switch’s serial port, Telnet, or the Web-based management agent. The Command Line
Interface (CLI) can be used to configure and manage the Switch via the serial port or Telnet interfaces.
This manual provides a reference for all of the commands contained in the CLI. Configuration and management of the Switch via the
Web-based management agent is discussed in the Manual.
Accessing the Switch via the Serial Port
The Switch’s serial port’s default settings are as follows:
• 115200 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 − DGS-3627:5#. 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 DGS-3600 Series Layer 3 Gigabit 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.24.22.200 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 DGS-3600 Series Layer 3 Gigabit 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 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 RA M using the save command. The current
configuration will then be retained in the Switch’s NV-RAM, and reloaded when the Switch is rebooted. If
the Switch is rebooted without using the save command, the last config uration 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.
Your terminal parameters will need to be set to:
• VT-100 compatible
• 115200 baud
• 8 data bits
• No parity
• One stop bit
• No flow control
Users can also access the same functions over a Telnet interface. Once an IP address has been set for the Switch, users can use a
Telnet program (in VT-100 compatible terminal mode) to access and control the Switch. All of the screens are identical, whether
accessed from the console port or from a Telnet interface.
After the Switch reboots and you have logged in, the console looks like this:
Figure 2- 1. Initial Console Screen after logging in
Commands are entered at the command prompt, DGS-3627:5#.
3
xStack DGS-3600 Series Layer 3 Gigabit Ethernet Managed Switch CLI Manual
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 users enter a command without its required parameters, the CLI will prompt a Next possible completions: message.
Figure 2- 3. Example Command Parameter Help
In this case, the command config account was entered with the parameter <username>. The CLI will then prompt to enter the
<username> with the message, 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, all of the next possible sub-commands can be seen, 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
xStack DGS-3600 Series Layer 3 Gigabit Ethernet Managed Switch CLI Manual
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.
If a command is entered that is unrecognized by the CLI, the top-level commands will be displayed under the Available commands:
prompt.
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 create command with no additional parameters, the CLI will then display all of the possible next
parameters.
5
xStack DGS-3600 Series Layer 3 Gigabit Ethernet Managed Switch CLI Manual
Figure 2- 6. Next possible completions: Create command
In the above example, all of the possible next parameters for the create command are displayed.
6
xStack DGS-3600 Series Layer 3 Gigabit 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
Description In the above syntax example, users must supply an IP interface name in the
Example
Command
create ipif <ipif_name 12> <network_address> (<ip_addr/netmask>)
<vlan_name 32> {secondary | state [enable | disable]}
<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.
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
Description
Example
Command
create account [admin | operator | user] <username 15>
In the above syntax example, users must specify the admin, operator, or user
level account to be created. Do not type the square brackets.
create account admin ctsnow
| vertical bar
Purpose Separates two or more mutually exclusive items in a list, one of which must be
entered.
Syntax
Description
Example
Command
create account [admin | operator |user] <username 15>
In the above syntax example, you must specify the admin, operator, or user
level account to be created. Do not type the backslash.
create account admin ctsnow
7
xStack DGS-3600 Series Layer 3 Gigabit Ethernet Managed Switch CLI Manual
{braces}
Purpose Encloses an optional value or set of optional arguments.
Syntax
Description In the above syntax example, users have the option to specify config or
Example
command
reset {[config | system]}
system. 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.
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.
8
xStack DGS-3600 Series Layer 3 Gigabit Ethernet Managed Switch CLI Manual
4
BASIC SWITCH COMMANDS
The basic switch commands in the Command Line Interface (CLI) are listed (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> {<string>}
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
save {[config {<drive_id>} <pathname 64> | log | all]}
reboot {<string>}
reset {[config |system]} {<string>}
login
logout
show device_status
config command_prompt
config greeting_message {default}
show greeting_message
Each command is listed, in detail, in the following sections.
create account
Purpose
Syntax create account [admin | operator | user] <username 15>
Description
Parameters
Used to create user accounts.
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 eight
user accounts can be created.
admin <username 15> - Enter a name between 1 and 15 alphanumeric characters
to define the administrator account created here.
operator <username 15>- Enter a name between 1 and 15 alphanumeric
characters to define the operator account created here.
user <username 15>- Enter a name between 1 and 15 alphanumeric ch aracters
9
xStack DGS-3600 Series Layer 3 Gigabit Ethernet Managed Switch CLI Manual
create account
to define the user account created here.
Restrictions
Example usage:
To create an administrator-level user account with the username “dlink”.
To create an operator-level user account with the username “frazier”.
Only Administrator-level users can issue this command.
DGS-3627:5#create account admin dlink
Command: create account admin dlink
Enter a case-sensitive new password:****
Enter the new password again for confirmation:****
Success.
DGS-3627:5#
DGS-3627:5#create account operator frazier
Command: create account operator frazier
Enter a case-sensitive new password:****
Enter the new password again for confirmation:****
Success.
DGS-3627:5#
To create a user-level user account with the username “reed”.
DGS-3627:5#create account user reed
Command: create account user reed
Enter a case-sensitive new password:****
Enter the new password again for confirmation:****
Success.
DGS-3627:5#
config account
Purpose
Syntax config account <username>
Description
Parameters
Used to configure user accounts.
The config account command configures a user account that has
been created using the create account command.
<username>- Enter a name between 1 and 15 alphanumeric
characters to define the administrator account to configure here.
Example usage:
Restrictions
Only Administrator-level users can issue this command.
10
xStack DGS-3600 Series Layer 3 Gigabit Ethernet Managed Switch CLI Manual
To configure the user password of “dlink” account:
DGS-3627:5#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-3627:5#
show account
Purpose Used to display user accounts
Example usage:
To display the accounts that have been created:
Syntax
Description Displays all user accounts created on the Switch. Up to eight user
Parameters None.
Restrictions Only Administrator-level users can issue this command.
DGS-3627:5#show account
Command: show account
Current Accounts:
Username Access Level
--------------- -----------dlink Admin
DGS-3627:5#
show account
accounts can exist at one time.
delete account
Purpose
Used to delete an existing user account.
Example usage:
To delete the user account “System”:
Syntax delete account <username> {<string>}
Description
Parameters <username> -
Restrictions
DGS-3627:5#delete account System
Command: delete account System
Are you sure to delete the last administrator account?(y/n)y
Success.
The delete account command deletes a user account that has
been created using the create account command.
<string> - Enter an alphanumeric string of up to 15 characte rs to
define the username.
Only Administrator-level users can issue this command.
11
xStack DGS-3600 Series Layer 3 Gigabit Ethernet Managed Switch CLI Manual
DGS-3627:5#
show session
Example usage:
To display the way that the users logged in:
Purpose
Syntax show session
Description
Parameters
Restrictions
DGS-3627:5#show session
Command: show session
ID Live Time From Level Name
-- --------- ------------ ----- ----------8 03:36:27 Serial Port 5 Anonymous
Total Entries: 1
CTRL+C ESC q Quit SPACE n Next Page p Previous Page r Refresh
Used to display a list of currently logged-in users.
This command displays a list of all the users that are logged-in at
the time the command is issued.
None
None.
Example usage:
To display the Switch’s information:
show switch
Purpose
Syntax show switch
Description
Parameters
Restrictions
DGS-3627:5#show switch
Command: show switch
Device Type : DGS-3627 Gigabit Ethernet Switch
MAC Address : 00-10-20-33-45-00
IP Address : 10.24.22.200 (Manual)
VLAN Name : default
Subnet Mask : 255.0.0.0
Default Gateway : 0.0.0.0
Boot PROM Version : Build 1.10-B06
Firmware Version : Build 2.40-B19
Hardware Version : 2A1G
System Name :
System Location :
System Contact :
Spanning Tree : Disabled
GVRP : Disabled
Used to display general information about the Switch.
This command displays information about the Switch.
None.
None.
12
xStack DGS-3600 Series Layer 3 Gigabit Ethernet Managed Switch CLI Manual
IGMP Snooping : Disabled
MLD Snooping : Disabled
RIP : Disabled
DVMRP : Disabled
PIM : Disabled
OSPF : Disabled
TELNET : Enabled (TCP 23)
WEB : Enabled (TCP 80)
RMON : Disabled
SSL status : Disabled
SSH status : Disabled
802.1x : Disabled
Jumbo Frame : Off
Clipaging : Disabled
MAC Notification : Disabled
Port Mirror : Disabled
SNTP : Disabled
DHCP Relay : Disabled
DNSR Status : Disabled
VRRP : Disabled
HOL Prevention State : Disabled
Syslog Global State : Disabled
Single IP Management: Disabled
DGS-3627:5#
Example usage:
To display the serial port setting:
show serial_port
Purpose
Syntax show serial_port
Description
Parameters
Restrictions
DGS-3627:5#show serial_port
Command: show serial_port
Baud Rate : 115200
Data Bits : 8
Parity Bits : None
Stop Bits : 1
Auto-Logout : 10 mins
DGS-3627:5#
Used to display the current serial port settings.
This command displays the current serial port settings.
None.
None
config serial_port
Purpose
Syntax config serial_port {baud_rate [9600 | 19200 | 38400 | 115200] |
Description
Used to configure the serial port.
auto_logout [never | 2_minutes | 5_minutes | 10_minutes |
15_minutes]}
This command is used to configure the serial port’s baud rate and auto
logout settings.
13
xStack DGS-3600 Series Layer 3 Gigabit Ethernet Managed Switch CLI Manual
config serial_port
Example usage:
To configure baud rate:
Parameters
Restrictions
DGS-3627:5#config serial_port baud_rate 115200
Command: config serial_port baud_rate 115200
Success.
DGS-3627:5#
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, and 115200.
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.
Only administrator-level and operator-level users can issue this
command.
Example usage:
To enable pausing of the screen display when the show command output reaches the end of the page:
enable clipaging
Purpose
Syntax enable clipaging
Description
Parameters
Restrictions
DGS-3627:5#enable clipaging
Command: enable clipaging
Success.
DGS-3627:5#
Used to pause the scrolling of the console screen when the show
command displays more than one page.
This command is used when issuing the show command which
causes 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 enabled.
None.
Only administrator-level and operator-level users can issue this
command.
disable clipaging
Purpose
Used to disable the pausing of the console screen scrolling at the
14
xStack DGS-3600 Series Layer 3 Gigabit Ethernet Managed Switch CLI Manual
disable clipaging
end of each page when the show command displays more than one
screen of information.
Syntax disable clipaging
Example usage:
To disable pausing of the screen display when show command output reaches the end of the page:
Description
Parameters
Restrictions
DGS-3627:5#disable clipaging
Command: disable clipaging
Success.
DGS-3627:5#
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.
None.
Only administrator-level and operator-level users can issue this
command.
enable telnet
Purpose
Syntax enable telnet {<tcp_port_number 1-65535>}
Used to enable communication with and management of the Switch
using the Telnet protocol.
Example usage:
To enable Telnet and configure port number:
Description
Parameters
Restrictions
DGS-3627:5#enable telnet 23
Command: enable telnet 23
Success.
DGS-3627:5#
disable telnet
Purpose
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.
{<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.
Only administrator-level and operator-level users can issue this
command.
Used to disable the Telnet protocol on the Switch.
Syntax disable telnet
Description
Parameters
This command is used to disable the Telnet protocol on the Switch.
None.
15
xStack DGS-3600 Series Layer 3 Gigabit Ethernet Managed Switch CLI Manual
disable telnet
Example usage:
To disable the Telnet protocol on the Switch:
Restrictions
DGS-3627:5#disable telnet
Command: disable telnet
Success.
DGS-3627:5#
Only administrator-level and operator-level users can issue this
command.
enable web
Purpose
Syntax enable web {<tcp_port_number 1-65535>}
Description
Parameters
Used to enable the HTTP-based management software on the Switch.
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.
{<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.
Example usage:
To enable HTTP and configure port number:
Restrictions
DGS-3627:5#enable web 80
Command: enable web 80
Note: SSL will be disabled if web is enabled.
Success.
DGS-3627:5#
Only administrator-level and operator-level users can issue this
command.
disable web
Purpose
Syntax disable web
Description
Parameters
Used to disable the HTTP-based management software on the Switch.
This command disables the Web-based management software on the
Switch.
None.
Example usage:
To disable HTTP:
Restrictions
DGS-3627:5#disable web
Command: disable web
Only administrator-level and operator-level users can issue this
command.
16
xStack DGS-3600 Series Layer 3 Gigabit Ethernet Managed Switch CLI Manual
Success.
DGS-3627:5#
save
Example usage:
To save the Switch’s current configuration to non-volatile RAM:
Purpose
Syntax save {[config {<drive_id>} <pathname 64> | log | all]}
Description
Parameters
Restrictions
DGS-3627:5#save
Command: save
Saving all configurations to NV-RAM... Done.
DGS-3627:5#
Used to save changes in the Switch’s configuration to non-volatile RAM.
This command is used to enter the current switch configuration or log
file into non-volatile RAM. The saved switch configuration will be loaded
into the Switch’s memory each time the Switch is restarted.
config <drive_id> – Specify to save current settings to the Flash
memory of the switch.
<drive_id> - Specify the ID of the drive where the log or configuration
file will be placed.
<pathname 64> - Enter a name of up to 64 characters to define the file
to be saved on the flash drive.
log – Specify to save current Switch log to NV-RAM.
all – Use to save the configuration and log file to NV-RAM.
Only administrator-level and operator-level users can issue this
command.
reboot
Purpose
Syntax reboot {<string>}
Description
Parameters
Restrictions
Example usage:
To restart the Switch:
Used to restart the Switch.
This command is used to restart the Switch.
None.
Only administrator-level users can issue this command.
DGS-3627:5#reboot
Command: reboot
Are you sure want to proceed with the system reboot? (y|n) y
Please wait, the switch is rebooting...
17
reset
xStack DGS-3600 Series Layer 3 Gigabit Ethernet Managed Switch CLI Manual
Purpose
Syntax reset {[config |system]} {<string>}
Description
Parameters
Restrictions
Example usage:
To restore all of the Switch’s parameters to its default values:
Used to reset the Switch to the factory default settings.
This command is used to restore the Switch’s configuration to the default
settings assigned from the factory.
config − If the keyword ‘config’ is specified, all of the factory default
settings are restored on the Switch including the IP address, user
accounts, and the switch history log. The Switch will not save or reboot.
system − If the keyword ‘system’ is specified all of the factory default
settings are restored on the Switch. The Switch will save and reboot after
the settings are changed to default. Rebooting will clear all entries in the
Forwarding Data Base.
If no parameter is specified, the Switch’s current IP address, user
accounts, and the switch history log are not changed. All other parameters
are restored to the factory default settings. The Switch will not save or
reboot.
Only administrator-level users can issue this command.
DGS-3627:5#reset config
Command: reset config
Are you sure to proceed with system reset?(y/n) y
Success.
DGS-3627:5#
Example usage:
To initiate the login procedure:
login
Purpose
Syntax login
Description
Parameters
Restrictions
DGS-3627:5#login
Command: login
UserName:
Used to log in a user to the Switch’s console.
This command is used to initiate the login procedure. The user will be
prompted for a Username and Password.
None.
None.
logout
Purpose
Syntax logout
Used to log out a user from the Switch’s console.
18
xStack DGS-3600 Series Layer 3 Gigabit Ethernet Managed Switch CLI Manual
logout
Example usage:
To terminate the current user’s console session:
Example usage:
To show the current hardware status of the Switch:
Description
Parameters
Restrictions
DGS-3627:5#logout
This command terminates the current user’s session on the Switch’s
console.
None.
None.
show device_status
Purpose Used to display the current status of the hardware of the Switch.
Syntax
Description This command displays the current status of the Switch’s physical
Parameters None.
Restrictions None.
show device_status
elements.
DGS-3627:5#show device_status
Command: show device_status
Internal Power External power Side Fan Back Fan
---------------------- ------------------------ ---------------- -- ---------------
Active Fail OK ---
DGS-3627:5#
config command_prompt
Purpose Used to configure the command prompt for the Command Line
Interface.
Syntax
Description This command is used to configure the command prompt for the CLI
Parameters <string 16> - Enter an alphanumeric string of no more than 16
config command_prompt [<string 16> | username | default]
interface of the Switch. The current command prompt consists of
“product name + : + user level + product name” (ex. DGS-3627:5#). The
user may replace all parts of the command prompt, except the # by
entering a string of 16 alphanumerical characters with no spaces, or the
user may enter the current login username configured on the Switch.
characters to define the command prompt for the CLI interface.
username – Entering this parameter will replace the current CLI
command prompt with the login username configured on the Switch.
default – Entering this parameter will return the command prompt to its
original factory default setting.
Restrictions The reset command will not alter the configured command prompt, yet
the reset system command will return the command prompt to its
original factory default setting.
Only administrator-level and operator-level users can issue this
19
xStack DGS-3600 Series Layer 3 Gigabit Ethernet Managed Switch CLI Manual
config command_prompt
command.
Example usage:
To configure the command prompt:
DGS-3627:5#config command_prompt Tiberius
Command: config command_prompt Tiberius
Success.
Tiberius#
config greeting_message
Purpose Used to configure the greeting message or banner for the opening
screen of the Command Line Interface.
Syntax
Description This command is used to configure the greeting message or login
Parameters default – Adding this parameter will return the greeting command to its
Restrictions The reset command will not alter the configured greeting message, yet
Example usage:
To configure the greeting message:
DGS-3627:5#config greeting_message
Command: config greeting_message
Greeting Messages Editor
===============================================================================
DGS-3627 Gigabit Ethernet Switch
Command Line Interface
Firmware: Build 2.40-B19
Copyright(C) 2008 D-Link Corporation. All rights reserved.
===============================================================================
<Function Key> <Control Key>
Ctrl+C Quit without save left/right/
Ctrl+W Save and quit up/down Move cursor
Ctrl+D Delete line
Ctrl+X Erase all setting
Ctrl+L Reload original setting
------------------------------------------------------------------------------------------------------------------------------------------
config greeting_message {default}
banner for the opening screen of the CLI.
original factory default configuration.
the reset system command will return the greeting message to its
original factory default setting.
The maximum character capacity for the greeting banned is 6 lines and
80 characters per line. Entering Ctrl+W will save the current configured
banner to the DRAM only. To save it into the FLASH memory, the user
must enter the save command.
Only administrator-level and operator-level users can issue this
command.
20
xStack DGS-3600 Series Layer 3 Gigabit Ethernet Managed Switch CLI Manual
show greeting_message
Purpose Used to view the currently configured greeting message
configured on the Switch.
Syntax
Description This command is used to view the currently configured greeting
Parameters None.
Restrictions Only administrator-level and operator-level users can issue this
Example usage:
To view the currently configured greeting message:
DGS-3627:5#show greeting_message
Command: show greeting_message
=========================================================================
DGS-3627 Gigabit Ethernet Switch
Command Line Interface
Firmware: Build 2.40-B19
Copyright(C) 2008 D-Link Corporation. All rights reserved.
=========================================================================
DGS-3627:5#
show greeting_message
message on the Switch.
command.
21
xStack DGS-3600 Series Layer 3 Gigabit Ethernet Managed Switch CLI Manual
5
SWITCH PORT COMMANDS
The switch port commands in the Command Line Interface (CLI) are listed (with the appropriate parameters) in the following table.
Command Parameters
config ports [<portlist> | all] {medium_type [fiber | copper]} {speed [auto | 10_half | 10_full |100_half |
100_full | 1000_full {master | slave]}] | flow_control [enable | disable] | learning [enable |
disable] | state [enable | disable]} | description [<desc 32> | clear_description]}
show ports {<portlist>} { [ description | err_disabled ] }
Each command is listed, in detail, in the following sections.
config ports
Purpose
Syntax [<portlist> | all] {medium_type [fiber | copper]} {speed [auto | 10_half | 10_full
Description
Parameters
Used to configure the Switch’s Ethernet port settings.
|100_half | 100_full | 1000_full {master | slave]}] | flow_control [enable | disable] |
learning [enable | disable] | state [enable | disable]} | description [<desc 1-32> |
clear_description]}
This command allows for the configuration of the Switch’s Ethernet ports. Only the ports
listed in the <portlist> will be affected.
all − Configure all ports on the Switch.
<portlist> − Specifies a port or range of ports to be configured. The beginning and end of
the port list range are separated by a dash.
medium_type [fiber | copper] – This applies only to the Combo ports. If configuring the
Combo ports this defines the type of transport medium used.
speed – Allows the user to adjust the speed for a port or range of ports. The user has a
choice of the following:
• auto − Enables auto-negotiation for the specified range of ports.
• [10 | 100 | 1000] − Configures the speed in Mbps for the specified range of
ports. Gigabit ports are statically set to 1000 and cannot be set to slower
speeds.
• [half | full] − Configures the specified range of ports as either full-duplex or halfduplex.
• [master | slave] - The master setting (1000M/Full_M) will allow the port to
advertise capabilities related to duplex, speed and physical layer type. The
master setting will also determine the master and slave relationship between
the two connected physical layers. This relationship is necessary for
establishing the timing control between the two physical layers. The timing
control is set on a master physical layer by a local source. The slave setting
(1000M/Full_S) uses loop timing, where the timing comes form a data stream
received from the master. If one connection is set for 1000M/Full_M, the other
side of the connection must be set for 1000M/Full_S. Any other configuration
will result in a link down status for both ports.
flow_control [enable | disable] – Enable or disable flow control for the specified ports.
learning [enable | disable] − Enables or disables the MAC address learning on the
specified range of ports.
state [enable | disable] − Enables or disables the specified range of ports.
description <desc 1-32> - Enter an alphanumeric string of no more than 32 characters to
describe a selected port interface.
clear_description - Enter this command to clear the port description of the sele cted
port(s).
22
xStack DGS-3600 Series Layer 3 Gigabit Ethernet Managed Switch CLI Manual
config ports
Restrictions
Example usage:
To configure the speed of ports 1 to 3 to be 10 Mbps, full duplex, with learning and state enabled:
show ports
Purpose
Syntax show ports {<portlist>} {[description} | err_disabled]}
Description
Parameters
Only administrator-level and operator-level users can issue this command.
DGS-3627:5#config ports 1-3 speed 10_full learning enable state enable
Command: config ports 1-3 speed 10_full learning enable state enable
Success.
DGS-3627:5#
Used to display the current configuration of a range of ports.
This command is used to display the current configuration of a range of ports.
<portlist> − Specifies a port or range of ports to be displayed. The beginning
and end of the port list range are separated by a dash.
{description} – Adding this parameter to the show ports command indicates
that a previously entered port description will be included in the display.
err_disabled – Choosing this parameter will display ports that have been
disconnected due to an error on the port, such as a Loopback Detection.
Restrictions
Example usage:
To display the configuration of all ports on a standalone switch:
None.
DGS-3627:5#show ports
Command: show ports
Port Port Settings Connection Address
State Speed/Duplex/FlowCtrl Speed/Duplex/FlowCtrl Learning
------ ------------- --------------- ------------------- ------------------------------ --- ---------------1 Enabled Auto/Enabled Link Down Enabled
2 Enabled Auto/Enabled Link Down Enabled
3 Enabled Auto/Enabled Link Down Enabled
4 Enabled Auto/Enabled Link Down Enabled
5 Enabled Auto/Enabled Link Down Enabled
6 Enabled Auto/Enabled Link Down Enabled
7 Enabled Auto/Enabled Link Down Enabled
8 Enabled Auto/Enabled Link Down Enabled
9 Enabled Auto/Enabled Link Down Enabled
10 Enabled Auto/Enabled Link Down Enabled
11 Enabled Auto/Enabled 100M/Full/None Enabled
12 Enabled Auto/Enabled Link Down Enabled
13 Enabled Auto/Enabled Link Down Enabled
14 Enabled Auto/Enabled Link Down Enabled
15 Enabled Auto/Enabled Link Down Enabled
16 Enabled Auto/Enabled Link Down Enabled
17 Enabled Auto/Enabled Link Down Enabled
18 Enabled Auto/Enabled Link Down Enabled
19 Enabled Auto/Enabled Link Down Enabled
CTRL+C ESC q Quit SPACE n Next Page p Previous Page r Refresh
23
Example usage:
To display the configuration of all ports on the Switch, with description:
xStack DGS-3600 Series Layer 3 Gigabit Ethernet Managed Switch CLI Manual
DGS-3627:5#show ports description
Command: show ports description
Port Port Settings Connection Address
State Speed/Duplex/FlowCtrl Speed/Duplex/FlowCtrl Learning
------ -------- ------------------------------- -------------------------------- ------------ --1 Enabled Auto/Disabled Link Down Enabled
Description: dads1
2 Enabled Auto/Disabled Link Down Enabled
Description:
3 Enabled Auto/Disabled Link Down Enabled
Description:
4 Enabled Auto/Disabled Link Down Enabled
Description:
5 Enabled Auto/Disabled Link Down Enabled
Description:
6 Enabled Auto/Disabled Link Down Enabled
Description:
7 Enabled Auto/Disabled Link Down Enabled
Description:
8 Enabled Auto/Disabled Link Down Enabled
Description:
CTRL+C ESC q Quit SPACE n Next Page p Previous Page r Refresh
To display the Error Disabled ports:
DGS-3627:5#show ports err_disabled
Command : show ports err_disabled
Port Port Connection status Reason
State
------- ------- -------------------------- -----------2 Enabled Err-disabled Storm control
Desc: Port 2
8 Enabled Err-disabled Storm control
Desc: Port 8
DGS-3627:5#
24
xStack DGS-3600 Series Layer 3 Gigabit Ethernet Managed Switch CLI Manual
6
PORT SECURITY COMMANDS
The Switch’s port security commands in the Command Line Interface (CLI) are listed (along with the appropriate parameters) in the
following table.
Command Parameters
config port_security ports [<portlist> | all] {admin_state [enable| disable] |
max_learning_addr <max_lock_no 0-16> |
lock_address_mode [Permanent | DeleteOnTimeout |
DeleteOnReset]}
delete port_security_entry vlan_name <vlan_name 32> port <port> mac_address <macaddr>
clear port_security_entry port <portlist>
show port_security {ports <portlist>}
Each command is listed, in detail, in the following sections.
config port_security ports
Purpose
Syntax config port_security ports [<portlist> | all] {admin_state [enable|
Description
Parameters
Used to configure port security settings.
disable] | max_learning_addr <max_lock_no 0-16> |
lock_address_mode [Permanent | DeleteOnTimeout |
DeleteOnReset]}
This command allows for the configuration of the port security feature.
Only the ports listed in the <portlist> are affected.
portlist − Specifies a port or range of ports to be configured. The
beginning and end of the port list range are separated by a dash.
all − Configure port security for all ports on the Switch.
admin_state [enable | disable] – Enable or disable port security for the
listed ports.
max_learning_addr <max_lock_no 0-16> - Use this to limit the number of
MAC addresses dynamically listed in the FDB for the ports.
lock_address_mode [Permanent | DeleteOnTimout | DeleteOnReset] –
Indicates the method of locking addresses. The user has three choices:
Permanent – The locked addresses will not age out after the
aging timer expires.
DeleteOnTimeout – The locked addresses will age out after the
aging timer expires.
DeleteOnReset – The locked addresses will not age out until the
Switch has been reset.
Example usage:
To configure the port security:
Restrictions
Only administrator-level and operator-level users can issue this command.
25
xStack DGS-3600 Series Layer 3 Gigabit Ethernet Managed Switch CLI Manual
DGS-3627:5#config port_security ports 1-5 admin_state enable
max_learning_addr 5 lock_address_mode DeleteOnReset
Command: config port_security ports 1-5 admin_state enable
max_learning_addr 5 lock_address_mode DeleteOnReset
Success.
DGS-3627:5#
delete port_security_entry vlan_name
Purpose
Syntax delete port_security_entry vlan_name <vlan_name 32> port
Description
Parameters
Restrictions
Example usage:
To delete a port security entry:
DGS-3627:5#delete port_security_entry vlan_name default port 6
mac_address 00-01-30-10-2C-C7
Command: delete port_security_entry vlan_name default port 6
mac_address 00-01-30-10-2C-C7
Success.
DGS-3627:5#
Used to delete a port security entry by MAC address, port number
and VLAN ID.
<port> mac_address <macaddr>
This command is used to delete a single, previously learned port
security entry by port, VLAN name, and MAC address.
vlan name <vlan_name 32> - Enter the corresponding vlan name of
the port to delete.
mac_address <macaddr> - Enter the corresponding MAC address,
previously learned by the port, which the user wishes to delete.
port <port> - Enter the port number which has learned the
previously entered MAC address.
Only administrator-level and operator-level users can issue this
command.
Example usage:
clear port_security_entry
Purpose
Syntax clear port_security_entr y port <portlist>
Description
Parameters
Restrictions
Used to clear MAC address entries learned from a specified port for
the port security function.
This command is used to clear MAC address entries which were
learned by the Switch by a specified port. This command only relates
to the port security function.
<portlist> − Specifies a port or port range to clear. The beginning
and end of the port list range are separated by a dash.
Only administrator-level and operator-level users can issue this
command.
26
xStack DGS-3600 Series Layer 3 Gigabit Ethernet Managed Switch CLI Manual
To clear a port security entry by port:
DGS-3627:5# clear port_security_entry port 6
Command: clear port_security_entry port 6
Success.
DGS-3627:5#
show port_security
Example usage:
To display the port security configuration:
Purpose
Syntax show port_security {ports <portlist>}
Description
Parameters
Restrictions
DGS-3627:5#show port_security ports 1-5
Command: show port_security ports 1-5
Port Admin State Max. Learning Addr. Lock Address Mode
------ ----------------- ---------------------------- ----------------- ----------1 Disabled 1 DeleteOnReset
2 Disabled 1 DeleteOnReset
3 Disabled 1 DeleteOnReset
4 Disabled 1 DeleteOnReset
5 Disabled 1 DeleteOnReset
DGS-3627:5#
Used to display the current port security configuration.
This command is used to display port security information of the
Switch’s ports. The information displayed includes port security,
admin state, maximum number of learning address and lock mode.
<portlist> − Specifies a port or range of ports to be viewed. The
beginning and end of the port list range are separated by a dash.
None.
27
Loading...