D-Link DGS-1510/ME Reference Manual

DGS-1510/ME Series Metro Ethernet Switch CLI Reference Guide
Table of Contents
Chapter 1 Using Command Line Interface ................................................................................................................. 1
Chapter 2 Basic Command List ................................................................................................................................. 8
Chapter 3 802.1Q VLAN Command List .................................................................................................................. 22
Chapter 4 802.1X Command List ............................................................................................................................. 36
Chapter 5 Access Authentication Control Command List ........................................................................................ 51
Chapter 6 Access Control List (ACL) Command List ............................................................................................... 72
Chapter 7 Address Resolution Protocol (ARP) Command List ................................................................................ 91
Chapter 8 ARP Spoofing Prevention Command List ............................................................................................... 96
Chapter 9 Auto-Configuration Command List .......................................................................................................... 98
Chapter 10 Basic Commands Command List .......................................................................................................... 101
Chapter 11 BPDU Attack Protection Command List ................................................................................................ 118
Chapter 12 Cable Diagnostics Command List ......................................................................................................... 123
Chapter 13 Command Logging Command List ........................................................................................................ 125
Chapter 14 Compound Authentication Command List ............................................................................................ 127
Chapter 15 Configuration Command List ................................................................................................................. 131
Chapter 16 Connectivity Fault Management (CFM) Command List ........................................................................ 136
Chapter 17 CPU Interface Filtering Command List .................................................................................................. 163
Chapter 18 Debug Software Command List ............................................................................................................ 172
Chapter 19 DHCP Local Relay Command List ........................................................................................................ 179
Chapter 20 DHCP Relay Command List .................................................................................................................. 185
Chapter 21 DHCP Server Screening Command List ............................................................................................... 201
Chapter 22 Digital Diagnostic Monitoring (DDM) Command s ................................................................................. 204
Chapter 23 D-Link Unidirectional Link Detection (DULD) Command Li st................................................................ 210
Chapter 24 DoS Attack Prevention Command List .................................................................................................. 212
Chapter 25 Energy Efficient Ethernet (EEE) Command List ................................................................................... 216
Chapter 26 Ethernet Ring Protection Switching (ER P S) Command List ................................................................. 218
Chapter 27 Filter Command List .............................................................................................................................. 227
Chapter 28 Filter Database (FDB) Command List ................................................................................................... 230
Chapter 29 Flash File System (FFS) Command List ............................................................................................... 240
Chapter 30 Gratuitous ARP Command List ............................................................................................................. 249
Chapter 31 IGMP Snooping Command List ............................................................................................................. 254
Chapter 32 IP-MAC-Port Binding (IMPB) Command List ........................................................................................ 280
Chapter 33 IPv6 Neighbor Discover Command List ................................................................................................ 295
Chapter 34 IPv6 Route Command List .................................................................................................................... 299
Chapter 35 Jumbo Frame Command List ................................................................................................................ 302
Chapter 36 Layer 2 Protocol Tunneling (L2PT) Command Li st ............................................................................... 304
Chapter 37 Link Aggregation Command List ........................................................................................................... 308
Chapter 38 Link Layer Discovery Protocol (LLDP) Command Li st .......................................................................... 315
Chapter 39 LLDP-MED Command List .................................................................................................................... 333
I
DGS-1510/ME Series Metro Ethernet Switch CLI Reference Guide
Chapter 40 Loop Back Detection (LBD) Command List .......................................................................................... 341
Chapter 41 MAC Notification Command List ........................................................................................................... 347
Chapter 42 MAC-based Access Control Command List .......................................................................................... 352
Chapter 43 MAC-based VLAN Command List ......................................................................................................... 367
Chapter 44 Mirror Command List ............................................................................................................................. 370
Chapter 45 MLD Snooping Command List .............................................................................................................. 373
Chapter 46 MSTP debug enhancement Command List .......................................................................................... 395
Chapter 47 Multicast Filter Command List ............................................................................................................... 401
Chapter 48 Multicast VLAN Command List ............................................................................................................. 412
Chapter 49 Multiple Spanning Tree Protocol (MSTP) Command List ..................................................................... 422
Chapter 50 Network Load Balancing (NLB) Command List .................................................................................... 434
Chapter 51 Network Monitoring Command List ....................................................................................................... 439
Chapter 52 OAM Commands ................................................................................................................................... 445
Chapter 53 Peripherals Command List .................................................................................................................... 452
Chapter 54 Ping Command List ............................................................................................................................... 455
Chapter 55 Port Security Command List ................................................................................................................. 457
Chapter 56 Power over Ethernet (PoE) Command List (D G S-1510-28LP/ME and DGS-1510-28XMP/ME Only) . 465
Chapter 57 PPPoE Circuit ID Insertions Command List .......................................................................................... 470
Chapter 58 Protocol VLAN Command List .............................................................................................................. 473
Chapter 59 QinQ Command List .............................................................................................................................. 479
Chapter 60 Quality of Service (QoS) Command List ............................................................................................... 487
Chapter 61 RADIUS Client Command List .............................................................................................................. 505
Chapter 62 Safeguard Engine Command List ......................................................................................................... 515
Chapter 63 Secure Shell (SSH) Command List ....................................................................................................... 517
Chapter 64 Secure Sockets Layer (SSL) Command List ........................................................................................ 525
Chapter 65 Show Technical Support Command List ............................................................................................... 531
Chapter 66 Simple Mail Transfer Protocol (SMTP) Command List ......................................................................... 534
Chapter 67 Simple Network Management Protocol (SNMP) Command List .......................................................... 539
Chapter 68 Single IP Management Command List .................................................................................................. 564
Chapter 69 Syslog and Trap Source-interface Command List ................................................................................ 574
Chapter 70 System Log Command List ................................................................................................................... 578
Chapter 71 System Severity Command List ............................................................................................................ 589
Chapter 72 Telnet Client Command List .................................................................................................................. 591
Chapter 73 TFTP/FTP Client Command List ........................................................................................................... 592
Chapter 74 Time and SNTP Command List ............................................................................................................ 601
Chapter 75 Trace Route Command List .................................................................................................................. 608
Chapter 76 Traffic Control Command List ............................................................................................................... 611
Chapter 77 Traffic Segmentation Command List ..................................................................................................... 616
Chapter 78 Trusted Host Command List ................................................................................................................. 618
Chapter 79 Unicast Routing Command List ............................................................................................................. 622
Chapter 80 VLAN Trunking Command List .............................................................................................................. 625
Chapter 81 Password Recovery Command List ...................................................................................................... 630
II
DGS-1510/ME Series Metro Ethernet Switch CLI Reference Guide
Appendix A Password Recovery Procedure ............................................................................................................. 632
Appendix B System Log Entries ............................................................................................................................... 633
Appendix C Trap Log Entries .................................................................................................................................... 643
Appendix D RADIUS Attributes Assignment ............................................................................................................. 647
Appendix E IETF RADIUS Attributes Support .......................................................................................................... 649
III
DGS-1510/ME Series Metro Ethernet Switch CLI Reference Guide
DGS-1510-28XMP/ME:admin#
Chapter 1
The Switch can be managed through the Switch’ s serial port, Telnet, SNMP or the Web-based manageme nt agent. The Command Line Interface (CLI) can be used to configure and manage the Switch via the serial po rt or Telnet interfaces.
This manual provides a reference for all of the comm ands contained in the CLI. Every command will be intr oduced in terms of purpose, format, description, parameters, and examples. Configuration and ma nagement of the Switch via the Web-based management agent are discusse d i n the Web UI Reference Guide. For detailed informat i on on installing hardware please also refer to the Hard ware I nstallat ion Gui de.
Using Command Line Interface

