How it Works
D-Link
Loading...
dgs-3420
User Manual
938 pgs4.9 Mb0
User Manual
10 pgs1.1 Mb0
Table of contents
Loading...

D-Link dgs-3420 User Manual

xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide
I
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide
Table of Contents
Chapter 1 Using Command Line Interface ........................................................................................... 1
Chapter 2 Basic Management Commands .......................................................................................... 8
Chapter 3 802.1X Commands............................................................................................................ 30
Chapter 4 Access Authentication Control (AAC) Commands ............................................................ 56
Chapter 5 Access Control List (ACL) Commands.............................................................................. 78
Chapter 6 Access Control List (ACL) Egress Command List .......................................................... 107
Chapter 7 ARP Commands.............................................................................................................. 126
Chapter 8 ARP Spoofing Prevention Commands ............................................................................ 131
Chapter 9 Asymmetric VLAN Commands ........................................................................................ 133
Chapter 10 Auto Configuration Commands ................................................................................... 135
Chapter 11 Basic IP Commands .................................................................................................... 138
Chapter 12 BPDU Attack Protection Commands........................................................................... 147
Chapter 13 Cable Diagnostics Commands .................................................................................... 152
Chapter 14 CFM Commands ......................................................................................................... 155
Chapter 15 Command List History Commands ............................................................................. 182
Chapter 16 Command Logging Command List.............................................................................. 185
Chapter 17 Common Unicast Routing Command List ................................................................... 187
Chapter 18 Compound Authentication Commands ....................................................................... 193
Chapter 19 Debug Software Command List .................................................................................. 203
Chapter 20 DHCP Local Relay Commands ................................................................................... 229
Chapter 21 DHCP Relay Commands ............................................................................................ 233
Chapter 22 DHCP Server Commands ........................................................................................... 248
Chapter 23 DHCPv6 Relay Command List .................................................................................... 274
Chapter 24 DHCPv6 Server Commands ....................................................................................... 279
Chapter 25 Domain Name System (DNS) Relay Commands ....................................................... 293
Chapter 26 Domain Name System (DNS) Resolver Commands .................................................. 298
Chapter 27 DoS Attack Prevention Commands............................................................................. 305
Chapter 28 D-Link Unidirectional Link Detection (DULD) Commands .......................................... 310
Chapter 29 Ethernet Ring Protection Switching (ERPS) Commands ............................................ 312
Chapter 30 External Alarm Commands ......................................................................................... 322
Chapter 31 FDB Commands .......................................................................................................... 324
Chapter 32 File System Management Commands ........................................................................ 333
Chapter 33 Filter Comm a nds ......................................................................................................... 343
Chapter 34 Gratuitous ARP Commands ........................................................................................ 350
II
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide
Chapter 35
Chapter 36 IGMP Snooping Commands ....................................................................................... 360
Chapter 37 IGMP Snooping Multicast (ISM) VLA N Commands .................................................... 381
Chapter 38 IP Routing Commands ................................................................................................ 392
Chapter 39 IP Tunnel Commands ................................................................................................. 397
Chapter 40 IPv6 NDP Commands ................................................................................................. 406
Chapter 41 IP-MAC-Port Binding (IMPB) Commands ................................................................... 413
Chapter 42 Japanese Web-based Access Control (JWAC) Commands ....................................... 434
Chapter 43 Jumbo Frame Commands ........................................................................................... 458
Chapter 44 LACP Configuration Commands ................................................................................. 461
Chapter 45 Layer 2 Protocol Tunneling (L2PT) Command List ..................................................... 463
Chapter 46 Limited Multicast IP Address Commands ................................................................... 468
Chapter 47 Link Aggregation Commands ...................................................................................... 477
Chapter 48 LLDP Commands ........................................................................................................ 482
Chapter 49 Loopback Detection Commands ................................................................................. 505
Chapter 50 Loopback Interface Commands .................................................................................. 512
Chapter 51 MAC Notification Commands ...................................................................................... 515
Chapter 52 MAC-based Access Control Commands .................................................................... 520
Chapter 53 Mirror Commands........................................................................................................ 536
Chapter 54 MLD Proxy Commands ............................................................................................... 542
Chapter 55 MLD Snooping Commands ......................................................................................... 547
Chapter 56 MLD Snooping Multicast (MSM) VLAN Com mands ................................................... 566
Chapter 57 Modify Login Banner and Prompt Commands ............................................................ 577
Chapter 58 Network Load Balancing (NLB) Commands ............................................................... 581
Chapter 59 Network Management Commands .............................................................................. 585
Chapter 60 Network Monitoring Commands .................................................................................. 602
Chapter 61 OAM Commands ......................................................................................................... 620
Chapter 62 Packet Storm Commands ........................................................................................... 627
Chapter 63 Password Recovery Commands ................................................................................. 632
Chapter 64 Port Security Commands ............................................................................................ 635
Chapter 65 Power over Ethernet (PoE) Commands ...................................................................... 643
Chapter 66 Power Saving Commands ........................................................................................... 648
Chapter 67 Precision Time Protocol (PTP) Commands ................................................................ 650
Chapter 68 Protocol VLAN Commands ......................................................................................... 668
Chapter 69 QoS Commands .......................................................................................................... 674
Chapter 70 Q-in-Q Command ........................................................................................................ 688
III
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide
Chapter 71
Chapter 72 RIPng Commands ....................................................................................................... 701
Chapter 73 RSPAN Commands..................................................................................................... 705
Chapter 74 Safeguard Engine Commands .................................................................................... 711
Chapter 75 sFlow Commands........................................................................................................ 713
Chapter 76 Single IP Management Commands ............................................................................ 724
Chapter 77 SMTP Commands ....................................................................................................... 734
Chapter 78 SNMPv1/v2/v3 Commands ......................................................................................... 739
Chapter 79 Spanning Tree Protocol (STP) commands ................................................................. 756
Chapter 80 SSH Commands.......................................................................................................... 769
Chapter 81 SSL Commands .......................................................................................................... 777
Chapter 82 Stacking Commands ................................................................................................... 783
Chapter 83 Static MAC-based VLAN Commands ......................................................................... 790
Chapter 84 Static Replication Commands ..................................................................................... 793
Chapter 85 Subnet VLAN Commands ........................................................................................... 800
Chapter 86 Switch Port Commands ............................................................................................... 806
Chapter 87 System Severity Commands ....................................................................................... 810
Chapter 88 Tech Support Commands ........................................................................................... 812
Chapter 89 Time and SNTP Commands ....................................................................................... 815
Chapter 90 Traffic Segmentation Commands ................................................................................ 822
Chapter 91 UDP Helper Commands .............................................................................................. 824
Chapter 92 Utility Commands ........................................................................................................ 830
Chapter 93 Voice VLAN Commands ............................................................................................. 853
Chapter 94 VLAN Commands........................................................................................................ 863
Chapter 95 VLAN Trunking Commands ........................................................................................ 880
Chapter 96 Web-based Access Control (WAC) Commands ......................................................... 884
Appendix A Mitigating ARP Spoofing Attacks Using Packet Content ACL .................................... 898
Appendix B Password Recovery Procedure ................................................................................... 906
Appendix C System Log Entries ..................................................................................................... 908
Appendix D Trap Entries ................................................................................................................. 927
Appendix E RADIUS Attributes Assignment ................................................................................... 931
IV
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide
Chapter 1 Using Command Line
Interface
The DGS-3420 Layer 2+ stackable Gigabit Ethernet switch series are members of the D-Link xStack® family. Ranging from 10/100/1000Mbps edge switches to core gigabit switches, the xStack tolerance, flexibility, port density, robust security and maximum throughput with a user-friendly management interface for the networking professional.
The Switch can be managed through the Switch’s serial port, Telnet, SNMP 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. Every command will be introduced in terms of purpose, format, description, parameters, and examples. Configuration and management of the Switch via the Web-based management agent are discussed in the Web UI Reference Guide. For detailed information on installi ng h ardware please also refer to the Harware Installation Guide.
®
switch family has been future-proof designed to provide a stacking architecture with fault

