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...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 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. 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).
Page 8
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin# config ipif System ipaddress 10.24.22.100/255.0.0.0 Command: config ipif System ipaddress 10.24.22.100/8 Success. 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.
Page 9
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#config account Command: config account Next possible completions: <username> DGS-3420-28SC:admin# 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.
Page 10
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#the Available commands: cable_diag change clear config copy create debug delete disable download enable erase format login logout move ping ping6 reboot reconfig rename reset save show smtp telnet traceroute traceroute6...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide {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.
Page 13
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 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.
Page 15
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters admin - Specify the name of the admin account. 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.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Enter a case-sensitive new password:**** Enter the new password again for confirmation:**** Success. DGS-3420-28SC:admin# enable password encryption Description The user account configuration information will be stored in the configuration file, and can be applied to the system later.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format disable password encryption Parameters None. Restrictions Only Administrator-level users can issue this command. Example To disable password encryption: DGS-3420-28SC:admin#disable password encryption Command: disable password encryption Success. DGS-3420-28SC:admin# config account Description When the password information is not specified in the command, the system will prompt the user to...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator-level users can issue this command. Example To configure the user password of the “dlink” account: DGS-3420-28SC:admin#config account dlink Command: config account dlink Enter a old password:**** Enter a case-sensitive new password:**** Enter the new password again for confirmation:**** Success.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#show account Command: show account Current Accounts: Username Access Level --------------- ------------ System User Sales Operator dlink Admin DGS-3420-28SC:admin# delete account Description This command is used to delete an existing account. Format delete account <username 15>...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 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: DGS-3420-28SC:admin#show session Command: show session Live Time From Level...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format show environment Parameters None. Restrictions None. Example To display the switch hardware status: DGS-3420-28SC:admin#show environment Command: show environment Internal Power : Active External Power : Fail Right Fan 1 : Speed Low (3000 RPM) Right Fan 2...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide enable - Enable either the trap or log state for a warning temperature event. disable - Disable either the trap or log state for a warning temperature event. Restrictions Only Administrator and Operator-level users can issue this command.
Page 24
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator and Operator-level users can issue this command. Example To configure a warming temperature threshold high of 80: DGS-3420-28SC:admin#config temperature threshold high 80 Command: config temperature threshold high 80 Success.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 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)
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 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: DGS-3420-28SC:admin#enable clipaging Command: enable clipaging Success.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin# 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...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator and Operator-level users can issue this command. Example To disable Telnet: DGS-3420-28SC:admin#disable telnet Command: disable telnet Success. DGS-3420-28SC:admin# 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.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 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: DGS-3420-28SC:admin#disable web Command: disable web...
Page 30
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator and Operator-level users can issue this command. Example To save the current configuration to the bootup configuration file: DGS-3420-28SC:admin#save Command: save Saving all configurations to NV-RAM..Done. DGS-3420-28SC:admin# To save the current configuration to destination file, named 1: DGS-3420-28SC:admin#save config 1...
Page 31
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format reboot {force_agree} Parameters force_agree – (Optional) Specify to immediately execute the reboot command without further confirmation. Restrictions Only Administrator-level users can issue this command. Example To restart the switch: DGS-3420-28SC:admin#reboot Command: reboot Are you sure you want to proceed with the system reboot?(y/n)
Page 32
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To reset all the switch parameters except the IP address: DGS-3420-28SC:admin#reset Command: reset Are you sure you want to proceed with system reset except IP address, log, user account and banner?(y/n) y Success.
Page 33
This command is used to log out of the switch. Format logout Parameters None. Restrictions None. Example To logout of the switch: DGS-3420-28SC:admin#logout Command: logout *********** * Logout * *********** DGS-3420-28SC Gigabit Ethernet Switch Command Line Interface Firmware: Build 1.50.010 Copyright(C) 2011 D-Link Corporation. All rights reserved.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide UserName: 2-25 clear Description This command is used to clear the terminal screen. Format clear Parameters None. Restrictions None. Example To clear the terminal screan: DGS-3420-28SC:admin#clear Command: clear 2-26 config terminal width Description...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To configure the terminal width: DGS-3420-28SC:admin#config terminal width 90 Command: config terminal width 90 Success. DGS-3420-28SC:admin# 2-27 show terminal width Description This command is used to display the configuration of the current terminal width. Format show terminal width Parameters...
Page 36
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Within fan(s) status display, for example, there are three fans on the left of the switch, if three fans is working normally, there will display “OK” in the Left Fan field. If some fans work failed, such as fan 1,3 , there will only display the failed fans in the Left Fan field, such as “1,3 Fail”.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 3 802.1X Commands enable 802.1x disable 802.1x create 802.1x user <username 15> delete 802.1x user <username 15> show 802.1x user config 802.1x auth_protocol [local | radius_eap] show 802.1x {[auth_state | auth_configuration] ports {<portlist>}} config 802.1x capability ports [<portlist>...
Page 38
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format enable 802.1x Parameters None. Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To enable the 802.1X function: DGS-3420-28SC:admin#enable 802.1x Command: enable 802.1x Success.
Page 39
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Success. DGS-3420-28SC:admin# create 802.1x user Description This command is used to create an 802.1X user. Format create 802.1x user <username 15> Parameters <username 15> - Specify to add a user name. Restrictions Only Administrator, Operator and Power-User level users can issue this command.
Page 40
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters <username 15> - Specify to delete a user name. Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To delete the user named “Tiberius”: DGS-3420-28SC:admin#delete 802.1x user Tiberius Command: delete 802.1x user Tiberius Success.
Page 41
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Total Entries : 1 DGS-3420-28SC:admin# config 802.1x auth_protocol Description This command is used to configure the 802.1X authentication protocol. Format config 802.1x auth_protocol [local | radius_eap] Parameters local - Specifiy the authentication protocol as local. radius_eap - Specify the authentication protocol as RADIUS EAP.
Page 42
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide ports - (Optional) Specify a range of ports to be displayed. <portlist> - Specify a range of ports to be displayed. Restrictions None. Example To display 802.1X information: DGS-3420-28SC:admin#show 802.1x Command: show 802.1x 802.1X...
Page 43
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Capability : None AdminCrlDir : Both OpenCrlDir : Both Port Control : Auto QuietPeriod : 60 Seconds TxPeriod : 30 Seconds SuppTimeout : 30 Seconds ServerTimeout : 30 Seconds MaxReq : 2 Times ReAuthPeriod...
Page 44
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin# config 802.1x fwd_pdu ports Description This command is used to configure the 802.1X PDU forwarding state on specific ports of the switch. Format config 802.1x fwd_pdu ports [<portlist> | all] [enable | disable] Parameters <portlist>...
Page 45
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To configure the 802.1X PDU forwarding state: DGS-3420-28SC:admin#config 802.1x fwd_pdu system enable Command: config 802.1x fwd_pdu system enable Success.
Page 46
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide be any value from 1 to 65535. <sec 1-65535> - The transmit period value must be between 1 an 65535 seconds. supp_timeout - (Optional) The initialization value of the aWhile timer when timing out the supplicant. Its default value is 30 s and can be any value from 1 to 65535.
Page 47
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters enable - The authorization attributes such as VLAN, 802.1p default priority, and ACL assigned by the RADUIS server will be accepted if the global authorization status is enabled. The default state is enabled.
Page 48
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To initialize the authentication state machine of some or all: DGS-3420-28SC:admin# config 802.1x init port_based ports all Command: config 802.1x init port_based ports all Success. DGS-3420-28SC:admin# 3-14 config 802.1x max_users Description This command is used to configure the 802.1X maximum number of users of the system.
Page 49
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format config 802.1x reauth [port_based ports [<portlist> | all] |mac_based ports [<portlist> | all] {mac_address <macaddr>}] Parameters port_based ports - The switch passes data based on its authenticated port. <portlist>...
Page 50
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To assign a static VLAN to be a guest VLAN: DGS-3420-28SC:admin# create 802.1x guest_vlan guestVLAN Command: create 802.1x guest_vlan guestVLAN Success.
Page 51
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format config 802.1x guest_vlan ports [<portlist> | all] state [enable | disable] Parameters <portlist> - Specify a range of ports to be configured. all - Specify to configure all ports. state - Specify the guest VLAN port state of the configured ports.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To configure a RADIUS server: DGS-3420-28SC:admin#config radius 1 ipaddress 10.48.74.121 key dlink Command: config radius 1 ipaddress 10.48.74.121 key dlink Success. DGS-3420-28SC:admin# 3-23 show radius Description This command is used to display RADIUS server configurations. Format show radius Parameters...
Page 56
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 3-24 show auth_statistics Description This command is used to display authenticator statistics information Format show auth_statistics {ports <portlist>} Parameters ports - (Optional) Specify a range of ports to be displayed. <portlist>...
Page 57
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 3-25 show auth_diagnostics Description This command is used to display authenticator diagnostics information. Format show auth_diagnostics {ports <portlist>} Parameters ports - (Optional) Specify a range of ports to be displayed. <portlist>...
Page 58
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide CTRL+C ESC q Quit SPACE n Next Page Previous Page Refresh 3-26 show auth_session_statistics Description This command is used to display authenticator session statistics information. Format show auth_session_statistics {ports <portlist>} Parameters ports - (Optional) Specify a range of ports to be displayed.
Page 59
Format show auth_client Parameters None. Restrictions None. Example To display authentication client information: DGS-3420-28SC:admin# show auth_client Command: show auth_client radiusAuthClient ==> radiusAuthClientInvalidServerAddresses radiusAuthClientIdentifier D-Link radiusAuthServerEntry ==> radiusAuthServerIndex :1 radiusAuthServerAddress 0.0.0.0 radiusAuthClientServerPortNumber radiusAuthClientRoundTripTime radiusAuthClientAccessRequests radiusAuthClientAccessRetransmissions radiusAuthClientAccessAccepts radiusAuthClientAccessRejects radiusAuthClientAccessChallenges radiusAuthClientMalformedAccessResponses 0 radiusAuthClientBadAuthenticators...
Page 65
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide • Extended TACACS (XTACACS) — An extension of the TACACS protocol with the ability to provide more types of authentication requests and more types of response codes than TACACS.
Page 66
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Note: This Switch also support the assignment of user privilege by a TACACS+ server. Note: TACACS, XTACACS and TACACS+ are separate entities and are not compatible. The Switch and the server must be configured exactly the same, using the same protocol.
Page 67
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format disable authen_policy Parameters None. Restrictions Only Administrator-level users can issue this command. Example To disable system access authentication policy: DGS-3420-28SC:admin#disable authen_policy Command: disable authen_policy Success. DGS-3420-28SC:admin# show authen_policy Description This command is used to display whether system access authentication policy is enabled or disabled.
Page 68
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#show authen_policy Command: show authen_policy Authentication Policy : Enabled Authentication Policy Encryption : Enabled DGS-3420-28SC:admin# enable authen_policy_encryption Description This command is used to enable the authentication policy encryption. When enabled, TACACS+ and RADIUS key will be in the encrypted form.
Page 69
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters None. Restrictions Only Administrator-level users can issue this command. Example To disable the authentication policy encryption: DGS-3420-28SC:admin#disable authen_policy_encryption Command: disable authen_policy_encryption Success. DGS-3420-28SC:admin# create authen_login method_list_name Description This command is used to create a user-defined method list of authentication methods for user login.
Page 70
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin# config authen_login Description This command is used to configure a user-defined or default method list of authentication methods for user login. The sequence of methods will affect the authentication result. For example, if the sequence is TACACS+ first, then TACACS and local, when a user trys to login, the authentication request will be sent to the first server host in the TACACS+ built-in server group.
Page 71
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#config authen_login method_list_name login_list_1 method tacacs+ tacacs local Command: config authen_login method_list_name login_list_1 method tacacs+ tacacs local Success. DGS-3420-28SC:admin# delete authen_login method_list_name Description This command is used to delete a user-defined method list of authentication methods for user login. Format delete authen_login method_list_name <string 15>...
Page 72
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters default – Specify to display the default method list for user login. method_list_name - Specify the user-defined method list for user login. <string 15> - Specify the user-defined method list for user login. The method list name can be up to 15 characters long.
Page 73
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To create a user-defined method list for promoting a user's privilege to Admin level: DGS-3420-28SC:admin#create authen_enable method_list_name enable_list_1 Command: create authen_enable method_list_name enable_list_1 Success. DGS-3420-28SC:admin# 4-11 config authen_enable Description This command is used to configure a user-defined or default method list of authentication methods for promoting a user's privilege to Admin level.
Page 74
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To configure a user-defined method list for promoting a user's privilege to Admin level: DGS-3420-28SC:admin#config authen_enable method_list_name enable_list_1 method tacacs+ tacacs local_enable Command: config authen_ enable method_list_name enable_list_1 method tacacs+ tacacs local_enable Success.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format show authen_enable [default | method_list_name <string 15> | all] Parameters default - Specify to display the default method list for promoting a user's privilege to Administrator level. method_list_name - Specify the user-defined method list for promoting a user's privilege to Administrator level.
Page 77
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator-level users can issue this command. Example To display the login and enable method list for all applications: DGS-3420-28SC:admin#show authen application Command: show authen application Application Login Method List Enable Method List -----------...
Page 78
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin# 4-17 config authen server_group Description This command is used to add or remove an authentication server host to or from the specified server group. Built-in server group tacacs, xtacacs, tacacs+, and RADIUS accept the server host with the same protocol only, but user-defined server group can accept server hosts with different protocols.
Page 79
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 4-18 delete authen server_group Description This command is used to delete a user-defined authentication server group. Format delete authen server_group <string 15> Parameters <string 15> - Specify the user-defined server group name. Restrictions Only Administrator-level users can issue this command.
Page 80
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To display all authentication server groups: DGS-3420-28SC:admin#show authen server_group Command: show authen server_group Group Name IP Address Protocol --------------- --------------- -------- mix_1 10.1.1.222 TACACS+ radius 10.1.1.224 RADIUS tacacs 10.1.1.225 TACACS...
Page 81
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide encryption_key - Specifies the encrypted form key string for TACACS+ and RADIUS authentication. This value is meaningless for TACACS and XTACACS. The encryption algorithm is based on DES. <key_string 344>...
Page 82
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide radius - Specify the server host’s authentication protocol RADIUS. port - Specify the port number of the authentication protocol for the server host. The default value for TACACS/XTACACS/TACACS+ is 49. The default value for RADIUS is 1812. <int 1-65535>...
Page 83
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters <ipaddr> - Specify the server host’s IP address. protocol - Specify the server host’s type of authentication protocol. tacacs - Specify the server host’s authentication protocol TACACS. xtacacs - Specify the server host’s authentication protocol XTACACS.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format config authen parameter attempt <int 1-255> Parameters <int 1-255> - Specify the amount of attempts for users trying to login or promote the privilege on console, Telnet, or SSH. The default value is 3. Restrictions Only Administrator-level users can issue this command.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Command: show authen parameter Response Timeout : 60 seconds User Attempts DGS-3420-28SC:admin# 4-27 enable admin Description This command is used to promote the "user" privilege level to "admin" level. When the user enters this command, the authentication method TACACS, XTACAS, TACACS+, user-defined server groups, local enable, or none will be used to authenticate the user.
Page 87
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format config admin local_enable {encrypt [plain_text | sha_1] <password>} Parameters encrypt - (Optional) Specifies the encryption type to be used for the password. plain_text - Specifies that the password entered should be in plain text form. sha_1 - Specifies that the password entered should be in SHA-1 encrypted form.
Page 88
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format create aaa server_group <string 15> Parameters <string 15> - Specify the user-defined server group name. Restrictions Only Administrator level can issue this command. Example To create a user-defined AAA server group called “mix_1”: DGS-3420-28SC:admin#create aaa server_group mix_1 Command: create aaa server_group mix_1 Success.
Page 89
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide protocol - Specify the server host protocol. tacacs - Specify the server host using TACACS protocol. xtacacs - Specify the server host using XTACACS protocol. tacacs+ - Specify the server host using TACACS+ protocol. radius - Specify the server host using RADIUS protocol.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#delete aaa server_group mix_1 Command: delete aaa server_group mix_1 Success. DGS-3420-28SC:admin# 4-32 delete aaa server_host Description This command is used to delete an AAA server host. Format delete aaa server_host <ipaddr> protocol [tacacs | xtacacs | tacacs+ | radius] Parameters <ipaddr>...
Page 91
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format show aaa Parameters None. Restrictions None. Example To display AAA global configuration: DGS-3420-28SC:admin#show aaa Command: show aaa Authentication Policy: Enabled Accounting Network Service State: AAA Method Accounting Network Service Method: acc_telnet Accounting Shell Service State: RADIUS Only Accounting Shell Service Method: Accounting System Service State: Disabled...
Page 92
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator level can issue this command. Example To display all AAA server groups: DGS-3420-28SC:admin#show aaa server_group Command: show aaa server_group Group Name IP Address Protocol --------------- --------------------------------------- -------- mix_1 --------------------------------------- -------- radius...
Page 93
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#show aaa server_host Command: show aaa server_host IP Address Protocl Port Acct Time Retry Key Port -------------------- ------- ----- ----- ---- ----- --------------------------- 10.1.1.222 RADIUS 15555 1813 ****** Total Entries : 1 DGS-3420-28SC:admin# 4-36...
Page 94
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format disable aaa_server_password_encryption Parameters None. Restrictions Only Administrator level can issue this command. Example To disable AAA server password encryption: DGS-3420-28SC:admin#disable aaa_server_password_encryption Command: disable aaa_server_password_encryption Success. DGS-3420-28SC:admin# 4-38 create radius server_host Description This command is used to create an RADIUS server host.
Page 95
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide retransmit - (Optional) Specify the count for re-transmissions. <int 1-20> - Enter the value between 1 and 20. The default value is 2. Restrictions Only Administrator level can issue this command. Example To create an RADIUS server host: DGS-3420-28SC:admin#create radius server_host 10.1.1.222 auth_port 15555 timeout 10...
Page 96
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator level can issue this command. Example To configure the RADIUS server host: DGS-3420-28SC:admin#config radius server_host 10.1.1.222 key "abc123" Command: config radius server_host 10.1.1.222 key "abc123" Success.
Page 97
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 4-41 show radius source_ipif Description This command is used to display specified source interface for all outgoing RADIUS packets. Format show radius source_ipif Parameters None. Restrictions Only Administrator level can issue this command. Example To display specified source interface for all outgoing RADIUS packets.
Page 98
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide retransmit - (Optional) Specify the count for re-transmissions. <int 1-20> - Enter the value between 1 and 20. The default value is 2. Restrictions Only Administrator level can issue this command. Example To create a TACACS server host: DGS-3420-28SC:admin#create tacacs server_host 10.1.1.223 port 15555 timeout 10...
Page 99
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#config tacacs server_host 10.1.1.223 retransmit 5 Command: config tacacs server_host 10.1.1.223 retransmit 5 Key is meaningless for TACACS and XTACACS. Success. DGS-3420-28SC:admin# 4-44 create tacacs+ server_host Description This command is used to create a TACACS+ server host. Format create tacacs+ server_host <ipaddr>...
Page 100
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 4-45 config tacacs+ server_host Description This command is used to configure the TACACS+ server host. Format config tacacs+ server_host <ipaddr> {port <int 1-65535> | [key [<key_string 254> | none] | encryption_key <key_string 344>] | timeout <int 1-255>} Parameters <ipaddr>...
Page 101
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters <ipaddr> - Enter the IP address of the server host. port - (Optional) The port number of the XTACACS server host. <int 1-65535> - Enter the value between 1 and 65535. The default value is 49. timeout - (Optional) Specify the time in second to wait for the server to reply.
Page 102
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To configure the XTACACS server host: DGS-3420-28SC:admin#config xtacacs server_host 10.1.1.224 retransmit 5 Command: config xtacacs server_host 10.1.1.224 retransmit 5 Key is meaningless for TACACS and XTACACS. Success. DGS-3420-28SC:admin# 4-48 config tacacs source_ipif...
Page 103
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 4-49 show tacacs source_ipif Description This command is used to display the specified source interface for all outgoing TACACS packets. Format show tacacs source_ipif Parameters None. Restrictions Only Administrator level can issue this command. Example To display the specified source interface for all outgoing TACACS packets.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide radius - Specifies to use the built-in server group 'radius'. server_group - Specifies the user-defined server group. If the group contains 'tacacs' or 'xtacacs' server, it will be skipped in accounting. <string 15>...
Page 105
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide method_list_name - Specifies that the accounting service should use the AAA user-defined method list specified by the “create accounting method_list_name <string 15>” command. <string 15> - Enter the method list name used here. This name can be up to 15 characters long.
Page 106
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To configure the AAA accounting methodlist “admin_acct” for accounting to all administrator commands: DGS-3420-28SC:admin#config accounting service command administrator method_list_name admin_acct Command: config accounting service command administrator method_list_name admin_acct Success.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format delete accounting method_list_name <string 15> Parameters <string 15> - Enter the name of the user-defined method list here. This name can be up to 15 characters long. Restrictions Only Administrator level users can issue this command.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#show accounting method_list_name shell_acct Command: show accounting method_list_name shell_acct Method List Name Priority Method Name Comment ---------------- -------- --------------- ------------------ shell_acct none Keyword DGS-3420-28SC:admin# 4-56 show accounting service Description This command is used to display RADIUS accounting service information.
Page 114
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Command: delete access_profile profile_id 1 Success. DGS-3420-28SC:admin# config access_profile Description This command is used to configure access list entries. Note: Please see the “Error! Reference source not found. Error! Reference source not found.”...
Page 115
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide auto_assign - Specify to automatically assign the access ID. <value 1-256> - Specify a value between 1 and 256. ethernet - Specify an Ethernet access control list rule. vlan - Specify the VLAN name.
Page 116
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide flag - Specify the TCP flag field value. all – Specify to check all paramenters below. urg - (Optional) Specify Urgent Pointer field significant. ack - (Optional) Specify Acknowledgment field significant. psh - (Optional) Specify Push Function.
Page 117
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide tcp - Specify TCP. src_port - (Optional) Specify the TCP source port range. <value 0-65535> - Specify the value between 0 and 65535. mask - (Optional) Specify the mask. <hex 0x0-0xffff>...
Page 118
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide group_id - Specifies the group ID used. <value 1-4> - Enter the group ID used here. This value must be between 1 and 4. deny - Specify the packets that match the access profile are filtered by the switch. time_range - (Optional) Specify the name of this time range entry.
Page 119
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To display the current access list table: DGS-3420-28SC:admin#show access_profile Command: show access_profile Access Profile Table Total User Set Rule Entries : 3 Total Used HW Entries : 19 Total Available HW Entries : 1005 ================================================================================...
Page 121
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Source MAC : FF-FF-FF-00-00-00 Destination MAC : 00-00-00-FF-FF-FF Available HW Entries: 255 --------------------------------------------------------------------------------- Rule ID : 22 Ports: 1-7 Match on: VLAN ID Mask : 0xFFF Source MAC : 00-01-02-03-04-05 Mask : FF-FF-FF-FF-FF-FF Destination MAC...
Page 122
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters <range_name 32> - Specify the name of the time range settings. hours start_time - Specify the starting time in a day. (24-hr time). For example, 19:00 means 7PM. 19 is also acceptable.
Page 123
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To display current time range setting: DGS-3420-28SC:admin#show time_range Command: show time_range Time Range Information ------------------------- Range Name testdaily Weekdays Mon,Fri Start Time 12:00:00 End Time 13:00:00 Total Entries :1 DGS-3420-28SC:admin# show current_config access_profile Description...
Page 124
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide permit create access_profile ip source_ip_mask 255.255.255 profile_id 2 config access_profile profile_id 2 add access_id 1 ip source_ip 10.10.10.10 port 2 deny #------------------------------------------------------------------------------ DGS-3420-28SC:admin# delete cpu access_profile Description This command is used to delete CPU access list profiles. Format delete cpu access_profile [profile_id <value 1-5>...
Page 126
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide src_port_mask - (Optional) Specify the UDP source port mask. <hex 0x0-0xffff> - Specify the UDP source port mask. dst_port_mask - (Optional) Specify the UDP destination port mask. <hex 0x0-0xffff> - Specify the UDP destination port mask. protocol_id_mask - Specify that the rule applies to the IP protocol ID traffic.
Page 127
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#create cpu access_profile profile_id 2 ip source_ip_mask 255.255.255.255 Command: create cpu access_profile profile_id 2 ip source_ip_mask 255.255.255.25 Success. DGS-3420-28SC:admin# 5-10 config cpu access_profile profile_id Description This command is used to configure CPU access list entries. Format config cpu access_profile profile_id <value 1-5>...
Page 128
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide <value 0-7> - Specify the value of the 802.1p priority tag. The priority tag ranges from 1 to 7. ethernet_type - Specify the Ethernet type. <hex 0x0-0xffff> - Specify the Ethernet type. ip - Specify an IP access control list rule.
Page 129
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide <hex 0x0-0xffffffff> - Specify the mask for packet bytes 24-27. <hex 0x0-0xffffffff> - Specify the mask for packet bytes 28-31. offset_32-47 - Specify the mask for packet bytes 32-47 <hex 0x0-0xffffffff>...
Page 130
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 5-11 show cpu access_profile Description This command is used to display the current CPU access list table. Format show cpu access_profile {profile_id <value 1-5>} Parameters profile_id - (Optional) Specify the index of an access list profile. <value 1-5>...
Page 131
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide ================================================================================ ================================================================================ Profile ID: 2 Type: IPv4 MASK on Dest IP : 255.255.0.0 Unused Rule Entries: 93 -------------------------------------------------------------------------------- Rule ID : 1 Ports: 1-28 Time Range: ben Match on Dest IP : 10.90.90.12 Mask : 255.255.255.255...
Page 132
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide ================================================================================ Profile ID: 5 Type: IPv6 MASK on Class Flow Label Source IPv6 Addr : FFFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF Dest IPv6 Addr : FFFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF Source Port : 0xFFFF Dest Port : 0xFFFF Unused Rule Entries: 93 -------------------------------------------------------------------------------- Rule ID : 1...
Page 133
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Rule ID : 1 Ports: 1 Match on Offset 0-15 : 0x12345678 0x12345678 0x12345678 0x12345678 Action: Permit ================================================================================ DGS-3420-28SC:admin# 5-12 enable cpu_interface_filtering Description This command is used to enable CPU interface filtering. Format enable cpu_interface_filtering Parameters...
Page 134
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format disable cpu_interface_filtering Parameters None. Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To disable CPU interface filtering: DGS-3420-28SC:admin#disable cpu_interface_filtering Command: disable cpu_interface_filtering Success.
Page 136
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide permit - Enter this parameter to allow packet flows that are in the yellow flow. replace_dscp - Specifies to change the DSCP of the packet. <value 0-63> - Enter the replacement DSCP of the packet here. This value must be between 0 and 63.
Page 137
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide permitted through or dropped. Users may replace the DSCP field of these packets by checking its radio button and entering a new DSCP value in the allotted field. permit - Enter this parameter to allow packet flows that are in the red flow.
Page 138
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format show flow_meter {[profile_id <value 1-6> | profile_name <name 1-32>] {access_id <value 1- 256>}} Parameters profile_id - (Optional) Specify the profile ID. <value 1-6> - Specify the profile ID. Enter a value between 1 and 6. profile_name - (Optional) Specify the name of the profile.
Page 140
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide create port_group id <value 1-64> name <name 16> config port_group [id <value 1-64> | name <name 16>] [add | delete] [<portlist> | all] delete port_group [id <value 1-64> | name <name 16>] show port_group {id <value 1-64>...
Page 141
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide type - Specifies the type of ICMP traffic. code - Specifies the code of ICMP traffic. igmp - (Optional) Specifies that the rule applies to IGMP traffic. type - Specifies the type of IGMP traffic. tcp - (Optional) Specifies that the rule applies to TCP traffic.
Page 142
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin# create egress_access_profile profile_id 1 profile_name eap- eth-bc ethernet source_mac FF-FF-FF-FF-FF-FF Command: create egress_access_profile profile_id 1 profile_name eap-eth-bc ethernet source_mac FF-FF-FF-FF-FF-FF DGS-3420-28SC:admin# delete egress_access_profile Description Delete egress access profile command can only delete the profile which is created by egress ACL module.
Page 144
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide <value 0-7> - Enter the 802.1p priority tag used here. ethernet_type - (Optional) Specifies the Ethernet type. <hex 0x0-0xffff> - Enter the Ethernet type mask used here. ip - Specifies an IP egress ACL rule. vlan - (Optional) Specifies the VLAN name.
Page 145
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide udp - (Optional) Specifies that the following parameters configured will apply to the UDP configuration. src_port - Specifies the UDP source port range. <value 0-65535> - Enter the UDP source port range value here. mask - Specifies the UDP source port mask here.
Page 146
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide code - Specifies that the rule will apply to the ICMP code traffic value. <value 0-255> - Enter the ICMP code traffic value here. This value must be between 0 and 255.
Page 148
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Egress Access Profile Table Total User Set Rule Entries Total Used Hardware Entries Total Available Hardware Entries : 253 ================================================================================ Profile ID: 1 Profile name: 1 Type: Ethernet Mask on Source MAC : FF-FF-FF-FF-FF-FF...
Page 149
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Rule ID : 2 (auto assign) Port group: 1 Match on Source IP : 10.0.0.1 Destination IP : 10.90.90.90 DSCP : 25 Action: Permit Matched Count : 0 packets ================================================================================ DGS-3420-28SC:admin# The following example displays an egress access profile that supports an entry mask for each rule:...
Page 150
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide The overall current configuration can be displayed by “show config” command which is accessible in administrator level of privilege. Format show current_config egress_access_profile Parameters None. Restrictions None. Example To display current configuration of egress access list table: DGS-3420-28SC:admin# show current_config egress_access_profile Command: show current_config egress_access_profile...
Page 152
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide conform - (Optional) Specify the action when packet is in “green color”. permit - Permit the packet. replace_dscp - Changes the DSCP of the packet. <value 0-63> - Enter the replace DSCP value here. This value must be between 0 and 63. counter - (Optional) Specifies the ACL counter.
Page 153
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide <value 0-63> - Enter the DSCP replace value here. This value must be between 0 and 63. drop - Drops the packet. counter - (Optional) Specifies the ACL counter. This is optional. The default is “disable”. The resource may be limited so that a counter cannot be turned on.
Page 154
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide profile_name - (Optional) Specifies the name of the profile. <name 1-32> - Enter the profile name used here. This name can be up to 32 characters long. access_id - (Optional) Specifies the access ID. <value 1-128>...
Page 155
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide <value 1-64> - Enter the port group ID here. This value must be between 1 and 64. name - Specifies the port group name. <name 16> - Enter the port group name here. This name can be up to 16 characters long. Restrictions Only Administrator and Operator-level users can issue this command.
Page 156
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin# config port_group id 2 add 1-3 Command: config port_group id 2 add 1-3 Success. DGS-3420-28SC:admin# 6-10 delete port_group Description This command is used to delete port group. Format delete port_group [id <value 1-64>...
Page 157
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters id - (Optional) Specifies the port group ID. <value 1-64> - Enter the port group ID used here. This value must be between 1 and 64. name - (Optional) Specifies the port group name. <name 16>...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide delete arpentry Description This command is used to delete a static ARP entry, made using the create arpentry command above, by specifying either the IP address of the entry or all. Specifying all deletes the switch’s ARP table. Format delete arpentry [<ipaddr>...
Page 160
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To configure a static ARP entry for the IP address 10.48.74.121 and MAC address 00:50:BA:00:07:36: DGS-3420-28SC:admin#config arpentry 10.48.74.121 00-50-BA-00-07-36 Command: config arpentry 10.48.74.121 00-50-BA-00-07-36 Success.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide show arpentry Description This command is used to display the Address Resolution Protocol (ARP) table. Filter the display by IP address, interface name, or static entries. Format show arpentry {ipif <ipif_name 12> | ipaddress <ipaddr> | static | mac_address <macaddr>} Parameters ipif - The name of the IP interface the end node or station for which the ARP table entry was made, resides on.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide clear arptable Description This command is used to remove dynamic entries from the ARP table. Static ARP entries are not affected. Format clear arptable Parameters None. Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To remove the dynamic entries from the ARP table: DGS-3420-28SC:admin#clear arptable...
Page 163
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions None. Example To display the IP address forwarding table on the Switch: DGS-3420-28SC:admin# show ipfdb Command: show ipfdb Interface IP Address Port Learned ------------ ---------------- --------- --------- Total Entries: 0 DGS-3420-28SC:admin#...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 8 ARP Spoofing Prevention Commands config arp_spoofing_prevention [add gateway_ip <ipaddr> gateway_mac <macaddr> ports [<portlist> | all] | delete gateway_ip <ipaddr>] show arp_spoofing_prevention config arp_spoofing_prevention Description The user can configure the spoofing prevention entry to prevent spoofing of MAC for the protected gateway.
Page 165
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Success. DGS-3420-28SC:admin# show arp_spoofing_prevention Description This command is used to display the ARP spoofing prevention status. Format show arp_spoofing_prevention Parameters None. Restrictions None. Example To display the ARP spoofing prevention status: DGS-3420-28SC:admin#show arp_spoofing_prevention Command: show arp_spoofing_prevention Gateway IP...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 10 Auto Configuration Commands show autoconfig enable autoconfig disable autoconfig 10-1 show autoconfig Description This command is used to display the status of automatically getting configuration from a TFTP server. Format show autoconfig Parameters...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format enable autoconfig Parameters None. Restrictions Only Administrator and Operator-level users can issue this command. Example To enable DHCP auto configuration status: DGS-3420-28SC:admin#enable autoconfig Command: enable autoconfig Success. DGS-3420-28SC:admin# 10-3 disable autoconfig...
Page 173
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide ipaddress - (Optional) The IP address and netmask of the IP interface to be created. <network_address> - Specify the address and mask information using the traditional format (for example, 10.1.2.3/255.0.0.0 or in CIDR format, 10.1.2.3/8). vlan - (Optional) The name of the VLAN corresponding to the IP interface.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide disable - Specifies that the clear DHCP Option 12 hostname setting will be disabled. dhcpv6_client_pd - Specifies the DHCPv6 client PD state of the interface. enable - Specifies to enable the DHCPv6 client PD state of the interface. prefix_name - Specifies an alias name for the prefix requested from the delegation router.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format delete ipif [<ipif_name 12> {ipv6address {prefix_name <string 1-12>} <ipv6networkaddr>} | all] Parameters <ipif_name 12> - The name of the interface. ipv6address - (Optional) The IPv6 network address to be deleted. prefix_name - (Optional) Specifies the IPv6 network address prefix name used.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To enable the state for interface petrovic1: DGS-3420-28SC:admin#enable ipif petrovic1 Command: enable ipif petrovic1 Success. DGS-3420-28SC:admin# 11-5 disable ipif Description This command is used to disable the state of an interface. Format disable ipif [<ipif_name 12>...
Page 178
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format show ipif {<ipif_name 12>} Parameters <ipif_name 12> - (Optional) The name of the interface. Restrictions None. Example To display IP interface settings: DGS-3420-28SC:admin#show ipif Command: show ipif IP Interface : System VLAN Name...
Page 179
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 11-7 config out_band_ipif Description This command is used to configure the out of band management port settings. Format config out_band_ipif {ipaddress <network_address> | state [enable | disable] | gateway <ipaddr>} (1) Parameters ipaddress - Specify the IP address of the interface.
Page 180
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters None. Restrictions None. Example To display the configuration of out-of-band management interfaces: DGS-3420-28SC:admin#show out_band_ipif Command: show out_band_ipif Status : Enable IP Address : 192.168.0.1 Subnet Mask : 255.255.255.0 Gateway : 0.0.0.0 Link Status...
Page 181
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To enable the automatic configuration of link local address for an interface: DGS-3420-28SC:admin#enable ipif_ipv6_link_local_auto interface1 Command: enable ipif_ipv6_link_local_auto interface1 Success. DGS-3420-28SC:admin# 11-10 disable ipif_ipv6_link_local_auto Description This command is used to disable the auto configuration of link local address when no IPv6 address is explicitly configured.
Page 182
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format show ipif_ipv6_link_local_auto {<ipif_name 12>} Parameters <ipif_name 12> - (Optional) The name of the interface. Restrictions None. Example To display the link local address automatic configuration state: DGS-3420-28SC:admin#show ipif_ipv6_link_local_auto Command: show ipif_ipv6_link_local_auto IPIF: System Automatic Link Local Address: Disabled...
Page 184
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To configure port state to enable and drop mode: DGS-3420-28SC:admin#config bpdu_protection ports 1 state enable mode drop Command: config bpdu_protection ports 1 state enable mode drop Success. DGS-3420-28SC:admin# 12-2 config bpdu_protection recovery_timer...
Page 185
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 12-3 config bpdu_protection Description This command is used to configure the BPDU protection trap state or log state. Format config bpdu_protection [trap | log] [none | attack_detected | attack_cleared | both] Parameters trap - Specify the trap state.
Page 186
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To enable BPDU protection for the entire switch: DGS-3420-28SC:admin#enable bpdu_protection Command: enable bpdu_protection Success. DGS-3420-28SC:admin# 12-5 disable bpdu_protection Description...
Page 187
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 12-6 show bpdu_protection Description This command is used to display BPDU protection global configuration or per port configuration and current status. Format show bpdu_protection {ports {<portlist>}} Parameters ports - (Optional) Specify all ports to be displayed. <portlist>...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 13 Cable Diagnostics Commands cable_diag ports [<portlist> | all] 13-1 cable_diag ports Description This command is used to test copper cabling. For 10/100Based-TX link speed RJ45 cables, two pairs of cables will be diagnosed. For 1000Base-T link speed RJ45 cables, four pairs of cables will be diagnosed.
Page 190
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 7. Where the link partner is powered on with no errors and the link is up, this command cannot detect the cable length. 8. Where the link partner is powered on with errors, this command can detect whether the error is open, short, or crosstalk.
Page 191
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To test the cable on ports 1 to 4, and 8: DGS-3420-28TC:admin# cable_diag ports 1:1-1:10,1:21 Command: cable_diag ports 1:1-1:10,1:21 Perform Cable Diagnostics ... Port Type Link Status Test Result Cable Length (M) ------...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 14-2 config cfm md Description This command is used to configure the parameters of a maintenance domain. The creation of MIPs on an MA is useful to trace the link, MIP by MIP. It also allows the user to perform a loopback from an MEP to an MIP.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 14-3 create cfm ma Description This command is used to create a maintenance association. Different MAs in an MD must have different MA Names. Different MAs in different MDs may have the same MA Name. Format create cfm ma <string 22>...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To create an MEP: DGS-3420-28SC:admin#create cfm mep mep1 mepid 1 md op_domain ma op1 direction inward port 2 Command: create cfm mep mep1 mepid 1 md op_domain ma op1 direction inward port 2 Success.
Page 199
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide between 1 and 4294967295. ma - Specify the maintenance association name. <string 22> - Specify the maintenance association name. The maximum length is 22 characters. ma_index - Specify the maintenance association index. <uint 1-4294967295>...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To delete a previously created maintenance domain: DGS-3420-28SC:admin#delete cfm md op_domain Command: delete cfm md op_domain Success.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 14-11 disable cfm Description This command is used to disable the CFM globally. Format disable cfm Parameters None. Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To disable the CFM globally: DGS-3420-28SC:admin#disable cfm...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters <portlist> - Specify the logical port list. state - Specify the CFM function status. enable - Specify to enable the CFM function. disable - Specify to disable the CFM function. Restrictions Only Administrator, Operator and Power-User level users can issue this command.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin# 14-15 show cfm fault Description This command is used to display all the fault conditions detected by the MEPs contained in the specified MA or MD. The display provides the overview of the fault status by MEPs. Format show cfm fault {md [<string 22>...
Page 207
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format show cfm port <port> {level <int 0-7> | direction [inward | outward] | vlanid <vlanid 1-4094>} Parameters <port> - Specify the port number. level - (Optional) Specify the maintenance domain level. If not specified, all levels are shown. <int 0-7>...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters md - Specifies the maintenance domain name. <string 22> - Enter the maintenance domain name here. This name can be up to 22 characters long. md_index – Specifies the MD index value used. <uint 1-4294967295>...
Page 209
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters <macaddr> - Specify the destination MAC address. mepname - Specify the MEP name. <string 32> - Specify the MEP name. The maximum length is 32 characters. mepid - (Optional) Specify the MEPID. <int 1-8191>...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin# 14-20 show cfm linktrace Description This command is used to display the link trace responses. The maximum linktrace responses a device can hold is 128. Format show cfm linktrace [mepname <string 32> | mepid <int 1-8191> md [<string 22> | md_index <uint 1-4294967295>] ma [<string 22>...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide To display a CFM linktrace reply: DGS-3420-28SC:admin# show cfm linktrace mepname mep trans_id 0 Command: show cfm linktrace mepname mep trans_id 0 Transaction ID: 0 From MEP mep to 00-15-72-20-91-09 Start Time : 2010-12-31 00:51:49 MEPID...
Page 213
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To delete the CFM link trace reply: DGS-3420-28SC:admin#delete cfm linktrace mepname mep1 Command: delete cfm linktrace mepname mep1 Success. DGS-3420-28SC:admin# 14-22 config cfm mp_ltr_all Description This command is to enable or disable the "all MPs reply LTRs" function. This function is for test purposes.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 14-23 show cfm mipccm Description This command is used to display the MIP CCM database entries. All entries in the MIP CCM database will be displayed. An MIP CCM entry is similar to an FDB which keeps the forwarding port information of a MAC entry.
Page 215
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters None. Restrictions None. Example To display the configuration of the all-MPs-reply-to-LTR function: DGS-3420-28SC:admin#show cfm mp_ltr_all Command: show cfm mp_ltr_all All MPs reply LTRs: Disabled DGS-3420-28SC:admin# 14-25 show cfm pkt_cnt Description This command is used to display the CFM packet’s RX/TX counters.
Page 217
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#clear cfm pkt_cnt Command: clear cfm pkt_cnt Success. DGS-3420-28SC:admin# To clear the CFM packet CCM counters: DGS-3420-28SC:admin#clear cfm pkt_cnt ccm Command: clear cfm pkt_cnt ccm Success. DGS-3420-28SC:admin# 14-27 show cfm remote_mep Description This command is used to display CFM remote MEP information.
Page 218
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To display CFM remote MEP information: DGS-3420-28SC:admin#show cfm remote_mep mepname mep1 remote_mepid 2 Command: show cfm remote_mep mepname mep1 remote_mepid 2 Remote MEPID MAC Address : 00-11-22-33-44-02 Status : OK : Yes...
Page 219
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 1sec - Specifies that the transmitting interval period will be set to 1 second. 1min - Specifies that the transmitting interval period will be set to 1 minute. level - (Optional) Specifies the client level ID to which the MEP sends AIS PDU.
Page 220
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide <int 1-8191> - Specify the MEP MEPID between 1 and 8191. period - (Optional) Specifies the transmitting interval of the LCK PDU. 1sec - Specifies that the transmitting interval period will be set to 1 second. 1min - Specifies that the transmitting interval period will be set to 1 minute.
Page 221
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example DGS-3420-28SC:admin#config cfm trap ais state enable Command: config cfm trap ais state enable Success. DGS-3420-28SC:admin#...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 15 Command List History Commands ? {<Command>} show command_history config command_history <value 1-40> 15-1 Description This command is used to display all of the commands available, on the current login account level, through the Command Line Interface (CLI).
Page 224
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To display the command history: DGS-3420-28SC:admin# show command_history Command: show command_history show traffic_segmentation 1-6 config traffic_segmentation 1-6 forward_list 7-8 config radius delete 1 config radius add 1 10.48.74.121 key dlink default config 802.1x reauth port_based ports all config 802.1x init port_based ports all config 802.1x auth_mode port_based...
Page 225
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To configure the number of commands the switch can record to the last 20 commands: DGS-3420-28SC:admin#config command_history 20 Command: config command_history 20 Success. DGS-3420-28SC:admin#...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 16 Command Logging Command List enable command logging disable command logging show command logging 16-1 enable command logging Description The enable command logging command is used to enable the command logging function. Note: When the switch is under the booting procedure and the procedure of downloading the configuration to execute immediately, all configuration commands should not be logged.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 16-2 disable command logging Description The disable command logging command is used to disable the command logging function. Format disable command logging Parameters None. Restrictions Only Administrator-level users can issue this command. Example To disable the command logging: DGS-3420-28SC:admin# disable command logging...
Page 228
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To show the command logging configuration status: DGS-3420-28SC:admin# show command logging Command: show command logging Command Logging State : Disabled DGS-3420-28SC:admin#...
Page 230
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 17-2 show route preference Description This command is used to display the route preference of each route type. Format show route preference {[local | static | default | rip]} Parameters local - (Optional) Display the preference of local route.
Page 231
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format create route redistribute dst rip src [local | static] {metric <value 0-16>} Parameters dst - Specifies the target protocol. src - Specifies the source protocol. local - To redistribute local routes to RIP. static - To redistribute static routes to RIP.
Page 232
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To configure route redistributions: DGS-3420-28SC:admin# config route redistribute dst rip src local metric 1 Command: config route redistribute dst rip src local metric 1 Success.
Page 233
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 17-6 show route redistribute dst rip Description This command is used to display the route redistribution settings on the Switch. It displays the redistribution with the target protocol RIP. Format show route redistribute dst rip {src [local | static]} Parameters...
Page 234
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format show route redistribute Parameters None. Restrictions None. Example To display route redistributions: DGS-3420-28SC:admin#show route redistribute Command: show route redistribute Route Redistribution Settings Source Destination Type Metric Protocol Protocol -------- ------------...
Page 236
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To assign a static VLAN to be a guest VLAN: DGS-3420-28SC:admin#create authentication guest_vlan vlan guestVLAN Command: create authentication guest_vlan vlan guestVLAN Success.
Page 237
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 18-3 config authentication guest_vlan Description This command is used to assign or remove ports to or from a guest VLAN. Format config authentication guest_vlan [vlan <vlan_name 32> | vlanid <vlanid 1-4094>] [add | delete] ports [<portlist>...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters case - (Optional) Specifies the case format used. lowercase - Specifies using the lowercase format, the RADIUS authentication username will be formatted as: aa-bb-cc-dd-ee-ff. uppercase - Specifies using the uppercase format, the RADIUS authentication username will be formatted as: AA-BB-CC-DD-EE-FF.
Page 239
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide port-based - If one of the attached hosts pass the authentication, all hosts on the same port will be granted access to the network. If the user fails the authorization, this port will keep trying the next authentication.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 18-6 show authentication Description This command is used to display the global authentication configuration. Format show authentication Parameters None. Restrictions None. Example To display the global authentication configuration: DGS-3420-28SC:admin#show authentication Command: show authentication Authentication Server Failover: Block.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To display the guest VLAN setting: DGS-3420-28SC:admin#show authentication guest_vlan Command: show authentication guest_vlan Guest VLAN VID Guest VLAN Member Ports: Total Entries: 0 DGS-3420-28SC:admin# 18-8 show authentication mac_format Description This command is used to display the authentication MAC format setting.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format show authentication ports {<portlist>} Parameters <portlist> - (Optional) Specify to display compound authentication on specific port(s). Restrictions None. Example To display the authentication settings for ports 1 to 3: DGS-3420-28SC:admin#show authentication ports 1-3 Command: show authentication ports 1-3 Port...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To enable the authorization global state: DGS-3420-28SC:admin#enable authorization attributes Command: enable authorization attributes Success. DGS-3420-28SC:admin# 18-11 disable authorization attributes Description This command is used to disable the authorization global state. Format disable authorization attributes Parameters...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters None. Restrictions None. Example To display the authorization status: DGS-3420-28SC:admin#show authorization Command: show authorization Authorization for Atributes: Enabled DGS-3420-28SC:admin# 18-13 config authentication server failover Description This command is used to configure the authentication server failover function. When authentication server fails, administrator can configure to: * Use the local database to authenticate the client.
Page 245
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To set the authentication server failover state: DGS-3420-28SC:admin#config authentication server failover local Command: config authentication server failover local Success. DGS-3420-28SC:admin#...
Page 247
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 19-1 debug address_binding Description This command is used to start the IMPB debug when the IMPB module receives an ARP/IP packet or a DHCP packet. Format debug address_binding [event | dhcp | all] state [enable | disable] Parameters event - To print out the debug messages when IMPB module receives ARP/IP packets.
Page 248
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator level users can issue this command. Example To stop IMPB debug: starting when the IMPB module receives an ARP/IP or DHCP packet: DGS-3420-28SC:admin# no debug address_binding Command: no debug address_binding Success.
Page 249
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide # level: CPU exception # clock: 437453880 ms # time : 2000-01-08 05:55:40 ======================== CPU EXCEPTION ======================== Current Task = IP-Tic Stack Pointer = 4CFEA7A0 ---------------------------CP0 Registers----------------------- Status : 1000FC01 Interrupt enable Normal level Cause...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin# debug error_log upload_toTFTP 10.0.0.90 debug-log.txt Command: debug error_log upload_toTFTP 10.0.0.90 debug-log.txt Connecting to server....Done. Upload configuration....Done. DGS-3420-28SC:admin# 19-4 debug buffer Description Use this command to show the debug buffer’s state, or dump, clear, or upload the debug buffer to a TFTP server.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin# debug buffer utilization Command: debug buffer utilization Allocate from System memory Total size 2 MB Utilization rate DGS-3420-28SC:admin# To clear the debug buffer: DGS-3420-28SC:admin# debug buffer clear Command: debug buffer clear Success.
Page 252
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters module - Specifies the module list. <module_list> - Enter the module list here. all - Control output method of all modules. buffer - Direct the debug message of the module output to debug buffer(default). console - Direct the debug message of the module output to local console.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin# debug config error_reboot disable Command: debug config error_reboot disable Success. DGS-3420-28SC:admin# 19-7 debug config state Description Use the command to set the state of the debug. Format debug config state [enable | disable] Parameters enable - Enable the debug state.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters None. Restrictions Only Administrator level users can issue this command. Example To show the error reboot status: DGS-3420-28SC:admin#debug show error_reboot state Command: debug show error_reboot state Error Reboot: Enabled DGS-3420-28SC:admin# 19-9 debug stp clear counter...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters ports - (Optional) Specifies the STP ports for display. <portlist> - Enter the list of port used for this configuration here. all - Display all port’s counters. If no parameter is specified, display the global counters.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format debug stp show flag {ports <portlist>} Parameters ports - (Optional) Specifies the STP ports to display. <portlist> - (Optional) Enter the list of port used for this configuration here. If no parameter is specified, all ports on the switch will be displayed.
Page 258
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format debug stp show information Parameters None. Restrictions Only Administrator level users can issue this command. Example To show STP debug information:...
Page 259
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin# debug stp show information Command: debug stp show information Spanning Tree Debug Information: ---------------------------------------- Port Status In Hardware Table: Instance 0: Port 1 :BLK Port 2 :BLK Port 3 :BLK Port 4 :BLK Port 5 :BLK...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 19-14 debug stp state Description This command is used to enable or disable the STP debug state. Format debug stp state [enable | disable] Parameters state - Specifies the STP debug state. enable - Enable the STP debug state.
Page 261
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters None. Restrictions Only Administrator-level users can issue this command. Example To enabled DHCPv6 client debug function: DGS-3420-28SC:admin# debug dhcpv6_client state enable Command: debug dhcpv6_client state enable Success. DGS-3420-28SC:admin# 19-16 debug dhcpv6_client state disable Description...
Page 262
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 19-17 debug dhcpv6_client output Description Used to set debug message to output to buffer or console. Format debug dhcpv6_client output [buffer | console] Parameters buffer - Let the debug message output to buffer. console - Let the debug message output to console.
Page 263
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator-level users can issue this command. Example To enable dhcpv6_client packet sending debug: DGS-3420-28SC:admin# debug dhcpv6_client packet sending state enable Command: debug dhcpv6_client packet sending state enable Success.
Page 264
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 19-20 debug dhcpv6_relay state disable Description This command is used to disable the DHCPv6 relay Debug function. Format debug dhcpv6_relay state disable Parameters None. Restrictions Only Administrator-level users can issue this command. Example To disabled DHCPv6 relay debug function: DGS-3420-28SC:admin#...
Page 265
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To enable debug information flag about the hop count: DGS-3420-28SC:admin# debug dhcpv6_relay hop_count state enable Command: debug dhcpv6_relay hop_count state enable Success. DGS-3420-28SC:admin# 19-22 debug dhcpv6_relay output Description Used to set debug message to output to buffer or console.
Page 266
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format debug dhcpv6_relay packet {all | receiving | sending} state [enable | disable] Parameters all - (Optional) Set packet receiving and sending debug flags. receiving - (Optional) Set packet receiving debug flag. sending - (Optional) Set packet sending debug flag.
Page 267
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator-level users can issue this command. Example To enabled the DHCPv6 server packet sending debug: DGS-3420-28SC:admin# debug dhcpv6_server packet sending state enable Command: debug dhcpv6_server packet sending state enable Success.
Page 268
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format debug dhcpv6_server state enable Parameters None. Restrictions Only Administrator-level users can issue this command. Example To enabled the DHCPv6 server debug function: DGS-3420-28SC:admin# debug dhcpv6_server state enable Command: debug dhcpv6_server state enable Success.
Page 269
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator-level users can issue this command. Example To enable the RIPng interface debug: DGS-3420-28SC:admin# debug ripng flag interface state enable Command: debug ripng flag interface state enable Success.
Page 270
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin# debug ripng show flag Command: debug ripng show flag Current Enabled RIPng Flags: Interface State Change Packet Receiving Packet Sending Route DGS-3420-28SC:admin# 19-29 debug ripng state disable Description This command is used to disable the RIPng debugging state.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format debug ripng state enable Parameters None. Restrictions Only Administrator-level users can issue this command. Example To enable RIPng debug globally: DGS-3420-28SC:admin# debug ripng state enable Command: debug ripng state enable Success.
Page 272
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Prompt# debug show status module MSTP Command: debug show status module MSTP Debug Global State : Enable MSTP : Enable Prompt# To show the debug state: Prompt# debug show status Command: debug show status Debug Global State: Enable : Enable...
Page 273
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To display the DHCPv6 snooping binding state of entries: DGS-3420-28SC:admin# debug show address_binding binding_state_table dhcpv6_snooping Command: debug show address_binding binding_state_table dhcpv6_snooping S (State) - S: Start, L: Live, D :Detection, R: Renew, B: Bound Time - Expiry Time (sec) IP Address MAC Address...
Page 274
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide all - Specifies that all the box IDs will be used. sio1 - Specifies that the first stacking port will be used. sio2 - Specifies that the second stacking port will be used. Restrictions Only Administrator-level users can issue this command.
Page 275
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters None. Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To display debug information of JWAC: DGS-3420-28SC:admin#debug show jwac auth_info Command: debug show jwac auth_info ACL Index Bitmap DB (jwac_db_acl_bmp): Internal TCP Port Number (jwac_internal_port_bitmap): Connection DB:...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters <value 1-12> - Enter the box ID used here. This value must be between 1 and 12. all - Specifies that all the box IDs will be used. sio1 - Specifies that the first stacking port will be used.
Page 277
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters vr_state_change - Specify the VRRP virtual router state change debug flag. packet - Specify to set the VRRP packet flags. all - Sets VRRP all packet debug flags. receiving - Set the VRRP packet receiving flag.
Page 278
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#debug vrrp interface_change state enable Command: debug vrrp interface_change state enable Success. DGS-3420-28SC:admin# To enable the VRRP timers debug flag: DGS-3420-28SC:admin#debug vrrp timers state enable Command: debug vrrp timers state enable Success.
Page 279
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 19-38 debug vrrp log state Description This command is used to enable or disable the VRRP debug log state. Format debug vrrp log state [enable | disable] Parameters enable - Specify that the VRRP debug log state will be enabled.
Page 280
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To display VRRP statistic counters: DGS-3420-28SC:admin#debug vrrp show counter Command: debug vrrp show counter VRRP debug statistic counters Received ADV : 9 Drop : 52 Auth fail Sent ADV DGS-3420-28SC:admin# 19-40 debug vrrp show flag...
Page 281
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#debug vrrp show flag Command: debug vrrp show flag Global State: Disabled Current VRRP debug level setting: virtual router state change packet receiving packet sending mac address update interface change timer DGS-3420-28SC:admin#...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 19-42 debug vrrp state Description The command is used to enable or disable the VRRP debug state. Format debug vrrp state [enable | disable] Parameters enable - Specify that the VRRP debug state will be enabled. disable - Specify that the VRRP debug state will be disabled.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 20 DHCP Local Relay Commands config dhcp_local_relay vlan <vlan_name 32> state [enable | disable] config dhcp_local_relay vlan vlanid <vlan_id 1-4094> state [enable | disable] enable dhcp_local_relay disable dhcp_local_relay show dhcp_local_relay 20-1 config dhcp_local_relay vlan...
Page 284
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#config dhcp_local_relay vlan default state enable Command: config dhcp_local_relay vlan default state enable Success. DGS-3420-28SC:admin# 20-2 config dhcp_local_relay vlan vlanid Description This command is used to enable or disable the DHCP local relay function for a specified VLAN ID. Format config dhcp_local_relay vlan vlanid <vlan_id 1-4094>...
Page 285
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters None. Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To enable the DHCP local relay function: DGS-3420-28SC:admin#enable dhcp_local_relay Command: enable dhcp_local_relay Success. DGS-3420-28SC:admin# 20-4 disable dhcp_local_relay...
Page 286
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 20-5 show dhcp_local_relay Description This command is used to display the current DHCP local relay configuration on the switch. Format show dhcp_local_relay Parameters None. Restrictions None. Example To display the local DHCP relay status: DGS-3420-28SC:admin#show dhcp_local_relay Command: show dhcp_local_relay DHCP/BOOTP Local Relay Status...
Page 288
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format config dhcp_relay {hops <int 1-16> | time <sec 0-65535>}(1) Parameters hops - Specify the maximum number of router hops that the DHCP/BOOTP packets can cross. The range is 1 to 16. The default value is 4. <int 1-16>...
Page 289
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide <ipaddr> - Specify the DHCP/BOOTP server IP address. Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To add an IP destination address to the switch’s DHCP relay table: DGS-3420-28SC:admin#config dhcp_relay add ipif System 10.43.21.12 Command: config dhcp_relay add ipif System 10.43.21.12 Success.
Page 290
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 21-4 config dhcp_relay option_60 add string Description This command is used to configure the Option 60 relay rules. Note that different strings can be specified with the same relay server, and the same string can be specified with multiple relay servers. The system will relay the packet to all the matching servers.
Page 291
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format config dhcp_relay option_60 default [relay <ipaddr> | mode [relay | drop]] Parameters relay - Specify a relay server IP for the packet that has matching Option 60 rules. <ipaddr>...
Page 292
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide default - Delete the default relay IP address that is specified by the user. <ipaddr> - (Optional) Enter the IP address here. Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To delete a DHCP Option 60 entry: DGS-3420-28SC:admin# config dhcp_relay option_60 delete string "abc"...
Page 293
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Success. DGS-3420-28SC:admin# 21-8 config dhcp_relay option_61 add Description This command adds a rule to determine the relay server based on Option 61. The match rule can be based on either MAC address or a user-specified string. Only one relay server can be specified for a MAC address or a string.
Page 294
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 21-9 config dhcp_relay option_61 default Description This command is used to determine the rule to process those packets that have no Option 61 matching rules. The default default-rule is drop. Format config dhcp_relay option_61 default [relay <ipaddr>...
Page 295
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To delete a DHCP Option 61 entry: DGS-3420-28SC:admin#config dhcp_relay option_61 delete mac_address 00-11-22-33-44- Command: config dhcp_relay option_61 delete mac_address 00-11-22-33-44-55 Success.
Page 296
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin# 21-12 config dhcp_relay option_82 check Description This command is used to configure the checking mechanism of the DHCP relay agent information Option 82 of the switch. Format config dhcp_relay option_82 check [enable | disable] Parameters enable - When the state is enabled, for a packet coming from the client side, the packet should not...
Page 297
<desc 32> - The user-defined string can be up to 32 characters long. Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To configure the remote ID string of the DHCP relay agent information Option 82: DGS-3420-28SC:admin#config dhcp_relay option_82 remote_id user_define D-Link Switch...
Page 298
DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Command: config dhcp_relay option_82 remote_id user_define D-Link Switch Success. DGS-3420-28SC:admin# 21-15 config dhcp_relay option_82 state Description This command is used to configure the state of the DHCP relay agent information Option 82 of the switch.
Page 299
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters None. Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To enable the DHCP relay function: DGS-3420-28SC:admin#enable dhcp_relay Command: enable dhcp_relay Success. DGS-3420-28SC:admin# 21-17 disable dhcp_relay Description This command is used to disable the DHCP relay function on the switch.
Page 300
DHCP Relay Agent Information Option 82 State : Disabled DHCP Relay Agent Information Option 82 Check : Disabled DHCP Relay Agent Information Option 82 Policy : Replace DHCP Relay Agent Information Option 82 Remote ID : D-Link Switch Interface Server 1 Server 2 Server 3...
Page 301
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 21-19 show dhcp_relay option_60 Description This command is used to display the DHCP relay option 60 entries. Format show dhcp_relay option_60 {[string <multiword 255> | ipaddress <ipaddr> | default]} Parameters string - (Optional) Display the entry whose string equals the string specified.
Page 302
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin# 21-20 show dhcp_relay option_61 Description This command is used to display all the DHCP relay option 61 rules. Format show dhcp_relay option_61 Parameters None. Restrictions None. Example To display the DHCP option 61 entries: DGS-3420-28SC:admin#show dhcp_relay option_61 Command: show dhcp_relay option_61...
Page 303
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format config dhcp_relay ports [<portlist> | all] state [enable | disable] Parameters <portlist> - Enter the list of ports, used for this configuration, here. all - Specifies that all the ports will be used for this configuration. state - Specifies the state of the DHCP relay function for each port.
Page 304
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#show dhcp_relay ports 1:1-1:10 Command: show dhcp_relay ports 1:1-1:10 Port DHCP Relay State ---- ---------------- Enabled Enabled Enabled Enabled Enabled Enabled Enabled Enabled Enabled 1:10 Enabled Total Entries : 10 DGS-3420-28SC:admin#...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 22 DHCP Server Commands create dhcp excluded_address begin_address <ipaddr> end_address <ipaddr> delete dhcp excluded_address [begin_address <ipaddr> end_address <ipaddr> | all] show dhcp excluded_address create dhcp pool <pool_name 12> delete dhcp pool [<pool_name 12>...
Page 306
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 22-1 create dhcp excluded_address Description This command is used to create a DHCP server exclude address. The DHCP server assumes that all IP addresses in a DHCP pool subnet are available for assigning to DHCP clients. Use this command to specify the IP address that the DHCP server should not assign to clients.
Page 307
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters begin_address - Specify the starting address of the IP address range. <ipaddr> - Specify the starting address of the IP address range. end_address - Specify the ending address of the IP address range. <ipaddr>...
Page 308
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#show dhcp excluded_address Command: show dhcp excluded_address Index Begin Address End Address ----- ------------- -------------- 192.168.0.1 192.168.0.100 10.10.10.10 10.10.10.11 Total Entries : 2 DGS-3420-28SC:admin# 22-4 create dhcp pool Description This command is used to create a DHCP pool by specifying a name.
Page 309
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format delete dhcp pool [<pool_name 12> | all] Parameters <pool_name 12> - Specify the name of the DHCP pool. all - Specify to delete all the DHCP pools. Restrictions Only Administrator, Operator and Power-User level users can issue this command.
Page 310
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To configure the address range of the DHCP address pool: DGS-3420-28SC:admin#config dhcp pool network_addr nyknicks 10.10.10.0/24 Command: config dhcp pool network_addr nyknicks 10.10.10.0/24 Success.
Page 311
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 22-8 config dhcp pool dns_server Description This command is used to specify the IP address of a DNS server that is available to a DHCP client. Up to three IP addresses can be specified on one command line. If DNS server is not specified, the DNS server information will not be provided to the client.
Page 312
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters <pool_name 12> - Specify the DHCP pool name. <ipaddr> - (Optional) Specify the IP address of the WINS server. Up to three IP addresses can be specified on one command line. Restrictions Only Administrator, Operator and Power-User level users can issue this command.
Page 313
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To configure the NetBIOS node type: DGS-3420-28SC:admin#config dhcp pool netbios_node_type knicks hybrid Command: config dhcp pool netbios_node_type knicks hybrid Success. DGS-3420-28SC:admin# 22-11 config dhcp pool default_router Description This command is used to specify the IP address of the default router for a DHCP client.
Page 314
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 22-12 config dhcp pool lease Description This command is used to specify the duration of the DHCP pool lease. By default, each IP address assigned by a DHCP server comes with a one-day lease, which is the amount of time that the address is valid.
Page 315
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters <pool_name 12> - Specify the DHCP pool name. <file_name 64> - (Optional) Specify the file name of the boot image. Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To configure the boot file: DGS-3420-28SC:admin#config dhcp pool boot_file engineering boot.had...
Page 316
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Success. DGS-3420-28SC:admin# 22-15 config dhcp pool class Description This command is used to configure an address range for a specific DHCP pool class. Format config dhcp pool class <pool_name 12> [add | delete] <class_name 12> {begin_address <ipaddr>...
Page 317
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 22-16 config dhcp pool option_43 Description This command is used to add or delete DHCP Option 43. The DHCP server may contain this option in the DHCP reply according to Option 55 in the client’s request packet. Format config dhcp pool option_43 <pool_name 12>...
Page 318
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters None. Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To enable the DHCP class function: DGS-3420-28SC:admin#enable dhcp class Command: enable dhcp class Success.
Page 319
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 22-19 create dhcp class Description This command is used to create a DHCP class. Administrators can create a DHCP class with a name that is a symbolic string, like "class1”. Format create dhcp class <class_name 12>...
Page 320
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide characters long. add - Specifies to add an option to the DHCP server class. option - Specifies the Option index that will be added. <int> - Enter the Option index value used here. string - Specifies the character string used with the DHCP class options.
Page 321
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 22-21 delete dhcp class Description This command is used to delete a DHCP class. Format delete dhcp class <class_name 12> Parameters class - Specifies the DHCP class name used. <class_name 12>...
Page 322
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions None. Example To display the current DHCP class configuration: DGS-3420-28SC:admin#show dhcp class Command: show dhcp class DHCP Class Status : Disabled DHCP Class Name : class1 Option Type Value ---------...
Page 323
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To configure ping packets: DGS-3420-28SC:admin#config dhcp ping_packets 4 Command: config dhcp ping_packets 4 Success. DGS-3420-28SC:admin# 22-24 config dhcp ping_timeout Description This command is used to specify the amount of time the DHCP server must wait before timing out a ping packet.
Page 324
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide An address binding is a mapping between the IP address and MAC address of a client. The IP address of a client can be assigned manually by an administrator or assigned automatically from a pool by a DHCP server.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format delete dhcp pool manual_binding <pool_name 12> [<ipaddr> | all] Parameters <pool_name 12> - Specify the DHCP pool name. <ipaddr> - Specify the IP address which will be assigned to a specified client. all - Specify to delete all manual binding IP addresses from the specified pool.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To clear dynamic binding entries in the pool named “engineering”: DGS-3420-28SC:admin#clear dhcp binding engineering 10.20.3.4 Command: clear dhcp binding engineering 10.20.3.4 Success. DGS-3420-28SC:admin# 22-28 show dhcp binding Description This command is used to display dynamic binding entries.
Page 327
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 22-29 show dhcp pool Description This command is used to display the information for DHCP pool. If pool name is not specified, information for all pools will be displayed. Format show dhcp pool {<pool_name 12>} Parameters...
Page 328
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 22-30 show dhcp pool manual_binding Description This command is used to display the configured manual binding entries. Format show dhcp pool manual_binding {<pool_name 12>} Parameters <pool_name 12> - (Optional) Specify the DHCP pool name. Restrictions None.
Page 329
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters None. Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To enable DHCP server: DGS-3420-28SC:admin#enable dhcp_server Command: enable dhcp_server Success. DGS-3420-28SC:admin# 22-32 disable dhcp_server Description This command is used to disable the DHCP server function on the switch.
Page 330
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 22-33 show dhcp_server Description This command is used to display the current DHCP server configuration. Format show dhcp_server Parameters None. Restrictions None. Example To display the DHCP server status: DGS-3420-28SC:admin#show dhcp_server Command: show dhcp_server DHCP Server Global State: Disabled...
Page 331
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions None. Example To clear an IP address 10.20.3.4 from the conflict database: DGS-3420-28SC:admin#clear dhcp conflict_ip 10.20.3.4 Command: clear dhcp conflict_ip 10.20.3.4 Success. DGS-3420-28SC:admin# 22-35 show dhcp conflict_ip Description This command is used to display the IP address that has been identified as being in conflict.
Page 332
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin# 22-36 create dhcp option_profile Description This command is used to create a DHCP option profile. Format create dhcp option_profile <profile_name 12> Parameters <profile_name 12> - Enter the DHCP option profile name here. This name can be up to 12 characters long.
Page 333
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide option - Specifies the option value used. <value 1-254> - Enter the option value used here. This must be between 1 and 254. string - Specifies the character string associated with the option. <multiword 255>...
Page 334
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 22-38 delete dhcp option_profile Description This command is used to delete a DHCP option profile. Format delete dhcp option_profile <profile_name 12> Parameters <profile_name 12> - Enter the DHCP server option profile name here. This name can be up to 12 characters long.
Page 335
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To display the current DHCP option profile configuration. DGS-3420-28SC:admin#show dhcp option_profile Command: show dhcp option_profile DHCP Option Profile Name : profile1 Option Type Value ------ ------ ------------------------------------------------------------ c0a800fe string 192.168.0.254...
Page 336
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin# To delete an option profile from a DHCP pool: DGS-3420-28SC:admin#config dhcp pool option_profile pool1 delete profile1 Command: config dhcp pool option_profile pool1 delete profile1 Success. DGS-3420-28SC:admin#...
Page 338
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters add permit server_ip - Specify the IP address of the DHCP server to be permitted. <ipaddr> - Specify the IP address. client_mac - (Optional) Specify the MAC address of the DHCP client. <macaddr>...
Page 339
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 23-2 config filter dhcp_server log Description This command is used to enable or disable the log for a DHCP server filter event. Format config filter dhcp_server log [enable | disable] Parameters enable –...
Page 340
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To enable the trap for a DHCP server filter event: DGS-3420-28SC:admin#config filter dhcp_server trap enable Command: config filter dhcp_server trap enable Success. DGS-3420-28SC:admin# 23-4 show filter dhcp_server Description This command is used to display the DHCP server/client filter list created on the switch.
Page 341
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 23-5 create filter dhcpv6_server permit sip Description This command used to create a permit entry. The specific DHCPv6 server packets, with the source IPv6 address, will be forwarded on the specified port(s). Format create filter dhcpv6_server permit sip <ipv6addr>...
Page 342
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide disable - Specifies that the log for the Filter DHCPv6 server will be disabled. Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To enable the Filter DHCPv6 Server log state: DGS-3420-28SC:admin#config filter dhcpv6_server log enable Command: config filter dhcpv6_server log enable Success.
Page 343
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Success. DGS-3420-28SC:admin# 23-8 config filter dhcpv6_server trap Description This command is used to enable or disable the filter DHCPv6 server trap state. Format config filter dhcpv6_server trap [enable | disable] Parameters enable - Specifies that the trap for the filter DHCPv6 server will be enabled.
Page 344
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions None. Example To display filter DHCPv6 server information: DGS-3420-28SC:admin#show filter dhcpv6_server Command: show filter dhcpv6_server Enabled ports:1:1-1:8 Trap State: Enabled State: Enabled Permit Source Address Table: Source IP Address Port --------------------------------------- ---------------...
Page 345
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Success. DGS-3420-28SC:admin# 23-11 create filter icmpv6_ra_all_node permit sip Description This command is used to create a filter ICMPv6 RA All-nodes permit entry. Format create filter icmpv6_ra_all_node permit sip <ipv6addr> ports [<portlist> | all] Parameters <ipv6addr>...
Page 346
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters enable - Specifies that the log for the filter ICMPv6 RA will be enabled. The log for filter ICMPv6 RA all-nodes will be generated. disable - Specifies that the log for the filter ICMPv6 RA will be disabled. Restrictions Only Administrator, Operator and Power-User level users can issue this command.
Page 347
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To configure the filter ICMPv6 RA all-nodes state to enabled for ports 1 to 8: DGS-3420-28SC:admin#config filter icmpv6_ra_all_node ports 1:1-1:8 state enable Command: config filter icmpv6_ra_all_node ports 1:1-1:8 state enable Success.
Page 348
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format show filter icmpv6_ra_all_node Parameters None. Restrictions None. Example To display filter ICMPv6 RA all-nodes information: DGS-3420-28SC:admin#show filter icmpv6_ra_all_node Command: show filter icmpv6_ra_all_node Enabled ports:1:1-1:8 Trap State: Enabled State: Enabled Permit Source Address Table: Source IP Address...
Page 349
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To delete permit entry from the filter ICMPv6 RA all-nodes forward list: DGS-3420-28SC:admin#delete filter icmpv6_ra_all_node permit sip 2200::4 Command: delete filter icmpv6_ra_all_node permit sip 2200::4 Success.
Page 351
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format disable dhcpv6_relay Parameters None. Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To configure the DHCPv6 relay global state to disable: DGS-3420-28SC:admin# disable dhcpv6_relay Command: disable dhcpv6_relay Success.
Page 352
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin# config dhcpv6_relay hop_count 4 Command: config dhcpv6_relay hop_count 4 Success. DGS-3420-28SC:admin# 24-4 config dhcpv6_relay Description The command could add/delete an IPv6 address which is a destination to forward (relay) DHCPv6 packets.
Page 353
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format config dhcpv6_relay ipif [<ipif_name 12> | all] state [enable | disable] Parameters ipif - Specifies the name of the IP interface. <ipif_name 12> - Enter the IP interface name used here. This name can be up to 12 characters long.
Page 354
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions None. Example To show the DHCPv6 relay configuration of all interfaces: DGS-3420-28SC:admin# show dhcpv6_relay Command: show dhcpv6_relay DHCPv6 Relay Global State : Disabled DHCPv6 Hops Count Limit --------------------------------------------------------------- IP Interface : n81...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 25 DHCPv6 Server Commands create dhcpv6 pool <pool_name 12> delete dhcpv6 pool [<pool_name 12> | all] show dhcpv6 pool {<pool_name 12>} config dhcpv6 pool ipv6network_addr <pool_name 12> begin <ipv6networkaddr> end <ipv6networkaddr>...
Page 356
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To create a DHCPv6 pool pool1: DGS-3420-28SC:admin# create dhcpv6 pool pool1 Command : create dhcpv6 pool pool1 success DGS-3420-28SC:admin# 25-2 delete dhcpv6 pool Description This command is used to delete one or all DHCPv6 pools. Format delete dhcpv6 pool [<pool_name 12>...
Page 357
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format show dhcpv6 pool {<pool_name 12>} Parameters pool – Specifies the DHCPv6 pool to be displayed. <pool_name 12> - (Optional) Enter the DHCPv6 pool name to be displayed here. This name can be up to 12 characters long.
Page 358
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide The begin address must not be large than end address, otherwise, the switch will print an error message: The begin IPv6 address must be lower than or equal to the end IPv6 address.(e.g.: the begin_networkaddr is 2000::200/64, and the end_networkaddr is 2000::100/64) There must not be intersection between the IPv6 address ranges of two pools, otherwise, the Switch will print an error message: IPv6network address collision.
Page 359
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format config dhcpv6 pool domain_name <pool_name 12> <domain_name 255> Parameters <pool_name 12> - Enter the DHCPv6 pool name used here. This name can be up to 12 characters long. <domain_name 255>...
Page 360
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To configure the DNS server address for a DHCPv6 pool: DGS-3420-28SC:admin# config dhcpv6 pool dns_server pool1 2000::200 2000::201 Command: config dhcpv6 pool dns_server pool1 2000::200 2000::201 Success.
Page 361
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To configure the preferred-lifetime and valid-lifetime for the DHCPv6 pool: DGS-3420-28SC:admin# config dhcpv6 pool lifetime pool1 preferred_lifetime 80 valid_lifetime 100 Command: config dhcpv6 pool lifetime pool1 preferred_lifetime 80 valid_lifetime 100 Success.
Page 362
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin# config dhcpv6 pool manual_binding pool1 add 2000::3 client_duid 00010006124dd5840021918d4d9f Command: config dhcpv6 pool manual_binding pool1 add 2000::3 client_duid 00010006124dd5840021918d4d9f success DGS-3420-28SC:admin# 25-9 config dhcpv6 pool prefix_delegation Description This command is used to create a DHCPv6 prefix pool for an interface.
Page 363
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format show dhcpv6 manual_binding {<pool_name 12>} Parameters <pool_name 12> - (Optional) Enter the DHCPv6 pool name used here. This name can be up to 12 characters long. If no parameter is specified, then all the entries will be displayed. Restrictions None.
Page 364
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format show dhcpv6 binding {<pool_name 12>} Parameters <pool_name 12> - (Optional) Enter the DHCPv6 pool name used here. This name can be up to 12 characters long. Restrictions None.
Page 365
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To clear the DHCPv6 dynamic binding information on the Switch: DGS-3420-28SC:admin# clear dhcpv6 binding Command: clear dhcpv6 binding Success.
Page 366
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format disable dhcpv6_server Parameters None. Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To configure the DHCPv6 server global state to disable: DGS-3420-28SC:admin# disable dhcpv6_server Command: disable dhcpv6_server Success.
Page 367
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin# show dhcpv6_server Command: show dhcpv6_server DHCPv6 Server Global State: Disabled --------------------------------------------------------------- IP Interface : System DHCPv6 Server State : Enabled IP Interface : ipif1 DHCPv6 Server State : Enabled Total Entries DGS-3420-28SC:admin#...
Page 368
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To add the IPv6 addresses range that DHCPv6 server should not assign to clients: DGS-3420-28SC:admin# config dhcpv6 pool excluded_address pool1 add begin 2000::3 end 2000::8 Command: config dhcpv6 pool excluded_address pool1 add begin 2000::3 end 2000::8 Success.
Page 369
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin# show dhcpv6 excluded_address Command: show dhcpv6 excluded_address Pool Name: net100 Range Begin Address: 3000:100:1::1 End Address : 3000:100:1::7 Pool Name: net110 Range Begin Address: 3000:110:1::1 End Address : 3000:110:1::7 Range Begin Address: 3000:110:1::9...
Page 370
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To configure the DHCPv6 Server state of System Interface to enable: DGS-3420-28SC:admin# config dhcpv6_server ipif System state enable Command: config dhcpv6_server ipif System state enable Success. DGS-3420-28SC:admin#...
Page 373
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide parameter falls below this value, the action associated with the warning is taken. <degrees> - Enter the low threshold warning value here. voltage_threshold - Specify the threshold of optic module’s voltage. high_alarm - (Optional) Specify the high threshold for the alarm.
Page 374
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide action will take effect. enable - Specify to enable the DDM state. disable - Specify to disable the DDM state. shutdown - (Optional) Specify whether or not to shutdown the port when the operating parameter exceeds the corresponding alarm threshold or warning threshold.
Page 376
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To display the DDM global settings: DGS-3420-28SC:admin#show ddm Command: show ddm DDM Log : Enabled DDM Trap : Disabled DDM Tx/Rx Power Unit : mw DGS-3420-28SC:admin# 26-4 show ddm ports Description This command is used to show the current operating DDM parameters and configuration values of the...
Page 377
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#show ddm ports 1:21-1:22 status Command: show ddm ports 1:21-1:22 status Port Temperature Voltage Bias-Current TX-Power RX-Power (in Celsius) (mA) (mW) (mW) ------- ------------- ---------- -------------- ---------- ------------ 1:21 21.5 1:22...
Page 378
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator and Operator-level users can issue this command. Example To configure the DDM TX and RX power unit as dBm: DGS-3420-28SC:admin#config ddm power_unit dbm Command: config ddm power_unit dbm Success.
Page 380
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin# config dnsr primary nameserver 10.24.22.5 Command: config dnsr primary nameserver 10.24.22.5 Success. DGS-3420-28SC:admin# To add the entry “dns1” with IP address 10.24.22.5 to the DNS static table: DGS-3420-28SC:admin#config dnsr add static dns1 10.24.22.5 Command: config dnsr add static dns1 10.24.22.5 Success.
Page 381
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#enable dnsr Command: enable dnsr Success. DGS-3420-28SC:admin# To enable cache lookup for DNS relay: DGS-3420-28SC:admin#enable dnsr cache Command: enable dnsr cache Success. DGS-3420-28SC:admin# To enable static table lookup for DNS relay: DGS-3420-28SC:admin#enable dnsr static Command: enable dnsr static Success.
Page 382
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#disable dnsr Command: disable dnsr Success. DGS-3420-28SC:admin# To disable cache lookup for DNS relay: DGS-3420-28SC:admin#disable dnsr cache Command: disable dnsr cache Success. DGS-3420-28SC:admin# To disable static table lookup for DNS relay: DGS-3420-28SC:admin#disable dnsr static Command: disable dnsr static Success.
Page 383
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#show dnsr Command: show dnsr DNSR Status : Disabled Primary Name Server : 0.0.0.0 Secondary Name Server : 0.0.0.0 DNSR Cache Status : Disabled DNSR Static Table Status : Disabled DNS Relay Static Table Domain Name IP Address...
Page 385
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin# config name_server add 10.10.10.10 primary Command: config name_server add 10.10.10.10 primary Success. DGS-3420-28SC:admin# 28-2 config name_server delete Description This command is used to delete a DNS resolver name server from the Switch. Format config name_server delete [<ipaddr>...
Page 386
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters timeout - Specifies the maximum time waiting for a responce from a specified name server. <sec 1-60> - Enter the timeout value used here. This value must be between 1 and 60 seconds.
Page 387
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin# show name_server Command: show name_server Name Server Time Out: 3 seconds Static Name Server Table: Server IP Address Priority --------------------- -------------- 20.20.20.20 Secondary 10.1.1.1 Primary Dynamic Name Server Table: Server IP Address Priority --------------------- --------------...
Page 388
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 28-6 delete host_name Description This command is used to delete the static or dynamic host name entries of the Switch. Format delete host_name [<name 255> | all] Parameters <name 255>...
Page 389
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To display the static and dynamic host name entries: DGS-3420-28SC:admin#show host_name Command: show host_name Static Host Name Table Host Name : hostname1.com IP Address : 10.90.90.10 Host Name : hostname2.com IPv6 Address : 3000::3...
Page 390
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin# enable dns_resolver Command: enable dns_resolver Success. DGS-3420-28SC:admin# 28-9 disable dns_resolver Description This command is used to disable the DNS Resolver state of the Switch. Format disable dns_resolver Parameters None.
Page 392
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide state - (Optional) Specifies the DoS Attack Prevention state. enable - Specifies that the DoS Attack Prevention state will be enabled. disable - Specifies that the DoS Attack Prevention state will be disabled. Restrictions Only Administrator, Operator and Power-User level users can issue this command.
Page 393
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#config dos_prevention log enable Command: config dos_prevention log enable Success. DGS-3420-28SC:admin# 29-3 config dos_prevention trap Description This command is used to enable or disable the DoS prevention trap state. Format config dos_prevention trap [enable | disable] Parameters...
Page 394
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters land_attack - (Optional) Specifies that only DoS LAND attack information will be displayed. blat_attack - (Optional) Specifies that only DoS BLAT attack information will be displayed. tcp_null_scan - (Optional) Specifies that only DoS TCP Null Scan attack information will be displayed.
Page 395
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#show dos_prevention land_attack Command: show dos_prevention land_attack DoS Type : Land Attack State : Enabled Action : Drop Frame Counts DGS-3420-28SC:admin# To display DoS prevention information of Blat Attack: DGS-3420-28SC:admin#show dos_prevention blat_attack Command: show dos_prevention blat_attack DoS Type...
Page 397
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To enable unidirectional link detection on port 1: DGS-3420-28SC:admin# config duld ports 1 state enable Commands: config duld ports 1 state enable Success DGS-3420-28SC:admin# 30-2 show duld ports Description This command is used to show unidirectional link detection information.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 31 Energy Efficient Ethernet (EEE) Commands Note: This feature is only available on hardware version B1 and later config eee ports [<portlist> | all] state [enable | disable] show eee ports {<portlist>} 31-1 config eee ports...
Page 400
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 31-2 show eee ports Description This command is used to display the EEE function state on the specified port(s). Format show eee ports {<portlist>} Parameters <portlist> - (Optional) Specify a list of ports to be displayed. Restrictions None.
Page 402
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To enable ERPS: DGS-3420-28SC:admin#enable erps Command: enable erps Success. DGS-3420-28SC:admin# 32-2 disable erps Description This command is used to disable the ERPS function on the switch. Format disable erps Parameters...
Page 403
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 32-3 create erps raps_vlan Description This command is used to create an R-APS VLAN on the switch. There should be only one R-APS VLAN used to transfer R-APS messages. Note that the R-APS VLAN must already have been created by the create vlan command.
Page 404
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To delete an R-APS VLAN: DGS-3420-28SC:admin#delete erps raps_vlan 4094 Command: delete erps raps_vlan 4094 Success. DGS-3420-28SC:admin# 32-5 config erps raps_vlan...
Page 405
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Note that modifying the RPL port and RPL owner may not take effect immediately when the ERPS function is enabled. The ring will run the old configuration’s protocol if the following conditions are not met: 1.
Page 406
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide ring_mel - Specify the ring MEL of the R-APS function. The default ring MEL is 1. <value 0-7> - Specify a value between 0 and 7. ring_port - Specify a port participating in the ERPS ring. west - Specify the port as the west ring port.
Page 407
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To set the R-APS west ring port parameter to 5: DGS-3420-28SC:admin#config erps raps_vlan 4094 ring_port west 5 Command: config erps raps_vlan 4094 ring_port west 5 Success. DGS-3420-28SC:admin# To set the R-APS east ring port parameter to 7: DGS-3420-28SC:admin#config erps raps_vlan 4094 ring_port east 7 Command: config erps raps_vlan 4094 ring_port east 7...
Page 408
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Success. DGS-3420-28SC:admin# 32-6 config erps log Description This command is used to configure the ERPS log state. Format config erps log [enable | disable] Parameters enable - Enable the log state. The default value is disabled. disable - Disable the log state.
Page 409
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide disable - Enter disable to disable the trap state. The default value is disabled. Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To configure the trap state of the ERPS: DGS-3420-28SC:admin# config erps trap enable Command: config erps trap enable Success.
Page 410
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters raps_vlan - Specifies the R-APS VLAN. <vlanid 1-4094> - Enter the R-APS VLAN ID used here. sub_ring - Display the sub-ring configuration information. Restrictions None. Example To display ERPS information: DGS-3420-28SC:admin#show erps Command: show erps Global Status...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 33 External Alarm Commands config external_alarm {unit <unit_id>} channel <value 1-2> message <sentence 1-128> show external_alarm {unit <unitlist>} 33-1 config external_alarm Description This command is used to configure the external alarm message for a channel. The source for the alarm is located on the front panel of the Switch.
Page 412
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#config external_alarm unit 2 channel 1 message External Alarm: UPS is exhausted! Command: config external_alarm unit 2 channel 1 message External Alarm: UPS is exhausted! Success. DGS-3420-28SC:admin# 33-2 show external_alarm Description This command is used to display the status of the external alarm.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin# 34-2 create fdb vlanid Description This command is used to create an entry into the switch’s unicast MAC address forwarding database using the VLAN ID. Format create fdb vlanid <vidlist> <macaddr> [port <port> | drop] Parameters <vidlist>...
Page 415
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters <vlan_name 32> - Specify the name of the VLAN on which the MAC address resides. The maximum length is 32 characters. <macaddr> - Specify the multicast MAC address to be added to the static forwarding table. Addresses in the range “01-80-C2-XX-XX-XX”...
Page 416
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To add multicast MAC forwarding: DGS-3420-28SC:admin# config multicast_fdb default 01-00-00-00-01-01 add 1-5 Command: config multicast_fdb default 01-00-00-00-01-01 add 1-5 Success.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 34-6 config multicast vlan_filtering_mode Description This command is used to configure the multicast packet filtering mode for VLANs. Format config multicast vlan_filtering_mode [vlanid <vidlist> | vlan <vlan_name 32> | all] [forward_all_groups | forward_unregistered_groups | filter_unregistered_groups] Parameters vlanid - Specifies the VLAN ID list to be configured.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format delete fdb <vlan_name 32> <macaddr> Parameters <vlan_name 32> - Specify the name of the VLAN on which the MAC address resides. The maximum length is 32 characters. <macaddr>...
Page 419
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To clear all FDB dynamic entries: DGS-3420-28SC:admin#clear fdb all Command: clear fdb all Success. DGS-3420-28SC:admin# 34-9 show multicast_fdb Description This command is used to display the contents of the static multicast MAC forwarding table. Format show multicast_fdb {[vlan <vlan_name 32>...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Total Entries : 1 DGS-3420-28SC:admin# 34-10 show fdb Description This command is used to display the current unicast MAC address forwarding database. Format show fdb {[port <port> | vlan <vlan_name 32> | vlanid <vidlist> | mac_address <macaddr> | static | aging_time | security]} Parameters port - (Optional) Specify the entries for one port.
Page 421
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide default 00-26-5A-AE-CA-1C 21 Dynamic Forward Total Entries: 2 DGS-3420-28SC:admin# 34-11 show multicast vlan_filtering_mode Description This command is used to display the multicast packet filtering mode configured on the VLAN. Format show multicast vlan_filtering_mode {[vlanid <vidlist>...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 35 File System Management Commands show storage_media_info {[unit <unit_id> | all]} md {{unit <unit_id>} <drive_id>} <pathname> rd {{unit <unit_id>} <drive_id>} <pathname> cd {<pathname>} dir {{unit <unit_id>} <drive_id>} {<pathname>} rename {{unit <unit_id>} <drive_id>} <pathname>...
Page 423
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#show storage_media_info Command: show storage_media_info Unit Drive Media Type Size Label FS Type Version ---- ----- ---------- -------- ----------- ------- ------- Flash 123 MB Ver2.1 DGS-3420-28SC:admin# 35-2 Description This command is used to create a directory.
Page 424
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format rd {{unit <unit_id>} <drive_id>} <pathname> Parameters unit - Specifies the unit ID in the stacking system. If not specified, it refers to the master unit. <unit_id> - Enter the unit ID value here. <drive_id>...
Page 425
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions None. Example To change a work directory: DGS-3420-28SC:admin#cd d1 Command: cd d1 Current work directory: “c:/d1” DGS-3420-28SC:admin# 35-5 Description This command is used to list all of the files located in a directory of a drive. If a path name is not specified, then all of the files in the specified drive will be displayed.
Page 427
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To rename a file or directory: DGS-3420-28SC:admin#rename run.had run1.had Command: rename run.had run1.had Success. DGS-3420-28SC:admin# 35-7 erase Description This command is used to delete a file stored in the file system. The system will prompt if the target file is a bootup image/configuration or the last image.
Page 428
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 35-8 format Description This command is used to format a specific drive. Format format {unit <unit_id>} <drive_id> {[fat16 | fat32]} {<label_name>} Parameters unit - Specifies the unit ID in the stacking system. If not specified, it refers to the master unit. <unit_id>...
Page 429
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide <drive_id> - Specifies the drive ID. If not specified, it refers to the current drive. <pathname> - Specify the file or directory to be deleted. If it is specified in the associated form, then it is related to the current directory.
Page 430
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide <pathname> - Specify the file to be moved. The path name can be specified either as a full path name or partial name. For a partial path name, it indicates the file is in the current directory. unit - Specifies the unit ID in the stacking system.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To copy a file: DGS-3420-28SC:admin#copy c:/log.txt c:/log1.txt Command: copy c:/log.txt c:/log1.txt Copying......Done! DGS-3420-28SC:admin# 35-12 change drive Description This command is used to change the current drive. Format change drive {unit <unit_id>} <drive_id>...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 36 Filter Commands config filter extensive_netbios [<portlist> | all] state [enable | disable] show filter extensive_netbios config filter netbios [<portlist> | all] state [enable | disable] show filter netbios 36-1 config filter extensive_netbios Description...
Page 433
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 36-2 show filter extensive_netbios Description This command is used to display the extensive NetBIOS filter state on the switch. Format show filter extensive_netbios Parameters None. Restrictions None. Example To display the extensive NetBIOS filter state on the switch: DGS-3420-28SC:admin#show filter extensive_netbios Command: show filter extensive_netbios...
Page 434
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To configure the NetBIOS filter state: DGS-3420-28SC:admin#config filter netbios 1-10 state enable Command: config filter netbios 1-10 state enable Success.
Page 436
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 37-2 disable gratuitous_arp Description This command is used to disable the gratuitous ARP trap and log state. Format disable gratuitous_arp {ipif <ipif_name 12>} {trap | log}(1) Parameters ipif - (Optional) The interface name of the L3 interface. <ipif_name 12>...
Page 437
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To enable learning of ARP entries in the ARP cache based on the received gratuitous ARP packets: DGS-3420-28SC:admin# config gratuitous_arp learning enable Command: config gratuitous_arp learning enable Success.
Page 438
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 37-5 config gratuitous_arp send ipif_status_up Description This command is used to enable or disable the sending of gratuitous ARP requests when the IP interface status becomes up. This is used to automatically announce the interface’s IP address to other nodes.
Page 439
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide characters. interval - The periodically send gratuitous ARP interval time, in seconds. <value 0-65535> - Specify the value between 0 and 65535. 0 (zero) means not to send gratuitous ARP request packets periodically.
Page 440
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide IP Interface Name : System Gratuitous ARP Trap : Disabled Gratuitous ARP Log : Enabled Gratuitous ARP Periodical Send Interval : 0 Total Entries: 1 DGS-3420-28SC:admin#...
Page 442
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format disable igmp_proxy Parameters None. Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To disable the IGMP proxy: DGS-3420-28SC:admin#disable igmp_proxy Command: disable igmp_proxy Success.
Page 443
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To configure the IGMP proxy’s downstream interface: DGS-3420-28SC:admin#config igmp_proxy downstream_if add vlan vlanid 2-7 Command: config igmp_proxy downstream_if add vlan vlanid 2-7 Success.
Page 444
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To configure the router port of IGMP proxy’s upstream interface: DGS-3420-28SC:admin#config igmp_proxy upstream_if vlan default router_ports add 3 Command: config igmp_proxy upstream_if vlan default router_ports add 3 Success.
Page 445
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Downstream Interface VLAN List : 2-4 DGS-3420-28SC:admin# To display the IGMP proxy’s group information: DGS-3420-28SC:admin#show igmp_proxy group Command: show igmp_proxy group Dest-V : The destination VLAN. : Active : Inactive Dest IP Source IP...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format config igmp_snooping querier [vlan_name <vlan_name 32> | vlanid <vlanid_list> | all] {query_interval <sec 1-65535> | max_response_time <sec 1-25> | robustness_variable <value 1- 7> | last_member_query_interval <sec 1-25> | state [enable | disable] | version <value 1-3>} (1) Parameters vlan_name - Specify the name of the VLAN for which IGMP snooping querier is to be configured.
Page 449
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To configure the IGMP snooping querier: DGS-3420-28SC:admin#config igmp_snooping querier vlan_name default query_interval 125 state enable Command: config igmp_snooping querier vlan_name default query_interval 125 state enable Success.
Page 450
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin# 39-4 config router_ports_forbidden Description This command is used to designate a range of ports as being not connected to multicast-enabled routers. This ensures that the forbidden router port will not propagate routing packets out. Format config router_ports_forbidden [<vlan_name 32>...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters vlan - Specify the name of the VLAN on which the router port resides. <vlan_name 32> - Specify the VLAN name. The maximum length is 32 characters. vlanid - Specify the ID of the VLAN on which the router port resides.
Page 452
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To enable IGMP snooping on the switch: DGS-3420-28SC:admin#enable igmp_snooping Command: enable igmp_snooping Success. DGS-3420-28SC:admin# 39-7 disable igmp_snooping Description This command is used to disable IGMP snooping on the switch.
Page 453
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 39-8 show igmp_snooping Description This command is used to display the current IGMP snooping configuration on the switch. Format show igmp_snooping {[vlan <vlan_name 32> | vlanid <vlanid_list>]} Parameters vlan - (Optional) Specify the name of the VLAN to display the IGMP snooping configuration.
Page 454
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#show igmp_snooping Command: show igmp_snooping IGMP Snooping Global State : Disabled Data Driven Learning Max Entries : 120 VLAN Name : default Query Interval : 125 Max Response Time : 10 Robustness Value Last Member Query Interval...
Page 455
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide <portlist> - Specify a range of ports to be configured. <ipaddr> - (Optional) Specify the group IP address for which to view IGMP snooping group information. data_driven - (Optional) Specifies that the data driven groups will be included in the display. Note: If no parameter is specified, the system will display all of the current IGMP snooping group configuration of the switch.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 39-10 config igmp_snooping rate_limit Description This command is used to configure the upper limit per second for ingress IGMP control packets. Format config igmp_snooping rate_limit [ports <portlist> | vlanid <vlanid_list>] [<value 1-1000> | no_limit] Parameters ports - Specify a range of ports to be configured.
Page 457
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters ports - Specify a range of ports to be displayed. <portlist> - Specify a range of ports to be displayed. vlanid - Specify a range of VLANs to be displayed. <vlanid_list>...
Page 458
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide vlanid - Specify the VLAN ID list. <vlanid_list> - Specify the VLAN ID list. <ipaddr> - Specify the multicast group IP address. Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To create an IGMP snooping static group on default VLAN, group 239.1.1.1: DGS-3420-28SC:admin#create igmp_snooping static_group vlan default 239.1.1.1...
Page 459
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To add port 9 to 10 to be IGMP snooping static member ports for group 239.1.1.1 on default VLAN: DGS-3420-28SC:admin#config igmp_snooping static_group vlan default 239.1.1.1 add 9- Command: config igmp_snooping static_group vlan default 239.1.1.1 add 9-10 Success.
Page 460
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 39-15 show igmp_snooping static_group Description This command is used to display the IGMP snooping static multicast group. Format show igmp_snooping static_group {[vlan <vlan_name 32> | vlanid <vlanid_list>] <ipaddr>} Parameters vlan - Specify the name of the VLAN on which the router port resides.
Page 461
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters vlan - Specify a VLAN to be displayed. <vlan_name 32> - Specify the VLAN name. The maximum length is 32 characters. vlanid - Specify a list of VLANs to be displayed. <vlanid_list>...
Page 462
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Report & Leave IGMP v1 Report IGMP v2 Report IGMP v3 Report IGMP v2 Leave Total Total Entries : 1 DGS-3420-28SC:admin# 39-17 clear igmp_snooping statistics counter Description This command is used to clear the IGMP snooping statistics counter on the switch. Format clear igmp_snooping statistics counter Parameters...
Page 463
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format show igmp_snooping forwarding {[vlan <vlan_name 32> | vlanid <vlanid_list>]} Parameters vlan - (Optional) Specify a VLAN to be displayed. <vlan_name 32> - Specify the VLAN name. The maximum length is 32 characters. vlanid - (Optional) Specify a list of VLANs to be displayed.
Page 464
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters all - Specifies to clear all the entries learned by the data driven feature. vlan_name - Specifies the VLAN name used. <vlan_name 32> - Enter the VLAN name used here. vlanid - Specifies that VLAN ID list used.
Page 465
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters all - Specifies that all VLANs will be configured. vlan_name - Specifies the VLAN name used. <vlan_name 32> - Enter the VLAN name used here. This name can be up to 32 characters long.
Page 466
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters <value 1-960> - Enter the maximum number of groups that can be learned by data driven feature here. This value must be between 1 and 960. Restrictions Only Administrator, Operator and Power-User level users can issue this command.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 39-23 show igmp_snooping forward_lookup_mode Description The command is used to display the IGMP snooping forward lookup mode on the Switch. Format show igmp_snooping forward_lookup_mode Parameters None. Restrictions None. Example To display the IGMP snooping forward lookup mode: DGS-3420-28SC:admin#show igmp_snooping forward_lookup_mode...
Page 468
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide enable - Enable the RADIUS authentication function on the specified ports. auth_accounting - Specifies that after the client authenticated, accounting messages will be sent to the RADIUS server. This is the default option. auth_only - Specifies that after the client authenticated, accounting messages will not be sent to the RADIUS server.
Page 469
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Port State ----- --------- Auth_accounting Disabled Disabled Disabled DGS-3420-28SC:admin# To display the IGMP Access Control status for all ports: DGS-3420-28SC:admin#show igmp access_authentication ports all Command: show igmp access_authentication ports all Port State -----...
Page 471
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide given a name that can be up to 32 characters. <vlanid 2-4094> - Specify the VLAN ID of the multicast VLAN to be created. The range is from 2 to 4094.
Page 472
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide source_port - Specify source port where the multicast traffic is entering the Switch. <portlist> - Specify a range of ports to be configured. untag_source_port - Specify the untagged source port where the multicast traffic is entering the Switch.
Page 473
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters <profile_name 1-32> - Specifies the multicast VLAN profile name. The maximum length is 32 characters. Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To create an IGMP snooping multicast group profile with the name “Knicks”: DGS-3420-28SC:admin#create igmp_snooping multicast_vlan_group_profile Knicks...
Page 474
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To add the single multicast address 225.1.1.1 and multicast range 225.1.1.10-225.1.1.20 to the IGMP snooping multicast VLAN profile named “Knicks”: DGS-3420-28SC:admin#config igmp_snooping multicast_vlan_group_profile Knicks add 225.1.1.1, 225.1.1.10-225.1.1.20 Command: config igmp_snooping multicast_vlan_group_profile Knicks add 225.1.1.1, 225.1.1.10-225.1.1.20 Success.
Page 475
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 40-6 show igmp_snooping multicast_vlan_group_profile Description This command is used to display an IGMP snooping multicast group profile. Format show igmp_snooping multicast_vlan_group_profile {<profile_name 1-32>} Parameters <profile_name 1-32> - (Optional) Specify the multicast VLAN profile name. The maximum length is 32 characters.
Page 476
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format config igmp_snooping multicast_vlan_group <vlan_name 32> [add | delete] profile_name <profile_name 1-32> Parameters <vlan_name 32> - Specify the name of the multicast VLAN to be configured. Each multicast VLAN is given a name that can be up to 32 characters.
Page 477
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To display all IGMP snooping multicast VLANs’group profile information: DGS-3420-28SC:admin#show igmp_snooping multicast_vlan_group Command: show igmp_snooping multicast_vlan_group VLAN Name VLAN ID Multicast Group Profiles ------------------------------- ------- --------------------------------- test2 test1 DGS-3420-28SC:admin# 40-9...
Page 478
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 40-10 enable igmp_snooping multicast_vlan Description This command is used to enable the IGMP snooping multicast VLAN function. By default, the multicast VLAN is disabled. Format enable igmp_snooping multicast_vlan Parameters None.
Page 479
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To disable IGMP snooping multicast VLAN: DGS-3420-28SC:admin#disable igmp_snooping multicast_vlan Command: disable igmp_snooping multicast_vlan Success. DGS-3420-28SC:admin# 40-12 show igmp_snooping multicast_vlan Description This command allows information for a specific multicast VLAN to be displayed. Format show igmp_snooping multicast_vlan {<vlan_name 32>} Parameters...
Page 480
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#show igmp_snooping multicast_vlan Command: show igmp_snooping multicast_vlan IGMP Multicast VLAN Global State : Disabled IGMP Multicast VLAN Forward Unmatched : Disabled IGMP Multicast VLAN Auto Assign VLAN : Disabled VLAN Name :test :100...
Page 481
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#config igmp_snooping multicast_vlan forward_unmatched enable Command: config igmp_snooping multicast_vlan forward_unmatched enable Success. DGS-3420-28SC:admin# 40-14 config igmp_snooping multicast_vlan auto_assign_vlan Description This command is used to enable or disable the assignment of IGMP control packets to the right ISM VLAN.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To add a default route with a nexthop of 10.48.74.21: DGS-3420-28SC:admin#create iproute default 10.48.74.121 Command: create iproute default 10.48.74.121 Success.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin# 41-3 show iproute Description This command is used to display the Switch’s current IP routing table. Format show iproute {[<network_address> | <ipaddr>]} {[static | rip | hardware]} Parameters <network_address>...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 41-4 create ipv6route Description This command is used to create an IPv6 static route in the Switch’s IP routing table. If the next hop is a global address, it is not necessary to indicate the interface name. If the next hop is a link local address, then the interface name must be specified.
Page 487
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions None. Example To display an IPv6 route: DGS-3420-28SC:admin#show ipv6route Command: show ipv6route IPv6 Prefix: ::/0 Protocol: Static Metric: 1 Next Hop : FEC0::5 IPIF : System Total Entries: 1 DGS-3420-28SC:admin# 41-7 create ipv6route redistribute dst ripng src...
Page 488
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#create ipv6route redistribute dst ripng src local Command: create ipv6route redistribute dst ripng src local Success. DGS-3420-28SC:admin# 41-8 config ipv6route redistribute dst ripng src Description This command is used to configure the metric to be associated with the redistributed routes imported from a specified protocol to RIPng protocol.
Page 489
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format delete ipv6route redistribute dst ripng src [local | static] Parameters local - Specifies not to redistribute local routes into RIPng. static - Specifies not to redistribute static routes into RIPng. Restrictions Only Administrator, Operator and Power-User level users can issue this command.
Page 491
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 42-2 delete ip_tunnel Description This command is used to delete an IP tunnel interface. Format delete ip_tunnel <tunnel_name 12> Parameters <tunnel_name 12> - Enter the IP tunnel interface name used here. This name can be up to 12 characters long.
Page 492
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide ipv6address - (Optional) Specifies the IPv6 address assigned to the IPv6 tunnel interface. IPv6 processing becomes enabled on the IPv6 tunnel interface when an IPv6 address is configured. The IPv6 address is not connected with the tunnel source or the destination IPv4 address.
Page 493
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format config ip_tunnel 6to4 <tunnel_name 12> {ipv6address <ipv6networkaddr> | source <ipaddr>}(1) Parameters <tunnel_name 12> - Enter the IP tunnel interface name used here. This name can be up to 12 characters long.
Page 494
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide systems within a site. An IPv6 ISATAP address is a well-defined unicast address that includes a 64-bit unicast IPv6 prefix (it can be either link-local or global prefixes), a 32-bit value 0000:5EFE and a 32-bit tunnel source IPv4 address.
Page 495
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format show ip_tunnel {<tunnel_name 12>} Parameters <tunnel_name 12> - (Optional) Enter the IP tunnel interface name used here. This name can be up to 12 characters long. Restrictions None.
Page 496
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To enable an IP tunnel interface (Tunnel name is “tn2”): DGS-3420-28SC:admin# enable ip_tunnel tn2 Command: enable ip_tunnel tn2 Success. DGS-3420-28SC:admin# 42-8 disable ip_tunnel Description This command is used to disable a single specified IP tunnel or all IP tunnels on the Switch. Format disable ip_tunnel {<tunnel_name 12>} Parameters...
Page 497
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide GRE tunnel are simple point-to-point tunnels that can be used within a site or between sites. When a user wants to configure a GRE IPv6/IPv4-in-IPv4 tunnel, both the source and destination address must be IPv4 addresses because the delivery protocol is the IPv4 protocol.
Page 499
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide To display the configuration of a GRE tunnel interface named “tn2”: DGS-3420-28SC:admin# show ip_tunnel tn2 Command: show ip_tunnel tn2 Tunnel Interface : tn2 Interface Admin State : Enabled Tunnel Mode : GRE Ipv4 Address...
Page 501
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 43-2 delete ipv6 neighbor_cache ipif Description This command is used to delete a neighbor cache entry or static neighbor cache entries from the address cache or all address cache entries on this IP interface. Both static and dynamic entries can be deleted.
Page 502
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters <ipif_name 12> - Specify the IPv6 interface name. all - Specify all the IPv6 interface names. ipv6address - Specify the IPv6 address of the neighbor. <ipv6addr> - Specify the IPv6 address static - Specify to display the IPv6 static neighbor cache entries.
Page 503
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To configure the NS retransmit time of a specified interface: DGS-3420-28SC:admin#config ipv6 nd ns ipif System retrans_time 400 Command: config ipv6 nd ns ipif System retrans_time 400 Success.
Page 504
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide other_config_flag - Specify to enable or disable the function. enable - When set to enable, it indicates that hosts receiving this RA must use a stateful address configuration protocol to obtain on-address configuration information. disable - Set to disable to stop hosts receiving this RA from using a stateful address configuration protocol to obtain on-address configuration information.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide <sec 0-4294967295> - Specify the time between 0 and 4294967295 seconds. For an infinite valid lifetime the value can be set to 4294967295. on_link_flag - Specify to enable or disable the function. enable - Setting this field to enable will denote, within the IPv6 packet, that the IPv6 prefix configured here is assigned to this link-local network.
Page 506
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions None. Example To display IPv6 Neighbor Discover related configuration: DGS-3420-28SC:admin#show ipv6 nd ipif System Command: show ipv6 nd ipif System Interface Name : System Hop Limit : 64 NS Retransmit Time : 400 (ms) Router Advertisement...
Page 508
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 44-1 create address_binding ip_mac ipaddress Description This command is used to create an IP-MAC-Port binding entry. Format create address_binding ip_mac ipaddress <ipaddr> mac_address <macaddr> {ports[<portlist>| all ]} Parameters <ipaddr>...
Page 509
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters <ipv6addr> - Specify the IPv6 address. mac_address - Specify the MAC address. <macaddr> - Enter the MAC address here. ports - (Optional) Configure the portlist or all ports. <portlist>...
Page 510
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters <portlist> - Specify a range of ports to configure. all - Specify to configure all ports. arp_inspection - (Optional) Specifies that when the ARP inspection function is enabled, the legal ARP packets wil be forwarded, while the illegal packets will be dropped.
Page 511
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 44-4 config address_binding ip_mac ipaddress Description This command is used to update an address binding entry. Format config address_binding ip_mac ipaddress <ipaddr> mac_address <macaddr> {ports [<portlist>| all ]} Parameters <ipaddr>...
Page 512
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters ipv6address - Specifies the IPv6 address used. <ipv6addr> - Enter the IPv6 address used here. mac_address - Specify the MAC address. <macaddr> - Enter the MAC address here. ports - (Optional) Configure the portlist to apply, if ports are not configured, then it will apply to all ports.
Page 513
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To delete the blocked MAC address 00-00-00-00-00-11, which belongs to the VLAN named “v31”: DGS-3420-28SC:admin# delete address_binding blocked vlan_name v31 mac_address 00- 00-00-00-00-11 Command: delete address_binding blocked vlan_name v31 mac_address 00-00-00-00-00-11 Success.
Page 514
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Success. DGS-3420-28SC:admin# To delete a static ipv6 IMPB entry that binds the IPv6 address fe80::240:5ff:fe00:28 to the MAC address 00-00-00-00-00-11: DGS-3420-28SC:admin# delete address_binding ip_mac ipv6address fe80::240:5ff:fe00:28 mac_address 00-00-00-00-00-11 Command: delete address_binding ip_mac ipv6address fe80::240:5ff:fe00:28 mac_address 00-00-00-00-00-11 Success.
Page 515
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Save Filename : dhcpsnp.cfg Function Version : 3.95 DGS-3420-28SC:admin# To display address binding information for ports 1 to 10: DGS-3420-28SC:admin#show address_binding ports 1-10 Command: show address_binding ports 1-10 ARP:ARP Inspection IP:IP Inspection ND:ND Inspection...
Page 516
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions None. Example To show the IMPB entries that are currently blocked: DGS-3420-28SC:admin#show address_binding blocked all Command: show address_binding blocked all VLAN Name MAC Address Port ---- -------------------------------- ----------------- ---- default 00-01-02-03-29-38 default...
Page 517
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide <ipaddr> - Enter the IP address here. ipv6address - Specify the IPv6 address. <ipv6addr> - Enter the IPv6 address here. mac_address – (Optional) Specify the MAC address. <macaddr> - Enter the MAC address here. mac_address - Specify the MAC address.
Page 518
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 44-11 enable address_binding trap_log Description This command is used to send trap and log messages when an address binding module detects illegal IP and MAC addresses. Format enable address_binding trap_log Parameters None.
Page 519
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To disable the address binding trap and log: DGS-3420-28SC:admin#disable address_binding trap_log Command: disable address_binding trap_log Success. DGS-3420-28SC:admin# 44-13 enable address_binding dhcp_snoop Description This command is used to enable the address binding DHCP snooping mode. By default, DHCP snooping is disabled.
Page 520
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To enable the address binding DHCP snooping mode: DGS-3420-28SC:admin#enable address_binding dhcp_snoop Command: enable address_binding dhcp_snoop Success.
Page 521
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 44-15 clear address_binding dhcp_snoop binding_entry ports Description This command is used to clear the address binding entries learned for the specified ports. Format clear address_binding dhcp_snoop binding_entry ports [<portlist> | all] {[ipv6 | all]} Parameters <portlist>...
Page 522
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions None. Example To display address binding DHCP snooping: DGS-3420-28SC:admin#show address_binding dhcp_snoop Command: show address_binding dhcp_snoop DHCP Snoop(IPv4) : Disabled DHCP Snoop(IPv6) : Disabled DGS-3420-28SC:admin# To display the address binding DHCP snooping maximum entries on port 1 to 10: DGS-3420-28SC:admin#show address_binding dhcp_snoop max_entry ports 1-10 Command: show address_binding dhcp_snoop max_entry ports 1-10 Port...
Page 523
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide <port> - Enter the port number here. Restrictions None. Example To display the DHCP snooping binding entries: DGS-3420-28SC:admin#show address_binding dhcp_snoop binding_entry Command: show address_binding dhcp_snoop binding_entry S (Status) - A: Active, I: Inactive Time - Left Time (sec) IP Address MAC Address...
Page 524
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide no_limit - Specify an unlimited number of entries. ipv6 – (Optional) Specifies that the configuration is for IPv6 DHCP Snooping. Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To set the maximum number of entries that ports 1 to 3 can learn to 10: DGS-3420-28SC:admin#config address_binding dhcp_snoop max_entry ports 1-3 limit...
Page 525
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 44-20 enable address_binding nd_snoop Description This command is used to enable ND snooping on the Switch. Format enable address_binding nd_snoop Parameters None. Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To enable the ND snooping function on the Switch: DGS-3420-28SC:admin# enable address_binding nd_snoop...
Page 526
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To disable the DHCPv6 snooping function on the Switch: DGS-3420-28SC:admin# disable address_binding nd_snoop Command: disable address_binding nd_snoop Success. DGS-3420-28SC:admin# 44-22 config address_binding nd_snoop ports Description This command is used to specify the maximum number of entries that can be learned with ND snooping.
Page 527
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 44-23 show address_binding nd_snoop Description This command is used to display the status of ND snooping on the Switch. Format show address_binding nd_snoop {ports <portlist>} Parameters ports – (Optional) Specifies the list of ports used for this display. <portlist>...
Page 528
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 44-24 show address_binding nd_snoop binding_entry Description This command is used to show the ND snooping binding entries on the Switch. Format show address_binding nd_snoop binding_entry {port <port>} Parameters port - (Optional) Specifies a port used for this display.
Page 529
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters ports - Specify the list of ports that you would like to clear the ND snoop learned entry. <portlist> - Enter the list of port used here. all - Clear all ND snooping learned entries.
Page 530
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#config address_binding dhcp_snoop_entry file save_dhcp.cfg autosave enable Command: config address_binding dhcp_snoop_entry filename save_dhcp.cfg autosave enable Success. DGS-3420-28SC:admin# 44-27 enable address_binding roaming Description This command is used to enable IMPB roaming. When IMPB roaming is enabled, the dynamic authenticated MAC address which learned through DHCP/ND snooping on specific port can change to another port if it detects (1) a new DHCP process belong to same IP and MAC address or (2) a new DAD process belong to same IP and MAC.
Page 531
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Note: For an inactive entry, whether the roaming state is enabled or not, it detects whether a new ARP or IP packet belongs to the same IP address from other ports. The inactive entry will change the port and set state to active.
Page 532
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To download the DHCP snooping binding table: DGS-3420-28SC:admin#download address_binding snoop_entry_fromTFTP 10.90.90.6 filename impb.cfg Command: download address_binding snoop_entry_fromTFTP 10.90.90.6 filename impb.cfg Connecting to server....
Page 533
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Upload DHCP Snooping Entry....Done. DGS-3420-28SC:admin# 44-31 save dhcp_snoop_entry Description This command is used to save the DHCPv4 Snooping binding entries. Format save dhcp_snoop_entry Parameters None. Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To backup the binding entries: DGS-3420-28SC:admin#save dhcp_snoop_entry...
Page 535
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 45-1 enable jwac Description This command is used to enable the Japanese Web-based access control (JWAC) function. JWAC and WAC are mutually exclusive functions. That is, they can not be enabled at the same time. Using the JWAC function, PC users need to pass two stages of authentication.
Page 536
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To disable JWAC: DGS-3420-28SC:admin#disable jwac Command: disable jwac Success. DGS-3420-28SC:admin# 45-3 enable jwac redirect Description This command is used to enable JWAC redirect.
Page 537
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 45-4 disable jwac redirect Description This command is used to disable JWAC redirect. When redirect is disabled, only access to quarantine_server and the jwac_login_page from an unauthenticated host is allowed, all other Web access will be denied.
Page 538
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To enable JWAC forcible logout: DGS-3420-28SC:admin#enable jwac forcible_logout Command: enable jwac forcible_logout Success. DGS-3420-28SC:admin# 45-6 disable jwac forcible_logout Description This command is used to disable JWAC forcible logout.
Page 539
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 45-7 enable jwac udp_filtering Description This command is used to enable the JWAC UDP filtering function. When UDP filtering is enabled, all UDP and ICMP packets except DHCP and DNS packets from unauthenticated hosts will be dropped. A Ping packet will pass thought when the JWAC authenticating time is between 0 and 30.
Page 540
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To disable JWAC UDP filtering: DGS-3420-28SC:admin#disable jwac udp_filtering Command: disable jwac udp_filtering Success. DGS-3420-28SC:admin# 45-9 enable jwac quarantine_server_monitor Description This command is used to enable the JWAC quarantine server monitor. When enabled, the JWAC switch will monitor the quarantine server to ensure the server is okay.
Page 541
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format disable jwac quarantine_server_monitor Parameters None. Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To disable JWAC quarantine server monitoring: DGS-3420-28SC:admin#disable jwac quarantine_server_monitor Command: disable jwac quarantine_server_monitor Success.
Page 542
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#config jwac quarantine_server_error_timeout 60 Command: config jwac quarantine_server_error_timeout 60 Success. DGS-3420-28SC:admin# 45-12 config jwac Description This command is used to configure the quarantine server URL. If the redirection is enabled and the redirection destination is a quarantine server, when a HTTP request from an unauthenticated host which is not headed to a quarantine server reaches the Switch, the Switch will handle this HTTP packet and send back a message to the host to make it access the quarantine server with the...
Page 543
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 45-13 config jwac redirect Description This command is used to configure redirect destination and delay time before an unauthenticated host is redirected to the quarantine server or the JWAC login web page. The unit of delay time is seconds. 0 means no delaying the redirect.
Page 544
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters <ipaddr> - Specify the IP address of the virtual IP. url - (Optional) Specify the URL of the virtual IP. <string 128> - Specify the URL of the virtual IP. clear - Clear the URL of the virtual IP.
Page 545
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide <port_number 1-65535> - Specify a TCP port value between 1 and 65535. udp_port - (Optional) Specify a UDP port number between 1 and 65535. <port_number 1-65535> - Specify a UDP port value between 1 and 65535. Restrictions Only Administrator, Operator and Power-User level users can issue this command.
Page 546
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#config jwac switch_http_port 8888 http Command: config jwac switch_http_port 8888 http Success. DGS-3420-28SC:admin# 45-17 config jwac ports Description This command is used to configure port state of JWAC. Format config jwac ports [<portlist>...
Page 547
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#config jwac ports 1-9 state enable Command: config jwac ports 1-9 state enable Success. DGS-3420-28SC:admin# 45-18 config jwac radius_protocol Description This command is used to specify the RADIUS protocol used by JWAC to complete RADIUS authentication.
Page 548
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format create jwac user <username 15> {vlan <vlanid 1-4094>} Parameters <username 15> - Specify the user name to be created. vlan - (Optional) Specify the target VLAN ID for the authenticated host which uses this user account to pass authentication.
Page 549
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To configure a JWAC user: DGS-3420-28SC:admin#config jwac user 112233 Command: config jwac user 112233 Enter a old password:*** Enter a case-sensitive new password:*** Enter the new password again for confirmation:*** Success.
Page 550
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 45-22 show jwac user Description This command is used to display JWAC users in the local database. Format show jwac user Parameters None. Restrictions None. Example To display the current JWAC local users: DGS-3420-28SC:admin#show jwac user Command: show jwac user Current Accounts:...
Page 551
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters None. Restrictions None. Example To display the current JWAC configuration: DGS-3420-28SC:admin#show jwac Command: show jwac State : Disabled Enabled Ports Virtual IP/URL : 0.0.0.0/- Switch HTTP Port : 80 (HTTP) UDP Filtering : Enabled...
Page 552
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Note: If no port is specified, the JWAC authentication state will be displayed for all ports. Restrictions None. Example To display JWAC authentication entries for ports 1 to 2: DGS-3420-28SC:admin#show jwac auth_state ports 1-2 Command: show jwac auth_state ports 1-2 Pri:Priority.
Page 553
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To display the JWAC update server: DGS-3420-28SC:admin#show jwac update_server Command: show jwac update_server Index TCP/UDP Port State ----- ------------------ ------ ---- ------- 172.18.0.0/21 Active 172.18.0.0/21 Active 172.18.0.0/21 Active DGS-3420-28SC:admin# 45-26 show jwac ports...
Page 554
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 45-27 clear jwac auth_state Description This command is used to clear authentication entries. Format clear jwac auth_state [ports [all | <portlist>] {authenticated | authenticating | blocked} | mac_addr <macaddr>] Parameters ports - Specify the port range to delete hosts on.
Page 555
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters japanese - Specify to change to the Japanese page. english - Specify to change to the English page. This is the default page. Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To customize the authenticate page: DGS-3420-28SC:admin#config jwac authenticate_page japanese...
Page 556
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Login Window Title : Authentication Login User Name Title : User Name Password Title : Password Logout Window Title : Logout from the network Notification Japanese Page Element ----------------------------------------------------------- Page Title : 社内...
Page 557
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide <desc 128> - Specify a notification line description up to 128 characters long. Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To customize the authenticate page: DGS-3420-28SC:admin# config jwac authentication_page element japanese page_title ディーリンクジャパン株式会社...
Page 558
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 45-31 config jwac authorization attributes Description This command is used to enable or disable acceptation of authorized configuration. When the authorization is enabled for JWAC’s RADIUS, the authorized data assigned by the RADUIS server will be accepted if the global authorization network is enabled.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 46 Jumbo Frame Commands enable jumbo_frame disable jumbo_frame config jumbo_frame ports [<portlist> | all] state [enable | disable] show jumbo_frame {<portlist>} 46-1 enable jumbo_frame Description This command is used to enable support of Jumbo Frames. Format enable jumbo_frame Parameters...
Page 560
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters None. Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To disable Jumbo Frames: DGS-3420-28SC:admin#disable jumbo_frame Command: disable jumbo_frame Success. DGS-3420-28SC:admin# 46-3 config jumbo_frame ports Description This command is used to configure the jumbo frame state on specified ports.
Page 561
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Success. DGS-3420-28SC:admin# 46-4 show jumbo_frame Description This command is used to display Jumbo Frames. Format show jumbo_frame {<portlist>} Parameters <portlist> - (Optional) Enter the list of ports to be displayed here. Restrictions None.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 47 LACP Configuration Commands config lacp_port <portlist> mode [active | passive] show lacp_port {<portlist>} 47-1 config lacp_port Description This command is used to configure per-port LACP mode. Format config lacp_port <portlist>...
Page 563
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format show lacp_port {<portlist>} Parameters <portlist> - (Optional) Specify a range of ports to be displayed. Note: If no parameter is specified, the system will display current LACP mode for all ports. Restrictions None.
Page 565
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 01-00-0C-CC-CC-CC - Specify to use this protocol MAC address. 01-00-0C-CC-CC-CD - Specify to use this protocol MAC address. all - Specify to use all the MAC addresses. threshold - (Optional) Specify the drop threshold for packets-per-second accepted on this UNI port. The port drops the PDU if the protocol’s threshold is exceeded.
Page 566
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin# show l2protocol_tunnel Command: show l2protocol_tunnel Global State: Enabled UNI Ports: 1-2 NNI Ports: 3-4 DGS-3420-28SC:admin# To show Layer 2 protocol tunneling detail information on UNI ports: DGS-3420-28SC:admin# show l2protocol_tunnel uni Command: show l2protocol_tunnel uni Tunneled Threshold...
Page 567
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 48-3 enable l2protocol_tunnel Description Used to enable the Layer 2 protocol tunneling function. Format enable l2protocol_tunnel Parameters None. Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To enable the Layer 2 protocol tunneling function: DGS-3420-28SC:admin# enable l2protocol_tunnel...
Page 568
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To disable the Layer 2 protocol tunneling function: DGS-3420-28SC:admin# disable l2protocol_tunnel Command: disable l2protocol_tunnel Success. DGS-3420-28SC:admin#...
Page 570
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To create a multicast address profile named MOD: DGS-3420-28SC:admin#create mcast_filter_profile profile_id 2 profile_name MOD Command: create mcast_filter_profile profile_id 2 profile_name MOD Success. DGS-3420-28SC:admin# 49-2 config mcast_filter_profile Description This command is used to modify the profile name, add or delete a range of previously defined multicast IP addresses to or from the profile.
Page 571
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin# 49-3 config mcast_filter_profile ipv6 Description This command is used to add or delete a range of previously defined IPv6 multicast IP addresses to or from the profile. Format config mcast_filter_profile ipv6 [profile_id <value 1-60>...
Page 572
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format delete mcast_filter_profile {[ipv4 | ipv6]} [profile_id [<value 1-60> | all] | profile_name <name 32>] Parameters ipv4 – (Optional) Specify to delete an IPv4 multicast profile. ipv6 – (Optional) Specify to delete an IPv6 multicast profile. profile_id - Specify the ID of the profile.
Page 573
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format show mcast_filter_profile {[ipv4 | ipv6]} {[profile_id <value 1-60> | profile_name <name 32>]} Parameters ipv4 - (Optional) Specify to display an IPv4 multicast profile. ipv6 - (Optional) Specify to display an IPv6 multicast profile. profile_id - (Optional) Specify the ID of the profile.
Page 574
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters ports - Specify a range of ports to configure the multicast address filtering function. <portlist> - Specify a range of ports to be configured. vlanid - Specify the VLAN ID of the VLAN that the multicast address filtering function will be configured on.
Page 575
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format show limited_multicast_addr [ ports <portlist> | vlanid <vlanid_list>] {[ipv4 | ipv6]} Parameters ports - Specify a range of ports to show the limited multicast address configuration. <portlist> - Specify a range of ports to be displayed. vlanid - Specify the VLAN ID of VLANs that require information displaying about the multicast address filtering function.
Page 576
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Profile ID Name Multicast Addresses ----------- ---------------- ----------------------------- customer 224.19.62.34 – 224.19.162.200 DGS-3420-28SC:admin# 49-8 config max_mcast_group Description This command is used to configure the maximum number of multicast groups a port or VLAN can join. If the IPv4 or IPv6 option is not specified, IPv4 is implied.
Page 577
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin# config max_mcast_group ports 1, 3 max_group 100 Command: config max_mcast_group ports 1, 3 max_group 100 Success. DGS-3420-28SC:admin# 49-9 show max_mcast_group Description This command is used to display the maximum number of multicast groups that a port or VLAN can join.
Page 579
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 50-2 delete link_aggregation group_id Description This command is used to delete a previously configured link aggregation group. Format delete link_aggregation group_id <value 1-32> Parameters <value 1-32> - Specify the group ID. The group number identifies each of the groups. The switch allows up to 32 link aggregation groups to be configured.
Page 580
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide <port> - Specify the master port ID. ports - Specify a range of ports that will belong to the link aggregation group. The port list should include the master port. <portlist>...
Page 581
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters mac_source - Indicates that the switch should examine the MAC source address. mac_destination - Indicates that the switch should examine the MAC destination address. mac_source_dest - Indicates that the switch should examine the MAC source and destination address.
Page 582
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To display the current link aggregation configuration when link aggregation is enabled: DGS-3420-28SC:admin#show link_aggregation Command: show link_aggregation Link Aggregation Algorithm = MAC_Source_Dest Group ID Type : LACP Master Port Member Port : 1-8...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters None. Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To enable LLDP: DGS-3420-28SC:admin#enable lldp Command: enable lldp Success. DGS-3420-28SC:admin# 51-2 disable lldp Description This command is used to disable LLDP.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 51-3 config lldp Description This command is used to configure LLDP timer values. The message TX interval controls how often active ports retransmit advertisements to their neighbors. The message TX hold multiplier is a multiplier on the msgTxInterval that is used to compute the TTL value of txTTL in an LLDPDU.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#config lldp message_tx_hold_multiplier 3 Command: config lldp message_tx_hold_multiplier 3 Success. DGS-3420-28SC:admin# To configure the delay-interval interval: DGS-3420-28SC:admin#config lldp tx_delay 8 Command: config lldp tx_delay 8 Success. DGS-3420-28SC:admin# To change the re-initialization delay interval to five seconds: DGS-3420-28SC:admin#config lldp reinit_delay 5 Command: config lldp reinit_delay 5 Success.
Page 587
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Command: show lldp LLDP System Information Chassis ID Subtype : MAC Address Chassis ID : 00-11-22-33-44-55 System Name System Description : Gigabit Ethernet Switch System Capabilities : Repeater, Bridge LLDP Configurations LLDP Status : Disabled...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Success. DGS-3420-28SC:admin# 51-6 config lldp notification_interval Description This command is used to configure LLDP timer values. This will globally change the interval between successive LLDP change notifications generated by the switch. Format config lldp notification_interval <sec 5-3600>...
Page 589
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide specified. The management addresses that are added in the list will be advertised in the LLDP from the specified interface, associated with each management address. The interface for that management address will be also advertised in the if-index form.
Page 590
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide admin_status - Select the desired administrative per port state. The default per port state is tx_and_rx. tx_only - Configure the specified port(s) to transmit LLDP packets, but block inbound LLDP packets from neighbor devices.
Page 591
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide all - (Optional) Specify that all VLAN names will be transmitted. <vlan_name 32> - (Optional) Specify a VLAN name to be transmitted. vlanid - (Optional) Specify a VLAN ID list to be transmitted. <vidlist>...
Page 592
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To change the SNMP notification state of ports 1 to 5 to enable: DGS-3420-28SC:admin#config lldp ports 1-5 notification enable Command: config lldp ports 1-5 notification enable Success. DGS-3420-28SC:admin# To configure the mode of ports 1 to 5 to transmit and receive: DGS-3420-28SC:admin#config lldp ports 1-5 admin_status tx_and_rx...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#config lldp ports all dot1_tlv_protocol_vid vlanid 1-3 enable Command: config lldp ports all dot1_tlv_protocol_vid vlanid 1-3 enable Success. DGS-3420-28SC:admin# To exclude the VLAN name TLV from the outbound LLDP advertisements for all ports: DGS-3420-28SC:admin#config lldp ports all dot1_tlv_vlan_name vlanid 1-3 enable Command: config lldp ports all dot1_tlv_vlan_name vlanid 1-3 enable Success.
Page 594
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters <portlist> - (Optional) Specify the ports to be displayed. Note: When a port list is not specified, information for all ports will be displayed. Restrictions None. Example To display LLDP TLV option port 1: DGS-3420-28SC:admin#show lldp ports 1 Command: show lldp ports 1...
Page 595
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide application layer shall start the fast start mechanism and set the ‘medFastStart’ timer to ‘medFastStartRepeatCount’ times 1. The default value is 4. Format config lldp_med fast_start repeat_count <value 1-10> Parameters <value 1-10>...
Page 596
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#config lldp_med log state enable Command: config lldp_med log state enable Success. DGS-3420-28SC:admin# 51-11 config lldp_med notification topo_change ports Description This command is used to enable or disable each port for sending topology change notification to configured SNMP trap receiver(s) if an endpoint device is removed or moved to another port.
Page 597
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format config lldp_med ports [<portlist> | all] med_transmit_capabilities [all | {capabilities | network_policy | power_pse | inventory}(1)] state [enable | disable] Parameters <portlist> - Specify a range of ports to be configured. all - Specify to set all ports in the system.
Page 598
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters <portlist> - Specify a range of ports to be displayed. Note: When a port list is not specified, information for all ports will be displayed. Restrictions None. Example To display LLDP-MED configuration information for port 1: DGS-3420-28SC:admin#show lldp_med ports 1...
Page 599
: B1 Firmware Revision : 1.00.003 Software Revision : 1.50.010 Serial Number : D1234567890 Manufacturer Name : D-Link Model Name : DGS-3420-28SC Gigabit Ethernet S Asset ID PoE Device Type : PSE Device PoE PSE Power Source : Primary LLDP-MED Configuration:...
Page 600
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To display LLDP-MED information currently available for populating outbound LLDP-MED advertisements for port 1: DGS-3420-28SC:admin#show lldp_med local_ports Command: show lldp_med local_ports 1 Port ID ----------------------------------------------------------------- LLDP-MED Capabilities Support: Capabilities :Support Network Policy...
Page 601
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To display remote entry information: DGS-3420-28SC:admin#show lldp_med remote_ports 1 Command: show lldp_med remote_ports 1 Port ID : 1 ---------------------------------------------------------------------------- Remote Entities Count : 1 Entity 1 Chassis ID Subtype : MAC Address Chassis ID : 00-01-02-03-04-00...
Page 602
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Extended Power Via MDI Power Device Type: PD Device Power Priority : High Power Source : From PSE Power Request : 8 Watts Inventory Management: Hardware Revision Firmware Revision Software Revision Serial Number Manufacturer Name...
Page 603
Port ID : 1 ----------------------------------------------------------------------------- Port ID Subtype : MAC Address Port ID : 00-01-02-03-05-00 Port Description : D-Link DGS-3420-28SC R1.50.010 Port 1 on Unit 1 Port PVID Management Address Count PPVID Entries Count VLAN Name Entries Count Protocol Identity Entries Count...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide IF Type : Unknown : 1.3.6.1.4.1.171.10.114.1.1 Advertising Ports Total Entries : 1 DGS-3420-28SC:admin# 51-19 show lldp remote_ ports Description This command is used to display the information learned from the neighbor parameters. Format show lldp remote_ports {<portlist>} {mode [brief | normal | detailed]} Parameters...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format show lldp statistics Parameters None. Restrictions None. Example To display LLDP statistics: DGS-3420-28SC:admin#show lldp statistics Command: show lldp statistics Last Change Time : 3648 Number of Table Insert : 0 Number of Table Delete : 0 Number of Table Drop Number of Table Ageout : 0...
Page 606
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To display LLDP statistic information for port 1: DGS-3420-28SC:admin#show lldp statistics ports 1 Command: show lldp statistics ports 1 Port ID : 1 --------------------------------------------- LLDPStatsTXPortFramesTotal LLDPStatsRXPortFramesDiscardTotal LLDPStatsRXPortFramesErrors LLDPStatsRXPortFramesTotal LLDPStatsRXPortTLVsDiscardedTotal LLDPStatsRXPortTLVsUnrecognizedTotal : 0...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To set a recover time of 0 and an interval of 20 in VLAN-based mode: DGS-3420-28SC:admin#config loopdetect recover_timer 0 interval 20 mode vlan-based Command: config loopdetect recover_timer 0 interval 20 mode vlan-based Success.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format config loopdetect vlan [<vid_list> | all] state [enable | disable] Parameters <vid_list> - Enter the VLAN ID, used for this configuration, here. all - Specifies that all VLANs will be used for this configuration. state - Specifies whether the LBD function should be enabled or disabled on the VLANs specified in the VLAN ID list.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To enable loop detection: DGS-3420-28SC:admin#enable loopdetect Command: enable loopdetect Success. DGS-3420-28SC:admin# 52-5 disable loopdetect Description This command allows the loop detection function to be globally disabled on the switch. The default value is disabled.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format show loopdetect Parameters None. Restrictions None. Example To display the switch’s current loop detection configuration: DGS-3420-28SC:admin#show loopdetect Command: show loopdetect LBD Global Settings --------------------------- Status : Disabled Mode : Port-based Interval...
Page 612
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions None. Example To display the loop detection state of ports 1 to 9 in port-based mode: DGS-3420-28SC:admin#show loopdetect ports 1-9 Command: show loopdetect ports 1-9 Port Loopdetect State Loop Status ------ ------------------ ---------- Enabled...
Page 613
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format config loopdetect trap [none | loop_detected | loop_cleared | both] Parameters none - Trap will not be sent for both cases. loop_detected - Trap is sent when the loop condition is detected loop_cleared - Trap is sent when the loop condition is cleared.
Page 614
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To enable the log state for LBD: DGS-3420-28SC:admin# config loopdetect log state enable Command: config loopdetect log state enable Success. DGS-3420-28SC:admin#...
Page 616
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 53-2 config loopback ipif Description This command is used to configure the loopback interface parameters. Format config loopback ipif <ipif_name 12> [{ipaddress <network_address> | state [enable | disable]}(1)] Parameters <ipif_name 12>...
Page 617
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters <ipif_name 12> - (Optional) Enter the IP interface name used for this configuration here. This name can be up to 12 characters long. Restrictions None. Example To show the information of the loopback interface named loopback1: DGS-3420-28SC:admin# show loopback ipif loopback1 Command: show loopback ipif loopback1 Loopback Interface...
Page 620
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format disable mac_notification Parameters None. Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To disable the MAC notification function: DGS-3420-28SC:admin#disable mac_notification Command: disable mac_notification Success.
Page 621
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#config mac_notification interval 1 historysize 500 Command: config mac_notification interval 1 historysize 500 Success. DGS-3420-28SC:admin# 54-4 config mac_notification ports Description This command is used to configure the port’s MAC address table notification status settings. Format config mac_notification ports [<portlist>...
Page 622
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters None. Restrictions None. Example To show the switch’s MAC address table notification global settings: DGS-3420-28SC:admin#show mac_notification Command: show mac_notification Global MAC Notification Settings State : Enabled Interval History Size : 500 DGS-3420-28SC:admin# 54-6...
Page 623
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#show mac_notification ports Command: show mac_notification ports Port MAC Address Table Notification State ------ ------------------------------------ Disabled Disabled Disabled Disabled Disabled Disabled Disabled Disabled Disabled 1:10 Disabled 1:11 Disabled 1:12 Disabled 1:13...
Page 625
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To enable MAC-based access control: DGS-3420-28SC:admin#enable mac_based_access_control Command: enable mac_based_access_control Success. DGS-3420-28SC:admin# 55-2 disable mac_based_access_control Description This command is used to disable the MAC-based access control function.
Page 626
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format config mac_based_access_control password <passwd 16> Parameters <passwd 16> - In RADIUS mode, the switch communicates with the RADIUS server using this password. The maximum length of the key is 16 characters. Restrictions Only Administrator, Operator and Power-User level users can issue this command.
Page 627
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Command: config mac_based_access_control method local Success. DGS-3420-28SC:admin# 55-5 config mac_based_access_control guest_vlan ports Description This command is used to put the specified port in guest VLAN mode. For those ports not contained in the port list, they are in non-guest VLAN mode.For detailed information about the operation of guest VLAN mode, please see the description for configuring the MAC-based access control port command.
Page 628
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide When the MAC-based access control function is enabled for a port, and the port is a MAC-based access control guest VLAN member, the port(s) will be removed from the original VLAN(s) member ports, and added to MAC-based access control guest VLAN member ports.
Page 629
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 55-7 create mac_based_access_control Description This command is used to create a MAC-based access control guest VLAN. Format create mac_based_access_control [guest_vlan <vlan_name 32> | guest_vlanid <vlanid 1-4094>] Parameters guest_vlan - Specify the name of the guest VLAN. <vlan_name 32>...
Page 630
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide guest_vlanid - Specify the VLAN ID of the guest VLAN. <vlanid 1-4094> - Specify the VLAN ID of the guest VLAN. The guest VLAN ID must be between 1 and 4094.
Page 631
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Success. DGS-3420-28SC:admin# 55-10 create mac_based_access_control_local mac Description This command is used to create a database entry. Format create mac_based_access_control_local mac <macaddr> {[vlan <vlan_name 32> | vlanid <vlanid 1-4094>]} Parameters <macaddr>...
Page 632
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters <macaddr> - Specify the MAC address that access is accepted by local mode. vlan - If the MAC address is authorized, the port will be assigned to this VLAN. <vlan_name 32>...
Page 633
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#config mac_based_access_control max_users 2 Command: config mac_based_access_control max_users 2 Success. DGS-3420-28SC:admin# 55-13 config mac_based_access_control authorization attributes Description This command is used to enable or disable the acceptance of an authorized configuration. When authorization is enabled for MAC-based access controls with RADIUS authentication, the authorized attributes (for example VLAN, 802.1p default priority, and ACL) assigned by the RADUIS server will be accepted if the global authorization status is enabled.
Page 634
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Success. DGS-3420-28SC:admin# 55-14 delete mac_based_access_control_local Description This command is used to delete a database entry Format delete mac_based_access_control_local [mac <macaddr> | vlan <vlan_name 32> | vlanid <vlanid 1-4094>] Parameters mac - Delete database by this MAC address.
Page 635
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 55-15 show mac_based_access_control auth_state ports Description This command is used to display MAC-based access control authentication MAC information. Format show mac_based_access_control auth_state ports {<portlist>} Parameters <portlist> - (Optional) Specify the ports to display. Restrictions None.
Page 636
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters ports - (Optional) Specify to display the MAC-based access control port state. <portlist> - Specify a range of ports to be displayed. Restrictions None. Example To display MAC-based access control information: DGS-3420-28SC:admin#show mac_based_access_control Command: show mac_based_access_control MAC-based Access Control...
Page 637
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin# 55-17 show mac_based_access_control_local Description This command is used to display MAC-based access control local data. Format show mac_based_access_control_local {[mac <macaddr> | vlan <vlan_name 32> | vlanid <vlanid 1-4094>]} Parameters mac - (Optional) Display MAC-based access control local databases by this MAC address.
Page 638
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Total Entries:1 DGS-3420-28SC:admin# To display MAC-based access control local data by VLAN: DGS-3420-28SC:admin#show mac_based_access_control_local vlan default Command: show mac_based_access_control_local vlan default MAC Address ----------------- ------ 00-00-00-00-00-01 Total Entries: 1 DGS-3420-28SC:admin# 55-18 config mac_based_access_control log state Description...
Page 639
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 55-19 config mac_based_access_control trap state Description This command is used to enable or disable the sending of MAC-based Access Control traps. Format config mac_based_access_control trap state [enable | disable] Parameters state - Specifies the trap state for MAC-based Access Control.
Page 640
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide authentication mac_format”. Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To configure the MAC-based Access Control using client’s MAC address as authentication password: DGS-3420-28SC:admin# config mac_based_access_control password_type client_mac_address Command: config mac_based_access_control password_type client_mac_address...
Page 642
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 56-2 config mirror port Description This command is used to allow a range of ports to have all of their traffic also sent to a designated port − where a network sniffer or other device can monitor the network traffic. In addition, you can specify that only traffic received by, sent by or both is mirrored to the target port.
Page 643
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format config mirror group_id <value 1-4> {target_port <port> | [add | delete] source ports <portlist> [rx | tx | both] | state [enable | disable]} Parameters <value 1-4> - Enter the mirror group ID used here. This value must be between 1 and 4. target_port - (Optional) Specifies the port that will receive the packets duplicated at the mirror port.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters <value 1-4> - Enter the mirror group ID used here. This value must be between 1 and 4. Restrictions Only Administrator and Operator-level users can issue this command. Example To delete mirror group 3: DGS-3420-28SC:admin# delete mirror group_id 3...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Success. DGS-3420-28SC:admin# 56-6 disable mirror Description This command, combined with the enable mirror command above, allows you to enable or disable mirror function without having to modify the mirror session configuration. Format disable mirror Parameters...
Page 646
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide <value 1-4> - Enter the group ID used for this display here. This value must be between 1 and Restrictions None. Example To display mirroring configuration: DGS-3420-28SC:admin#show mirror Command: show mirror Mirror Global State: Disabled...
Page 648
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format disable mld_proxy Parameters None. Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To disable the MLD proxy: DGS-3420-28SC:admin#disable mld_proxy Command: disable mld_proxy Success.
Page 649
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To configure the MLD Proxy’s downstream interface: DGS-3420-28SC:admin#config mld_proxy downstream_if add vlan vlanid 2-7 Command: config mld_proxy downstream_if add vlan vlanid 2-7 Success. DGS-3420-28SC:admin# 57-4 config mld_proxy upstream_if Description This command is used to configure the setting for the MLD proxy’s upstream interface.
Page 650
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To configure the router port of MLD proxy’s upstream interface: DGS-3420-28SC:admin#config mld_proxy upstream_if vlan default router_ports add 3 Command: config mld_proxy upstream_if vlan default router_ports add 3 Success.
Page 651
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#show mld_proxy Command: show mld_proxy MLD Proxy Global State : Enabled Upstream Interface VLAN ID Dynamic Router Ports : 1-4 Static Router Ports : 5-6 Unsolicited Report Interval : 10 Source IP Address : ::...
Page 653
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format config mld_snooping [vlan_name <vlan_name 32> | vlanid <vlanid_list> | all] {state [enable | disable] | fast_done [enable | disable] | proxy_reporting {state [enable | disable] | source_ip <ipv6addr>}(1)}(1) Parameters vlan_name - Specify the name of the VLAN for which MLD snooping is to be configured.
Page 654
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format config mld_snooping rate_limit [ports <portlist> | vlanid <vlanid_list>] [<value 1-1000> | no_limit] Parameters ports - Specify a range of ports to be configured. <portlist> - Specify a range of ports to be configured. vlanid - Specify a range of VLANs to be configured.
Page 655
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions None. Example To display the MLD snooping packet rate limit for ports 1 to 2: DGS-3420-28SC:admin#show mld_snooping rate_limit ports 1-2 Command: show mld_snooping rate_limit ports 1-2 Port Rate Limit(pkt/sec) -------- --------------------...
Page 656
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To create an MLD snooping static group on vlan1, group FF1E::1: DGS-3420-28SC:admin#create mld_snooping static_group vlan vlan1 FF1E::1 Command: create mld_snooping static_group vlan vlan1 FF1E::1 Success. DGS-3420-28SC:admin# 58-5 config mld_snooping static_group Description This command is used to configure an MLD snooping static group on the switch.
Page 657
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Success. DGS-3420-28SC:admin# 58-6 delete mld_snooping static_group Description This command is used to delete an MLD snooping static group on the switch. The deletion of an MLD snooping static group will not affect the MLD snooping dynamic member ports for a group. Format delete mld_snooping static_group [vlan <vlan_name 32>...
Page 658
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters vlan - (Optional) Specify the name of the VLAN on which the static group resides. <vlan_name 32> - Specify the VLAN name. The maximum length is 32 characters. vlanid - (Optional) Specify the ID of the VLAN on which the static group resides.
Page 659
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions None. Example To display the MLD snooping statistics counters on port 1: DGS-3420-28SC:admin#show mld_snooping statistic counter ports 1 Command: show mld_snooping statistic counter ports 1 Port # -------------------------------------------------- Group Number Receive Statistics...
Page 660
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 58-9 clear mld_snooping statistics counter Description This command is used to clear the MLD snooping statistics counters. Format clear mld_snooping statistics counter Parameters None. Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To clear the MLD snooping statistics counters: DGS-3420-28SC:admin#clear mld_snooping statistics counter...
Page 661
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide <vlanid_list> - Specify the VLAN ID list. all - Specify all VLANs for which MLD snooping querier is to be configured. query_interval - Specify the amount of time in seconds between general query transmissions. <sec 1-65535>...
Page 662
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 58-11 config mld_snooping mrouter_ports Description This command allows users to designate a range of ports as being connected to multicast-enabled routers. This will ensure that all packets with such a router as its destination will reach the multicast- enabled router, regardless of protocol.
Page 663
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters vlan - Specify the name of the VLAN on which the router port resides. <vlan_name 32> - Specify the name of the VLAN on which the router port resides. The maximum length is 32 characters.
Page 664
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#enable mld_snooping Command: enable mld_snooping Success. DGS-3420-28SC:admin# 58-14 disable mld_snooping Description This command is used to disable MLD snooping on the switch. MLD snooping can be disabled only if IPv6 multicast routing is not being used.
Page 665
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters vlan - (Optional) Specify the name of the VLAN for which to view the MLD snooping configuration. <vlan_name 32> - Specify the name of the VLAN. The maximum length is 32 characters. vlanid - (Optional) Specify the ID of the VLAN for which to view the MLD snooping configuration.
Page 666
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 58-16 show mld_snooping group Description This command is used to display the current MLD snooping group information on the switch. Format show mld_snooping group {[vlan <vlan_name 32> | vlanid <vlanid_list> | ports <portlist>] {<ipv6addr>}} {data_driven} Parameters vlan - (Optional) Specify the name of the VLAN for which to view MLD snooping group...
Page 667
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#show mld_snooping group Command: show mld_snooping group Source/Group : 2001::1/FF1E::1 VLAN Name/VID :default/1 Member Ports : 1-2 UP Time : 26 Expiry Time : 258 Filter Mode : INCLUDE Source/Group : 2002::2/FF1E::1 VLAN Name/VID:...
Page 668
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Note: If no parameter is specified, the system will display all router ports on the Switch. Restrictions None. Example To display router ports: DGS-3420-28SC:admin#show mld_snooping mrouter_ports all Command: show mld_snooping mrouter_ports all VLAN Name : default Static Router Port...
Page 669
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Note: If no parameter is specified, the system will display all currently configured MLD snooping forwarding entries. Restrictions None. Example To display all MLD snooping forwarding entries located on the switch: DGS-3420-28SC:admin#show mld_snooping forwarding Command: show mld_snooping forwarding VLAN Name...
Page 670
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To clear the MLD snooping group learned by data driven: DGS-3420-28SC:admin#clear mld_snooping data_driven_group all Command: clear mld_snooping data_driven_group all Success.
Page 671
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide disable - Disable data driven learning of an MLD snooping group. aged_out - Enable or disable the aging of the entry. This is disabled by default. enable - Enable the aging of the entry. disable - Disable the aging of the entry.
Page 674
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide given a name that can be up to 32 characters. <vlanid 2-4094> - Specify the VLAN ID of the multicast VLAN to be created. The range is from 2 to 4094.
Page 675
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide source_port - Specify source port where the multicast traffic is entering the Switch. <portlist> - Specify a range of ports to be configured. untag_source_port - Specify the untagged source port where the multicast traffic is entering the Switch.
Page 676
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format create mld_snooping multicast_vlan_group_profile <profile_name 1-32> Parameters <profile_name 1-32> - Specify the multicast VLAN profile name. The maximum length is 32 characters. Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To create an MLD snooping multicast group profile with the name “Knicks”: DGS-3420-28SC:admin#create mld_snooping multicast_vlan_group_profile Knicks...
Page 677
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To add the single multicast address FF1E::11 and multicast range FF1E::12-FF1E::20 to the MLD snooping multicast VLAN profile named “Knicks”: DGS-3420-28SC:admin#config mld_snooping multicast_vlan_group_profile Knicks add FF1E::11, FF1E::12-FF1E::20 Command: config mld_snooping multicast_vlan_group_profile Knicks add FF1E::11, FF1E::12-FF1E::20 Success.
Page 678
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 59-6 show mld_snooping multicast_vlan_group_profile Description This command is used to display an MLD snooping multicast group profile. Format show mld_snooping multicast_vlan_group_profile {<profile_name 1-32>} Parameters <profile_name 1-32> - (Optional) Specify the multicast VLAN profile name. The maximum length is 32 characters.
Page 679
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format config mld_snooping multicast_vlan_group <vlan_name 32> [add | delete] profile_name <profile_name 1-32> Parameters <vlan_name 32> - Specify the name of the multicast VLAN to be configured. Each multicast VLAN is given a name that can be up to 32 characters.
Page 680
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To display all MLD snooping multicast VLANs’ group profile information: DGS-3420-28SC:admin#show mld_snooping multicast_vlan_group Command: show mld_snooping multicast_vlan_group VLAN Name VLAN ID Multicast Group Profiles ------------------------------- ------- --------------------------------- test2 test1 DGS-3420-28SC:admin#...
Page 681
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 59-10 enable mld_snooping multicast_vlan Description This command is used to enable the MLD snooping multicast VLAN function. By default, the multicast VLAN is disabled. Format enable mld_snooping multicast_vlan Parameters None.
Page 682
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To disable MLD snooping multicast VLAN: DGS-3420-28SC:admin#disable mld_snooping multicast_vlan Command: disable mld_snooping multicast_vlan Success. DGS-3420-28SC:admin# 59-12 show mld_snooping multicast_vlan Description This command allows information for a specific multicast VLAN to be displayed. Format show mld_snooping multicast_vlan {<vlan_name 32>} Parameters...
Page 683
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#show mld_snooping multicast_vlan Command: show mld_snooping multicast_vlan MLD Multicast VLAN Global State : Disabled MLD Multicast VLAN Forward Unmatched : Disabled MLD Multicast VLAN Auto Assign VLAN : Disabled VLAN Name :test :100...
Page 684
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#config mld_snooping multicast_vlan forward_unmatched enable Command: config mld_snooping multicast_vlan forward_unmatched enable Success. DGS-3420-28SC:admin# 59-14 config mld_snooping multicast_vlan auto_assign_vlan Description This command is used to enable the auto assignment of MLD control packets to the right MSM VLAN. If auto assign vlan is enabled, the Switch would check for group matching in the profiles of all multicast VLANs to which the ingress port belongs to.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 60 Modify Login Banner and Prompt Commands config greeting_message {default} show greeting_message config command_prompt [<string 16> | username | default] 60-1 config greeting_message Description This command is used to modify the login banner. Format config greeting_message {default} Parameters...
Page 686
DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Command Line Interface Firmware: Build 1.50.010 Copyright(C) 2011 D-Link Corporation. All rights reserved. =============================================================================== <Function Key> <Control Key> Ctrl+C Quit without save left/right/ Ctrl+W Save and quit up/down...
Page 687
DGS-3420-28SC:admin#show greeting_message Command: show greeting_message =============================================================================== DGS-3420-28SC Gigabit Ethernet Switch Command Line Interface Firmware: Build 1.50.010 Copyright(C) 2011 D-Link Corporation. All rights reserved. =============================================================================== DGS-3420-28SC:admin# 60-3 config command_prompt Description This command is used to modify the command prompt. The current command prompt consists of four parts: “product name”...
Page 688
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide default - Specify the command to return the command prompt to its original factory default value. Restrictions When users issue the “reset” command, the current command prompt will remain in tact. Issuing the “reset system”...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format config nlb multicast_fdb [<vlan_name 32> | vlanid <vlanid 1-4094>] <macaddr> [add | delete] <portlist> Parameters <vlan_name 32> - Enter the VLAN name of the NLB multicast FDB entry here. This name can be up to 32 characters long.
Page 692
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To display the NLB forwarding table: DGS-3420-28SC:admin# show nlb fdb Command: show nlb fdb MAC Address VLAN ID Egress Ports ----------------- ---------- ---------------------------------- 02-bf-01-01-01-01 1:1-1:5,1:26,2:26 02-bf-01-01-01-02 1:1-1:5,1:26,2:26 03-bf-01-01-01-01 1:1-1:5,1:26,2:26 03-bf-01-01-01-01...
Page 693
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 61-6 config nlb unicast_fdb Description This command is used to add or delete the forwarding ports for the specified NLB unicast FDB entry. Format config nlb unicast_fdb <macaddr> [add | delete] <portlist> Parameters <macaddr>...
Page 694
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To delete the NLB unicast FDB entry, for the product that support the VLAN information on the unicast forwarding: DGS-3420-28SC:admin#delete nlb unicast_fdb 02-bf-01-01-01-01 Command: delete nlb unicast_fdb 02-BF-01-01-01-01...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator and Operator-level users can issue this command. Example To enable SNMP: DGS-3420-28SC:admin#enable snmp Command: enable snmp Success. DGS-3420-28SC:admin# 62-2 disable snmp Description This command is used to disable the SNMP function. When SNMP function is disabled, the network manager will not be able to access SNMP MIB objects.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 62-3 show snmp Description This command is used to display SNMP status. Format show snmp Parameters None. Restrictions None. Example To display SNMP: DGS-3420-28SC:admin#show snmp Command: show snmp System Name System Location System Contact...
Page 698
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters <ipaddr> - Specify the IP address of the trusted host. <ipv6addr> - Specify the IPv6 address of the trusted host. network - Specify the network address of the trusted network. The form of network address is xxx.xxx.xxx.xxx/y.
Page 699
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters <ipaddr> - Specify the IP address of the trusted host. <ipv6addr> - Specify the IPv6 address of the trusted host. network - Specify the network address of the trusted network. The form of network address is xxx.xxx.xxx.xxx/y.
Page 700
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide <ipv6addr> - Specify the IPv6 address of the trusted host. network - Specify the network address of the trusted network. The form of network address is xxx.xxx.xxx.xxx/y. <network_address> - Specify the network address of the trusted network. The form of network address is xxx.xxx.xxx.xxx/y.
Page 701
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Management Stations IP Address Access Interface ---------------------------------------------------------------------------- 10.48.93.100 10.51.17.1 10.50.95.90 Total Entries : 3 DGS-3420-28SC:admin# 62-8 config snmp system_name Description This command is used to configure the SNMP system name of the switch. Format config snmp system_name <sw_name>...
Page 702
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format config snmp system_location <sw_location> Parameters <sw_location> - Specify an SNMP system location for the switch. A maximum of 255 characters is allowed. Restrictions Only Administrator and Operator-level users can issue this command. Example To configure the switch location for “HQ 5F”: DGS-3420-28SC:admin#config snmp system_location HQ 5F...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#config snmp system_contact "MIS Department IV" Command: config snmp system_contact "MIS Department IV" Success. DGS-3420-28SC:admin# 62-11 enable snmp traps Description This command is used to enable SNMP trap support on the switch. Format enable snmp traps Parameters...
Page 704
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters None. Restrictions Only Administrator and Operator-level users can issue this command. Example To prevent SNMP traps from being sent from the switch: DGS-3420-28SC:admin#disable snmp traps Command: disable snmp traps Success.
Page 705
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 62-14 disable snmp authenticate_traps Description This command is used to disable SNMP authentication failure trap support. Format disable snmp authenticate_traps Parameters None. Restrictions Only Administrator and Operator-level users can issue this command. Example To disable SNMP authentication trap support: DGS-3420-28SC:admin#disable snmp authenticate_traps...
Page 706
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To enable SNMP linkchange trap support: DGS-3420-28SC:admin#enable snmp linkchange_traps Command: enable snmp linkchange_traps Success. DGS-3420-28SC:admin# 62-16 disable snmp linkchange_traps Description This command is used to disable SNMP linkchange trap support. Format disable snmp linkchange_traps Parameters...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format config snmp linkchange_traps ports [all | <portlist>] [enable | disable] Parameters all - Specify all ports. <portlist> - Specify a port or range of ports. enable - Enable sending of the link change trap for this port. disable - Disable sending of the link change trap for this port.
Page 709
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format config snmp coldstart_traps [enable | disable] Parameters enable - Enable traps for coldstart events. The default state is enabled. disable - Disable traps for coldstart events. Restrictions Only Administrator and Operator-level users can issue this command.
Page 710
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Success. DGS-3420-28SC:admin# 62-21 config trap source_ipif Description This command is used to force change the ipif information in trap messages. By default, trap messages will carry the information of the ipif they belong to. Format config trap source_ipif [<ipif_name 12>...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 62-22 show trap source_ipif Description This command is used to display the trap source IP interface. Format show trap source_ipif Parameters None. Restrictions None. Example To display the trap source IP interface: DGS-3420-28SC:admin#show trap source_ipif Command: show trap source_ipif Trap Source IP Interface Configuration:...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide falling_alarm - (Optional) Specify the trap state for falling alarm. The default state is enabled. enable - Enable the trap state for falling alarm. disable - Disable the trap state for falling alarm. Restrictions Only Administrator and Operator-level users can issue this command.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions None. Example To display the packets analysis for port 7: DGS-3420-28SC:admin#show packet ports 7 Command: show packet ports 7 Port number : 7 Frame Size/Type Frame Counts Frames/sec --------------- ----------------------...
Page 716
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format show errors ports <portlist> Parameters <portlist> - Specify a port or range of ports to be displayed. Restrictions None. Example To display the errors of port 3: DGS-3420-28SC:admin#show error ports 3 Command: show error ports 3 Port Number : 3...
Page 717
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters ports - Specify to display real-time port statistics. cpu - Specify to display real-time CPU statistics. Restrictions None. Example To display port utilization: DGS-3420-28SC:admin#show utilization ports Command: show utilization ports Port TX/sec RX/sec...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide CTRL+C ESC q Quit SPACE n Next Page Previous Page Refresh 63-4 show utilization dram Description This command is used to display real-time DRAM utilization statistics. Format show utilization dram {unit <unit_id>} Parameters unit - Specifies which unit on the stacking system.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters unit - Specifies which unit on the stacking system. If it is not specified, it refers to the master unit. <unit_id> - Enter the unit ID used here. Restrictions None.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To clear the switch’s statistics counters for ports 7 to 9: DGS-3420-28SC:admin#clear counters ports 7-9 Command: clear counters ports 7-9 Success. DGS-3420-28SC:admin# 63-7 clear log Description This command is used to clear the switch’s history log. Format clear log Parameters...
Page 721
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format show log {[index <value_list> | severity {module <module_list>} {emergency | alert | critical | error | warning | notice | informational | debug | <level_list 0-7>} | module <module_list>]} Parameters index - (Optional) Specify to display the history log between two values.
Page 722
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin# 63-9 show log_save_timing Description This command is used to display the method to save log. Format show log_save_log_timing Parameters None. Restrictions None. Example To display the method to save log: DGS-3420-28SC:admin#show log_save_timing Command: show log_save_timing Saving Log Method:...
Page 723
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions None. Example To display the protocols or applications that support the enhanced log: DGS-3420-28SC:admin#show log_software_module Command: show log_software_module CFM_EXT DHCPv6_CLIENT DHCPv6_RELAY DHCPv6_SERVER ERPS ERROR_LOG MSTP VRRP DGS-3420-28SC:admin# 63-11 config log_save_timing Description This command is used to set the method to save log.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 63-12 enable syslog Description This command is used to globally enable syslog to send log messages to a remote server. Format enable syslog Parameters None. Restrictions Only Administrator and Operator-level users can issue this command. Example To enable syslog to send a message: DGS-3420-28SC:admin#enable syslog...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To disable syslog sending a message: DGS-3420-28SC:admin#disable syslog Command: disable syslog Success DGS-3420-28SC:admin# 63-14 show syslog Description This command is used to display the syslog protocol global state. Format show syslog Parameters...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide enable - Enable the host to receive messages. disable - Disable the host to receive messages. Restrictions Only Administrator and Operator-level users can issue this command. Example To create a new syslog host: DGS-3420-28SC:admin# create syslog host 1 ipaddress 10.1.1.1 Command: create syslog host 1 ipaddress 10.1.1.1 Success.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 63-18 show syslog host Description This command is used to display syslog host configurations. Format show syslog host {<index 1-4>} Parameters <index 1-4> - (Optional) Specify the host index. Note: If no parameter is specified, all hosts will be displayed.
Page 730
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 63-19 config syslog source_ipif Description This command is used to force change the ipif information in syslogs. By default, syslogs will carry the information of the ipif they belong to. Format config syslog source_ipif [<ipif_name 12>...
Page 731
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format show syslog source_ipif Parameters None. Restrictions None. Example To display the syslog source interface: DGS-3420-28SC:admin#show syslog source_ipif Command: show syslog source_ipif Syslog Source IP Interface Configuration: IP Interface : System IPv4 Address : None...
Page 732
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions None. Example To display the switch’s attack log: DGS-3420-28SC:admin#show attack_log index 1-3 Command: show attack_log index 1-3 Index Date Time Level Log Text ----- ---------- -------- -------- -------------------------------------------- 2009-12-26 14:15:45 WARN(4) Port security violation mac addrss 00-18-...
Page 736
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide window - The range is 148810 to 100000000 ms. <number 14881-892860000> - The range is 14881 to 892860000 ms. notify_state - Specify the event notification status. The default state is enable. enable - Specify to enable event notification.
Page 737
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin# To configure the error frame threshold to 2 and period to 1000 ms for port 1: DGS-3420-28SC:admin#config ethernet_oam ports 1 link_monitor error_frame threshold 2 window 1000 notify_state enable Command: config ethernet_oam ports 1 link_monitor error_frame threshold 2 window 1000 notify_state enable Success.
Page 738
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Command: config ethernet_oam ports 1 remote_loopback start Success. DGS-3420-28SC:admin# To configure the method of processing the received remote loopback command as “process” on port 1: DGS-3420-28SC:admin#config ethernet_oam ports 1 received_remote_loopback process Command: config ethernet_oam ports 1 received_remote_loopback process Success.
Page 739
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide configuration changes have occurred, which might require the peer OAM entity to re-evaluate whether OAM peering is allowed. (6) OAM mode change. (7) OAM Functions Supported: The OAM functions supported on this port. These functions include: 1.
Page 743
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide time_interval also need to be configured. threshold - The upper threshold at which the specified storm control will turn on. This is the number of broadcast/multicast/unknown unicast packets per second received by the switch that will trigger the storm traffic control measure.
Page 744
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 65-2 config traffic control auto_recover_time Description This command is used to configure the traffic auto recover time that allowed for a port to recover from shutdown forever status. The time allowed for auto recovery from shutdown for a port. The default value is 0, so no auto recovery is possible;...
Page 745
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format config traffic control log state [enable | disable] Parameters state - Specifies the traffic control log state. enable - Specifies that traffic control state will be logged when a storm occurs. disable - Specifies that the traffic control state will be disabled.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To configure a traffic control trap: DGS-3420-28SC:admin#config traffic trap both Command: config traffic trap both Success. DGS-3420-28SC:admin# 65-5 show traffic control Description This command is used to display current traffic control settings. Format show traffic control {<portlist>} Parameters...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 66 Password Recovery Commands enable password_recovery disable password_recovery show password_recovery 66-1 enable password_recovery Description This command is used to enable the password recovery mode. Note: The configuration does not take effect until saved. Format enable password_recovery Parameters...
Page 749
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Note: The configuration does not take effect until saved. Format disable password_recovery Parameters None. Restrictions Only Administrator-level users can issue this command. Example To disable the password recovery mode: DGS-3420-28SC:admin# disable password_recovery Command: disable password_recovery Success.
Page 750
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters None. Restrictions Only Administrator-level users can issue this command. Example To display the password recovery state: DGS-3420-28SC:admin# show password_recovery Command: show password_recovery Running Configuration : Disabled NV-RAM Configuration : Enabled DGS-3420-28SC:admin#...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 67 Policy Route Commands create policy_route name <policyroute_name 32> delete policy_route name <policyroute_name 32> config policy_route name <policyroute_name 32> acl profile_id <value 1-6> access_id <value 1- 256> nexthop <ipaddr> state [enable | disable] {route_preference [default | pbr]} show policy_route 67-1 create policy_route name...
Page 752
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format delete policy_route name <policyroute_name 32> Parameters <policyroute_name 32> - The policy route name. The maximum length is 32 characters. Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To delete an IP route entry in the Switch’s IP routing table named “duhon”: DGS-3420-28SC:admin#delete policy_route name duhon...
Page 753
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide pbr - Specifies that the policy based route has higher priority than the route in the routing table. Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To configure all packets which match ACL rule profile ID=1 and access ID=1, and then route to 20.1.1.100:...
Page 756
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide command will be rejected. The default value is 32. <max_lock_no 0-3328> - Specify the value between 0 and 3328. lock_address_mode - Indicate locking address mode. The default mode is deleteonreset. permanent - The address will never be deleted unless the user removes it manually or the VLAN of the entry is removed or the port are removed from the VLAN, or port security is disabled on the port where the address resides.
Page 757
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide a port, for a VLAN, and for specific VLAN on a port. If any limitation is exceeded, the new entry will be discarded. The setting for system level max learned users must be greater than the total of the max learned users allowed on all ports.
Page 758
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide <vidlist> - Specify the VLAN ID. max_learning_addr - Specify the maximum number of MAC address entries that can be learned with this VLAN. If this parameter is set to 0, it means that no user can get authorization on this VLAN.
Page 759
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#delete port_security_entry vlan default mac_address 00-01- 30-10-2C-C7 Command: delete port_security_entry vlan default mac_address 00-01-30-10-2C-C7 Success. DGS-3420-28SC:admin# 68-5 clear port_security_entry Description This command is used to clear the MAC entries learned from the specified port(s) or VLAN(s) for the port security function.
Page 760
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format show port_security_entry {ports {<portlist>} {[vlan <vlan_name 32> | vlanid <vidlist>]}} Parameters ports - (Optional) Specify a range of ports to be displayed. <portlist> - Specify a range of ports to be displayed. vlan - (Optional) Specify a VLAN to display its entry.
Page 761
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide vlan - (Optional) Specify a VLAN to display its configuration. <vlan_name 32> - Specify the VLAN name. The maximum length is 32 characters. vlanid - (Optional) Specify a VLAN list to display the configuration. <vidlist>...
Page 762
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 68-8 config port_security log state Description This command is used to enable or disable the port security log. When the port security log is enabled and there is a new MAC that violates the pre-defined port security configuration, the MAC, port and other relevant information will be logged, otherwise, no log will be generated.
Page 763
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To enable the sending of port security traps: DGS-3420-28SC:admin# config port_security trap state enable Command: config port_security trap state enable Success.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 69 Power over Ethernet (PoE) Commands Note: These commands are only available on Switches in the series that suppport Power over Ethernet. (PoE). config poe ports [all | <portlist>] {state [enable | disable] | [time_range <range_name 32> | clear_time_range] | priority [critical | high | low] | power_limit [class_0 | class_1 | class_2 | class_3 | user_define <value 1000-35000>]} config poe system {units [<unitlist>...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide critical - Specifies that the priority value will be set to critical. high - Specifies that the priority value will be set to high. low - Specifies that the priority value will be set to low. power_limit - (Optional) Specifies the per-port power limit.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters units - (Optional) Specifies the unit list that will be configured. <unitlist> - Enter the unit list, used for this configuration, here. all - Specifies that all the units will be used for this configuration. power_limit - (Optional) Specifies the power budget of the PoE system.
Page 767
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format show poe ports {<portlist>} Parameters ports - (Optional) Specifies the list of ports to be displayed here. <portlist> - Enter the list of ports, used for the display, here. If no parameter is specified, the system will display the status for all the ports.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 69-4 show poe system Description This command is used to display the settings and actual values of the whole PoE system. Format show poe system {units <unitlist>} Parameters units - (Optional) Specifies the unit list, that will be displayed, here.
Page 770
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide port - (Optional) Specify to configure the power saving state of port. hibernation - (Optional) Specify to configure the power saving state of system hibernation. enable - Specify to enable power saving state. disable - Specify to disable power saving state.
Page 771
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#config power_saving hibernation add time_range range_1 Command: config power_saving hibernation add time_range range_1 Success. DGS-3420-28SC:admin# 70-3 config power_saving led Description This command is used to add or delete the power saving schedule on the LED of all ports. When any schedule is up, all port’s LED will be turned off even device’s LED working on PoE mode.
Page 772
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 70-4 config power_saving port Description This command is used to add or delete the power saving schedule on the port. When any schedule is up, the specific port will be shut down (disabled). Note: The port’s admin state has high priority.
Page 773
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 70-5 show power_saving Description This command is used to display the current state of power saving. Format show power_saving {length_detection | link_detection | led | port | hibernation} Parameters length_detection - (Optional) Display the length detection configuration of power saving.
Page 774
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 70-6 config led state Description This command is used to configure the LED admin state of all ports. When the port LED admin state is disabled, the LEDs of all ports are turned off. If the port LED admin state is enabled, the port LEDs are controlled by the ports' link status.
Page 775
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To display the setting of all port’s LED admin state: DGS-3420-28SC:admin#show led Command: show led Port LED State: Enabled DGS-3420-28SC:admin#...
Page 777
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To enable the PTP function globally: DGS-3420-28SC:admin# enable ptp Command: enable ptp Success. DGS-3420-28SC:admin# 71-2 disable ptp Description This command is used to disable the PTP function globally. When the PTP function is disabled, all switch ports will forward the PTP packets according to the multicast filtering configuration.
Page 778
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide • Has multiple Precision Time Protocol (PTP) ports in a domain and maintains the timescale used in the domain. • Can serve as the time source and can synchronize with another clock. •...
Page 779
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters ethernet - Specifies the transport protocol of PTP as IEEE802.3 Ethernet. udp - Specifies the transport protocol of PTP as UDP over IPv4. Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To specify the transport protocol of PTP as IEEE802.3 Ethernet frames: DGS-3420-28SC:admin# config ptp transport protocol ethernet...
Page 780
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To configure the domain number of the PTP clock as 1 and assign a domain name of internal_domain on the local unit, when the stacking mode is disabled: DGS-3420-28SC:admin# config ptp clock domain_number 1 domain_name internal_domain Command: config ptp clock domain_number 1 domain_name internal_domain...
Page 781
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To configure the priority1 value of the boundary clock as 127: DGS-3420-28SC:admin# config ptp boundary priority1 127 Command: config ptp boundary priority1 127 Success.
Page 782
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin# config ptp ports 1:1-1:4 state enable Command: config ptp ports 1:1-1:4 state enable Success. DGS-3420-28SC:admin# config ptp boundary ports Description This command is used to configure the attributes of the PTP boundary clock. The configuration takes effect when the PTP device is a boundary type.
Page 783
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide and 5. pdelay_req_interval - (Optional) Specifies the permitted mean time interval between successive pdelay_request messages. <sec 1-32> - Enter the permitted mean time interval value used here. This value must be between 1 and 32 seconds.
Page 784
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin# config ptp boundary ports all delay_req_interval 0 Command: config ptp boundary ports all delay_req_interval 0 Success. DGS-3420-28SC:admin# To configure the pdelay_req_interval attribute of the all PTP ports as 5 seconds: DGS-3420-28SC:admin# config ptp boundary ports all pdelay_req_interval 5 Command: config ptp boundary ports all pdelay_req_interval 5 The pdelay_req interval is automatically adjusted to 8.
Page 785
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To configure the pdelay_req_interval attribute of all the PTP ports to 4 seconds: DGS-3420-28SC:admin# config ptp p2p_transparent ports all pdelay_req_interval 4 Command: config ptp p2p_transparent ports all pdelay_req_interval 4 Success.
Page 786
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide show ptp clock Description This command is used to display the active attributes of the PTP clock. Format show ptp clock Parameters None. Restrictions None. Example To show the active attributes of the boundary clock: DGS-3420-28SC:admin# show ptp clock Command: show ptp clock PTP State...
Page 787
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin# show ptp clock Command: show ptp clock PTP State : Enabled PTP Clock Mode : Peer-to-Peer Transparent Clock PTP Transport Protocol : UDP PTP Clock Domain Number PTP Clock Domain Name : internal_domain PTP Clock Delay Mechanism...
Page 788
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide PTP Last Offset +130ns PTP Mean Path Delay 140 second PTP Enabled Ports : 2:1-2:4 DGS-3420-28SC:admin# show ptp clock parent Description This command is used to display the active attributes of the PTP parent clock. Format show ptp clock parent Parameters...
Page 789
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin# show ptp clock parent Command: show ptp clock parent The boundary clock has not completed synchronization. DGS-3420-28SC:admin# The display of the active attributes of the boundary clock parent when the boundary clock is the grandmaster clock: DGS-3420-28SC:admin# show ptp clock parent Command: show ptp clock parent...
Page 790
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin# show ptp clock parent Command: show ptp clock parent Box ID: 1 PTP Parent Port Identity ACDE4823456789AB PTP Parent Port Number PTP Grandmaster Identity ACDE4823659789AD PTP Grandmaster Clock Class PTP Grandmaster Clock Accuracy 100ns PTP Grandmaster Priority 1...
Page 791
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin# show ptp ports 1:1-1:4 Command: show ptp ports 1:1-1:4 The active attributes: : Delay Mechanism : Announce Interval ART : Announce Receipt Timeout : Synchronization Interval DRIM: Delay_Request Interval-Master DRIS: Delay_Request Interval-Slave PDRI: Pdelay_Request Interval PMPD: Peer Mean Path Delay...
Page 792
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format show ptp boundary {ports [<portlist> | all]} Parameters ports – (Optional) Specifies the list of port used for this display. <portlist> - Enter the list of port used for this display here. all - Specifies that all the ports will be used for this display.
Page 793
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide show ptp p2p_transparent ports Description This command is used to display the configured attributes of the P2P transparent clock’s special ports. Format show ptp p2p_transparent ports [<portlist> | all] Parameters ports - Specifies the list of port used for this display.
Page 794
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters ports - Specifies the list of port used for this display. <portlist> - Enter the list of port used for this display here. all - Specifies that all the ports will be used for this display. Restrictions None.
Page 796
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide config dot1v_protocol_group Description This command is used to add a protocol to a protocol group. The selection of a protocol can be a pre- defined protocol type or a user defined protocol. Format config dot1v_protocol_group [group_id <int 1-16>...
Page 797
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To add a protocol IPv6 to protocol group 4: DGS-3420-28SC:admin# config dot1v_protocol_group group_id 4 add protocol ethernet_2 86dd Command: config dot1v_protocol_group group_id 4 add protocol ethernet_2 86dd Success.
Page 798
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin# show dot1v_protocol_group Description This command is used to display the protocols defined in protocol groups. Format show dot1v_protocol_group {[group_id <int 1-16> | group_name <name 32>]} Parameters group_id - (Optional) Specify the group ID to be displayed. <int 1-16>...
Page 799
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide When priority is not specified in the command, the port default prority will be the priority for those untagged packets classified by the protocol VLAN. Format config port dot1v ports [<portlist> | all] [add protocol_group [group_id <int 1-16> | group_name <name 32>] [vlan <vlan_name 32>...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide show port dot1v Description This command is used to display the VLAN to be associated with untagged packets ingressed from a port based on the protocol group. Format show port dot1v {ports <portlist>} Parameters ports - (Optional) Specify a range of ports to be displayed.
Page 802
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide <value 8-10240000> - Specify an integer value from 8 to 10240000 to set a maximum limit in Kbits/sec. The specified bandwidth limit may be equaled but not exceeded. This exact logical limit or token value is hardware determined.
Page 803
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#show bandwidth_control 1-2 Command: show bandwidth_control 1-2 Bandwidth Control Table Port RX Rate TX Rate Effective RX Effective TX (Kbit/sec) (Kbit/sec) (Kbit/sec) (Kbit/sec) ---- ---------- ---------- ---------------- ---------------- No Limit No Limit No Limit...
Page 804
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To configure the maximum rate to be 100 on queue 1 for ports 1 to 10: DGS-3420-28SC:admin#config per_queue bandwidth_control ports 1-10 1 max_rate 100 Command: config per_queue bandwidth_control ports 1-10 1 max_rate 100 Granularity: TX: 8.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide No Limit No Limit No Limit No Limit No Limit No Limit No Limit No Limit DGS-3420-28SC:admin# config scheduling Description This command is used to configure the traffic scheduling mechanism for each CoS queue. Format config scheduling {ports [<portlist>...
Page 806
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Success. DGS-3420-28SC:admin# config scheduling_mechanism Description This command is used to configure the traffic scheduling mechanism for each CoS queue. Format config scheduling_mechanism {ports [<portlist> | all]} [strict | wrr] Parameters ports - (Optional) Specifies the range of ports to be configured.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide show scheduling Description This command is used to display the current traffic scheduling parameters. Format show scheduling {<portlist>} Parameters <portlist> - (Optional) Specifies the range of ports to be displayed. Restrictions None.
Page 808
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#show scheduling 1 Command: show scheduling 1 QOS Output Scheduling On Port: 1 Class ID Weight -------- ------ Class-0 Class-1 Class-2 Class-3 Class-4 Class-5 Class-6 Class-7 DGS-3420-28SC:admin# show scheduling_mechanism Description This command is used to display the traffic scheduling mechanism.
Page 809
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Strict Strict Strict Strict Strict Strict CTRL+C ESC q Quit SPACE n Next Page ENTER Next Entry To show the scheduling mechanism on ports 1-10: DGS-3420-28SC:admin#show scheduling_mechanism 1-10 Command: show scheduling_mechanism 1-10 Port Mode...
Page 810
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Highest Highest Format config 802.1p user_priority {ports [<portlist> | all]} <priority 0-7> <class_id 0-7> Parameters ports - (Optional) Specifies that port used for this configuration. portlist - Specifies the range of ports to be configured. all - Specifies that all the ports will be used for this configuration.
Page 811
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions None. Example To display the 802.1p user priority: DGS-3420-28SC:admin#show 802.1p user_priority Command: show 802.1p user_priority QoS Class of Traffic Port 1 Priority-0 -> <Class-2> Priority-1 -> <Class-0> Priority-2 ->...
Page 812
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide beginning and end of the port list range are separated by a dash. all - Specify that the command applies to all ports on the switch. <priority 0-7> - Specify a priority value (0 to 7) to assign to untagged packets received by the switch or a range of ports on the switch.
Page 813
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To display 802.1p default priority for ports 1 to 4: DGS-3420-28SC:admin#show 802.1p default_priority 1-4 Command: show 802.1p default_priority 1-4 Port Priority Effective Priority ---- ----------- ------------------ DGS-3420-28SC:admin# 5-13 enable hol_prevention Description...
Page 814
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format disable hol_prevention Parameters None. Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To disable HOL prevention on the switch: DGS-3420-28SC:admin#disable hol_prevention Command: disable hol_prevention Success.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#show hol_prevention Command: show hol_prevention Device HOL Prevention State: Enabled DGS-3420-28SC:admin# 5-16 config dscp map Description This command is used to configure DHCP mapping. The mapping of DSCP to priority will be used to determine the priority of the packet (which will be then used to determine the scheduling queue) when the port is in DSCP trust state.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To configure the mapping of the DSCP priority to priority 1: DGS-3420-28SC:admin#config dscp map 1:1-1:8 dscp_priority 1 to 1 Command: config dscp map 1:1-1:8 dscp_priority 1 to 1 Success.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#show dscp map 1:1 dscp_dscp Command: show dscp map 1:1 dscp_dscp DSCP to DSCP Mapping: -------------------------------------------------------------- Port 1:1 -----------+-------------------------------------------------- -------------------------------------------------------------- DGS-3420-28SC:admin# 5-18 config dscp trust Description This command is used to configure the state of DSCP trust per port. When DSCP is not trusted, 802.1p is trusted.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#config dscp trust 1:1-1:8 state enable Command: config dscp trust 1:1-1:8 state enable Success. DGS-3420-28SC:admin# 5-19 show dscp trust Description This command is used to display DSCP trust state for the specified ports on the Switch. Format show dscp trust {<portlist>} Parameters...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To enable Q-in-Q: DGS-3420-28SC:admin#enable qinq Command: enable qinq Success. DGS-3420-28SC:admin# disable qinq Description This command is used to disable Q-in-Q. When Q-in-Q is disabled, all dynamic learned L2 addresses will be cleared, all dynamic registered VLAN entries will be cleared, and GVRP will be disabled.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide show qinq Description This command is used to display the global Q-in-Q status. Format show qinq Parameters None. Restrictions None. Example To display Q-in-Q: DGS-3420-28SC:admin#show qinq Command: show qinq QinQ Status : Enabled DGS-3420-28SC:admin# config qinq ports...
Page 822
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide the Q-in-Q profile and translated VLAN. enable - Enable miss drop of ports. disable - Disable miss drop of ports. outer_tpid - Specify the outer-TPID of a port. <hex 0x1-0xffff>...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To configure the inner TPID in the system to 0x9100: DGS-3420-28SC:admin# config qinq inner_tpid 0x9100 Command: config qinq inner_tpid 0x9100 Success.
Page 824
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format show qinq ports {<portlist>} Parameters <portlist> - (Optional) Specify a range of ports to be displayed. Note: If no parameter specified, the system will display port information for all ports. Restrictions None.
Page 825
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide by adding or replacing according the configured rule. The S-VLAN Tag of egress packets at this port will be recovered to C-VLAN Tag or stripped. Format create vlan_translation ports [<portlist> | all] [add cvid <vidlist> | replace cvid <vlanid 1-4094>] svid <vlanid 1-4094>...
Page 826
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide delete vlan_translation ports Description This command is used to delete translation relationships between C-VLAN and S-VLAN. Format delete vlan_translation ports [<portlist> | all] {cvid <vidlist>} Parameters <portlist> - Specify the ports to be deleted. all - Specify to delete all ports.
Page 827
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions None. Example To display VLAN translation for ports 1 and 2: DGS-3420-28SC:admin#show vlan_translation ports 1-2 Command: show vlan_translation ports 1-2 Port CVID SVID Action Priority ----- ----- ----- ------- -------- Total Entries: 5 DGS-3420-28SC:admin#...
Page 828
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Command: create vlan_translation_profile 2 Success. DGS-3420-28SC:admin# 6-12 config vlan_translation_profile Description This command is used to create a flow-based QinQ translation rule of a profile. Format config vlan_translation_profile <profile_id> add rule_id {<rule_id>} [add svid <vlanid 1-4094> {priority <priority 0-7>} classify {source_mac <macaddr>...
Page 829
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide sip_mask - Specifies the source IPv4 address mask used. <netmask> - Enter the source IPv4 address mask used here. destination_ipv4 - Specifies the destination IPv4 address or IPv4 subnet for the match. <ipaddr>...
Page 830
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide <value 1-65535> - Enter the Layer 4 source port ID used here. This value must be between 1 and 65535. l4_dest_port - Specifies the Layer 4 destination port ID for the match. <value 1-65535>...
Page 831
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin# 6-13 show vlan_translation_profile Description This command is used to show flow-based VLAN translation rules in a profile. Format show vlan_translation_profile {<profile_id_list>} Parameters <profile_id_list> - (Optional) Specifies the profile ID number to be shown. If no profile ID is used, all profiles will be displayed.
Page 832
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 6-14 delete vlan_translation_profile Description This command is used to delete a QinQ translation profile or delete a QinQ rule in a profile. Format delete vlan_translation_profile [<profile_id> | all] {rule_id [<rule_id_list> | all]} Parameters <profile_id>...
Page 834
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide config rip Description This command is used to configure the RIP settings for one or more IP interfaces. Format config rip [ipif <ipif_name 12> | all] {authentication [enable <password 16> | disable] | tx_mode [disable | v1_only | v1_compatible | v2_only] | rx_mode [v1_only | v2_only | v1_or_v2 | disable] | state [enable | disable]}(1) Parameters...
Page 835
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin# config rip ipif System rx_mode v1_only Command: config rip ipif System rx_mode v1_only Success. DGS-3420-28SC:admin# config rip timers Description This command is used to configure RIP timers. Format config rip timers {update <sec 5-65535>...
Page 836
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide disable rip Description This command is used to disable RIP for the Switch. Format disable rip Parameters None. Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To disable RIP: DGS-3420-28SC:admin# disable rip...
Page 837
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions None. Example To display RIP configuration and statistics for all IP interface. DGS-3420-28SC:admin#show rip Command: show rip RIP Global State : Enabled Update Time : 120 seconds Timeout Time : 300 seconds Garbage Collection Time...
Page 839
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format disable ripng Parameters None. Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To disable RIPng globally: DGS-3420-28SC:admin# disable ripng Command: disable ripng Success.
Page 840
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#show ripng Command: show ripng Global State: Disabled Method: Split Horizon Update Time: 30 seconds Expire Time: 180 seconds Garbage Collection Time: 120 seconds Interface State Metric ----------------------------------------------------- Total Entries : 0 DGS-3420-28SC:admin# config ripng...
Page 841
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To configure the RIPng method as poison reverse: DGS-3420-28SC:admin# config ripng method poison_reverse Command: config ripng method poison_reverse Success. DGS-3420-28SC:admin# config ripng ipif Description This command is used to specify the RIPng state and metric value for one or all interfaces Format config ripng ipif [<ipif_name 12>...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format disable rspan Parameters None. Restrictions Only Administrator and Operator-level users can issue this command. Example To disable the RSPAN globally: DGS-3420-28SC:admin#disable rspan Command: disable rspan Success. DGS-3420-28SC:admin# create rspan vlan Description This command is used to create an RSPAN VLAN.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide To delete an RSPAN VLAN entry by VLAN ID “3”: DGS-3420-28SC:admin#delete rspan vlan vlan_id 3 Command: delete rspan vlan vlan_id 3 Success. DGS-3420-28SC:admin# config rspan vlan Description This command is used by the source switch to configure the source setting for the RSPAN VLAN. The redirect command is used by the intermediate or last switch to configure the output port of the RSPAN VLAN packets, and makes sure that the RSPAN VLAN packets can egress to the redirect ports.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide delete - (Optional) Specify to delete source ports. ports - (Optional) Specify source port list to add to or delete from the RSPAN source. <portlist> - Specify a range of ports to be configured. rx - (Optional) Specify to only monitor ingress packets.
Page 847
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters vlan_name - Specify the RSPAN VLAN by VLAN name. <vlan_name> - Specify the VLAN name. vlan_id - Specify the RSPAN VLAN by VLAN ID. <vlanid 1-4094> - Specify the VLAN ID between 1 and 4094. Restrictions None.
Page 848
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide RSPAN VLAN ID -------------------- Redirect Port : 6-10 Total RSPAN VLAN :3 DGS-3420-28SC:admin#...
Page 850
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To configure the safeguard engine: DGS-3420-28SC:admin#config safeguard_engine state enable utilization rising 50 falling 30 trap_log enable Command: config safeguard_engine state enable utilization rising 50 falling 30 trap_log enable Success.
Page 851
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Mode Fuzzy DGS-3420-28SC:admin# Note: The safeguard engine current status has two modes: exhausted and normal mode.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 11 Secure File Transfer Protocol (SFTP) Commands enable sftp server disable sftp server config sftp server {timeout <sec 30-600>}(1) show sftp server 11-1 enable sftp server Description This command is used to enable the SFTP function globally.
Page 853
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 11-2 disable sftp server Description This command is used to disable the SFTP server function globally. All active SFTP sessions will be disturbed after executing this command. SFTP server runs as a subsystem of the SSH server. Disabling SSH server will also disturb all SFTP session.
Page 854
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To configure idle timer to 600 seconds. DGS-3420-28SC:admin#config sftp server timeout 600 Command: config sftp server timeout 600 Success.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#enable sflow Command: enable sflow Success. DGS-3420-28SC:admin# 12-2 disable sflow Description This command is used to disable the sFlow function. Format disable sflow Parameters None. Restrictions Only Administrator and Operator-level users can issue this command. Example To disable the sFlow function: DGS-3420-28SC:admin#disable sflow...
Page 857
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters None. Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To display the sFlow information: DGS-3420-28SC:admin#show sflow Command: show sflow sFlow Version : V5 sFlow Address : 10.90.90.90 sFlow AddressV6: FE80::201:2FF:FE03:400...
Page 858
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide sampled that will be encapsulated and forwarded to the server. If not specified, the default value is 128. Restrictions Only Administrator and Operator-level users can issue this command. Example To create the sFlow flow sampler: DGS-3420-28SC:admin#create sflow flow_sampler ports 1 analyzer_server_id 1 rate 200...
Page 859
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To configure the sFlow flow sampler parameters: DGS-3420-28SC:admin#config sflow flow_sampler ports all rate 1 Command: config sflow flow_sampler ports all rate 1 Success. DGS-3420-28SC:admin# 12-6 delete sflow flow_sampler ports Description This command is used to delete the sFlow flow sampler.
Page 860
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format create sflow analyzer_server <value 1-4> owner<name 16> {timeout [<sec 1-2000000> | infinite] | collectoraddress [<ipaddr> | <ipv6addr>] | collectorport <udp_port_number 1-65535> | maxdatagramsize <value 300-1400>} Parameters <value 1-4> - Specify a value between 1 and 4. owner - Specify the entity making use of this sflow analyzer server.
Page 861
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format delete sflow analyzer_server <value 1-4> Parameters <value 1-4> - Specify a value between 1 and 4. Restrictions Only Administrator and Operator-level users can issue this command. Example To delete the sFlow analyzer server 1: DGS-3420-28SC:admin#delete sflow analyzer_server 1 Command: delete sflow analyzer_server 1...
Page 862
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide <ipv6addr> - Specifies the IPv6 used. collectorport - (Optional) Specify the destination port for sending sflow datagrams. <udp_port_number 1-65535> - Specify the destination port for sending sflow datagrams. The number is between 1 and 65535.
Page 863
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#show sflow analyzer_server Command: show sflow analyzer_server sFlow Analyzer_server Information ------------------------------ Server ID Owner : admin Timeout : 400 Current Countdown Time: 400 Collector Address Collector Port : 6343 Max Datagram Size : 1400 Total Entries: 1...
Page 864
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#create sflow counter_poller ports 1 analyzer_server_id 1 Command: create sflow counter_poller ports 1 analyzer_server_id 1 Success. DGS-3420-28SC:admin# 12-12 config sflow counter_poller ports Description This command is used to configure the sflow counter poller parameters. If a user wants to change the analyzer server ID, they need to delete the counter poller and create a new one.
Page 865
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format delete sflow counter_poller ports [<portlist> | all] Parameters <portlist> - Specify the ports to be deleted. all - Specify to delete all ports. Restrictions Only Administrator and Operator-level users can issue this command. Example To delete the sFlow counter poller for port 1: DGS-3420-28SC:admin#delete sflow counter_poller ports 1...
Page 866
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Port Analyzer Server ID Polling Interval (sec) ---- ------------------ ----------------------- Total Entries: 1 DGS-3420-28SC:admin# 12-15 show sflow flow_sampler Description This command is used to display sFlow sampler information for the ports that have been created. Format show sflow flow_sampler Parameters...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 13 Single IP Management Commands enable sim disable sim show sim {[candidates {<candidate_id 1-100>} | members {<member_id 1-32>} | group {commander_mac <macaddr>} | neighbor]} reconfig [member_id <value 1-32> | exit] config sim_group [add <candidate_id 1-100>...
Page 868
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 13-2 disable sim Description This command is used to configure the single IP management on the switch as disabled. Format disable sim Parameters None. Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To disable single IP management: DGS-3420-28SC:admin#disable sim...
Page 869
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide group – (Optional) Specify other group devices. commander_mac - Specify the commander MAC address. <macaddr> - Specify the commander MAC address. neighbor - (Optional) Specify other neighbor devices. Restrictions None.
Page 870
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide MAC Address Platform / Hold Firmware Device Name Capability Time Version --- ----------------- ------------------------ ----- --------- ---------------- 00-01-02-03-04-00 DGS-3420-28SC-DC L3 Switch 2.00.009 aaaaaaaaabbb 00-55-55-00-55-00 DGS-3420-28SC-DC L3 Switch 140 2.00.009 default master Total Entries: 2 DGS-3420-28SC:admin# To show other groups information in summary:...
Page 871
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 00-35-26-00-11-90 Candidate Total Entries: 3 DGS-3420-28SC:admin# 13-4 reconfig Description This command is used to re-Telnet to a member. Format reconfig [member_id <value 1-32> | exit] Parameters member_id - Specify the serial number of a member. <value 1-32>...
Page 872
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters add - Specify to add a specific candidate to the group. <candidate_id 1-100> - Specify to add a specific candidate to the group. <password> - (Optional) Specify the password of a candidate, if necessary. delete - Specify to remove a specific member from the group.
Page 873
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters commander - Transfer the role to commander. group_name - (Optional) If commander, users can specify the name of the group. <groupname 64> - If commander, users can specify the name of the group. The maximum length is 64 characters.
Page 874
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#config sim dp_interval 30 Command: config sim dp_interval 30 Success. DGS-3420-28SC:admin# To change the hold time of discovery protocol: DGS-3420-28SC:admin#config sim hold_time 200 Command: config sim hold_time 200 Success.
Page 875
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide This device is updating firmware. Please wait several minutes... Download Status : MAC Address Result ----------------- ---------------- 00-01-02-03-04-00 Success 00-07-06-05-04-03 Transfer Fail 00-07-06-05-04-04 Transfer Fail DGS-3420-28SC:admin# To download configuration: DGS-3420-28SC:admin#download sim_ms configuration_from_tftp 10.55.47.1 D:\test.txt members 1-3 Commands: download sim_ms configuration_from_tftp 10.55.47.1 D:\test.txt members 1-...
Page 876
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide <mslist> - Specifiy the members which upload its configuration.The value is from 1 to 32. all - Specify all members which upload its configuration. Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To upload a configuration: DGS-3420-28SC:admin#upload sim_ms configuration_to_tftp 10.55.47.1...
Page 878
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format disable smtp Parameters None. Restrictions Only Administrator-level users can issue this command. Example To disable SMTP status: DGS-3420-28SC:admin#disable smtp Command: disable smtp Success. DGS-3420-28SC:admin# 14-3 config smtp Description This command is used to configure SMTP settings.
Page 879
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator-level users can issue this command. Example To configure an SMTP server IP address: DGS-3420-28SC:admin# config smtp server 172.18.208.9 Command: config smtp server 172.18.208.9 Success. DGS-3420-28SC:admin# To configure an SMTP server port: DGS-3420-28SC:admin# config smtp server_port 25 Command: config smtp server_port 25...
Page 880
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide To delete a mail destination address: DGS-3420-28SC:admin# config smtp delete mail_receiver 2 Command: config smtp delete mail_receiver 2 Success. DGS-3420-28SC:admin# 14-4 show smtp Description This command is display the current SMTP information. Format show smtp Parameters...
Page 881
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#show smtp Command: show smtp SMTP Status : Disabled SMTP Server Address : 0.0.0.0 SMTP Server Port : 25 Self Mail Address Index Mail Receiver Address ----- --------------------------------------------------------------------- DGS-3420-28SC:admin# 14-5 smtp send_testmsg...
Page 882
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin# smtp send_testmsg Command: smtp send_testmsg Subject: This is a test of SMTP. Content: Hello, everybody! Sending mail, please wait! Success. DGS-3420-28SC:admin# Note: The sentences following “Subject:” and “Content:” are user inputs.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters <user_name 32> - Specify the name of the user on the host that connects to the agent. The range is 1 to 32 characters. <groupname 32> - Specify the name of the group to which the user is associated. The range is 1 to 32 characters.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format delete snmp user <user_name 32> Parameters <user_name 32> - Specify the name of the user on the host to be deleted. The range is 1 to 32 characters.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#show snmp user Command: show snmp user Username Group Name VerAuthPriv --------------------------- --------------------------- ------------ initial initial V3 NoneNone Total Entries : 1 DGS-3420-28SC:admin# 15-4 show snmp groups Description This command is used to display the names of groups on the switch, and the security model, level, and the status of the different views.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Group Name : public ReadView Name : CommunityView WriteView Name Notify View Name : CommunityView Security Model : SNMPv2 Security Level : NoAuthNoPriv Group Name : private ReadView Name : CommunityView WriteView Name : CommunityView...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin# 15-6 delete snmp view Description This command is used to remove a view record. Format delete snmp view <view_name 32> [all | <oid>] Parameters <view_name 32> - Specify the view name of the user who will be deleted. all - Specify to view all records.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide read_write - Specify read and write permission. Restrictions Only Administrator-level users can issue this command. Example To create an SNMP community string: DGS-3420-28SC:admin#create snmp community dlink view CommunityView read_write Command: create snmp community dlink view CommunityView read_write Success.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 15-10 show snmp community Description This command is used to display community string configurations. Format show snmp community {<community_string 32>} Parameters <community_string 32> - (Optional) Specify the community string to be displayed. Note: If a community string is not specified, all community string information will be displayed.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format create snmp community_masking view <view_name 32> [read_only | read_write] Parameters <view_name 32> - Enter the MIB view name used here. This name can be up to 32 characters long. read_only - Specifies that the user, using the community string, will have read only access to the switch’s SNMP agent.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To configure an identifier for the SNMP engine on the switch: DGS-3420-28SC:admin#config snmp engineID 1023457890 Command: config snmp engineID 1023457890 Success. DGS-3420-28SC:admin# 15-13 show snmp engineID Description This command is used to display the identification of the SNMP engine on the switch.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters <groupname 32> - Specify the name of the group that will be deleted. Restrictions Only Administrator-level users can issue this command. Example To remove an SNMP group: DGS-3420-28SC:admin#delete snmp group D_Link_group Command: delete snmp group D_Link_group Success.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To create a recipient of an SNMP operation: DGS-3420-28SC:admin#create snmp host 10.48.74.100 v3 noauth_nopriv initial Command: create snmp host 10.48.74.100 v3 noauth_nopriv initial Success. DGS-3420-28SC:admin# 15-17 delete snmp Description This command is used to delete a recipient of an SNMP trap operation.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format show snmp host {<ipaddr>} Parameters <ipaddr> - (Optional) Specify the IP address of the recipient for which the traps are targeted. Note: If no parameter is specified, all SNMP hosts will be displayed. Restrictions None.
Page 898
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions None. Example To display the recipient for which the traps are targeted: DGS-3420-28SC:admin# show snmp v6host Command: show snmp v6host SNMP Host Table ------------------------------------------------------------------- Host IPv6 Address: FFFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF SNMP Version : V3 na/np Community Name/SNMPv3 User Name: 123456789101234567890...
Page 899
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin# enable community_encryption Command: enable community_encryption Success. DGS-3420-28SC:admin# When creating an SNMP community string after the encryption state has been enabled, the community string will be displayed as an encrypted string (six "*"), otherwise displayed as plaintext, for example: DGS-3420-28SC:admin# show snmp community Command: show snmp community...
Page 900
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin# disable community_encryption Command: disable community_encryption Success. DGS-3420-28SC:admin# 15-22 show community_encryption Description This command is used to display the encryption state on the SNMP community string. Format show community_encryption Parameters None.
Page 901
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters None. Restrictions Only Administrator level users can issue this command. Example To enable SNMP response broadcast requests: DGS-3420-28SC:admin#enable snmp response_broadcast_request Command: enable snmp response_broadcast_request Success. DGS-3420-28SC:admin# 15-24 disable snmp response_broadcast_request Description This command is used to disable response broadcast requests.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To display STP: DGS-3420-28SC:admin#show stp Command: show stp STP Bridge Global Settings --------------------------- STP Status : Disabled STP Version : RSTP Max Age : 20 Hello Time Forward Delay : 15 Max Hops...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#show stp instance Command: show stp instance STP Instance Settings --------------------------- Instance Type : CIST Instance Status : Enabled Instance Priority : 32768(Bridge Priority : 32768, SYS ID Ext : 0 ) STP Instance Operational Status -------------------------------- Designated Root Bridge : 32768/00-22-22-22-22-00...
Page 906
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To show STP ports: DGS-3420-28SC:admin#show stp ports Command: show stp ports MSTP Port Information ---------------------- Port Index , Hello Time: 2 /2 , Port STP : Enabled External PathCost : Auto/200000 , Edge Port : False/No , P2P : Auto /Yes Port RestrictedRole : False,...
Page 907
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Configuration Name : 00-22-22-22-22-00 Revision Level :0 MSTI ID Vid list ------- ----------- CIST 1-4094 DGS-3420-28SC:admin# 16-5 create stp instance_id Description This command is used to create a new MST instance independent from the default Instance: CIST (Instance 0).
Page 908
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format delete stp instance_id <value 1-64> Parameters <value 1-64> - Specify the MSTP instance ID. Instance 0 represents the default instance CIST. This value must be between 1 and 64. Restrictions Only Administrator, Operator and Power-User level users can issue this command.
Page 909
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To map a VLAN ID to an MSTP instance: DGS-3420-28SC:admin#config stp instance_id 2 add_vlan 1 Command: config stp instance_id 2 add_vlan 1 Success. DGS-3420-28SC:admin# To remove a VLAN ID from an MSTP instance: DGS-3420-28SC:admin#config stp instance_id 2 remove_vlan 2 Command: config stp instance_id 2 remove_vlan 2 Success.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Success. DGS-3420-28SC:admin# 16-9 enable stp Description Although it is possible to modify to allow a user to enable STP per instance, CIST should be enabled first before enabling other instances. When a user enables the CIST, all MSTIs will be enabled automatically if FORCE_VERSION is set to MSTP and there is at least one VLAN mapped to this instance.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters None. Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To disable STP: DGS-3420-28SC:admin#disable stp Command: disable stp Success. DGS-3420-28SC:admin# 16-11 config stp version Description This command is used to enable STP globally.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin# To configure the STP version with the same value of the old configuration: DGS-3420-28SC:admin#config stp version mstp Command: config stp version mstp Configure value is the same with current value. Success.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To enable an SSH server public key algorithm: DGS-3420-28SC:admin#config ssh algorithm DSA enable Command: config ssh algorithm DSA enable Success.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 17-4 show ssh authmode Description This command is used to display the user authentication methods. Format show ssh authmode Parameters None. Restrictions None. Example To display the SSH user authentication method: DGS-3420-28SC:admin#show ssh authmode Command: show ssh authmode The SSH Authentication Method:...
Page 921
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide hostname - Specify the host domain name. <domain_name 32> - Specify the host domain name. The hostname value can be up to 32 characters long. hostname_IP - Specify the host domain name and IP address. <domain_name 32>...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#show ssh user authmode Command: show ssh user authmode Current Accounts: User Name Authentication Host Name Host IP --------------- --------- -------------------------------- --------------- dlink Host-based dlink.com 192.168.69.1 dlink2 Host-based dlink.com dlink3 Password...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To configure an SSH server maximum session of 3: DGS-3420-28SC:admin#config ssh server maxsession 3 Command: config ssh server maxsession 3 Success. DGS-3420-28SC:admin# 17-8 enable ssh Description This command is used to enable SSH server services. Format enable ssh Parameters...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters None. Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To disable SSH: DGS-3420-28SC:admin#disable ssh Command: disable ssh Success. DGS-3420-28SC:admin# 17-10 show ssh server Description This command is used to display SSH server general information.
Page 925
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Authentication Fail Attempts : 2 Rekey Timeout : Never TCP Port Number : 22 Bypass Login Screen State : Disabled DGS-3420-28SC:admin# 17-11 config ssh publickey bypass_login_screen state Description This command is used to enable or disable bypassing login screen which is used to avoid a secondary username/password authentication for users using SSH public key authentication.
Page 926
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 17-12 download ssh client_pub_key Description This command is used to download the SSH public key file on client computer to the switch through TFTP protocol. Format download ssh client_pub_key [<ipaddr> | <ipv6addr> | <domain_name 255>] src_file <path_filename 64>...
Page 927
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters <ipaddr> - Specify the IPv4 address of the TFTP server. <ipv6addr> - Specify the IPv6 address of the TFTP server. <domain_name 255> - Enter the domain name of the TFTP server. This name can be up to 255 characters long.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin# To enable SSL: DGS-3420-28SC:admin# enable ssl Command: enable ssl Note: Web will be disabled if SSL is enabled. Success. DGS-3420-28SC:admin# 18-3 disable ssl Description This command is used to disable the SSL feature and supported ciphersuites. Format disable ssl {ciphersuite {RSA_with_RC4_128_MD5 | RSA_with_3DES_EDE_CBC_SHA | DHE_DSS_with_3DES_EDE_CBC_SHA | RSA_EXPORT_with_RC4_40_MD5}(1)}...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide To disable the SSL feature: DGS-3420-28SC:admin# disable ssl Command: disable ssl Success. DGS-3420-28SC:admin# 18-4 show ssl Description This command is used to display the current SSL status and supported ciphersuites. Format show ssl {certificate {[chain | <path_filename 64>]}} Parameters...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#show ssl certificate Command: show ssl certificate Cert1.cer Cert2.cer Cert3.cer DGS-3420-28SC:admin# 18-5 show ssl cachetimeout Description This command is used to display the cache timeout value which is designed for a dlktimer library to remove the session ID after it has expired.
Page 933
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide session ID by the cache timeout value. The unit of argument’s value is second and its boundary is between 60 (1 minute) and 86400 (24 hours). The default value is 600 seconds. Format config ssl cachetimeout <value 60-86400>...
Page 934
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To configure SSL chain of certifications DGS-3420-28SC:admin#config ssl certificate chain web_ca2.cer,server.crt Command: config ssl certificate chain web_ca2.cer,server.crt Success. DGS-3420-28SC:admin# 18-8 delete ssl certificate Description This command is used to delete a certification on the Switch. Format delete ssl certificate <path_filename 64>...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 19 Stacking Commands config stacking_mode [disable | enable] config stacking force_master_role state [enable | disable] show stacking_mode show stack_information show stack_device config box_id current_box_id <value 1-12> new_box_id [auto | <value 1-12>] config box_priority current_box_id <value 1-12>...
Page 936
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 19-2 config stacking force_master_role state Description This command is used to configure stacking force master role state. If state is enabled, when device is in election state, it still uses old priority setting and MAC to compare device priority. After stacking is stable, master’s priority will become zero.
Page 937
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To display stacking mode: DGS-3420-28SC:admin# show stacking_mode Command: show stacking_mode Stacking mode : Enabled DGS-3420-28SC:admin# 19-4 show stack_information Description...
Page 938
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Box User Prio- Prom Runtime Type Exist rity version version version --- ---- ----------------- ----- --- ----------------- -------- --------- ------ Auto DGS-3420-28SC Exist 32 00-01-02-03-04-00 1.00.003 1.50.010 B1 NOT_EXIST NOT_EXIST NOT_EXIST...
Page 939
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin# show stack_device Command: show stack_device Box ID Box Type H/W Version Serial Number ------- --------------- ------------ ---------------- DGS-3420-28SC D1234567890 DGS-3420-28SC D1234567891 DGS-3420-28SC:admin# 19-6 config box_id current_box_id Description This command configures the box ID.
Page 940
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 19-7 config box_priority current_box_id Description This command configures the priority of switch, which will determines which box becomes master. Lower number means higher priority. New priority will take effect after user reboot Format config box_priority current_box_id <value 1-12>...
Page 941
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To enable the stacking log state: DGS-3420-28SC:admin#config stacking log state enable Command: config stacking log state enable Success.
Page 943
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin# 20-2 delete mac_based_vlan Description This command is used to delete static MAC-based VLAN entries. Format delete mac_based_vlan {mac_address <macaddr> [vlan <vlan_name 32>| vlanid <vlanid 1- 4094>]} Parameters mac_address - (Optional) Specify the MAC address to be deleted.
Page 944
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format show mac_based_vlan {mac_address <macaddr> | [vlan <vlan_name 32> | vlanid <vlanid 1- 4094>]} Parameters mac_address - (Optional) Specify the MAC address to be displayed. <macaddr> - Specify the MAC address to be displayed. vlan - (Optional) Specify the VLAN associated with the MAC address.
Page 946
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#create ipmc_vlan_replication_entry mr1 Command: create ipmc_vlan_replication_entry mr1 Success. DGS-3420-28SC:admin# 21-2 config ipmc_vlan_replication Description This command is used to configure the IP multicast VLAN replication global settings. Generally, when a multicast packet is forwarded across VLANs, the TTL will be decreased by one.
Page 947
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 21-3 config ipmc_vlan_replication_entry destination Description For the traffic that matches an IPMC VLAN replication entry, it will be replicated based on the destination setting. Multiple destination entries can be defined for an IPMC VLAN replication entry. Each destination entry specifies the VLAN and the outgoing port on which the traffic will be replicated.
Page 948
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide entry. Therefore, the resource entry consumed by a replication entry is not constant and it will be determined by the number of (V, G, S) pairs defined by the entry. If the entry (V, G, S) exists in two replication entries, both will take effect.
Page 949
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters <name 16> - Specify the name of the IP multicast VLAN replication entry to be deleted. Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To delete an IP multicast VLAN replication entry named mr1: DGS-3420-28SC:admin#delete ipmc_vlan_replication_entry mr1...
Page 950
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 21-7 disable ipmc_vlan_replication Description This command is used to disable static configuration of IP multicast VLAN replication. Format disable ipmc_vlan_replication Parameters None. Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To disable static configuration of IP multicast VLAN replication: DGS-3420-28SC:admin#disable ipmc_vlan_replication...
Page 951
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To display the static IP multicast VLAN replication global setting: DGS-3420-28SC:admin#show ipmc_vlan_replication Command: show ipmc_vlan_replication IP Multicast VLAN Replication State : Disabled : No Decrease Source MAC Address : Replace DGS-3420-28SC:admin# 21-9...
Page 952
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin# show ipmc_vlan_replication_entry hardware Command: show ipmc_vlan_replication_entry hardware Name : ipmc_vlan_replication_entry name Src-v : The source VLAN Dest-v : The destination VLAN Name Src_v Group Dest_v Portlist ----------------- ----- --------------- ----------------- ----- ------------- 255.1.1.1 1-11, 13 255.1.1.1...
Page 955
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To delete a subnet VLAN entry: DGS-3420-28SC:admin#delete subnet_vlan network 172.168.1.1/24 Command: delete subnet_vlan network 172.168.1.1/24 Success. DGS-3420-28SC:admin# To delete all subnet VLAN entries: DGS-3420-28SC:admin#delete subnet_vlan all Command: delete subnet_vlan all Success.
Page 956
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To display a specified subnet VLAN entry: DGS-3420-28SC:admin#show subnet_vlan network 172.168.1.1/24 Command: show subnet_vlan network 172.168.1.1/24 IP Address/Subnet Mask VLAN Priority ------------------------ ----- ---------- 172.168.1.1/255.255.255.0 DGS-3420-28SC:admin# To display a specied IPv6 subnet VLAN entry: DGS-3420-28SC:admin# show subnet_vlan ipv6network fe80:250:baff::0/64 Command: show subnet_vlan ipv6network fe80:250:baff::0/64 IP Address/Subnet Mask...
Page 957
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide If a port’s VLAN classification is subnet VLAN precedence, the subnet VLAN classification will process at first. If subnet VLAN classification fails, the MAC-based VLAN classification will be executed. Format config vlan_precedence ports <portlist>...
Page 958
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To display VLAN classification precedence on ports 1-5: DGS-3420-28SC:admin#show vlan_precedence ports 1:1-1:5 Command: show vlan_precedence ports 1:1-1:5 Port VLAN Precedence ---- ----------------- MAC-Based VLAN Subnet VLAN MAC-Based VLAN MAC-Based VLAN Subnet VLAN DGS-3420-28SC:admin#...
Page 960
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide restart_an - Specifies to restart the auto-negotiation process. remote_fault_advertised - Specifies that the remote fault advertisement option will be configured. disable - Specifies to disable remote fault advertisement. offline - Specifies that a local device may indicate Offline prior to powering off, running transmitter tests, or removing the local device from the active configuration.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin# 23-2 show ports Description This command is used to display the current configurations of a range of ports. Format show ports {<portlist>} {[description | err_disabled | auto_negotiation | details | media_type]} Parameters <portlist>...
Page 962
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Enabled Auto/Disabled Link Down Enabled Auto CTRL+C ESC q Quit SPACE n Next Page Previous Page Refresh To display the description information of ports 1 to 4: DGS-3420-28SC:admin# show ports 1-4 description Command: show ports 1:1-1:4 description Port State/...
Page 964
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin# 24-2 show system_severity Description This command is used to show the severity level control for a system. Format show system_severity Parameters None. Restrictions None. Example To show the severity level control for a system: DGS-3420-28SC:admin#show system_severity Command: show system_severity System Severity Trap : information(6)
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 25 Tech Support Commands show tech_support upload tech_support_toTFTP <ipaddr> <path_filename 64> 25-1 show tech_support Description This command is used to display technical support information. It is especially useful for technical support personnel that need to view the overall device operation information.
Page 966
DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Firmware: Build 1.50.010 Copyright(C) 2011 D-Link Corporation. All rights reserved. #----------------------------------------------------------------------------- ******************** Basic System Information ******************** [SYS 2000-2-29 22:41:48] Boot Time : 29 Feb 2000 17:54:29 RTC Time...
Page 967
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator and Operator-level users can issue this command. Example To upload technical support information: DGS-3420-28SC:admin#upload tech_support_toTFTP 10.0.0.66 tech_suppport.txt Command: upload tech_support_toTFTP 10.0.0.66 tech_suppport.txt Connecting to server....Done. Upload techsupport file....
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#config sntp primary 10.1.1.1 secondary 10.1.1.2 poll-interval Command: config sntp primary 10.1.1.1 secondary 10.1.1.2 poll-interval 30 Success. DGS-3420-28SC:admin# 26-2 config sntp ipv6server Description This command is used to configure the SNTP IPv6 server information. Note: If both SNTP IPv4 and IPv6 servers are configured, the SNTP IPv4 server has higher priority, the Switch’s time syncs with the IPv4 server’s time first.
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format show sntp Parameters None. Restrictions None. Example To show SNTP: DGS-3420-28SC:admin#show sntp Command: show sntp Current Time Source : System Clock SNTP Status : Disabled IPv4 Primary SNTP Server : None IPv4 Secondary SNTP Server: None IPv6 Primary SNTP Server...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To enable SNTP: DGS-3420-28SC:admin#enable sntp Command: enable sntp Success. DGS-3420-28SC:admin# 26-5 disable sntp Description This command is used to turn off SNTP support. Format disable sntp Parameters None.
Page 972
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters <date ddmthyyyy> - Specify the system clock date. <time hh:mm:ss> - Specify the system clock time. Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To configure time: DGS-3420-28SC:admin# config time 30jun2003 16:30:30...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide <start_date 1-31> - Configure the start date number of DST. The values are 1 to 31. s_mth - Configure the start month number of DST. <start_mth 1-12> - Configure the start month number of DST. The values are 1 to 12. s_time - Configure the start time of DST.
Page 975
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions None. Example To show time: DGS-3420-28SC:admin#show time Command: show time Current Time Source : System Clock Boot Time : 8 Jan 2000 21:44:33 Current Time : 9 Jan 2000 03:25:17 Time Zone : GMT +00:00...
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 27 Traffic Segmentation Commands config traffic_segmentation [<portlist> | all] forward_list [null | all | <portlist>] show traffic_segmentation {<portlist>} 27-1 config traffic_segmentation Description This command is used to configure traffic segmentation. Format config traffic_segmentation [<portlist>...
Page 977
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format show traffic_segmentation {<portlist>} Parameters <portlist> - (Optional) Specify a range of ports to be displayed. Note: If no parameter is specified, the system will display all current traffic segmentation tables.
Page 979
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 28-2 disable udp_helper Description This command is used to disable the UDP Helper function on the Switch. Format disable udp_helper Parameters None. Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To disable the UDP Helper function: DGS-3420-28SC:admin# disable udp_helper...
Page 980
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To add a server address for System interface: DGS-3420-28SC:admin# config udp_helper add ipif System 20.0.0.90 Command: config udp_helper add ipif System 20.0.0.90 Success. DGS-3420-28SC:admin# 28-4 config udp_helper delete ipif Description This command is used to delete a UDP Helper server address for specific interface of Switch.
Page 981
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format config udp_helper udp_port add [time | tacacs | dns | tftp | netbios-ns | netbios-ds | <port_number 0-65535>] Parameters time - Specifies the Time service. The UDP port number is 37. tacacs - Specifies the Terminal Access Controller Access Control System service.
Page 982
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide dns - Specifies the Domain Naming System service. The UDP port number is 53. tftp - Specifies the Trivial File Transfer Protocol service. The UDP port number is 69. netbios-ns - Specifies the NetBIOS Name Server service.
Page 983
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin# show udp_helper Command: show udp_helper UDP Helper Status : Enabled Application UDP Port ------------ --------------- User App1 Interface Server ------------ --------------- System 20.0.0.90 DGS-3420-28SC:admin# To display the current UDP Helper all configured ports: DGS-3420-28SC:admin#show udp_helper udp_port Command: show udp_helper udp_port UDP Helper Status...
Page 985
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide enable broadcast_ping_reply disable broadcast_ping_reply show broadcast_ping_reply config tftp source_ipif [<ipif_name 12> {<ipaddr> | <ipv6addr>} | none] show tftp source_ipif 29-1 download Description This command is used to download a new firmware or a switch configuration file. Format download [firmware_fromTFTP [<ipaddr>...
Page 986
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide all - Specifies that all the units in the stacking system will be used. increment - If increment is specified, then the existing configuration will not be cleared before applying of the new configuration.
Page 987
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide <string 128> - Syntax: rcp: username@ipaddr/directory/filename. Example for full path: user_name@10.1.1.1/home/user_name/desxxxx.had; Example for relative path: user_name@10.1.1.1./desxxxx.had. Example for omitted user name in RCP string: 10.1.1.1./desxxxx.had. Note: No spaces in the whole <string>. unit - Specifies which unit on the stacking system.
Page 988
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 10.1.1.1./desxxxx.had. Note: No spaces are allowed in the <string>. <string 128> - Syntax: rcp: username@ipaddr/directory/filename. Example for full path: user_name@10.1.1.1/home/user_name/desxxxx.had; Example for relative path: user_name@10.1.1.1./desxxxx.had; Example for omitted user name in RCP string: 10.1.1.1./desxxxx.had.
Page 989
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters cfg_toTFTP - Used to upload a configuration file from a device to a TFTP server. <ipaddr> - Specify the IP address of the TFTP server. <ipv6addr> - Specify the IPv6 address of the TFTP server. <domain_name 255>...
Page 990
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide src_file - (Optional) Specify an absolute path name on the device file system. If the path name is not specified, it refers to the boot up image. <pathname> - Specify an absolute path name on the device file system. If the path name is not specified, it refers to the boot up image.
Page 991
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Success. DGS-3420-28SC:admin# 29-5 upload attack_log_toRCP Description This command is used to upload the attack log file from the device to an RCP server. Note: If a user specifies the relative file path, the path search strategy will depend on the server system.
Page 992
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Success. DGS-3420-28SC:admin# 29-6 upload cfg_toRCP Description This command is used to upload a configuration file from the device to a Remote Copy Protocol (RCP) server. Format upload cfg_toRCP [{username <username>} {<ipaddr>} dest_file <path_filename 64> | rcp: <string 128>] {unit <unit_id 1-12>} {src_file <pathname>} {[include | exclude | begin] <filter_string 80>...
Page 993
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To upload the current configuration from the device to an RCP server: DGS-3420-28SC:admin#upload cfg_toRCP username rcp_user 10.48.74.121 dest_file /home/DGS-3420.cfg Command: upload cfg_toRCP username rcp_user 10.48.74.121 dest_file /home/DGS- 3420.cfg Connecting to server...
Page 994
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator and Operator-level users can issue this command. Example To upload firmware image to an RCP server: DGS-3420-28SC:admin#upload firmware_toRCP rcp: rcp_user@172.18.212.106/DGS-3420.had src_file 2.00.009.had Command: upload firmware_toRCP rcp: rcp_user@172.18.212.106/DGS-3420.had src_file 2.00.009.had Connecting to server....
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Command: config firmware image 2.00.009.had boot_up Success. DGS-3420-28SC:admin# 29-10 config configuration Description This command is used to select a configuration file as the next boot up configuration or to apply a specific configuration to the system.
Page 997
<filter_string 80> - Specify a filter string enclosed by the quotation mark symbol. Restrictions Only Administrator-level users can issue this command. Example To display configuration information: DGS-3420-28SC:admin#show config current_config Command: show config current_config #----------------------------------------------------------------------------- DGS-3420-28SC Gigabit Ethernet Switch Configuration Firmware: Build 1.50.010 Copyright(C) 2011 D-Link Corporation. All rights reserved. #-----------------------------------------------------------------------------...
Page 998
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide # STACK config stacking force_master_role state disable # DEVICE config temperature threshold high 79 config temperature threshold low 11 config temperature trap state enable config temperature log state enable CTRL+C ESC q Quit SPACE n...
Page 999
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 29-13 config rcp server Description This command is used to configure Remote Copy Protocol (RCP) global server information. This global RCP server setting can be used when the server or remote user name is not specified. Only one RCP server can be configured for each system.
Page 1000
xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters ipaddr - Clear the IP address of the RCP server. username - Clear the username of the RCP server. both - Clear both the IP address and the username of the RCP server. Restrictions Only Administrator-level users can issue this command.