1-1 Accessing the Switch via the Serial Port

The Switch’s serial port’s default setting s 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 are then connected to the Switch’s Console port via an included RS-232 to RJ-45 convertor 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 t o ref resh the console screen.
DGS-1510-28XMP/ME Gigabit Ethernet Switch
Command Line Interface
Firmware: Build 1.00.018
Copyright(C) 2015 D-Link Corporation. All rights reserved. UserName: PassWord:
There is no initial username or password. Just p ress the Enter key twice to display the CLI input cursor DGS­1510-28XMP/ME:admin#. This is the command line where all commands are input.

1-2 Setting the Switch’s IP Address

Each Switch must be assigned its own IP Addres s, which is used for communication with an SNMP network manager or other TCP/IP application (for example BOOTP, TFTP). The Switch’s default I P address is 10.90.90.90. You can change the default Switch IP address to meet the specification of your networking addr ess scheme.
The Switch is also assigned a unique MAC address by the factory. This MAC address cannot be changed, and can be found on the initial boot console screen – shown below.
1
DGS-1510/ME Series Metro Ethernet Switch CLI Reference Guide
DGS-1510-28XMP/ME:admin#
Boot Procedure V1.00.001
-------------------------------------------------------------------------------
Power On Self Test ........................................ 100 %
MAC Address : 00-01-02-03-04-00 H/W Version : A1
Please Wait, Loading V1.00.018 Runtime Image .............. 100 %
UART init ................................................. 100 %
Starting runtime image
Device Discovery .......................................... 100 %
Configuration init ........................................ |
The Switch’s MAC address can also be found in the Web management program on the Switch Informati on (Basic Settings) window on the Configuration menu.
The IP address for the Switch must be set before it can be mana ged with the Web-based manager. The Switch IP address can be automatically set using BOOTP or DHCP protocols, in which case the actual addr ess assigned to the Switch must be known.
Starting at the command line prompt, enter the c ommands 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 corresp onding subnet mask.
Alternatively, you can enter config ipif System ipaddress xxx.xxx.xxx.xxx/z. Where the x’s represent the IP address to be assigned to the IP interface named System and the z represents the corresponding number of subnets in CIDR notation.
The IP interface named System on the Switch can be assigned an IP address and subnet mask whi ch can then be used to connect a management station to the Switch’s Telnet or Web-based management agent.
DGS-1510-28XMP/ME:admin# config ipif System ipaddress 10.24.22.100/255.0.0.0 Command: config ipif System ipaddress 10.24.22.100/8
Success.
In the above example, the Switch was assigned an IP address of 10.24.22.100 with a subnet mask of 255. 0.0.0. The system message Success indicates that t he command was executed successfully. The Switch can now be configured and managed via Telnet, SNMP MI B browser and the CLI or via the Web-based management agent using the above IP address to connect to the Swit ch.
There are a number of helpful features included in t he CLI. Entering the ? command will display a list of all of t he top-level commands.
2
DGS-1510/ME Series Metro Ethernet Switch CLI Reference Guide
CTRL+C ESC q Quit SPACE n Next Page ENTER Next Entry a All
DGS-1510-28XMP/ME:admin#
DGS-1510-28XMP/ME:admin#config account
.. ? cable_diag ports cd cfm linktrace cfm loopback clear clear address_binding dhcp_snoop binding_entry ports clear arptable clear attack_log clear cfm pkt_cnt clear counters clear ethernet_oam ports clear fdb clear igmp_snooping data_driven_group clear igmp_snooping statistics counter clear log clear mac_based_access_control auth_state clear mld_snooping data_driven_group clear mld_snooping statistics counter clear port_security_entry config 802.1p default_priority
When entering a command without its required parameters, the CLI will prompt you with a Next possi ble completions: message.
DGS-1510-28XMP/ME:admin# config account Command: config account Next possible completions: <username>
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 sev eral l ayers of parameter prompting.
In addition, after typing any given command plus on e space, users 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 previ ous command will appear at the command prompt.
DGS-1510-28XMP/ME:admin#config account Command: config account Next possible completions: <username>
In the above example, the command config account was entered without the required parameter <username>, the CLI returned the Next possible completi on s: <username> prompt. The up arrow cursor control key was
3
DGS-1510/ME Series Metro Ethernet Switch CLI Reference Guide
DGS-1510-28XMP/ME:admin#
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, t he top-level commands will be displayed under the Available commands: prompt.
DGS-1510-28XMP/ME:admin#the Available commands: .. ? cable_diag cd cfm clear config copy create debug del delete dir disable download enable erase login logout md move no ping ping6 rd reboot reconfig rename reset save show smtp telnet traceroute traceroute6 upload
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, entering the show command with no additional parameters, the CLI will then display all of the possible next parameters.
4
DGS-1510/ME Series Metro Ethernet Switch CLI Reference Guide
DGS-1510-28XMP/ME:admin#
Command: show Next possible completions:
802.1p 802.1x access_profile account accounting acct_client address_binding arp_spoofing_prevention arpentry attack_log auth_client auth_diagnostics auth_session_statistics auth_statistics authen authen_enable authen_login authen_policy authentication authorization autoconfig bandwidth_control boot_file bpdu_protection cfm command command_history config cpu cpu_filter current_config ddm device_status dhcp_local_relay dhcp_relay dos_prevention dot1v_protocol_group dscp duld eee environment erps error ethernet_oam fdb filter flow_meter gratuitous_arp greeting_message gvrp hol_prevention igmp igmp_snooping ipif ipif_ipv6_link_local_auto iproute ipv6 ipv6route jumbo_frame l2protocol_tunnel lacp_port limited_multicast_addr link_aggregation lldp log log_save_timing log_software_module loopdetect mac_based_access_control mac_based_access_control_local mac_based_vlan mac_notification max_mcast_group mcast_filter_profile mirror mld_snooping multicast multicast_fdb nlb packet password_recovery per_queue poe port port_security port_security_entry port_vlan ports pppoe pvid qinq radius rmon router_ports safeguard_engine scheduling scheduling_mechanism serial_port session sim smtp snmp sntp ssh ssl storage_media_info stp switch syslog system_severity tech_support terminal tftp time time_range traffic traffic_segmentation trap trusted_host utilization vlan vlan_translation vlan_trunk
In the above example, all of the possible next parameters for the show command are displayed. A t the next command prompt, the up arrow was used to re-enter the show command, followed by the account parameter. The CLI then displays the user accounts config ured on the Switch.

