D-Link DGS-3700 Series User manual

DGS-3700 Series Layer 2 Managed Gigabit Ethernet Switch CLI Reference Guide
Page | 1
CLI Reference Guide
Product Model:
DGS-3700 Series
Layer 2 Managed Gigabit Ethernet Switch
Release 2.00

DGS-3700 Series Layer 2 Managed Gigabit Ethernet Switch CLI Reference Guide
Page | 2
Information in this document is subject to change without notice.
© 2010 D-Link Corporation. All rights reserved.
Reproduction in any manner whatsoever without the written permission of D-Link Corporation is strictly forbidden.
Trademarks used in this text: D-Link and the D-LINK logo are trademarks of D-Link Corporation; Microsoft and Windows are registered
trademarks of Microsoft Corporation.
Other trademarks and trade names may be used in this document to refer to either the entities claiming the marks and names or their products. D-
Link Corporation disclaims any proprietary interest in trademarks and trade names other than its own.
March 2011 P/N 651370012005G

DGS-3700 Series Layer 2 Managed Gigabit Ethernet Switch CLI Reference Guide
Page | 3
Table of Contents
Introduction Section ........................................................................................................................................5
Using the Command Line Interface (CLI) .................................................................................................................................... 5
Accessing the Switch via the Serial Port....................................................................................................5
Setting the Switch’s IPAddress..................................................................................................................7
Command Syntax Symbols.......................................................................................................................11
Interface and Hardware Section...................................................................................................................13
Cable Diagnostic Commands...................................................................................................................................................... 13
DDM Commands ........................................................................................................................................................................ 15
Local Loopback Commands........................................................................................................................................................ 21
Fundamentals Section....................................................................................................................................23
Basic Commands......................................................................................................................................................................... 23
Debug Commands....................................................................................................................................................................... 37
Password Recovery Commands.................................................................................................................................................. 48
Power Saving Commands ........................................................................................................................................................... 51
Switch Utility Commands........................................................................................................................................................... 53
Technical Support Commands..................................................................................................................................................... 65
Management Section......................................................................................................................................67
Command History Commands.................................................................................................................................................... 67
D-Link Single IP Management Commands................................................................................................................................. 70
DNS Relay Commands ............................................................................................................................................................... 80
Modify Banner and Prompt Commands...................................................................................................................................... 84
IPv6 Neighbor Discovery Commands......................................................................................................................................... 87
LLDP Commands........................................................................................................................................................................ 91
Network Monitoring Commands .............................................................................................................................................. 110
Safeguard Engine Commands ................................................................................................................................................... 127
sFlow Commands...................................................................................................................................................................... 129
SNMP Commands..................................................................................................................................................................... 137
Switch Port Commands............................................................................................................................................................. 160
Time and SNTP Commands...................................................................................................................................................... 165
Layer 2 Features Section.............................................................................................................................171
BPDU Attack Protection Commands ........................................................................................................................................ 171
Ethernet Ring Protection Switching (ERPS) Commands.......................................................................................................... 175
Filter (DHCP Server/NetBIOS) Commands.............................................................................................................................. 183
Forwarding Database Commands ............................................................................................................................................. 188
IGMP Multicast VLAN Commands.......................................................................................................................................... 194
IGMP Snooping Commands ..................................................................................................................................................... 202
IPMC Commands...................................................................................................................................................................... 218
Layer 2 Protocol Tunneling (L2PT) Commands....................................................................................................................... 219
Link Aggregation Commands ................................................................................................................................................... 221
Limited IP Multicast Address Commands................................................................................................................................. 226
MAC Notification Commands .................................................................................................................................................. 232
MLD Multicast VLAN Commands........................................................................................................................................... 235
MLD Snooping Commands ...................................................................................................................................................... 243
Multiple Spanning Tree Protocol (MSTP) Commands ............................................................................................................. 258
Packet Storm Commands .......................................................................................................................................................... 269
Port Mirroring Commands ........................................................................................................................................................ 274
Port Security Commands........................................................................................................................................................... 277
Q-in-Q Commands.................................................................................................................................................................... 283
Rspan Commands...................................................................................................................................................................... 289
Static MAC-Based VLAN Commands...................................................................................................................................... 293
Static Subnet VLAN Commands............................................................................................................................................... 295
Traffic Segmentation Commands.............................................................................................................................................. 298
VLAN Commands .................................................................................................................................................................... 300
VLAN Counter Commands....................................................................................................................................................... 313
Voice VLAN Commands........................................................................................................................................................... 316
Layer 3 Features Section.............................................................................................................................323
ARP Commands........................................................................................................................................................................ 323
Basic IP Commands .................................................................................................................................................................. 327