1-1 Accessing the Switch via the Ser ial 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 RJ-45 to RS­232 DB-9 convertor cable.
With the serial port properly connected to a management computer, the following screen should be visible.
DGS-3420-28SC Gigabit Ethernet Switch
Command Line Interface
Firmware: Build 1.00.024
Copyright(C) 2011 D-Link Corporation. All rights reserved.
UserName:
There is no initial username or password. Just press the Enter key twice to display the CLI input cursor − DGS-3420-28SC:admin#. This is the command line where all commands are input.
1
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide
Boot Procedure V1.00.006
DGS-3420-28SC:admin# config ipif System ipaddress 10.24.22.100/255.0.0.0
DGS-3420-28SC:admin#

1-2 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.
-------------------------------------------------------------------------------
Power On Self Test ........................................ 100 %
MAC Address : 00-01-02-03-04-00 H/W Version : A1
Please Wait, Loading V1.00.024 Runtime Image .............. 100 %
UART init ................................................. 100 %
Starting runtime image
Device Discovery .......................................... 100 %
Configuration init ........................................ 100 %
The Switch’s MAC address can also be found in the Web management program on the Device Information (Basic Settings) window on the Configuration menu.
The IP address for the S wit c h must be set before it ca n 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.
Starting at the command line prompt, enter the commands config ipif System ipaddress xxx.xxx.xxx.xxx/yyy.yyy.yyy.yyy. Where the x’s represent the IP address to be assigned to the IP interface named System and the y’s represent the corresponding subnet mask.
Alternatively, you can enter config ipif System ipaddress xxx.xxx.xxx.xxx/z. Where the x’s represent the IP address to be assigned to the IP interface named System a nd th e 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.
Command: config ipif System ipaddress 10.24.22.100/8
Success.
2
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide
DGS-3420-28SC:admin#?
DGS-3420-28SC:admin#config account
DGS-3420-28SC:admin#
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 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.
There are a number of helpful features included in the CLI. Entering the ? c om mand will display a list of all of the top-level commands.
Command: ?
.. ? cable_diag ports cd cfm linktrace cfm lock md cfm loopback change drive clear clear address_binding dhcp_snoop binding_entry ports clear address_binding nd_snoop binding_entry ports clear arptable clear attack_log clear cfm pkt_cnt clear counters clear dhcp binding clear dhcp conflict_ip clear dhcpv6 binding clear ethernet_oam ports clear fdb clear igmp_snooping data_driven_group clear igmp_snooping statistics counter
CTRL+C ESC q Quit SPACE n Next Page ENTER Next Entry a All
When entering a command without its required parameters, the CLI will prompt you with a Next possible completions: message.
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 several layers of parameter prompting.
3
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide
DGS-3420-28SC:admin# config account
DGS-3420-28SC:admin# config account
DGS-3420-28SC:admin#the
DGS-3420-28SC:admin#show
In addition, after typing any given command plus one 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 previous command will appear at the command prompt.
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 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.
Available commands: .. ? cable_diag cd cfm change clear config copy create debug del delete dir disable download enable erase format login logout md move no ping ping6 rd reboot reconfig rename reset save show smtp telnet traceroute traceroute6 upload
DGS-3420-28SC:admin#
The top-level commands consist of commands such as show or config. Most of these commands require one or more param eter s to narr o w the top-level command. T his is equival ent 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
Command: show
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide
Next possible completions:
802.1p 802.1x access_profile account accounting acct_client address_binding arp_spoofing_prevention arpentry asymmetric_vlan 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 broadcast_ping_reply cfm command command_history community_encryption config cpu current_config ddm device_status dhcp dhcp_local_relay dhcp_relay dhcp_server dhcpv6 dhcpv6_relay dhcpv6_server dnsr dos_prevention dot1v_protocol_group duld egress_access_profile egress_flow_meter environment erps error ethernet_oam external_alarm fdb filter flow_meter gratuitous_arp greeting_message gvrp hol_prevention host_name igmp_proxy igmp_snooping ip_tunnel ipfdb ipif ipif_ipv6_link_local_auto ipmc_vlan_replication ipmc_vlan_replication_entry iproute ipv6 ipv6route jumbo_frame jwac l2protocol_tunnel lacp_port limited_multicast_addr link_aggregation lldp lldp_med log log_save_timing log_software_module loopback loopdetect mac_based_access_control mac_based_access_control_local mac_based_vlan mac_notification max_mcast_group mcast_filter_profile mirror mld_proxy mld_snooping multicast multicast_fdb name_server nlb out_band_ipif packet password_recovery per_queue port port_group port_security port_security_entry port_vlan ports power_saving private_vlan ptp pvid qinq radius rcp rip ripng rmon route router_ports rspan safeguard_engine scheduling scheduling_mechanism serial_port session sflow sim smtp snmp sntp ssh ssl stack_device stack_information stacking_mode storage_media_info stp subnet_vlan switch syslog system_severity tech_support terminal time time_range traffic traffic_segmentation trap trusted_host udp_helper utilization vlan vlan_precedence vlan_translation vlan_trunk voice_vlan wac
DGS-3420-28SC:admin#
5
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide
Syntax
Description
angle brackets < >
Encloses a variable or value. Users must specify the variable or value.
square brackets [ ]
Encloses a required value or list of required arguments. Only one
vertical bar |
Separates mutually exclusive items in a list. For example, in the syntax
parentheses ( )
Indicates at least one or more of the values or arguments in the
In the above example, all of the possible next parameters for the show command are displayed. At the next command prompt, the up arrow was used to re-enter the show command, followed by the account parameter. The CLI then displays the user accounts configured on the Switch.