1-3 Command Syntax Symbols

Each CLI command, available on this switch, c ontains certain syntax symbols that might be unf am il i ar to the inexperienced user. Each syntax symbol carri es a meaning and by knowing that meaning we can better understand how the command is used. All commands are case-sensitive. Be sure to disable the Caps Lock or any other unwanted function that changes text case.
5
DGS-1510/ME Series Metro Ethernet Switch CLI Reference Guide
Syntax Description
angle brackets < > This syntax is used to enclose a variable or a val ue. Users must enter the variable or
value. For example, in the config command_prompt [<string 16> | username | default] command, users must enter the command prompt string value and NOT the parameter <string 16>.
square brackets [ ] This syntax is used to enclose a required value or li st of required arguments. Only one
value or argument must be specified. For example, in the config command_prompt [<string 16> | username | default] command, users must enter either the command prompt string, select the username, or select t he default option. Do not type the square brackets.
vertical bar | This syntax is used to separate mutually ex clusive items in a list. For example, in the
reset {[config | system]} {force_agree} command, users may choose config or system in the command. Do not type the vertical bar.
braces { } This syntax is used to enclose an optional value or a list of optional arguments. One or
more values or arguments can be specified. For example, in the reset {[config | system]} {force_agree} command, users may choose conf ig or system in the command. Do not type the braces.
parentheses ( ) This syntax is used to indicate that at least one or more of the values or arguments in
the preceding syntax enclosed by braces must be specified. For example, in the config dhcp_relay {hops <int 1-16> | time <sec 0-65535>}(1) command, users have the option to specify hops or time or both of them. The " (1)" following the set of braces indicates at least one argument or value within the brace s must be specified. Do not type the parentheses.
ipif <ipif_name 12> In this syntax example, the value 12 means that the IP interface name can be up to 12
characters long.
metric <value 1-31> In this syntax example, the values 1-31 means that the metric value must be between
1 and 32.