DGS-3700 Series Layer 2 Managed Gigabit Ethernet Switch CLI Reference Guide
Page | 4
Loop-back Detection Commands.............................................................................................................................................. 334
Out-of-Band Managemnet Commands ..................................................................................................................................... 338
Routing Table Commands......................................................................................................................................................... 340
Quality of Service (QoS) Section ................................................................................................................344
QoS Commands ........................................................................................................................................................................ 344
Simple RED Commands ........................................................................................................................................................... 355
Access Control List (ACL) Section.............................................................................................................363
Access Control List (ACL) Commands .................................................................................................................................... 363
Security Section............................................................................................................................................386
802.1X and Guest VLAN Commands....................................................................................................................................... 386
Access Authentication Control Commands............................................................................................................................... 404
IP-MAC-Port Binding (IMPB) Commands............................................................................................................................... 424
MAC-based Access Control Commands................................................................................................................................... 442
Compound Authentication Commands ..................................................................................................................................... 454
SSH Commands........................................................................................................................................................................ 460
SSL Commands......................................................................................................................................................................... 467
Web-based Access Control Commands..................................................................................................................................... 472
Network Application Section ......................................................................................................................481
DHCP Local Relay Commands................................................................................................................................................. 481
DHCP Relay Commands........................................................................................................................................................... 484
DHCP Server Commands.......................................................................................................................................................... 498
Object Access Method (OAM) Section.......................................................................................................511
CFM EXTENSION (ITU-T Y.1731)......................................................................................................................................... 511
Connectivity Fault Management Commands............................................................................................................................ 517
Ethernet OAM Commands........................................................................................................................................................ 535
Monitoring Section.......................................................................................................................................548
External Alarm Commands....................................................................................................................................................... 548
Appendix Section .........................................................................................................................................550
Appendix A ............................................................................................................................................................................... 550
Mitigating ARP Spoofing Attacks Using Packet Content ACL..............................................................550
Appendix B ............................................................................................................................................................................... 556
Password Recovery Procedure ...............................................................................................................556

DGS-3700 Series Layer 2 Managed Gigabit Ethernet Switch CLI Reference Guide
Page | 5
INTRODUCTION SECTION1
Table of Contents
Next Section
USINGTHE COMMAND LINE INTERFACE (CLI)
Back to Section Header
The Switch can be managed through the Switch’s serial port, Telnet, or the Web-based management agent.
The Command Line Interface (CLI) can be used to configure and manage the Switch via the serial port or
Telnet interfaces.
This manual provides a reference for all of the commands contained in the CLI. Configuration and
management of the Switch via the Web-based management agent is discussed in the Web UI Reference
Guide.
This manual provides a reference for all of the commands contained in the CLI for the DGS-3700-12 and
DGS-3700-12G. Examples present in this manual may refer to either member of this series and may show
different port counts, but are universal to this series of switches, unless otherwise stated. Configuration and
management of the Switch via the Web-based management agent is discussed in the User Guide.
NOTE: For the remainder of this manual, the DGS-3700-12, DGS-3700-12G, switches
will be referred to as simply the Switch or the DGS-3700 Series.
ACCESSING THE SWITCH VIATHE SERIAL PORT
The Switch’s serial port’s default settings are as follows:
•115200 baud
•no parity
•8 data bits
•1 stop bit
A computer running a terminal emulation program capable of emulating a VT-100 terminal and a serial port
configured as above is then connected to the Switch’s serial port via an RS-232 DB-9 cable.
With the serial port properly connected to a management computer, the following screen should be visible. If
this screen does not appear, try pressing Ctrl+r to refresh the console screen.