1-3 Command Syntax Symbols

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.
For example, in the syntax
create ipif <ipif_name 12> {<network_address>} <vlan_name 32> {secondary | state [enable | disable] | proxy_arp [enable | disable] {local [enable | disable]}}
users must supply an IP interface name for <ipif_name 12> and a VLAN name for <vlan_name 32> when entering the command. DO NOT TYPE THE ANGLE BRACKETS.
value or argument must be specified. For example, in the syntax
create account [admin | operator | power_user | user] <username 15> {encrypt [plain_text | sha_1] <password>}
users must specify either the admin-, operator-, power_user-level or user-level account when entering the command. DO NOT TYPE THE SQUARE BRACKETS.
reset {[config |system]} {force_agree}
users may choose config or system in the command. DO NOT TYPE THE VERTICAL BAR.
braces { } Encloses an optional value or a list of optional arguments. One or
more values or arguments can be specified. For example, in the syntax reset {[config | system]} {force_agree} users may choose config or system in the command. DO NOT TYPE
THE BRACES.
preceding syntax enclosed by braces must be specified. For example, in the syntax
config dhcp_relay {hops <int 1-16> | time <sec 0-65535>}(1)
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 braces must be specified. DO NOT TYPE THE PARENTHESES.
6
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide
ipif <ipif_name 12>
12 means the maximum length of the IP interface name.
Keys
Description
Backspace
Delete character to left of cursor and shift remainder of line to left.
CTRL+R
Toggle on and off. When toggled on, inserts text and shifts previous
Up Arrow
Repeats the previously entered command. Each time the up arrow is
Left Arrow
Move cursor to left.
Tab
Help user to select appropriate token.
Keys
Description
CTRL+C
Stops the display of remaining pages when multiple pages are to be
ESC
Stops the display of remaining pages when multiple pages are to be n
Displays the next page.
p
Displays the previous page.
a
Displays the remaining pages without pausing between pages.
Enter
Displays the next line or table entry.
metric <value 1-31>
1-31 means the legal range of the metric value.

