D-Link xStack DGS-3420 Series Reference Manual

D-Link xStack DGS-3420 Series Reference Manual

Layer 2 managed stackable gigabit switch cli
Hide thumbs Also See for xStack DGS-3420 Series:
Table of Contents

Advertisement

Quick Links

xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide
I

Advertisement

Table of Contents
loading

Summary of Contents for D-Link xStack DGS-3420 Series

  • Page 1 xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide...
  • Page 2: Table Of Contents

    Domain Name System (DNS) Relay Commands ............374 Chapter 28 Domain Name System (DNS) Resolver Commands ..........379 Chapter 29 DoS Attack Prevention Commands................386 Chapter 30 D-Link Unidirectional Link Detection (DULD) Commands .......... 391 Chapter 31 Energy Efficient Ethernet (EEE) Commands .............. 394...
  • Page 3 xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 32 Ethernet Ring Protection Switching (ERPS) Commands ..........396 Chapter 33 External Alarm Commands ..................406 Chapter 34 FDB Commands ......................408 Chapter 35 File System Management Commands ................ 417 Chapter 36 Filter Commands ......................
  • Page 4 xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 66 Password Recovery Commands ................. 743 Chapter 67 Policy Route Commands ..................... 746 Chapter 68 Port Security Commands .................... 750 Chapter 69 Power over Ethernet (PoE) Commands ..............759 Chapter 70 Power Saving Commands ...................
  • Page 5 xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 32 VLAN Commands...................... 1023 Chapter 33 VLAN Trunking Commands ..................1041 Chapter 34 Web-based Access Control (WAC) Commands ............1046 Chapter 35 Weighted Random Early Detection (WRED) Commands ......... 1061 Appendix A Password Recovery Procedure .................
  • Page 6: Chapter 1 Using Command Line Interface

    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...
  • Page 7: Setting The Switch's Ip Address

    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...
  • Page 11: Command Syntax Symbols

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide jwac l2protocol_tunnel lacp_port limited_multicast_addr link_aggregation lldp lldp_med log_save_timing log_software_module loopback loopdetect mac_based_access_control mac_based_access_control_local mac_based_vlan mac_notification max_mcast_group mcast_filter_profile mirror mld_proxy mld_snooping multicast multicast_fdb name_server out_band_ipif packet password_recovery per_queue policy_route port port_group port_security...
  • Page 12: Line Editing Keys

    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 14: Chapter 2 Basic Management Commands

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 2 Basic Management Commands create account [admin | operator | power_user | user] <username 15> {encrypt [plain_text | sha_1] <password>} enable password encryption disable password encryption config account <username 15> {encrypt [plain_text | sha_1] <password>} show account delete account <username 15>...
  • 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.
  • Page 16: Enable Password Encryption

    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.
  • Page 17: Config Account

    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...
  • Page 18: Show Account

    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.
  • Page 19: Delete Account

    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>...
  • Page 20: Show Switch

    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...
  • Page 21: Show Environment

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#show switch Command: show switch Device Type : DGS-3420-28SC Gigabit Ethernet Switch MAC Address : 00-01-02-03-04-00 IP Address : 10.90.90.90 (Manual) VLAN Name : default Subnet Mask : 255.0.0.0 Default Gateway : 0.0.0.0 Boot PROM Version...
  • Page 22: Config Temperature

    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...
  • Page 23: Config Temperature Threshold

    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.
  • Page 25: Enable Clipaging

    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)
  • Page 26: Disable Clipaging

    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.
  • Page 27: Enable Telnet

    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...
  • Page 28: Enable Web

    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.
  • Page 29: Disable Web

    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.
  • Page 34: Config Terminal Width

    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...
  • Page 35: Show Terminal Width

    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”.
  • Page 37: Chapter 3 802.1X Commands

    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.
  • Page 52: Config Radius Add

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To display guest VLAN information: DGS-3420-28SC:admin#show 802.1x guest_vlan Command: show 802.1x guest_vlan Guest Vlan Setting ----------------------------------------------------------- Guest vlan : guest Enable guest vlan ports : 1-10 DGS-3420-28SC:admin# 3-20 config radius add Description...
  • Page 53: Config Radius Delete

    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 new RADIUS server: DGS-3420-28SC:admin#config radius add 1 10.48.74.121 key dlink default Command: config radius add 1 10.48.74.121 key dlink default Success.
  • Page 54: Config Radius

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 3-22 config radius Description This command is used to configure a RADIUS server. Format config radius <server_index 1-3> {ipaddress [<server_ip> | <ipv6addr>] | [key <password 32> | encryption_key <password 56>] | auth_port [<udp_port_number 1-65535> | default] | acct_port [<udp_port_number 1-65535>...
  • Page 55: Show Radius

    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 60 0.0.0.0 radiusAuthClientServerPortNumber radiusAuthClientRoundTripTime radiusAuthClientAccessRequests radiusAuthClientAccessRetransmissions radiusAuthClientAccessAccepts radiusAuthClientAccessRejects radiusAuthClientAccessChallenges radiusAuthClientMalformedAccessResponses 0 radiusAuthClientBadAuthenticators radiusAuthClientPendingRequests radiusAuthClientTimeouts radiusAuthClientUnknownTypes radiusAuthClientPacketsDropped radiusAuthClient ==> radiusAuthClientInvalidServerAddresses radiusAuthClientIdentifier D-Link radiusAuthServerEntry ==> radiusAuthServerIndex :3 radiusAuthServerAddress 0.0.0.0 radiusAuthClientServerPortNumber radiusAuthClientRoundTripTime radiusAuthClientAccessRequests radiusAuthClientAccessRetransmissions radiusAuthClientAccessAccepts radiusAuthClientAccessRejects radiusAuthClientAccessChallenges radiusAuthClientMalformedAccessResponses 0 radiusAuthClientBadAuthenticators radiusAuthClientPendingRequests radiusAuthClientTimeouts radiusAuthClientUnknownTypes radiusAuthClientPacketsDropped...
  • Page 61 Format show acct_client Parameters None. Restrictions None. Example To display account client information: DGS-3420-28SC:admin# show acct_client Command: show acct_client radiusAcctClient ==> radiusAcctClientInvalidServerAddresses radiusAcctClientIdentifier D-Link radiusAuthServerEntry ==> radiusAccServerIndex : 1 radiusAccServerAddress 0.0.0.0 radiusAccClientServerPortNumber radiusAccClientRoundTripTime radiusAccClientRequests radiusAccClientRetransmissions radiusAccClientResponses radiusAccClientMalformedResponses radiusAccClientBadAuthenticators radiusAccClientPendingRequests radiusAccClientTimeouts...
  • Page 62 DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide radiusAccServerAddress 0.0.0.0 radiusAccClientServerPortNumber radiusAccClientRoundTripTime radiusAccClientRequests radiusAccClientRetransmissions radiusAccClientResponses radiusAccClientMalformedResponses radiusAccClientBadAuthenticators radiusAccClientPendingRequests radiusAccClientTimeouts radiusAccClientUnknownTypes radiusAccClientPacketsDropped radiusAcctClient ==> radiusAcctClientInvalidServerAddresses radiusAcctClientIdentifier D-Link radiusAuthServerEntry ==> radiusAccServerIndex : 3 radiusAccServerAddress 0.0.0.0 radiusAccClientServerPortNumber radiusAccClientRoundTripTime radiusAccClientRequests radiusAccClientRetransmissions radiusAccClientResponses radiusAccClientMalformedResponses radiusAccClientBadAuthenticators radiusAccClientPendingRequests radiusAccClientTimeouts radiusAccClientUnknownTypes radiusAccClientPacketsDropped DGS-3420-28SC:admin#...
  • Page 63: Chapter 4 Access Authentication Control (Aac) Commands

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 4 Access Authentication Control (AAC) Commands enable authen_policy disable authen_policy show authen_policy enable authen_policy_encryption disable authen_policy_encryption create authen_login method_list_name <string 15> config authen_login [default | method_list_name <string 15>] method {tacacs | xtacacs | tacacs+ | radius | server_group <string 15>...
  • Page 64 xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide show aaa server_group {<string 15>} show aaa server_host enable aaa_server_password_encryption disable aaa_server_password_encryption create radius server_host <ipaddr> {auth_port <int 1-65535> | acct_port <int 1-65535> | [key [<key_string 254> | none] | encryption_key <key_string 344>] | timeout <int 1-255> | retransmit <int 1-20>} config radius server_host <ipaddr>...
  • 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.
  • Page 75: Config Authen Application

    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 76: Show Authen Application

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format config authen application [console | telnet | ssh | http | all] [login | enable] [default | method_list_name <string 15>] Parameters console - Specify an application: console. telnet - Specify an application: Telnet.
  • 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.
  • Page 84: Config Authen Parameter Attempt

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#show authen server_host Command: show authen server_host IP Address Protocol Port Timeout Retransmit --------------- -------- ----- ------- ---------- ----------------------- 10.1.1.222 TACACS+ 15555 ------ Total Entries : 1 DGS-3420-28SC:admin# 4-24 config authen parameter response_timeout Description...
  • Page 85: Show Authen Parameter

    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.
  • Page 86: Enable Admin

    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.
  • Page 90: Show Aaa

    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.
  • Page 104: Config Accounting Service

    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.
  • Page 107: Show Accounting

    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.
  • Page 108: Show Accounting Service

    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 109: Chapter 5 Access Control List (Acl) Commands

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 5 Access Control List (ACL) Commands create access_profile profile_id <value 1-6> profile_name <name 1-32> [ethernet {vlan {<hex 0x0- 0x0fff>} | source_mac <macmask 000000000000-ffffffffffff> | destination_mac <macmask 000000000000-ffffffffffff> | 802.1p | ethernet_type}(1) | ip {vlan {<hex 0x0-0x0fff>} | source_ip_mask <netmask>...
  • Page 110 xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 0x0-0xffff> | flag_mask [all | {urg | ack | psh | rst | syn | fin}]} | udp {src_port_mask <hex 0x0-0xffff> | dst_port_mask <hex 0x0-0xffff>} | protocol_id_mask <hex 0x0-0xff> {user_define_mask <hex 0x0-0xffffffff>}]}(1) | packet_content_mask {offset_0-15 <hex 0x0-0xffffffff>...
  • Page 111 xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 000000000000-ffffffffffff> | 802.1p | ethernet_type}(1) | ip {vlan {<hex 0x0-0x0fff>} | source_ip_mask <netmask> | destination_ip_mask <netmask> | dscp | [icmp {type | code} | igmp {type} | tcp {src_port_mask <hex 0x0-0xffff> | dst_port_mask <hex 0x0-0xffff> | flag_mask [all | {urg | ack | psh | rst | syn | fin}]} | udp {src_port_mask <hex 0x0-0xffff>...
  • Page 112 xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide udp - Specify that the rule applies to UDP traffic. src_port_mask - (Optional) Specify the TCP source port mask. <hex 0x0-0xffff> - Specify the TCP source port mask. dst_port_mask - (Optional) Specify the TCP destination port mask.
  • Page 113 xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To create access list profiles: DGS-3420-28SC:admin#create access_profile profile_id 1 profile_name 1 ethernet vlan source_mac FF-FF-FF-FF-FF-FF destination_mac 00-00-00-FF-FF-FF 802.1p ethernet_type Command: create access_profile profile_id 1 profile_name 1 ethernet vlan source_mac FF-FF-FF-FF-FF-FF destination_mac 00-00-00-FF-FF-FF 802.1p ethernet_type Success.
  • 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 120 xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Source Port: 210 Mask : 0x0FFF Action: Mirror =================================================================================== Profile ID: 2 Profile Name: IMPBv4 Mask Source MAC : FF-FF-FF-FF-FF-FF Source IP : 255.255.255.255 Consumed HW Entries: 2 ---------------------------------------------------------------------------------- Rule ID : 1 Ports: 1...
  • 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 125 xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format create cpu access_profile profile_id <value 1-5> [ethernet {vlan | source_mac <macmask 000000000000-ffffffffffff> | destination_mac <macmask 000000000000-ffffffffffff> | 802.1p | ethernet_type}(1) | ip {vlan | source_ip_mask <netmask> | destination_ip_mask <netmask> | dscp | [icmp {type | code} | igmp {type} | tcp {src_port_mask <hex 0x0-0xffff>...
  • 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 135 xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide <value 0-63>] {counter [enable | disable]}} exceed [permit {replace_dscp <value 0-63>} | drop] {counter [enable | disable]} violate [permit {replace_dscp <value 0-63>} | drop] {counter [enable | disable]} | sr_tcm cir <value 0-1048576> cbs <value 0-131072> ebs <value 0-131072> {[color_blind | color_aware]} {conform [permit | replace_dscp <value 0-63>] {counter [enable | disable]}} exceed [permit {replace_dscp <value 0-63>} | drop] {counter [enable | disable]} violate [permit {replace_dscp <value 0-63>} | drop] {counter [enable | disable]} | delete]...
  • 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 139: Chapter 6 Access Control List (Acl) Egress Command List

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 6 Access Control List (ACL) Egress Command List create egress_access_profile profile_id <value 1-4> profile_name <name 1-32> [ethernet {vlan {<hex 0x0-0x0fff>} | source_mac <macmask 000000000000-ffffffffffff> | destination_mac <macmask 000000000000-ffffffffffff> | 802.1p | ethernet_type} | ip {vlan {<hex 0x0-0x0fff>} | source_ip_mask <netmask>...
  • 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 143 xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format config egress_access_profile [profile_id <value 1-4> | profile_name <name 1-32>] [add access_id [auto_assign | <value 1-128>] [ethernet {[vlan <vlan_name 32> | vlan_id <vlanid 1- 4094>] {mask <hex 0x0-0x0fff>} | source_mac <macaddr> {mask <macmask>} | destination_mac <macaddr>...
  • 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 147 xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin# config egress_access_profile profile_id 2 add access_id auto_assign ip source_ip 10.0.0.1 dscp 25 destination_ip 10.90.90.90 port_group id 1 permit Command: config egress_access_profile profile_id 2 add access_id auto_assign ip source_ip 10.0.0.1 dscp 25 destination_ip 10.90.90.90 port_group id 1 permit Success.
  • 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 151 xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format config egress_flow_meter [profile_id <value 1-4> | profile_name <name 1-32>] access_id <value 1-128> [rate <value 0-1048576> {burst_size <value 0-131072>} rate_exceed [drop_packet | remark_dscp <value 0-63>] | tr_tcm cir <value 0-1048576> {cbs <value 0-131072>} pir <value 0- 1048576>...
  • 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>...
  • Page 158: Chapter 7 Arp Commands

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 7 ARP Commands create arpentry <ipaddr> <macaddr> delete arpentry [<ipaddr> | all] config arpentry <ipaddr> <macaddr> config arp_aging time <min 0-65535> show arpentry {ipif <ipif_name 12> | ipaddress <ipaddr> | static | mac_address <macaddr>} clear arptable show ipfdb {[ip_address <ipaddr>...
  • Page 159: Delete Arpentry

    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.
  • Page 161: Show Arpentry

    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.
  • Page 162: Clear Arptable

    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#...
  • Page 164: Chapter 8 Arp Spoofing Prevention Commands

    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...
  • Page 166: Chapter 9 Asymmetric Vlan Commands

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 9 Asymmetric VLAN Commands enable asymmetric_vlan disable asymmetric_vlan show asymmetric_vlan enable asymmetric_vlan Description This command is used to enable the asymmetric VLAN function. Format enable asymmetric_vlan Parameters None.
  • Page 167 xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format disable asymmetric_vlan Parameters None. Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To disable asymmetric VLAN setting: DGS-3420-28SC:admin# disable asymmetric_vlan Command: disable asymmetric_vlan Success.
  • Page 168 xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin# show asymmetric_vlan Command: show asymmetric_vlan Asymmetric Vlan : Disabled DGS-3420-28SC:admin#...
  • Page 169: Chapter 10 Auto Configuration Commands

    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...
  • Page 170: Disable Autoconfig

    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 171 xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#disable autoconfig Command: disable autoconfig Success. DGS-3420-28SC:admin#...
  • Page 172: Chapter 11 Basic Ip Commands

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 11 Basic IP Commands config ipif <ipif_name 12> [{ipaddress <network_address> | vlan <vlan_name 32> | state [enable | disable]} | proxy_arp [enable | disable] {local [enable | disable]} | bootp | dhcp | ipv6 [ipv6address {prefix_name <string 1-12>} <ipv6networkaddr>...
  • 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.
  • Page 174: Create Ipif

    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.
  • Page 175: Delete Ipif

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide IPv4 addresses on the same interface. Configuration of IPv6 addresses must be done through the command config ipif. Format create ipif <ipif_name 12> {<network_address>} <vlan_name 32> {secondary | state [enable | disable] | proxy_arp [enable | disable] {local [enable | disable]}} Parameters <ipif_name 12>...
  • Page 176: Enable Ipif

    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.
  • Page 177: Disable Ipif

    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 183: Chapter 12 Bpdu Attack Protection Commands

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 12 BPDU Attack Protection Commands config bpdu_protection ports [<portlist> | all] {state [enable | disable] | mode [drop | block | shutdown]}(1) config bpdu_protection recovery_timer [<sec 60-1000000> | infinite] config bpdu_protection [trap | log] [none | attack_detected | attack_cleared | both] enable bpdu_protection disable bpdu_protection...
  • 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>...
  • Page 188 xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide...
  • Page 189: Chapter 13 Cable Diagnostics Commands

    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) ------...
  • Page 192: Chapter 14 Cfm Commands

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 14 CFM Commands create cfm md <string 22> {md_index <uint 1-4294967295>} level <int 0-7> config cfm md [<string 22> | md_index <uint 1-4294967295>] {mip [none | auto | explicit] | sender_id [none | chassis | manage | chassis_manage]}(1) create cfm ma <string 22>...
  • Page 193: Create Cfm Md

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide show cfm remote_mep [mepname <string 32> | md [<string 22> | md_index <uint 1- 4294967295>] ma [<string 22> | ma_index <uint 1-4294967295>] mepid <int 1-8191>] remote_mepid <int 1-8191> config cfm ais md [<string 22>...
  • Page 194: Config Cfm Md

    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.
  • Page 195: Create Cfm Ma

    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>...
  • Page 196 xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format config cfm ma [<string 22> | ma_index <uint 1-4294967295>] md [<string 22> | md_index <uint 1-4294967295>] {vlanid <vlanid 1-4094> | mip [none | auto | explicit | defer] | sender_id [none | chassis | manage | chassis_manage | defer] | ccm_interval [100ms | 1sec | 10sec | 1min | 10min] | mepid_list [add | delete] <mepid_list1-8191>}(1) Parameters...
  • Page 197: Create Cfm Mep

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To configure the parameters of a maintenance association: DGS-3420-28SC:admin#config cfm ma op1 md op_domain vlanid 1 ccm_interval 1sec Command: config cfm ma op1 md op_domain vlanid 1 ccm_interval 1sec Success.
  • Page 198: Config Cfm Mep

    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>...
  • Page 200: Delete Cfm Mep

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 14-7 delete cfm mep Description This command is used to delete a previously created MEP. Format delete cfm mep [mepname <string 32> | mepid <int 1-8191> md [<string 22> | md_index <uint 1- 4294967295>] ma [<string 22>...
  • Page 201: Delete Cfm Md

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format delete cfm ma [<string 22> | ma_index <uint 1-4294967295>] md [<string 22> | md_index <uint 1-4294967295>] Parameters <string 22> - Specify the maintenance association name. The maximum length is 22 characters. ma_index - Specify the maintenance association index.
  • Page 202: Enable Cfm

    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.
  • Page 203: Disable Cfm

    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...
  • Page 204: Show Cfm Ports

    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.
  • Page 205: Show Cfm

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Enabled Enabled Enabled DGS-3420-28SC:admin# 14-14 show cfm Description This command is used to display the CFM configuration. Format show cfm {[md [<string 22> | md_index <uint 1-4294967295>] {ma [<string 22> | ma_index <uint 1-4294967295>] {mepid <int 1-8191>}} | mepname <string 32>]} Parameters md - (Optional) Specify the maintenance domain name.
  • Page 206: Show Cfm Fault

    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>...
  • Page 208: Cfm Loopback

    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>...
  • Page 210: Cfm Linktrace

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 14-19 cfm linktrace Description This command is used to issue a CFM link track message. Format cfm linktrace <macaddr> [mepname <string 32> | mepid <int 1-8191> md [<string 22> | md_index <uint 1-4294967295>] ma [<string 22>...
  • Page 211: Show Cfm Linktrace

    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>...
  • Page 212: Delete Cfm Linktrace

    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.
  • Page 214: Show Cfm Mipccm

    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 216 xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#show cfm pkt_cnt ports 1-2 Command: show cfm pkt_cnt ports 1-2 CFM RX Statistics ------------------------------------------------------------------------------ Port AllPkt VidDrop OpcoDrop ----- -------- -------- -------- --------- ------ ------- -------- -------- CFM TX Statistics ---------------------------------------------------------- Port...
  • 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#...
  • Page 222: Chapter 15 Command List History Commands

    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 223 xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide clear address_binding dhcp_snoop binding_entry ports clear arptable clear attack_log clear cfm pkt_cnt clear counters clear dhcp binding clear dhcp conflict_ip clear ethernet_oam ports clear fdb clear historical_counters ports clear igmp_snooping data_driven_group clear igmp_snooping statistic counter clear jwac auth_state...
  • 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#...
  • Page 226: Chapter 16 Command Logging Command List

    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.
  • Page 227: Disable Command Logging

    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 229: Chapter 17 Common Unicast Routing Command List

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 17 Common Unicast Routing Command List config route preference [static | default | rip] <value 1-999> show route preference {[local | static | default | rip]} create route redistribute dst rip src [local | static] {metric <value 0-16>} config route redistribute dst rip src [local | static] {metric <value 0-16>} delete route redistribute dst rip src [local | static] show route redistribute dst rip {src [local | static]}...
  • 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 235: Chapter 18 Compound Authentication Commands

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 18 Compound Authentication Commands create authentication guest_vlan [vlan <vlan_name 32> | vlanid <vlanid 1-4094>] delete authentication guest_vlan [vlan <vlan_name 32> | vlanid <vlanid 1-4094>] config authentication guest_vlan [vlan <vlan_name 32> | vlanid <vlanid 1-4094>] [add | delete] ports [<portlist>...
  • 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>...
  • Page 238: Config Authentication Ports

    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.
  • Page 240: Show 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.
  • Page 241: Show Authentication Ports

    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.
  • Page 242: Enable Authorization Attributes

    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...
  • Page 243: Disable Authorization Attributes

    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...
  • Page 244: Config Authentication Server Failover

    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 246: Chapter 19 Debug Software Command List

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 19 Debug Software Command List debug address_binding [event | dhcp | all] state [enable | disable] no debug address_binding debug error_log [dump | clear | upload_toTFTP <ipaddr> <path_filename 64>] debug buffer [utilization | dump | clear | upload_toTFTP <ipaddr>...
  • 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...
  • Page 250: Debug Buffer

    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.
  • Page 251: Debug Output

    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.
  • Page 253: Debug Config State

    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.
  • Page 254: Debug Stp Clear Counter

    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...
  • Page 255: Debug Stp Config Ports

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 19-10 debug stp config ports Description This command used to configure per-port STP debug level on the specified ports. Format debug stp config ports [<portlist> | all] [event | bpdu | state_machine | all] state [disable | brief | detail] Parameters ports - Specifies the STP port range to debug.
  • Page 256: Debug Stp Show Flag

    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.
  • Page 257: Debug Stp Show Information

    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...
  • Page 260: Debug Stp State

    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.
  • Page 271: Debug Show Status

    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:...
  • Page 276: Debug Vrrp

    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#...
  • Page 282: Debug Vrrp State

    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.
  • Page 283: Chapter 20 Dhcp Local Relay Commands

    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 287: Chapter 21 Dhcp Relay Commands

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 21 DHCP Relay Commands config dhcp_relay {hops <int 1-16> | time <sec 0-65535>}(1) config dhcp_relay add ipif <ipif_name 12> <ipaddr> config dhcp_relay delete ipif <ipif_name 12> <ipaddr> config dhcp_relay option_60 add string <multiword 255>...
  • 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#...
  • Page 305: Chapter 22 Dhcp Server Commands

    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.
  • Page 325: Clear Dhcp Binding

    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.
  • Page 326: Show Dhcp Binding

    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 337: Chapter 23 Dhcp Server Screening Commands

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 23 DHCP Server Screening Commands config filter dhcp_server [add permit server_ip <ipaddr> {client_mac <macaddr>} ports [<portlist> | all] | delete permit server_ip <ipaddr> {client_mac <macaddr>} ports [<portlist> | all] | ports [<portlist>...
  • 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 350: Chapter 24 Dhcpv6 Relay Command List

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 24 DHCPv6 Relay Command List enable dhcpv6_relay disable dhcpv6_relay config dhcpv6_relay hop_count <value 1-32> config dhcpv6_relay [add | delete] ipif <ipif_name 12> <ipv6addr> config dhcpv6_relay ipif [<ipif_name 12> | all] state [enable | disable] show dhcpv6_relay {ipif <ipif_name 12>} 24-1 enable dhcpv6_relay...
  • 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...
  • Page 355: Chapter 25 Dhcpv6 Server Commands

    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 371: Chapter 26 Digital Diagnostic Monitoring (Ddm) Commands

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 26 Digital Diagnostic Monitoring (DDM) Commands config ddm [trap | log] [enable | disable] config ddm ports [<portlist> | all] [[temperature_threshold {high_alarm <degrees> | low_alarm <degrees> | high_warning <degrees> | low_warning <degrees>} | voltage_threshold {high_alarm <voltage>...
  • Page 372 xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#config ddm log enable Command: config ddm log enable Success. DGS-3420-28SC:admin# To configure DDM trap state to enable: DGS-3420-28SC:admin#config ddm trap enable Command: config ddm trap enable Success. DGS-3420-28SC:admin# 26-2 config ddm ports...
  • 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 375: Show Ddm

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#config ddm ports 1:21 tx_power_threshold high_alarm 0.625 low_alarm 0.006 high_warning 0.55 low_warning 0.008 Command: config ddm ports 1:21 tx_power_threshold high_alarm 0.625 low_alarm 0.006 high_warning 0.55 low_warning 0.008 Success. DGS-3420-28SC:admin# To configure the port 21’s receive power threshold: DGS-3420-28SC:admin#config ddm ports 1:21 rx_power_threshold high_alarm 4.55...
  • 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 379: Chapter 27 Domain Name System (Dns) Relay Commands

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 27 Domain Name System (DNS) Relay Commands config dnsr [[primary | secondary] nameserver <ipaddr> | [add | delete] static <domain_name 32> <ipaddr>] enable dnsr {[cache | static]} disable dnsr {[cache | static]} show dnsr {static} 27-1...
  • 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 384: Chapter 28 Domain Name System (Dns) Resolver Commands

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 28 Domain Name System (DNS) Resolver Commands config name_server add [<ipaddr> | <ipv6addr>] {primary} config name_server delete [<ipaddr> | <ipv6addr>] {primary} config name_server timeout <sec 1-60> show name_server create host_name <name 255>...
  • 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 391: Chapter 29 Dos Attack Prevention Commands

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 29 DoS Attack Prevention Commands config dos_prevention dos_type [{land_attack | blat_attack | tcp_null_scan | tcp_xmasscan | tcp_synfin | tcp_syn_srcport_less_1024 | ping_death_attack | tcp_tiny_frag_attack} | all] {action [drop] | state [enable | disable]}(1) config dos_prevention log [enable | disable] config dos_prevention trap [enable | disable] show dos_prevention {land_attack | blat_attack | tcp_null_scan | tcp_xmasscan | tcp_synfin |...
  • 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 396: Chapter 30 D-Link Unidirectional Link Detection (Duld) Commands

    DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 30 D-Link Unidirectional Link Detection (DULD) Commands config duld ports [<portlist> | all] {state [enable | disable] | mode [shutdown | normal] | discovery_time <sec 5-65535>} show duld ports {<portlist>}...
  • 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.
  • Page 398 xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#...
  • Page 399: Chapter 31 Energy Efficient Ethernet (Eee) Commands

    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 401: Chapter 32 Ethernet Ring Protection Switching (Erps) Commands

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 32 Ethernet Ring Protection Switching (ERPS) Commands enable erps disable erps create erps raps_vlan <vlanid 1-4094> delete erps raps_vlan <vlanid 1-4094> config erps raps_vlan <vlanid> [state [enable | disable] | ring_mel <value 0-7> | ring_port [west [<port>...
  • 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...
  • Page 411: Chapter 33 External Alarm Commands

    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.
  • Page 413: Chapter 34 Fdb Commands

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 34 FDB Commands create fdb <vlan_name 32> <macaddr> [port <port> | drop] create fdb vlanid <vidlist> <macaddr> [port <port> | drop] create multicast_fdb <vlan_name 32> <macaddr> config multicast_fdb <vlan_name 32> <macaddr> [add | delete] <portlist> config fdb aging_time <sec 10-1000000>...
  • Page 414: Create Fdb Vlanid

    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.
  • Page 417: Delete Fdb

    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.
  • Page 418: Clear Fdb

    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>...
  • Page 420: Show Fdb

    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>...
  • Page 422: Chapter 35 File System Management Commands

    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 426 xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Idx Info Attr Size Update Time Name --- ------- ---- -------- -------------------- ---- 1 RUN(*) -rw- 4796564 2000/01/22 03:52:03 runtime.had 2 CFG(*) -rw- 24120 2000/01/22 23:22:58 config.cfg 3 CFG(b) -rw- 24120 2000/01/23 06:59:39 d---...
  • 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.
  • Page 431: Change Drive

    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>...
  • Page 432: Chapter 36 Filter Commands

    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 435: Chapter 37 Gratuitous Arp Commands

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 37 Gratuitous ARP Commands enable gratuitous_arp {ipif <ipif_name 12>} {trap | log}(1) disable gratuitous_arp {ipif <ipif_name 12>} {trap | log}(1) config gratuitous_arp learning [enable | disable] config gratuitous_arp send dup_ip_detected [enable | disable] config gratuitous_arp send ipif_status_up [enable | disable] config gratuitous_arp send periodically ipif <ipif_name 12>...
  • 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 441: Chapter 38 Igmp Proxy Commands

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 38 IGMP Proxy Commands enable igmp_proxy disable igmp_proxy config igmp_proxy downstream_if [add | delete] vlan [<vlan_name 32> | vlanid <vidlist>] config igmp_proxy upstream_if {vlan [<vlan_name 32> | vlanid <vlanid 1-4094>] | router_ports [add | delete] <portlist>...
  • 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...
  • Page 446: Chapter 39 Igmp Snooping Commands

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 39 IGMP Snooping Commands config igmp_snooping [vlan_name <vlan_name 32> | vlanid <vlanid_list> | all] {state [enable | disable] | fast_leave [enable | disable] | proxy_reporting {state [enable | disable] | source_ip <ipaddr>}(1)}(1) config igmp_snooping querier [vlan_name <vlan_name 32>...
  • Page 447: Disable] | Fast_Leave [Enable | Disable] | Proxy_Reporting {State [Enable | Disable] | Source_Ip

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format config igmp_snooping [vlan_name <vlan_name 32> | vlanid <vlanid_list> | all] {state [enable | disable] | fast_leave [enable | disable] | proxy_reporting {state [enable | disable] | source_ip <ipaddr>}(1)}(1) Parameters vlan_name - Specify the name of the VLAN for which IGMP snooping is to be configured.
  • Page 448: Config Igmp_Snooping Querier [Vlan_Name | Vlanid | All] {Query_Interval | Max_Response_Time | Robustness_Variable

    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>...
  • Page 451: Enable Igmp_Snooping

    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.
  • Page 456: Config Igmp_Snooping Rate_Limit [Ports | Vlanid ] [ | No_Limit]

    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.
  • Page 467: 39-23 Show Igmp_Snooping Forward_Lookup_Mode

    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 470: Chapter 40 Igmp Snooping Multicast (Ism) Vlan Commands

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 40 IGMP Snooping Multicast (ISM) VLAN Commands create igmp_snooping multicast_vlan <vlan_name 32> <vlanid 2-4094> {remap_priority [<value 0-7> | none] {replace_priority}} config igmp_snooping multicast_vlan <vlan_name 32> {[add | delete] [member_port <portlist> | [source_port <portlist>...
  • 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.
  • Page 482: Chapter 41 Ipv4/Ipv6 Routing Commands

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 41 IPv4/IPv6 Routing Commands create iproute [default | <network_address>] [<ipaddr> {<metric 1-65535>} {[primary | backup]} | null0 | ip_tunnel <tunnel_name 12>] delete iproute [default | <network_address>] [<ipaddr> | null0 | ip_tunnel <tunnel_name 12>] show iproute {[<network_address>...
  • Page 483: Delete Iproute

    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.
  • Page 484: Show Iproute

    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>...
  • Page 485: Create Ipv6Route

    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 486: Show Ipv6Route

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format delete ipv6route [[default | <ipv6networkaddr>] [<ipif_name 12> <ipv6addr> | <ipv6addr> | ip_tunnel <tunnel_name 12>] | all] Parameters default - Specifies the default route. <ipv6networkaddr> - Specifies the IPv6 network address. <ipif_name 12>...
  • 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 490: Chapter 42 Ip Tunnel Commands

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 42 IP Tunnel Commands create ip_tunnel <tunnel_name 12> delete ip_tunnel <tunnel_name 12> config ip_tunnel manual <tunnel_name 12> {ipv6address <ipv6networkaddr> | source <ipaddr> | destination <ipaddr>}(1) config ip_tunnel 6to4 <tunnel_name 12> {ipv6address <ipv6networkaddr> | source <ipaddr>}(1) config ip_tunnel isatap <tunnel_name 12>...
  • 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 498 xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin# config ip_tunnel gre tn1 source 1.0.0.1 destination 1.0.0.2 Command: config ip_tunnel gre tn1 source 1.0.0.1 destination 1.0.0.2 Success. DGS-3420-28SC:admin# config ip_tunnel gre tn1 ipaddress 2.0.0.1/8 ipv6address 2001::1/64 Command: config ip_tunnel gre tn1 ipaddress 2.0.0.1/8 ipv6address 2001::1/64 Success.
  • 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 500: Chapter 43 Ipv6 Ndp Commands

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 43 IPv6 NDP Commands create ipv6 neighbor_cache ipif <ipif_name 12> <ipv6addr> <macaddr> delete ipv6 neighbor_cache ipif [<ipif_name 12> | all] [<ipv6addr> | static | dynamic | all] show ipv6 neighbor_cache ipif [<ipif_name 12>...
  • 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.
  • Page 505: Show Ipv6 Nd

    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 507: Chapter 44 Ip-Mac-Port Binding (Impb) Commands

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 44 IP-MAC-Port Binding (IMPB) Commands create address_binding ip_mac ipaddress <ipaddr> mac_address <macaddr> {ports[<portlist>| all ]} create address_binding ip_mac ipv6address <ipv6addr> mac_address <macaddr> {ports [<portlist> | all]} config address_binding ip_mac ports [<portlist> | all] {arp_inspection [strict | loose | disable] | ip_inspection [enable | disable] | nd_inspection [enable | disable] | protocol [ipv4 | ipv6 | all] | allow_zeroip [enable | disable] | forward_dhcppkt [enable | disable] | stop_learning_threshold <int 0-500>}(1)
  • 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 534: Chapter 45 Japanese Web-Based Access Control (Jwac) Commands

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 45 Japanese Web-based Access Control (JWAC) Commands enable jwac disable jwac enable jwac redirect disable jwac redirect enable jwac forcible_logout disable jwac forcible_logout enable jwac udp_filtering disable jwac udp_filtering enable jwac quarantine_server_monitor disable jwac quarantine_server_monitor config jwac quarantine_server_error_timeout <sec 5-300>...
  • 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.
  • Page 559: Chapter 46 Jumbo Frame Commands

    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.
  • Page 562: Chapter 47 Lacp Configuration Commands

    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 564: Chapter 48 Layer 2 Protocol Tunneling (L2Pt) Command List

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 48 Layer 2 Protocol Tunneling (L2PT) Command List config l2protocol_tunnel ports [<portlist> | all] type [uni tunneled_protocol [{stp | gvrp | protocol_mac [01-00-0C-CC-CC-CC | 01-00-0C-CC-CC-CD]}(1) | all] {threshold <value 0-65535>} | nni | none] show l2protocol_tunnel {[uni | nni]} enable l2protocol_tunnel disable l2protocol_tunnel...
  • 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 569: Chapter 49 Limited Multicast Ip Address Commands

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 49 Limited Multicast IP Address Commands create mcast_filter_profile {[ipv4 | ipv6]} profile_id <value 1-60> profile_name <name 32> config mcast_filter_profile [profile_id <value 1-60> | profile_name <name 32>] {profile_name <name 32>...
  • 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 578: Chapter 50 Link Aggregation Commands

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 50 Link Aggregation Commands create link_aggregation group_id <value 1-32> {type [lacp | static]} delete link_aggregation group_id <value 1-32> config link_aggregation group_id <value 1-32> {master_port <port> | ports <portlist> | state [enable | disable] | trap [enable | disable]} (1) config link_aggregation algorithm [mac_source | mac_destination | mac_source_dest | ip_source | ip_destination | ip_source_dest | l4_src_port | l4_dest_port | l4_src_dest_port]...
  • 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...
  • Page 583: Chapter 51 Lldp Commands

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 51 LLDP Commands enable lldp disable lldp config lldp [message_tx_interval <sec 5-32768> | message_tx_hold_multiplier <int 2-10> | tx_delay <sec 1-8192> | reinit_delay <sec 1-10>] show lldp config lldp forward_message [enable | disable] config lldp notification_interval <sec 5-3600>...
  • Page 584: Disable Lldp

    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.
  • Page 585: Config 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.
  • Page 586: Show Lldp

    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...
  • Page 588: Config Lldp Ports

    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...
  • Page 593: Show Lldp Ports

    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...
  • Page 604: Show Lldp Statistics

    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...
  • Page 605: Show Lldp Statistics Ports

    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...
  • Page 607: Chapter 52 Loopback Detection Commands

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 52 Loopback Detection Commands config loopdetect {recover_timer [0 | <sec 60-1000000>] | interval <sec 1-32767> | mode [port-based | vlan-based]}(1) config loopdetect ports [<portlist> | all] state [enable | disable] config loopdetect vlan [<vid_list>...
  • Page 608: Config Loopdetect Ports

    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.
  • Page 609: Enable Loopdetect

    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.
  • Page 610: Disable Loopdetect

    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.
  • Page 611: Show Loopdetect Ports

    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 615: Chapter 53 Loopback Interface Commands

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 53 Loopback Interface Commands create loopback ipif <ipif_name 12> {<network_address>} {state [enable | disable]} config loopback ipif <ipif_name 12> [{ipaddress <network_address> | state [enable | disable]}(1)] show loopback ipif {<ipif_name 12>} delete loopback ipif [<ipif_name 12>...
  • 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 618 xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin# delete loopback ipif loopback1 Command: delete loopback ipif loopback1 Success. DGS-3420-28SC:admin#...
  • Page 619: Chapter 54 Mac Notification Commands

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 54 MAC Notification Commands enable mac_notification disable mac_notification config mac_notification {interval <sec 1-2147483647> | historysize <int 1-500>}(1) config mac_notification ports [<portlist> | all] [enable | disable] show mac_notification show mac_notification ports {<portlist>} 54-1 enable mac_notification...
  • 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 624: Chapter 55 Mac-Based Access Control Commands

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 55 MAC-based Access Control Commands enable mac_based_access_control disable mac_based_access_control config mac_based_access_control password <passwd 16> config mac_based_access_control method [local | radius] config mac_based_access_control guest_vlan ports <portlist> config mac_based_access_control ports [<portlist> | all] {state [enable | disable] | aging_time [infinite | <min 1-1440>] | block_time <sec 0-300>...
  • 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 641: Chapter 56 Mirror Commands

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 56 Mirror Commands create mirror group_id <value 1-4> config mirror port <port> {[add | delete] source ports <portlist> [rx | tx | both]} config mirror group_id <value 1-4> {target_port <port> | [add | delete] source ports <portlist> [rx | tx | both] | state [enable | disable]}(1) delete mirror group_id <value 1-4>...
  • 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.
  • Page 644: Enable Mirror

    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...
  • Page 645: Disable Mirror

    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 647: Chapter 57 Mld Proxy Commands

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 57 MLD Proxy Commands enable mld_proxy disable mld_proxy config mld_proxy downstream_if [add | delete] vlan [<vlan_name 32> | vlanid <vidlist>] config mld_proxy upstream_if {vlan [<vlan_name 32> | vlanid <vlanid 1-4094>] | router_ports [add | delete] <portlist>...
  • 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 652: Chapter 58 Mld Snooping Commands

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 58 MLD Snooping Commands 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) config mld_snooping rate_limit [ports <portlist>...
  • 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 672 xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#config mld_snooping data_driven_learning max_learned_entry Command: config mld_snooping data_driven_learning max_learned_entry 50 Success. DGS-3420-28SC:admin#...
  • Page 673: Chapter 59 Mld Snooping Multicast (Msm) Vlan Commands

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 59 MLD Snooping Multicast (MSM) VLAN Commands create mld_snooping multicast_vlan <vlan_name 32> <vlanid 2-4094> {remap_priority [<value 0-7> | none] {replace_priority}} config mld_snooping multicast_vlan <vlan_name 32> {[add | delete] [member_port <portlist> | [source_port <portlist>...
  • 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.
  • Page 685: Chapter 60 Modify Login Banner And Prompt Commands

    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”...
  • Page 689: Chapter 61 Network Load Balancing (Nlb) Commands

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 61 Network Load Balancing (NLB) Commands create nlb multicast_fdb [<vlan_name 32> | vlanid <vlanid 1-4094>] <macaddr> delete nlb multicast_fdb [<vlan_name 32> | vlanid <vlanid 1-4094>] <macaddr> config nlb multicast_fdb [<vlan_name 32> | vlanid <vlanid 1-4094>] <macaddr> [add | delete] <portlist>...
  • Page 690 xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To create a NLB multicast FDB entry: DGS-3420-28SC:admin# create nlb multicast_fdb default 03-bf-01-01-01-01 Command: create nlb multicast_fdb default 03-bf-01-01-01-01 Success. DGS-3420-28SC:admin# 61-2 delete nlb multicast_fdb Description This command is used to delete the Switch’s NLB multicast FDB entry. Format delete nlb multicast_fdb [<vlan_name 32>...
  • Page 691: Show Nlb Fdb

    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...
  • Page 695: Chapter 62 Network Management Commands

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 62 Network Management Commands enable snmp disable snmp show snmp create trusted_host [<ipaddr> | <ipv6addr> | network <network_address> | ipv6_prefix <ipv6networkaddr>] {snmp | telnet | ssh | http | https | ping} config trusted_host [<ipaddr>...
  • Page 696: Disable Snmp

    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.
  • Page 697: Show Snmp

    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...
  • Page 703: Enable Snmp Traps

    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...
  • Page 707: Show Snmp Traps

    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 708 xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To display SNMP traps: DGS-3420-28SC:admin#show snmp traps Command: show snmp traps SNMP Traps : Enabled Authenticate Trap : Enabled Linkchange Traps : Enabled Coldstart Traps : Enabled Warmstart Traps : Enabled DGS-3420-28SC:admin#...
  • 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>...
  • Page 711: Config Rmon Trap

    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:...
  • Page 712: Show Rmon

    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.
  • Page 713 xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide...
  • Page 714: Chapter 63 Network Monitoring Commands

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 63 Network Monitoring Commands show packet ports <portlist> show error ports <portlist> show utilization [ports | cpu] show utilization dram {unit <unit_id>} show utilization flash {unit <unit_id>} clear counters {ports <portlist>} clear log show log {[index <value_list>...
  • Page 715: Show Error Ports

    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...
  • Page 718: Show Utilization Dram

    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.
  • Page 719: Clear Counters

    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.
  • Page 720: Clear Log

    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.
  • Page 724: Enable Syslog

    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...
  • Page 725: Show 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...
  • Page 726 xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format config syslog host [<index> | all] {severity [emergency | alert | critical | error | warning | notice | informational | debug | <level 0-7>] | facility [local0 | local1 | local2 | local3 | local4 | local5 | local6 | local7] | udp_port <udp_port_number>...
  • Page 727: Create Syslog Host

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Command: config syslog host all severity informational facility local0 Success. DGS-3420-28SC:admin# 63-16 create syslog host Description This command is used to create a new syslog host. Format create syslog host <index 1-4> ipaddress [<ipaddr> | <ipv6addr>] {severity [emergency | alert | critical | error | warning | notice | informational | debug | <level 0-7>] | facility [local0 | local1 | local2 | local3 | local4 | local5 | local6 | local7] | udp_port <udp_port_number>...
  • Page 728: Delete Syslog Host

    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.
  • Page 729: Show Syslog Host

    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 733 xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#...
  • Page 734: Chapter 64 Oam Commands

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 64 OAM Commands config ethernet_oam ports [<portlist> | all] [mode [active | passive] | state [enable | disable] | link_monitor [error_symbol {threshold <range 0-4294967295> | window <millisecond 1000- 60000>...
  • Page 735 xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format config ethernet_oam ports [<portlist> | all] [mode [active | passive] | state [enable | disable] | link_monitor [error_symbol {threshold <range 0-4294967295> | window <millisecond 1000- 60000> | notify_state [enable | disable]} (1) | error_frame {threshold <range 0-4294967295> | window <millisecond 1000-60000>...
  • 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 740 xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Unique Event Notification OAMPDU TX Unique Event Notification OAMPDU RX Duplicate Event Notification OAMPDU TX: 0 Duplicate Event Notification OAMPDU RX: 0 Loopback Control OAMPDU TX Loopback Control OAMPDU RX Variable Request OAMPDU TX Variable Request OAMPDU RX Variable Response OAMPDU TX...
  • Page 741 xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide To clear port 1 OAM events: DGS-3420-28SC:admin#clear ethernet_oam ports 1 event_log Command: clear ethernet_oam ports 1 event_log Success. DGS-3420-28SC:admin#...
  • Page 742: Chapter 65 Packet Storm Commands

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 65 Packet Storm Commands config traffic control [<portlist> | all] {broadcast [enable | disable] | multicast [enable | disable] | unicast [enable | disable] | action [drop | shutdown] | [threshold <value 0-255000> | {broadcast_threshold <value 0-255000>...
  • 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.
  • Page 746: Show Traffic Control

    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...
  • Page 747 xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Enabled Disabled Disabled shutdown 0 DGS-3420-28SC:admin#...
  • Page 748: Chapter 66 Password Recovery Commands

    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#...
  • Page 751: Chapter 67 Policy Route Commands

    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 754 xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide ference -------------------------------- ----- ------ --------------- -------- ------- policy1 10.90.90.254 Enabled Total Entries: 1 DGS-3420-28SC:admin#...
  • Page 755: Chapter 68 Port Security Commands

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 68 Port Security Commands config port_security ports [<portlist> | all] [{admin_state [enable | disable] | max_learning_addr <max_lock_no 0-3328> | lock_address_mode [permanent | deleteontimeout | deleteonreset]}(1) | {vlan [<vlan_name 32> | vlanid <vidlist>] max_learning_addr [<max_lock_no 0-3328>...
  • 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.
  • Page 764: Chapter 69 Power Over Ethernet (Poe) Commands

    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>...
  • Page 765: Config Poe System

    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.
  • Page 766: Show Poe Ports

    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.
  • Page 768: Show Poe System

    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 769: Chapter 70 Power Saving Commands

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 70 Power Saving Commands config power_saving mode {length_detection | link_detection | led | port | hibernation} [enable | disable] config power_saving hibernation [[add | delete] time_range <range_name 32> | clear_time_range] config power_saving led [[add | delete] time_range <range_name 32>...
  • 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 776: Chapter 71 Precision Time Protocol (Ptp) Commands

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 71 Precision Time Protocol (PTP) Commands enable ptp disable ptp config ptp mode [boundary | p2p_transparent | e2e_transparent] config ptp transport protocol [ethernet | udp] config ptp clock domain_number <value 0-127> {unit <unit_id 1-12>} {domain_name <string 1- 32>} config ptp boundary {priority1 <value 0-255>...
  • 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 795: Chapter 4 Protocol Vlan Commands

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 4 Protocol VLAN Commands create dot1v_protocol_group group_id <int 1-16> {group_name <name 32>} config dot1v_protocol_group [group_id <int 1-16> | group_name <name 32>] [add protocol [ethernet_2 | ieee802.3_snap | ieee802.3_llc] <protocol_value> | delete protocol [ethernet_2 | ieee802.3_snap | ieee802.3_llc] <protocol_value>] delete dot1v_protocol_group [group_id <int 1-16>...
  • 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>...
  • Page 800: Show Port Dot1V

    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 801: Chapter 5 Qos Commands

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 5 QoS Commands config bandwidth_control [<portlist> | all] {rx_rate [no_limit | <value 8-10240000>] | tx_rate [no_limit | <value 8-10240000>]}(1) show bandwidth_control {<portlist>} config per_queue bandwidth_control {ports [<portlist> | all]} <cos_id_list 0-7> {{min_rate [no_limit | <value 8-10240000>]} max_rate [no_limit | <value 8-10240000>]}(1) show per_queue bandwidth_control {<portlist>} config scheduling {ports [<portlist>...
  • 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.
  • Page 805: Config Scheduling

    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.
  • Page 807: Show Scheduling

    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.
  • Page 815: Config Dscp Map

    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.
  • Page 816: Show Dscp Map

    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.
  • Page 817: Config Dscp Trust

    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.
  • Page 818: Show Dscp Trust

    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...
  • Page 819: Chapter 6 Q-In-Q Command

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 6 Q-in-Q Command enable qinq disable qinq show qinq config qinq ports [<portlist> | all] {role [uni | nni] | missdrop [enable | disable] | outer_tpid <hex 0x1-0xffff>| use_inner_priority [enable | disable] | add_inner_tag [<hex 0x1-0xffff>...
  • Page 820: Disable Qinq

    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.
  • Page 821: Show Qinq

    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>...
  • Page 823: Show Qinq Ports

    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 833: Chapter 7 Routing Information Protocol (Rip) Command List

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 7 Routing Information Protocol (RIP) Command List enable rip 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) config rip timers {update <sec 5-65535>...
  • 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 838: Chapter 8 Ripng Commands

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 8 RIPng Commands enable ripng disable ripng show ripng {ipif <ipif_name 12>} config ripng {method [no_horizon | split_horizon | poison_reverse] | update <sec 5-65535> | expire <sec 1-65535> | garbage_collection <sec 1-65535>}(1) config ripng ipif [<ipif_name 12>...
  • 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>...
  • Page 842: Chapter 9 Rspan Commands

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 9 RSPAN Commands enable rspan disable rspan create rspan vlan [vlan_name <vlan_name> | vlan_id <vlanid 1-4094>] delete rspan vlan [vlan_name <vlan_name> | vlan_id <vlanid 1-4094>] config rspan vlan [vlan_name <vlan_name> | vlan_id <vlanid 1-4094>] [redirect [add | delete] ports <portlist>...
  • Page 843: Create Rspan Vlan

    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.
  • Page 844: Delete Rspan Vlan

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#create rspan vlan vlan_name v2 Command: create rspan vlan vlan_name v2 Success. DGS-3420-28SC:admin# To create an RSPAN VLAN entry by VLAN ID “3”: DGS-3420-28SC:admin#create rspan vlan vlan_id 3 Command: create rspan vlan vlan_id 3 Success.
  • Page 845: Config 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.
  • Page 846: Show Rspan

    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 849: Chapter 10 Safeguard Engine Commands

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 10 Safeguard Engine Commands config safeguard_engine {state [enable | disable] | utilization {rising <value 20-100> | falling <value 20-100>}(1) | trap_log [enable | disable] | mode [strict | fuzzy]}(1) show safeguard_engine 10-1 config safeguard_engine...
  • 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.
  • Page 852: Chapter 11 Secure File Transfer Protocol (Sftp) Commands

    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.
  • Page 855: Chapter 12 Sflow Commands

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 12 sFlow Commands enable sflow disable sflow show sflow create sflow flow_sampler ports [<portlist> | all] analyzer_server_id <value 1-4> {rate <value 0- 65535> | tx_rate <value 0-65535> | maxheadersize <value 18-256>} config sflow flow_sampler ports [<portlist>...
  • Page 856: Disable Sflow

    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...
  • Page 867: Chapter 13 Single Ip Management Commands

    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 877: Chapter 14 Smtp Commands

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 14 SMTP Commands enable smtp disable smtp config smtp {server <ipaddr> | server_port <port_number 1-65535> | self_mail_addr <mail_addr 254> | [add mail_receiver <mail_addr 254> | delete mail_receiver <index 1-8>]} show smtp smtp send_testmsg 14-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.
  • Page 883: Chapter 15 Snmpv1/V2/V3 Commands

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 15 SNMPv1/v2/v3 Commands create snmp user <user_name 32> <groupname 32> {encrypted [by_password auth [md5 <auth_password 8-16> | sha <auth_password 8-20>] priv [none | des <priv_password 8-16>] | by_key auth [md5 <auth_key 32-32>...
  • Page 884: Delete Snmp User

    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.
  • Page 885: Show Snmp User

    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.
  • Page 886: Show Snmp Groups

    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.
  • Page 887: Create Snmp View

    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...
  • Page 888: Delete Snmp View

    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.
  • Page 889: Create Snmp Community

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions None. Example To display SNMP view records: DGS-3420-28SC:admin#show snmp view Command: show snmp view Vacm View Table Settings View Name Subtree View Type -------------------- ------------------------- ---------- restricted 1.3.6.1.2.1.1 Included restricted...
  • Page 890: Delete Snmp Community

    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.
  • Page 891: Show Snmp Community

    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.
  • Page 892: Config Snmp Engineid

    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.
  • Page 893: Show Snmp Engineid

    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.
  • Page 894: Delete Snmp Group

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format create snmp group <groupname 32> [v1 | v2c | v3 [noauth_nopriv | auth_nopriv | auth_priv]] {read_view <view_name 32> | write_view <view_name 32> | notify_view <view_name 32>}(1) Parameters <groupname 32>...
  • Page 895: Create Snmp

    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.
  • Page 896: Delete Snmp

    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.
  • Page 897: Show Snmp V6Host

    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.
  • Page 902 xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide...
  • Page 903: Chapter 16 Spanning Tree Protocol (Stp) Commands

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 16 Spanning Tree Protocol (STP) commands show stp show stp instance {<value 0-64>} show stp ports {<portlist>} show stp mst_config_id create stp instance_id <value 1-64> delete stp instance_id <value 1-64> config stp instance_id <value 1-64>...
  • Page 904: Show Stp Instance

    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...
  • Page 905: Show Stp Ports

    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.
  • Page 910: Enable Stp

    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.
  • Page 911: Config Stp Version

    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.
  • Page 912: Config Stp Priority

    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.
  • Page 913: Config Stp

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 16-13 config stp Description This command is used to configure the bridge parameter global settings. Format config stp {maxage <value 6-40> | maxhops <value 6-40> | hellotime <value 1-2> | forwarddelay <value 4-30>...
  • Page 914: Config Stp Ports

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 16-14 config stp ports Description This command is used to configure all the parameters of ports, except for Internal Path Cost and Port Priority. Format config stp ports <portlist> {externalCost [auto | <value 1-200000000> ] | hellotime <value 1-2> | migrate [yes | no] | edge [true | false | auto] | p2p [true | false | auto] | state [enable | disable] | restricted_role [true | false] | restricted_tcn [true | false] | fbpdu [enable | disable ]} (1) Parameters...
  • Page 915 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 STP ports: DGS-3420-28SC:admin# config stp ports 1 externalCost auto Command: config stp ports 1 externalCost auto Success.
  • Page 916 xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Success. DGS-3420-28SC:admin# 16-16 config stp trap Description This command is used to configure sending the STP traps. Format config stp trap {topo_change [disable | enable] | new_root [enable | disable]} (1) Parameters topo_change - Specify the state of sending topology change traps.
  • Page 917: Chapter 17 Ssh Commands

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 17 SSH Commands config ssh algorithm [3DES | AES128 | AES192 | AES256 | arcfour | blowfish | cast128 | twofish128 | twofish192 | twofish256 | MD5 | SHA1 | RSA | DSA] [enable | disable] show ssh algorithm config ssh authmode [password | publickey | hostbased] [enable | disable] show ssh authmode...
  • Page 918: Show Ssh Algorithm

    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.
  • Page 919: Config Ssh Authmode

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide twofish128 : Enabled twofish192 : Enabled twofish256 : Enabled Data Integrity Algorithm -------------------------- : Enabled SHA1 : Enabled Public Key Algorithm -------------------------- : Enabled : Enabled DGS-3420-28SC:admin# 17-3 config ssh authmode Description This command is used to update the user authentication for SSH configuration.
  • Page 920: Show Ssh Authmode

    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>...
  • Page 922: Config Ssh Server

    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...
  • Page 923: Enable Ssh

    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...
  • Page 924: Show Ssh Server

    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.
  • Page 928: Chapter 18 Ssl Commands

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 18 SSL Commands download ssl certificate <ipaddr> certfilename <path_filename 64> {keyfilename <path_filename 64>} enable 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)} 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)} show ssl {certificate {[chain | <path_filename 64>]}} show ssl cachetimeout...
  • Page 929: Enable Ssl

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To download a certificate from a TFTP server: DGS-3420-28SC:admin# download ssl certificate 10.55.47.1 certfilename cert.der keyfilename pkey.der Command: download ssl certificate 10.55.47.1 certfilename cert.der keyfilename pkey.der Success. DGS-3420-28SC:admin# 18-2 enable ssl...
  • Page 930: Disable Ssl

    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)}...
  • Page 931: Show Ssl

    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...
  • Page 932: Show Ssl Cachetimeout

    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>...
  • Page 935: Chapter 19 Stacking Commands

    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 942: Chapter 20 Static Mac-Based Vlan Commands

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 20 Static MAC-based VLAN Commands create mac_based_vlan mac_address <macaddr> [vlan <vlan_name 32> | vlanid <vlanid 1-4094>] {priority <value 0-7>} delete mac_based_vlan {mac_address <macaddr> [vlan <vlan_name 32>| vlanid <vlanid 1-4094>]} show mac_based_vlan {mac_address <macaddr>...
  • 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 945: Chapter 21 Static Replication Commands

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 21 Static Replication Commands create ipmc_vlan_replication_entry <name 16> config ipmc_vlan_replication {[ttl [decrease | no_decrease] | src_mac [replace | no_replace]]}(1) config ipmc_vlan_replication_entry destination <name 16> [add | delete] [vlan <vlan_name 32>...
  • 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 953: Chapter 22 Subnet Vlan Commands

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 22 Subnet VLAN Commands create subnet_vlan [network <network_address> | ipv6network <ipv6networkaddr>] [vlan <vlan_name 32> | vlanid <vlanid 1-4094>] {priority <value 0-7>} delete subnet_vlan [network <network_address> | ipv6network <ipv6networkaddr> | vlan <vlan_name 32>...
  • Page 954 xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To create a subnet VLAN entry: DGS-3420-28SC:admin#create subnet_vlan network 172.168.1.1/24 vlan v2 priority 2 Command: create subnet_vlan network 172.168.1.1/24 vlan v2 priority 2 Success. DGS-3420-28SC:admin# To create an IPv6 subnet VLAN entry: DGS-3420-28SC:admin# create subnet_vlan ipv6network fe80:250:baff::0/64 vlan v2 priority 2 Command: create subnet_vlan ipv6network fe80:250:baff::0/64 vlan v2 priority 2...
  • 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 959: Chapter 23 Switch Port Commands

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 23 Switch Port Commands config ports [<portlist> | all] {medium_type [fiber | copper]} {speed [auto {capability_advertised {10_half | 10_full | 100_half | 100_full | 1000_full}} | 10_half | 10_full | 100_half | 100_full | 1000_full {[master | slave]}] | auto_negotiation [restart_an | remote_fault_advertised [disable | offline | link_fault | auto_negotiation_error]] | flow_control [enable | disable] | learning [enable | disable] | state [enable | disable] | mdix [auto | normal | cross] | [description <desc 1-32>...
  • 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.
  • Page 961: Show Ports

    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 963: Chapter 24 System Severity Commands

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 24 System Severity Commands config system_severity [trap | log | all] [emergency | alert | critical | error | warning | notice | information | debug | <level 0-7>] show system_severity 24-1 config system_severity...
  • 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)
  • Page 965: Chapter 25 Tech Support Commands

    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....
  • Page 968: Chapter 26 Time And Sntp Commands

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 26 Time and SNTP Commands config sntp {primary <ipaddr> | secondary <ipaddr> | poll-interval <int 30-99999>} (1) config sntp ipv6server {primary <ipv6addr> | secondary <ipv6addr>} show sntp enable sntp disable sntp config time <date ddmthyyyy>...
  • Page 969: Show Sntp

    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.
  • Page 970: Enable Sntp

    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...
  • Page 971: Disable Sntp

    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...
  • Page 973: Config Dst

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Command: config time_zone operator + hour 2 min 30 Success. DGS-3420-28SC:admin# 26-8 config dst Description This command is used to change Daylight Saving Time settings. Format config dst [disable | repeating {s_week <start_week 1-4,last> | s_day <start_day sun-sat> | s_mth <start_mth 1-12>...
  • Page 974: Show Time

    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...
  • Page 976: Chapter 27 Traffic Segmentation Commands

    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 978: Chapter 28 Udp Helper Commands

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 28 UDP Helper Commands enable udp_helper disable udp_helper config udp_helper add ipif <ipif_name 12> <ipaddr> config udp_helper delete ipif <ipif_name 12> <ipaddr> config udp_helper udp_port add [time | tacacs | dns | tftp | netbios-ns | netbios-ds | <port_number 0-65535>] config udp_helper udp_port delete [time | tacacs | dns | tftp | netbios-ns | netbios-ds | <port_number 0-65535>]...
  • 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 984: Chapter 29 Utility Commands

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 29 Utility Commands download [firmware_fromTFTP [<ipaddr> | <ipv6addr> | <domain_name 255>] src_file <path_filename 64> {[unit <unit_id> | all]} {dest_file <pathname>} {boot_up} | cfg_fromTFTP [<ipaddr> | <ipv6addr> | <domain_name 255>] src_file <path_filename 64> {[unit <unit_id> | all]} {[increment | dest_file <pathname>]}] download cfg_fromRCP [{username <username>} {<ipaddr>} src_file <path_filename 64>...
  • 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....
  • Page 995: Config Firmware Image

    xStack® DGS-3420 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3420-28SC:admin#upload log_toRCP username rcp_user 172.18.212.104 dest_file /home/DGS-3420.log Command: upload log_toRCP username rcp_user 172.18.212.104 dest_file /home/DGS- 3420.log Connecting to server....Done. Upload log......Done. Success. To upload log from the device to an RCP server using an RCP string: DGS-3420-28SC:admin#upload log_toRCP rcp: tld2@172.18.212.104/home/DGS-3420.log Command: upload log_toRCP rcp: tld2@172.18.212.104/home/DGS-3420.log Connecting to server....
  • Page 996: Config Configuration

    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.

Table of Contents