DGS-3700 Series Layer 2 Managed Gigabit Ethernet Switch CLI Reference Guide
Page | 6
DGS-3700-12G Gigabit Ethernet Switch
Command Line Interface
Firmware: Build 2.00.B023
Copyright(C) 2009 D-Link Corporation. All rights reserved.
UserName:
There is no initial username or password. Just press the Enter key twice to display the CLI input cursor −
DGS-3700-12:5#.This is the command line where all commands are input.

DGS-3700 Series Layer 2 Managed Gigabit Ethernet Switch CLI Reference Guide
Page | 7
SETTING THE SWITCH’S IPADDRESS
Each Switch must be assigned its own IPAddress, which is used for communication with an SNMP network
manager or other TCP/IP application (for example BOOTP, TFTP). The Switch’s default IP address is
10.90.90.90. Users can change the default Switch IP address to meet the specification of your networking
address scheme.
The Switch is also assigned a unique MAC address by the factory. This MAC address cannot be changed,
and can be found on the initial boot console screen – shown below.
Boot Procedure V1.00.B002
-----------------------------------------------------------------------------
Power On Self Test ........................................ 100 %
MAC Address : 00-01-02-03-04-00
H/W Version : A1
Please Wait, Loading V2.00.B023 Runtime Image ............. 100 %
UART init ................................................. 100 %
Device Discovery .......................................... 100 %
Configuration init ........................................ \_
The Switch’s MAC address can also be found in the Web management program on the Switch Information
(Basic Settings) window on the Configuration menu.
The IP address for the Switch must be set before it can be managed with the Web-based manager. The
Switch IP address can be automatically set using BOOTP or DHCP protocols, in which case the actual
address assigned to the Switch must be known.
The IP address may be set using the Command Line Interface (CLI) over the console serial port as follows:
1. Starting at the command line prompt, enter the commands config ipif System ipaddress
xxx.xxx.xxx.xxx/yyy.yyy.yyy.yyy. Where the x’s represent the IP address to be assigned to the IP
interface named System and the y’s represent the corresponding subnet mask.
2. Alternatively, users can enter config ipif System ipaddress xxx.xxx.xxx.xxx/z. Where the x’s
represent the IP address to be assigned to the IP interface named System and the z represents the
corresponding number of subnets in CIDR notation.
The IP interface named System on the Switch can be assigned an IP address and subnet mask which can
then be used to connect a management station to the Switch’s Telnet or Web-based management agent.
DGS-3700-12:5#config ipif System ipaddress 10.24.73.21/255.0.0.0
Command: config ipif System ipaddress 10.73.21.21/8
Success.
DGS-3700-12:5#

DGS-3700 Series Layer 2 Managed Gigabit Ethernet Switch CLI Reference Guide
Page | 8
In the above example, the Switch was assigned an IP address of 10.24.73.21 with a subnet mask of 255.0.0.0.
The system message Success indicates that the command was executed successfully. The Switch can now be
configured and managed via Telnet, SNMP MIB browser and the CLI or via the Web-based management
agent using the above IP address to connect to the Switch.
There are a number of helpful features included in the CLI. Entering the ?command will display a list of all
of the top-level commands.
?
cable_diag ports
cfm linktrace
cfm loopback
clear
clear address_binding dhcp_snoop binding_entry ports
clear arptable
clear attack_log
clear cfm pkt_cnt
clear counters
clear ethernet_oam ports
clear fdb
clear historical_counters ports
clear igmp_snooping data_driven_group
clear igmp_snooping statistic counter
clear log
clear mac_based_access_control auth_mac
clear mld_snooping data_driven_group
clear mld_snooping statistic counter
clear port_security_entry
clear vlan_counter statistics
CTRL+C ESC q Quit SPACE n Next Page ENTER Next Entry aAll
When users enter a command without its required parameters, the CLI will prompt users with a Next
possible completions: message.
DGS-3700-12:5#config account
Command: config account
Next possible completions:
<username>
DGS-3700-12:5#
In this case, the command config account was entered with the parameter <username>. The CLI will then
prompt users to enter the <username> with the message, Next possible completions:. Every command in
the CLI has this feature, and complex commands have several layers of parameter prompting.
In addition, after typing any given command plus one space, users can see all of the next possible sub-
commands, in sequential order, by repeatedly pressing the Tab key.
To re-enter the previous command at the command prompt, press the up arrow cursor key. The previous
command will appear at the command prompt.