1-4 Line Editing Keys

Delete Delete character under cursor and shift remainder of line to left.
text to right.
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.
Right Arrow Move cursor to right
The screen display pauses when the show command output reaches the end of the page.

1-5 Multiple Page Display Control Keys

Space Displays the next page.
displayed.
displayed.
q Stops the display of remaining pages when multiple pages are to be
displayed.
r Refreshes the pages currently displayed.
7
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide
create account [admin | operator | power_user | user] <username 15> {encrypt [plain_text |
sha_1] <password>}
enable password encryption
disable password encryption
config account <username> {encrypt [plain_t ex t | sha_1] <pas sw ord>}
show account
delete account <username>
show session
show switch
show environment
config temperature [trap | log] state [enable | disable]
config temperature threshold {high <temperature -500-500> | low <temperature -500-500>}(1)
show serial_port
config serial_port { bau d_r at e [960 0 | 19200 | 38400 | 1152 00] | auto_l ogo ut [never | 2_minutes |
5_minutes | 10_minutes | 15_m inutes ]}( 1)
enable clipaging
disable clipaging
enable telnet {<tcp_port_number 1-65535>}
disable telnet
enable web {<tcp_port_number 1-65535>}
disable web
save {[config <pathname> | log | all]}
reboot {force_agree}
reset {[config | system]} {force_agree}
login
logout
clear
config terminal width [default | <value 80-200>]
show terminal width
show device_status
admin - Specify the name of the admin account.
Chapter 2 Basic Management
Commands

2-1 create account

Description

This command creates user accounts. The username is between 1 and 15 characters, the password is between 0 and 15 characters. The number of accounts (including admin, operator, power-user and user) is up to eight.