1-4 Line Editing Keys

Keys Description
Delete This key specifies to delete the character under the cursor and to shift the remainder
of the line to the left.
Backspace This key specifies to delete the character t o the left of cursor and shift the remainder of
the line to the left.
CTRL+R This key specifies to replace text characters with newly typed text or to insert newly
typed text within the existing sentence. This is simi l ar to the Insert key.
Up Arrow This key specifies to repeat the previously entered com m and. 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 hi st ory list.
Down Arrow This key specifies to 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. Left Arrow This key specifies to move the cursor to the left . Right Arrow This key specifies to move the cursor to the right. Tab This key specifies to help users to select the appropriate token.
6
DGS-1510/ME Series Metro Ethernet Switch CLI Reference Guide
CTRL+C ESC q Quit SPACE n Next Page p Previous Page r Refresh

1-5 Multiple Page Display Control Keys

When CLI paging is enabled, the screen display will pause w hen the show command output reaches the end of t he page, as shown below.
DGS-1510-28XMP/ME:admin#show stp ports Command: show stp ports
MSTP Port Information
---------------------­ Port Index : 1 , Hello Time: 2 /2 , Port STP : Enabled , External PathCost : Auto/200000 , Edge Port : True /No , P2P : Auto /Yes Port RestrictedRole : False, Port RestrictedTCN : False Port Forward BPDU : Disabled MSTI Designated Bridge Internal PathCost Prio Status Role
----- ------------------ ----------------- ---- ---------- ---------­ 0 N/A 200000 128 Forwarding NonStp
The following control keys will then be available:
Keys Description
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. q Stops the display of remaining pages when multiple pages are to be displayed. SPACE Displays the next page. n Displays the next page. p Displays the previous page. r Refreshes the pages currently displayed. a Displays the remaining pages without pausing between pages. Enter Display s the next line or table entry.
7
DGS-1510/ME Series Metro Ethernet Switch CLI Reference Guide
Chapter 2
show session 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 login logout ? clear show command_history config command_history <value 1-40> config greeting_message {default} show greeting_message config command_prompt [<string 16> | username | def aul t]
Basic Command List
config terminal width [default | <value 80-200>] show terminal width config ports [<portlist> | all] {medium_type [fiber | copper]} {speed [auto | 10_half | 10_full | 100_half | 100_full |
1000_full {[master | slave]} | 10g_full] | flow_control [enable | disable] | learning [enable | disable] | state [enable | disable] | mdix [auto | normal | cross] | [description <desc 1-32> | clear_description]}
show ports {<portlist>} {[description | err_disabled | details | media_type]}

2-1 show session

Description

This command is used to display a list of current l y users which are login to the Switch.

Format

show session

Parameters

None.

Restrictions

Only Administrators and Operators can issue this command.

Example

To display the session entries:
8
DGS-1510/ME Series Metro Ethernet Switch CLI Reference Guide
CTRL+C ESC q Quit SPACE n Next Page p Previous Page r Refresh
DGS-1510-28XMP/ME:admin#
ID Live Time From Level Name
--- ------------ --------------------------------------- ----- --------------­ 0 00:01:46.360 10.90.90.10 puser puser 8 00:05:49.340 Serial Port admin admin
Total Entries: 2

2-2 show serial_port

Description

This command is used to display the current serial port settings.

Format

show serial_port

Parameters

None.

Restrictions

None.

Example

To display the serial port setting:
DGS-1510-28XMP/ME:admin# show serial_port Command: show serial_port
Baud Rate : 115200 Data Bits : 8 Parity Bits : None Stop Bits : 1 Auto-Logout : 10 mins

2-3 config serial_port

Description

This command is used to configure the serial bit rate that will be used to communicate with the management host and the auto logout time for idle connections.
9
DGS-1510/ME Series Metro Ethernet Switch CLI Reference Guide
DGS-1510-28XMP/ME:admin#

Format

config serial_port {baud_rate [9600 | 19200 | 38400 | 115200] | auto_logout [never | 2_minutes | 5_minutes | 10_minutes | 15_minutes]}

Parameters