DGS-3700 Series Layer 2 Managed Gigabit Ethernet Switch CLI Reference Guide
Page | 9
DGS-3700-12:5#config account
Command: config account
Next possible completions:
<username>
DGS-3700-12:5#config account
Command: config account
Next possible completions:
<username>
DGS-3700-12:5#
In the above example, the command config account was entered without the required parameter
<username>, the CLI returned the Next possible completions: <username> prompt. The up arrow cursor
control key was pressed to re-enter the previous command (config account) at the command prompt. Now
the appropriate username can be entered and the config account command re-executed.
All commands in the CLI function in this way. In addition, the syntax of the help prompts are the same as
presented in this manual −angle brackets < > indicate a numerical value or character string, braces { }
indicate optional parameters or a choice of parameters, and brackets [ ] indicate required parameters.
If a command is entered that is unrecognized by the CLI, the top-level commands will be displayed under
the Available commands: prompt.
DGS-3700-12:5#the
Available commands:
.. ? cable_diag cfm
clear config create delete
disable download enable login
logout ping ping6 reboot
reconfig reset save show
upload
DGS-3700-12G:5#
The top-level commands consist of commands such as show or config. Most of these commands require one
or more parameters to narrow the top-level command. This is equivalent to show what? or config what?
Where the what? is the next parameter.
For example, if users enter the show command with no additional parameters, the CLI will then display all
of the possible next parameters.

DGS-3700 Series Layer 2 Managed Gigabit Ethernet Switch CLI Reference Guide
Page | 10
DGS-3700-12G:5#show
Command: show
Next possible completions:
802.1p 802.1x access_profile account
accounting acct_client address_binding arpentry
attack_log auth_client auth_diagnostics
auth_session_statistics auth_statistics authen
authen_enable authen_login authen_policy autoconfig
bandwidth_control bpdu_tunnel cfm command_history
config cpu current_config ddm
device_status dhcp_relay dot1v_protocol_group
dscp error ethernet_oam external_alarm
fdb filter firmware flow_meter
greeting_message gvrp historical_counter
historical_utilization hol_prevention igmp_snooping
ipif ipif_ipv6_link_local_auto iproute
ipv6 ipv6route jumbo_frame lacp_port
limited_multicast_addr link_aggregation lldp
local_loopback log log_save_timing loopdetect
mac_based_access_control mac_based_access_control_local
mac_based_vlan mac_notification max_mcast_group
mcast_filter_profile mef_l2_protocols mgmt_pkt_priority
mirror mld_snooping multicast multicast_fdb
out_band_ipif packet port port_security
port_security_entry port_vlan ports
pvid qinq radius router_ports
rspan safeguard_engine scheduling
scheduling_mechanism serial_port session
sflow sim snmp sntp
sred ssh ssl stp
subnet_vlan switch syslog system_severity
time time_range traffic
traffic_segmentation trusted_host utilization
vlan vlan_counter vlan_precedence vlan_translation
wac
DGS-3700-12G:5#
In the above example, all of the possible next parameters for the show command are displayed.At the next
command prompt, the up arrow was used to re-enter the show command, followed by the account parameter.
The CLI then displays the user accounts configured on the Switch.