Format

create account [admin | operator | power_user | user] <username 15> {encrypt [plain_text | sha_1] <password>}

Parameters

8
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide
operator - Specify the name of the operator account.
power_user - Specify a power user level account. The power user level is lower than the
operator level and higher than the user level.
user - Specify the name of the user account.
<username 15> - Specify a username of up to 15 characters.
encrypt - Specifies the encryption used.
password, the length is fixed to 35 bytes long. The password is case-sensitive.
DGS-3420-28SC:admin#create account admin dlink
DGS-3420-28SC:admin##create account operator Sales
DGS-3420-28SC:admin##create account user System
plain_text - Specify the password in plain text form. sha_1 - Specify the password in SHA-1 encrypted form. <password> - The password for the user account. The length of a password in plain-text form
and encrypted form are different. For a plain-text form password, the password must be a minimum of 0 characters and a maximum of 15 characters. For an encrypted form

Restrictions

Only Administrator-level users can issue this command.

Example

To create the Administrator-level user “dlink”:
Command: create account admin dlink
Enter a case-sensitive new password:**** Enter the new password again for confirmation:**** Success.
DGS-3420-28SC:admin#
To create the Operator-level user “Sales”:
Command: create account operator Sales
Enter a case-sensitive new password:**** Enter the new password again for confirmation:**** Success.
DGS-3420-28SC:admin#
To create the User-lev el us er “System”:
Command: create account user System
Enter a case-sensitive new password:**** Enter the new password again for confirmation:**** Success.
DGS-3420-28SC:admin#
9
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide
DGS-3420-28SC:admin#enable password encryption

2-2 enable password encryption

Description

The user account configuration information will be stored in the configuration file, and can be applied to the system later. If the password encryption is enabled, the password will be in encrypted form when it is stored in the configuration file. When password encryption is disabled, the password will be in plain text form when it is stored in the configuration file. However, if the created user account directly uses the encrypted password, the password will still be in the encrypted form.

Format

enable password encryption

Parameters

None.

Restrictions

Only Administrator-level users can issue this command.

Example

To enable password encryption:
Command: enable password encryption
Success.
DGS-3420-28SC:admin#

2-3 disable password encryption

Description

The user account configuration information will be stored in the configuration file, and can be applied to the system later. If the password encryption is enabled, the password will be in encrypted form when it is stored in the configuration file. When password encryption is disabled, the password will be in plain text form when it is stored in the configuration file. However, if the created user account directly uses the encrypted password, the password will still be in the encrypted form.

Format

disable password encryption

Parameters

None.
10
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide
DGS-3420-28SC:admin#disable password encryption
DGS-3420-28SC:admin#
<username> - Specify the name of the account. The account must already be defined.
encrypt - (Optional) Spec if y the enc r yption t ype, plain_text or sha_1.
the length is fixed to 35 bytes long. The password is case-sensitive.
<password> - Specify the password.
DGS-3420-28SC:admin#config account dlink
Enter the new password again for confirmation:****

Restrictions

Only Administrator-level users can issue this command.

Example

To disable password encryption:
Command: disable password encryption
Success.

2-4 config account

Description

When the password information is not specified in the command, the system will prompt the user to input the password interactively. For this case, the user can only input the plain text password.
If the password is present in the command, the user can select to input the password in the plain text form or in the encrypted form. The encryption algorithm is based on SHA-1.

Format

config account <username> {encrypt [plain_text | sha_1] <password>}

Parameters

plain_text - Specify the password in plain text form. For the plain text form, passwords must
have a minimum of 0 and a maximum of 15 characters. The password is case-sensitive
sha_1 - Specify the password in the SHA-1 encrypted form. For the encrypted form password,

Restrictions

Only Administrator-level users can issue this command.

Example

To configure the user password of the “dlink” account:
Command: config account dlink
Enter a old password:**** Enter a case-sensitive new password:****
11
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide
Success.
DGS-3420-28SC:admin#config account administrator encrypt sha_1
DGS-3420-28SC:admin#show account
DGS-3420-28SC:admin#
To configure the user password of the “administrator” account:
*@&NWoZK3kTsExUV00Ywo1G5jlUKKv+toYg Command: config account administrator encrypt sha_1
*@&NWoZK3kTsExUV00Ywo1G5jlUKKv+toYg Success.
DGS-3420-28SC:admin#

2-5 show account

Description