baud_rate - (Optional) Specifies the serial bit rate that will be used to communicate with the management host.
The default baud rate is 115200.
9600 - Specifies the serial bit rate to be 9600. 19200 - Specifies the serial bit rate to be 19200. 38400 - Specifies the serial bit rate to be 38400. 115200 - Specifies the serial bit rate to be 115200.
auto_logout - (Optional) Specifies the auto logout time out setting.
never - Never timeout. 2_minutes - Specifies that the device will auto logout when idle over 2 minutes. 5_minutes - Specifies that the device will auto logout 2hen idle over 5 minutes. 10_minutes - Specifies that the device will auto logout when idle over 10 min utes. 15_minutes - Specifies that the device will auto logout when idle over 15 min utes.

Restrictions

Only Administrators and Operators can issue thi s command.

Example

To configure baud rate:
DGS-1510-28XMP/ME:admin# config serial_port baud_rate 9600 Command: config serial_port baud_rate 9600
Success.

2-4 enable clipaging

Description

This command is used to enable the pausing of t he screen display when the show command output reaches the end of the page. The default setting is enabled.

Format

enable clipaging

Parameters

None.

Restrictions

Only Administrators and Operators can issue thi s command.
10
DGS-1510/ME Series Metro Ethernet Switch CLI Reference Guide
DGS-1510-28XMP/ME:admin#
DGS-1510-28XMP/ME:admin#

Example

To enable pausing of the screen display when sho w command output reaches the end of the page:
DGS-1510-28XMP/ME:admin# enable clipaging Command: enable clipaging
Success.

2-5 disable clipaging

Description

This command is used to disable the pausing of t he screen display when the show command output reaches the end of the page. The default setting is enabled.

Format

disable clipaging

Parameters

None.

Restrictions

Only Administrators and Operators can issue thi s command.

Example

To disable pausing of the screen display when sho w c om m and output reaches the end of the page:
DGS-1510-28XMP/ME:admin# disable clipaging Command: disable clipaging
Success.

2-6 login

Description

This command is used to allow user login to the Switch.

Format

login
11
DGS-1510/ME Series Metro Ethernet Switch CLI Reference Guide
DGS-1510-28XMP/ME:admin#

Parameters

None.

Restrictions

None.

Example

To login the Switch with a user name dlink:
DGS-1510-28XMP/ME:admin# login Command: login
UserName:dlink PassWord:****

2-7 logout

Description

This command is used to logout the facility.

Format

logout

Parameters

None.

Restrictions

None.

Example

To logout current user:
12
DGS-1510/ME Series Metro Ethernet Switch CLI Reference Guide
UserName:
DGS-1510-28XMP/ME:admin#
DGS-1510-28XMP/ME:admin# logout Command: logout
********** * Logout * **********
DGS-1510-28XMP/ME Gigabit Ethernet Switch
Command Line Interface
Firmware: Build 1.00.018
Copyright(C) 2015 D-Link Corporation. All rights reserved.

2-8 ?

Description

This command is used to display the usage desc ri ption for all commands or the specific one.

Format

?

Parameters

None.

Restrictions

None.

Example

To get “ping” command usage, descriptions:
DGS-1510-28XMP/ME:admin#? ping Command: ? ping
Command: ping Usage: <ipaddr> { times <value 1-255> | timeout <sec 1-99>} Description: Used to test the connectivity between network devices.

2-9 clear

Description

The command is used to clear screen.
13
DGS-1510/ME Series Metro Ethernet Switch CLI Reference Guide
DGS-1510-28XMP/ME:admin#

Format

clear

Parameters

None.

Restrictions

None.

Example

To clear screen:
DGS-1510-28XMP/ME:admin# clear Command: clear

2-10 show command_history

Description

The command is used to display command history.

Format

show command_history

Parameters

None.

Restrictions

None.

Example

To display command history:
14
DGS-1510/ME Series Metro Ethernet Switch CLI Reference Guide
DGS-1510-28XMP/ME:admin#
DGS-1510-28XMP/ME:admin#
DGS-1510-28XMP/ME:admin# show command_history Command: show command_history
? ping login show serial_port show session ? config bpdu_protection ports ? reset ? create account ? create ipif show the ?

2-11 config command_history

Description

This command is used to configure the numbe r of commands that the Switch can recall. The Switch “ remembers” up to the last 40 commands you entered.

Format

config command_history <value 1-40>

Parameters

<value 1-40> - Enter the number of command s t hat the Switch can recall. This value must be betwe en 1 and 40.

Restrictions

Only Administrators and Operators can issue this command.

Example

To configure the number of command history:
DGS-1510-28XMP/ME:admin# config command_history 25 Command: config command_history 25
Success.

2-12 config greeting_message

Description

This command is used to configure the greeting message (or banner).
15
DGS-1510/ME Series Metro Ethernet Switch CLI Reference Guide
-------------------------------------------------------------------------------

Format

config greeting_message {default}

Parameters

default - (Optional) Specifies to return the greeting message (banner) t o its original factory default entry.

Restrictions

Only Administrators and Operators can issue thi s command.

Example

To edit the banner:
DGS-1510-28XMP/ME:admin#config greeting_message Command: config greeting_message
Greeting Messages Editor ================================================================================
DGS-1510-28XMP/ME Gigabit Ethernet Switch Command Line Interface
Firmware: Build 1.00.018 Copyright(C) 2015 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

2-13 show greeting_message

Description

The command is used to display greeting message.

Format

show greeting_message

Parameters