DGS-3700 Series Layer 2 Managed Gigabit Ethernet Switch CLI Reference Guide
Page | 11
COMMAND SYNTAX SYMBOLS
The following symbols are used to describe how command entries are made and values and arguments are
specified in this manual. The online help contained in the CLI and available through the console interface
uses the same syntax.
Note: All commands are case-sensitive. Be sure to disable Caps Lock or any other
unwanted function that changes text case.
<ANGLE BRACKETS>
Purpose Encloses a variable or value that must be specified.
Syntax
config ipif <ipif_name 12> [{ipaddress <network_address> |vlan <vlan_name 32>
|state [enable |disable]} | bootp |dhcp | ipv6 [ipv6address <ipv6networkaddr> |
state [enable| disable]] |ipv4 state [enable | disable] | dhcpv6_client
[enable|disable]
Description In the above syntax example, users must supply an IP interface name in the
<ipif_name 12> space, a VLAN name in the <vlan_name 32> space, and the
network address in the <network_address> space. Do not type the angle brackets.
Example
Command config ipif Engineering ipaddress 10.24.22.5/255.0.0.0 vlan Design state enable
[
SQUARE BRACKETS
]
Purpose Encloses a required value or set of required arguments. One value or argument can be
specified.
Syntax create vlan_counter [vlan <vlan_name> | vlanid <vidlist>] {ports [<portlist> |
all]} [all_frame | broadcast | multicast | unicast] [packet | byte]
Description In the above syntax example, users must specify either an admin or a user level
account to be created. Do not type the square brackets.
Example
Command create vlan_counter vlanid 1 unicast packet
|
VERTICAL BAR
Purpose Separates two or more mutually exclusive items in a list, one of which must be
entered.
Syntax create account [admin | operator | user] <username 15>
Description In the above syntax example, users must specify either admin, or user. Do not type
the backslash.
Example
Command create account admin Tommy
{BRACES}
Purpose Encloses an optional value or set of optional arguments.
Syntax reset {[config |system]} {force_agree}
Description
In the above syntax example, users have the option to specify config or system. It is
not necessary to specify either optional value, however the effect of the system
reset is dependent on which, if any, value is specified. Therefore, with this example
there are three possible outcomes of performing a system reset. See the following
chapter, Basic Commands for more details about the reset command.
Example reset config

DGS-3700 Series Layer 2 Managed Gigabit Ethernet Switch CLI Reference Guide
Page | 12
{BRACES}
command
PARENTHESES ()
Purpose
Indicates at least one or more of the values or arguments in the preceding syntax
enclosed by braces must be specified.
Syntax
config dhcp_relay {hops <value 1-16> | time <sec 0-65535>}(1)
Description Users have the option to specify hops or time or both of them. The "(1)" following the
set of braces indicates at least one argument or value within the braces must be
specified. DO NOT TYPE THE PARENTHESES.
Example
command config dhcp_relay time 60
LINE EDITING KEY USAGE
Delete
Deletes the character under the cursor and then shifts the remaining characters in the
line to the left.
Backspace
Deletes the character to the left of the cursor and then shifts the remaining characters
in the line to the left.
Left Arrow
Moves the cursor to the left.
Right Arrow Moves the cursor to the right.
Up Arrow Repeats the previously entered command. Each time the up arrow is pressed, the
command previous to that displayed appears. This way it is possible to review the
command history for the current session. Use the down arrow to progress
sequentially forward through the command history list.
Down Arrow The down arrow will display the next command in the command history entered in the
current session. This displays each command sequentially as it was entered. Use
the up arrow to review previous commands.
Tab Shifts the cursor to the next field to the left.
CTRL+k Deletes all the characters on the right of the cursor.
MULTIPLE PAGE DISPLAY CONTROL KEYS
Space Displays the next page.
CTRL+c Stops the display of remaining pages when multiple pages are to be displayed.
ESC Stops the display of remaining pages when multiple pages are to be displayed.
n Displays the next page.
p Displays the previous page.
q
Stops the display of remaining pages when multiple pages are to be displayed.
r Refreshes the pages currently displayed.
a Displays the remaining pages without pausing between pages.
Enter
Displays the next line or table entry.

DGS-3700 Series Layer 2 Managed Gigabit Ethernet Switch CLI Reference Guide
Page | 13
INTERFACE AND HARDWARE SECTION 2
Table of Contents
Next Section
Previous Section
CABLE DIAGNOSTIC COMMANDS
Back to Section Header
The Cable Diagnostic commands in the Command Line Interface (CLI) are listed (along with the
appropriate
parameters) in the following table.
COMMAND PARAMETERS
cable_diag ports
[<portlist>|all]
Each command is listed, in detail, in the following sections.
cable diag ports
Purpose This command is used to diagnose the copper cable. If there is an error on the cable, it
can determine the type of error and the position where the error occurred.
Syntax cable_diag ports [<portlist>|all]
Description When a port is in link up status, the diagnostic will obtain the distance of the cable.
Since the status is link-up, the cable will not have any problem. Since this
diagnostic is for copper cable, the port with fiber cable will be skipped from the
diagnostic.
If the link is up, the abnormal results won’t be shown and the cable length item
indicates the length of the cable.
If the link is down the reason may be that its partner has powered off or the port is
disabled, the abnormal results won’t be shown and the cable length item shows the
length of the cable.
If the link is down and there is some error in the cable, the abnormal results will be
shown, but the cable length item won’t be shown.
Parameters
all −Indicate all ports will be displayed.
<portlist> −Specifies a port or range of ports to be displayed.
Restrictions
None.
Example usage:
To do the cable diagnostic on ports 1-7 on the Switch:

DGS-3700 Series Layer 2 Managed Gigabit Ethernet Switch CLI Reference Guide
Page | 14
DGS-3700-12:5#cable_diag ports 1-7
Command: cable_diag ports 1-7
Perform Cable Diagnostics ...
Port Type Link Status Test Result Cable Length (M)
---- ------- -------------- ------------------------- -----------------
1 GE Link Down No Cable -
2 GE Link Down No Cable -
3 GE Link Up OK 55
4 GE Link Down No Cable -
5 GE Link Down No Cable -
6 GE Link Down No Cable -
7 GE Link Up OK 5
DGS-3700-12:5#

DGS-3700 Series Layer 2 Managed Gigabit Ethernet Switch CLI Reference Guide
Page | 15
DDM COMMANDS
Back to Section Header
The Digital Diagnostic Monitoring (DDM) module allows real time access to the SFP module operating
parameters. The DDM commands allow users to set warning and alarm thresholds on the operating
parameters. Once any of the operating parameters rise above the high threshold or fall below the low
threshold, the abnormal or dangerous conditions will be logged or processed accordingly to user’s
configuration.
The following monitoring operating parameters can be accessed.
•Internally measure the transceiver temperature in degree Celsius.
•Internally measure the transceiver supply voltage in volts.
•Measures Tx bias current in mA.
•Measures Tx output power in mW.
•Measures Rx received optical power in mW.
The DDM (Digital Diagnostic Monitoring) commands in the Command Line Interface (CLI) are listed
(along with the appropriate parameters) in the following table.
COMMAND PARAMETERS
config ddm log [enable | disable]
config ddm trap
[enable | disable]
config ddm ports [<portlist> | all] [[temperature_threshold | voltage_threshold | bias_current_threshold
| tx_power_threshold | rx_power_threshold] {high_alarm <float> | low_alarm
<float> | high_warning <float> | low_warning <float>}(1) | {state [enable |
disable] | shutdown [alarm | warning | none]} (1)]
show ddm
show ddm ports {<portlist>} [status | configuration]
Each command is listed, in detail, in the following sections.
config ddm log
Purpose To enable or disable log action when the SFP exceed its DDM threshold.
Syntax config ddm log [enable | disable]
Description This command is used to configure the DDM log action when encountering an
exceeding alarm or warning threshold event.
Parameters log - Specify whether or not to send a log when the operating parameter exceeds the
corresponding threshold.
enable - Enable the parameter selected.
disable - Disable the parameter selected.
Restrictions Only Administrator and Operator-level users can issue this command.
Example usage:
To configure the DDM log state to enable:

DGS-3700 Series Layer 2 Managed Gigabit Ethernet Switch CLI Reference Guide
Page | 16
DGS-3700-12:5#config ddm log enable
Command: config ddm log enable
Success.
DGS-3700-12:5#
config ddm trap
Purpose To enable or disable trap action when the SFP exceed its DDM threshold.
Syntax config ddm trap [enable | disable]
Description This command is used to configure the DDM trap action when encountering an
exceeding alarm or warning threshold event.
Parameters trap - Specify whether or not to send a trap when the operating parameter exceeds the
corresponding threshold.
enable - Enable the parameter selected.
disable - Disable the parameter selected.
Restrictions Only Administrator and Operator-level users can issue this command.
Example usage:
To configure the DDM trap state to enable:
DGS-3700-12:5#config ddm trap enable
Command: config ddm trap enable
Success.
DGS-3700-12:5#
config ddm ports
Purpose To configure a DDM threshold or action.
Syntax config ddm ports [<portlist> | all] [[temperature_threshold | voltage_threshold |
bias_current_threshold | tx_power_threshold | rx_power_threshold]
{high_alarm <float> | low_alarm <float> | high_warning <float> |
low_warning <float>} (1) | {state [enable | disable] | shutdown [alarm |
warning | none]} (1)]
Description
This command is used to configure a DDM threshold or action.
Parameters <portlist> - Specify a range of ports to be configured.
all - Specify to configure all ports.
temperature_threshold - Specify the temperature thresholds of the specified ports.
voltage_threshold - Specify the voltage thresholds of the specified ports.
bias_current_threshold - Specify the bias current thresholds of the specified ports.
tx_power_threshold - Specify the output power thresholds of the specified ports.
rx_power_threshold - Specify the received power thresholds of the specified ports.
high_alarm - Specify high threshold for alarm. For the temperature threshold: when
the operating parameter rises above this value, action associated with alarm is
taken. The range of this parameter is -128 to 127.996 Celsius degrees. For the
voltage threshold: when the operating parameter rises above this value, action
associated with alarm is taken. The range of this parameter is 0 to 6.55 voltages.
For the bias current threshold: when the operating parameter rises above this value,
action associated with alarm is taken. The range of this parameter is 0 to 131 mA.
For the output power threshold: when the operating parameter rises above this
value, action associated with alarm is taken. The range of this parameter is 0 to

DGS-3700 Series Layer 2 Managed Gigabit Ethernet Switch CLI Reference Guide
Page | 17
config ddm ports
6.5535 mW. For the received power threshold: when the operating parameter rises
above this value, action associated with alarm is taken. The range of this parameter
is 0 to 6.5535 mW.
low_alarm - Specify low threshold for alarm. For the temperature threshold: when the
operating parameter falls below this value, action associated with alarm is taken.
The range of this parameter is -128 to 127.996 Celsius degrees. For the voltage
threshold: when the operating parameter falls below this value, action associated
with alarm is taken. The range of this parameter is 0 to 6.55 voltages. For the bias
current threshold: when the operating parameter falls below this value, action
associated with alarm is taken. The range of this parameter is 0 to 131 mA. For the
output power threshold: when the operating parameter falls below this value, action
associated with alarm is taken. The range of this parameter is 0 to 6.5535 mW. For
the received power threshold: when the operating parameter falls below this value,
action associated with alarm is taken. The range of this parameter is 0 to 6.5535
mW.
high_warning - Specify high threshold for warning. For the temperature threshold:
when the operating parameter rises above this value, action associated with
warning is taken. The range of this parameter is -128 to 127.996 Celsius degrees.
For the voltage threshold: when the operating parameter rises above this value,
action associated with warning is taken. The range of this parameter is 0 to 6.55
voltages. For the bias current threshold: when the operating parameter rises above
this value, action associated with warning is taken. The range of this parameter is 0
to 131 mA. For the output power threshold: when the operating parameter rises
above this value, action associated with warning is taken. The range of this
parameter is 0 to 6.5535 mW. For the received power threshold: when the
operating parameter rises above this value, action associated with warning is taken.
The range of this parameter is 0 to 6.5535 mW.
low_warning - Specify low threshold for warning. For the temperature threshold:
when the operating parameter falls below this value, action associated with
warning is taken. The range of this parameter is -128 to 127.996 Celsius degrees.
For the voltage threshold: when the operating parameter falls below this value,
action associated with warning is taken. The range of this parameter is 0 to 6.55
voltages. For the bias current threshold: when the operating parameter falls below
this value, action associated with warning is taken. The range of this parameter is 0
to 131 mA. For the output power threshold: when the operating parameter falls
below this value, action associated with warning is taken. The range of this
parameter is 0 to 6.5535 mW. For the received power threshold: when the
operating parameter falls below this value, action associated with warning is taken.
The range of this parameter is 0 to 6.5535 mW.
state - Specify the DDM state and/or DDM shutdown action when encountering an
exceeding alarm or warning threshold event.
enable - Enable the DDM state.
disable - Disable the DDM state. If the DDM state is disabled, no DDM action will
take effect.
shutdown - Specify whether or not to shut down the port on which the operating
parameter exceeds the corresponding alarm or warning threshold. Note that the
port being shut down cannot recover to normal operation automatically. Use the
config ports x state enable command to recover the port.
alarm - Specify whether or not to shut down the port, on which the operating
parameter exceeds the corresponding alarm threshold.
warning - Specify whether or not to shut down the port, on which the operating

DGS-3700 Series Layer 2 Managed Gigabit Ethernet Switch CLI Reference Guide
Page | 18
config ddm ports
parameter exceeds the corresponding warning threshold.
none - Specify whether or not to shut down the port regardless if the operating
parameter exceeds the corresponding alarm or warning threshold.
Restrictions
Only Administrator and Operator-level users can issue this command.
Example usage:
To configure port 9’s temperature threshold:
DGS-3700-12:5#config ddm ports 9 temperature_threshold high_alarm 84.9555 low_alarm -10
high_warning 70 low_warning 2.2525
Command: config ddm ports 9 temperature_threshold high_alarm 84.9555 low_alarm -10
high_warning 70 low_warning 2.2525
According to the DDM precision definition, closest value 84.9531 and 2.25 are chosen
Success.
DGS-3700-12:5#
To configure port 9’s voltage threshold:
DGS-3700-12:5#config ddm ports 9 voltage_threshold high_alarm 4.25 low_alarm 2.5
high_warning 3.5 low_warning 3
Command: config ddm ports 9 voltage_threshold high_alarm 4.25 low_alarm 2.5
high_warning 3.5 low_warning 3
Success.
DGS-3700-12:5#
To configure port 9’s bias current threshold:
DGS-3700-12:5#config ddm ports 9 bias_current_threshold high_alarm 7.25 low_alarm 0.004
high_warning 0.5 low_warning 0.008
Command: config ddm ports 25 bias_current_threshold high_alarm 7.25 low_alarm 0.004
high_warning 0.5 low_warning 0.008
Success.
DGS-3700-12:5#
To configure port 9’s transmit power threshold:
DGS-3700-12:5#config ddm ports 9 tx_power_threshold high_alarm 0.625 low_alarm 0.006
high_warning 0.55 low_warning 0.008
Command: config ddm ports 9 tx_power_threshold high_alarm 0.625 low_alarm 0.006
high_warning 0.55 low_warning 0.008
Success.
DGS-3700-12:5#
To configure port 9’s received power threshold:

DGS-3700 Series Layer 2 Managed Gigabit Ethernet Switch CLI Reference Guide
Page | 19
DGS-3700-12:5#config ddm ports 9 rx_power_threshold high_alarm 4.55 low_alarm 0.01
high_warning 3.5 low_warning 0.03
Command: config ddm ports 9 rx_power_threshold high_alarm 4.55 low_alarm 0.01
high_warning 3.5 low_warning 0.03
Success.
DGS-3700-12:5#
To configure the port 9 actions associated with alarm:
DGS-3700-12:5#config ddm ports 9 state enable shutdown alarm
Command: config ddm ports 9 state enable shutdown alarm
Success.
DGS-3700-12:5#
show ddm
Purpose To display the DDM global state.
Syntax
show ddm
Description This command is used to display the DDM global state.
Parameters None
Restrictions
OnlyAdministrator-level users can issue this command.
Example usage:
To display the DDM global state:
DGS-3700-12:5#show ddm
Command: show ddm
DDM Log :Enabled
DDM Trap :Disabled
Success.
DGS-3700-12:5#
show ddm ports
Purpose
To display DDM status or configuration.
Syntax show ddm ports {<portlist>} [status | configuration]
Description This command is used to display DDM status or configuration. The configuration
parameter displays the current configurations of the SFP modules. There are two
types of threshold, the administrative configuration and the operation configuration
threshold. For the SFP port, when a particular threshold was configured by user, it
will be shown on this command with a tag indicating that it is a threshold that the
user configured, else it will be the threshold read from the SFP module that is being
inserted.
Parameters <portlist> - Specify a range of ports to be displayed.
status - Specify to display the current operating DDM parameters values of the SFP
module of the specified port
configuration - Specify to display the current configurations of the digital diagnostics
monitoring function.

DGS-3700 Series Layer 2 Managed Gigabit Ethernet Switch CLI Reference Guide
Page | 20
show ddm ports
Restrictions
None.
Example usage:
To display the DDM status for ports 8 to 12:
DGS-3700-12:5#show ddm ports 8-12
Command: show ddm ports 8-12
Port Temperature Voltage Bias Current TX Power RX Power
(in Celsius) (V) (mA) (mW) (mW)
------ ------------ ---------- -------------- ---------- ------------
8 -----
9 -----
10 -----
11 -----
12 -----
DGS-3700-12:5##