This command is used to display user accounts that have been created.

Format

show account

Parameters

None.

Restrictions

Only Administrator-level users can issue this command.

Example

To display accounts that have been created:
Command: show account
Current Accounts: Username Access Level
--------------- -----------­System User Sales Operator dlink Admin
DGS-3420-28SC:admin#

2-6 delete account

Description

This command is used to delete an existing account.
12
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide
<username> - Specify the name of the user who will b e deleted .
DGS-3420-28SC:admin#delete account System
DGS-3420-28SC:admin#show session
8 23:37:42.270 Serial Port admin Anonymous

Format

delete account <username>

Parameters

Restrictions

Only Administrator-level users can issue this command. One active admin user must exist.

Example

To delete the user account “System”:
Command: delete account System
Success.
DGS-3420-28SC:admin#

2-7 show session

Description

This command is used to display a list of current users which are logged in to CLI sessions.

Format

show session

Parameters

None.

Restrictions

Only Administrator and Operator-level users can issue this command.

Example

To display accounts a list of currently logged-in users:
Command: show session
ID Live Time From Level User
-- ------------ ------------ ----- --------------------
13
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide
DGS-3420-28SC:admin#show switch
Telnet : Enabled (TCP 23)
Total Entries: 1
CTRL+C ESC q Quit SPACE n Next Page p Previous Page r Refresh

2-8 show switch

Description

This command is used to display the switch information.

Format

show switch

Parameters

None.

Restrictions

None.

Example

To display the switch information:
Command: show switch
Device Type : DGS-3420-28SC Gigabit Ethernet Switch MAC Address : 00-01-02-03-04-00 IP Address : 10.90.90.90 (Manual) VLAN Name : default Subnet Mask : 255.0.0.0 Default Gateway : 0.0.0.0 Boot PROM Version : Build 1.00.006 Firmware Version : Build 1.00.024 Hardware Version : A1 Serial Number : D1234567890 System Name : System Location : System Uptime : 0 days, 0 hours, 38 minutes, 12 seconds System Contact : Spanning Tree : Disabled GVRP : Disabled IGMP Snooping : Disabled MLD Snooping : Disabled RIP : Disabled RIPng : Disabled VLAN Trunk : Disabled
14
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide
Web : Enabled (TCP 80)
DGS-3420-28SC:admin#
DGS-3420-28SC:admin#show environment
High Warning Temperature Threshold(Celsius) : 79
SNMP : Disabled SSL Status : Disabled SSH Status : Disabled
802.1X : Disabled Jumbo Frame : Off CLI Paging : Enabled MAC Notification : Disabled Port Mirror : Disabled SNTP : Disabled HOL Prevention State : Enabled Syslog Global State : Disabled Single IP Management : Disabled Password Encryption Status : Disabled DNS Resolver : Disabled

2-9 show environment

Description

This command is used to display the device’s internal and external po wer and inter nal temperature status.

Format

show environment

Parameters

None.

Restrictions

None.

Example

To display the switch hardware status:
Command: show environment
Internal Power : Active External Power : Fail Right Fan 1 : Speed Low (3000 RPM) Right Fan 2 : Speed Low (3000 RPM) Current Temperature(Celsius) : 30 Fan High Temperature Threshold(Celsius) : 40 Fan Low Temperature Threshold(Celsius) : 35
15
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide
Low Warning Temperature Threshold(Celsius) : 11
trap - Specify to configure the warning temperature trap.
log - Specify to configure the warning temperature log.
state - Enable or disable either the trap or log state for a warning temperature event. The default
disable - Disable either the trap or log state for a warning temperature event.
DGS-3420-28SC:admin#config temperature trap state enable
DGS-3420-28SC:admin#
DGS-3420-28SC:admin#config temperature log state enable
DGS-3420-28SC:admin#
DGS-3420-28SC:admin#

2-10 config temperature

Description

This command is used to configure the warning trap or log state of the system internal temperature.

Format

config temperature [trap | log] state [enable | disable]

Parameters

is enable.
enable - Enable either the trap or log state for a warning temperature event.

Restrictions

Only Administrator and Operator-level users can issue this command.

Example

To enable the warning temperature trap state:
Command: config temperature trap state enable
Success.
To enable the warning temperature log state:
Command: config temperature log state enable
Success.
16
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide
high - Specify the high threshold value. The high threshold must bigger than the low threshold.
and 500.
low - Specify the low threshold value.
DGS-3420-28SC:admin#config temperature threshold high 80
DGS-3420-28SC:admin#