None.
16
DGS-1510/ME Series Metro Ethernet Switch CLI Reference Guide
DGS-1510-28XMP/ME:admin#

Restrictions

Only Administrators and Operators can issue thi s command.

Example

To display greeting message:
DGS-1510-28XMP/ME:admin#show greeting_message Command: show greeting_message
================================================================================
DGS-1510-28XMP/ME Gigabit Ethernet Switch Command Line Interface
Firmware: Build 1.00.018 Copyright(C) 2015 D-Link Corporation. All rights reserved. ================================================================================

2-14 config command_prompt

Description

This command is used to modify the command prompt. The current command prompt consists of f our parts: “product name” + “:” + ”user level” + ”#” (e.g. “DGS-1510-
28XMP/ME:admin# ”). This command is used t o m odi fy the first part (1. “product name”) with a string consisting of a maximum of 16 characters, or to be replaced with the users’ login user name.
When issuing the reset command, the current command prompt will remain the same. However, when issuing the
reset system command, the command prompt will return to its original factory default value.

Format

config command_prompt [<string 16> | username | default]

Parameters

<string 16> - Enter the new command prompt string of no more than 16 characters. username - Specifies to set the login username as the command prom pt. default - Specifies to return the command prompt to its original factory default value.

Restrictions

Only Administrators and Operators can issue thi s command.

Example

To edit the command prompt:
17
DGS-1510/ME Series Metro Ethernet Switch CLI Reference Guide
Prompt#:admin#
DGS-1510-28XMP/ME:admin#
DGS-1510-28XMP/ME:admin# config command_prompt Prompt# Command: config command_prompt Prompt#
Success.

2-15 config terminal width

Description

The command is used to set current terminal width. The usage is described as below:
1. Users login and configure the terminal width to 120, this configuration take effect on this login section. If users implement “save” command, the confi guration is saved. After users log out and log in again, the terminal width is 120.
2. If user did not save the configuration, another user login, the terminal width is default value.
3. If at the same time, two CLI sessions are running, once section configure to 120 width and save it, the other section will not be effected, unless it log out and then log in.

Format

config terminal width [default | <value 80-200>]

Parameters

default - Specifies the default setting of terminal width. The default value is 80. <value 80-200> - Enter the terminal width to be configured. The width is between 80 and 200 characters.

Restrictions

None.

Example

To configure the current terminal width:
DGS-1510-28XMP/ME:admin# config terminal width 120 Command: config terminal width 120
Success.

2-16 show terminal width

Description

The command is used to display the configuration of current terminal width.
18
DGS-1510/ME Series Metro Ethernet Switch CLI Reference Guide
DGS-1510-28XMP/ME:admin#

Format

show terminal width

Parameters

None.

Restrictions

None.

Example

To display the configuration of current terminal width:
DGS-1510-28XMP/ME:admin# show terminal width Command: show terminal width
Global terminal width : 80 Current terminal width : 80

2-17 config ports

Description

This command is used to configure the Switch's port settings.

Format

config ports [<portlist> | all] {medium_type [fiber | copper]} {speed [auto | 10_hal f | 10_ ful l | 100_h al f | 100_full | 1000_full {[master | slave]} | 10g_full] | flow_control [enable | disable] | learning [enable | disable] | state [enable | disable] | mdix [auto | normal | cross] | [description <d esc 1-32> | clear_description]}

Parameters

<portlist> - Enter a list of ports used here. all - Specifies that all the ports will be used for this configuration. medium_type - (Optional) Specifies the medium type while the configure ports are combo ports.
fiber - Specifies that the medium type will be set to fiber. copper - Specifies that the medium type will be set to copper.
speed - (Optional) Specifies the port speed of the specified ports.
auto - Specifies the port speed to auto negotiation. 10_half - Specifies the port speed to 10_half. 10_full - Specifies the port speed to 10_full. 100_half - Specifies the port speed to 100_half. 100_full - Specifies the port speed to 100_full. 1000_full - Specifies the port speed to 1000_full. While set port speed to 1000_full,user should specify m aster
or slave mode for 1000 base TX interface, and leave the 1000_full without any master or slave set ting for other interface.
master - Specifies that the port(s) will be set to master.
19
DGS-1510/ME Series Metro Ethernet Switch CLI Reference Guide
slave - Specifies that the port(s) will be set to slave.
DGS-1510-28XMP/ME:admin#
10g_full - Specifies the port speed to 10g_full.
flow_control - (Optional) Specifies to turn on or turn off flow control on one or more ports.
enable - Specifies that the flow control option will be enabled. disable - Specifies that the flow control option will be disabled.
learning - (Optional) Specifies to turn on or turn off MAC address learni ng on one or more ports.
enable - Specifies that the learning option will be enabled. disable - Specifies that the learning option will be disabled.
state - (Optional) Specifies to enable or disable the specified port. If the specified ports are in error-disabled
status , configure their state to enable will recover these ports from disabled to enable state.
enable - Specifies that the port state will be enabled. disable - Specifies that the port state will be disabled.
mdix - (Optional) Specifies the MDIX mode.
auto - Specifies the MDIX mode for the port to be auto. normal - Specifies the MDIX mode for the port to be normal. If set to normal state, the port is in the MDIX
mode and can be connected to a PC’s NIC using a straight -th rough cable or a port (in the MDIX mode) on another switch through a cross-over cable.
cross - Specifies the MDIX mode for the port to be cross. If set to cross state, the port is in the MDI mod e and
can be connected to a port (in the MDIX mode) on another switch through a straight cable.
description - (Optional) Specifies the description of the port interface.
<desc 1-32> - Enter the port interface description here . This value can be up to 32 characters long.
clear_description - (Optional) Specifies that the description field will be cleared.

