D-Link DGS-3120-24PC Manual

D-Link DGS-3120-24PC Manual

Layer 2 managed stackable gigabit switch
Hide thumbs Also See for DGS-3120-24PC:
Table of Contents

Advertisement

Advertisement

Table of Contents
loading

Summary of Contents for D-Link DGS-3120-24PC

  • Page 2: Table Of Contents

    Chapter 28 D-Link License management System (DLMS) Command List ......... 277 Chapter 29 D-Link Unidirectional Link Detection (DULD) Command List (EI Mode Only) ....279 Chapter 30 Ethernet Ring Protection Switching (ERPS) Command List (EI Mode Only)....281 Chapter 31 Filter Command List ......................
  • Page 3 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 35 IGMP / MLD Snooping Command List ................321 Chapter 36 IP-MAC-Port Binding (IMPB) Command List (EI Mode Only) ........... 365 Chapter 37 IPv6 Neighbor Discover Command List (EI Mode Only) ........... 381 Chapter 38 IPv6 Route Command List (EI Mode Only) ...............
  • Page 4 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 71 Secure Sockets Layer (SSL) Command List ..............641 Chapter 72 Surveillance VLAN Command List ..................648 Chapter 73 sFlow Command List (EI Mode Only) ................654 Chapter 74 Show Technical Support Command List ................
  • Page 5: Using Command Line Interface

    With the serial port properly connected to a management computer, the following screen should be visible. DGS-3120-24TC Gigabit Ethernet Switch Command Line Interface Firmware: Build 2.50.015 Copyright(C) 2012 D-Link Corporation. All rights reserved. UserName: PassWord: DGS-3120-24TC:admin# There is no initial username or password. Just press the Enter key twice to display the CLI input cursor −...
  • Page 6 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide default IP address is 10.90.90.90. You can change the default Switch IP address to meet the specification of your networking address scheme. The Switch is also assigned a unique MAC address by the factory. This MAC address cannot be changed, and can be found on the initial boot console screen –...
  • Page 7 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide There are a number of helpful features included in the CLI. Entering the ? command will display a list of all of the top-level commands. cable_diag ports cfm linktrace cfm lock md cfm loopback...
  • Page 8 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# config account Command: config account Next possible completions: <username> DGS-3120-24TC:admin# config account In the above example, the command config account was entered without the required parameter <username>, the CLI returned the Next possible completions: <username>...
  • Page 9 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Command: show Next possible completions: 802.1p 802.1x access_profile account accounting acct_client address_binding arp_spoofing_prevention arpentry asymmetric_vlan attack_log auth_client auth_diagnostics auth_session_statistics auth_statistics authen authen_enable authen_login authen_policy authentication authorization autoconfig backup bandwidth_control boot_file...
  • Page 10: Command Syntax Symbols

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Command Syntax Symbols Syntax Description angle brackets < > Encloses a variable or value. Users must specify the variable or value. For example, in the syntax config command_history <value 1-40> users must enter how many entries for <value 1-40>...
  • Page 11 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Left Arrow Move cursor to left. Right Arrow Move cursor to right Help user to select appropriate token. P or p Display the previous page. N, n or Space Display the next page.
  • Page 12: Chapter 2 Basic Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 2 Basic Command List show session show serial_port config serial_port {baud_rate [9600 | 19200 | 38400 | 115200] | auto_logout [never | 2_minutes | 5_minutes | 10_minutes | 15_minutes]} enable clipaging disable clipaging login...
  • Page 13 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#show session Command: show session Live Time From Level User --- ------------ --------------------------------------- ----- --------------- 00:04:17.870 Serial Port admin Anonymous Total Entries: 1 CTRL+C ESC q Quit SPACE n Next Page Previous Page...
  • Page 14: Enable Clipaging

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format config serial_port {baud_rate [9600 | 19200 | 38400 | 115200] | auto_logout [never | 2_minutes | 5_minutes | 10_minutes | 15_minutes]} Parameters baud_rate - (Optional) The serial bit rate that will be used to communicate with the management host.
  • Page 15: Disable Clipaging

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 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-3120-24TC:admin# enable clipaging Command: enable clipaging Success.
  • Page 16 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format login Parameters None. Restrictions None. Example To login the Switch with a user name dlink: DGS-3120-24TC:admin# login Command: login UserName:dlink PassWord:**** DGS-3120-24TC:admin# logout Description This command is used to logout the facility. Format logout Parameters...
  • Page 17 Press any key to login... DGS-3120-24TC Gigabit Ethernet Switch Command Line Interface Firmware: Build 2.00.010 Copyright(C) 2011 D-Link Corporation. All rights reserved. UserName: Description This command is used to display the usage description for all commands in the cuurent login account level or the specific one.
  • Page 18 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide clear Description The command is used to clear screen. Format clear Parameters None. Restrictions None. Example To clear screen: DGS-3120-24TC:admin# clear Command: clear DGS-3120-24TC:admin# 2-10 show command_history Description The command is used to display command history.
  • Page 19 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#show command_history Command: show command_history ? ping login show serial_port show session ? config bpdu_protection ports ? reset ? create account ? create ipif show DGS-3120-24TC:admin# 2-11 config command_history Description This command is used to configure the number of commands that the Switch can recall.
  • Page 20 To edit the banner: DGS-3120-24TC:admin#config greeting_message Command: config greeting_message Greeting Messages Editor ================================================================================ DGS-3120-24TC Gigabit Ethernet Switch Command Line Interface Firmware: Build 2.00.010 Copyright(C) 2011 D-Link Corporation. All rights reserved. ================================================================================ <Function Key> <Control Key> Ctrl+C Quit without save left/right/ Ctrl+W...
  • Page 21 To display greeting message: DGS-3120-24TC:admin#show greeting_ message Command: show greeting_message ================================================================================ DGS-3120-24TC Gigabit Ethernet Switch Command Line Interface Firmware: Build 2.00.010 Copyright(C) 2011 D-Link Corporation. All rights reserved. ================================================================================ DGS-3120-24TC:admin# 2-14 config command_prompt Description This command is used to modify the command prompt.
  • Page 22: Config Terminal Width

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format config command_prompt [<string 16> | username | default] Parameters <string 16> - Enter the new command prompt string of no more than 16 characters. username - Enter this command to set the login username as the command prompt. default - Enter this command to return the command prompt to its original factory default value.
  • Page 23: Show Terminal Width

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions None. Example To configure the current terminal width: DGS-3120-24TC:admin# config terminal width 120 Command: config terminal width 120 Success. DGS-3120-24TC:admin# 2-16 show terminal width Description The command is used to display the configuration of current terminal width. Format show terminal width Parameters...
  • Page 24 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format config ports [<portlist> | all] {medium_type [fiber | copper]} {speed [auto | 10_half | 10_full | 100_half | 100_full | 1000_full {[master | slave]}] | flow_control [enable | disable] | learning [enable | disable] | state [enable | disable] | mdix [auto | normal | cross] | [description <desc 1-32>...
  • Page 25: Show Ports

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#config ports all medium_type copper speed auto Command: config ports all medium_type copper speed auto Success. DGS-3120-24TC:admin# 2-18 show ports Description This command is used to display the current configurations of a range of ports. Format show ports {<portlist>} {[description | err_disabled | details | media_type]} Parameters...
  • Page 26 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#show ports details Command: show ports details Port : 1:1 -------------------- Port Status : Link Down Description HardWare Type : Gigabits Ethernet MAC Address : 00-01-02-03-04-10 Bandwidth : 1000000Kbit Auto-Negotiation : Enabled...
  • Page 27: Chapter 3 802.1Q Vlan Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 3 802.1Q VLAN Command List create vlan <vlan_name 32> tag <vlanid 2-4094> {type [1q_vlan | private_vlan]} {advertisement} create vlan vlanid <vidlist> {type [1q_vlan | private_vlan]} {advertisement} delete vlan <vlan_name 32>...
  • Page 28: Create Vlan Vlanid

    ® xStack DGS-3120 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 a VLAN with name “v2” and VLAN ID 2: DGS-3120-24TC:admin# create vlan v2 tag 2 type 1q_vlan advertisement Command: create vlan v2 tag 2 type 1q_vlan advertisement Success.
  • Page 29: Delete Vlan

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide delete vlan Description This command is used to delete a previously configured VLAN by the name on the Switch. Format delete vlan <vlan_name 32> Parameters vlan - The VLAN name of the VLAN to be deleted. <vlan_name 32>...
  • Page 30: Config Vlan

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To remove VLANs from 10-30: DGS-3120-24TC:admin# delete vlan vlanid 10-30 Command: delete vlan vlanid 10-30 Success. DGS-3120-24TC:admin# config vlan Description This command is used to configure a VLAN based on the name. Format config vlan <vlan_name 32>...
  • Page 31: Config Vlan Vlanid

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide config vlan vlanid Description This command allows you to configure multiple VLANs at one time. But conflicts will be generated if you configure the name of multiple VLANs at one time. Format config vlan vlanid <vidlist>...
  • Page 32: Show Vlan

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters <portlist> - A range of ports for which you want ingress checking. The port list is specified by listing the lowest switch number and the beginning port number on that switch, separated by a colon.
  • Page 33: Show Vlan Ports

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions None. Example To display VLAN settings: DGS-3120-24TC:admin#show vlan Command: show vlan VLAN Trunk State : Disabled VLAN Trunk Member Ports : VLAN Name : default VLAN Type : Static Advertisement : Enabled Member Ports...
  • Page 34: Show Vlan Vlanid

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#show vlan ports 1:6 Command: show vlan ports 1:6 Port Untagged Tagged Dynamic Forbidden ----- ---- -------- ------ ------- --------- DGS-3120-24TC:admin# 3-10 show vlan vlanid Description This command is used to display the vlan information using the VLAN ID. Format show vlan vlanid <vidlist>...
  • Page 35 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 3-11 show port_vlan Description This command is used to display the ports’ VLAN attributes on the Switch. Format show port_vlan {<portlist>} Parameters <portlist> - (Optional) Specify a range of ports to be displayed. (UnitID:port number). If no parameter specified, system will display all ports gvrp information.
  • Page 36: Enable Pvid Auto Assign

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 3-12 enable pvid auto assign Description This command is used to enable the auto-assignment of PVID. If “Auto-assign PVID” is enabled, PVID will be possibly changed by PVID or VLAN configuration. When user configures a port to VLAN X’s untagged membership, this port’s PVID will be updated with VLAN X.
  • Page 37: Config Gvrp

    ® xStack DGS-3120 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 the auto-assign PVID: DGS-3120-24TC:admin# disable pvid auto_assign Command: disable pvid auto_assign Success. DGS-3120-24TC:admin# 3-14 show pvid auto_assign...
  • Page 38: Show Gvrp

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format config gvrp [timer [join | leave | leaveall] < value 100-100000> | nni_bpdu_addr [dot1d | dot1ad]] Parameters timer - Specify that the GVRP timer parameter will be configured. join - (Optional) Specify the Join time will be set.
  • Page 39: Enable Gvrp

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To display the global setting of GVRP: DGS-3120-24TC:admin#show gvrp Command: show gvrp Global GVRP : Disabled Join Time : 200 Milliseconds Leave Time : 600 Milliseconds LeaveAll Time : 10000 Milliseconds NNI BPDU Address: dot1d DGS-3120-24TC:admin#...
  • Page 40 ® xStack DGS-3120 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 the Generic VLAN Registration Protocol (GVRP): DGS-3120-24TC:admin# disable gvrp Command: disable gvrp Success.
  • Page 41: Show Private Vlan

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# config private_vlan p1 add community vlanid 2-5 Command: config private_vlan p1 add community vlanid 2-5 Success. DGS-3120-24TC:admin# 3-20 show private vlan Description This command is used to show the private VLAN information. Format show private_vlan {[<vlan_name 32>...
  • Page 42 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide...
  • Page 43: Chapter 4 802.1X Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 4 802.1X Command List 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] config 802.1x fwd_pdu system [enable | disable] config 802.1x fwd_pdu ports [<portlist>...
  • Page 44 ® xStack DGS-3120 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 Used to enable the 802.1X function: DGS-3120-24TC:admin# enable 802.1x Command: enable 802.1x Success.
  • Page 45 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 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> - Enter the username to be added. This value can be up to 15 characters long. Restrictions Only Administrator, Operator and Power-User level users can issue this command.
  • Page 46 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#delete 802.1x user test Command: delete 802.1x user test Success. DGS-3120-24TC:admin# show 802.1x user Description This command is used to display the 802.1X user. Format show 802.1x user Parameters None.
  • Page 47 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters local - Specify the authentication protocol as local. radius_eap - Specify the authentication protocol as RADIUS EAP. Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To configure the 802.1X authentication protocol to RADIUS EAP: DGS-3120-24TC:admin# config 802.1x auth_protocol radius_eap...
  • Page 48 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# config 802.1x fwd_pdu system enable Command: config 802.1x fwd_pdu system enable Success. DGS-3120-24TC:admin# config 802.1x fwd_pdu ports Description This command is used to control the forwarding of EAPOL PDU. When 802.1X functionality is disabled globally or for a port, and if 802.1X fwd_pdu is enabled both globally and for the port, a received EAPOL packet on the port will be flooded in the same VLAN to those ports for which 802.1X fwd_pdu is enabled and 802.1X is disabled (globally or just for the port).
  • Page 49 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format config 802.1x authorization attributes radius [enable | disable] Parameters radius - If specified to enable, the authorization 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 50 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#show 802.1x auth_configuration ports Command: show 802.1x auth_configuration ports 1:1 Port Number : 1:1 Capability : None AdminCrlDir : Both OpenCrlDir : Both Port Control : Auto QuietPeriod : 60 TxPeriod...
  • Page 51 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To configure the port capability: DGS-3120-24TC:admin# config 802.1x capability ports 1:1-1:10 authenticator Command: config 802.1x capability ports 1:1-1:10 authenticator Success. DGS-3120-24TC:admin# 4-12 config 802.1x max_users Description This command is used to limit the maximum number of users that can be learned via 802.1X authentication.
  • Page 52 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format config 802.1x auth_parameter ports [<portlist> | all] [default | {direction [both | in] | port_control [force_unauth | auto | force_auth] | quiet_period <sec 0-65535> | tx_period <sec 1-65535>...
  • Page 53 ® xStack DGS-3120 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 parameters that control the operation of the authenticator associated with a port: DGS-3120-24TC:admin# config 802.1x auth_parameter ports 1:1-1:20 direction both...
  • Page 54 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format config 802.1x init [port_based ports [<portlist> | all] | mac_based ports [<portlist> | all] {mac_address <macaddr>}] Parameters port_based ports- Configure the authentication as port based mode. <portlist>...
  • Page 55 ® xStack DGS-3120 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 re-authenticate the device connected to the port: DGS-3120-24TC:admin# config 802.1x reauth port_based ports all Command: config 802.1x reauth port_based ports all Success.
  • Page 56 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format delete 802.1x guest_vlan {<vlan_name 32>} Parameters <vlan_name 32> - (Optional) Enter the VLAN name here. The VLAN name can be up to 32 characters long. Restrictions Only Administrator, Operator and Power-User level users can issue this command.
  • Page 57: Config Radius Add

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#config 802.1x guest_vlan ports 1:2-1:8 state enable Command: config 802.1x guest_vlan ports 1:2-1:8 state enable Warning, The ports are moved to Guest VLAN. Success. DGS-3120-24TC:admin# 4-20 show 802.1x guest_vlan Description This command is used to show the information of guest VLANs.
  • Page 58: Config Radius Delete

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format config radius add <server_index 1-3> [<server_ip> | <ipv6addr>] [key <password 32> | encryption_key <password 56>] [default | {auth_port <udp_port_number 1-65535 > | acct_port <udp_port_number 1-65535 > | timeout <sec 1-255> | retransmit<int 1-20>}] Parameters <server_index 1-3>...
  • Page 59: Config Radius

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format config radius delete <server_index 1-3> Parameters <server_index 1-3> - Specify to delete a RADIUS server.Enter the RADIUS server index. Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To delete a radius server: DGS-3120-24TC:admin# config radius delete 1...
  • Page 60: Show Radius

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide <udp_port_number 1-65535> - Enter the authentication port number here. This value must be between 1 and 65535. default - Specify that the default port number will be used. acct_port - (Optional) Specify the UDP port number which is used to transmit RADIUS accounting statistics between the Switch and the RADIUS server.
  • Page 61 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# show radius Command: show radius Index 1 IP Address : 172.18.211.71 Auth-Port : 1812 Acct-Port : 1813 Timeout : 5 sec Retransmit : 1234567 Index 2 IP Address : 172.18.211.108 Auth-Port...
  • Page 62 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#show auth_statistics ports 1:1 Command: show auth_statistics ports 1:1 Port Number : 1:1 EapolFramesRx EapolFramesTx EapolStartFramesRx EapolReqIdFramesTx EapolLogoffFramesRx EapolReqFramesTx EapolRespIdFramesRx EapolRespFramesRx InvalidEapolFramesRx EapLengthErrorFramesRx LastEapolFrameVersion LastEapolFrameSource 00-00-00-00-00-00 CTRL+C ESC q Quit SPACE n Next Page...
  • Page 63 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#show auth_diagnostics ports 1:1 Command: show auth_diagnostics ports 1:1 Port Number : 1:1 EntersConnecting EapLogoffsWhileConnecting EntersAuthenticating SuccessWhileAuthenticating TimeoutsWhileAuthenticating FailWhileAuthenticating ReauthsWhileAuthenticating EapStartsWhileAuthenticating EapLogoffWhileAuthenticating ReauthsWhileAuthenticated EapStartsWhileAuthenticated EapLogoffWhileAuthenticated BackendResponses BackendAccessChallenges BackendOtherRequestsToSupplicant BackendNonNakResponsesFromSupplicant BackendAuthSuccesses...
  • Page 64 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# show auth_session_statistics ports 1:1 Command: show auth_session_statistics ports 1:1 Port Number : 1:1 SessionOctetsRx SessionOctetsTx SessionFramesRx SessionFramesTx SessionId SessionAuthenticMethod Remote Authentication Server SessionTime SessionTerminateCause SupplicantLogoff SessionUserName CTRL+C ESC q Quit SPACE n...
  • Page 65 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#show auth_client Command: show auth_client radiusAuthClient ==> radiusAuthClientInvalidServerAddresses radiusAuthClientIdentifier D-Link radiusAuthServerEntry ==> radiusAuthServerIndex :3 radiusAuthServerAddress 0.0.0.0 radiusAuthClientServerPortNumber radiusAuthClientRoundTripTime radiusAuthClientAccessRequests radiusAuthClientAccessRetransmissions radiusAuthClientAccessAccepts radiusAuthClientAccessRejects radiusAuthClientAccessChallenges radiusAuthClientMalformedAccessResponses 0 radiusAuthClientBadAuthenticators radiusAuthClientPendingRequests...
  • Page 66: Config Accounting Service

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC: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 radiusAccClientUnknownTypes...
  • Page 67: Show Accounting Service

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example Enable it to configure accounting shell state: DGS-3120-24TC:admin# config accounting service shell state enable Command: config accounting service shell state enable Success. DGS-3120-24TC:admin# 4-31 show accounting service Description This command is used to show the status of RADIUS accounting services.
  • Page 68: Chapter 5 Access Authentication Control Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 5 Access Authentication Control Command List enable authen_policy_encryption disable authen_policy_encryption enable password encryption disable password encryption enable authen_policy disable authen_policy show authen_policy 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 69 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters None. Restrictions Only Administrator-level users can issue this command. Example To enable the authentication policy encryption: DGS-3120-24TC:admin#enable authen_policy_encryption Command: enable authen_policy_encryption Success. DGS-3120-24TC:admin# disable authen_policy_encryption Description This command is used to disable the authentication policy encryption.
  • Page 70: Enable Password Encryption

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide enable password encryption Description This command is used to enable password encryption. The user account configuration information will be stored in the configuration file, and can be applied to the system later. If the password encryption is enabled, the password will be in encrypted form.
  • Page 71: Enable Authen_Policy

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator-level users can issue this command. Example To disable the password encryption: DGS-3120-24TC:admin#disable password encryption Command: disable password encryption Success. DGS-3120-24TC:admin# enable authen_policy Description This command is used to enable system access authentication policy. Enable system access authentication policy.
  • Page 72 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide disable authen_policy Description This command is used to disable system access authentication policy. Disable system access authentication policy. When authentication is disabled, the device will adopt the local user account database to authenticate the user for login, and adopt the local enable password to authenticate the enable password for promoting the user‘s privilege to Admin level.
  • Page 73: Create Authen_Login Method_List_Name

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To display system access authentication policy: DGS-3120-24TC:admin#show authen_policy Command: show authen_policy Authentication Policy : Enabled Authentication Policy Encryption: Enabled DGS-3120-24TC:admin# create authen_login Description This command is used to create a user-defined method list of authentication methods for user login.
  • Page 74: Delete Authen_Login Method_List_Name

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide methods like tacacs/xtacacs/tacacs+/radius built-in or user-defined server groups or none, the “user” privilege level is assigned only. If user wants to get admin privilege level, user must use the “enable admin”...
  • Page 75: Show Authen_Login [Default | Method_List_Name | All]

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters <string 15> - The user-defined method list name. This value can be up to 15 characters long. Restrictions Only Administrator-level users can issue this command. Example To delete a user-defined method list for user login: DGS-3120-24TC:admin# delete authen_login method_list_name login_list_1 Command: delete authen_login method_list_name login_list_1...
  • Page 76: Create Authen_Enable Method_List_Name

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# show authen_login method_list_name login_list_1 Command: show authen_login method_list_name login_list_1 Method List Name Priority Method Name Comment ---------------- -------- --------------- ------------------ login_list_1 tacacs+ Built-in Group tacacs Built-in Group mix_1 User-defined Group local...
  • Page 77: Tacacs+ | Radius | Server_Group | Local _Enable | None

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide server hosts in tacacs+ group are missing, the authentication request will be sent to the first server host in tacacs group…If all server hosts in tacacs group are missing, the local enable password in the device is used to authenticate this user’s password.
  • Page 78: Show Authen_Enable [Default | Method_List_Name | All]

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters <string 15> - The user-defined method list name. This value can be up to 15 characters long. Restrictions Only Administrator-level users can issue this command. Example To delete a user-defined method list for promoting user's privilege to Admin level: DGS-3120-24TC:admin# delete authen_enable method_list_name enable_list_1 Command: delete authen_enable method_list_name enable_list_1...
  • Page 79: Config Authen Application [Console | Telnet | Ssh | Http | All] [Login | Enable]

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#show authen_enable method_list_name enable_list_1 Command: show authen_enable method_list_name enable_list_1 Method List Name Priority Method Name Comment ---------------- -------- --------------- ------------------ enable_list_1 local_enable Keyword DGS-3120-24TC:admin# 5-16 config authen application Description This command is used to configure login or enable method list for all or the specified application.
  • Page 80: Show Authen Application

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 5-17 show authen application Description This command is used to display the login/enable method list for all applications. Format show authen application Parameters None. Restrictions Only Administrator-level users can issue this command. Example To display the login/enable method list for all applications: DGS-3120-24TC:admin# show authen application...
  • Page 81: Server_Host [ | ]Protocol [Tacacs | Xtacacs | Tacacs+| Radius]

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator-level users can issue this command. Example To create a user-defined authentication server group: DGS-3120-24TC:admin# create authen server_group mix_1 Command: create authen server_group mix_1 Success. DGS-3120-24TC:admin# 5-19 config authen server_group...
  • Page 82: Delete Authen Server_Group

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# config authen server_group mix_1 add server_host 10.1.1.222 protocol tacacs+ Command: config authen server_group mix_1 add server_host 10.1.1.222 protocol tacacs+ Success. DGS-3120-24TC:admin# 5-20 delete authen server_group Description This command is used to delete a user-defined authentication server group.
  • Page 83: 255> | Retransmit

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator-level users can issue this command. Example To display all authentication server groups: DGS-3120-24TC:admin# show authen server_group Command: show authen server_group Group Name IP Address Protocol --------------- ---------------...
  • Page 84: 255> | Retransmit

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide encryption will apply. This value is meaningless for TACACS and XTACACS. <key_string 254> - Enter the TACACS+ or the RADIUS key here. This key can be up to 254 characters long.
  • Page 85: Delete Authen Server_Host Protocol [Tacacs | Xtacacs | Tacacs+ | Radius]

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide <int 1-65535> - Enter the port number here. This value must be between 1 and 65535. key - (Optional) The key for TACACS+ and RADIUS authentication. If the value is null, no encryption will apply.
  • Page 86: Show Authen Server_Host

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To delete an authentication server host: DGS-3120-24TC:admin# delete authen server_host 10.1.1.222 protocol tacacs+ Command: delete authen server_host 10.1.1.222 protocol tacacs+ Success. DGS-3120-24TC:admin# 5-25 show authen server_host Description This command is used to display the authentication server hosts.
  • Page 87: Config Authen Parameter Response_Timeout

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format config authen parameter response_timeout <int 0-255> Parameters <int 0-255> - The amount of time for user input on console or telnet or SSH. 0 means there is no time out.
  • Page 88: Show Authen Parameter

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# config authen parameter attempt 9 Command: config authen parameter attempt 9 Success. DGS-3120-24TC:admin# 5-28 show authen parameter Description This command is used to display the parameters of authentication. Format show authen parameter Parameters...
  • Page 89 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format enable admin Parameters None. Restrictions None. Example To enable administrator lever privilege: DGS-3120-24TC:oper#enable admin Command: enable admin PassWord:***** Success. DGS-3120-24TC:admin# 5-30 config admin local_enable Description This command is used to config the local enable password of administrator level privilege. When the user chooses the “local_enable”...
  • Page 90 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator-level users can issue this command. Example To configure the administrator password: DGS-3120-24TC:admin#config admin local_enable Command: config admin local_enable Enter the old password: Enter the case-sensitive new password:***** Enter the new password again for confirmation:***** Success.
  • Page 91: Chapter 6 Access Control List (Acl) Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 6 Access Control List (ACL) Command List 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>...
  • Page 92 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide config time_range <range_name 32> [hours start_time <time hh:mm:ss> end_time <time hh:mm:ss> weekdays <daylist> | delete] show time_range show current_config access_profile create access_profile Description This command is used to create access list rules. Support for field selections can have additional limitations that are project dependent.
  • Page 93 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide ip - Specify this is a IPv4 mask. vlan - (Optional) Specify a VLAN mask. Only the last 12 bits of the mask will be considered. <hex 0x0-0x0fff> -Enter the VLAN mask value here. source_ip_mask - (Optional) Specify a source IP address mask.
  • Page 94 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide <hex 0x0-0xffff> - Enter the TCP source port mask value here. des_port_mask - Specify an IPv6 Layer 4 TCP destination port mask. <hex 0x0-0xffff> - Enter the TCP destination port mask value here. udp - (Optional) Specify that the rule applies to UDP traffic.
  • Page 95 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format delete access_profile [profile_id <value 1-6> | profile_name <name 1-32> | all] Parameters profile_id - Specify the index of the access list profile. <value 1-6> - Enter the profile ID value here. This value must be between 1 and 6. profile_name - Specify the name of the profile.
  • Page 96 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide {mask <ipv6mask>} | destination_ipv6 <ipv6addr> {mask <ipv6mask>} | [tcp {src_port <value 0-65535> {mask <hex 0x0-0xffff>} | dst_port <value 0-65535> {mask <hex0x0-0xffff>}} | udp {src_port <value 0-65535> {mask <hex 0x0-0xffff>} | dst_port <value 0-65535> {mask <hex 0x0-0xffff>}} | icmp {type<value 0-255>...
  • Page 97 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide <hex 0x0-0x0fff> - Enter the mask value here. source_ip - (Optional) Specify an IP source address. <ipaddr> - Enter the source IP address used for this configuration here. mask - Specify an additional mask parameter that can be configured.
  • Page 98 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide packet_content - A maximum of 11 offsets can be specified. Each offset defines 2 bytes of data which is identified as a single UDF field. The offset reference is also configurable. It can be defined to start at the end of the tag, the end of the ether type or the end of the IP header.
  • Page 99 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide port - Specify the port list used for this configuration. <portlist> - Enter a list of ports used for the configuration here. all - Specify that all the ports will be used for this configuration. vlan_based - Specify that the rule will be VLAN based.
  • Page 100 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide show access_profile Description This command is used to display the current access list table. Format show access_profile {[profile_id <value 1-6> | profile_name <name 1-32>]} Parameters profile_id - (Optional) Specify the index of the access list profile. <value 1-6>...
  • Page 101 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Permit ============================================================================== ============================================================================== Profile ID: 2 Profile name: IPv4ACL Type: IPv4 MASK on VLAN : 0xFFF DSCP ICMP Available HW Entries : 255 ------------------------------------------------------------------------------ Rule ID : 1 Ports: 1:2 Match on VLAN ID...
  • Page 102 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Available HW Entries : 255 ------------------------------------------------------------------------------- Rule ID : 1 Ports: 1:4 Match on offset_chunk_1 : 0 value : 0x0000FFEE Mask : 0x0000FFEE Action: Permit Priority Replace DSCP ============================================================================== DGS-3120-24TC:admin# The following example displays an access profile that supports an entry mask for each rule:...
  • Page 103 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#show access_profile profile_id 5 Command: show access_profile profile_id 5 Access Profile Table Profile ID: 5 Profile name:5 Type: User Defined MASK on offset_chunk_1 : 3 value : 0x0000FFFF offset_chunk_2 : 5 value : 0x0000FF00 offset_chunk_3 : 14...
  • Page 104 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide The replace DSCP action can be performed on packets that conform (GREEN) and packets that do not conform (YELLOW and RED). If drop YELLOW/RED is selected, the action to replace the DSCP will not take effect.
  • Page 105 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide optional parameter. The default value is 4*1024. <value 0-131072> - Enter the peak burst size value here. This value must be between 0 and 131072. color_blind - (Optional) Specify the meter mode as color-blind. The default is color-blind mode.
  • Page 106 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide when the function is disabled. enable - Specify that the ACL counter option will be enabled. disable - Specify that the ACL counter option will be disabled. exceed - Specify the action when a packet is mapped to the “yellow”...
  • Page 107 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters profile_id - (Optional) Specify the profile ID. <value 1-6> - Enter the profile ID used here. This value must be between 1 and 6. A lower value denotes a higher priority.
  • Page 108 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide hours - Specify the time of a day. start_time - Specify the starting time of a day. <time hh:mm:ss> - Enter the starting time here. (24-hr time). For example, 19:00 means 7PM.
  • Page 109 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions None. Example To display the current time range settings: DGS-3120-24TC:admin# show time_range Command: show time_range Time Range Information ----------------------------- Range Name : test Weekdays : Sun,Tue Start Time : 11:00:00 End Time...
  • Page 110 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# show current_config access_profile Command: show current_config access_profile #------------------------------------------------------------------- # ACL create access_profile ethernet vlan profile_id 1 config access_profile profile_id 1 add access_id 1 ethernet vlan default port 1 permit create access_profile ip source_ip_mask 255.255.255.255 profile_id 2 config access_profile profile_id 2 add access_id 1 ip source_ip 10.10.10.10...
  • Page 111: Chapter 7 Access Control List (Acl) Egress Command List (Ei Mode Only)

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 7 Access Control List (ACL) Egress Command List (EI Mode Only) 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>...
  • Page 112: Create Egress_Access_Profile Profile_Id Profile_Name

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide create egress_access_profile profile_id Description This command is used to create an egress access list profile. For example, for some hardware, it may be invalid to specify destination IPv6 address and source IPv6 address at the same time. The user will be prompted for these limitations.
  • Page 113 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide dst_port_mask - Specify the TCP destination port mask. <hex 0x0-0xffff> - Enter the TCP source port mask value here. flag_mask - (Optional) Specify the TCP flag field mask. all - Specify that the TCP flag field mask will be set to 'all'.
  • Page 114: Access_Id [Auto_Assign | ] [Ethernet {[Vlan | Vlan_Id

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide delete egress_access_profile Description This command is used to delete egress access profile command can only delete the profile which is created by egress ACL module. Format delete egress_access_profile [profile_id <value 1-4> | profile_name <name 1-32> | all] Parameters profile_id - Specify the index of the egress access list profile.
  • Page 115: Value 0-255> | Source_Ipv6 {Mask } | Destination_Ipv6

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide <value 0-255> | source_ipv6 <ipv6addr> {mask <ipv6mask>} | destination_ipv6 <ipv6addr> {mask <ipv6mask>} | [tcp {src_port <value 0-65535> {mask <hex 0x0-0xffff>} | dst_port <value 0-65535> {mask <hex 0x0-0xffff>}} | udp {src_port <value 0-65535> {mask <hex 0x0- 0xffff>} | dst_port <value 0-65535>...
  • Page 116 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide <netmask> - Enter the destination network mask here. dscp - (Optional) Specify the value of DSCP. The DSCP value ranges from 0 to 63. <value 0-63> - Enter the DSCP value used here. This value must be between 0 and 63. icmp - (Optional) Specify that the following parameters configured will apply to the ICMP configuration.
  • Page 117 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide <ipv6mask> - Enter the IPv6 source address mask value here. destination_ipv6 - (Optional) Specify the value of IPv6 destination address. <ipv6addr> - Enter the source IPv6 destination address here. mask - Specify the IPv6 destination address mask here.
  • Page 118 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide the “counter” is overridden. enable - Specify that the ACL counter feature will be enabled. disable - Specify that the ACL counter feature will be disabled. deny - Specify the packets that match the egress access rule are filtered by the Switch. time_range - (Optional) Specify the name of the time range entry.
  • Page 119 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters profile_id - (Optional) Specify the index of the egress access list profile. <value 1-4> - Enter the profile ID here. This value must be between 1 and 4. A lower value denotes a higher priority.
  • Page 120 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide -------------------------------------------------------------------------------- Rule ID : 1 (auto assign) Ports: 1:3 Match on DSCP Action: Permit ================================================================================ ================================================================================ Profile ID: 3 Profile name: IPv6 Type: IPv6 MASK on Class Available HW Entries : 126 -------------------------------------------------------------------------------- Rule ID : 1...
  • Page 121: Show Current_Config Egress_Access_Profile

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#show egress_access_profile profile_id 1 Command: show egress_access_profile profile_id 1 Egress Access Profile Table ================================================================================ Profile ID: 1 Profile name: EthernetACL Type: Ethernet MASK on VLAN : 0xFFF 802.1p Available HW Entries : 127 --------------------------------------------------------------------------------...
  • Page 122 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# show current_config egress_access_profile Command: show current_config egress_access_profile #------------------------------------------------------------------------------- # Egress ACL create egress_access_profile profile_id 1 profile_name 1 ethernet source_mac FF- FF-FF-FF-FF-FF config egress_access_profile profile_id 1 add access_id 1 ethernet source_mac 00 -00-00-00-00-01 vlan_based vlan_id 1 permit create egress_access_profile profile_id 2 profile_name 2 ip source_ip_mask 255.2 55.255.255 destination_ip_mask 255.255.255.255 dscp...
  • Page 123 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide lower value denotes a higher priority. rate - This specifies the rate for single rate two-color mode. Specify the committed bandwidth in Kbps for the flow. The value m and n are determined by the project. <value>...
  • Page 124 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide enable - Specify that the ACL counter parameter will be enabled. disable - Specify that the ACL counter parameter will be disabled. sr_tcm - Specify the “single rate three color mode”. cir - Specify the Committed Information Rate in Kbps.
  • Page 125: Show Egress_Flow_Meter {[Profile_Id | Profile_Name ] {Access_Id

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#config egress_flow_meter profile_id 1 access_id 1 tr_tcm cir 1000 cbs 200 pir 2000 pbs 200 exceed permit replace_dscp 21 violate drop Command: config egress_flow_meter profile_id 1 access_id 1 tr_tcm cir 1000 cbs 200 pir 2000 pbs 200 exceed permit replace_dscp 21 violate drop Success.
  • Page 126 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#show egress_flow_meter Command: show egress_flow_meter Flow Meter Information ------------------------------------------------------------------------------ Profile ID:1 Aceess ID:1 Mode : trTCM / ColorAware CIR(Kbps):1000 CBS(Kbyte):1000 PIR(Kbps):2000 PBS(Kbyte):2000 Action: Conform : Permit Counter: Enabled Exceed : Drop Counter: Enabled Violate : Drop...
  • Page 127 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# create port_group id 2 name group2 Command: create port_group id 2 name group2 Success. DGS-3120-24TC:admin# config port_group Description This command is used to add or delete a port list to a port group. Format config port_group [id <value 1-64>...
  • Page 128 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters id - Specify the port group ID. <value 1-64> - Enter the port group ID used here. This value must be between 1 and 64. name - Specify the port group name. <name 16>...
  • Page 129 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#show port_group Command: show port_group Port Group Table --------------------------------------------- Port Group ID Port Group Name Ports group2 1:1-1:3 Total Entries :1 DGS-3120-24TC:admin#...
  • Page 130: Chapter 8 Address Resolution Protocol (Arp) Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 8 Address Resolution Protocol (ARP) Command List create arpentry <ipaddr> <macaddr> delete arpentry [<ipaddr> | all] config arpentry <ipaddr> <macaddr> config arp_aging time <min 0-65535> clear arptable show arpentry {ipif <ipif_name 12>...
  • Page 131: Config Arpentry

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format delete arpentry [<ipaddr> | all] Parameters <ipaddr> - The IP address of the end node or station. all - Delete all ARP entries. Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To delete an entry of IP address 10.48.74.121 from the ARP table: DGS-3120-24TC:admin# delete arpentry 10.48.74.121...
  • Page 132: Clear Arptable

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# config arpentry 10.48.74.121 00-50-BA-00-07-37 Command: config arpentry 10.48.74.121 00-50-BA-00-07-37 Success. DGS-3120-24TC:admin# config arp_aging time Description This command is used to set the maximum amount of time, in minutes, that a dynamic ARP entry can remain in the Switch’s ARP table, without being accessed, before it is dropped from the table.
  • Page 133: Show Arpentry

    ® xStack DGS-3120 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 ARP table: DGS-3120-24TC:admin# clear arptable Command: clear arptable Success. DGS-3120-24TC:admin# show arpentry Description This command is used to displays the ARP table.
  • Page 134 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# show arpentry Command: show arpentry ARP Aging Time : 20 Interface IP Address MAC Address Type ------------- --------------- ----------------- --------------- System 10.0.0.0 FF-FF-FF-FF-FF-FF Local/Broadcast System 10.1.1.1 00-02-03-04-05-06 Static System...
  • Page 135: Chapter 9 Arp Spoofing Prevention Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 9 ARP Spoofing Prevention Command List 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 This command is used to configure the spoofing prevention entry to prevent spoofing of MAC for the protected gateway.
  • Page 136 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#config arp_spoofing_prevention add gateway_ip 10.254.254.251 gateway_mac 00-00-00-11-11-11 ports 1:1-1:2 Command: config arp_spoofing_prevention add gateway_ip 10.254.254.251 gateway_mac 00-00-00-11-11-11 ports 1:1-1:2 Success. DGS-3120-24TC:admin# show arp_spoofing_prevention Description This command is used to show the ARP spoofing prevention entry. Format show arp_spoofing_prevention Parameters...
  • Page 137: Chapter 10 Asymmetric Vlan Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 10 Asymmetric VLAN Command List enable asymmetric_vlan disable asymmetric_vlan show asymmetric_vlan 10-1 enable asymmetric_vlan Description This command is used to enable the asymmetric VLAN function on the Switch. Format enable asymmetric_vlan Parameters...
  • Page 138 ® xStack DGS-3120 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 asymmetric VLANs: DGS-3120-24TC:admin# disable asymmetric_vlan Command: disable asymmetric_vlan Success. DGS-3120-24TC:admin# 10-3 show asymmetric_vlan Description...
  • Page 139: Chapter 11 Auto-Configuration Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 11 Auto-Configuration Command List enable autoconfig disable autoconfig show autoconfig 11-1 enable autoconfig Description This command is used to enable auto configuration. When enabled, during power on initialization, the Switch will get configure file path name and TFTP server IP address from the DHCP server.
  • Page 140: Show Autoconfig

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format disable autoconfig Parameters None. Restrictions Only Administrator and Operator-level users can issue this command. Example To disable autoconfig: DGS-3120-24TC:admin# disable autoconfig Command: disable autoconfig Success. DGS-3120-24TC:admin# 11-3 show autoconfig Description...
  • Page 141: Chapter 12 Basic Commands Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 12 Basic Commands Command List create account [admin | operator | power_user | user] <username 15> {encrypt [plain_text | sha_1] <password>} config account <username> {encrypt [plain_text | sha_1] <password>} show account delete account <username>...
  • Page 142: Config Account

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide encrypt - (Optional) Specify the encryption applied to the account. plain_text - Select to specify the password in plain text form. sha_1 - Select to specify the password in the SHA-I encrypted form. <password>...
  • Page 143: Show Account

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters <username> - Enter the user name of the account that has been defined. encrypt - (Optional) Specify that the password will be encrypted. plain_text - Select to specify the password in plain text form. sha_1 - Select to specify the password in the SHA-I enacrpted form.
  • Page 144: Delete Account

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator-level users can issue this command. Example To display the accounts that have been created: DGS-3120-24TC:admin#show account Command: show account Current Accounts: Username Access Level --------------- ------------ admin...
  • Page 145: Show Switch

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 12-5 show switch Description This command is used to display the Switch information. Format show switch Parameters None. Restrictions None. Example The following is an example for display of the Switch information. DGS-3120-24TC:admin#show switch Command: show switch Device Type...
  • Page 146: Enable Telnet

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 12-6 enable telnet Description This command is used to manage the Switch via TELNET based management software. Use the command to enable TELNET and configure port number. Format enable telnet {<tcp_port_number 1-65535>} Parameters...
  • Page 147: Enable Web

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To disable TELNET: DGS-3120-24TC:admin# disable telnet Command: disable telnet Success. DGS-3120-24TC:admin# 12-8 enable web Description This command is used to manage the Switch via HTTP based management software. Use the command to enable HTTP and configure port number.
  • Page 148 ® xStack DGS-3120 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 disable HTTP: DGS-3120-24TC:admin# disable web Command: disable web Success. DGS-3120-24TC:admin# 12-10 reboot Description This command is used to restart the Switch.
  • Page 149: Config Firmware Image

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 12-11 reset Description This command is used to provide reset functions. The configuration setting will be reset to the default setting. For the “save system” command, the device will store the reset setting in the NVRAM and then reboot the system.
  • Page 150 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format config firmware image {unit <unit_id>} <pathname> boot_up Parameters unit - (Optional) Specify which unit on the stacking system. If it is not specified, it refers to the master unit.
  • Page 151: Config Ipif

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide enable - Specify that the proxy ARP option will be enabled. disable - Specify that the proxy ARP option will be disabled. local - (Optional) This setting controls whether the system provides the proxy reply for the ARP packets destined for IP address located in the same interface as the received interface.
  • Page 152 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide disable - Disable the state of the interface. proxy_arp - Enable/disable of proxy ARP function. It is for IPv4 function. Default: Disabled. (EI Mode Only) enable - Specify that the proxy ARP option will be enabled. disable - Specify that the proxy ARP option will be disabled.
  • Page 153 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#config ipif System ipaddress 192.168.69.123/24 vlan default Command: config ipif System ipaddress 192.168.69.123/24 vlan default Success. DGS-3120-24TC:admin# 12-15 delete ipif (EI Mode Only) Description This command is used to delete an IP interface. Format delete ipif [<ipif_name 12>...
  • Page 154 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters ipif_name - Specify 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 155: Show Ipif

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 12-18 show ipif Description This command is used to display an IP interface. Format show ipif {<ipif_name 12>} Parameters ipif_name - Specify the name of the IP interface. <ipif_name 12>...
  • Page 156 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide processing will be disabled. By enable this automatic configuration, the link local address will be automatically configured and IPv6 processing will be started. Format enable ipif_ipv6_link_local_auto [<ipif_name 12> | all] Parameters <ipif_name 12>...
  • Page 157 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#disable ipif_ipv6_link_local_auto newone Command: disable ipif_ipv6_link_local_auto newone Success. DGS-3120-24TC:admin# 12-21 show ipif_ipv6_link_local_auto (EI Mode Only) Description This commands is used to display the link local address automatic configuration state. Format show ipif_ipv6_link_local_auto {<ipif_name 12>} Parameters...
  • Page 158: Chapter 13 Bpdu Attack Protection Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 13 BPDU Attack Protection Command List config bpdu_protection ports [<portlist> | all ] {state [enable | disable] | mode [ drop | block | shutdown} (1) config bpdu_protection recovery_timer [<sec 60-1000000>...
  • Page 159 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To set the port state enable and drop mode: DGS-3120-24TC:admin# config bpdu_protection ports 1 state enable mode drop Commands: config bpdu_protection ports 1 state enable mode drop Success.
  • Page 160 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format config bpdu_protection [trap | log] [none | attack_detected | attack_cleared | both] Parameters trap - To specify the trap state. log - To specify the log state. none - Neither attack_detected nor attack_cleared is trapped or logged.
  • Page 161 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# enable bpdu_protection Commands: enable bpdu_protection Success. DGS-3120-24TC:admin# 13-5 disable bpdu_protection Description This command is used to disable BPDU protection function globally for the Switch. Format disable bpdu_protection Parameters None.
  • Page 162 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions None. Example To show the bpdu_protection for the entire switch: DGS-3120-24TC:admin# show bpdu_protection Commands: show bpdu_protection BPDU Protection Global Settings --------------------------------------- BPDU Protection status : Enabled BPDU Protection Recovery Time : 60 seconds BPDU Protection Trap State...
  • Page 163: Chapter 14 Cable Diagnostics Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 14 Cable Diagnostics Command List cable_diag ports [<portlist> | all] 14-1 cable_diag ports Description This command is used to configure cable diagnostics on ports. For FE port, two pairs of cable will be diagnosed.
  • Page 164 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide • When the link partner is powered down with errors, this command can detect whether the error is open, short, or crosstalk. In this case this command can also detect the distance of the error.
  • Page 165 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#cable_diag ports 1:1,1:11-1:12 Command: cable_diag ports 1:1,1:11-1:12 Perform Cable Diagnostics ... Port Type Link Status Test Result Cable Length (M) ------ ---------- ------------- ------------------------- ----------------- 1000BASE-T Link Up 1:11 1000BASE-T Link Down...
  • Page 166: Chapter 15 Command Logging Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 15 Command Logging Command List enable command logging disable command logging show command logging 15-1 enable command logging Description This command is used to enable the command logging function. Note: When the Switch is under the booting procedure or in the procedure of downloading the configuration, all configuration commands should not be logged.
  • Page 167: Show Command Logging

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format disable command logging Parameters None. Restrictions Only Administrator-level users can issue this command. Example To disable the command logging: DGS-3120-24TC:admin# disable command logging Command: disable command logging Success.
  • Page 168 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide...
  • Page 169: Chapter 16 Compound Authentication Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 16 Compound Authentication Command List create authentication guest_vlan [vlan <vlan_name 32> | vlanid <vlanid 1-4094>] (EI Mode Only) delete authentication guest_vlan [vlan <vlan_name 32> | vlanid <vlanid 1-4094>] (EI Mode Only) config authentication guest_vlan [vlan <vlan_name 32>...
  • Page 170 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# create authentication guest_vlan vlan guestVLAN Command: create authentication guest_vlan vlan guestVLAN Success. DGS-3120-24TC:admin# 16-2 delete authentication guest_vlan (EI Mode Only) Description This command is used to delete guest VLAN setting, but won’t delete the static VLAN. All ports which enable guest VLAN will move to original VLAN after deleting guest VLAN.
  • Page 171: Config Authentication Ports

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters vlan - Assigned a VLAN as guest VLAN. The VLAN must be an existed static VLAN. <vlan_name 32> - Enter the VLAN name here. This name can be up to 32 characters long. vlanid - Assigned a VLAN as guest VLAN.
  • Page 172 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide disable - Remove the specified VID list from authentication VLAN(s). If "vlanid" is not specified, or all VLANs is disabled, means do not care which VLAN the client comes from, the client will be authenticated if the client's MAC(not care the VLAN) is not authenticated.
  • Page 173 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide delimiter - (Optional)Specify whether to use delimiter and number of delimiters for MAC address. hyphen - (Optional) Use “-” when specifying MAC address, e.g. aa-bb-cc-dd-ee-ff. colon - (Optional) Use “:” when specifying MAC address, e.g. aa:bb:cc:dd:ee:ff. dot - (Optional) Use “.”when specifying MAC address, e.g.
  • Page 174: Show Authentication Ports

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#show authentication guest_vlan Command: show authentication guest_vlan Guest VLAN VID Guest VLAN Member Ports: 1:1-1:24 Total Entries: 1 DGS-3120-24TC:admin# 16-7 show authentication ports Description This command is used to display authentication setting on port(s). Format show authentication ports {<portlist>} Parameters...
  • Page 175: Enable Authorization Attributes

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 16-8 enable authorization attributes Description This command is used to enable authorization. Format enable authorization attributes Parameters None. Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example This example sets authorization global state enabled: DGS-3120-24TC:admin# enable authorization attributes...
  • Page 176: Show Authorization

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# disable authorization attributes Command: disable authorization attributes Success. DGS-3120-24TC:admin# 16-10 show authorization Description This command is used to display authorization status. Format show authorization Parameters None. Restrictions None.
  • Page 177: Show Authentication

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example Set authentication server auth fail over state: DGS-3120-24TC:admin# config authentication server failover local Command: config authentication server failover local Success.
  • Page 178 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format show authentication mac_format Parameters None. Restrictions None. Example To display the authentication MAC format settings: DGS-3120-24TC:admin#show authentication mac_format Command: show authentication mac_format Case : Uppercase Delimiter : Hyphen Delimiter Number DGS-3120-24TC:admin#...
  • Page 179: Chapter 17 Configuration Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 17 Configuration Command List show config [effective | modified | current_config | boot_up | information| file <pathname>] {[include | exclude | begin] <filter_string 80> {<filter_string 80> {<filter_string 80>}} {[include | exclude | begin ] <filter_string 80>...
  • Page 180 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide setting regarding STP is not displayed. The lower level setting will only be displayed when the higher level setting is enabled. Note: This parameter is only for the current configuration. modified - Show only the commands which are not from the ‘reset’...
  • Page 181: Config Configuration

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example The following example illustrates how the special filters ‘modified’ and .’effective’ affect the configuration display: DGS-3120-24TC:admin# show config modified Command:show config modified enable loopdetect enable ssl config ipif System vlan default ipaddress 192.168.3.4/8 state enable create arpentry 10.1.1.1 00-00-00-00-00-01 DGS-3120-24TC:admin# show config effective...
  • Page 182: Show Boot File

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To configure the Switch’s configuration file as boot up: DGS-3120-24TC:admin#config configuration config.cfg boot_up Command: config configuration config.cfg boot_up Success. DGS-3120-24TC:admin# 17-3 save Description This command is used to save the current configuration to a file. This command is required to be supported regardless of whether file system is supported or whether multiple configuration files are supported.
  • Page 183 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format show boot_file Parameters None. Restrictions None. Example To display the boot file: DGS-3120-24TC:admin#show boot_file Command: show boot_file Bootup Firmware : /c:/runtime.had Bootup Configuration : /c:/config.cfg DGS-3120-24TC:admin#...
  • Page 184: Chapter 18 Configuration Trap Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 18 Configuration Trap Command List config configuration trap {save [enable | disable] | upload [enable | disable] | download [enable | disable]} 18-1 config configuration trap Description This command is used to configure the trap status of configuration saving completed, configuration uploading completed and configuration downloading completed.When set to enabled, the SNMP...
  • Page 185 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#config configuration trap save enable Command: config configuration trap save enable Success. DGS-3120-24TC:admin#...
  • Page 186: Chapter 19 Connectivity Fault Management (Cfm) Command List (Ei Mode Only)

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 19 Connectivity Fault Management (CFM) Command List (EI Mode Only) 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]} create cfm ma <string 22>...
  • Page 187: Create Cfm Md

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide remote_mepid <int 1-8191> show cfm pkt_cnt {[ports <portlist> {[rx | tx]} | [rx | tx] | ccm]} clear cfm pkt_cnt {[ports <portlist> {[rx | tx]} | [rx | tx] | ccm]} config cfm trap [ais | lock] state [enable | disable] 19-1 create cfm md...
  • Page 188: Create Cfm Ma

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters <string 22> - Enter the maintenance domain name. This name can be up to 22 characters long. md_index - Specify the maintenance domain index. <uint 1-4294967295> - Enter the maintenance domain index value here. This value must be between 1 and 4294967295.
  • Page 189: Config Cfm Ma

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide <uint 1-4294967295> - Enter the maintenance association index value here. This value must be between 1 and 4294967295. md - Specify the maintenance domain name. <string 22> - Enter the maintenance domain name here. This name can be up to 22 characters long.
  • Page 190: Create Cfm Mep

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide be between 1 and 4294967295. vlanid - (Optional) Specify the VLAN Identifier. Different MAs must be associated with different VLANs. <vlanid 1-4094> - Enter the VLAN ID used here. This value must be between 1 and 4094. mip - (Optional) This is the control creation of MIPs.
  • Page 191: Config Cfm Mep

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format create cfm mep <string 32> mepid <int 1-8191> md [<string 22> | md_index <uint 1- 4294967295>] ma [<string 22> | ma_index <uint 1-4294967295>] direction [inward | outward] port <port>...
  • Page 192 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide • Error CCM Received: priority 4 • Some Remote MEPs Down: priority 3 • Some Remote MEP MAC Status Errors: priority 2 • Some Remote MEP Defect Indications: priority 1 If multiple types of the fault occur on an MEP, only the fault with the highest priority will be alarmed.
  • Page 193: Delete Cfm Mep

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide <centisecond 250-1000> - Enter the alarm time value here. This value must be between 250 and 1000 centiseconds. alarm_reset_time - (Optional) This is the dormant duration time before a defect is triggered before the fault can be re-alarmed.
  • Page 194: Delete Cfm Ma

    ® xStack DGS-3120 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 CFM MEP: DGS-3120-24TC:admin# delete cfm mep mepname mep1 Command: delete cfm mep mepname mep1 Success.
  • Page 195: Delete Cfm Md

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# delete cfm ma op1 md op_domain Command: delete cfm ma op1 md op_domain Success. DGS-3120-24TC:admin# 19-9 delete cfm md Description This command is used to delete a previously created maintenance domain. All the MEPs and maintenance associations created in the maintenance domain will be deleted automatically.
  • Page 196: Disable Cfm

    ® xStack DGS-3120 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 CFM globally: DGS-3120-24TC:admin# enable cfm Command: enable cfm Success. DGS-3120-24TC:admin# 19-11 disable cfm Description...
  • Page 197: Config Cfm Ports

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 19-12 config cfm ports Description This command is used to enable or disable the CFM function on a per-port basis. By default, the CFM function is disabled on all ports. If the CFM is disabled on a port: 1.
  • Page 198: Show Cfm

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions None. Example To show the CFM ports: DGS-3120-24TC:admin#show cfm ports 1:3-1:6 Command: show cfm ports 1:3-1:6 Port State ----- -------- Enabled Enabled Enabled Disabled DGS-3120-24TC:admin# 19-14 show cfm Description This command is used to show the CFM configuration.
  • Page 199 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions None. Example To show the CFM configuration: DGS-3120-24TC:admin#show cfm Command: show cfm CFM State: Enabled AIS Trap State: Disabled LCK Trap State: Disabled MD Index MD Name Level ---------- ----------------------...
  • Page 200: Show Cfm Fault

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Port : 1:2 Direction : Inward CFM Port Status : Enabled MAC Address : 00-01-02-03-04-02 MEP State : Enabled CCM State : Enabled PDU Priority Fault Alarm : Disabled Alarm Time : 250 centisecond((1/100)s)
  • Page 201: Show Cfm Port

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format show cfm fault {md [<string 22> | md_index <uint 1-4294967295>] {ma [<string 22> | ma_index <uint 1-4294967295>]}} Parameters md - (Optional) Specify the maintenance domain name. <string 22>...
  • Page 202: Cfm Loopback

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide outward - Specify that the MEP direction will be outward facing. If not specified, both directions and the MIP are shown. vlanid - (Optional) Specify the VLAN identifier. If not specified, all VLANs are shown. <vlanid 1-4094>...
  • Page 203: Cfm Linktrace

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide <string 22> - Enter the maintenance association name her. This name can be up to 22 characters long. ma_index - Specify the maintenance association index. <uint 1-4294967295> - Enter the maintenance association index value here. This value must be between 1 and 4294967295.
  • Page 204: Show Cfm Linktrace

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide <string 32> - Enter the MEP name used here. This name can be up to 32 characters long. mepid - Specify the MEP ID used. <int 1-8191> - Enter the MEP ID used here. This value must be between 1 and 8191. md - Specify the maintenance domain name.
  • Page 205 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide <int 1-8191> - Enter the MEP ID used here. This value must be between 1 and 8191. md - Specify the maintenance domain name. <string 22> - Enter the maintenance domain name her. This name can be up to 22 characters long.
  • Page 206: Delete Cfm Linktrace

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# show cfm linktrace mep mep1 trans_id 26 Command: show cfm linktrace mep mep1 trans_id 26 Transaction ID: 26 From MEP mep1 to 00-11-22-33-44-55 Start Time 2008-01-01 12:00:00 MEPID Ingress MAC Address Egress MAC Address...
  • Page 207: Show Cfm Mipccm

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To delete the CFM link trace reply: DGS-3120-24TC:admin# delete cfm linktrace mepname mep1 Command: delete cfm linktrace mepname mep1 Success. DGS-3120-24TC:admin# 19-21 show cfm mipccm Description This command is used to show the MIP CCM database entries.
  • Page 208 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format config cfm mp_ltr_all [enable | disable] Parameters enable - Specify that the MP's reply to the LTR function will be set to all. disable - Disable sending the all MPs replay LTRs function. Restrictions Only Administrator, Operator and Power-User level users can issue this command.
  • Page 209 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 19-24 show cfm remote_mep Description This command is used to show remote MEPs. Format show cfm remote_mep [mepname <string 32> | md [<string 22> | md_index <uint 1- 4294967295>] ma [<string 22>...
  • Page 210 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC: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 Port State : Blocked Interface Status...
  • Page 211 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide CFM TX Statistics ----------------------------------------------------------- Port AllPkt ----- -------- -------- -------- -------- -------- -------- 3988 3984 DGS-3120-24TC:admin# show cfm pkt_cnt ccm Command: show cfm pkt_cnt ccm CCM RX counters: XCON = Cross-connect CCMs Error...
  • Page 212 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format clear cfm pkt_cnt {[ports <portlist> {[rx | tx]} | [rx | tx] | ccm]} Parameters ports - (Optional) The ports which require need the counters clearing. If not specified, all ports will be cleared.
  • Page 213 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide enable – Enable the CFM trap state. This is the default. disable – Disable the CFM trap state. Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example DGS-3120-24TC:admin#config cfm trap ais state enable Command: config cfm trap ais state enable...
  • Page 214: Chapter 20 Connectivity Fault Management (Cfm) Extension Command List (Ei Mode Only)

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 20 Connectivity Fault Management (CFM) Extension Command List (EI Mode Only) config cfm ais md [<string 22> | md_index <uint 1-4294967295>] ma [<string 22> | ma_index <uint 1-4294967295>] mepid <int 1-8191>...
  • Page 215: Config Cfm Lock

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide <int 1-8191> - Enter the MEP ID value here. This value must be between 1 and 8191. period - (Optional) The transmitting interval of AIS PDU. The default period is 1 second. 1sec - Specify that the transmitting interval will be set to 1 second.
  • Page 216 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide characters long. ma_index - Specify the maintenance association index. <uint 1-4294967295> - Enter the maintenance association index value here. This value must between 1 and 4294967295. mepid - The MEP ID in the MD which sends LCK frame. <int 1-8191>...
  • Page 217 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide <uint 1-4294967295> - Enter the maintenance association index value here. This value must between 1 and 4294967295. mepid - The MEP ID in the MD which sends LCK frame. <int 1-8191>...
  • Page 218: Chapter 21 Cpu Interface Filtering Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 21 CPU Interface Filtering Command List 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} | ip {vlan | source_ip_mask <netmask> | destination_ip_mask <netmask> | dscp | [icmp {type | code } | igmp {type} | tcp {src_port_mask <hex 0x0-0xffff>...
  • Page 219 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide <hex 0x0-0xffffffff> <hex 0x0-0xffffffff> <hex 0x0-0xffffffff> <hex 0x0-0xffffffff> | offset_16-31 <hex 0x0-0xffffffff> <hex 0x0-0xffffffff> <hex 0x0-0xffffffff> <hex 0x0-0xffffffff> | offset_32-47 <hex 0x0-0xffffffff> <hex 0x0-0xffffffff> <hex 0x0-0xffffffff> <hex 0x0-0xffffffff> | offset_48-63 <hex 0x0-0xffffffff>...
  • Page 220 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide and 15. <hex 0x0-0xffffffff> - Enter the mask pattern offset of the frame between 0 and 15 here. offset_16-31 - (Optional) Specify that the mask pattern offset of the frame will be between 16 and 31.
  • Page 221 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#create cpu access_profile profile_id 1 ethernet vlan source_mac 00-00-00-00-00-01 destination_mac 00-00-00-00-00-02 802.1p ethernet_type Command: create cpu access_profile profile_id 1 ethernet vlan source_mac 00-00- 00-00-00-01 destination_mac 00-00-00-00-00-02 802.1p ethernet_type Success.
  • Page 222 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format config cpu access_profile profile_id <value 1-5> [add access_id [auto_assign | <value 1- 100>] [ethernet {[vlan <vlan_name 32> | vlan_id <vlanid 1-4094>] | source_mac <macaddr> | destination_mac <macaddr> | 802.1p <value 0-7> | ethernet_type <hex 0x0-0xffff>} | ip {[vlan <vlan_name 32>...
  • Page 223 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide destination_ip - (Optional) Specify an IP destination address. <ipaddr> - Enter the destination IP address used for this configuration here. mask - (Optional) Specify the mask. <netmask> - Specify the mask. dscp - (Optional) Specify the value of DSCP, the value can be configured 0 to 63.
  • Page 224 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide <hex 0x0-0xffffffff> - Enter the mask pattern offset of the frame between 16 and 31 here. offset_32-47 - (Optional) Specify that the mask pattern offset of the frame will be between 32 and 47.
  • Page 225 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide delete - Specify to delete a rule from the profile ID entered. access_id - Specify the index of access list entry. The range of this value is 1-100. <value 1-100>...
  • Page 226 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 21-5 disable cpu interface filtering Description This command is used to disable CPU interface filtering control. Format disable cpu_interface_filtering Parameters None. Restrictions Only Administrator and Operator-level users can issue this command. Example To disable cpu_interface_filtering: DGS-3120-24TC:admin# disable cpu_interface_filtering...
  • Page 227 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# show cpu access_profile Command: show cpu access_profile CPU Interface Filtering State: Disabled CPU Interface Access Profile Table Total Unused Rule Entries : 497 Total Used Rule Entries ================================================================================ Profile ID: 1 Type: IPv6...
  • Page 228 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Source MAC : FF-FF-FF-FF-FF-FF Unused Rule Entries: 99 -------------------------------------------------------------------------------- Rule ID : 1 Ports: 1:1-1:24,2:1-2:24,3:1-3:24 Match on Source MAC : 00-00-22-B0-61-51 Action: Deny ================================================================================ ================================================================================ Profile ID: 4 Type: User Defined MASK on Offset...
  • Page 229: Chapter 22 Debug Software Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 22 Debug Software Command List debug error_log [dump | clear | upload_toTFTP <ipaddr> <path_filename 64>] debug show error_reboot state debug buffer [utilization | dump | clear | upload_toTFTP <ipaddr> <path_filename 64>] debug output [module <module_list>...
  • Page 230 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To dump the error log: DGS-3120-24TC:admin# debug error_log dump Command: debug error_log dump ************************************************************************** # debug log: 1 # level: fatal # clock: 10000ms # time : 2009/03/11 13:00:00 ====================== SOFTWARE FATAL ERROR ======================= Invalid mutex handle : 806D6480 Current TASK : bcmARL.0...
  • Page 231: Debug Buffer

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format debug show error_reboot state Parameters None. Restrictions Only Administrator-level users can issue this command. Example To display the error reboot status: DGS-3120-24TC:admin#debug show error_reboot state Command: debug show error_reboot state Error Reboot: Enabled DGS-3120-24TC:admin# 22-3...
  • Page 232: Debug Output

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator users can issue this command. Example To show the debug buffer’s state: DGS-3120-24TC:admin# debug buffer utilization Command: debug buffer utilization Allocate from System memory pool Total size 2 MB Utilization rate...
  • Page 233 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters module - Specify 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 234: Debug Config State

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# debug config error_reboot disable Command: debug config error_reboot disable Success. DGS-3120-24TC:admin# 22-6 debug config state Description This command is used to set the state of the debug. Format debug config state [enable | disable] Parameters...
  • Page 235 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator-level users can issue this command. Example To clear cpu port counter of all ports: DGS-3120-24TC:admin#debug clear cpu port counter all Command: debug clear cpu port counter all Success.
  • Page 236 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To show debug cpu port counter by CoS on port 1:1 and 1:2: DGS-3120-24TC:admin#debug show cpu port counter 1:1-1:2 by_cos Command: debug show cpu port counter 1:1-1:2 by_cos Ports:1 CoS 0 rx:0 tx:0 1 rx:0 tx:0...
  • Page 237: Debug Show Status

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To display debug information of JWAC: DGS-3120-24TC: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: No Host Current AUTH DB (_jwac_db_nodes): No Host...
  • Page 238 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#debug show status Command: debug show status Debug Global State : Enabled MSTP : Disabled IMPB : Disabled DHCPv6_CLIENT : Disabled DHCPv6_RELAY : Disabled ERPS : Disabled DGS-3120-24TC:admin# 22-11 debug dhcpv6_client state enable (EI Mode Only) Description...
  • Page 239 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters None. Restrictions Only Administrator-level users can issue this command. Example To disabled the DHCPv6 client debug function: DGS-3120-24TC:admin#debug dhcpv6_client state disable Command: debug dhcpv6_client state disable Success.
  • Page 240 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 22-14 debug dhcpv6_client packet (EI Mode Only) Description This command is used to enable or disable debug information flag for DHCPv6 client packet, including packet receiving and sending. Format debug dhcpv6_client packet [all | receiving | sending] state [enable | disable] Parameters...
  • Page 241 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To enabled the DHCPv6 relay debug function: DGS-3120-24TC:admin#debug dhcpv6_relay state enable Command: debug dhcpv6_relay state enable Success. DGS-3120-24TC:admin# 22-16 debug dhcpv6_relay state disable (EI Mode Only) Description This command is used to disable DHCPv6 relay debug functions.
  • Page 242 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters buffer - Let the debug message output to buffer. console - Let the debug message output to console. Restrictions Only Administrator-level users can issue this command. Example To set debug information to output to a console: DGS-3120-24TC:admin#debug dhcpv6_relay output console...
  • Page 243 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 22-19 debug dhcpv6_relay hop_count state (EI Mode Only) Description This command is used to enable or disable debug information flag about the hop count. Format debug dhcpv6_relay hop_count state [enable | disable] Parameters enable - Specify to enable the hop count state.
  • Page 244: Chapter 23 Dhcp Local Relay Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 23 DHCP Local Relay Command List 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 23-1...
  • Page 245 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 23-2 config dhcp_local_relay vlan vlanid Description This command is used to enable or disable DHCP local relay function for specified VLAN ID. Format config dhcp_local_relay vlan vlanid <vlan_id 1-4094> state [enable | disable] Parameters vlanid - Specify the VLAN ID that the DHCP local relay function will be enabled.
  • Page 246 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To enable the DHCP local relay function: DGS-3120-24TC:admin# enable dhcp_local_relay Command: enable dhcp_local_relay Success. DGS-3120-24TC:admin# 23-4 disable dhcp_local_relay Description This command is used to globally disable the DHCP local relay function on the Switch. Format disable dhcp_local_relay Parameters...
  • Page 247 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions None. Example To display local dhcp relay status: DGS-3120-24TC:admin# show dhcp_local_relay Command: show dhcp_local_relay DHCP/BOOTP Local Relay Status : Disabled DHCP/BOOTP Local Relay VID List : 1,3-4 DGS-3120-24TC:admin#...
  • Page 248: Chapter 24 Dhcp Relay Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 24 DHCP Relay Command List config dhcp_relay {hops <int 1-16> | time <sec 0-65535>} config dhcp_relay add ipif <ipif_name 12> <ipaddr> config dhcp_relay add vlanid <vlan_id_list> <ipaddr> config dhcp_relay delete ipif <ipif_name 12>...
  • Page 249 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To configure the DHCP relay hops and time parameters: DGS-3120-24TC:admin# config dhcp_relay hops 4 time 2 Command: config dhcp_relay hops 4 time 2 Success. DGS-3120-24TC:admin# 24-2 config dhcp_relay add Description This command is used to add an IP destination address to the Switch’s DHCP relay table.
  • Page 250 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format config dhcp_relay add vlanid <vlan_id_list> <ipaddr> Parameters vlanid - Specify the VLAN ID list used for this configuration. <vlan_id_list> - Enter the VLAN ID list used for this configuration here. <ipaddr>...
  • Page 251 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 24-4 config dhcp_relay delete Description This command is used to delete one of the IP destination addresses in the swith’s relay table. Format config dhcp_relay delete ipif <ipif_name 12> <ipaddr> Parameters ipif - The name of the IP interface which contains the IP address below.
  • Page 252 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator, Operator and Power-User level users can issue this command. (SI Mode Only) Example To delete a DHCP/BOOTP server 10.43.21.12 from VLAN 2 and VLAN 3: DGS-3120-24TC:admin# config dhcp_relay delete vlanid 2-3 10.43.21.12 Command: config dhcp_relay delete vlanid 2-3 10.43.21.12 Success.
  • Page 253 Success. DGS-3120-24TC:admin# config dhcp_relay option_82 policy replace Command: config dhcp_relay option_82 policy replace Success. DGS-3120-24TC:admin# config dhcp_relay option_82 remote_id user_define “D-Link L2 Switch” Command: config dhcp_relay option_82 remote_id user_define "D-Link L2 Switch" Success. DGS-3120-24TC:admin# 24-7 enable dhcp_relay Description This command is used to enable the DHCP relay function on the Switch.
  • Page 254 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To enable the DHCP relay function. DGS-3120-24TC:admin# enable dhcp_relay Command: enable dhcp_relay Success. DGS-3120-24TC:admin# 24-8 disable dhcp_relay Description This command is used to disable the DHCP relay function on the Switch. Format disable dhcp_relay Parameters...
  • Page 255 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters ipif - (Optional) Specify the IP interface name. <ipif_name 12> - Enter the IP interface name used here. This name can be up to 12 characters long. If no parameter is specified , the system will display all DHCP relay configuration.
  • Page 256 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# show dhcp_relay ipif System Command: show dhcp_relay ipif System DHCP/BOOTP Relay Status : Disabled DHCP/BOOTP Hops Count Limit DHCP/BOOTP Relay Time Threshold : 0 DHCP Vendor Class Identifier Option 60 State: Disabled DHCP Client Identifier Option 61 State: Disabled DHCP Relay Agent Information Option 82 State : Disabled...
  • Page 257 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To configure the state of dhcp_relay option 60: DGS-3120-24TC:admin# config dhcp_relay option_60 state enable Command: config dhcp_relay option_60 state enable Success DGS-3120-24TC:admin# 24-11 config dhcp_relay option_60 add Description This command is used to configure the option 60 relay rules.
  • Page 258 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 24-12 config dhcp_relay option_60 default Description This command is used to configure the DHCP relay option 60 default drop option. When there are no match servers found for the packet based on option 60, the relay servers will be determined by the default relay server setting.
  • Page 259 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format config dhcp_relay option_60 delete [string <multiword 255> {relay <ipaddr>} | ipaddress <ipaddr> | all | default {<ipaddr>}] Parameters string - Delete all the entries whose string is equal to the string of specified if ipaddress is not specified <multiword 255>...
  • Page 260 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions None. Example To show DHCP option 60 information: DGS-3120-24TC:admin#show dhcp_relay option_60 Command: show dhcp_relay option_60 Default Processing Mode: Drop Default Servers: Matching Rules: String Match Type IP Address ------- ---------...
  • Page 261 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To configure the state of dhcp_relay option 61: DGS-3120-24TC:admin# config dhcp_relay option_61 state enable Command: config dhcp_relay option_61 state enable Success DGS-3120-24TC:admin# 24-16 config dhcp_relay option_61 add Description This command is used to add a rule to determine the relay server based on option 61.
  • Page 262 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 24-17 config dhcp_relay option_61 default Description This command is used to configure the default ruler for option 61. Format config dhcp_relay option_61 default [relay <ipaddr> | drop] Parameters relay - Specify to relay the packet that has no option matching 61 matching rules to an IP address.
  • Page 263 ® xStack DGS-3120 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 remove a DHCP relay option 61 entry: DGS-3120-24TC:admin# config dhcp_relay option_61 delete mac_address 00-11-22- 33-44-55 Command: config dhcp_relay option_61 delete mac_address 00-11-22-33-44-55 Success...
  • Page 264 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# show dhcp_relay option_61 Command: show dhcp_relay option_61 Default Relay Rule: 10.90.90.200 Matching Rules: Client-ID Type Relay Rule ---------------------- ----------- ---------------- String Drop abcde String 10.90.90.1 00-11-22-33-44-55 MAC Address Drop Total Entries: 3...
  • Page 265: Chapter 25 Dhcp Server Screening Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 25 DHCP Server Screening Command List 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 266 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide <portlist> - Enter the list of ports to be configured here. all - Specify that all the port will be used for this configuration. delete permit - Specify to delete a DHCP permit. server_ip - The IP address of the DHCP server to be filtered.
  • Page 267 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters None. Restrictions None. Example To display the DHCP server/client filter list created on the Switch: DGS-3120-24TC:admin#show filter dhcp_server Command: show filter dhcp_server Enabled Ports: 1:1-1:10 Trap State: Disabled State: Disabled Illegal Server Log Suppress Duration:5 minutes Permit DHCP Server/Client Table:...
  • Page 268 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#config filter dhcp_server log disable Command: config filter dhcp_server log disable Success. DGS-3120-24TC:admin# 25-4 config filter dhcp_server trap Description This command is used to enable or disable the log function. Format config filter dhcp_server trap [enable | disable] Parameters...
  • Page 269: Chapter 26 Dhcpv6 Relay Command List (Ei Mode Only)

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 26 DHCPv6 Relay Command List (EI Mode Only) enable dhcpv6_relay disable dhcpv6_relay config dhcpv6_relay [add|delete] ipif <ipif_name 12> <ipv6addr> config dhcpv6_relay hop_count <value 1-32> config dhcpv6_relay ipif [<ipif_name 12> | all] state [enable | disable] show dhcpv6_relay {ipif <ipif_name 12>} 26-1 enable dhcpv6_relay...
  • Page 270 ® xStack DGS-3120 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 configure the DHCPv6 relay global state to disable: DGS-3120-24TC:admin#disable dhcpv6_relay Command: disable dhcpv6_relay Success.
  • Page 271 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# config dhcpv6_relay add ipif System 2001:DB8:1234:0:218:FEFF:FEFB:CC0E Command: config dhcpv6_relay add ipif System 2001:DB8:1234:0:218:FEFF:FEFB:CC0E Success. DGS-3120-24TC:admin# 26-4 config dhcpv6_relay hop_count Description This command is used to configure the DHCPv6 relay hop count of the Switch. Format config dhcpv6_relay hop_count <value 1-32>...
  • Page 272 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide state - Enable or disable the DHCPv6 relay state of the interface. enable - Enable the DHCPv6 relay state of the interface. disable - Disable the DHCPv6 relay state of the interface. Restrictions Only Administrator, Operator and Power-User level users can issue this command.
  • Page 273 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#show dhcpv6_relay Command: show dhcpv6_relay DHCPv6 Relay Global State : Disabled DHCPv6 Hops Count Limit --------------------------------------------------------------- IP Interface : System DHCPv6 Relay Status : Enabled Server Address : 2001:DB8:1234::218:FEFF:FEFB:CC0E Total Entries DGS-3120-24TC:admin#...
  • Page 274: Chapter 27 Digital Diagnostic Monitoring (Ddm) Command List (Ei Mode Only)

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 27 Digital Diagnostic Monitoring (DDM) Command List (EI Mode Only) config ddm [trap | log] [enable | disable] config ddm ports [<portlist> | all] [[temperature_threshold {high_alarm <degrees> | low_alarm <degrees>...
  • Page 275 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#config ddm log enable Command: config ddm log enable Success. DGS-3120-24TC:admin# To configure DDM trap state to enable: DGS-3120-24TC:admin#config ddm trap enable Command: config ddm trap enable Success.
  • Page 276 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide parameter rises above this value, the action associated with the alarm is taken. <voltage> - Enter the high threshold alarm value used here. low_alarm - (Optional) Specify the low threshold for the alarm. When the operating parameter falls below this value, the action associated with the alarm is taken.
  • Page 277 ® xStack DGS-3120 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 port 21’s temperature threshold: DGS-3120-24TC:admin#config ddm ports 1:21 temperature_threshold high_alarm 84.9555 low_alarm -10 high_warning 70 low_warning 2.25251 Command: config ddm ports 1:21 temperature_threshold high_alarm 84.9555 low_alarm -10 high_warning 70 low_warning 2.25251 Success.
  • Page 278: Show Ddm

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#config ddm ports 1:21 rx_power_threshold high_alarm 4.55 low_alarm 0.01 high_warning 3.5 low_warning 0.03 Command: config ddm ports 1:21 rx_power_threshold high_alarm 4.55 low_alarm 0.01 high_warning 3.5 low_warning 0.03 Success.
  • Page 279 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 27-4 show ddm ports Description This command is used to show the current operating DDM parameters and configuration values of the optic module of the specified ports. There are two types of thresholds: the administrative configuration and the operation configuration threshold.
  • Page 280 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#show ddm ports 1:21 configuration Command: show ddm ports 1:21 configuration Port: 1:21 -------------------------------------------- DDM State : Enabled Shutdown : Alarm Threshold Temperature Voltage Bias-Current TX-Power RX-Power (in Celsius) (mA) (mW)
  • Page 281: Chapter 28 D-Link License Management System (Dlms) Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 28 D-Link License management System (DLMS) Command List install dlms activation_code <string 25> {unit <unit_id 1-6>} show dlms license {unit <unit_id 1-6>} 28-1 install dlms activation_code Description This command is used to install an activation code to activate or unlock function on the applicance.
  • Page 282 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format show dlms license {unit <unit_id 1-6>} Parameters unit - (Optional) Specify the Swithc in the switch stack. <unit_id 1-6> - Enter the unit ID of the Switch. Restrictions None.
  • Page 283: Chapter 29 D-Link Unidirectional Link Detection (Duld) Command List (Ei Mode Only)

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 29 D-Link Unidirectional Link Detection (DULD) Command List (EI Mode Only) config duld ports [<portlist> | all ] {state [enable | disable] | mode [shutdown | normal] | discovery_time <sec 5-65535>}(1)
  • Page 284 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#config duld ports 1 state enable Command: config duld ports 1:1 state enable Success. DGS-3120-24TC:admin# 29-2 show duld ports Description This command is used to show unidirectional link detection information. Format show duld ports {<portlist>} Parameters...
  • Page 285: Chapter 30 Ethernet Ring Protection Switching (Erps) Command List (Ei Mode Only)

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 30 Ethernet Ring Protection Switching (ERPS) Command List (EI Mode Only) enable erps disable erps create erps raps_vlan <vlanid> delete erps raps_vlan <vlanid> config erps raps_vlan <vlanid> [state [enable | disable] | ring_mel <value 0-7> | ring_port [west [<port>...
  • Page 286 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# enable erps Command: enable erps Success. DGS-3120-24TC:admin# 30-2 disable erps Description This command is used to disable the global ERPS function on a switch. Format disable erps Parameters None.
  • Page 287 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide <vlanid> - Enter the VLAN ID used here. Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To create an R-APS VLAN: DGS-3120-24TC:admin# create erps raps_vlan 4094 Command: create erps raps_vlan 4094 Success.
  • Page 288 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 30-5 config erps raps_vlan Description This command is used to configure the ERPS R-APS VLAN settings. The ring MEL is one field in the R-APS PDU. Note that if CFM (Connectivity Fault Management) and ERPS are used at the same time, the R-APS PDU is one of a suite of Ethernet OAM PDU.
  • Page 289 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide unblocked RPL port and start to send R-APS PDU with an RB flag after the link recovery is confirmed within this period of time. When both the global state and the specified ring ERPS state are enabled, the specified ring will be activated.
  • Page 290 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide sub_ring - Specify that the sub-ring is being configured. raps_vlan - Specify the R-APS VLAN. <vlanid> - Enter the VLAN ID used here. tc_propagation - Specify that the topology propagation state will be configured. state - Specify the topology propagation state.
  • Page 291 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide To configure the RPL port or the RPL owner for a specific R-APS VLAN: DGS-3120-24TC:admin# config erps raps_vlan 4094 rpl port west owner enable Command: config erps raps_vlan 4094 rpl port west owner enable Success.
  • Page 292 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide To configure the state of topology change propagation: DGS-3120-24TC:admin# config erps raps_vlan 4094 sub_ring raps_vlan 4093 tc_propagation state enable Command: config erps raps_vlan 4094 sub_ring raps_vlan 4093 tc_propagation state enable Success.
  • Page 293 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters trap - Specify to enable or disable the ERPS trap state. enable - Enter enable to enable the trap state. 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.
  • Page 294 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To display ERPS information: DGS-3120-24TC:admin# show erps Command: show erps ERPS Information Global Status : Enabled Log Status : Disabled Trap Status : Disabled ------------------------ R-APS VLAN : 4092 Ring Status : Enabled...
  • Page 295: Chapter 31 Filter Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 31 Filter Command List config filter netbios [<portlist> | all] state [enable | disable] show filter netbios config filter extensive_netbios [<portlist> | all] state [enable | disable] show filter extensive_netbios 31-1 config filter netbios...
  • Page 296 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters None. Restrictions None. Example To display the DHCP server/client filter list created on the Switch: DGS-3120-24TC:admin# show filter netbios Command: show filter netbios Enabled ports: 1-3 DGS-3120-24TC:admin# 31-3 config filter extensive_netbios...
  • Page 297 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# config filter extensive_netbios 1-10 state enable Command: config filter extensive_netbios 1-10 state enable Success. DGS-3120-24TC:admin# 31-4 show filter extensive_netbios Description This command is used to display the extensive netbios state on the Switch. Format show filter extensive_netbios Parameters...
  • Page 298: Chapter 32 Filter Database (Fdb) Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 32 Filter Database (FDB) Command List 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>...
  • Page 299: Create Fdb Vlanid

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#create fdb default 00-00-00-00-01-02 port 1:5 Command: create fdb default 00-00-00-00-01-02 port 1:5 Success. DGS-3120-24TC:admin# To filter a unicast MAC: DGS-3120-24TC:admin# create fdb default 00-00-00-00-01-02 drop Command: create fdb default 00-00-00-00-01-02 drop Success.
  • Page 300 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#create fdb vlanid 1 00-00-00-00-02-02 drop Command: create fdb vlanid 1 00-00-00-00-02-02 drop Success. DGS-3120-24TC:admin# 32-3 create multicast_fdb Description This command is used to create a static entry in the multicast MAC address forwarding table (database).
  • Page 301 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters <vlan_name 32> - The name of the VLAN on which the MAC address resides. The maximum name length is 32. <macaddr> - Enter the multicast MAC address to be added or removed to and from the static forwarding table here.
  • Page 302 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To configure the MAC address table aging time to 600 seconds: DGS-3120-24TC:admin# config fdb aging_time 600 Command: config fdb aging_time 600 Success. DGS-3120-24TC:admin# 32-6 config multicast vlan_filtering_mode Description This command is used to configure the multicast packet filtering mode for VLANs.
  • Page 303: Delete Fdb

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 32-7 delete fdb Description This command is used to delete a static entry from the forwarding database. Format delete fdb <vlan_name 32> <macaddr> Parameters <vlan_name 32> - The name of the VLAN on which the MAC address resides. The maximum name length is 32.
  • Page 304 ® xStack DGS-3120 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 all FDB dynamic entries: DGS-3120-24TC:admin# clear fdb all Command: clear fdb all Success.
  • Page 305: Show Fdb

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#show multicast_fdb Command: show multicast_fdb VLAN Name : default MAC Address : 01-00-5C-11-22-33 Egress Ports : 1:1-1:5 Mode : Static Total Entries: 1 DGS-3120-24TC:admin# 32-10 show fdb Description This command is used to display the current unicast MAC address forwarding database.
  • Page 306 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#show fdb Command: show fdb Unicast MAC Address Aging Time = 300 VLAN Name MAC Address Port Type Status ---- -------------------------------- ----------------- ----- ------- ------- default 00-01-02-03-04-00 CPU Self Forward default...
  • Page 307 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide long. If no parameter is specified, the device will show all multicast filtering settings in the device. Restrictions None. Example To show the multicast vlan_filtering_mode for VLANs: DGS-3120-24TC:admin#show multicast vlan_filtering_mode Command: show multicast vlan_filtering_mode VLAN ID/VLAN Name...
  • Page 308: Chapter 33 Flash File System (Ffs) Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 33 Flash File System (FFS) Command List show storage_media_info {[unit <unit_id> | all]} change drive {unit <unit_id>} <drive_id> 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 309: Change Drive

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide GS-3120-24TC:admin#show storage_media_info Command: show storage_media_info Unit Drive Media Type Size Label FS Type Version ---- ----- ---------- -------- ----------- ------- ------- Flash 28 MB Ver2.1 DGS-3120-24TC:admin# 33-2 change drive Description This command is used to change the current drive.
  • Page 310 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters unit – (Optional) Specify a unit ID if in the stacking system. If not specified, it refers to the master unit. <unit_id> - Enter the unit ID here. <drive_id>...
  • Page 311 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# rd c:/abc Command: rd c:/abc Success. DGS-3120-24TC:admin# 33-5 Description This command is used to change the current directory. The current directory is changed under the current drive. If you want to change the working directory to the directory in another drive, then you need to change the current drive to the desired drive, and then change the current directory.
  • Page 312 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters unit - (Optional) Specify a unit ID if in the stacking system. If not specified, it refers to the master unit. <unit_id> - Enter the unit ID here. <drive_id>...
  • Page 313 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide <unit_id> - Enter the unit ID here. <drive_id> - (Optional) Enter the drive ID used here. Examples are C: or D: <pathname> - Specified the file (in path form) to be renamed. <filename>...
  • Page 314 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#dir Command: dir Directory of /unit2:/c: Idx Info Attr Size Update Time Name --- ------- ---- -------- ------------------- ---------------- drw- 0 2000/04/02 06:02:04 12 2 CFG(*) -rw- 29661 2000/04/01 05:54:38 config.cfg 3 RUN(*) -rw- 4879040...
  • Page 315 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide <drive_id> - (Optional) Enter the drive ID used here. Examples are C: or D: <pathname> - Specify the file to be deleted. If it is specified in the associated form, then it is related to the current directory.
  • Page 316 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 33-10 move Description This command is used to move a file around the file system. Files in a drive located in a unit can be moved to another drive located in another unit. Note that when a file is moved, it can be specified whether to rename at the same time.
  • Page 317 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format copy {{unit <unit_id>} <drive_id>} <pathname> {{unit <unit_id>} <drive_id>} <pathname> Parameters unit - (Optional) Unit ID in the stacking system. If not specified, it refers to the master unit. <unit_id>...
  • Page 318 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator and Operator-level users can issue this command. Example To format a drive: DGS-3120-24TC:admin#format d: fat32 aaaa Command: format d: fat32 aaaa Formatting......Done Success DGS-3120-24TC:admin#...
  • Page 319: Chapter 34 Gratuitous Arp Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 34 Gratuitous ARP Command List config gratuitous_arp send ipif_status_up [enable | disable] config gratuitous_arp send dup_ip_detected [enable | disable] config gratuitous_arp learning [enable | disable] config gratuitous_arp send periodically ipif <ipif_name 12> interval <value 0-65535> enable gratuitous_arp {ipif <ipif_name 12>} {trap | log}(1) disable gratuitous_arp {ipif <ipif_name 12>} {trap | log}(1) show gratuitous_arp {ipif <ipif_name 12>}...
  • Page 320 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide that the system received a ARP request packet that is sent by an IP address that match the system’s own IP address. In this case, the system knows that some body out there uses an IP address that is conflict with the system.
  • Page 321 ® xStack DGS-3120 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 show the global GratuitousARP state: DGS-3120-24TC:admin# config gratuitous_arp learning enable Command: config gratuitous_arp learning enable Success.
  • Page 322 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 34-5 enable gratuitous_arp Description The command is used to enable gratuitous ARP trap and log state. The switch can trap and log the IP conflict event to inform the administrator. By default, trap is disabled and event log is enabled. Format enable gratuitous_arp {ipif <ipif_name 12>} {trap | log}(1) Parameters...
  • Page 323 ® xStack DGS-3120 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 system interface’s gratuitous ARP log and trap: DGS-3120-24TC:admin# disable gratuitous_arp ipif System trap log Command: disable gratuitous_arp ipif System trap log Success.
  • Page 324 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#show gratuitous_arp Command: show gratuitous_arp Send on IPIF Status Up : Enabled Send on Duplicate IP Detected : Enabled Gratuitous ARP Learning : Enabled IP Interface Name : System Gratuitous ARP Trap : Enabled Gratuitous ARP Log...
  • Page 325: Chapter 35 Igmp / Mld Snooping Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 35 IGMP / MLD Snooping Command List The Internet Group Management Protocol (IGMP) is a L3 protocol used to manage the membership of Internet Protocol multicast groups. IGMP is used by IP hosts and adjacent multicast routers to establish multicast group memberships.
  • Page 326 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide show igmp_snooping forwarding {[vlan <vlan_name 32> | vlanid <vlanid_list>]} show router_ports [vlan <vlan_name 32> | vlanid <vlanid_list> | all ] {[static | dynamic | forbidden]} show igmp_snooping statistic counter [vlan <vlan_name> | vlanid <vlanid_list> | ports <portlist>] show igmp access_authentication ports [all | <portlist>] clear igmp_snooping statistics counter...
  • Page 327 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters vlan_name - Specify the name of the VLAN for which IGMP snooping is to be configured. <vlan_name 32> - Enter the VLAN name here. The VLAN name can be up to 32 characters long.
  • Page 328 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide vlanid - Specify a range of VLANs to be configured. <vlanid_list> - Enter the VLAN ID list here. <value 1-1000> - Configure the rate of the IGMP control packet that the Switch can process on a specific port/VLAN.
  • Page 329 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide and 25 seconds. robustness_variable - (Optional) Provides fine-tuning to allow for expected packet loss on a subnet. The value of the robustness variable is used in calculating the following IGMP message intervals: <value 1-7>...
  • Page 330 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 35-4 config igmp access_authentication ports Description This command is used to enable or disable the IGMP Access Control function for the specified ports. If the IGMP Access Control function is enabled and the Switch receives an IGMP JOIN message, the Switch will send the access request to the RADIUS server for authentication.
  • Page 331 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide delete - Specify to delete the router ports. <portlist> - Specify a range of ports to be configured. (UnitID:port number) Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To set up static router ports: DGS-3120-24TC:admin# config router_ports default add 1:1-1:10...
  • Page 332 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 35-7 enable igmp_snooping Description This command is used to enable IGMP snooping on the Switch. Format enable igmp_snooping Parameters None. Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To enable IGMP snooping on the Switch: DGS-3120-24TC:admin# enable igmp_snooping...
  • Page 333 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To disable IGMP snooping on the Switch: DGS-3120-24TC:admin# disable igmp_snooping Command: disable igmp_snooping Success. DGS-3120-24TC:admin# 35-9 create igmp_snooping static_group Description This command is used to create an IGMP snooping static group. Member ports can be added to the static group.
  • Page 334 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# create igmp_snooping static_group vlan default 239.1.1.1 Command: create igmp_snooping static_group vlan default 239.1.1.1 Success. DGS-3120-24TC:admin# 35-10 delete igmp_snooping static_group Description This command is used to delete an IGMP snooping multicast static group. The deletion of an IGMP snooping static group will not affect the IGMP snooping dynamic member ports for a group.
  • Page 335 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format config igmp_snooping static_group [vlan <vlan_name 32> | vlanid <vlanid_list>] <ipaddr> [add | delete] <portlist> Parameters vlan - Specify the name of the VLAN on which the static group resides. <vlan_name 32>...
  • Page 336 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions None. Example To display all the IGMP snooping static groups: DGS-3120-24TC:admin# show igmp_snooping static_group VLAN ID/Name IP Address Static Member Ports -------------- ------------------ ------------------------ 1 / Default 239.1.1.1 2:9-2:10 Total Entries : 1...
  • Page 337 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide vlanid - Specify the VLAN ID to be configured. <vlanid_list> - Enter the VLAN ID here. state - (Optional) Specify to enable or disable the data driven learning of an IGMP snooping group.
  • Page 338 ® xStack DGS-3120 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 set the maximum number of groups that can be learned by data driven: DGS-3120-24TC:admin# config igmp_snooping data_driven_learning max_learned_entry 50 Command: config igmp_snooping data_driven_learning max_learned_entry 50...
  • Page 339 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 35-16 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 for which you want to view the IGMP snooping configuration.
  • Page 340 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#show igmp_snooping Command: show igmp_snooping IGMP Snooping Global State : Enabled Data Driven Learning Max Entries : 128 VLAN Name : default Query Interval : 125 Max Response Time : 10 Robustness Value Last Member Query Interval...
  • Page 341 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To display the IGMP snooping rate limit for ports 1 to 15: DGS-3120-24TC:admin# show igmp_snooping rate_limit ports 1-15 Command: show igmp_snooping rate_limit ports 1-15 Port Rate Limit -------- ----------- No Limit...
  • Page 342 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# show igmp_snooping group Command: show igmp_snooping group Source/Group : 10.0.0.1/225.0.0.1 VLAN Name/VID : default/1 Member Ports : 1:5 UP Time Expiry Time : 254 Filter Mode : INCLUDE Source/Group : 10.0.0.10/225.0.0.1...
  • Page 343 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Member Ports : 1:5 UP Time : 10 Expiry Time : 258 Filter Mode : EXCLUDE Source/Group : NULL/226.0.0.2 VLAN Name/VID : default/1 Member Ports : 1:5 UP Time Expiry Time : 259...
  • Page 344 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide <vlanid_list> - Enter the VLAN ID list here. If no parameter is specified, the system will display all current IGMP snooping forwarding table entries of the Switch. Restrictions None.
  • Page 345 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide all - Specify all VLANs on which the router port resides. static - (Optional) Displays router ports that have been statically configured. dynamic - (Optional) Displays router ports that have been dynamically configured. forbidden - (Optional) Displays forbidden router ports that have been statically configured.
  • Page 346 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide <portlist> - Enter the list of port to be displayed here. Restrictions None. Example To display the IGMP snooping statistics counter: DGS-3120-24TC:admin# show igmp_snooping statistics counter vlanid 1 Command: show igmp_snooping statistics counter vlanid 1 VLAN Name : Default...
  • Page 347 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide To display the IGMP snooping statistics counter for a port: DGS-3120-24TC:admin# show igmp_snooping statistics counter ports 1 Command: show igmp_snooping statistics counter ports 1 Port #1 ------------------------------------------------ Group Number : 10 Receive Statistics...
  • Page 348 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format show igmp access_authentication ports [all | <portlist>] Parameters all - Specify all ports to be displayed. <portlist> - Specify a range of ports to be displayed. Restrictions None.
  • Page 349 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 1:16 Disabled 1:17 Disabled 1:18 Disabled 1:19 Disabled 1:20 Disabled CTRL+C ESC q Quit SPACE n Next Page ENTER Next Entry 35-23 clear igmp_snooping statistics counter Description This command is used to clear the IGMP snooping statistics counter.
  • Page 350 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide <vlan_name 32> - Enter the VLAN name here. The VLAN name can be up to 32 characters long. vlanid - Specify the ID of the VLAN for which MLD snooping is to be configured. <vlanid_list>...
  • Page 351 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide <vlanid_list> - Enter the VLAN ID list here. 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. The default setting is 125 seconds.
  • Page 352 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 35-26 config mld_snooping router_ports Description This command is used 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, etc.
  • Page 353 ® xStack DGS-3120 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> - Enter the VLAN name here. The VLAN name can be up to 32 characters long.
  • Page 354 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To enable MLD snooping on the Switch: DGS-3120-24TC:admin# enable mld_snooping Command: enable mld_snooping Success. DGS-3120-24TC:admin# 35-29 disable mld_snooping Description This command is used to disable MLD snooping on the Switch. Format disable mld_snooping Parameters...
  • Page 355 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters vlan - (Optional) Specify the name of the VLAN for which you want to view the IGMP snooping configuration. <vlan_name 32> - Enter the VLAN name here. The VLAN name can be up to 32 characters long.
  • Page 356 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 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 you want to view MLD snooping group information.
  • Page 357 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# show mld_snooping group Command: show mld_snooping group Source/Group : 2001::1/FE1E::1 VLAN Name/VID : default/1 Member Ports : 1-2 UP Time : 26 Expiry Time : 258 Filter Mode : INCLUDE Source/Group...
  • Page 358 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 35-32 show mld_snooping forwarding Description This command is used to display the Switch’s current MLD snooping forwarding table. It provides an easy way for users to check the list of ports that the multicast group that comes from specific sources will be forwarded to.
  • Page 359 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 35-33 show mld_snooping mrouter_ports Description This command is used to display the currently configured router ports on the Switch. Format show mld_snooping mrouter_ports [vlan <vlan_name 32> | vlanid <vlanid_list> | all] {[static | dynamic | forbidden]} Parameters vlan - Specify the name of the VLAN on which the router port resides.
  • Page 360 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide The static group will only take effect when MLD snooping is enabled on the VLAN. For those static member ports, the device needs to emulate the MLD protocol operation to the querier, and forward the traffic destined to the multicast group to the member ports.
  • Page 361 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide long. vlanid - Specify the ID of the VLAN on which the static group resides. <vlanid_list> - Enter the VLAN ID list here. <ipv6addr> - Specify the multicast group IP address. Restrictions Only Administrator, Operator and Power-User level users can issue this command.
  • Page 362 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To unset port range 9-10 from MLD snooping static member ports for group FF1E::1 on default VLAN: DGS-3120-24TC:admin# config mld_snooping static_group vlan default FF1E::1 delete 2:9-2:10 Command: create mld_snooping static_group vlan default FF1E::1 delete 2:9-2:10 Success.
  • Page 363 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide When data-driven learning is enabled for the VLAN, when the Switch receives the IP multicast traffic, on this VLAN, an MLD snooping group will be created. That is, the learning of an entry is not activated by MLD membership registration, but activated by the traffic.
  • Page 364 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 35-39 config mld_snooping data_driven_learning max_learned_entry Description This command is used to configure the maximum number of groups that can be learned by data driven. When the table is full, the system will stop the learning of the new data-driven groups. Traffic for Format config mld_snooping data_driven_learning max_learned_entry <value 1-1024>...
  • Page 365 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters all - Specify all VLANs to which IGMP snooping groups will be deleted. vlan_name - Specify the VLAN name. <vlan_name 32> - Enter the VLAN name here. vlanid - Specify the VLAN ID.
  • Page 366 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# show mld_snooping statistics counter vlanid 1 Command: show mld_snooping statistics counter vlanid 1 VLAN Name : Default ----------------------------------------------- Total Groups : 10 Receive Statistics Query MLD v1 Query MLD v2 Query Total Dropped By Rate Limitation...
  • Page 367 ® xStack DGS-3120 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 MLD snooping statistics counter: DGS-3120-24TC:admin# clear mld_snooping statistic counter Command: clear mld_snooping statistic counter Success.
  • Page 368 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# config mld_snooping ports 1 rate_limit 100 Command: config mld_snooping ports 1 rate_limit 100 Success. DGS-3120-24TC:admin# 35-44 show mld_snooping rate_limit Description This command is used to configure the rate limit of MLD control packets that are allowed by each port.
  • Page 369: Chapter 36 Ip-Mac-Port Binding (Impb) Command List (Ei Mode Only)

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 36 IP-MAC-Port Binding (IMPB) Command List (EI Mode Only) create address_binding ip_mac ipaddress <ipaddr> mac_address <macaddr> {ports [<portlist> | all]} config address_binding ip_mac ports [<portlist> | all] {arp_inspection [strict | loose | disable] | ip_inspection [enable | disable] | protocol [ipv4] | allow_zeroip [enable | disable] | forward_dhcppkt [enable | disable] | stop_learning_threshold <int 0-500>} delete address_binding blocked [all | vlan_name <vlan_name>...
  • Page 370 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide will be applied to all ports. <portlist> - Enter a list of ports used for this configuration here. all - Specify that all the ports will be included. Restrictions Only Administrator, Operator and Power-User level users can issue this command.
  • Page 371 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide enable - Specify that the allow zero IP option will be enabled. disable - Specify that the allow zero IP option will be disabled. forward_dhcppkt - (Optional) By default, DHCP packets with a broadcast DA will be flooded. When set to disabled, the broadcast DHCP packet received by the specified port will not be forwarded.
  • Page 372 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To delete a blocked address: DGS-3120-24TC: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. DGS-3120-24TC:admin# 36-4 delete address_binding ip_mac Description This command is used to delete an IMPB entry.
  • Page 373 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format config address_binding ip_mac ipaddress <ipaddr> mac_address <macaddr> {ports [<portlist> | all]} Parameters ipaddress - Specify the IP address of the entry being updated. <ipaddr> - Enter the IP address used here. mac_address - Specify the MAC address of the entry being updated <macaddr>...
  • Page 374 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To show the IMPB global configuration: DGS-3120-24TC:admin#show address_binding Command: show address_binding Trap/Log : Disabled DHCP Snoop : Disabled Function Version : 3.92 DGS-3120-24TC:admin# To show the IMPB ports: DGS-3120-24TC:admin#show address_binding ports Command: show address_binding ports ARP: ARP Inspection...
  • Page 375 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters all - Specify that all the addresses in the database that the system has auto learned and blocked to be displayed. vlan_name - Specify the name of the VLAN to which the blocked MAC address belongs. <vlan_name>...
  • Page 376 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To show IMPB entries: DGS-3120-24TC:admin#show address_binding ip_mac all Command: show address_binding ip_mac all M(Mode) - D:DHCP, S:Static ACL - A:Active I:Inactive IP Address MAC Address ACL Ports --------------------------------------- ----------------- -- -- -------------- 10.1.1.1 00-00-00-00-00-11 S...
  • Page 377 ® xStack DGS-3120 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 IPv4 snooping mode: DGS-3120-24TC:admin# enable address_binding dhcp_snoop Command: enable address_binding dhcp_snoop Success.
  • Page 378 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 36-11 clear address_binding dhcp_snoop binding_entry ports Description This command is used to clear the DHCP snooping entries learned for the specified ports. Format clear address_binding dhcp_snoop binding_entry ports [<portlist> | all] Parameters <portlist>...
  • Page 379 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To show the DHCP snooping state: DGS-3120-24TC:admin#show address_binding dhcp_snoop Command: show address_binding dhcp_snoop DHCP Snoop(IPv4) : Disabled DGS-3120-24TC:admin# To display DHCP snooping maximun entry configuration: DGS-3120-24TC:admin# show address_binding dhcp_snoop max_entry Command: show address_binding dhcp_snoop max_entry Port Max Entry...
  • Page 380 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide <port> - Enter the port number used here. Restrictions None. Example To display the DHCP snooping binding entries: DGS-3120-24TC: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...
  • Page 381 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To set the maximum number of DHCP IPv4 snooping entries that ports 1:1–1:3 can learned to 10: DGS-3120-24TC:admin#config address_binding dhcp_snoop max_entry ports 1:1-1:3 limit 10 Command: config address_binding dhcp_snoop max_entry ports 1:1-1:3 limit 10 Success.
  • Page 382 ® xStack DGS-3120 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 IMPB traps and logs: DGS-3120-24TC:admin# disable address_binding trap_log Command: disable address_binding trap_log Success.
  • Page 383 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 36-18 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 384 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To stop IMPB debug: starting when the IMPB module receives an ARP/IP or DHCP packet: DGS-3120-24TC:admin# no debug address_binding Command: no debug address_binding Success. DGS-3120-24TC:admin#...
  • Page 385: Chapter 37 Ipv6 Neighbor Discover Command List (Ei Mode Only)

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 37 IPv6 Neighbor Discover Command List (EI Mode Only) 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 386 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 37-2 delete ipv6 neighbor_cache 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 387 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide <ipif_name 12> - Enter the IP interface name here. This name can be up to 12 characters long. all - Specify that all the interface will be displayed. ipv6address - The neighbor’s address.
  • Page 388: Show Ipv6 Nd

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To configure the retrans_time of IPv6 ND neighbor solicitation: DGS-3120-24TC:admin# config ipv6 nd ns ipif Zira retrans_time 1000000 Command: config ipv6 nd ns ipif Zira retrans_time 1000000 Success.
  • Page 389: Chapter 38 Ipv6 Route Command List (Ei Mode Only)

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 38 IPv6 Route Command List (EI Mode Only) create ipv6route [default | <ipv6networkaddr>] [<ipif_name 12> <ipv6addr> | <ipv6addr>] {<metric 1-65535>} {[primary | backup]} delete ipv6route [[default | <ipv6networkaddr>] [<ipif_name 12> <ipv6addr> | <ipv6addr>] | all] show ipv6route {[<ipv6networkaddr>...
  • Page 390: Delete Ipv6Route

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 38-2 delete ipv6route Description This command is used to delete an IPv6 static route. If the next hop is a global address, it is not needed to indicate the interface name. If the next hop is a link local address, then the interface name must be specified.
  • Page 391 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions <ipv6networkaddr> - (Optional) The destination network of the route. <ipv6addr> - (Optional) Specify the destination 128-bit length IPv6 address to be displayed. static - (Optional) Specify to display only the static route entries. hardware - (Optional) Specify to display only the route entries which have been wrote into hardware table.
  • Page 392: Chapter 39 Japanese Web-Based Access Control (Jwac) Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 39 Japanese Web-Based Access Control (JWAC) Command List enable jwac disable jwac config jwac [quarantine_server_url [<string 128> | ipv6 <string 128>] | clear_quarantine_server_url {ipv6}] show jwac enable jwac redirect disable jwac redirect config jwac redirect {destination [quarantine_server | jwac_login_page] | delay_time <sec 0-...
  • Page 393 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Using the JWAC function, PC users need to pass two stages of authentication. The first stage is to do the authentication with the quarantine server and the second stage is the authentication with the Switch.
  • Page 394 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#disable jwac Command: disable jwac Success. DGS-3120-24TC:admin# 39-3 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 395 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 39-4 show jwac Description This command is used to display the JWAC configuration settings. Format show jwac Parameters None. Restrictions None. Example To display the current JWAC configuration: DGS-3120-24TC:admin#show jwac Command: show jwac State...
  • Page 396 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide URL. When redirect jwac_login_page is enabled, the unauthenticated host will be redirected to the jwac_login_page on the Switch to finish authentication. When enable redirect to quarantine server is in effect, a quarantine server must be configured first. Format enable jwac redirect Parameters...
  • Page 397: Enable Jwac Forcible_Logout

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#disable jwac redirect Command: disable jwac redirect Success. DGS-3120-24TC:admin# 39-7 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.
  • Page 398 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format enable jwac forcible_logout Parameters None. Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To enable JWAC forcible logout: DGS-3120-24TC:admin#enable jwac forcible_logout Command: enable jwac forcible_logout Success.
  • Page 399 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#disable jwac forcible_logout Command: disable jwac forcible_logout Success. DGS-3120-24TC:admin# 39-10 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.enable jwac udp_filtering Format...
  • Page 400 ® xStack DGS-3120 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 UDP filtering: DGS-3120-24TC:admin#disable jwac udp_filtering Command: disable jwac udp_filtering Success. DGS-3120-24TC:admin# 39-12 enable jwac quarantine_server_monitor Description This command is used to enable the JWAC quarantine server monitor.
  • Page 401: 39-13 Disable Jwac Quarantine_Server_Monitor

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 39-13 disable jwac quarantine_server_monitor Description This command is used to disable JWAC quarantine server monitoring. 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-3120-24TC:admin#disable jwac quarantine_server_monitor...
  • Page 402 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To set the quarantine server error timeout: DGS-3120-24TC:admin#config jwac quarantine_server_error_timeout 60 Command: config jwac quarantine_server_error_timeout 60 Success. DGS-3120-24TC:admin# 39-15 config jwac virtual_ip Description This command is used to configure JWAC virtual IP addresses used to accept authentication requests from an unauthenticated host.
  • Page 403 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide need to be able to have access to accomplish authentication. Before the client passes authentication, it should be added to the Switch with its IP address. For example, the client may need to access update.microsoft.com or some sites of the Anti-Virus software companies to check whether the OS or Anti-Virus software of the client are the latest;...
  • Page 404: []

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format config jwac switch_http_port <tcp_port_number 1-65535> {[http | https]} Parameters <tcp_port_number 1-65535> - Specify a TCP port which the JWAC switch listens to and uses to finish the authenticating process. http - (Optional) Specify the JWAC run HTTP protocol on this TCP port.
  • Page 405 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide state. infinite - Specify to indicate the idle state of the authenticated host on the port will never be checked. The default value is infinite. <min 1-1440> - Specify an idle time between 1 and 1440 minutes. block_time - If a host fails to pass the authentication, it will be blocked for a period specified by the blocking time.The default value is 60 seconds.
  • Page 406 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#show jwac ports 1-4 Command: show jwac ports 1:1-1:4 Port State Aging Time Idle Time Block Time (min) (min) (sec) Hosts ----- -------- ---------- --------- ---------- ----- Disabled 1440 Infinite...
  • Page 407 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 39-21 create jwac user Description This command is used to create JWAC users in the local database. When “local” is chosen while configuring the JWAC RADIUS protocol, the local database will be used. Format create jwac user <username 15>...
  • Page 408: Delete Jwac [User | All_Users]

    ® xStack DGS-3120 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 JWAC user: DGS-3120-24TC: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:******...
  • Page 409: Clear Jwac Auth_State [Ports [All | ] {Authenticated | Authenticating | Blocked} | Mac_Addr

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 39-24 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-3120-24TC:admin#show jwac user Command: show jwac user User Name...
  • Page 410 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide authenticating - (Optional) Specify the state of host to delete. blocked - (Optional) Specify the state of host to delete. mac_addr - Delete a specified host with this MAC address. <macaddr>...
  • Page 411: 39-27 Config Jwac Authorization Attributes

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC: show jwac auth_state ports 1-3C ommand: show jwac auth_state ports 1-3 Pri - Priority. State - A:Authenticated, B:Blocked, -:Authenticating Time - Aging Time/Idle Time for authenticated entries. Port MAC Address State VID...
  • Page 412 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To disable the configuration authorized from the local database: DGS-3120-24TC:admin#config jwac authorization attributes local disable Command: config jwac authorization attributes local disable Success. DGS-3120-24TC:admin# 39-28 show jwac update_server Description This command is used to display the JWAC update server.
  • Page 413 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format config jwac authentication_page element [japanese | english] [default | page_title <desc 128> | login_window_title <desc 32> | user_name_title <desc 16> | password_title <desc 16> | logout_window_title <desc 32> | notification_line <value 1-5> <desc 128>] Parameters japanese - Specify to change to the Japanese page.
  • Page 414: 39-31 Show Jwac Authenticate_Page

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format config jwac authenticate_page [japanese | english] 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.
  • Page 415 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#show jwac authenticate_page Command: show jwac authenticate_page Current Page : English Version English Page Element ----------------------------------------------------------- Page Title Login Window Title : Authentication Login User Name Title : User Name Password Title : Password...
  • Page 416: Chapter 40 Jumbo Frame Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 40 Jumbo Frame Command List enable jumbo_frame disable jumbo_frame show jumbo_frame 40-1 enable jumbo_frame Description This command is used to configure the jumbo frame setting as enable. Format enable jumbo_frame Parameters...
  • Page 417 ® xStack DGS-3120 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 disable the Jumbo frame: DGS-3120-24TC:admin# disable jumbo_frame Command: disable jumbo_frame Success. DGS-3120-24TC:admin# 40-3 show jumbo_frame Description This command is used to display the current configuration of jumbo frame.
  • Page 418: Chapter 41 Layer 2 Protocol Tunneling (L2Pt) Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 41 Layer 2 Protocol Tunneling (L2PT) Command List enable l2protocol_tunnel disable l2protocol_tunnel 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]} 41-1...
  • Page 419 ® xStack DGS-3120 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 the Layer 2 protocol tunneling function: DGS-3120-24TC:admin#disable l2protocol_tunnel Command: disable l2protocol_tunnel Success.
  • Page 420 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 01-00-0C-CC-CC-CD - Specify the MAC address as 01-00-0C-CC-CC-CD. all - All tunnel-abled Layer 2 protocols will be tunneled on the ports. threshold - (Optional) Specify the drop threshold for packets-per-second accepted on the UNI ports.
  • Page 421 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# show l2protocol_tunnel Command: show l2protocol_tunnel Global State : Enabled UNI Ports : 1:1-1:4 NNI Ports DGS-3120-24TC:admin# To show Layer 2 protocol tunneling information summary: DGS-3120-24TC:admin#show l2protocol_tunnel uni Command: show l2protocol_tunnel uni Tunneled Threshold...
  • Page 422: Chapter 42 Link Aggregation Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 42 Link Aggregation Command List 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]} 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 423 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 42-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 group_id - Specify the group id. The number of link aggregation groups is project dependency. The group number identifies each of the groups.
  • Page 424 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide are separated by a dash. For example, 1:3 would specify switch number 1, port 3. 2:4 specifies switch number 2, port 4. 1:3-2:4 specifies all of the ports between switch 1, port 3 and switch 2, port 4 −...
  • Page 425 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide destination port. Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To configure link aggregation algorithm for mac-source-dest: DGS-3120-24TC:admin# config link_aggregation algorithm mac_source_dest Command: config link_aggregation algorithm mac_source_dest Success.
  • Page 426 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#show link_aggregation Command: show link_aggregation Link Aggregation Algorithm = MAC-Source-Dest Group ID Type : LACP Master Port : 1:5 Member Port : 1:5-1:7 Active Port Status : Enabled Flooding Port : 7 Trap : Disabled...
  • Page 427 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#show link_aggregation Command: show link_aggregation Link Aggregation Algorithm = MAC-Source-Dest Group ID Type : LACP Master Port : 1:5 Member Port : 1:5-1:7 Active Port Status : Disabled Flooding Port : Trap : Disabled...
  • Page 428 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 42-7 show lacp_port Description This command is used to display the current mode of LACP of the ports. Format show lacp_port <portlist> Parameters lacp_port - Specified a range of ports to be configured. (UnitID:port number). <portlist>...
  • Page 429: Chapter 43 Link Layer Discovery Protocol (Lldp) Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 43 Link Layer Discovery Protocol (LLDP) Command List 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>] config lldp notification_interval <sec 5-3600>...
  • Page 430: Disable Lldp

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format enable lldp Parameters None. Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To enable LLDP: DGS-3120-24TC:admin# enable lldp Command: enable lldp Success.
  • Page 431: Config Lldp

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 43-3 config lldp Description This command is used to change the packet transmission interval. Format 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>] Parameters message_tx_interval - Changes the interval between consecutive transmissions of LLDP advertisements on any given port.
  • Page 432: Config Lldp Ports

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters notification_interval - Specify the timer of notification interval for sending notification to configured SNMP trap receiver(s). The default setting is 5 seconds. <sec 5-3600> - Enter the notification interval value here. This value must be between 5 and 3600 seconds.
  • Page 433 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide packets from neighbor devices. rx_only - Configure the specified port(s) to receive LLDP packets from neighbors, but block outbound packets to neighbors. tx_and_rx - Configure the specified port(s) to both transmit and receive LLDP packets. disable - Disable LLDP packet transmit and receive on the specified port(s).
  • Page 434 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide numerous vendor proprietary variations are responsible for maintaining the topology and connectivity of the network. If EAPOL, GVRP, STP (including MSTP), and LACP protocol identity is enabled on this port and it is enabled to be advertised, then this protocol identity will be advertised.
  • Page 435 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# config lldp ports 1:1-1:5 admin_status tx_and_rx Command: config lldp ports 1:1-1:5 admin_status tx_and_rx Success. DGS-3120-24TC:admin# To enable ports 1-2 for manage address entry: DGS-3120-24TC:admin# config lldp ports 1:1-1:2 mgt_addr ipv4 192.168.254.10 enable Command: config lldp ports 1:1-1:2 mgt_addr ipv4 192.168.254.10 enable Success...
  • Page 436 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC: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. DGS-3120-24TC:admin# To configure exclude the protocol identity TLV from the outbound LLDP advertisements for all ports: DGS-3120-24TC:admin# config lldp ports all dot1_tlv_protocol_identity all...
  • Page 437: Show Lldp

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# config lldp forward_message enable Command: config lldp forward_message enable Success. DGS-3120-24TC:admin# 43-7 show lldp Description This command is used to display the Switch’s general LLDP configuration status. Format show lldp Parameters...
  • Page 438: Show Lldp Ports

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 43-8 show lldp mgt_addr Description This command is used to display the LLDP management address information. Format show lldp mgt_addr {[ipv4 {<ipaddr>} | ipv6 {<ipv6addr>}]} Parameters ipv4 - (Optional) Specify the IPv4 address used for the display. <ipaddr>...
  • Page 439 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions None. Example To display the LLDP port 1 TLV option configuration: DGS-3120-24TC:admin#show lldp ports 1:1 Command: show lldp ports 1:1 Port ID : 1:1 ----------------------------------------------------------------- Admin Status : TX_and_RX Notification Status : Enabled...
  • Page 440 Command: show lldp local_ports 1:1 mode detailed Port ID : 1:1 ----------------------------------------------------------------------------- Port ID Subtype : MAC Address Port ID : 00-01-02-03-04-01 Port Description : D-Link DGS-3120-24TC R2.00.010 Port 1 on Unit 1 Port PVID Management Address Count Subtype : IPv4 Address : 0.0.0.0...
  • Page 441 Port ID : 1:1 ----------------------------------------------------------------------------- Port ID Subtype : MAC Address Port ID : 00-01-02-03-04-01 Port Description : D-Link DGS-3120-24TC R2.00.010 Port 1 on Unit 1 Port PVID Management Address Count PPVID Entries Count VLAN Name Entries Count Protocol Identity Entries Count...
  • Page 442 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters <portlist> - (Optional) Specified a range of ports to be configured. When port list is not specified, information for all ports will be displayed. mode – (Optional) Specify to display the information in various modes. brief - Display the information in brief mode.
  • Page 443 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Entity 3 Chassis ID Subtype : MACADDRESS Chassis ID : 00-01-02-03-04-05 Port ID Subtype : LOCAL Port ID : 2/3 Port Description : RMON Port 2 on Unit 3 DGS-3120-24TC:admin# To display remote table in normal mode: DGS-3120-24TC:admin#...
  • Page 444 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Power Via MDI : (See detail) Link Aggregation : (See detail) Maximum Frame Size : 1536 DGS-3120-24TC:admin# To display remote table in detailed mode: DGS-3120-24TC:admin# show lldp remote_ports 1:1 mode detailed Command: show lldp remote_ports 1:1 mode detailed Port ID : 1 ---------------------------------------------------------------------...
  • Page 445 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide PPVID Enable : Enable VLAN Name Entries Entry 1 VLAN ID VLAN Name : V1 Entry 2 VLANID VLAN Name : V2 Entry 3 VLAN ID VLAN Name : V3 Protocol Identity Entries Entry 1...
  • Page 446: Show Lldp Statistics

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Unknown TLV type : 31 Unknown TLV Information Bytes : XX XX XX XX XX XX(hex) DGS-3120-24TC:admin# 43-12 show lldp statistics Description This command is used to display an overview of neighbor detection activity on the Switch. Format show lldp statistics Parameters...
  • Page 447 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide information for all ports will be displayed. Restrictions None. Example To display statistics information of port 1: DGS-3120-24TC:admin# show lldp statistics ports 1:1 Command: show lldp statistics ports 1:1 Port ID: 1 ------------------------------------------------------------------------ lldpStatsTxPortFramesTotal...
  • Page 448 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#config lldp_med fast_start repeat_count 5 Command: config lldp_med fast_start repeat_count 5 Success. DGS-3120-24TC:admin# 43-15 config lldp_med log state Description This command is used to configure the log state of LLDP-MED events. Format config lldp_med log state [enable | disable] Parameters...
  • Page 449 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide state - Enable or disable the SNMP trap notification of topology change detected state. enable - Enable the SNMP trap notification of topology change detected. disable - Disable the SNMP trap notification of topology change detected. The default notification state is disabled.
  • Page 450 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator and Operator-level users can issue this command. Example To enable transmitting all capabilities on all ports: DGS-3120-24TC:admin#config lldp_med ports all med_transmit_capabilities all state enable Command: config lldp_med ports all med_transmit_capabilities all state enable Success.
  • Page 451 : A1 Firmware Revision : 2.00.003 Software Revision : 2.00.010 Serial Number : abcd1234 Manufacturer Name : D-Link Model Name : DGS-3120-24TC Gigabit Ethernet S Asset ID PoE Device Type : PSE Device PoE PSE Power Source : Primary LLDP-MED Configuration:...
  • Page 452 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format show lldp_med local_ports {<portlist>} Parameters <portlist> - (Optional) Specify a range of ports to be displayed. Restrictions None. Example To display LLDP-MED information currently available for populating outbound LLDP-MED advertisements for port 1: DGS-3120-24TC:admin#show lldp_med local_ports 1:1 Command: show lldp_med local_ports 1:1...
  • Page 453 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions None. Example To display remote entry information: DGS-3120-24TC:admin#show lldp_med remote_ports 1:1 Command: show lldp_med remote_ports 1:1 Port ID : 1:1 --------------------------------------------------------------------------- Remote Entities Count : 1 Entity 1 Chassis ID Subtype : MAC Address...
  • Page 454 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Location Information Location Subtype: CivicAddress Location Information Extended Power Via MDI Power Device Type: PD Device Power Priority : High Power Source : From PSE Power Request : 8 Watts Inventory Management: Hardware Revision...
  • Page 455: Chapter 44 Loop Back Detection (Lbd) Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 44 Loop Back Detection (LBD) Command List config loopdetect {recover_timer [0 | <sec 60-1000000>] | interval <sec 1-32767> | mode [port- based | vlan-based]} config loopdetect ports [<portlist> | all] state [enable | disable] enable loopdetect disable loopdetect show loopdetect...
  • Page 456: Config Loopdetect Ports

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To set the auto-recover time to 0, which disables the auto-recovery mechanism, the interval to 20 seconds and specify VLAN-based mode: DGS-3120-24TC:admin# config loopdetect recover_timer 0 interval 20 mode vlan- based Command: config loopdetect recover_timer 0 interval 20 mode vlan-based Success.
  • Page 457: Disable Loopdetect

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format enable loopdetect Parameters None. Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To enable the LBD function globally: DGS-3120-24TC:admin# enable loopdetect Command: enable loopdetect Success.
  • Page 458: Show Loopdetect

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# disable loopdetect Command: disable loopdetect Success. DGS-3120-24TC:admin# 44-5 show loopdetect Description This command is used to display the LBD global configuration. Format show loopdetect Parameters None. Restrictions Only Administrator and Operator-level users can issue this command.
  • Page 459 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format show loopdetect ports {<portlist>} Parameters ports - Specify the range of member ports that will display the LBD settings. <portlist> - Enter the list of port to be configured here. If no port is specified, the configuration for all ports will be displayed.
  • Page 460: Config Loopdetect Log

    ® xStack DGS-3120 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 specify that traps will be sent when the loop condition is detected or cleared: DGS-3120-24TC:admin# config loopdetect trap both Command: config loopdetect trap both Success.
  • Page 461: Chapter 45 Mac Notification Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 45 MAC Notification Command List enable mac_notification disable mac_notification config mac_notification {interval <sec 1-2147483647> | historysize <int 1-500>} config mac_notification ports [<portlist> | all] [enable | disable] show mac_notification show mac_notification ports {<portlist>} 45-1...
  • Page 462 ® xStack DGS-3120 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 disable mac_notification function: DGS-3120-24TC:admin# disable mac_notification Command: disable mac_notification Success. DGS-3120-24TC:admin# 45-3 config mac_notification Description This command is used to configure the Switch’s MAC address table notification global settings.
  • Page 463 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 45-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> | all] [enable | disable] Parameters <portlist>...
  • Page 464 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To show the Switch’s Mac address table notification global settings: DGS-3120-24TC:admin# show mac_notification Command: show mac_notification Global Mac Notification Settings State : Enabled Interval History Size : 500 DGS-3120-24TC:admin# 45-6...
  • Page 465 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC: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 DGS-3120-24TC:admin#...
  • Page 466: Chapter 46 Mac-Based Access Control Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 46 MAC-based Access Control Command List enable mac_based_access_control disable mac_based_access_control config mac_based_access_control password <passwd 16> config mac_based_access_control password_type [manual_string | client_mac_address] config mac_based_access_control method [local | radius] config mac_based_access_control guest_vlan ports <portlist>...
  • Page 467 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To enable the MAC-based Access Control global state: DGS-3120-24TC:admin# enable mac_based_access_control Command: enable mac_based_access_control Success. DGS-3120-24TC:admin# 46-2 disable mac_based_access_control Description This command is used to disable MAC-based Access Control. Format disable mac_based_access_control Parameters...
  • Page 468 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters password - In RADIUS mode, the Switch will communicate with the RADIUS server using this password. The maximum length of the key is 16. <password> - Enter the password used here. The default password is “default”. Restrictions Only Administrator, Operator and Power-User level users can issue this command.
  • Page 469 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 46-5 config mac_based_access_control method Description This command is used to configure the MAC-based Access Control authentication method. Format config mac_based_access_control method [local | radius] Parameters local - Specify to authenticate via the local database. radius - Specify to authenticate via a RADIUS server.
  • Page 470 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To set the MAC-based Access Control guest VLAN membership: DGS-3120-24TC:admin# config mac_based_access_control guest_vlan ports 1-8 Command: config mac_based_access_control guest_vlan ports 1-8 Success. DGS-3120-24TC:admin# 46-7 config mac_based_access_control ports Description This command is used to configure MAC-based Access Control port’s setting.
  • Page 471 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters ports - Specify a range of ports for configuring the MAC-based Access Control function parameters. <portlist> - Enter the list of port used for this configuration here. all - Specify all existed ports of switch for configuring the MAC-based Access Control function parameters.
  • Page 472 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# config mac_based_access_control ports 1:1-1:8 aging_time infinite block_time 120 Command: config mac_based_access_control ports 1:1-1:8 aging_time infinite block_time 120 Success. DGS-3120-24TC:admin# 46-8 create mac_based_access_control Description This command is used to assign a static 802.1Q VLAN as a MAC-based Access Control guest VLAN.
  • Page 473 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format delete mac_based_access_control [guest_vlan <vlan_name 32> | guest_vlanid <vlanid 1- 4094>] Parameters guest_vlan - Specify the name of the MAC-based Access Control’s guest VLAN. <vlan_name 32> - Enter the VLAN name here. This name can be up to 32 characters long. guest_vlanid - Specify the VID of the MAC-based Access Control’s guest VLAN.
  • Page 474 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To clear MAC-based Access Control clients’ authentication information for all ports: DGS-3120-24TC:admin# clear mac_based_access_control auth_state ports all Command: clear mac_based_access_control auth_state ports all Success. DGS-3120-24TC:admin# To delete the MAC-based Access Control authentication information for the host that has a MAC address of 00-00-00-47-04-65: DGS-3120-24TC:admin# clear mac_based_access_control auth_state mac_addr 00-00- 00-47-04-65...
  • Page 475 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To create one MAC-based Access Control local database entry for MAC address 00-00-00-00-00- 01 and specify that the host will be assigned to the “default” VLAN after the host has been authorized: DGS-3120-24TC:admin# create mac_based_access_control_local mac 00-00-00-00-00- 01 vlan default...
  • Page 476 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# config mac_based_access_control_local mac 00-00-00-00-00- 01 vlan default Command: config mac_based_access_control_local mac 00-00-00-00-00-01 vlan default Success. DGS-3120-24TC:admin# 46-13 delete mac_based_access_control_local Description This command is used to delete a MAC-based Access Control local database entry. Format delete mac_based_access_control_local [mac <macaddr>...
  • Page 477 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# delete mac_based_access_control_local vlan VLAN3 Command: delete mac_based_access_control_local vlan VLAN3 Success. DGS-3120-24TC:admin# 46-14 config mac_based_access_control authorization attributes Description This command is used to enable or disable the acceptation 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 478 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 46-15 show mac_based_access_control Description This command is used to display the MAC-based Access Control setting. Format show mac_based_access_control {ports {<portlist>}} Parameters ports – (Optional) Displays the MAC-based Access Control settings for a specific port or range of ports.
  • Page 479 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide address. <macaddr> - Enter the MAC address used here. vlan - (Optional) Displays MAC-based Access Control local database entries for a specific target VLAN name. <vlan_name 32> - Enter the VLAN name here. This name can be up to 32 characters long. vlanid - (Optional) Displays MAC-based Access Control local database entries for a specific target VLAN ID.
  • Page 480 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#show mac_based_access_control auth_state ports 1:1-1:4 Command: show mac_based_access_control auth_state ports 1:1-1:4 (P): Port-based Port MAC Address State Priority Aging Time/ Block Time ---- -------------------- -------------- ---- -------- ------------ Total Authenticating Hosts Total Authenticated Hosts Total Blocked Hosts...
  • Page 481 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 46-19 config mac_based_access_control trap state Description This command is used to enable or disable sending of MAC-based Access Control traps. Format config mac_based_access_control trap state [enable | disable] Parameters enable - Enable trap for MAC-based Access Control.
  • Page 482 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To disable log state of MAC-based Access Control: DGS-3120-24TC:admin# config mac_based_access_control log state disable Command: config mac_based_access_control log state disable Success. DGS-3120-24TC:admin#...
  • Page 483: Chapter 47 Mac-Based Vlan Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 47 MAC-based VLAN Command List 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 484 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# create mac_based_vlan mac_address 00-11-22-33-44-55 vlanid Command: create mac_based_vlan mac_address 00-11-22-33-44-55 vlanid 100 Success. DGS-3120-24TC:admin# 47-2 delete mac_based_vlan Description This command is used to delete the static MAC-based VLAN entry. Format delete mac_based_vlan {mac_address <macaddr>...
  • Page 485 ® xStack DGS-3120 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 entry that you would like to display. <macaddr>...
  • Page 486: Chapter 48 Mirror Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 48 Mirror Command List config mirror port <port> {[add | delete] source ports <portlist> [rx | tx | both]} enable mirror disable mirror show mirror 48-1 config mirror Description This command is used to configure a mirror port −...
  • Page 487: Enable Mirror

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 48-2 enable mirror Description This command is used to enable mirror function without having to modify the mirror session configuration. Format enable mirror Parameters None. Restrictions Only Administrator and Operator-level users can issue this command. Example To enable mirroring function: DGS-3120-24TC:admin# enable mirror...
  • Page 488: Show Mirror

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To disable mirroring function: DGS-3120-24TC:admin# disable mirror Command: disable mirror Success. DGS-3120-24TC:admin# 48-4 show mirror Description This command is used to display the current mirror function state and mirror session configuration on the Switch.
  • Page 489: Chapter 49 Mstp Debug Enhancement Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 49 MSTP debug enhancement Command List debug stp config ports [<portlist> | all] [event | bpdu | state_machine | all] state [disable | brief | detail] debug stp show information debug stp show flag {ports <portlist>} debug stp show counter {ports [<portlist>...
  • Page 490: Debug Stp Show Information

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# debug stp config ports all all state brief Command: debug stp config ports all all state brief Warning: only support local device. Success. DGS-3120-24TC:admin# 49-2 debug stp show information Description This command is used to display STP detailed information, such as the hardware tables, the STP state machine, etc.
  • Page 491: Debug Stp Show Flag

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Regional Root Bridge : 32768/00-01-70-33-21-02 Internal Root Cost Designated Bridge : 32768/00-01-70-33-21-02 Designated Port Message Age Max Age : 20 Forward Delay : 15 Hello Time -------------------------------------- Designated Priority And Times: Instance 0: --------------------------------------...
  • Page 492: Debug Stp Show Counter

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Brief Brief Brief Brief Brief Brief Brief Brief Brief Brief Brief Brief Brief Brief Brief Brief Brief Brief Brief Brief Brief 1:10 Brief Brief Brief 1:11 Brief Brief Brief 1:12...
  • Page 493: Debug Stp Clear Counter

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# debug stp show counter ports 1:9 Command: debug stp show counter ports 1:9 STP Counters -------------------------------------- Port 1:9 Receive: Transmit: Total STP Packets Total STP Packets Configuration BPDU Configuration BPDU : 0 TCN BPDU...
  • Page 494: Debug Stp State

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# debug stp clear counter ports all Command: debug stp clear counter ports all Warning: only support local device. Success. DGS-3120-24TC:admin# 49-6 debug stp state Description This command is used to enable or disable the STP debug state. Format debug stp state [enable | disable] Parameters...
  • Page 495 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format config stp trap {topo_change [disable | enable ] | new_root [enable | disable]}(1) Parameters topo_change - Specify the state of sending new root traps. The default state is enable. disable - Disable sending new root traps.
  • Page 496: Chapter 50 Multicast Filter Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 50 Multicast Filter Command List create mcast_filter_profile {[ipv4 | ipv6]} profile_id <value 1-24> profile_name <name 32> config mcast_filter_profile [profile_id <value 1-24> | profile_name <name 32>] {profile_name <name 32>...
  • Page 497 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# create mcast_filter_profile profile_id 2 profile_name MOD Command: create mcast_filter_profile profile_id 2 profile_name MOD Success. DGS-3120-24TC:admin# 50-2 config mcast_filter_profile Description This command is used to add or delete a range of multicast IP addresses to or from the profile. Format config mcast_filter_profile [profile_id <value 1-24>...
  • Page 498 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format config mcast_filter_profile ipv6 [profile_id <value 1-24> | profile_name <name 32>] {profile_name <name 32> | [add | delete] <mcastv6_address_list>}(1) Parameters profile_id - ID of the profile. <value 1-24> - Enter the profile ID value here. This value must be between 1 and 24. profile_name - Provides a meaningful description for the profile.
  • Page 499 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide profile_name - Specify to display a profile based on the profile name. <name 32> - Enter the profile name value here. The profile name can be up to 32 characters long.
  • Page 500 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To display all the defined multicast address profiles: DGS-3120-24TC:admin# show mcast_filter_profile Command: show mcast_filter_profile Profile ID Name Multicast Addresses ---- ---------------- ---------------- ---------------- 234.1.1.1 - 238.244.244.244 234.1.1.1 - 238.244.244.244 customer 224.19.62.34 - 224.19.162.200...
  • Page 501 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide all - Specify to delete all multicast address profile.. access - Specify the access of packets matching the addresses defined in the profiles. permit - Specify that packets matching the addresses defined in the profiles will be permitted. The default mode is permit.
  • Page 502 ® xStack DGS-3120 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 number of multicast group that ports 1 and 3 can join to 100: DGS-3120-24TC:admin# config max_mcast_group ports 1, 3 max_group 100 Command: config max_mcast_group ports 1, 3 max_group 100 Success.
  • Page 503 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#show max_mcast_group ports 1:1-1:2 Command: show max_mcast_group ports 1:1-1:2 Port Max Multicast Group Number Action ------ ---------------------------- --------- Infinite Drop Drop Total Entries: 2 DGS-3120-24TC:admin# To display the maximum number of multicast groups that VLANs 1 and 2 can join: DGS-3120-24TC:admin#show max_mcast_group vlanid 1-2 Command: show max_mcast_group vlanid 1-2 VLAN...
  • Page 504 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions None. Example To show the limited multicast address range on ports 1 and 3: DGS-3120-24TC:admin# show limited_multicast_addr ports 1,3 Command: show limited_multicast_addr ports 1,3 Port Access : Deny Profile ID Name...
  • Page 505 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format config cpu_filter l3_control_pkt <portlist> [{dvmrp | pim | igmp_query}(1) | all] state [enable | disable] Parameters <portlist> - Specify the port list to filter control packets. dvmrp - Specify to filter the DVMRP control packets.
  • Page 506 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#show cpu_filter l3_control_pkt ports 1:1-1:2 Command: show cpu_filter l3_control_pkt ports 1:1-1:2 Port IGMP Query DVMRP ---- ---------- -------- -------- Disabled Enabled Disabled Disabled Enabled Disabled DGS-3120-24TC:admin#...
  • Page 507: Chapter 51 Multicast Vlan Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 51 Multicast VLAN Command List create [igmp_snooping | mld_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 508 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format create [igmp_snooping | mld_snooping] multicast_vlan <vlan_name 32> <vlanid 2-4094> {remap_priority [<value 0-7> | none] {replace_priority}} Parameters igmp_snooping - Specify to configure VLAN for IGMP snooping. mld_snooping - Specify to configure VLAN for MLD snooping. multicast_vlan - The name of the multicast VLAN to be created.
  • Page 509 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters multicast_vlan - The name of the multicast VLAN to be configured. <vlan_name 32> - Enter the VLAN here. The VLAN name can be up to 32 characters long. add - Specify that the entry will be added to the specified multicast VLAN.
  • Page 510 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 51-3 config mld_snooping multicast_vlan Description This command is used to add member ports and source ports to a list of multicast VLAN member ports. Member ports automatically become untagged members of the multicast VLAN and source ports automatically become tagged members of the multicast VLAN.
  • Page 511 ® xStack DGS-3120 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 an MLD snooping multicast VLAN with the name “v1”, make ports 1 and 3 members of the VLAN, and set the state to enable: DGS-3120-24TC:admin#config mld_snooping multicast_vlan v1 add member_port 1:1,1:3 state enable...
  • Page 512 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 51-5 config igmp_snooping multicast_vlan_group_profile Description This command is used to configure an IGMP snooping multicast group profile on the Switch and add or delete multicast addresses for the profile. Format config igmp_snooping multicast_vlan_group_profile <profile_name 1-32>...
  • Page 513 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format config mld_snooping multicast_vlan_group_profile <profile_name 1-32> [add | delete] <mcast_v6address_list> Parameters multicast_vlan_group_profile - Specify the multicast VLAN profile name. The maximum length is 32 characters. <profile_name 1-32> - Enter the multicast VLAN group profile name here. This name can be up to 32 characters long.
  • Page 514 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters igmp_snooping - Specify to delete an IGMP snooping group profile. mld_snooping - Specify to delete an MLD snooping group profile. profile_name - Specify the multicast VLAN profile name. <profile_name 1-32>...
  • Page 515 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# show igmp_snooping multicast_vlan_group_profile Command: show igmp_snooping multicast_vlan_group_profile Profile Name Multicast Addresses --------------------- -------------------------------- 234.1.1.1 - 238.244.244.244 239.1.1.1 - 239.2.2.2 Customer 224.19.62.34 - 224.19.162.200 Total Entries : 2 DGS-3120-24TC:admin# 51-9 config [igmp_snooping | mld_snooping]...
  • Page 516 ® xStack DGS-3120 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 an IGMP snooping profile to a multicast VLAN group with the name “v1”: DGS-3120-24TC:admin# config igmp_snooping multicast_vlan_group v1 add profile_name channel_1...
  • Page 517 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 51-11 delete [igmp_snooping | mld_snooping] multicast_vlan Description This command is used to delete an IGMP or MLD snooping multicast VLAN. Format delete [igmp_snooping | mld_snooping] multicast_vlan <vlan_name 32> Parameters igmp_snooping - Specify that an IGMP snooping multicast VLAN will be deleted.
  • Page 518 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator-level users can issue this command. Example To enable the IGMP snooping multicast VLAN function globally: DGS-3120-24TC:admin# enable igmp_snooping multicast_vlan Command: enable igmp_snooping multicast_vlan Success. DGS-3120-24TC:admin# 51-13 disable [igmp_snooping | mld_snooping] multicast_vlan Description...
  • Page 519 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 51-14 config [igmp_snooping | mld_snooping] multicast_vlan forward_unmatched Description This command is used to configure the forwarding mode for multicast VLAN unmatched packets. When the Switch receives an IGMP/MLD snooping packet, it will match the packet against the multicast profile to determine which multicast VLAN to associate with.
  • Page 520 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters igmp_snooping - Specify that IGMP snooping multicast VLANs will be displayed. mld_snooping - Specify that MLD snooping multicast VLANs will be displayed. multicast_vlan - The name of the multicast VLAN to be shown. <vlan_name 32>...
  • Page 521: Chapter 52 Multiple Spanning Tree Protocol (Mstp) Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 52 Multiple Spanning Tree Protocol (MSTP) Command List enable stp disable stp config stp {maxage <value 6-40> | maxhops <value 6-40> | hellotime <value 1-2> | forwarddelay <value 4-30>...
  • Page 522: Disable Stp

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# enable stp Command: enable stp Success. DGS-3120-24TC:admin# 52-2 disable stp Description This command is used to disable STP globally. Format disable stp Parameters None. Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To disable STP: DGS-3120-24TC:admin#...
  • Page 523: Show Stp

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide <value 6-40> - Enter the maximum age value here. This value must be between 6-40. maxhops - (Optional) Used to restrict the forwarded times of one BPDU. The default value is 20. <value 6-40>...
  • Page 524 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To show STP: DGS-3120-24TC:admin#show stp Command: show stp STP Bridge Global Settings --------------------------- STP Status : Enabled STP Version : RSTP Max Age : 25 Hello Time Forward Delay : 15 Max Hops...
  • Page 525 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# create stp instance_id 2 Command: create stp instance_id 2 Success. DGS-3120-24TC:admin# 52-6 config stp instance_id Description This command is used to map or remove the VLAN range of the specified MST instance for the existed MST instances.
  • Page 526 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 52-7 delete stp instance_id Description This command is used to delete an MST Instance. Format delete stp instance_id <value 1-15> Parameters instance_id - Specify the MSTP instance ID. Instance 0 represents for default instance, CIST. <value 1-15>...
  • Page 527 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To change the name and revision level of the MST configuration identification: DGS-3120-24TC:admin# config stp mst_config_id name R&D_BlockG revision_level 1 Commands: config stp mst_config_id name R&D_BlockG revision_level 1 Success.
  • Page 528: Config Stp Ports

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format config stp mst_ports <portlist> instance_id <value 0-15> {internalCost [auto | <value 1- 200000000>] | priority <value 0-240>} Parameters mst_ports - Specify to be distinguished from the parameters of ports only at CIST level. <portlist>...
  • Page 529: Show Stp Ports

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide hellotime - (Optional) The default value is 2 . This parameter is for MSTP version. For STP and RSTP version, uses the per system hellotime parameter. <value 1-2> - Enter the hello time value here. This value must be between 1 and 2. migrate - (Optional) Operation of management in order to specify the port to send MSTP BPDU for a delay time.
  • Page 530: Config Stp Priority

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format show stp ports {<portlist>} Parameters ports - To show parameters of the designated port numbers, to be distinguished from showing parameters of the bridge. <portlist> - (Optional) Enter a list of ports used for the configuration here. Restrictions None.
  • Page 531 ® xStack DGS-3120 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 STP instance ID: DGS-3120-24TC:admin# config stp priority 61440 instance_id 0 Command: config stp priority 61440 instance_id 0 Success.
  • Page 532: Config Stp Version

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 52-15 config stp version Description This command is used to enable STP globally. Format config stp version [mstp | rstp | stp] Parameters version - To decide to run under which version of STP. mstp - Multiple Spanning Tree Protocol.
  • Page 533 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters instance - Specify the MSTP instance ID. <value 0-15> - (Optional) Enter the MSTP instance ID value here. This value must be between 0 and 15. Restrictions None.
  • Page 534: Chapter 53 Network Load Balancing (Nlb) Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 53 Network Load Balancing (NLB) Command List create nlb unicast_fdb <macaddr> config nlb unicast_fdb <macaddr> [add | delete] <portlist> delete nlb unicast_fdb <macaddr> create nlb multicast_fdb [<vlan_name 32> | vlanid <vlanid 1-4094>] <macaddr> config nlb multicast_fdb [<vlan_name 32>|vlanid <vlanid 1-4094>] <macaddr>...
  • Page 535 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format config nlb unicast_fdb <macaddr> [add | delete] <portlist> Parameters <macaddr> - Specify the MAC address of the NLB unicast FDB entry to be configured. add - Specify to add the ports. delete - Specify to delete the ports.
  • Page 536 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#delete nlb unicast_fdb 02-bf-01-01-01-01 Command: delete nlb unicast_fdb 02-BF-01-01-01-01 Success. DGS-3120-24TC:admin# 53-4 create nlb multicast_fdb Description This command is used to create a NLB multicast FDB entry. The number of supported entries is project dependent.
  • Page 537 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC: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-3120-24TC:admin# 53-5 config nlb multicast_fdb Description This command is used to add or delete the forwarding ports for the specified NLB multicast FDB entry.
  • Page 538: Show Nlb Fdb

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format delete nlb multicast_fdb [<vlan_name 32> |vlanid <vlanid 1-4094>] <macaddr> Parameters <vlan_name 32> - Specify the VLAN of the NLB multicast FDB entry to be deleted. vlanid - Specify the VLAN by VLAN ID. <vlanid 1-4094>...
  • Page 539 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# show nlb fdb Command: show nlb fdb MAC Address VLAN ID Egress Ports ----------------- ---------- ---------------------------------- 03-bf-01-01-01-01 1:1-1:5,1:24,2:24 03-bf-01-01-01-01 1:1-1:5,1:24,2:24 Total Entries : 2 DGS-3120-24TC:admin#...
  • Page 540: Chapter 54 Network Monitoring Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 54 Network Monitoring Command List show packet ports <portlist> show error ports <portlist> show utilization [cpu | ports] show utilization dram {unit <unit_id>} show utilization flash {unit <unit_id>} clear counters {ports <portlist>} 54-1 show packet ports...
  • Page 541: Show Error Ports

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#show packet ports 1:7 Command: show packet ports 1:7 Port Number : 1:7 ================================================================== Frame Size/Type Frame Counts Frames/sec --------------- ---------------------- ----------- 65-127 128-255 256-511 512-1023 1024-1518 Unicast RX Multicast RX Broadcast RX...
  • Page 542: Show Utilization

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#show error ports 1:3 Command: show error ports 1:3 Port Number : 1:3 RX Frames TX Frames --------- --------- CRC Error Excessive Deferral Undersize CRC Error Oversize Late Collision Fragment Excessive Collision...
  • Page 543 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# show utilization ports Command: show utilization ports Port TX/sec RX/sec Util Port TX/sec RX/sec Util ----- ---------- ---------- ---- ----- ---------- ---------- ---- 1:21 1:22 1:23 1:24 1:10 1:11...
  • Page 544: Show Utilization Dram

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#show utilization cpu Command: show utilization cpu CPU Utilization ------------------------------------------------------------------------------- Five seconds - 10 % One minute - 10 % Five minutes - 10 % CTRL+C ESC q Quit SPACE n Next Page...
  • Page 545: Show Utilization Flash

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#show utilization dram Command: show utilization dram Unit 1 DRAM utilization : Total DRAM : 131072 Used DRAM : 128128 Utilization : 97 % CTRL+C ESC q Quit SPACE n Next Page...
  • Page 546 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format clear counters {ports <portlist>} Parameters ports - (Optional) Specify a range of ports to be configured. The port list is specified by listing the lowest switch number and the beginning port number on that switch, separated by a colon. Then highest switch number, and the highest port number of the range (also separeted by a colon) are specified.
  • Page 547: Chapter 55 Oam Commands (Ei Mode Only)

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 55 OAM Commands (EI Mode Only) 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 548 ® xStack DGS-3120 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>...
  • Page 549 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide critical_link_event –Specify critical link event. dying_gasp - An unrecoverable local failure condition has occurred. critical_event - An unspecified critical event has occurred. notify_state - Specify the event notification status. The default state is enable. enable - Specify to enable event notification.
  • Page 550 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC: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. DGS-3120-24TC:admin# To configure the error frame seconds threshold to 2 and period to 10000 ms for port 1: DGS-3120-24TC:admin# config ethernet_oam ports 1 link_monitor...
  • Page 551 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# config ethernet_oam ports 1 received_remote_loopback process Command: config ethernet_oam ports 1 received_remote_loopback process Success. DGS-3120-24TC:admin# 55-2 show ethernet_oam ports Description This command is used to display Ethernet OAM information, including status, configuration, statistics, and event log, on specified ports.
  • Page 552 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Variable: It indicates that the OAM entity can send and receive variable requests to monitor the attribute value as described in the IEEE 802.3 Clause 30 MIB. The event log displays Ethernet OAM event log information.
  • Page 553 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# show ethernet_oam ports 1 statistics Command: show ethernet_oam ports 1 statistics Port 1 ------------------------------------------------------------ Information OAMPDU TX Information OAMPDU RX 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...
  • Page 554 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# clear ethernet_oam ports 1 statistics Command: clear ethernet_oam ports 1 statistics Success. DGS-3120-24TC:admin# To clear port 1 OAM events: DGS-3120-24TC:admin# clear ethernet_oam ports 1 event_log Command: clear ethernet_oam ports 1 event_log Success.
  • Page 555: Chapter 56 Password Recovery Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 56 Password Recovery Command List enable password_recovery disable password_recovery show password_recovery 56-1 enable password_recovery Description This command is used to enable the password recovery mode. Note: This command does not take effect until being saved. Format enable password_recovery Parameters...
  • Page 556 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format disable password_recovery Parameters None. Restrictions Only Administrator-level users can issue this command. Example To disable the password recovery mode: DGS-3120-24TC:admin# disable password_recovery Command: disable password_recovery Success. DGS-3120-24TC:admin# 56-3 show password_recovery...
  • Page 557 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To display the password recovery state: DGS-3120-24TC:admin# show password_recovery Command: show password_recovery Running Configuration : Enabled NV-RAM Configuration : Enabled DGS-3120-24TC:admin#...
  • Page 558: Chapter 57 Peripherals Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 57 Peripherals Command List show device_status show environment config temperature threshold {high <temperature -500-500> | low <temperature -500-500>} config temperature [trap | log] state [enable | disable] config fan trap state [enable | disable] config power trap state [enable | disable] 57-1...
  • Page 559: Show Environment

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 57-2 show environment Description This command is used to display current status of power(s) and fan(s) on the system. Format show environment Parameters None. Restrictions None. Example To display the standalone device environment:...
  • Page 560: Config Temperature Threshold

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#show environment Command: show environment High Warning Temperature Threshold(Celsius) : Low Warning Temperature Threshold(Celsius) Unit Internal Power : Active External Power : Fail Right Fan 1 : Speed Low (3000 RPM) Right Fan 2 : Speed Low...
  • Page 561: Config Temperature

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide <temperature -500-500> - Enter the high threshold temperature here. low - (Optional) To configure low threshold value. n is the low threshold value. <temperature -500-500> - Enter the low threshold temperature here. Restrictions Only Administrator and Operator-level users can issue this command.
  • Page 562 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 57-5 config fan trap state Description This command is used to configure the trap state for fan warning event. Format config fan trap state [enable | disable] Parameters enable - Enable trap state for warning fan event.
  • Page 563 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#config power trap state enable Command: config power trap state enable Success. DGS-3120-24TC:admin#...
  • Page 564: Chapter 58 Ping Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 58 Ping Command List ping <ipaddr> {times <value 1-255> | timeout <sec 1-99>} ping6 <ipv6addr> {times <value 1-255> | size <value 1-6000> | timeout <sec 1-99>} (EI Mode Only) 58-1...
  • Page 565 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 58-2 ping6 (EI Mode Only) Description This command is used to send IPv6 Internet Control Message Protocol (ICMP) echo messages to a remote IPv6 address. The remote IPv6 address will then “echo” or return the message. This is used to confirm the IPv6 connectivity between the Switch and the remote device.
  • Page 566: Chapter 59 Port Security Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 59 Port Security Command List config port_security system max_learning_addr [<max_lock_no 1-3072> | no_limit] config port_security ports [<portlist> | all] [{admin_state [enable | disable] | max_learning_addr <max_lock_no 0-3072> | lock_address_mode [permanent | deleteontimeout | deleteonreset]} (1)| {vlan [<vlan_name 32>...
  • Page 567 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# config port_security system max_learning_addr 256 Command: config port_security system max_learning_addr 256 Success. DGS-3120-24TC:admin# 59-2 config port_security ports Description This command is used to configure the admin state, the maximum number of addresses that can be learnt and the lock address mode.
  • Page 568 ® xStack DGS-3120 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 port-based port security setting so that the maximum number of port security entries is restricted to 10, and the lock_address mode is set to permanent on port 6: DGS-3120-24TC:admin#config port_security ports 1:6 admin_state enable max_learning_addr 10 lock_address_mode permanent...
  • Page 569 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To configure the maximum number of VLAN-based port security entries on VLAN 1 to be 64: DGS-3120-24TC:admin# config port_security vlan vlanid 1 max_learning_addr 64 Command: config port_security vlan vlanid 1 max_learning_addr 64 Success.
  • Page 570 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format clear port_security_entry {ports [<portlist> | all] {[vlan <vlan_name 32> | vlanid <vidlist>]}} Parameters ports - (Optional) Specify the range of ports to be configured. <portlist> - The port security entries learned on the specified port will be cleared. all - All the port security entries learned by the system will be cleared.
  • Page 571 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions None. Example To show all the port security entries: DGS-3120-24TC:admin# show port_security_entry Command: show port_security_entry MAC Address Port Lock Mode ----------------- ---- ----- --------------- 00-00-00-00-00-01 DeleteOnTimeout Total Entries: 1 DGS-3120-24TC:admin# 59-7...
  • Page 572 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#show port_security Command: show port_security Port Security Trap State : Disabled Port Security Log State : Disabled System Maximum Address : 256 VLAN Configuration (Only VLANs with limitation are displayed) VLAN Name Max.
  • Page 573 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 59-9 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, if 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 574: Chapter 60 Power Over Ethernet (Poe) Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 60 Power over Ethernet (PoE) Command List config poe system {units [<unitlist> | all]} {power_limit <value 37-760>| power_disconnect_method [deny_next_port | deny_low_priority_port] | legacy_pd [enable | disable]} config poe ports [all | <portlist>] { state [enable | disable]| [time_range <range_name 32>...
  • Page 575: Config Poe Ports

    DGS-3120 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 config PoE system-wise was setting: DGS-3120-24PC:admin# config poe system power_limit 250 power_disconnect_method deny_low_priority_port Command: config poe system power_limit 250 power_disconnect_method deny_low_priority_port Success.
  • Page 576 Command: config poe ports 1:1-1:4 state enable priority critical power_limit class_1 Success. DGS-3120-24PC:admin# config poe ports 5 state enable priority critical power_lim it user_define 1000 Command: config poe ports 1:5 state enable priority critical power_limit user_define 1000 Success.
  • Page 577: Show Poe System

    If no parameter specified, the system will display the status of all supported poe units in the systems. Restrictions None. Example To display PoE system: DGS-3120-24PC:admin#show poe system units 1 Command: show poe system units 1 Unit: 1 PoE System Information --------------------------------------------------- Power Limit : 760(Watts)
  • Page 578 <portlist> - (Optional) Specified a list of ports to be displayed. If no parameter specified, the system will display the status for all ports. Restrictions None. Example To display PoE port: DGS-3120-24PC:admin#show poe ports 1:1-1:6 Command: show poe ports 1:1-1:6 Port State Priority Power Limit(mW)
  • Page 579: Chapter 61 Power Saving Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 61 Power Saving Command List 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 580 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Led - (Optional) Specify to configure the power saving state of port LED. 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.
  • Page 581 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#config power_saving hibernation add time_range range_1 Command: config power_saving hibernation add time_range range_1 Success. DGS-3120-24TC:admin# 61-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 582 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format config power_saving port [<portlist> | all] [[add | delete] time_range <range_name 32> | clear_time_range] Parameters <portlist> - Specify a range of ports. all - Specify all ports. add - Specify to add a time range.
  • Page 583 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters length_detection - (Optional) Display the length detection configuration of power saving. link_detection - (Optional) Display the link detection configuration of power saving. led - (Optional) Display the port LED configuration of power saving. port - (Optional) Display the port configuration of power saving.
  • Page 584 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator and Operator-level users can issue this command. Example To disable the LED admin state: DGS-3120-24TC:admin#config led state disable Command: config led state disable Success. DGS-3120-24TC:admin# 61-7 show led...
  • Page 585: Chapter 62 Pppoe Circuit Id Insertions Command List (Ei Mode Only)

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 62 PPPoE Circuit ID Insertions Command List (EI Mode Only) config pppoe circuit_id_insertion state [enable | disable] config pppoe circuit_id_insertion ports <portlist> {state [enable | disable] | circuit_id [mac | ip | udf <string 32>]}(1) show pppoe circuit_id_insertion show pppoe circuit_id_insertion ports {<portlist>}...
  • Page 586 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 62-2 config pppoe circuit_id_insertion ports Description This command is used to configure port’s PPPoE Circuit ID insertion function. When the port’s state and the global state are enabled, the system will insert the Circuit ID TAG to the received PPPoE discovery initiation and request packet if the TAG is absent, and remove the Circuit ID TAG from the received PPPoE offer and session confirmation packet.
  • Page 587 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters None. Restrictions None. Example To display PPPoE circuit ID insertion status: DGS-3120-24TC:admin#show pppoe circuit_id_insertion Command: show pppoe circuit_id_insertion Global PPPoE State: Enabled DGS-3120-24TC:admin# 62-4 show pppoe circuit_id_insertion ports Description This command is used to display Switch’s port PPPoE Circuit ID insertion configuration.
  • Page 588 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#...
  • Page 589: Chapter 63 Protocol Vlan Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 63 Protocol VLAN Command List create dot1v_protocol_group group_id <id> {group_name <name 32>} config dot1v_protocol_group [group_id <id> | 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 <id>...
  • Page 590 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 63-2 config dot1v_protocol_group add protocol 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 <id>...
  • Page 591 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters group_id - Specify the group ID to be deleted. <id> - Enter the group ID used here. group_name - Specify the name of the group to be deleted. <name 32>...
  • Page 592: Config Port Dot1V

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# show dot1v_protocol_group group_id 10 Command: show dot1v_protocol_group group_id 10 Protocol Protocol Frame Type Protocol Group ID Group Name Value --------- --------------- ------------ ------------ General Group EthernetII 86dd Success.
  • Page 593: Show Port Dot1V

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example The example is to assign VLAN marketing-1 for untaged ipv6 packet ingress from port 3. To configure the group ID 10 on port 3 to be associated with VLAN marketing-1: DGS-3120-24TC:admin#config port dot1v ports 1:3 add protocol_group group_id 10 vlan marketing-1...
  • Page 594 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# show port dot1v ports 1:1 Command: show port dot1v ports 1:1 Port: 1:1 Protocol Group ID VLAN Name Protocol Priority ------------------- --------------------------------- ----------------- default VLAN2 VLAN3 VLAN4 Success.
  • Page 595: Chapter 64 Qinq Command List (Ei Mode Only)

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 64 QinQ Command List (EI Mode Only) enable qinq disable qinq config qinq inner_tpid <hex 0x1-0xffff> config qinq ports [<portlist> | all] {role [uni | nni] | missdrop [enable | disable] | outer_tpid <hex 0x1 - 0xffff>...
  • Page 596: Disable Qinq

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# enable qinq Command: enable qinq Success. DGS-3120-24TC:admin# 64-2 disable qinq Description This command is used to disable the QinQ. When QinQ is disabled, all dynamic learned L2 addresses will be cleared, all dynamic registered VLAN entries will be cleared, and GVRP will be disabled.
  • Page 597: Config Qinq Ports

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters inner_tpid - Specify the inner-TPID of the system. <hex 0x1-0xffff> - Enter the inner-TPID of the system here. 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-3120-24TC:admin# config qinq inner_tpid 0x9100...
  • Page 598: Show Qinq

    ® xStack DGS-3120 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 port list 1-4 as NNI port and set the TPID to 0x88A8: DGS-3120-24TC:admin# config qinq ports 1:1-1:4 role nni outer_tpid 0x88A8 Command: config qinq ports 1:1-1:4 role nni outer_tpid 0x88A8 Success.
  • Page 599: Show Qinq Ports

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format show qinq inner_tpid Parameters None. Restrictions None. Example To display the inner-TPID of a system: DGS-3120-24TC:admin# show qinq inner_tpid Command: show qinq inner_tpid Inner TPID: 0x9100 DGS-3120-24TC:admin# 64-7 show qinq ports...
  • Page 600 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# show qinq ports 1:1-1:2 Command: show qinq ports 1:1-1:2 Port ID: --------------------------------------------------------- Role: Miss Drop: Disabled Outer Tpid: 0x88a8 Add Inner Tag: Disabled Port ID: --------------------------------------------------------- Role: Miss Drop: Disabled...
  • Page 601 ® xStack DGS-3120 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 replace the C-Tag in which the CVID is 20, with the S-Tag and the S-VID is 200 at UNI Port 1: DGS-3120-24TC:admin# create vlan_translation ports 1:1 replace cvid 20 svid 200 Command: create vlan_translation ports 1:1 replace cvid 20 svid 200 Success.
  • Page 602 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# delete vlan_translation ports 1:1-1:4 Command: delete vlan_translation ports 1:1-1:4 Success. DGS-3120-24TC:admin# 64-10 show vlan_translation Description This command is used to display the existing C-VLAN-based VLAN translation rules. Format show vlan_translation {[ports <portlist>...
  • Page 603: Chapter 65 Quality Of Service (Qos) Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 65 Quality of Service (QoS) Command List config bandwidth_control [<portlist> | all] {rx_rate [no_limit | <value 64-1024000>] | tx_rate [ no_limit | <value 64-1024000>]} show bandwidth_control {<portlist>} config per_queue bandwidth_control {ports [<portlist>...
  • Page 604 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide not exceed it.. The actual limit recognized by the device, will be displayed when the command is executed. <value 64-1024000> - Enter the transmitting data rate here. This value must be between 64 and 1024000.
  • Page 605 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#show bandwidth_control 1:1-1:10 Command: show bandwidth_control 1:1-1:10 Bandwidth Control Table Port RX Rate TX Rate Effective RX Effective TX (Kbit/sec) (Kbit/sec) (Kbit/sec) (Kbit/sec) ----- ---------- ---------- ---------------- ---------------- No Limit No Limit...
  • Page 606 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide receive. If the specified rate is not multiple of minimum granularity, the rate will be adjusted. Restrictions Only Administrator level can issue this command. Example To configure the ports 1:1-1:10 CoS bandwidth queue 1 min rate to 130 and max rate to 100000: DGS-3120-24TC:admin# config per_queue bandwidth_control ports 1:1-1:10 1 min_rate 130 max_rate 1000 Command: config per_queue bandwidth_control ports 1:1-1:10 1 min_rate 130...
  • Page 607: Config Scheduling

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#show per_queue bandwidth_control 1:10 Command: show per_queue bandwidth_control 1:10 Queue Bandwidth Control Table On Port: 1:10 Queue Min Rate(Kbit/sec) Max Rate(Kbit/sec) No Limit No Limit No Limit No Limit No Limit No Limit...
  • Page 608: Show Scheduling

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 65-6 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) Specify a range of ports to be configured.
  • Page 609 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters <portlist> - (Optional) Specify a range of ports to be displayed. If no parameter specified, system will display all ports scheduling configurations. Restrictions None. Example To display the traffic scheduling parameters for each CoS queue on port 1:1(take eight hardware priority queues for example): DGS-3120-24TC:admin#show scheduling 1:1 Command: show scheduling 1:1...
  • Page 610 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To show scheduling mechanism: DGS-3120-24TC:admin#show scheduling_mechanism Command: show scheduling_mechanism Port Mode ----- ------ Strict Strict Strict Strict Strict Strict Strict Strict Strict 1:10 Strict 1:11 Strict 1:12 Strict 1:13...
  • Page 611 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide priority queues available. They are numbered between 0 (the lowest priority) and 7 (the highest priority). Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To configure the 802.1p user priority: DGS-3120-24TC:admin#config 802.1p user_priority 1 3...
  • Page 612 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# show 802.1p user_priority Command: show 802.1p user_priority QOS Class of Traffic: Priority-0 -> <Class-2> Priority-1 -> <Class-0> Priority-2 -> <Class-1> Priority-3 -> <Class-3> Priority-4 -> <Class-4> Priority-5 ->...
  • Page 613 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# config 802.1p default_priority all 5 Command: config 802.1p default_priority all 5 Success. DGS-3120-24TC:admin# 65-12 show 802.1p default_priority Description This command is used to display the current configured default priority settings on the Switch. The default priority can also be assigned by the RADIUS server through the authentication process.
  • Page 614 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# show 802.1p default_priority 1:1-1:10 Command: show 802.1p default_priority 1:1-1:10 Port Priority Effective Priority ---- ----------- ------------------ 1:10 DGS-3120-24TC:admin# 65-13 enable hol_prevention Description This command is used to enable head of line prevention on the Switch. Format enable hol_prevention Parameters...
  • Page 615 ® xStack DGS-3120 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-3120-24TC:admin# disable hol_prevention Command: disable hol_prevention Success.
  • Page 616: Config Dscp Trust

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# show hol_prevention Command: show hol_prevention Device HOL Prevention State: Enabled DGS-3120-24TC:admin# 65-16 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 617: Config Dscp Map

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters <portlist> - (Optional) A range of ports to display. If not specify the port, all ports for DSCP trust status on the Switch will be displayed. Restrictions None.
  • Page 618: Show Dscp Map

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters <portlist> - Enter the list of port used for this configuration here. all - Specify that all the ports will be included in this configuration. dscp_priority - Specify a list of DSCP value to be mapped to a specific priority. <dscp_list>...
  • Page 619 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide dscp_dscp - Specify a list of DSCP value to be mapped to a specific DSCP. dscp - (Optional) This specifies DSCP value that will be mapped. <dscp_list> - Enter the DSCP list here. Restrictions None.
  • Page 620: Chapter 66 Remote Switched Port Analyzer (Rspan) Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 66 Remote Switched Port ANalyzer (RSPAN) Command List enable rspan disable rspan create rspan vlan [vlan_name <vlan_name> | vlan_id <value 1-4094>] delete rspan vlan [vlan_name <vlan_name> | vlan_id <value 1-4094>] config rspan vlan [vlan_name <vlan_name>...
  • Page 621: Disable Rspan

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# enable rspan Command: enable rspan Success. DGS-3120-24TC:admin# 66-2 disable rspan Description This command is used to disable the RSPAN function. Format disable rspan Parameters None. Restrictions Only Administrator and Operator-level users can issue this command.
  • Page 622: Delete Rspan Vlan

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator and Operator-level users can issue this command. Example To create an RSPAN VLAN entry by VLAN name “v2”: DGS-3120-24TC:admin# create rspan vlan vlan_name v2 Command: create rspan vlan vlan_name v2 Success.
  • Page 623: Config Rspan Vlan

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# delete rspan vlan vlan_name v2 Command: delete rspan vlan vlan_name v2 Success. DGS-3120-24TC:admin# To delete an RSPAN VLAN entry by VLAN ID “3”: DGS-3120-24TC:admin# delete rspan vlan vlan_id 3 Command: delete rspan vlan vlan_id 3 Success.
  • Page 624: Show Rspan

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator and Operator-level users can issue this command. Example To configure an RSPAN source entry without source target port: DGS-3120-24TC:admin# config rspan vlan vlan_name VLAN2 source add ports 1:2-1:5 Command:config rspan vlan vlan_name VLAN2 source add ports 1:2-1:5 rx Success.
  • Page 625 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide <vlan_name> - Enter the VLAN name here. vlan_id - (Optional) Specify the RSPAN VLAN by VLAN ID. <value 1-4094> - Enter the VLAN ID here. This value must be between 1 and 4094. Restrictions None.
  • Page 626: Chapter 67 Rpc Portmapper Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 67 RPC PortMapper Command List config filter rpc_portmapper [<portlist> | all] state [enable | disable] show filter rpc_portmapper 67-1 config filter rpc_portmapper Description This command is used to configure the Switch to deny TCP/UDP packets with port number 135 on the network.
  • Page 627 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters None. Restrictions None. Example To display the RPC portmapper state: DGS-3120-24TC:admin#show filter rpc_portmapper Command: show filter rpc_portmapper Enabled Ports: 1:1-1:10 DGS-3120-24TC:admin#...
  • Page 628: Chapter 68 Safeguard Engine Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 68 Safeguard Engine Command List 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 68-1 config safeguard_engine...
  • Page 629 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC: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. DGS-3120-24TC:admin# 68-2 show safeguard_engine Description This command is used to show safeguard engine information.
  • Page 630: Chapter 69 Sd Card Management Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 69 SD Card Management Command List create backup [config | log] time_range <range_name 32> filename <pathname> {state [enable | disable]} config backup [config | log] time_range <range_name 32> filename <pathname> state [enable | disable] delete backup [config | log] [all | time_range <range_name 32>...
  • Page 631: Config Backup

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To create a backup schedule on time range "range_1": DGS-3120-24TC:admin#create backup config time_range range_1 filename c:/bk- confi Command: create backup config time_range range_1 filename c:/bk-config-1 Success. DGS-3120-24TC:admin# 69-2 config backup...
  • Page 632 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 69-3 delete backup Description This command is used to delete schedule backup. Format delete backup [config | log] [all | time_range <range_name 32> {filename <pathname>}] Parameters config - Schedule to back up configuration. log - Schedule to back up log.
  • Page 633 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To show all backup schedules: DGS-3120-24TC:admin#show backup Command: show backup Backup Schedule Entry 1 Time Range : range_1 Type : configuration Filename : c:/bk-config-1 State : Disabled Total Entries1 DGS-3120-24TC:admin# 69-5...
  • Page 634 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#create execute_config time_range range-1 config c:/vlan- config state enable Command: create execute_config time_range range-1 config c:/vlan-config state enable Success. DGS-3120-24TC:admin# 69-6 config execute_config time_range Description This command is used to configure configuration state or execute method of a executive schedule. Format config execute_config time_range <range_name 32>...
  • Page 635 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 69-7 delete execute_config Description This command is used to delete the schedule of executing configuration. Format delete execute_config [all | time_range <range_name 32> {config <pathname>}] Parameters all - Delete all the schedules of executing configuration. time_range - The time range of the schedules that execute configuration to be deleted.
  • Page 636 - (Optional) If not specified, the current configuration will be reset before executing the configuration.If specified, the current configuration will not be reset before executing the configuration. Restrictions Only Administrator-level users can issue this command. Example To load and execute a configuration: DGS-3120-24PC:admin#execute config c:/config-vlan-0.cfg Command: execute config c:/config-vlan-0.cfg Success. DGS-3120-24TC:admin#...
  • Page 637: Chapter 70 Secure Shell (Ssh) Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 70 Secure Shell (SSH) Command List 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 638: Show Ssh Algorithm

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To enable SSH server public key algorithm: DGS-3120-24TC:admin#show ssh server Command: show ssh server The SSH Server Configuration Maximum Session Connection Timeout : 120 Authentication Fail Attempts : 2 Rekey Timeout : Never TCP Port Number...
  • Page 639: Config Ssh Authmode

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# show ssh algorithm Command: show ssh algorithm Encryption Algorithm -------------------------- 3DES : Enabled AES128 : Enabled AES192 : Enabled AES256 : Enabled Arcfour : Enabled Blowfish : Enabled Cast128 : Enabled...
  • Page 640: Show Ssh Authmode

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To configure user authentication method: DGS-3120-24TC:admin# config ssh authmode publickey enable Command: config ssh authmode publickey enable Success. DGS-3120-24TC:admin# 70-4 show ssh authmode Description This command is used to show the user authentication method. Format show ssh authmode Parameters...
  • Page 641: Show Ssh User

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format config ssh user <username 15> authmode [hostbased [hostname <domain_name 32> | hostname_IP <domain_name 32> [<ipaddr> | <ipv6addr>]] | password | publickey] Parameters user - Specify the user name. <username 15>...
  • Page 642: Config Ssh Server

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To show user information about SSH configuration: DGS-3120-24TC:admin# show ssh user authmode Command: show ssh user authmode Current Accounts: User Name Authentication Host Name Host IP ---------- --- -------------- ---------...
  • Page 643: Enable Ssh

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To configure SSH server maximum session number is 3: DGS-3120-24TC:admin# config ssh server maxsession 3 Command: config ssh server maxsession 3 Success. DGS-3120-24TC:admin# 70-8 enable ssh Description This command is used to enable SSH server services.
  • Page 644: Show Ssh Server

    ® xStack DGS-3120 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 the SSH server services: DGS-3120-24TC:admin#disable ssh Command: disable ssh Success. DGS-3120-24TC:admin# 70-10 show ssh server Description This command is used to show the SSH server general information.
  • Page 645: Chapter 71 Secure Sockets Layer (Ssl) Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 71 Secure Sockets Layer (SSL) Command List 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}} 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}} delete ssl certificate <path_filename 64>...
  • Page 646: Enable Ssl

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC: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-3120-24TC:admin# 71-2 enable ssl Description This command is used to enable SSL status and it’s ciphersuites. Using “enable ssl” command will enable SSL feature which means enable SSLv3 and TLSv1.
  • Page 647: Disable Ssl

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# enable ssl Command: enable ssl Success. DGS-3120-24TC:admin# Note: Web will be disabled when SSL is enabled. 71-3 disable ssl Description This command is used to disable SSL feature and supported ciphercuites. Using “disable ssl” command will disable SSL feature and for each ciphersuites status user must specified it by this command.
  • Page 648: Show Ssl

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# disable ssl Command: disable ssl Success. DGS-3120-24TC:admin# 71-4 delete ssl certificate Description This command is used to delete a certification on the Switch. Format delete ssl certificate <path_filename 64> Parameters <path_filename 64>...
  • Page 649: Show Ssl Cachetimeout

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide <path_filename 64> - (Optioanl) Specify the certification file name on the Switch. Restrictions None. Example To show SSL: DGS-3120-24TC:admin# show ssl Commands: show ssl SSL status Enabled RSA_WITH_RC4_128_MD5 Enabled RSA_WITH_3DES_EDE_CBC_SHA...
  • Page 650: Config Ssl Cachetimeout

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To show SSL cache timeout: DGS-3120-24TC:admin# show ssl cachetimeout Commands: show ssl cachetimeout Cache timeout is 600 second(s) DGS-3120-24TC:admin# 71-7 config ssl cachetimeout Description This command is used to configure cahce timeout value which is designed for dlktimer library to remove the session id after expired.
  • Page 651 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format config ssl certificate chain [default | <cert_list>] Parameters default - Specify to use the built-in certificate. <cert_list> - Specify chain of certifications on the Switch. Restrictions Only Administrator-level users can issue this command.
  • Page 652: Chapter 72 Surveillance Vlan Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 72 Surveillance VLAN Command List enable surveillance_vlan [<vlan_name 32> | vlanid <vlanid 1-4094>] disable surveillance_vlan config surveillance_vlan priority <int 0-7> config surveillance_vlan oui [add | delete] <macaddr> <macmask> {component_type [vms | vms_client | video_encoder | network_storage | other] description <desc 32>} config surveillance_vlan ports [<portlist>...
  • Page 653 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 72-2 disable surveillance_vlan Description This command is used to disable surveillance VLAN globally. Format disable surveillance_vlan Parameters None. Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To disable the surveillance VLAN: DGS-3120-24TC:admin#disable surveillance_vlan...
  • Page 654 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#config surveillance_vlan priority 6 Command: config surveillance_vlan priority 6 Success. DGS-3120-24TC:admin# 72-4 config surveillance_vlan oui Description This command is used to configure the user-defined surveillance traffic OUI. OUI is used by the Switch to identify the surveillance traffic packets.
  • Page 655 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 72-5 config surveillance_vlan ports Description This command is used to configure the surveillance VLAN state on the specific ports. Format config surveillance_vlan ports [<portlist> | all] state [enable | disable] Parameters <portlist>...
  • Page 656 ® xStack DGS-3120 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 set the aging time of the surveillance VLAN to 60 minutes: DGS-3120-24TC:admin#config surveillance_vlan aging_time 60 Command: config surveillance_vlan aging_time 60 Success.
  • Page 657 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format show surveillance_vlan {oui | ports {<portlist>} | device {ports <portlist>}} Parameters oui - (Optional) The OUI information of the surveillance VLAN. ports - (Optional) Specify a range of ports to be displayed. <portlist>...
  • Page 658: Chapter 73 Sflow Command List (Ei Mode Only)

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 73 sFlow Command List (EI Mode Only) create sflow flow_sampler ports [<portlist> | all] analyzer_server_id <value 1-4> {rate <value 0- 65535> | maxheadersize <value 18-256>} config sflow flow_sampler ports [<portlist> | all] {rate <value 0-65535> | maxheadersize <value 18-256>} delete sflow flow_sampler ports [<portlist>...
  • Page 659 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide been sampled that will be encapsulated and forwarded to the server. If not specified, the default value is 128. <value 18-256> - Enter the maximum header size here. This value must be between 18 and 256.
  • Page 660 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example Configure the sFlow sampler the rate of port 1 to be 0: DGS-3120-24TC:admin#config sflow flow_sampler ports 1:1 rate 0 maxheadersize 18 Command: config sflow flow_sampler ports 1:1 rate 0 maxheadersize 18 Success.
  • Page 661 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters ports - Specify the list of ports to be configured. <portlist> - Enter the list of ports that will be used for this configuration here. all - Specify all ports on the Switch. analyzer_server_id - The ID of a analyzer server.
  • Page 662 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example Configure the interval of sFlow counter poller port 1 to be 0: DGS-3120-24TC:admin#config sflow counter_poller ports 1:1 interval disable Command: config sflow counter_poller ports 1:1 interval disable Success.
  • Page 663 ® xStack DGS-3120 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> | collectorport <udp_port_number 1-65535> | maxdatagramsize <value 300-1400>} Parameters analyzer_server - The ID of analyzer server. <value 1-4>...
  • Page 664 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format config sflow analyzer_server <value 1-4> {timeout [<sec 1-2000000> | infinite] | collectoraddress <ipaddr> | collectorport <udp_port_number 1-65535> | maxdatagramsize <value 300-1400>} Parameters analyzer_server - The ID of analyzer server. <value 1-4>...
  • Page 665: Enable Sflow

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters analyzer_server - The ID of analyzer server that to be deleted. <value 1-4> - Enter the analyzer server ID value here. This value must be between 1 and 4. Restrictions Only Administrator and Operator-level users can issue this command.
  • Page 666: Disable Sflow

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 73-11 disable sflow Description This command is used to disable the sFlow function on the Switch. Format disable sflow Parameters None. Restrictions Only Administrator and Operator-level users can issue this command. Example Disable the sFlow globally: DGS-3120-24TC:admin# disable sflow...
  • Page 667 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To show the sFlow information: DGS-3120-24TC:admin#show sflow Command: show sflow sFlow Version : V5 sFlow Address : 10.90.90.90 sFlow State : Disabled DGS-3120-24TC:admin# 73-13 show sflow flow_sampler Description This command is used to show the sFlow flow sampler configured for ports.
  • Page 668 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 73-14 show sflow counter_poller Description This command is used to display the sFlow counter pollers which have been configured for port. Format show sflow counter_poller Parameters None. Restrictions None.
  • Page 669 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To show the sFlow flow sampler information of ports which have been created: DGS-3120-24TC:admin#show sflow analyzer_server Command: show sflow analyzer_server sFlow Analyzer_server Information ------------------------------ Server ID Owner : sflow Timeout...
  • Page 670: Chapter 74 Show Technical Support Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 74 Show Technical Support Command List show tech_support upload tech_support_toTFTP <ipaddr> <path_filename 64> 74-1 show tech_support Description This command is especially used by the technical support personnel to dump the device overall operation information.
  • Page 671 DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DES-3200-28P:admin#show tech_support Command: show tech_support #------------------------------------------------------------------------------- DGS-3120-24TC Gigabit Ethernet Switch Technical Support Information Firmware: Build 2.50.015 Copyright(C) 2012 D-Link Corporation. All rights reserved. #------------------------------------------------------------------------------- ******************** Basic System Information ******************** [SYS 2015-5-4 21:52:57] Boot Time : 4 May 2015...
  • Page 672 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide • Basic System information • System log • Running configuration • Layer 1 information • Layer 2 information • Layer 3 information • Application • OS status •...
  • Page 673: Chapter 75 Simple Mail Transfer Protocol (Smtp) Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 75 Simple Mail Transfer Protocol (SMTP) Command List 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>]}(1) show smtp smtp send_testmsg 75-1...
  • Page 674 ® xStack DGS-3120 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-3120-24TC:admin#disable smtp Command: disable smtp Success. DGS-3120-24TC:admin# 75-3 config smtp Description This command is used to configure SMTP settings.
  • Page 675 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To configure an SMTP server IP address: DGS-3120-24TC:admin#config smtp server 172.18.208.9 Command: config smtp server 172.18.208.9 Success. DGS-3120-24TC:admin# To configure an SMTP server port: DGS-3120-24TC:admin#config smtp server_port 25 Command: config smtp server_port 25 Success.
  • Page 676 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format show smtp Parameters None. Restrictions None. Example To display the current SMTP information: DGS-3120-24TC:admin#show smtp Command: show smtp SMTP Status : Disabled SMTP Server Address : 172.18.208.9 SMTP Server Port : 25 Self Mail Address...
  • Page 677 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator-level users can issue this command. Example To test whether the SMTP server can be reached: DGS-3120-24TC:admin#smtp send_testmsg Command: smtp send_testmsg Subject:e-mail heading Content:e-mail content Sending mail, please wait...
  • Page 678: Chapter 76 Simple Network Management Protocol (Snmp) Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 76 Simple Network Management Protocol (SNMP) Command List create snmp community <community_string 32> view <view_name 32> [read_only | read_write] create snmp community_masking view <view_name 32> [ read_only | read_write] delete snmp community <community_string 32>...
  • Page 679: Create Snmp Community

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 76-1 create snmp community Description This command is used to create an SNMP community string. Use an SNMP community string to define the relationship between the SNMP manager and the agent.
  • Page 680: Delete Snmp Community

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 76-2 create snmp community_masking view Description This command is used to create a secure method to create a SNMP community string. Format create snmp community_masking view <view_name 32> [ read_only | read_write] Parameters <view_name 32>...
  • Page 681: Show Snmp Community

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator-level users can issue this command. Example To delete a SNMP community “System”: DGS-3120-24TC:admin# delete snmp community System Command: delete snmp community System Success. DGS-3120-24TC:admin# 76-4 show snmp community Description...
  • Page 682: Create Snmp User

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 76-5 create snmp user Description This command is used to create a new user to an SNMP group originated by this command. Format create snmp user <user_name 32> <groupname 32> {encrypted [by_password auth [md5 <auth_password 8-16>...
  • Page 683: Delete Snmp User

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# create snmp user user123 group123 encrypted by_password auth md5 12345678 priv des 12345678 Command: create snmp user user123 group123 encrypted by_password auth md5 12345678 priv des 12345678 Success.
  • Page 684: Create Snmp Group

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters None. Restrictions None. Example To show SNMP user: DGS-3120-24TC:admin# show snmp user Command: show snmp user Username Group Name VerAuthPriv -------------------------------- -------------------------- ----------- initial initial V3 NoneNone user123 group123 V3 MD5 DES...
  • Page 685: Delete Snmp Group

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide long. Restrictions Only Administrator-level users can issue this command. Example To create SNMP group “group123”: DGS-3120-24TC:admin# create snmp group group123 v3 auth_priv read_view CommunityView write_view CommunityView notify_view CommunityView Command: create snmp group group123 v3 auth_priv read_view CommunityView write_view CommunityView notify_view CommunityView Success.
  • Page 686: Show Snmp Groups

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 76-10 show snmp groups Description This command is used to display the names of groups on the Switch and the security model, level, the status of the different views. Format show snmp groups Parameters...
  • Page 687: Create Snmp View

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# show snmp groups Command: show snmp groups Vacm Access Table Settings Group Name : public ReadView Name : CommunityView WriteView Name Notify View Name : CommunityView Securiy Model : SNMPv1 Securiy Level...
  • Page 688: Delete Snmp View

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide <oid> - Object-Identified tree, MIB tree. view_type - Specify the access type of the MIB tree in this view. included - Includes for this view. excluded - Excluded for this view. Restrictions Only Administrator-level users can issue this command.
  • Page 689: Show Snmp View

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 76-13 show snmp view Description This command is used to display the SNMP view record. Format show snmp view {<view_name 32>} Parameters view - (Optional) View name of the user who likes to show. <view_name 32>...
  • Page 690: Delete Snmp

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters host - Specify the recipient for which the traps are targeted. <ipaddr> - The IP address of the recipient for which the traps are targeted. v6host - Specify the IPv6 host address to which the trap packet will be sent. (EI Mode Only) <ipv6addr>...
  • Page 691: Show Snmp Host

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To delete SNMP host “10.0.0.1”: DGS-3120-24TC:admin# delete snmp host 10.0.0.1 Command: delete snmp host 10.0.0.1 Success. DGS-3120-24TC:admin# 76-16 show snmp host Description This command is used to display the recipient for which the traps are targeted. Format show snmp host {<ipaddr>} Parameters...
  • Page 692 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 76-17 show snmp v6host (EI Mode Only) Description This command is used to display the recipient for which the traps are targeted. Format show snmp v6host {<ipv6addr>} Parameters v6host - (Optional) Specify the IPv6 host address.
  • Page 693: Config Snmp Engineid

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 76-18 config snmp engineID Description This command is used to configure a identifier for the SNMP engine on the Switch. Format config snmp engineID <snmp_engineID 10-64> Parameters engineID - Identify for the SNMP engine on the Switch.
  • Page 694: Enable Snmp

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions None. Example To show SNMP engine ID: DGS-3120-24TC:admin# show snmp engineID Command: show snmp engineID SNMP Engine ID : 1023457890 DGS-3120-24TC:admin# 76-20 enable snmp Description This command is used to enable the SNMP function. Format enable snmp Parameters...
  • Page 695 ® xStack DGS-3120 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 disable SNMP: DGS-3120-24TC:admin# disable snmp Command: disable snmp Success. DGS-3120-24TC:admin# 76-22 config snmp system_name Description This command is used to configure the name for the Switch.
  • Page 696 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 76-23 config snmp system_location Description This command is used to enter a description of the location of the Switch. Format config snmp system_location {<sw_location>} Parameters system_location - A maximum of 128 characters is allowed. And NULL string is accepted <sw_location>...
  • Page 697: Enable Snmp Traps

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# config snmp system_contact "MIS Department II" Command: config snmp system_contact "MIS Department II" Success. DGS-3120-24TC:admin# 76-25 enable snmp traps Description This command is used to enable SNMP trap support. Format enable snmp traps Parameters...
  • Page 698 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator and Operator-level users can issue this command. Example To prevent SNMP traps from being sent from the Switch: DGS-3120-24TC:admin# disable snmp traps Command: disable snmp traps Success.
  • Page 699 ® xStack DGS-3120 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 disable SNMP authentication trap support: DGS-3120-24TC:admin# disable snmp authenticate_traps Command: disable snmp authenticate_traps Success.
  • Page 700 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 76-30 disable snmp linkchange_traps Description This command is used to configure the sending of linkchange traps. Format disable snmp linkchange_traps Parameters None. Restrictions Only Administrator and Operator-level users can issue this command. Example To disable the sending of linkchange traps: DGS-3120-24TC:admin# disable snmp linkchange_traps...
  • Page 701 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To configure the sending of linkchange traps: DGS-3120-24TC:admin# config snmp linkchange_traps ports 1:1-1:4 enable Command: config snmp linkchange_traps ports 1:1-1:4 enable Success. DGS-3120-24TC:admin# 76-32 config snmp coldstart_traps Description This command is used to configure the trap for coldstart event.
  • Page 702: Show Snmp Traps

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters enable - Enable the trap of the warmstart event. The default state is enabled. disable - Disable the trap of the warmstart event. Restrictions Only Administrator-level users can issue this command. Example To configure the trap state for warmstart event: DGS-3120-24TC:admin# config snmp warmstart_traps enable...
  • Page 703: Config Rmon Trap

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#show snmp traps Command: show snmp traps SNMP Traps : Enabled Authenticate Trap : Enabled Linkchange Traps : Enabled Coldstart Traps : Enabled Warmstart Traps : Enabled DGS-3120-24TC:admin# 76-35 config rmon trap Description...
  • Page 704 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format show rmon Parameters None. Restrictions Only Administrator-level users can issue this command. Example To display the RMON related setting: DGS-3120-24TC:admin# show rmon Command: show rmon RMON Rising Alarm Trap : Enabled RMON Falling Alarm Trap : Enabled...
  • Page 705 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 76-38 disable community_encryption Description This command is used to disable the encryption state on SNMP community string. Format disable community_encryption Parameters None. Restrictions Only Administrator-level users can issue this command. Example To disable the encryption state on SNMP community string: DGS-3120-24TC:admin#disable community_encryption...
  • Page 706 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#show community_encryption Command: show community_encryption SNMP Community Encryption State : Enabled DGS-3120-24TC:admin#...
  • Page 707: Chapter 77 Single Ip Management Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 77 Single IP Management Command List 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 708 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 77-2 disable sim Description This command is used to disable single IP management on the Switch. Format disable sim Parameters None. Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To disable SIM: DGS-3120-24TC:admin# disable sim...
  • Page 709 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions None. Example To show the self information in detail: DGS-3120-24TC:admin#show sim Command: show sim SIM Version : VER-1.61 Firmware Version : 2.50.015 Device Name MAC Address : 00-00-00-01-02-03 Capabilities : L2...
  • Page 710 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# show sim member Command: show sim member MAC Address Platform / Hold Firmware Device Name Capability Time Version --- ----------------- ------------------------ ----- --------- ---------------- 00-01-02-03-04-00 DES-XXXXS L2 Switch 1.00-B01 aaaaaaaaaaaaaaaa bbbbbbbbbbbbbbb 00-55-55-00-55-00 DES-3326SR L3 Switch...
  • Page 711 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# show sim neighbor Command: show sim neighbor Neighbor Table Port MAC Address Role ------ ------------------ --------- 00-35-26-00-11-99 Commander 00-35-26-00-11-91 Member 00-35-26-00-11-90 Candidate Total Entries: 3 DGS-3120-24TC:admin# 77-4 reconfig Description...
  • Page 712 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format config sim_group [add <candidate_id 1-100> {<password>} | delete <member_id 1-32>] Parameters add - Specify to add a specific candidate to the group. <candidate_id 1-100> - Enter the candidate ID to be added to the group here. This value must be between 1 and 100.
  • Page 713 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format config sim [{[commander {group_name <groupname 64>} | candidate] | dp_interval <sec 30- 90> | hold_time <sec 100-255>}] Parameters commander - (Optional) Specify to transfer the role to the commander. group_name - (Optional) Specify that if the user is the commander, the user can update the name of group.
  • Page 714 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# config sim dp_interval 30 Command: config sim dp_interval 30 Success. DGS-3120-24TC:admin# To change the hold time of discovery protocol: DGS-3120-24TC:admin# config sim hold_time 200 Command: config sim hold_time 200 Success.
  • Page 715 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# download sim_ms configuration_from_tftp 10.55.47.1 D:\dwl600x.tfp members 1 Commands: download sim_ms configuration_from_tftp 10.55.47.1 D:\dwl600x.tfp members 1 This device is updating configuration. Please wait several minutes ... Download Status : MAC Address Result -----------------...
  • Page 716 ® xStack DGS-3120 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 upload configuration: DGS-3120-24TC:admin# upload sim_ms configuration_to_tftp 10.55.47.1 D:\configuration.txt members 1 Command: upload sim_ms configuration_to_tftp 10.55.47.1 D:\configuration.txt members 1 This device is uploading configuration.
  • Page 717: Chapter 78 Stacking Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 78 Stacking Command List config box_priority current_box_id <value 1-6> priority <value 1-63> config box_id current_box_id <value 1-6> new_box_id [auto | <value 1-6>] show stack_information show stack_device config stacking_mode [disable | enable] show stacking_mode config stacking force_master_role state [enable | disable]...
  • Page 718 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 78-2 config box_id Description This command is used to configure the box ID. By default, the box ID is automatically assigned by the system based topology election results. Administrators can assign box IDs statically. The new box ID will take effect after unit reboot.
  • Page 719 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Message 2: Stack Topology Status: New device is detected; hot insert may happen after n seconds. When this message is shown, it means hot insert of new device is detected. The stack system will do the hot insert action after the timer reaches 0.
  • Page 720 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#show stack_information Command: show stack_information Topology :Duplex_Chain My Box ID Master ID Box Count Force Master Role: Disabled Trap State :Enabled Log State :Enabled Box User Prio- Prom Runtime Type...
  • Page 721 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#show stack_device Command: show stack_device Box ID Box Type H/W Version Serial Number ------ ---------------- ----------- -------------------- DGS-3120-24TC abcd1234 DGS-3120-24TC:admin# 78-5 config stacking_mode Description This command is used to configure the state of stacking function. By default stacking mode is enabled.
  • Page 722 ® xStack DGS-3120 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 stacking mode: DGS-3120-24TC:admin# show stacking_mode Command: show stacking_mode Stacking mode : Enabled DGS-3120-24TC:admin# 78-7...
  • Page 723 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# config stacking force_master_role state enable Command: config stacking force_master_role state enable Success. DGS-3120-24TC:admin# 78-8 config stacking trap state Description This command is used to configure trap state for stacking. Format config stacking trap state [enable | disable] Parameters...
  • Page 724 ® xStack DGS-3120 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-3120-24TC:admin#config stacking log state enable Command: config stacking log state enable Success.
  • Page 725: Chapter 79 Syslog And Trap Source-Interface Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 79 Syslog and Trap Source- interface Command List config syslog source_ipif [<ipif_name 12> {<ipaddr> | <ipv6addr>} | none] show syslog source_ipif config trap source_ipif [<ipif_name 12> {<ipaddr> | <ipv6addr> } | none] show trap source_ipif 79-1 config syslog source_ipif...
  • Page 726 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# config syslog source_ipif none Command: config syslog source_ipif none Success DGS-3120-24TC:admin# 79-2 show syslog source_ipif Description This command is used to display the syslog source IP interface. Format show syslog source_ipif Parameters...
  • Page 727 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters ipif - Specify the IP interface name. If only specify this parameter, the least IPv4 address and the smallest IPv6 address of ipif_name will be used as source IP addresses. <ipif_name 12>...
  • Page 728 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example Show trap source IP interface: DGS-3120-24TC:admin# show trap source_ip Command: show trap source_ip Trap Source IP Interface Configuration: IP Interface : System IPv4 Address : None DGS-3120-24TC:admin#...
  • Page 729: Chapter 80 System Log Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 80 System Log Command List clear log show log {[index <value_list> | severity {module <module_list>} {emergency | alert | critical | error | warning | notice | informational | debug | <level_list 0-7>} | module<module_list>]} show log_software_module enable syslog disable syslog...
  • Page 730: Show Log

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# clear log Command: clear log Success. DGS-3120-24TC:admin# 80-2 show log Description This command is used to display the Switch’s history log. 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) The show log command will display the history log between the log number of...
  • Page 731: Enable Syslog

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#show log index 1-3 Command: show log index 1-3 Index Date Time Level Log Text ----- ---------- -------- ------- ---------------------------------------------- 2011-05-10 04:06:40 CRIT(2) Unit 1, Right Side Fan 2 failed 2011-05-10 04:06:40 CRIT(2) Unit 1, Right Side Fan 1 failed 2011-05-09 11:10:23 INFO(6) Unit 1, Configuration and log saved to flash b y console (Username: Anonymous)
  • Page 732: Disable Syslog

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format enable syslog Parameters None. Restrictions Only Administrator and Operator-level users can issue this command. Example To enable the sending of syslog messages: DGS-3120-24TC:admin# enable syslog Command: enable syslog Success.
  • Page 733: Show Syslog

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 80-6 show syslog Description This command is used to display the syslog protocol global state. Format show syslog Parameters None. Restrictions None. Example To display the syslog protocol global state: DGS-3120-24TC:admin# show syslog Command: show syslog Syslog Global State: Enabled...
  • Page 734: Config Syslog Host

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide emergency - Severity level 0 alert - Severity level 1 critical - Severity level 2 error - Severity level 3 warning - Severity level 4 notice - Severity level 5 informational - Severity level 6 debug - Severity level 7 <level 0-7>...
  • Page 735 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format config syslog host [<index 1-4> | 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 736: Delete Syslog Host

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#config syslog host all severity debug facility local0 Command: config syslog host all severity debug facility local0 Success. DGS-3120-24TC:admin# 80-9 delete syslog host Description This command is used to delete the syslog host(s). Format delete syslog host [<index 1-4>...
  • Page 737 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide If no parameter is specified, all hosts will be displayed. Restrictions None. Example To show the syslog host information: DGS-3120-24TC:admin#show syslog host Command: show syslog host Syslog Global State: Disabled Host IP Address : 10.90.90.1...
  • Page 738 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# config log_save_timing on_demand Command: config log_save_timing on_demand Success. DGS-3120-24TC:admin# 80-12 show log_save_timing Description This command is used to show the method for saving the log. Format show log_save_timing Parameters None.
  • Page 739 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters unit - (Optional) The attack log messages on the specified unit will be displayed. If unit ID is specified, then it will be referred to as the master unit. <unit_id 1-12>...
  • Page 740 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# clear attack_log Command: clear attack_log Success. DGS-3120-24TC:admin#...
  • Page 741: Chapter 81 System Severity Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 81 System Severity Command List config system_severity [trap | log | all] [emergency | alert| critical | error | warning | notice | information | debug | <level 0-7>] show system_severity 81-1 config system_severity...
  • Page 742 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 81-2 show system_severity Description This command is used to display the severity level controls for the system. Format show system_severity Parameters None. Restrictions None. Example To show severity level control for system: DGS-3120-24TC:admin#show system_severity Command: show system_severity System Severity Trap : warning(4)
  • Page 743: Chapter 82 Telnet Client Command List

    <value 1-65535> - Enter the TCP port number used here. This value must be between 1 and 65535. Restrictions None. Example Telnet to a Switch by specifying the IP address: DGS-3120-24TC:admin# telnet 10.90.90.90 Command: telnet 10.90.90.90 DGS-XXXX Fast Ethernet Switch Command Line Interface Firmware: Build 1.00.B01 Copyright(C) 2006-2009 D-Link Corporation. All rights reserved. UserName:...
  • Page 744: Chapter 83 Tftp Client Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 83 TFTP Client Command List download [firmware_fromTFTP [<ipaddr> | <ipv6addr>] src_file <path_filename 64> {[unit <unit_id> | all]} {dest_file <pathname>} | cfg_fromTFTP [<ipaddr> | <ipv6addr>] src_file <path_filename 64> {[unit <unit_id> | all]} {dest_file <pathname>}] upload [cfg_toTFTP [<ipaddr>...
  • Page 745 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide apply the setting to the system. If increment is specified, the existing configuration will not be cleared before applying to the new configuration. If it is not specified, the existing configuration will be cleared before applying to the new configuration.
  • Page 746 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters cfg_toTFTP – Specify that the configuration file will be uploaded to the TFTP server. <ipaddr> - The IP address of the TFTP server. <ipv6addr> - The IPv6 address of the TFTP server. (EI Mode Only) dest_file - Used to identify the parameter “path_filename”.
  • Page 747 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide long. attack_log_toTFTP – Specify that the attack log will be uploaded to the TFTP server. <ipaddr> - The IP address of the TFTP server. <ipv6addr> - The IPv6 address of the TFTP server. (EI Mode Only) dest_file - Used to identify the parameter “path_filename”.
  • Page 748 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide To upload configuration from TFTP: DGS-3120-24TC:admin#upload cfg_toTFTP 10.90.90.99 dest_file 111.cfg unit 1 src_file c:/config.cfg Command: upload cfg_toTFTP 10.90.90.99 dest_file 111.cfg unit 1 src_file c:/config.cfg Connecting to server....Done. Upload configuration....
  • Page 749: Chapter 84 Time And Sntp Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 84 Time and SNTP Command List config sntp {primary <ipaddr> | secondary <ipaddr> | poll-interval <int 30-99999>} config sntp ipv6server {primary <ipv6addr> | secondary <ipv6addr>}(1) (EI Mode Only) show sntp enable sntp disable sntp...
  • Page 750: Show Sntp

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# config sntp primary 10.1.1.1 secondary 10.1.1.2 poll- interval 30 Command: config sntp primary 10.1.1.1 secondary 10.1.1.2 poll-interval 30 Success. DGS-3120-24TC:admin# 84-2 config sntp ipv6server (EI Mode Only) Description This command is used to configure the SNTP IPv6 server information.
  • Page 751: Enable Sntp

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters None. Restrictions None. Example To show SNTP: DGS-3120-24TC: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 752: Disable Sntp

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# enable sntp Command: enable sntp Success. DGS-3120-24TC:admin# 84-5 disable sntp Description This command is used to turn off SNTP support. Format disable sntp Parameters None. Restrictions Only Administrator and Operator-level users can issue this command.
  • Page 753 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions Only Administrator and Operator-level users can issue this command. Example To configure time: DGS-3120-24TC:admin# config time 30jun2003 16:30:30 Command: config time 30jun2003 16:30:30 Success. DGS-3120-24TC:admin# 84-7 config time_zone Description This command is used to configure time zone of the device.
  • Page 754: Config Dst

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 84-8 config dst Description This command is used to configure Daylight Saving Time of the device. 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 755: Show Time

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide <start_time hh:mm> - Enter the starting time of Daylight Saving Time here. This value must be in the hh:mm format. <end_time hh:mm> - Enter the starting time of Daylight Saving Time here. This value must be in the hh:mm format.
  • Page 756 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#show time Command: show time Current Time Source : System Clock Boot Time : 9 May 2011 06:20:55 Current Time : 9 May 2011 07:46:10 Time Zone : GMT +00:00 Daylight Saving Time : Disabled...
  • Page 757: Chapter 85 Trace Route Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 85 Trace Route Command List traceroute <ipaddr> {ttl <value 1-60>} {port <value 30000-64900>} {timeout <sec 1-65535>} {probe <value 1-9>} traceroute6 <ipv6addr> {ttl <value 1-60> | port <value 30000-64900> | timeout <sec 1-65535> | probe <value 1-9>} (EI Mode Only) 85-1...
  • Page 758 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# traceroute 10.48.74.121 probe 3 Command: traceroute 10.48.74.121 probe 3 <10 ms. 10.12.73.254 <10 ms. 10.19.68.1 <10 ms. 10.48.74.121 Trace complete. DGS-3120-24TC:admin# 85-2 traceroute6 (EI Mode Only) Description This command is used to trace the IPv6 routed path between the Switch and a destination end station.
  • Page 759 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# traceroute6 3000::1 probe 3 Command: traceroute6 3000::1 probe 3 <10 ms. 1345:142::11 <10 ms. 2011:14::100 <10 ms. 3000::1 Trace complete. DGS-3120-24TC:admin# Trace the IPv6 routed path between the Switch and 1210:100::11 with port 40000: DGS-3120-24TC:admin# traceroute6 1210:100::11 port 40000 Command: traceroute6 1210:100::11 port 40000 <10 ms.
  • Page 760: Chapter 86 Traffic Control Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 86 Traffic Control Command List config traffic control [<portlist> | all] {broadcast [enable | disable] | multicast [enable | disable] | unicast [enable | disable] | action [drop | shutdown] | [threshold <value 0-1488100> | {broadcast_threshold <value 0-1488100>...
  • Page 761 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide the Switch that will trigger the storm traffic control measure. The threshold is expressed as PPS (packets per second) and must be an unsigned integer. <value 0-1488100> - Enter the upper threshold value here. This value must be between 0 and 1488100.
  • Page 762: Show Traffic Control

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters none - No trap state is specified for storm control. storm_occurred - Occurred mode is enabled and cleared mode is disabled. storm_cleared - Occurred mode is disabled and cleared mode is enabled. both - Both occurred and cleared modes are enabled.
  • Page 763 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#show traffic control 1:1-1:10 Command: show traffic control 1:1-1:10 Traffic Control Trap : [Both] Traffic Control Log : Enabled Traffic Control Auto Recover Time: 0 Minutes Port Broadcast/ Multicast/ Unicast/ Action Count...
  • Page 764 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide disable - Neither occurred nor cleared is logged. Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To configure the traffic log state on the Switch: DGS-3120-24TC:admin# config traffic control log state enable Command: config traffic control log state enable Success.
  • Page 765 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide...
  • Page 766: Chapter 87 Traffic Segmentation Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 87 Traffic Segmentation Command List config traffic_segmentation [<portlist> | all] forward_list [null | all | <portlist>] show traffic_segmentation {<portlist>} 87-1 config traffic_segmentation Description This command is used to configure the traffic segmentation. Format config traffic_segmentation [<portlist>...
  • Page 767 ® xStack DGS-3120 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. If no parameter is specified, the system will display all current traffic segmentation tables. Restrictions None.
  • Page 768: Chapter 88 Trusted Host Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 88 Trusted Host Command List create trusted_host [<ipaddr> |<ipv6addr> | network <network_address> | ipv6_prefix <ipv6networkaddr>] {snmp | telnet | ssh | http | https | ping} delete trusted_host [ipaddr <ipaddr>...
  • Page 769 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# create trusted_host 10.48.74.121 Command: create trusted_host 10.48.74.121 Success. DGS-3120-24TC:admin# 88-2 delete trusted_host Description This command is used to delete a trusted host entry made using the create trusted_host command above.
  • Page 770 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format config trusted_host [<ipaddr> | <ipv6addr> | network <network_address> | ipv6_prefix <ipv6networkaddr>] [add | delete] {snmp | telnet | ssh | http | https | ping | all} Parameters <ipaddr>...
  • Page 771 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions None. Example To display trusted host: DGS-3120-24TC:admin#show trusted_host Command: show trusted_host Management Stations IP Address Access Interface ---------------------------------------------------------------- 10.48.74.121 SNMP Telnet SSH HTTP HTTPs Ping Total Entries: 1 DGS-3120-24TC:admin#...
  • Page 772: Chapter 89 Udp Helper Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 89 UDP Helper Command List enable udp_helper disable udp_helper 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>] config udp_helper add ipif <ipif_name 12>...
  • Page 773 ® xStack DGS-3120 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 the UDP helper function: DGS-3120-24TC:admin#disable udp_helper Command: disable udp_helper Success. DGS-3120-24TC:admin# 89-3 config udp_helper udp_port add...
  • Page 774 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#config udp_helper udp_port add 55 Command: config udp_helper udp_port add 55 Success. DGS-3120-24TC:admin# 89-4 config udp_helper udp_port delete Description This command is used to delete a UDP port for UDP helper function on the Switch. Format config udp_helper udp_port delete [time | tacacs | dns | tftp | netbios-ns | netbios-ds | <port_number 0-65535>]...
  • Page 775 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters <ipif_name 12> - Enter the name of the IP interface that receives UDP broadcast. <ipaddr> - Enter the UDP helper server IP address. Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To add a server address for System interface: DGS-3120-24TC:admin#config udp_helper add ipif System 20.0.0.90...
  • Page 776 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 89-7 show udp_helper Description This command is used to display the current UDP Helper configuration on the Switch Format show udp_helper {[udp_port | ipif <ipif_name 12>]} Parameters udp_port - (Optional) Specify the UDP port configured for the UDP helper.
  • Page 777: Chapter 90 Unicast Routing Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 90 Unicast Routing Command List create iproute [default | <network_address>] [<ipaddr> {<metric 1-65535>} {[primary | backup]}] delete iproute [default | <network_address>][<ipaddr>] show iproute {[<network_address> | <ipaddr>]} {[static | hardware]} show ipfdb {[ip_address <ipaddr>...
  • Page 778: Delete Iproute

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To add a floating static route and a static multipath route: DGS-3120-24TC:admin# create iproute default 10.1.1.254 primary Command: create iproute default 10.1.1.254 primary Success. DGS-3120-24TC:admin# 90-2 delete iproute Description This command is used to delete an IP route entry from the Switch’s IP routing table.
  • Page 779: Show Ipfdb

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters <network_address> - (Optional) Specify the destination network address of the route to be displayed. (EI Mode Only) <ipaddr> - (Optional) Specify the destination IP address of the route to be displayed. The longest prefix matched route will be displayed.
  • Page 780 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions None. Example To display network address forwarding table: DGS-3120-24TC:admin# show ipfdb Command: show ipfdb Interface IP Address Port Learned ------------ --------------- ------ --------- System 10.1.1.101 Dynamic System 10.1.40.22 Dynamic...
  • Page 781 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#show route preference Command: show route preference Route Preference Settings Protocol Preference ---------- ---------- Static Default Local DGS-3120-24TC:admin#...
  • Page 782: Chapter 91 Vlan Trunking Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 91 VLAN Trunking Command List enable vlan_trunk disable vlan_trunk config vlan_trunk ports [<portlist> | all] | state [enable | disable] show vlan_trunk 91-1 enable vlan_trunk Description This command is used to enable the VLAN trunk function.
  • Page 783 ® xStack DGS-3120 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 disable the VLAN Trunk: DGS-3120-24TC:admin# disable vlan_trunk Command: disable vlan_trunk Success. DGS-3120-24TC:admin# 91-3 config vlan_trunk Description This command is used to configure a port as a VLAN trunk port.
  • Page 784 Command: config vlan_trunk ports 1:1-1:5 state enable Success. DGS-3120-24TC:admin# Port 6 is LA-1 member port; port 7 is LA-2 master port: DGS-3120-24PC:admin#config vlan_trunk ports 1:6-1:7 state enable Command: config vlan_trunk ports 1:6-1:7 state enable Success. DGS-3120-24PC:admin#config vlan_trunk ports 1:7 state disable Command: config vlan_trunk ports 1:7 state disable Success.
  • Page 785 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24PC:admin#config vlan_trunk ports 1:7 state disable Command: config vlan_trunk ports 1:7 state disable Success. DGS-3120-24PC:admin# Port 6, 7 have the same VLAN configuration before enabling VLAN trunk.
  • Page 786 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#show vlan_trunk Command: show vlan_trunk VLAN Trunk Global Setting ---------------------------- VLAN Trunk Status : Enabled VLAN Trunk Member Ports : 1:1-1:5 DGS-3120-24TC:admin# The following example displays the VLAN information which will also display VLAN trunk setting: DGS-3120-24TC:admin# show vlan Command: show vlan VLAN Trunk State...
  • Page 787: Chapter 92 Voice Vlan Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 92 Voice VLAN Command List enable voice_vlan [<vlan_name 32> | vlanid <vlanid 1-4094>] disable voice_vlan config voice_vlan priority <int 0-7> config voice_vlan oui [add | delete] <macaddr> <macmask> {description <desc 32>} config voice_vlan ports [<portlist>...
  • Page 788 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# enable voice_vlan v2 Command: enable voice_vlan v2 Success. DGS-3120-24TC:admin# 92-2 disable voice_vlan Description The command is used to disable the voice VLAN function on a switch. When the voice VLAN function is disabled, the voice VLAN will become unassigned.
  • Page 789 ® xStack DGS-3120 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 set the priority of the voice VLAN to be six: DGS-3120-24TC:admin# config voice_vlan priority 6 Command: config voice_vlan priority 6 Success.
  • Page 790 ® xStack DGS-3120 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 user-defined OUI for a voice device: DGS-3120-24TC:admin# config voice_vlan oui add 00-0A-OB-00-00-00 FF-FF-FF-00- 00-00 Command: config voice_vlan oui add 00-0A-OB-00-00-00 FF-FF-FF-00-00-00 Success.
  • Page 791 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To configure voice VLAN ports 4-6 to enable: DGS-3120-24TC:admin#config voice_vlan ports 1:4-1:6 state enable Command: config voice_vlan ports 1:4-1:6 state enable Success. DGS-3120-24TC:admin# To set the mode auto to voice VLAN ports 3-5: DGS-3120-24TC:admin#config voice_vlan ports 1:3-1:5 mode auto Command: config voice_vlan ports 1:3-1:5 mode auto Success.
  • Page 792 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# config voice_vlan aging_time 60 Command: config voice_vlan aging_time 60 Success. DGS-3120-24TC:admin# 92-7 config voice_vlan log state Description This command is used to configure the log state for voice VLAN. If there is a new voice device detected/or a port joins/leaves the voice VLAN dynamically, and the log is enabled, a log will be triggered.
  • Page 793 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions None. Example To display the voice VLAN global information when voice VLAN is enabled: DGS-3120-24TC:admin#show voice_vlan Command: show voice_vlan Voice VLAN State : Enabled VLAN ID VLAN Name : v2 Priority...
  • Page 794 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Restrictions None. Example To display the OUI information of voice VLAN: DGS-3120-24TC:admin#show voice_vlan oui Command: show voice_vlan oui OUI Address Mask Description ------------------ ----------------- -------------- 00-01-E3-00-00-00 FF-FF-FF-00-00-00 Siemens 00-03-6B-00-00-00 FF-FF-FF-00-00-00...
  • Page 795 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#show voice_vlan ports 1:1-1:5 Command: show voice_vlan ports 1:1-1:5 Ports Status Mode ----- --------- -------------- Disabled Auto Untagged Disabled Auto Untagged Disabled Auto Untagged Enabled Auto Untagged Enabled Auto Untagged DGS-3120-24TC:admin#...
  • Page 796 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# show voice_vlan voice_device port 1:1-1:5 Command: show voice_vlan voice_device ports 1:1-1:5 Ports Voice Device Start Time Last Active Time ----- ----------------- ---------------- ---------------- 00-E0-BB-00-00-01 2008-10-6 09:00 2008-10-6 10:30 00-E0-BB-00-00-02 2008-10-6 14:10...
  • Page 797 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# show voice_vlan lldp_med voice_device Command: show voice_vlan lldp_med voice_device Index Local Port : 1:1 Chassis ID Subtype : MAC Address Chassis ID : 00-E0-BB-00-00-11 Port ID Subtype : Network Address Port ID : 172.18.1.1...
  • Page 798: Chapter 93 Web-Based Access Control (Wac) Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 93 Web-Based Access Control (WAC) Command List enable wac disable wac config wac ports [<portlist> | all] {state [enable | disable] | aging_time [infinite | <min 1-1440>] | idle_time [infinite | <min 1-1440>] | block_time [<sec 0-300>]} (1) config wac method [local | radius] config wac default_redirpath <string 128>...
  • Page 799: Disable Wac

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# enable wac Command: enable wac Success. DGS-3120-24TC:admin# 93-2 disable wac Description This command is used to disable WAC function; all authentication entries related to WAC will be deleted.
  • Page 800: Config Wac Method

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide all - Configure all the Switch ports’ WAC state. state - (Optional) To specify the port state of WAC enable - Specify that the port state of WAC will be enabled. disable - Specify that the port state of WAC will be disabled.
  • Page 801 ® xStack DGS-3120 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 WAC auth method: DGS-3120-24TC:admin# config wac method radius Command: config wac method radius Success.
  • Page 802 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 93-6 config wac clear_default_redirpath Description This command is used to clear the WAC default redirect path. When the string is cleared, the client will not be redirected to another URL after successful authentication. Format config wac clear_default_redirpath Parameters...
  • Page 803 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example Set virtual IP address: DGS-3120-24TC:admin# config wac virtual_ip 1.1.1.1 Command: config wac virtual_ip 1.1.1.1 Success. DGS-3120-24TC:admin# 93-8 config wac switch_http_port Description This command is used to configure the HTTP or HTTPs ports used by WAC. The TCP port for HTTP or HTTPs is used to identify the HTTP or HTTPs packets That will be trapped to CPU for authentication processing, or to access the login page.
  • Page 804: Create Wac User

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 93-9 create wac user Description This command is used to create account for web-base access control. This user account is independent with login user account. If VLAN is not specified, the user will not get a VLAN assigned after the authentication. Format create wac user <username 15>...
  • Page 805: Config Wac User

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters user - To specify the user name to be deleted <username 15> - Enter the username used here. This name can be up to 15 characters long. all_users - All user accounts in local DB will be deleted.
  • Page 806: Config Wac Authorization Attributes

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin# config wac user Jim vlanid 3 Command: config wac user Jim vlanid 3 Enter a old password: *** Enter a case-sensitive new password: *** Enter the new password again for confirmation: *** Success.
  • Page 807: Show Wac

    Only Administrator, Operator and Power-User level users can issue this command. Example To configure the authenticate page elements: DGS-3120-24TC:admin#config wac authentication_page element notification_line 1 C opyright @ 2011 D-Link All Rights Reserved Command: config wac authentication_page element notification_line 1 Copyright @ 2011 D-Link All Rights Reserved Success.
  • Page 808: Show Wac Ports

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format show wac Parameters None. Restrictions None. Example Show global configuration about WAC: DGS-3120-24TC:admin#show wac Command: show wac Web-based Access Control -------------------------------- State : Enabled Method : Local Redirect Path : http://www.dlink.com Virtual IP...
  • Page 809: Show Wac User

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To show WAC port state and other parameters: DGS-3120-24TC:admin# show wac ports 1-3 Command: show wac ports 1-3 Port State Aging Time Idle Time Block Time (min) (min) (sec)
  • Page 810 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format show wac auth_state ports {<portlist>} Parameters ports - Specify a range of member ports to show the status. <portlist> - (Optional) Enter a list of ports to display here. Restrictions None.
  • Page 811 This command is used to show the elements of the customized authenticate pages. Format show wac authenticate_page Parameters None. Restrictions None. Example To display the authentication page elements: DGS-3120-24TC:admin#show wac authenticate_page Command: show wac authenticate_page Page Title : D-Link Login Window Title : Authentication Login User Name Title : User Name...
  • Page 812 : Password Logout Window Title : Logout From The Network Notification Copyright @ 2011 D-Link All Rights Reserved DGS-3120-24TC:admin# 93-19 clear wac auth_state Description This command is used to clear the authentication state of a port. If the port is port-based mode, the port will return to un-authenticated state.
  • Page 813: Chapter 94 Weighted Random Early Detection (Wred) Command List

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 94 Weighted Random Early Detection (WRED) Command List enable wred disable wred create wred profile <int 2-128> profile_name <profile_name 32> config wred profile [default | profile_id <int 2-128> | <profile_name 32>] {tcp | non_tcp} {green | yellow | red} min_threshold <int 0-100>...
  • Page 814 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 94-2 disable wred Description This command is used to disable the WRED global state. Format disable wred Parameters None. Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To disable wred global state: DGS-3120-24TC:admin#disable wred...
  • Page 815 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#create wred profile 2 profile_name profilename Command: create wred profile 2 profile_name profilename Success. DGS-3120-24TC:admin# 94-4 config wred profile Description This command is used to configure the WRED profile. Format config wred profile [default | profile_id <int 2-128>...
  • Page 816 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#config wred profile profile_id 2 min_threshold 30 max_threshold 50 max_drop_rate 10 Command: config wred profile profile_id 2 min_threshold 30 max_threshold 50 max_drop_rate 10 Success. DGS-3120-24TC:admin# 94-5 config wred ports Description This command is used to configure the WRED parameters of the ports.
  • Page 817 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide DGS-3120-24TC:admin#config wred ports 1:1 cos 2 profile profile_id 2 Command: config wred ports 1:1 cos 2 profile profile_id 2 Success. DGS-3120-24TC:admin# 94-6 delete wred profile Description This command is used to delete a WRED profile. Format delete wred profile [profile_id <int 2-128>...
  • Page 818 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide <portlist> - (Optional) Enter a range of ports. Restrictions None. Example To display wred of port 1:1 and 1:2 settings: DGS-3120-24TC:admin#show wred ports 1:1-1:2 Command: show wred ports 1:1-1:2 Global WRED : Disabled Port: 1:1 Class_ID...
  • Page 819 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters default - (Optional) Specify the default profile to be displayed. profile_id - (Optional) Specify the profile ID to be displayed. <int 2-128> - Enter the profile ID between 2 and 128. <profile_name 32>...
  • Page 820: Appendix A Mitigating Arp Spoofing Attacks Using Packet Content Acl

    ARP protocol, ARP spoofing attacks, and the countermeasures brought by D-Link’s switches to thwart ARP spoofing attacks. Figure 1 In the process of ARP, PC A will first issue an ARP request to query PC B’s MAC address. The network structure is shown in Figure 1.
  • Page 821 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Table 2 Ethernet Frame Format When the Switch receives the frame, it will check the “Source Address” in the Ethernet frame’s header. If the address is not in its Forwarding Table, the Switch will learn PC A’s MAC and the associated port into its Forwarding Table.
  • Page 822 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Table 3 ARP Payload When PC B replies to the query, the “Destination Address” in the Ethernet frame will be changed to PC A’s MAC address. The “Source Address” will be changed to PC B’s MAC address (see Table 4).
  • Page 823 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide attack). The principle of ARP spoofing is to send the fake, or spoofed ARP messages to an Ethernet network. Generally, the aim is to associate the attacker's or random MAC address with the IP address of another node (such as the default gateway).
  • Page 824 DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide can be seen in Figure 5 all traffic will be then sniffed by the hacker but the users will not discover. Prevent ARP Spoofing via Packet Content ACL D-Link managed switches can effectively mitigate common DoS attacks...
  • Page 825 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Byte Offset Offset Offset Offset Offset Offset Offset Offset Offset Offset Offset Offset Offset Offset Offset Offset Offset Chunk Chunk16 Chunk17 Chunk18 Chunk19 Chunk20 Chunk21 Chunk22 Chunk23 Chunk24 Chunk25 Chunk26...
  • Page 826 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Step Configure access profile 2. config access_profile profile_id 2 add access_id 1 packet_content The rest of the ARP packets whose offset_chunk_1 0x806 offset_chunk_2 Sender IP claim they are the gateway’s IP 0xA5A offset_chunk_3 0x5A5A0000 will be dropped.
  • Page 827: Appendix B Password Recovery Procedure

    This chapter explains how the Password Recovery feature can help network administrators reach this goal. The following steps explain how to use the Password Recovery feature on D-Link devices to easily recover passwords. Complete these steps to reset the password: For security reasons, the Password Recovery feature requires the user to physically access the device.
  • Page 828 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Command Parameters reset account The reset account command deletes all the previously created accounts. reset password The reset password command resets the password of the specified user. If {<username>} a username is not specified, the passwords of all users will be reset.
  • Page 829: Appendix C System Log Entries

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Appendix C System Log Entries The following table lists all possible entries and their corresponding meanings that will appear in the System Log of this Switch. Category Event Description Log Information Severity...
  • Page 830 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide unsuccessful! (Username: <ipaddr>" are <username>, IP: <ipaddr> ) XOR shown in log string, which means if user login by console, there will no IP information for logging. Configuration successfully Configuration successfully Informational...
  • Page 831 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Firmware successfully Firmware successfully uploaded Informational "by console" uploaded by console (Username: and "IP: <username>, IP: <ipaddr> ) <ipaddr>" are XOR shown in log string, which means if user login by console, there will no IP...
  • Page 832 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide <ipaddr> ) Successful login through Successful login through Informational Web(SSL) Web(SSL) (Username: <username>, IP: <ipaddr> ) Login failed through Login failed through Web(SSL) Warning Web(SSL) (Username: <username>, IP: <ipaddr>...
  • Page 833 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 1. The soure ip is same <ipaddr>, MAC: <macaddr>, as switch's interface ip but Port: <[unitID:]portNum> the source mac is different 2. Source ip is the same as the switch's IP in ARP packet 3.
  • Page 834 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Successful login through Successful login through Informational Web(SSL) authenticated Web(SSL) from <userIP> by AAA none method authenticated by AAA none method (Username: <username> ) Successful login through Successful login through Telnet Informational Telnet authenticated by...
  • Page 835 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Successful Enable Admin Successful Enable Admin Informational through Console through Console authenticated authenticated by AAA by AAA local_enable method local_enable method (Username: <username>) Enable Admin failed Enable Admin failed through Warning through Console Console authenticated by AAA...
  • Page 836 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide authenticated by AAA by AAA server <serverIP> server (Username: <username>) Enable Admin failed Enable Admin failed through Warning through Console Console authenticated by AAA authenticated by AAA server <serverIP>...
  • Page 837 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide RADIUS VID assigned from RADIUS server <ipaddr> Informational RADIUS server after assigned VID :<vlanID> to port RADIUS client is <[unitID:]portNum> authenticated by RADIUS (account :<username> ) server successfully .This VID will be assigned to the port and this port will be the VLAN untagged port...
  • Page 838 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide <vid>) JWAC When a client host JWAC authenticated user Informational authenticated successful. (Username: <string>, IP: <ipaddr | ipv6address>, MAC: <macaddr>, Port: <[unitID:] portNum>) When a client host fails to JWAC unauthenticated user Warning authenticate.
  • Page 839 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide which means if user login by console, there will no IP information for logging. Safeguard Safeguard Engine is in [Unit <unitID>] Safeguard Engine Informational Engine normal mode enters NORMAL mode Safeguard Engine is in [Unit <unitID>] Safeguard Engine...
  • Page 840 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide MAC:<macaddr>) Can not receive remote CFM remote down. MD Warning MEP's CCM packet Level:<mdlevel>, VLAN:<vlanid>, Local(Port <[unitID:]portNum>, Direction:<mepdirection>) Remote MEP's MAC CFM remote MAC error. MD Warning reports an error status Level:<mdlevel>, VLAN:<vlanid>, Local(Port...
  • Page 841 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide SD Card Execute configuration Error when execute configuration Warning Management error. <filename> line:<lineno> at time < time-range>. Schedule backup fail. Backup <type>:<filename> at Warning time <time-range> failure. Execute configuration Execute configuration Informational...
  • Page 842: Appendix D Trap Log Entries

    This table lists the trap logs found on the Switch. Log Entry Description swL2macNotification This trap indicate the MAC addresses 1.3.6.1.4.1.171.11.117.1.1.2.100.1. variation in the address table . 2.0.1(DGS-3120-24TC) Binding 1: swL2macNotifyInfo 1.3.6.1.4.1.171.11.117.1.2.2.100.1. 2.0.1(DGS-3120-24PC) 1.3.6.1.4.1.171.11.117.1.3.2.100.1. 2.0.1(DGS-3120-24SC) 1.3.6.1.4.1.171.11.117.1.4.2.100.1. 2.0.1(DGS-3120-48TC) 1.3.6.1.4.1.171.11.117.1.5.2.100.1. 2.0.1(DGS-3120-48PC) 1.3.6.1.4.1.171.11.117.1.6.2.100.1. 2.0.1(DGS-3120-24SC-DC) swL2PortSecurityViolationTrap When the port_security trap is enabled, if 1.3.6.1.4.1.171.11.117.1.1.2.100.1.
  • Page 843 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide uccess Control host is successfully logged in. Binding 1. swMacBasedAuthInfoMacIndex 2. swMacBasedAuthInfoPortIndex 3. swMacBasedAuthVID swMacBasedAccessControlLoggedFa The trap is sent when a MAC-based Access 1.3.6.1.4.1.171.12.35.11.1.0.2 Control host login fails Binding 1.
  • Page 844 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide entity with the OID of the MEP that has detected the fault. Binding 1. dot1agCfmMepHighestPrDefect swCFMExtAISOccurred A notification is generated when local MEP 1.3.6.1.4.1.171.12.86.100.0.1 enters AIS status. Binding 1.
  • Page 845 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 2. swPowerID 3. swPowerStatus swPowerRecover Power Recover notification. 1.3.6.1.4.1.171.12.11.2.2.2.0.3 Binding 1. swPowerUnitIndex 2. swPowerID 3. swPowerStatus swUnitInsert Unit Hot Insert notification. 1.3.6.1.4.1.171.12.11.2.2.1.0.1 Binding 1. swUnitMgmtId 2. swUnitMgmtMacAddr swUnitRemove Unit Hot Remove notification.
  • Page 846 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide detected by the local entity, while a remote event is detected by the reception of an Ethernet OAM Event Notification OAMPDU that indicates a non-threshold crossing event. Binding 1.
  • Page 847 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide of ifOperStatus. Binding 1: ifIndex 2: ifAdminStatus 3: ifOperStatus linkUp A linkUp trap signifies that the SNMP entity, 1.3.6.1.6.3.1.1.5.4 acting in an agent role, has detected that the ifOperStatus object for one of its communication links left the down state and...
  • Page 848 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide traps. Binding 1: alarmIndex 2: alarmVariable 3: alarmSampleType 4: alarmValue 5: alarmFallingThreshold LLDP This trap is initialed when a LLDP entry is 1.3.6.1.2.1.1.3.0 added to or deleted from remote DB. 1.3.6.1.6.3.1.1.4.1.0 1.0.8802.1.1.2.1.2.2 1.0.8802.1.1.2.1.2.3...
  • Page 849: Appendix Eradius Attributes Assignment

    ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Appendix E RADIUS Attributes Assignment The RADIUS Attributes Assignment on the Switch is used in the following modules: 802.1X (Port- based and Host-based), MAC-based Access Control, Web-based Access Control (WAC) and Japanese Web-based Access Control (JWAC).
  • Page 850 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide The parameters of the Vendor-Specific attributes are: Vendor-Specific Attribute Description Value Usage Vendor-ID Defines the vendor. 171 (DLINK) Required Vendor-Type Defines the attribute. Required Attribute-Specific Field Used to assign the 802.1p default Required priority of the port.
  • Page 851 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Tag field value String field format Note 0x01 VLAN name (ASCII) A tag field of greater than 0x1F is interpreted as the first octet of the 0x02 VLAN ID (ASCII) following field.
  • Page 852 ® xStack DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide If the user has configured the ACL attribute of the RADIUS server (for example, ACL profile: create access_profile profile_id 6 profile_name 1 ethernet; ACL rule: config access_profile profile_id 6 add access_id auto_assign ethernet), and the 802.1X, MAC-based Access Control, WAC or JWAC authentication is successful, the device will assign the ACL profiles and rules according to the RADIUS server.

This manual is also suitable for:

Xstack dgs-3120 series

Table of Contents