2-11 config temperature threshold

Description

This command is used to configure the warning temperature high threshold or low threshold. When temperature is above the high threshold or below the low threshold, SW will send alarm traps or keep the logs.

Format

config temperature threshold {high <temperature -500-500> | low <temp erat ure -500-500>}(1)

Parameters

<temperature -500-500> - Specify the high threshold value. This value must be between -500
<temperature -500-500> - Specify the low threshold value. This value must be between -500
and 500.

Restrictions

Only Administrator and Operator-level users can issue this command.

Example

To configure a warming temperature threshold high of 80:
Command: config temperature threshold high 80
Success.

2-12 show serial_port

Description

This command is used to display the current console port setting.

Format

show serial_port

Parameters

None.
17
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide
DGS-3420-28SC:admin#show serial_port
baud_rate - Specify the baud rate value. The default baud rate is 115200.
115200 - Specify a baud rate of 115200.
auto_logout - Specify the timeout value. The default timeout is 10_minutes.
15_minutes - Specify when the idle value is over 15 minutes, the device will auto logout.
DGS-3420-28SC:admin# config serial_port baud_rate 9600

Restrictions

None.

Example

To display the console port setting:
Command: show serial_port
Baud Rate : 115200 Data Bits : 8 Parity Bits : None Stop Bits : 1 Auto-Logout : 10 mins
DGS-3420-28SC:admin#

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

Format

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

Parameters

9600 - Specify a baud rate of 9600. 19200 - Specify a baud rate of 19200. 38400 - Specify a baud rate of 38400.
never - Specify to never timeout. 2_minutes - Specify when the idle value is over 2 minutes, the device will auto logout. 5_minutes - Specify when the idle value over 5 minutes, the device will auto logout. 10_minutes - Specify when the idle value is over 10 minutes, the device will auto logout.

Restrictions

Only Administrator and Operator-level users can issue this command.

Example

To configure the baud rate:
18
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide
Command: config serial_port baud_rate 9600
DGS-3420-28SC:admin#
DGS-3420-28SC:admin#enable clipaging
Success.

2-14 enable clipaging

Description

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

Format

enable clipaging

Parameters

None.

Restrictions

Only Administrator and Operator-level users can issue this command.

Example

To enable pausing of the screen display when show command output reaches the end of the page:
Command: enable clipaging
Success.
DGS-3420-28SC:admin#

2-15 disable clipaging

Description

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

Format

disable clipaging

Parameters

None.
19
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide
DGS-3420-28SC:admin#disable clipaging
DGS-3420-28SC:admin#
<tcp_port_number 1-65535> - (Optional) Specify the TCP port number. TCP ports are
numbered between 1 and 65535. The “well-known” TCP port for the Telnet protocol is 23.
DGS-3420-28SC:admin#enable telnet 23

Restrictions

Only Administrator and Operator-level users can issue this command.

Example

To disable pausing of the screen displa y when show comm and output r eaches th e end of the page:
Command: disable clipaging
Success.

2-16 enable telnet

Description

This command is used to enable Telnet and configure a port number. The default setting is enabled and the port number is 23.

Format

enable telnet {<tcp_port_number 1-65535>}

Parameters

Restrictions

Only Administrator and Operator-level users can issue this command.

Example

To enable Telnet and configure a port number:
Command: enable telnet 23
Success.
DGS-3420-28SC:admin#

2-17 disable telnet

Description

This command is used to disable Telnet.
20
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide
DGS-3420-28SC:admin#disable telnet
DGS-3420-28SC:admin#
<tcp_port_number 1-65535> - (Optional) Specify the TCP port number. TCP ports are
numbered between 1 and 65535. The “well-know” TCP port for the Web protocol is 80.
DGS-3420-28SC:admin#enable web 80

Format

disable telnet

Parameters

None.

Restrictions

Only Administrator and Operator-level users can issue this command.

Example

To disable Telnet:
Command: disable telnet
Success.

2-18 enable web

Description

This command is used to enable Web UI and configure the port number . The default setting is enabled and the port number is 80.

Format

enable web {<tcp_port_number 1-65535>}

Parameters

Restrictions

Only Administrator and Operator-level users can issue this command.

Example