Restrictions

Only Administrators and Operators can issue thi s command.

Example

To configure the ports:
DGS-1510-28XMP/ME:admin# config ports all medium_type copper speed auto Command: config ports all medium_type copper speed auto
Success.

2-18 show ports

Description

This command is used to display the current configurations of a range of ports.

Format

show ports {<portlist>} {[description | err_disabled | details | media_type]}
20
DGS-1510/ME Series Metro Ethernet Switch CLI Reference Guide
CTRL+C ESC q Quit SPACE n Next Page p Previous Page r Refresh

Parameters

ports - Specifies a range of ports to be displayed.
<portlist> - (Optional) Enter the list of ports to be configured here.
description - (Optional) Specifies to indicate if port description will be included in the display . err_disabled - (Optional) Specifies to indicate if ports are disabled by some reasons will be displayed. details - (Optional) Specifies to display the port details. media_type - (Optional) Specifies to display port transceiver type.

Restrictions

None.

Example

To display the port details:
DGS-1510-28XMP/ME:admin#show ports details Command: show ports details
Port : 1
-------------------­Port Status : Link Up Description : HardWare Type : Gigabits Ethernet MAC Address : 00-01-02-03-04-01 Bandwidth : 100000Kbit Auto-Negotiation : Enabled Duplex Mode : Full Duplex Flow Control : Disabled MDI : Normal Address Learning : Enabled Loopback Mode : Disabled Last Clear of Counter : 6 hours 57 mins ago BPDU Hardware Filtering Mode: Disabled Queuing Strategy : FIFO TX Load : 0/100, 0 bits/sec, 0 packets/sec RX Load : 0/100, 0 bits/sec, 0 packets/sec
21
DGS-1510/ME Series Metro Ethernet Switch CLI Reference Guide
Chapter 3
create vlan <vlan_name 32> tag <vlanid 2-4094> {type 1q_vlan advertisement} create vlan vlanid <vidlist> {advertisement} delete vlan <vlan_name 32> delete vlan vlanid <vidlist> config vlan <vlan_name 32> {[add [tagged | untagg ed | forbidden] | delete] <portlist> | advertisement [enable |
disable]}(1)
config vlan vlanid <vidlist> {[add [tagged | untagged | forbidden] | delete] <portlist> | advertisement [enable |
disable] | name <vlan_name 32>}(1)
config port_vlan [<portlist> | all] {gvrp_state [ enable | disable] | ingress_checking [enable | disable] |
acceptable_frame [tagged_only | admit_all ] | pvid <vlanid 1-4094>}(1)
show vlan {<vlan_name 32>} show vlan ports {<portlist>} show vlan vlanid <vidlist> show port_vlan {<portlist>} enable pvid auto_assign disable pvid auto_assign
802.1Q VLAN Command List
show pvid auto_assign config gvrp [timer {join < value 100-100000> | leave < value 100-100000> | leaveall <value 100-100000>} |
nni_bpdu_addr [dot1d | dot1ad]]
show gvrp enable gvrp disable gvrp

3-1 create vlan

Description

This command is used to create a VLAN on the Switch. The VLAN ID must be always specified for creating a VLAN.

Format

create vlan <vlan_name 32> tag <vlanid 2-4094> {t ype 1q_vlan advertisement}

Parameters

vlan - Specifies the name of the VLAN to be created.
<vlan_name 32> - Enter the VLAN name here. T he VLAN name can be up to 32 characters long.
tag - Specifies the VLAN ID of the VLAN to be created.
<vlanid 2-4094> - Enter the VLAN ID here. The VLAN ID value must be between 2 and 4094.
type 1q_vlan advertisement - (Optional) Specifies that the VLAN type used is based on the 802.1Q standard
and being able to be advertised out.
22
DGS-1510/ME Series Metro Ethernet Switch CLI Reference Guide
DGS-1510-28XMP/ME:admin#
DGS-1510-28XMP/ME:admin#

Restrictions

Only Administrators, Operators and Power-Users can issue this command.

Example

To create a VLAN with name “v2” and VLAN ID 2:
DGS-1510-28XMP/ME:admin# create vlan v2 tag 2 type 1q_vlan advertisement Command: create vlan v2 tag 2 type 1q_vlan advertisement
Success.

3-2 create vlan vlanid

Description

This command is used to create more than one VLANs at a time. A unique VLAN name (e.g. VLAN10) will be automatically assigned by the system. The aut om atic assignment of VLAN name is based on the following rule: “VLAN”+ID. For example, for VLAN ID 100, t he VLAN name will be VLAN100. If this VLAN name is c onflict with the name of an existing VLAN, then it will be renamed based on the following rule: “VLAN”+ID+”ALT”+ collision count. For example, if this conflict is the second colli sion, then the name will be VLAN100ALT2.

