CLI Guide
Page 2
... 33 Chapter 34 Using Command Line Interface 1 Basic Command List ...8 802.1Q VLAN Command List 23 802.1X Command List...39 Access Authentication Control Command List 64 Access Control List (ACL) Command List 87 Access Control List (ACL) Egress Command List (EI Mode Only 107 Address Resolution Protocol (ARP) Command List 126 ARP Spoofing Prevention Command List 131 Asymmetric VLAN Command List 133 Auto-Configuration Command List 135 Basic Commands Command List 137 BPDU Attack Protection Command List 154 Cable Diagnostics Command List 159 Command Logging Command List 162 Compound...
... 33 Chapter 34 Using Command Line Interface 1 Basic Command List ...8 802.1Q VLAN Command List 23 802.1X Command List...39 Access Authentication Control Command List 64 Access Control List (ACL) Command List 87 Access Control List (ACL) Egress Command List (EI Mode Only 107 Address Resolution Protocol (ARP) Command List 126 ARP Spoofing Prevention Command List 131 Asymmetric VLAN Command List 133 Auto-Configuration Command List 135 Basic Commands Command List 137 BPDU Attack Protection Command List 154 Cable Diagnostics Command List 159 Command Logging Command List 162 Compound...
CLI Guide
Page 3
... Command List 457 MAC-based Access Control Command List 462 MAC-based VLAN Command List 479 Mirror Command List...482 MSTP debug enhancement Command List 485 Multicast Filter Command List 492 Multicast VLAN Command List 503 Multiple Spanning Tree Protocol (MSTP) Command List 517 Network Load Balancing (NLB) Command List 530 Network Monitoring Command List 536 OAM Commands (EI Mode Only 543 Password Recovery Command List 551 Peripherals Command List 554 Ping Command List ...560 Port Security Command List 562 Power over Ethernet (PoE) Command List 570 Power Saving Command List...
... Command List 457 MAC-based Access Control Command List 462 MAC-based VLAN Command List 479 Mirror Command List...482 MSTP debug enhancement Command List 485 Multicast Filter Command List 492 Multicast VLAN Command List 503 Multiple Spanning Tree Protocol (MSTP) Command List 517 Network Load Balancing (NLB) Command List 530 Network Monitoring Command List 536 OAM Commands (EI Mode Only 543 Password Recovery Command List 551 Peripherals Command List 554 Ping Command List ...560 Port Security Command List 562 Power over Ethernet (PoE) Command List 570 Power Saving Command List...
CLI Guide
Page 5
... RS-232 to configure and manage the Switch via the Serial Port The Switch's serial port's default settings are as follows: • 115200 baud • no initial username or password. xStack® DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 1 Using Command Line Interface The Switch can be used for communication with an SNMP network manager or other TCP/IP application (for all commands are then connected to the Hardware Installation Guide. 1-1 Accessing the Switch via the serial port or Telnet interfaces. Every command will be visible...
... RS-232 to configure and manage the Switch via the Serial Port The Switch's serial port's default settings are as follows: • 115200 baud • no initial username or password. xStack® DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Chapter 1 Using Command Line Interface The Switch can be used for communication with an SNMP network manager or other TCP/IP application (for all commands are then connected to the Hardware Installation Guide. 1-1 Accessing the Switch via the serial port or Telnet interfaces. Every command will be visible...
CLI Guide
Page 24
... cale. disable - slave - Enter a list of ports used for the port will be set port speed to cross. Set port speed to 10_full. 100_half - enable - If set to slave. medium_type - (Optional) Specify the medium type while the configure ports are in mdix mode) on one or more ports. learning - (Optional) You can issue this configuration. Enter the port interface description here. Specify that the MDIX mode for this command. disable - xStack® DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format config ports...
... cale. disable - slave - Enter a list of ports used for the port will be set port speed to cross. Set port speed to 10_full. 100_half - enable - If set to slave. medium_type - (Optional) Specify the medium type while the configure ports are in mdix mode) on one or more ports. learning - (Optional) You can issue this configuration. Enter the port interface description here. Specify that the MDIX mode for this command. disable - xStack® DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Format config ports...
CLI Guide
Page 36
...; DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 3-12 enable pvid auto assign Description This command is used to disable auto assignment of VLAN list. When user removes a port from the untagged membership of PVID. Format enable pvid auto_assign Parameters None. Restrictions Only Administrator, Operator and Power-User level users can issue this port's PVID will be possibly changed by PVID or VLAN configuration. In the form of VLAN list command, PVID is used to VLAN X's untagged membership, this command. The default setting is enabled...
...; DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 3-12 enable pvid auto assign Description This command is used to disable auto assignment of VLAN list. When user removes a port from the untagged membership of PVID. Format enable pvid auto_assign Parameters None. Restrictions Only Administrator, Operator and Power-User level users can issue this port's PVID will be possibly changed by PVID or VLAN configuration. In the form of VLAN list command, PVID is used to VLAN X's untagged membership, this command. The default setting is enabled...
CLI Guide
Page 56
... and Power-User level users can be up to join the guest VLAN. If the specific port state is used for the configuration here. A range of the configured ports. Specify the guest VLAN port state of ports enable or disable guest VLAN function. - The VLAN name can issue this command. DGS-3120-24TC:admin# 4-19 config 802.1x guest_vlan Description This command is changed from enabled state to configure guest VLAN setting. Enter the list of ports used to disable state, this configuration. disable...
... and Power-User level users can be up to join the guest VLAN. If the specific port state is used for the configuration here. A range of the configured ports. Specify the guest VLAN port state of ports enable or disable guest VLAN function. - The VLAN name can issue this command. DGS-3120-24TC:admin# 4-19 config 802.1x guest_vlan Description This command is changed from enabled state to configure guest VLAN setting. Enter the list of ports used to disable state, this configuration. disable...
CLI Guide
Page 149
...; DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 12-11 reset Description This command is used to provide reset functions. But device will do save and reboot. system - (Optional) If you specify the 'system' keyword, all parameters are reset to select a firmware file as a boot up file. Example To reset the Switch: DGS-3120-24TC:admin#reset system Command: reset system Are you sure you specify the 'config' keyword , all parameters are reset to default settings. Please wait, the switch is rebooting... 12...
...; DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide 12-11 reset Description This command is used to provide reset functions. But device will do save and reboot. system - (Optional) If you specify the 'system' keyword, all parameters are reset to select a firmware file as a boot up file. Example To reset the Switch: DGS-3120-24TC:admin#reset system Command: reset system Are you sure you specify the 'config' keyword , all parameters are reset to default settings. Please wait, the switch is rebooting... 12...
CLI Guide
Page 233
... all console Command: debug output all module debug message outputs to not need a reboot when a fatal error occurs: 229 If enabled, the Switch will hang-up for debug and enter the debug shell mode for debug. Format debug config error_reboot [enable | disable] Parameters enable - If the error_reboot is enabled, the watchdog shall be rebooted when a fatal error occurs. Enter the module list here. xStack® DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters module...
... all console Command: debug output all module debug message outputs to not need a reboot when a fatal error occurs: 229 If enabled, the Switch will hang-up for debug and enter the debug shell mode for debug. Format debug config error_reboot [enable | disable] Parameters enable - If the error_reboot is enabled, the watchdog shall be rebooted when a fatal error occurs. Enter the module list here. xStack® DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters module...
CLI Guide
Page 301
...-33 add 1:1-1:5 Success. Specify the FDB age out time in dynamic forwarding table entries that are not accessed within the aging time. A very long aging time can be specified as static MAC addresses. delete - Enter the multicast MAC address to and from the multicast forwarding table. - This will result in a high percentage of having a switch.. - DGS-3120-24TC:admin# 32-5 config fdb aging_time Description This command is used to 1000000 seconds. xStack® DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide...
...-33 add 1:1-1:5 Success. Specify the FDB age out time in dynamic forwarding table entries that are not accessed within the aging time. A very long aging time can be specified as static MAC addresses. delete - Enter the multicast MAC address to and from the multicast forwarding table. - This will result in a high percentage of having a switch.. - DGS-3120-24TC:admin# 32-5 config fdb aging_time Description This command is used to 1000000 seconds. xStack® DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide...
CLI Guide
Page 327
... to disable the IGMP snooping fast leave function. disable - Enter disable to use all - If enabled, multiple IGMP reports or leave for which IGMP snooping is immediately removed when the system receives the IGMP leave message. Disable the proxy reporting. xStack® DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters vlan_name - Specify the name of the VLAN for a specific (S, G) will be up to disable IGMP snooping for the chosen VLAN. all configured VLANs. Enter disable to 32 characters long. disable - Specify IGMP...
... to disable the IGMP snooping fast leave function. disable - Enter disable to use all - If enabled, multiple IGMP reports or leave for which IGMP snooping is immediately removed when the system receives the IGMP leave message. Disable the proxy reporting. xStack® DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters vlan_name - Specify the name of the VLAN for a specific (S, G) will be up to disable IGMP snooping for the chosen VLAN. all configured VLANs. Enter disable to 32 characters long. disable - Specify IGMP...
CLI Guide
Page 331
.... Specify to be configured. (UnitID:port number) Restrictions Only Administrator, Operator and Power-User level users can issue this command. Specify the name of default VLAN: DGS-3120-24TC:admin# config router_ports_forbidden default add 1:11-1:12 Command: config router_ports_forbidden default add 1:11-1:12 Success. add - Specify the ID of ports to delete the router ports. - Enter the VLAN ID list here. Specify a range of the VLAN on which the router port resides. - xStack® DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide delete -
.... Specify to be configured. (UnitID:port number) Restrictions Only Administrator, Operator and Power-User level users can issue this command. Specify the name of default VLAN: DGS-3120-24TC:admin# config router_ports_forbidden default add 1:11-1:12 Command: config router_ports_forbidden default add 1:11-1:12 Success. add - Specify the ID of ports to delete the router ports. - Enter the VLAN ID list here. Specify a range of the VLAN on which the router port resides. - xStack® DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide delete -
CLI Guide
Page 333
...; DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To disable IGMP snooping on which the router port resides. - The static group will only affect V2 IGMP operation. vlanid - Enter the VLAN ID here. - DGS-3120-24TC:admin# 35-9 create igmp_snooping static_group Description This command is enabled on which the router port resides. - The static member port will only take effect when IGMP snooping is used to 32 characters long. Example To create an IGMP snooping static group for this command. Member ports can issue this specific...
...; DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To disable IGMP snooping on which the router port resides. - The static group will only affect V2 IGMP operation. vlanid - Enter the VLAN ID here. - DGS-3120-24TC:admin# 35-9 create igmp_snooping static_group Description This command is enabled on which the router port resides. - The static member port will only take effect when IGMP snooping is used to 32 characters long. Example To create an IGMP snooping static group for this command. Member ports can issue this specific...
CLI Guide
Page 352
...3120-24TC:admin# config mld_snooping mrouter_ports vlan default add 1:11:10 Command: config mld_snooping mrouter_ports vlan default add 1:1-1:10 Success. Specify to delete the router ports. - This will ensure that the forbidden router port will reach the multicast-enabled router, regardless of protocol, etc. The VLAN name can be configured. (UnitID:port number) Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To set up to 32 characters long. delete - xStack® DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch...
...3120-24TC:admin# config mld_snooping mrouter_ports vlan default add 1:11:10 Command: config mld_snooping mrouter_ports vlan default add 1:1-1:10 Success. Specify to delete the router ports. - This will ensure that the forbidden router port will reach the multicast-enabled router, regardless of protocol, etc. The VLAN name can be configured. (UnitID:port number) Restrictions Only Administrator, Operator and Power-User level users can issue this command. Example To set up to 32 characters long. delete - xStack® DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch...
CLI Guide
Page 353
... command will be configured. (UnitID:port number) Restrictions Only Administrator, Operator and Power-User level users can issue this command. 349 Otherwise, the Switch forwards all multicast traffic to be forwarded to all the members of ports to the multicast router, only. xStack® DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters vlan - The VLAN name can issue this command. Enter the VLAN ID list here. Example To set up to forbidden router ports of the VLAN on the Switch. DGS-3120-24TC:admin# 35-28 enable...
... command will be configured. (UnitID:port number) Restrictions Only Administrator, Operator and Power-User level users can issue this command. 349 Otherwise, the Switch forwards all multicast traffic to be forwarded to all the members of ports to the multicast router, only. xStack® DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters vlan - The VLAN name can issue this command. Enter the VLAN ID list here. Example To set up to forbidden router ports of the VLAN on the Switch. DGS-3120-24TC:admin# 35-28 enable...
CLI Guide
Page 434
...'Maximum-frame-size TLV. maximum_frame_size - (Optional) This TLV optional data type indicates that LLDP agent should transmit 'MAC/PHY configuration/status TLV'. disable - Example To enable SNMP notifications from port 1-5: DGS-3120-24TC:admin# config lldp ports 1:1-1:5 notification enable Command: config lldp ports 1:1-1:5 notification enable Success. DGS-3120-24TC:admin# To configure port 1-5 to advertise and discover the MDI power support capabilities of doing link aggregation, whether the port is disabled. If EAPOL, GVRP, STP (including MSTP), and LACP protocol identity is enabled on...
...'Maximum-frame-size TLV. maximum_frame_size - (Optional) This TLV optional data type indicates that LLDP agent should transmit 'MAC/PHY configuration/status TLV'. disable - Example To enable SNMP notifications from port 1-5: DGS-3120-24TC:admin# config lldp ports 1:1-1:5 notification enable Command: config lldp ports 1:1-1:5 notification enable Success. DGS-3120-24TC:admin# To configure port 1-5 to advertise and discover the MDI power support capabilities of doing link aggregation, whether the port is disabled. If EAPOL, GVRP, STP (including MSTP), and LACP protocol identity is enabled on...
CLI Guide
Page 455
... auto-recovery mechanism should be between 1 and 32767 seconds. Format config loopdetect {recover_timer [0 | ] | interval | mode [port-based | vlan-based]} Parameters recover_timer - (Optional) The time interval (in seconds) that the device will be disabled. The default value for the entire Switch. Specify that has detected the loop. 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 | ] | interval | mode [portbased | vlan-based]} config...
... auto-recovery mechanism should be between 1 and 32767 seconds. Format config loopdetect {recover_timer [0 | ] | interval | mode [port-based | vlan-based]} Parameters recover_timer - (Optional) The time interval (in seconds) that the device will be disabled. The default value for the entire Switch. Specify that has detected the loop. 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 | ] | interval | mode [portbased | vlan-based]} config...
CLI Guide
Page 474
... VLAN exists. - Format create mac_based_access_control_local mac {[vlan | vlanid < vlanid 1-4094>]} Parameters mac - xStack® DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To clear MAC-based Access Control clients' 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-0000-47-04-65 Command: clear mac_based_access_control auth_state mac_addr 00-00-00-47-04-65 Success. Enter the MAC address used for this command...
... VLAN exists. - Format create mac_based_access_control_local mac {[vlan | vlanid < vlanid 1-4094>]} Parameters mac - xStack® DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Example To clear MAC-based Access Control clients' 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-0000-47-04-65 Command: clear mac_based_access_control auth_state mac_addr 00-00-00-47-04-65 Success. Enter the MAC address used for this command...
CLI Guide
Page 738
... type of log message may generate a large amount of messages and quickly cause the system to log messages driven by modules such as DOS and the IP-MAC-port binding module. Format show log_save_timing Parameters None. Example To show the timing method used to display the attack log messages. 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. Therefore, for saving the log: DGS-3120-24TC:admin...
... type of log message may generate a large amount of messages and quickly cause the system to log messages driven by modules such as DOS and the IP-MAC-port binding module. Format show log_save_timing Parameters None. Example To show the timing method used to display the attack log messages. 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. Therefore, for saving the log: DGS-3120-24TC:admin...
CLI Guide
Page 783
...removed. To change the VLAN trunk setting for an aggregated link, the user must apply the command to link aggregation member port excluding the master, the command will be automatically created, and the trunk port will be rejected. Example To disable the VLAN Trunk: DGS-3120-24TC:admin# disable vlan_trunk Command: disable vlan_trunk Success. xStack® DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters None. However, if they are specified as VLAN trunk port, they are allowed to these VLANs are not allowed to configure a port as the aggregated...
...removed. To change the VLAN trunk setting for an aggregated link, the user must apply the command to link aggregation member port excluding the master, the command will be automatically created, and the trunk port will be rejected. Example To disable the VLAN Trunk: DGS-3120-24TC:admin# disable vlan_trunk Command: disable vlan_trunk Success. xStack® DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Parameters None. However, if they are specified as VLAN trunk port, they are allowed to these VLANs are not allowed to configure a port as the aggregated...
CLI Guide
Page 827
... connection to easily recover passwords. Therefore this goal. If force_agree is through a local login, utilizing a Username and Password. Sometimes, passwords get forgotten or destroyed, so network administrators need to reset these steps to enter the "Password Recovery Mode." In the "Password Recovery Mode" only the following steps explain how to use the Password Recovery feature on the Switch will be used to save the current settings. 823 xStack® DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Appendix B Password Recovery...
... connection to easily recover passwords. Therefore this goal. If force_agree is through a local login, utilizing a Username and Password. Sometimes, passwords get forgotten or destroyed, so network administrators need to reset these steps to enter the "Password Recovery Mode." In the "Password Recovery Mode" only the following steps explain how to use the Password Recovery feature on the Switch will be used to save the current settings. 823 xStack® DGS-3120 Series Layer 2 Managed Stackable Gigabit Switch CLI Reference Guide Appendix B Password Recovery...