To enable HTTP and configure port number:
Command: enable web 80
Note: SSL will be disabled if web is enabled. Success.
21
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide
DGS-3420-28SC:admin#
DGS-3420-28SC:admin#disable web
config - (Optional) Specify to save configuration.
<pathname> - Specify the path name of the indicated configuration
log - (Optional) Specify to save log.
all - (Optional) Specify to save changes to currently active configuration and save logs.
Note: If no keyword is specified, all changes will be saved to bootup configuration file.

2-19 disable web

Description

This command is used to disable Web UI.

Format

disable web

Parameters

None.

Restrictions

Only Administrator and Operator-level users can issue this command.

Example

To disable HTTP:
Command: disable web
Success.
DGS-3420-28SC:admin#

2-20 save

Description

This command is used to save the current configuration or log in non-volatile RAM.

Format

save {[config <pathname> | log | all]}

Parameters

22
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide
DGS-3420-28SC:admin#save
DGS-3420-28SC:admin#
DGS-3420-28SC:admin#save config 1
DGS-3420-28SC:admin#
DGS-3420-28SC:admin#save log
DGS-3420-28SC:admin#save all
DGS-3420-28SC:admin#

Restrictions

Only Administrator and Operator-level users can issue this command.

Example

To save the current configuration to the bootup configuration file:
Command: save
Saving all configurations to NV-RAM.......... Done.
To save the current configuration to destination file, named 1:
Command: save config 1
Saving all configurations to NV-RAM.......... Done.
To save a log to NV-RAM:
Command: save log
Saving all system logs to NV-RAM............. Done.
DGS-3420-28SC:admin#
To save all the configurations and logs to NV-RAM:
Command: save all
Saving configuration and logs to NV-RAM...... Done.

2-21 reboot

Description

This command is used to restart the switch.

Format

reboot {force_agree}
23
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide
force_agree – (Optional) Specify to immediately execute the reboot command without further
confirmation.
DGS-3420-28SC:admin#reboot
Please wait, the switch is rebooting…
config - (Optional) Specif y this ke yword and all parameters are reset to default settings.
However, the device will neither save nor reboot.
system - (Optional) Specify this keyword and all parameters are reset to default settings. Then
the switch will do factory reset, save, and reboot.
force_agree - (Optional) Specify and the reset command will be executed immediately without
further confirmation.
Note:
DGS-3420-28SC:admin#reset

Parameters

Restrictions

Only Administrator-level users can issue this command.

Example

To restart the switch:
Command: reboot
Are you sure you want to proceed with the system reboot?(y/n)

2-22 reset

Description

This command is used to reset all switch parameters to the factory defaults.

Format

reset {[config | system]} {force_agree}

Parameters

If no keyword is specified, all parameters will be reset to default settings except IP
address, user account, and history log, but the device will neither save nor reboot.

Restrictions

Only Administrator-level users can issue this command.

Example

To reset all the switch parameters except the IP address:
Command: reset
24
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide
Are you sure you want to proceed with system reset
DGS-3420-28SC:admin#
DGS-3420-28SC:admin#reset config
DGS-3420-28SC:admin#reset system
DGS-3420-28SC:admin#login
except IP address, log, user account and banner?(y/n) y Success.
To reset the system configuration settings:
Command: reset config
Are you sure to proceed with system reset?(y/n) Success.
DGS-3420-28SC:admin#
To reset all system parameters, save, and restart the switch:
Command: reset system
Are you sure to proceed with system reset, save and reboot?(y/n) Loading factory default configuration… Done. Saving all configuration to NV-RAM… Done. Please wait, the switch is rebooting…

2-23 login

Description

This command is used to log in to the switch.

Format

login

Parameters

None.

Restrictions

None.

Example

To login to the switch:
Command: login
UserName:
25
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide
DGS-3420-28SC:admin#logout

2-24 logout

Description

This command is used to log out of the switch.

Format

logout

Parameters

None.

Restrictions

None.

Example

To logout of the switch:
Command: logout
*********** * Logout * ***********
UserName:

2-25 clear

Description

DGS-3420-28SC Gigabit Ethernet Switch
Command Line Interface
Firmware: Build 1.00.024
Copyright(C) 2011 D-Link Corporation. All rights reserved.
This command is used to clear the terminal screen.

Format

clear
26
Loading...
+ 908 hidden pages
Buy Points How it Works FAQ Contact Us Questions and Suggestions Privacy Policy Cookie Policy Terms of Use