Format

create vlan vlanid <vidlist> {advertisement}

Parameters

vlanid - Specifies the VLAN ID list to be created.
<vidlist> - Enter the VLAN ID list here.
advertisement - (Optional) Specifies the VLAN as being able to be advertised out.

Restrictions

Only Administrators, Operators and Power-Users can issue this command.

Example

To create some VLANs using VLAN ID:
DGS-1510-28XMP/ME:admin# create vlan vlanid 10-30 Command: create vlan vlanid 10-30
Success.
23
DGS-1510/ME Series Metro Ethernet Switch CLI Reference Guide
DGS-1510-28XMP/ME:admin#

3-3 delete vlan

Description

This command is used to delete a previously co nfigured VLAN by the name on the Switch.

Format

delete vlan <vlan_name 32>

Parameters

vlan - Specifies the VLAN name of the VLAN to be deleted.
<vlan_name 32> - Enter the VLAN name here. T his name can be up to 32 characters long.

Restrictions

Only Administrators, Operators and Power-Users can issue this command.

Example

To remove a vlan v1:
DGS-1510-28XMP/ME:admin# delete vlan v1 Command: delete vlan v1
Success.

3-4 delete vlan vlanid

Description

This command is used to delete one or a numbe r of previously configured VLAN by VID list.

Format

delete vlan vlanid <vidlist>

Parameters

vlanid - Specifies the VLAN ID list to be deleted.
<vidlist> - Enter the VLAN ID list here.

Restrictions

Only Administrators, Operators and Power-Users can issue this command.
24
DGS-1510/ME Series Metro Ethernet Switch CLI Reference Guide
DGS-1510-28XMP/ME:admin#
DGS-1510-28XMP/ME:admin#

Example

To remove VLANs from 10-30:
DGS-1510-28XMP/ME:admin# delete vlan vlanid 10-30 Command: delete vlan vlanid 10-30
Success.

3-5 config vlan

Description

This command is used to configure a VLAN based on the name.

Format

config vlan <vlan_name 32> {[add [tagged | untagged | forbidden] | delete] <portlist> | ad vertisement [enable | disable]}(1)

Parameters

<vlan_name 32> - Enter the VLAN name you want to add ports to. This name can be up to 32 chara ct ers long. add - Specifies to add tagged, untagged or forbidden ports to the VLA N.
tagged - Specifies the additional ports as tagged. untagged - Specifies the additional ports as untagge d.
forbidden - Specifies the additional ports as forbidden. delete - Specifies to delete ports from the V LA N. <portlist> - Enter the list of ports used for the configuration here. advertisement - Specifies the GVRP state of this VLAN.
enable - Specifies to enable advertisement for this VLAN.
disable - Specifies to disable advertisement for this VLAN.

Restrictions

Only Administrators, Operators and Power-Users can issue this command.

Example

To add 4 through 8 as tagged ports to the VLAN v2:
DGS-1510-28XMP/ME:admin# config vlan v2 add tagged 4-8 Command: config vlan v2 add tagged 4-8
Success.
25
DGS-1510/ME Series Metro Ethernet Switch CLI Reference Guide
DGS-1510-28XMP/ME:admin#

3-6 config vlan vlanid

Description

This command allows you to configure multiple V LANs at one time. But conflicts will be generat ed i f you configure the name of multiple VLANs at one time.

Format

config vlan vlanid <vidlist> {[add [tagged | untagged | forbidden] | delete] <po rtlist> | advertisement [enable | disable] | name <vlan_name 32>}(1)

Parameters

<vidlist> - Enter a list of VLAN IDs to configure. add - Specifies to add tagged, untagged or forbidden ports to the V LA N.
tagged - Specifies the additional ports as tagged.
untagged - Specifies the additional ports as untagge d.
forbidden - Specifies the additional ports as forbidden. delete - Specifies to delete ports from the V LA N. <portlist> - Enter the list of ports used for the configuration her e. advertisement - Specifies the GVRP state of this VLAN.
enable - Specifies to enable advertisement for this VLAN.
disable - Specifies to disable advertisement for this VLAN. name - Specifies the new name of the VLAN.
<vlan_name 32> - Enter the VLAN name here. T his name can be up to 32 characters long.

Restrictions

Only Administrators, Operators and Power-Users can issue this command.

Example

To add 4 through 8 as tagged ports to the VLAN ID f rom 10-20:
DGS-1510-28XMP/ME:admin# config vlan vlanid 10-20 add tagged 4-8 Command: config vlan vlanid 10-20 add tagged 4-8
Success.

3-7 config port_vlan

Description

This command is used to set the ingress checking status, the sending and receiving GVRP information.

Format

config port_vlan [<portlist> | all] {gvrp_state [enable | d isable] | ingress_checking [enable | disable] | acceptable_frame [tagged_only | admit_al l] | pvid <vlanid 1-4094>}(1)
26
Loading...
+ 624 hidden pages