Page 1
D-Link™ DGS-1100-06/ME Ver.A1
Metro Ethernet Managed Switch
CLI Reference Guide
V1.0
Page 2
Page 3
Information in this document is subject to change without notice.
© 2012 D-Link Computer Corporation. All rights reserved.
Reproduction in any manner whatsoever without the written permission of D-Link Computer Corporation
is strictly forbidden.
Trademarks used in this text: D-Link and the D-Link logo are trademarks of D-Link Computer
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 Computer Corporation disclaims any proprietary interest
in trademarks and trade names other than its own.
FCC Warning
This equipment has been tested and found to comply with the limits for a Class A digital device,
pursuant to Part 15 of the FCC Rules. These limits are designed to provide reasonable protection against
harmful interference when the equipment is operated in a commercial environment. This equipment
generates, uses, and can radiate radio frequency energy and, if not installed and used in accordance
with this user’s guide, may cause harmful interference to radio communications. Operation of this
equipment in a residential area is likely to cause harmful interference in which case the user will be
required to correct the interference at hisown expense.
CE Mark Warning
This is a Class A product. In a domestic environment, this product may cause radio interference in
which case the user may be required to take adequate measures.
Warnung!
Dies ist ein Produkt der Klasse A. Im Wohnbereich kann dieses Produkt Funkstoerungen verursachen. In
diesem Fall kann vom Benutzer verlangt werden, angemessene Massnahmen zu ergreifen.
Precaución!
Este es un producto de Clase A. En un entorno doméstico, puede causar interferencias de radio, en
cuyo case, puede requerirse al usuario para que adopte las medidas adecuadas.
Attention!
Ceci est un produit de classe A. Dans un environnement domestique, ce produit pourrait causer des
interférences radio, auquel cas l`utilisateur devrait prendre les mesures adéquates.
Attenzione!
Il presente prodotto appartiene alla classe A. Se utilizzato in ambiente domestico il prodotto può causare
interferenze radio, nel cui caso è possibile che l`utente debba assumere provvedimenti adeguati.
VCCI Warning
Oct, 2012
Page 4
Table of Contents
INTRODUCTION ...................................................................................................................................................... 1
USING THE COMMAND LINE INTERFACE ........................................................................................................... 2
COMMAND SYNTAX ............................................................................................................................................... 5
BASIC SWITCH COMMANDS ................................................................................................................................. 7
enable password encryption .................................................................................................................................................. 8
disable password encryption ................................................................................................................................................. 8
create account ........................................................................................................................................................................ 9
config account ......................................................................................................................................................................10
show account ........................................................................................................................................................................10
delete account .......................................................................................................................................................................11
save account .........................................................................................................................................................................11
show session .........................................................................................................................................................................12
show switch ..........................................................................................................................................................................12
enable web ...........................................................................................................................................................................13
disable web ...........................................................................................................................................................................13
enable autoconfig .................................................................................................................................................................14
disable autoconfig ................................................................................................................................................................14
show autoconfig ...................................................................................................................................................................15
show config ..........................................................................................................................................................................15
enable auto learning .............................................................................................................................................................16
disable auto learning ............................................................................................................................................................16
enable jumbo_frame .............................................................................................................................................................17
disable jumbo_frame ............................................................................................................................................................17
show jumbo_frame ...............................................................................................................................................................18
save ......................................................................................................................................................................................18
reboot ...................................................................................................................................................................................19
reset ................................................................................................................................................................ ......................20
logout ...................................................................................................................................................................................21
ping ......................................................................................................................................................................................21
ping6 ....................................................................................................................................................................................22
enable telnet .........................................................................................................................................................................23
disable telnet ........................................................................................................................................................................23
config time_range ................................................................................................................................................................24
show time_range ..................................................................................................................................................................25
show tech support .................................................................................................................................................................25
MODIFY BANNER AND PROMPT COMMANDS ................................................................................................. 27
config command_prompt .....................................................................................................................................................27
config greeting_message ......................................................................................................................................................28
show greeting_message ........................................................................................................................................................29
SWITCH PORT COMMANDS ................................................................................................................................ 30
config ports ..........................................................................................................................................................................30
delete ports ...........................................................................................................................................................................31
show ports ............................................................................................................................................................................31
show duld ports ....................................................................................................................................................................32
Page 5
LOOPBACK DETECTION COMMANDS ............................................................................................................... 33
enable loopdetect ..................................................................................................................................................................33
disable loopdetect .................................................................................................................................................................33
config loopdetect mode ........................................................................................................................................................34
config loopdetect ports ................................ ................................ ................................................................ .........................34
config loopdetect ..................................................................................................................................................................35
show loopdetect....................................................................................................................................................................35
PPPOE CIRCUIT ID INSERTION COMMANDS .................................................................................................... 37
config pppoe circuit_id_insertion state ................................................................................................................................37
config pppoe circuit_id_insertion ports ................................................................................................................................38
show pppoe circuit_id_insertion ..........................................................................................................................................38
show pppoe circuit_id_insertion ports .................................................................................................................................39
NETWORK MANAGEMENT (SNMP) COMMANDS ............................................................................................. 40
create snmp user ...................................................................................................................................................................42
delete snmp user ...................................................................................................................................................................42
show snmp user ................................................................................................................................ ....................................43
create snmp view ..................................................................................................................................................................43
delete snmp view ..................................................................................................................................................................44
show snmp view ...................................................................................................................................................................45
create snmp community .......................................................................................................................................................45
delete snmp community .......................................................................................................................................................46
show snmp community ........................................................................................................................................................46
config snmp engineID ..........................................................................................................................................................47
create snmp group ................................................................................................................................................................47
delete snmp group ................................................................................................................................................................49
show snmp groups ................................................................................................................................................................49
show snmp global state ........................................................................................................................................................50
create snmp host ...................................................................................................................................................................50
delete snmp host ...................................................................................................................................................................51
show snmp host ....................................................................................................................................................................52
create snmp v6host ...............................................................................................................................................................52
delete snmp v6host ...............................................................................................................................................................53
show snmp v6host ................................................................................................................................................................54
enable snmp traps .................................................................................................................................................................54
disable snmp traps ................................................................................................................................................................55
show snmp traps ...................................................................................................................................................................55
enable snmp authenticate trap ..............................................................................................................................................56
disable snmp authenticate trap .............................................................................................................................................56
config syslocation ................................................................................................................................................................56
config sysname .....................................................................................................................................................................57
config syslogintimeout .........................................................................................................................................................57
enable snmp .........................................................................................................................................................................57
disable snmp .........................................................................................................................................................................58
enable snmp fiber_port_link traps ................................................................................................ ........................................58
disable snmp fiber_port_link traps .......................................................................................................................................59
enable snmp LBD traps ........................................................................................................................................................59
disable snmp LBD traps .......................................................................................................................................................59
Page 6
enable snmp port_security_violation traps ...........................................................................................................................60
disable snmp port_security_violation traps ..........................................................................................................................60
enable snmp system_device_bootup traps ...........................................................................................................................61
disable snmp system_device_bootup traps...........................................................................................................................61
enable snmp twistedpair_port_link traps ..............................................................................................................................62
disable snmp twistedpair_port_link traps .............................................................................................................................62
DISCOVERY TRAP COMMANDS ......................................................................................................................... 63
enable discover_trap ............................................................................................................................................................64
disable discover_trap ............................................................................................................................................................64
enable discover_trap_event DeviceBoot ..............................................................................................................................64
disable discover_trap_event DeviceBoot .............................................................................................................................65
enable discover_trap_event FiberPort ..................................................................................................................................65
disable discover_trap_event FiberPort .................................................................................................................................66
enable discover_trap_event IllegalLogin .............................................................................................................................66
disable discover_trap_event IllegalLogin ............................................................................................................................67
enable discover_trap_event LBD .........................................................................................................................................67
disable discover_trap_event LBD ........................................................................................................................................67
enable discover_trap_event PortSecurity .............................................................................................................................68
disable discover_trap_event PortSecurity ............................................................................................................................68
enable discover_trap_event TwistedPairPort .......................................................................................................................69
disable discover_trap_event TwistedPairPort ......................................................................................................................69
show discover_trap ..............................................................................................................................................................69
DOWNLOAD/UPLOAD COMMANDS ................................................................................................................... 71
download ..............................................................................................................................................................................71
upload ...................................................................................................................................................................................72
DHCP RELAY COMMANDS .................................................................................................................................. 74
enable dhcp_relay ................................................................................................................................................................74
disable dhcp_relay ................................................................................................................................................................75
config dhcp_relay add ipif System .......................................................................................................................................75
config dhcp_relay delete ipif System ...................................................................................................................................76
config dhcp_relay .................................................................................................................................................................76
config dhcp_relay option_82 ................................................................................................................................................77
show dhcp_relay ..................................................................................................................................................................78
enable dhcp_local_relay .......................................................................................................................................................78
disable dhcp_local_relay ......................................................................................................................................................79
config dhcp_local_relay .......................................................................................................................................................79
show dhcp_local_relay .........................................................................................................................................................80
enable dhcpv6_relay ............................................................................................................................................................80
disable dhcp6_relay ..............................................................................................................................................................81
show dhcpv6_relay ..............................................................................................................................................................81
config dhcpv6_relay .............................................................................................................................................................82
config dhcpv6_relay hop_count ...........................................................................................................................................82
NETWORK MONITORING COMMANDS .............................................................................................................. 83
show packet ports .................................................................................................................................................................83
show error ports ...................................................................................................................................................................84
show utilization ....................................................................................................................................................................85
clear counters .......................................................................................................................................................................86
Page 7
clear log ................................................................................................................................................................................86
show log ...............................................................................................................................................................................86
save log ................................................................................................................................................................................87
enable syslog ........................................................................................................................................................................87
disable syslog .......................................................................................................................................................................88
show syslog ..........................................................................................................................................................................88
create syslog host .................................................................................................................................................................88
config syslog host.................................................................................................................................................................91
delete syslog host .................................................................................................................................................................93
show syslog host ..................................................................................................................................................................93
cable diagnostic port ............................................................................................................................................................94
FORWARDING DATABASE COMMANDS ........................................................................................................... 95
create fdb ..............................................................................................................................................................................95
create multicast_fdb .............................................................................................................................................................96
config multicast_fdb ............................................................................................................................................................96
config fdb aging_time ..........................................................................................................................................................97
delete fdb ..............................................................................................................................................................................97
enable flood_fdb ..................................................................................................................................................................98
disable flood_fdb..................................................................................................................................................................98
show flood_fdb ....................................................................................................................................................................99
clear flood_fdb .....................................................................................................................................................................99
show multicast_fdb ..............................................................................................................................................................99
show fdb .............................................................................................................................................................................100
config multicast filter .........................................................................................................................................................101
show multicast filter port_mode .........................................................................................................................................101
create auto_fdb ...................................................................................................................................................................102
delete auto_fdb ...................................................................................................................................................................102
show auto_fdb ....................................................................................................................................................................102
BROADCAST STORM CONTROL COMMANDS ............................................................................................... 104
config traffic control ..........................................................................................................................................................104
show traffic control ............................................................................................................................................................105
config traffic trap ...............................................................................................................................................................105
QOS COMMANDS ............................................................................................................................................... 107
config bandwidth_control ..................................................................................................................................................107
show bandwidth_control ................................................................................................................................ ....................108
config qos mode .................................................................................................................................................................108
show qos mode ...................................................................................................................................................................109
config cos ipv6_tc_mapping ..............................................................................................................................................109
show cos ipv6_tc_mapping ................................................................................................................................................110
delete cos ipv6_tc_mapping ...............................................................................................................................................110
config scheduling_mechanism ................................................................................................................................ ...........111
show scheduling_mechanism .............................................................................................................................................111
config dscp_mapping .........................................................................................................................................................112
show dscp_mapping ...........................................................................................................................................................112
RMON COMMANDS ............................................................................................................................................ 114
enable rmon ........................................................................................................................................................................114
disable rmon .......................................................................................................................................................................115
Page 8
create rmon alarm ...............................................................................................................................................................115
delete rmon alarm ...............................................................................................................................................................116
create rmon collection stats ................................................................................................................................................116
delete rmon collection stats ................................................................................................................................................117
create rmon collection history ............................................................................................................................................117
delete rmon collection history ............................................................................................................................................118
create rmon event ...............................................................................................................................................................118
delete rmon event ...............................................................................................................................................................119
show rmon ..........................................................................................................................................................................119
PORT MIRRORING COMMANDS ....................................................................................................................... 121
enable mirror ......................................................................................................................................................................121
disable mirror .....................................................................................................................................................................121
config mirror target ............................................................................................................................................................122
show mirror ........................................................................................................................................................................123
VLAN COMMANDS ............................................................................................................................................. 124
create vlan ..........................................................................................................................................................................124
delete vlan ..........................................................................................................................................................................125
config vlan .........................................................................................................................................................................125
config pvid .........................................................................................................................................................................126
show vlan ...........................................................................................................................................................................126
enable asymmetric_vlan .....................................................................................................................................................127
disable asymmetric_vlan ....................................................................................................................................................127
show asymmetric_vlan .......................................................................................................................................................127
enable management vlan ....................................................................................................................................................128
disable management vlan ...................................................................................................................................................128
config management vlan ....................................................................................................................................................129
show management vlan ......................................................................................................................................................129
show port_vlan pvid ...........................................................................................................................................................129
Q-IN-Q COMMANDS ............................................................................................................................................ 131
enable qinq .........................................................................................................................................................................131
disable qinq ........................................................................................................................................................................131
show qinq ...........................................................................................................................................................................132
config qinq ports ................................................................................................................................................................132
BASIC IP COMMANDS ........................................................................................................................................ 134
config ipif System ..............................................................................................................................................................134
show ipif.............................................................................................................................................................................135
MAC NOTIFICATION COMMANDS .................................................................................................................... 136
enable mac_notification .....................................................................................................................................................136
disable mac_notification ....................................................................................................................................................136
config mac_notification .....................................................................................................................................................137
config mac_notification ports ............................................................................................................................................137
show mac_notification .......................................................................................................................................................138
show mac_notification ports ..............................................................................................................................................138
IGMP SNOOPING COMMANDS.......................................................................................................................... 140
enable igmp_snooping .......................................................................................................................................................141
disable igmp_snooping.......................................................................................................................................................141
show igmp_snooping .........................................................................................................................................................142
Page 9
config igmp_snooping ........................................................................................................................................................142
config igmp_snooping querier ...........................................................................................................................................143
config igmp_snooping querier_selection ...........................................................................................................................144
config igmp_snooping robustness_variable .......................................................................................................................144
create igmp_snooping multicast_vlan ................................................................................................................................145
config igmp_snooping multicast_vlan ...............................................................................................................................145
delete igmp_snooping multicast_vlan ................................................................................................................................146
config igmp_snooping multicast_vlan_group ....................................................................................................................146
config router_ports .............................................................................................................................................................147
config igmp access_authentication ports ............................................................................................................................147
show igmp access_authentication ports .............................................................................................................................148
enable igmp_snooping multicast_vlan ...............................................................................................................................149
disable igmp_snooping multicast_vlan ..............................................................................................................................149
show igmp_snooping multicast_vlan .................................................................................................................................149
show igmp_snooping multicast_vlan_group ......................................................................................................................150
show igmp_snooping group ...............................................................................................................................................151
show igmp_snooping forwarding .......................................................................................................................................151
show igmp_snooping host ..................................................................................................................................................152
show igmp_snooping statistic counter ...............................................................................................................................152
clear igmp_snooping statistic counter ................................................................................................................................153
show router_port ................................................................................................................................................................154
MLD SNOOPING COMMANDS ........................................................................................................................... 155
enable mld_snooping .........................................................................................................................................................156
disable mld_snooping ........................................................................................................................................................156
config mld_snooping ..........................................................................................................................................................156
config mld_snooping mrouter_ports ..................................................................................................................................157
config mld_snooping querier .............................................................................................................................................158
enable mld_snooping multicast_vlan .................................................................................................................................159
disable mld_snooping multicast_vlan ................................................................................................................................159
create mld_snooping multicast_vlan ..................................................................................................................................160
delete mld_snooping multicast_vlan ..................................................................................................................................160
config mld_snooping multicast_vlan .................................................................................................................................160
config mld_snooping multicast_vlan_group ......................................................................................................................161
show mld snooping ............................................................................................................................................................162
show mld_snooping forwarding .........................................................................................................................................162
show mld_snooping group .................................................................................................................................................163
show mld_snooping mrouter_ports ....................................................................................................................................164
show mld_snooping statistic counter .................................................................................................................................164
clear mld_snooping statistics counter ................................................................................................................................165
show mld_snooping host ....................................................................................................................................................165
LIMITED IP MULTICAST ADDRESS COMMANDS ............................................................................................ 167
create mcast_filter_profile .................................................................................................................................................167
config mcast_filter_profile ................................................................................................................................ ................168
config mcast_filter_profile ipv6 ........................................................................................................................................168
delete mcast_filter_profile .................................................................................................................................................169
show mcast_filter_profile...................................................................................................................................................169
config limited_multicast_addr ports...................................................................................................................................170
show limited_multicast_addr ports ....................................................................................................................................171
Page 10
config max_mcast_group ports ..........................................................................................................................................171
show max_mcast_group ports ............................................................................................................................................172
802.1X COMMANDS ............................................................................................................................................ 173
enable 802.1x .....................................................................................................................................................................174
disable 802.1x ....................................................................................................................................................................174
show 802.1x .......................................................................................................................................................................175
show 802.1x auth_state ......................................................................................................................................................175
show 802.1x auth_configuration ........................................................................................................................................176
config 802.1x auth_parameter ports ...................................................................................................................................177
config 802.1x init ...............................................................................................................................................................178
config 802.1x auth_protocol ..............................................................................................................................................179
config 802.1x reauth ..........................................................................................................................................................179
config radius add ................................ ................................................................ ................................ ................................180
config radius delete ............................................................................................................................................................180
config radius .......................................................................................................................................................................181
show radius ........................................................................................................................................................................181
config 802.1x auth_mode ...................................................................................................................................................182
create 802.1x guest_vlan ....................................................................................................................................................182
delete 802.1x guest_vlan ....................................................................................................................................................183
config 802.1x guest_vlan ports ..........................................................................................................................................183
show 802.1x guest_vlan .....................................................................................................................................................184
create 802.1x user ..............................................................................................................................................................184
show 802.1x user................................................................................................................................................................185
delete 802.1x user ..............................................................................................................................................................185
config 802.1x capability ports ............................................................................................................................................186
config 802.1x fwd_pdu system ..........................................................................................................................................186
show 802.1x fwd_pdu system status ..................................................................................................................................187
PORT SECURITY COMMANDS .......................................................................................................................... 188
config port_security ...........................................................................................................................................................188
show port_security .............................................................................................................................................................189
PORT PRIORITY COMMANDS ........................................................................................................................... 190
config port_priority ............................................................................................................................................................190
show port_priority ..............................................................................................................................................................190
TIME AND SNTP COMMANDS ........................................................................................................................... 192
config sntp ..........................................................................................................................................................................192
show sntp ...........................................................................................................................................................................193
enable sntp .........................................................................................................................................................................193
disable sntp .........................................................................................................................................................................194
config time .........................................................................................................................................................................194
config time_zone operator ..................................................................................................................................................195
config dst ............................................................................................................................................................................195
show time ...........................................................................................................................................................................196
ARP COMMANDS ................................................................................................................................................ 198
config arp_aging time ........................................................................................................................................................198
clear arptable ......................................................................................................................................................................199
show arpentry .....................................................................................................................................................................199
show arpentry aging_time ..................................................................................................................................................200
Page 11
IPV6 NEIGHBOR DISCOVERY COMMANDS ..................................................................................................... 201
create ipv6 neighbor_cache ipif .........................................................................................................................................201
delete ipv6 neighbor_cache ipif .........................................................................................................................................202
show ipv6 neighbor_cache ipif ..........................................................................................................................................202
config ipv6 nd ns ipif .........................................................................................................................................................203
show ipv6 nd ipif System ...................................................................................................................................................203
create ipv6route default ......................................................................................................................................................204
delete ipv6route default ......................................................................................................................................................204
show ipv6route ...................................................................................................................................................................205
enable ipif_ipv6_link_local_auto System ..........................................................................................................................205
disable ipif_ipv6_link_local_auto System .........................................................................................................................206
BANNER COMMANDS ........................................................................................................................................ 207
config log_save_timing ......................................................................................................................................................207
show log_save_timing ........................................................................................................................................................208
show log_software_module ...............................................................................................................................................208
show log .............................................................................................................................................................................209
COMMAND HISTORY LIST COMMANDS .......................................................................................................... 210
? ..........................................................................................................................................................................................210
show command_history .....................................................................................................................................................211
dir .......................................................................................................................................................................................212
ACCESS AUTHENTICATION CONTROL COMMANDS .................................................................................... 213
create authen_login method_list_name ..............................................................................................................................214
config authen_login ............................................................................................................................................................214
delete authen_login method_list_name ..............................................................................................................................216
show authen_login .............................................................................................................................................................216
create authen_enable method_list_name ............................................................................................................................217
config authen_enable .........................................................................................................................................................217
delete authen_enable method_list_name ............................................................................................................................219
show authen_enable ...........................................................................................................................................................219
enable authen_policy ................................................................................................................................ ..........................220
disable authen_policy .........................................................................................................................................................220
show authen_policy ............................................................................................................................................................221
config authen application ...................................................................................................................................................221
show authen application .....................................................................................................................................................222
config authen parameter .....................................................................................................................................................222
show authen parameter .......................................................................................................................................................223
create authen server_host ...................................................................................................................................................223
config authen server_host ..................................................................................................................................................224
delete authen server_host ...................................................................................................................................................225
show authen server_host ....................................................................................................................................................226
create authen server_group ................................................................................................................................................227
config authen server_group ................................................................................................................................ ................227
delete authen server_group ................................................................................................................................................228
show authen server_group ..................................................................................................................................................229
enable admin ......................................................................................................................................................................229
config admin local_enable .................................................................................................................................................230
POWER SAVING COMMANDS ........................................................................................................................... 231
Page 12
config power_saving mode ................................................................................................................................................231
config power_saving ..........................................................................................................................................................231
show power_saving ............................................................................................................................................................232
LLDP COMMANDS .............................................................................................................................................. 234
enable lldp ................................................................................................ ................................................................ ..........235
disable lldp .........................................................................................................................................................................235
config lldp message_tx_interval.........................................................................................................................................235
config lldp message_tx_hold_multiplier ............................................................................................................................236
config lldp reinit_delay ......................................................................................................................................................236
config lldp tx_delay ...........................................................................................................................................................237
config lldp notification_interval .........................................................................................................................................237
show lldp ............................................................................................................................................................................237
show lldp ports ...................................................................................................................................................................238
show lldp local_ports .........................................................................................................................................................239
show lldp remote_ports ......................................................................................................................................................240
config lldp ports .................................................................................................................................................................240
config lldp ports .................................................................................................................................................................240
config lldp ports .................................................................................................................................................................241
config lldp ports .................................................................................................................................................................241
config lldp ports .................................................................................................................................................................242
config lldp ports .................................................................................................................................................................242
config lldp ports .................................................................................................................................................................243
config lldp ports .................................................................................................................................................................243
show lldp mgt_addr ............................................................................................................................................................244
show lldp statistics .............................................................................................................................................................244
TRAFFIC SEGMENTATION COMMANDS .......................................................................................................... 246
config traffic_segmentation ...............................................................................................................................................246
show traffic_segmentation .................................................................................................................................................246
ETHERNET OAM COMMANDS .......................................................................................................................... 248
config ethernet_oam ports (mode) .....................................................................................................................................249
config ethernet_oam ports (state) .......................................................................................................................................249
config ethernet_oam ports (link monitor error symbol) .....................................................................................................250
config ethernet_oam ports (link monitor error frame) .......................................................................................................251
config ethernet_oam ports (link monitor error frame seconds) ..........................................................................................252
config ethernet_oam ports (link monitor error frame period) ............................................................................................253
config ethernet_oam ports (remote loopback) ....................................................................................................................254
config ethernet_oam ports (received remote loopback) .....................................................................................................254
show ethernet_oam ports (status) .......................................................................................................................................256
show ethernet_oam ports (configuration)...........................................................................................................................257
show ethernet_oam ports (statistics) ..................................................................................................................................258
show ethernet_oam ports (event log) .................................................................................................................................259
clear ethernet_oam ports ....................................................................................................................................................260
SAFEGUARD COMMANDS ................................................................................................................................ 262
config safeguard_engine ....................................................................................................................................................262
show safeguard_engine ......................................................................................................................................................262
Page 13
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
1
INTRODUCTION
The DGS-1100-06/ME consists of 5 10/100/1000Mbps ports plus 1 100/100/SFP port.
The Switch can be managed through the Telnet or the Web-based management agent. The Command
Line Interface (CLI) can be used to configure and manage the Switch via the 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 Manual. For
detailed information on installing hardware please refer also to the Manual.
Setting the Switch’s IP Address
Each Switch must be assigned its own IP Address, which is used for communication with an SNMP
network manager or other TCP/IP application (for example BOOTP, TFTP). The Switch’s 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.
The Switch’s MAC address can also be found in the Web management program on the Switch Information
(Basic Settings) window in the Configuration folder.
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.
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.
Figure 1–1 Assigning an IP Address
In the above example, the Switch was assigned an IP address of 10.90.90.91 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 Webbased management agent using the above IP address to connect to the Switch.
1
Page 14
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
NOTE: Switch configuration settings are saved to non-volatile RAM using the save command.
The current configuration will then be retained in the Switch’s NV-RAM, and reloaded when the
Switch is rebooted. If the Switch is rebooted without using the save command, the last
configuration saved to NV-RAM is loaded.
2
USING THE COMMAND LINE INTERFACE
The Switch allows a computer or terminal to perform some basic monitoring and configuration tasks by
using the Command Line Interface (CLI) via TELNET protocol.
The command line functions are accessed over a Telnet interface. Once an IP address for the Switch has
been set, A Telnet program can be used (in VT-100 compatible terminal mode) to access and control the
Switch.
After the Switch reboots and you have to logged in, the console looks like this:
Figure 2–1 Initial Console Screen after Logging In
Commands are entered at the command prompt, DGS-1100-06/ME:5#
There are a number of helpful features included in the CLI. Entering the ? command displays a list of all
of the top-level commands.
Figure 2–2 The ? Command
When entering a command without its required parameters, the CLI displays the prompt: command:
config account message and the options listed below.
2
Page 15
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
Figure 2–3 Example Command Parameter Help
In this case, the command config account was entered with the parameter <username>. The CLI will then
prompt to enter the <username> with the message, command: config account. 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 subcommands, in sequential order, by pressing the ? key.
To re-enter the previous command at the command prompt, press the up arrow cursor key. The previous
command appears at the command prompt.
Figure 2–4 Using the Up Arrow to Re-enter a Command
In the above example, the command config account was entered without the required parameter
<username>, the CLI returned the command: config account 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. The < > can
also indicate a word with a number for character allowed.
If a command is entered that is unrecognized by the CLI, the top-level commands are displayed under
the Available commands: prompt.
3
Page 16
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
Figure 2–5 Available Commands
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, entering the show command with no additional parameters, the CLI will then display all of
the possible next parameters.
Figure 2–6 Next possible completions: Show Command
In the above example, all of the possible next parameters for the show command are displayed. At the
next command prompt in the example, 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.
4
Page 17
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
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
create account [admin | oper |user] <username 15>
Description
In the above syntax example, supply a username in the
<username> space. Do not type the angle brackets.
Example
Command
create account admin newadmin1
[square brackets]
Purpose
Encloses a required value or set of required arguments. One value
or argument can be specified.
Syntax
create account [admin | oper |user] <username 15>
Description
In the above syntax example, specify admin, oper or a user level
account to be created. Do not type the square brackets.
Example
Command
create account user newuser1
| vertical bar
Purpose
Separates two or more mutually exclusive items in a list, one of
which must be entered.
Syntax
create account [admin | oper | user] <username 15>
Description
In the above syntax example, specify admin, oper, or user. Do not
type the vertical bar.
Example
Command
create account user newuser1
3
COMMAND SYNTAX
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 Telnet uses
the same syntax.
All commands are case-sensitive. Be sure to disable Caps Lock or any other unwanted function that
changes text case.
5
Page 18
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
{braces}
Purpose
Encloses an optional value or set of optional arguments.
Syntax
reset
Description
execute “reset” will return the switch to its factory default setting.
Example
command
reset
Please be aware that all configuration will be reset to default value.
Are you sure you want to proceed with system reset now? (Y/N)[N] N
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.
Insert or Ctrl+R
Toggle on and off. When toggled on, inserts text and shifts previous
text to the right.
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 displays 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.
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.
6
Page 19
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
Command
Parameter
enable password
encryption
disable password
encryption
create account
[admin | operator | user] <username 15>
config account
<username 15>
show account
delete account
<username 15>
save account
show session
show switch
enable web
{<tcp_port_number 1-65535>}
disable web
enable autoconfig
disable autoconfig
show autoconfig
show config
[[config_in_nvram config_id <value 1-2>] | current_config] [begin | exclude]
<string 80>
enable auto learning
disable auto learning
enable jumbo_frame
disable jumbo_frame
show jumbo_frame
save
{[config config_id <value 1-2> | log | account]}
reboot
reset
{[config | system | account | password]} {force_agree}
logout
ping
<ipaddr> {times <value 1-255> | timeout <sec 1-99> | size <short 0-2080>}
ping6
<ipv6_addr> {frequency <sec 0-86400> | size <value 1-1522> | source_ip
<ipv6_addr> | timeout <sec 1-99> | times <value 1-255>}
enable telnet
4
BASIC SWITCH COMMANDS
The Basic Switch commands in the Command Line Interface (CLI) are listed (along with the appropriate
parameters) in the following table.
7
Page 20
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
Command
Parameter
disable telnet
config time_range
<range_name 20> [hours start_time <start_time 32> end_time <end_time 32>
weekdays <daylist 32> date from_day year <start_year 2011-2029> month
<start_mth 1-12> date <start_date 1-31> to_day year <end_year 2011-2029>
month <end_mth 1-12> date <end_date 1-31> | delete]
show time_range
show tech support
enable password encryption
Purpose
Used to enable password encryption on a user account.
Syntax
enable password encryption
Description
The user account configuration information will be stored in the
configuration file, and can be applied to the system at a time in the
future. If the password encryption is enabled, the password will be in
encrypted form. If password encryption is disabled and the user
specifies the password in encrypted form, or if the password has
been converted to encrypted form by the last enabled password
encryption command, the password will still be in encrypted form. It
can not revert back to plain text.
Parameters
None.
Restrictions
Only Administrator level users can issue this command.
DGS-1100-06/ME:5# enable password encryption
Command: enable password encryption
Success.
DGS-1100-06/ME:5#
disable password encryption
Purpose
Used to disable password encryption on a user account.
Syntax
disable password encryption
Description
The user account configuration information will be stored in the
configuration file, and can be applied to the system at a time in the
future. If the password encryption is enabled, the password will be in
encrypted form. If password encryption is disabled and the user
specifies the password in encrypted form, or if the password has
been converted to encrypted form by the last enabled password
encryption command, the password will still be in encrypted form. It
can not revert back to plain text.
Each command is listed in detail, as follows:
Example usage:
To enable password encryption on the Switch:
8
Page 21
Parameters
None.
Restrictions
Only Administrat level users can issue this command.
DGS-1100-06/ME:5# disable password encryption
Command: disable password encryption
Success.
DGS-1100-06/ME:5#
create account
Purpose
To create user accounts.
Syntax
create account [admin | operator | user | poweruser] <username
15>
Description
The create account command creates an administrator, operator,
or user account that consists of a username and an optional
password. Up to 31 accounts can be created. You can enter
username and Enter. In this case, the system prompts for the
account’s password, which may be between 0 and 15 characters.
Alternatively, you can enter the username and password on the
same line.
Parameters
admin − Name of the administrator account.
oper − Specify an operator level account.
user − Specify a user account with read-only permissions.
poweruser − Specify a power user level account.
<username 1-15> − The account username may be between 1 and
15 characters.
password <password_string> {encrypted} - the account password
can be included, and (optionally) can be encrypted.
Restrictions
Only Administrator level users can issue this command.
Usernames can be between 1 and 15 characters.
Passwords can be between 0 and 15 characters.
NOTE: You are not required to enter a User Name. However, if you do not enter a User Name,
you cannot perform the following actions:
Create a monitor or operator (level 1 or level 14) users until an administrator user (level 15) is
defined.
Delete the last administrator user if there are monitor and/or operator users defined.
DGS-1100-06/ME:5# create account admin dlink
Example usage:
To disable password encryption on the Switch:
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
Example usage:
To create an administrator-level user account with the username ‘dlink’:
9
Page 22
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
Command: create account admin dlink
Enter a case-sensitive new password:***
Enter the new password again for confirmation:***
Success.
DGS-1100-06/ME:5#
config account
Purpose
To change the password for an existing user account.
Syntax
config account <username 15>
Description
The config account command changes the password for a user
account that has been created using the create account command.
The system prompts for the account’s new password, which may be
between 0 and 15 characters.
Parameters
<username 15> − the account username.
Restrictions
Only Administrator-level users can issue this command.
DGS-1100-06/ME:5# config account dlink
Command: config account dlink
Enter a old password:***
Enter a case-sensitive new password:****
Enter the new password again for confirmation:****
Success.
DGS-1100-06/ME:5#
show account
Purpose
To display information about all user accounts on the Switch.
Syntax
show account
Description
The show account command displays all account usernames and
their access levels created on the Switch. Up to 31 user accounts
can exist on the Switch at one time.
Parameters
None.
Restrictions
None.
Example usage:
To configure the user password of ‘dlink’ account:
Example usage:
To display the account which have been created:
10
Page 23
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
DGS-1100-06/ME:5# show account
Command: show account
Username Access Level
------------------ ------------
dlink Admin
Total Entries : 1
DGS-1100-06/ME:5#
delete account
Purpose
To delete an existing user account.
Syntax
delete account <username 15>
Description
The delete account command deletes a user account that has been
created using the create account command.
Parameters
<username 15> − the account username.
Restrictions
Only Administrator-level users can issue this command.
DGS-1100-06/ME:5# delete account System
Command: delete account System
Success.
DGS-1100-06/ME:5#
save account
Purpose
To save an existing user account.
Syntax
save account
Description
The save account command saves all user account that has been
created using the create account command.
Parameters
None..
Restrictions
Only Administrator-level users can issue this command.
DGS-1100-06/ME:5# save account
Command: save account
DGS-1100-06/ME:5#
Example usage:
To delete the user account ‘System’:
Example usage:
To save the all user accounts:
11
Page 24
show session
Purpose
To display information about currently logged-in users.
Syntax
show session
Description
The show session command displays a list of all the users that are
logged-in at the time the command is issued. The information
includes the session ID (0 for the first logged-in user, 1 for the next
logged-in user, etc.), the Protocol used to connect to the Switch, the
user’s IP address, the user’s access Level (1=user, 15=admin), and
the account name on the Switch.
Parameters
None.
Restrictions
None.
Example usage:
DGS-1100-06/ME:5# show session
Command: show session
Total Entries: 1
ID Login Time Live Time From Level Name
-- ----------------------------- ----------- --------------- ----- ---------------
0 Jan 1 01:04:08 2012 00:11:05 14 root
Total Entries: 1
CTRL+C ESC q Quit SPACE n Next Page p Previous Page r Refresh
show switch
Purpose
To display information about the Switch.
Syntax
show switch
Description
The show switch command displays information about the Switch
settings, including Device Type, MAC Address, IP configuration,
Hardware/Software version, System information, and Switch
Network configuration.
Parameters
None.
Restrictions
None.
DGS-1100-06/ME:5# show switch
Command: show switch
System name :
System Contact :
System Location :
To display the way users logged in:
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
Example usage:
To display the Switch information:
12
Page 25
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
System up time : 0 days, 0 hrs, 20 min, 28 secs
System Time : 01/01/2012 00:20:30
System hardware version : A1
System firmware version : 1.00.008
System boot version : 1.00.000
System Protocol version : 2.001.004
System serial number : 1MB1733K0000A
MAC Address : 00-AE-B7-21-22-62
SNMP Status : Enabled
Port Mirroring : Disabled
802.1X Status : Disabled
Storm Control : Disabled
802.1Q Management VLAN : Disabled
Safeguard Engine : Enabled
IGMP Snooping : Disabled
DGS-1100-06/ME:5#
enable web
Purpose
To enable the HTTP-based management software on the Switch.
Syntax
enable web {<tcp_port_number 1-65535>}
Description
The enable web command enables the Web-based management
software on the Switch. The user can specify the TCP port number
the Switch uses to listen for Telnet requests.
Parameters
<tcp_port_number 1-65535> − The TCP port number. TCP ports are
numbered between 1 and 65535. The ‘well-known’ port for the Webbased management software is 80.
Restrictions
Only Administrator or operator-level users can issue this command.
DGS-1100-06/ME:5# enable web
Command: enable web
Success.
DGS-1100-06/ME:5#
disable web
Purpose
To disable the HTTP-based management software on the Switch.
Syntax
disable web
Description
The disable web command disables the Web-based management
software on the Switch.
Parameters
None.
Restrictions
Only Administrator or operator-level users can issue this command.
Example usage:
To enable HTTP and configure the TCP port number to listen for Telnet requests:
13
Page 26
Example usage:
DGS-1100-06/ME:5# disable web
Command: disable web
Success.
DGS-1100-06/ME:5#
enable autoconfig
Purpose
Used to activate the auto configuration function for the Switch. This
will load a previously saved configuration file for current use.
Syntax
enable autoconfig
Description
When autoconfig is enabled on the Switch, the DHCP reply will
contain a configuration file and path name. It will then request the file
from the TFTP server specified in the reply. When autoconfig is
enabled, the ipif settings will automatically become DHCP client.
Parameters
None.
Restrictions
When autoconfig is enabled, the Switch becomes a DHCP client
automatically (same as: config ipif System dhcp). The DHCP server
must have the TFTP server IP address and configuration file name,
and be configured to deliver this information in the data field of the
DHCP reply packet. The TFTP server must be running and have the
requested configuration file in its base directory when the request is
received from the Switch. Consult the DHCP server and TFTP
server software instructions for information on loading a
configuration file.
If the Switch is unable to complete the auto configuration process
the previously saved local configuration file present in Switch
memory will be loaded.
DGS-1100-06/ME:5# enable autoconfig
Command: enable autoconfig
Success.
DGS-1100-06/ME:5#
disable autoconfig
Purpose
Use this to deactivate auto configuration from DHCP.
Syntax
disable autoconfig
Description
The disable autoconfig command is used to instruct the Switch not
to accept auto configuration instruction from the DHCP server. This
does not change the IP settings of the Switch. The ipif settings will
continue as DHCP client until changed with the config ipif command.
Parameters
None.
To disable HTTP-based management software on the Switch:
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
Example usage:
To enable auto configuration on the Switch:
14
Page 27
Restrictions
Only Administrator-level users can issue this command. .
Example usage:
DGS-1100-06/ME:5# disable autoconfig
Command: disable autoconfig
Success.
DGS-1100-06/ME:5#
show autoconfig
Purpose
Used to display the current autoconfig status of the Switch.
Syntax
show autoconfig
Description
The show autoconfig command is used to list the current status of
the auto configuration function.
Parameters
None.
Restrictions
None.
DGS-1100-06/ME:5# show autoconfig
Command: show autoconfig
Autoconfig State: Enabled
DGS-1100-06/ME:5#
show config
Purpose
To display the current or saved version of the configuration settings
of the Switch.
Syntax
show config [[config_in_nvram config_id <value 1-2>] |
current_config] [begin | exclude] <string 80>
Description
The show config command is used to list the current status of the
configuration settings of the Switch.
Parameters
config_in_nvram config_id <value 1-2> − Display the system
configuration from NV-RAM.
current_config − Display system configuration from the DRAM
database, i.e. the current system setting.
[begin | exclude] − Display the configuration which is begined or
excluded.
<string 80> − Display the configuration which begin or exclude the
specified string. The maximum string is 80.
Restrictions
None.
To stop the auto configuration function:
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
Example usage:
To display the autoconfig status:
Example usage:
To display the autoconfig status:
15
Page 28
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
#-------------------------------------------------------------------- -------------------------------
# DGS-1100-06/ME Gigabit Ethernet Switch Configuration
#
# Firmware: Build 1.00.011
# Copyright(C) 2010 D-Link Corporation. All rights reserved.
#--------------------------------------------------------------------------------------------------
command-start
# Basic
config syslogintimeout 5
config sysgroupinterval 120
enable web 80
config arp_aging time 5
config fdb aging_time 300
enable telnet 23
# Vlan
disable asymmetric_vlan
create vlan default
config vlan vlanid 1 add untagged 1-6
config multicast filter 1 forward
config multicast filter 2 forward
CTRL+C ESC q Quit SPACE n Next Page ENTER Next Entry a ALL
enable auto learning
Purpose
To enable the MAC address auto learning on the switch.
Syntax
enable auto learning
Description
The enable auto learing command enables the MAC address auto
learning feature on the Switch.
Parameters
None.
Restrictions
Only administrator-level users can issue this command.
DGS-1100-06/ME:5# enable auto learning
Command: enable auto learning
Success
DGS-1100-06/ME:5#
disable auto learning
Purpose
To disable the MAC address auto learning of the switch.
Syntax
disable auto learning
Example usage:
To enable auto learning on the Switch:
16
Page 29
Description
The disable auto learing command disables the MAC address auto
learning feature on the Switch.
Parameters
None.
Restrictions
Only administrator-level users can issue this command.
Example usage:
DGS-1100-06/ME:5# disable auto learning
Command: disable auto learning
Success
DGS-1100-06/ME:5#
enable jumbo_frame
Purpose
To enable jumbo frames on the device.
Syntax
enable jumbo_frame
Description
The enable jumbo_frame command enables jumbo frames on the
device.
Parameters
None.
Restrictions
Only Administrator or operate-level users can issue this command.
Jumbo frames will be enabled after save and restart.
DGS-1100-06/ME:5# enable jumbo_frame
Command: enable jumbo_frame.
Success.
DGS-1100-06/ME:5#
disable jumbo_frame
Purpose
To disable jumbo frames on the device.
Syntax
disable jumbo_frame
Description
The disable jumbo_frame command disables jumbo frames on the
device.
Parameters
None.
Restrictions
Only Administrator or operate-level users can issue this command.
Jumbo frames will be disabled after save and restart.
DGS-1100-06/ME:5# disable jumbo_frame
To disable auto learning on the Switch:
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
Example usage:
To enable jumbo frames:
Example usage:
To disable jumbo_frames:
17
Page 30
Command: disable jumbo_frame
Success.
DGS-1100-06/ME:5#
show jumbo_frame
Purpose
To display the jumbo frame configuration.
Syntax
show jumbo_frame
Description
The show jumbo_frame command displays the jumbo frame
configuration.
Parameters
None.
Restrictions
None.
DGS-1100-06/ME:5# show jumbo_frame
Command: show jumbo_frame
Jumbo frame is enable.
Success
DGS-1100-06/ME:5#
save
Purpose
To save changes in the Switch’s configuration to non-volatile RAM.
Syntax
save {[config config_id <value 1-2> | log | account]}
Description
The save command used to enter the current switch configuration
into non-volatile RAM. The saved switch configuration will be loaded
into the Switch’s memory each time the Switch is restarted.
Parameters
config – Used to save the current configuration to a file.
config_id <value 1-2> - Specifies which cfg file ID if cfg ID is not
specified, it refers to the boot_up CFG file.
log – Used to save the current log to a file. The log file cannot be
deleted.
account – Used to save the account to a file.
Restrictions
Only administrator-level users can issue this command.
Example usage:
To show the jumbo_frames configuration status on the device:
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
Example usage:
To save the Switch’s current configuration to non-volatile RAM:
18
Page 31
DGS-1100-06/ME:5# save
Command: save
Building configuration ...
[OK]
DGS-1100-06/ME:5#
reboot
Purpose
To reboot the Switch.
Syntax
reboot
Description
The reboot command restarts the Switch.
Parameters
None.
Restrictions
Only Administrator or operate-level users can issue this command.
DGS-1100-06/ME:5# reboot
Command: reboot
Are you sure you want to proceed with the system reboot?(y/n)y
% Please wait, the switch is rebooting...
DGS-1100-06/ME:5#
DGS-1100-06/ME:5# System will Reboot....
Boot Procedure
--------------------------------------------------------------------------------
PP_init for CAMEO DGS-1100-06ME(instead of EEPROM)
Please wait, loading Runtime image ........................ 100%
MAC Address : 00-AE-B7-21-22-62
H/W Version : Rev.A1
F/W Version : 1.00.008
...........................................
DGS-1100-06/ME Gigabit Ethernet Switch
Command Line Interface
Copyright(C) 2012 D-Link Corporation. All rights reserved.
DGS-1100-06/ME login:
Example usage:
To restart the Switch:
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
19
Page 32
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
reset
Purpose
To reset the Switch to the factory default settings.
Syntax
reset {[config | system | account | password]} {force_agree}
Description
The reset command restores the Switch’s configuration to the
default settings assigned from the factory.
Parameters
config - If the keyword ‘config’ is specified, all of the factory default
settings are restored on the Switch including the IP address, user
accounts, and the switch history log. The Switch will not save or
reboot.
system − If the keyword ‘system’ is specified all of the factory default
settings are restored on the Switch. The Switch will save and reboot
after the settings are changed to default. Rebooting will clear all
entries in the Forwarding Data Base.
account − If the keyword ‘account is specified, all of the factory
default account settings are restored on the Switch.
password − If the keyword ‘password is specified, all of the factory
default password settings are restored on the Switch.
{force_agree} - When force_agree is specified, the reset command
will be executed immediately without further confirmation.
If no parameter is specified, the Switch’s current IP address, user
accounts, and the switch history log are not changed. All other
parameters are restored to the factory default settings. The Switch
will not save or reboot.
Restrictions
Only administrator-level users can issue this command.
Example usage:
To restore all of the Switch’s parameters to their default values:
20
Page 33
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
DGS-1100-06/ME:5# reset system
Command: reset system
Are you sure you want to proceed with the system reset, save and
reboot?(y/n)y
% Success.
DGS-1100-06/ME:5# System will Reboot....
Boot Procedure
-------------------------------------------------------------------------------
PP_init for CAMEO DGS-1100-06ME(instead of EEPROM)
Please wait, loading Runtime image ........................ 100%
MAC Address : 00-AE-B7-21-22-62
H/W Version : Rev.A1
F/W Version : 1.00.008
...........................................
DGS-1100-06/ME Gigabit Ethernet Switch
Command Line Interface
Copyright(C) 2012 D-Link Corporation. All rights reserved.
DGS-1100-06/ME login:
logout
Purpose
To log out a user from the Switch.
Syntax
Logout
Description
The logout command terminates the current user’s session on the
Switch.
Parameters
None.
Restrictions
None.
DGS-1100-06/ME:5# logout
ping
Purpose
To test the connectivity between network devices.
Syntax
ping <ipaddr> {times <value 1-255> | timeout <sec 1-99> | size
<short 0-2080>}
Description
The ping command sends Internet Control Message Protocol
(ICMP) echo messages to a remote IP address. The remote IP
Example usage:
To terminate the current user’s Telnet session:
21
Page 34
address then ‘echos’ or returns the message. This is used to confirm
connectivity between the Switch and the remote device.
Parameters
<ipaddr> - The IP address of the host.
times <value 1-255> - The number of individual ICMP echo
messages to be sent. The maximum value is 255. The default is 4.
timeout <sec 1-99> - The time-out period while waiting for a
response from the remote device. A value of 1 to 99 seconds can be
specified. The default is 1 second.
size <short 0-2080> - Specify the size of the test packet. A value of
0 to 2080 can be specified.
Restrictions
None.
Example usage:
DGS-1100-06/ME:5#ping 10.6.150.34 times 3
Command: ping 10.6.150.34 times 3
Reply Not Received From : 10.6.150.34, Timeout : 5 secs
Reply Not Received From : 10.6.150.34, Timeout : 5 secs
Reply Not Received From : 10.6.150.34, Timeout : 5 secs
--- 10.6.150.34 Ping Statistics ---
3 Packets Transmitted, 0 Packets Received, 100% Packets Loss
DGS-1100-06/ME:5#
ping6
Purpose
To test the IPv6 connectivity between network devices.
Syntax
ping6 <ipv6_addr> {frequency <sec 0-86400> | size <value 11522> | source_ip <ipv6_addr> | timeout <sec 1-99> | times
<value 1-255>}
Description
The ping6 command sends 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.
Parameters
<ipv6_addr> - The IPv6 address of the host.
frequency <sec 0-86400> - The number of seconds to wait before
repeating a ping test as defined by the value of this parameter.
A single ping test consists of a series of ping probes. The number of
probes is determined by the value of the parameter times. After a
single test completes the number of seconds as defined by the value
of frequency must elapse before the next ping test is started.
A value of 0 for this parameter implies that the test as defined by the
corresponding entry will not be repeated.
size <value 1-1522> - Specify the size of the test packet. A value of
1 to 1522 can be specified.
source_ip <ipv6_addr > - Specify the source IPv6 address of the
ping packets. If specified this parameter, this IPv6 address will be
used as the packets’ source IPv6 address that ping6 sends to the
remote host.
To ping the IP address 10.6.150.34 three times:
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
22
Page 35
timeout <sec 1-99> - The time-out period while waiting for a
response from the remote device. A value of 1 to 99 seconds can be
specified. The default is 1 second.
times <value 1-255> - The number of individual ICMP echo
messages to be sent. The maximum value is 255. The default is 4.
Restrictions
None.
Example usage:
DGS-1100-06/ME:5#ping6 3000::1 times 4
Command: ping6 3000::1 times 4
Reply From : 3000::1, bytes=200, time<10ms
Reply From : 3000::1, bytes=200, time<10ms
Reply From : 3000::1, bytes=200, time<10ms
Reply From : 3000::1, bytes=200, time<10ms
--- 3000::1 Ping Statistics ---
4 Packets Transmitted, 4 Packets Received, 0% Packets Loss
DGS-1100-06/ME:5#
enable telnet
Purpose
To enable the telnet.
Syntax
enable telnet
Description
The enable telnet command enables telnet.
Parameters
None.
Restrictions
Only Administrator or operate-level users can issue this command
DGS-1100-06/ME:5#enable telnet
Command: enable telnet
Success.
DGS-1100-06/ME:5#
disable telnet
Purpose
To disable telnet.
Syntax
disable telnet
Description
The disable telnet command disables telnet.
Parameters
None.
Restrictions
Only Administrator or operate-level users can issue this command
To ping the IPv6 address to “3000::1” four times:
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
Example usage:
To enable telnet:
Example usage:
23
Page 36
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
DGS-1100-06/ME:5#disable telnet
Command: disable telnet
Success.
DGS-1100-06/ME:5#
config time_range
Purpose
To configure the time range on the Switch..
Syntax
config time_range <range_name 20> [[hours start_time
<start_time 32> end_time <end_time 32> weekdays <daylist 32>
date from_day year <start_year 2011-2029> month <start_mth 112> date <start_date 1-31> to_day year <end_year 2011-2029>
month <end_mth 1-12> date <end_date 1-31>] | delete]
Description
The config time_range command defines time ranges for access
lists. If the end time is earlier than the start time, the end time will
move to the following day
Parameters
<range_name 20> – Specifies the time range name. The range of
characters is 1 - 20.
start_time <start_time 32> – defines the time on which the time
range will start to be active.
end_time <end_time 32 >– defines the time on which the time range
will stop to be active.
weekdays <daylist 32> – defines the days of the week on which the
time range will be active.
<start_year 2011-2029 > – Specifies the time range start year.
<start_mth 1-12> – Specifies the time range start month.
<start_date 1-31> – Specifies the time range start date.
<end_year 2011-2029 > – Specifies the time range end year.
<end _mth 1-12> – Specifies the time range end month.
<end _date 1-31> – Specifies the time range end date.
delete – Delete the time range settings.
Restrictions
Only Administrator or operator-level users can issue this command.
DGS-1100-06/ME:5# config time_range dd hours start_time 00:22 end_time
12:34 weekdays tue-fri date from_day year 2012 month 1 date 1 to_day year
2012 month 1 date 3
Command: config time_range dd hours start_time 00:22 end_time 12:34
weekdays tue-fri date from_day year 2012 month 1 date 1 to_day year 2012
month 1 date 3
Success!
DGS-1100-06/ME:5#
To disable telnet:
Example usage:
To configure the time range on the Switch:
24
Page 37
show time_range
Purpose
To display the currently configured access profiles on the Switch.
Syntax
show time_range
Description
The show time_range command displays the time range
configuration.
Parameters
None.
Restrictions
None.
Example usage:
DGS-1100-06/ME:5# show time_range
Range name : xxx
Start time : 10:00
End time : 11:00
Days : wed sun
Total Entries : 1
DGS-1100-06/ME:5#
show tech support
Purpose
To display system and configuration information. to provide to the
Technical Assistance Center when reporting a problem, use the
show tech-support command.
Syntax
show tech support
Description
The show tech support command displays system and
configuration information. to provide to the Technical Assistance
Center when reporting a problem.
By default, this command displays the output for technical-supportrelated show commands. Use keywords to specify the type of
information to be displayed. If you do not specify any parameters,
the system displays all configuration and memory data.
The show tech support command may time out if the configuration
file output takes longer to display than the configured session
timeout time. If this happens, enter a set logout timeout value of 0 to
disable automatic disconnection of idle sessions or enter a longer
timeout value.
The show tech support command output is continuous; it does not
display one screen at a time. To interrupt the output, press Esc.
Parameters
None.
Restrictions
None.
DGS-1100-06/ME:5#show tech support
Command: show tech support
- System Info. -
To display time range settings on the Switch:
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
Example usage:
To display technical support information on the Switch:
25
Page 38
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
System name :
System Contact :
System Location :
System up time : 0 days, 0 hrs, 7 min, 12 secs
System Time : 01/01/2012 00:07:14
System hardware version : A1
System firmware version : 1.00.008
System boot version : 1.00.000
System Protocol version : 2.001.004
System serial number : 1MB1733K0000A
MAC Address : 00-AE-B7-21-22-62
SNMP Status : Enabled
Port Mirroring : Disabled
802.1X Status : Disabled
Storm Control : Disabled
802.1Q Management VLAN : Disabled
Safeguard Engine : Enabled
IGMP Snooping : Disabled
CTRL+C ESC q Quit SPACE n Next Page ENTER Next Entry a ALL
26
Page 39
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
Command
Parameter
config
command_prompt
[<string 32> | default | username]
config
greeting_message
{default}
show
greeting_message
config command_prompt
Purpose
To configure the command prompt.
Syntax
config command_prompt [<string 32> | default | username]
Description
The config command_prompt command configures the command
prompt.
Parameters
<string 32> – The command prompt can be changed by entering a
new name of no more that 32 characters.
default – The command prompt will reset to factory default command
prompt. Default = the name of the Switch model, for example “DGS1100-06/ME”.
username – The command prompt will be changed to the login
username.
Restrictions
Only Administrator-level users can issue this command. Other
restrictions include:
If the “reset” command is executed, the modified command prompt
will remain modified. However, the “reset config/reset system”
command will reset the command prompt to the original factory
banner.
DGS-1100-06/ME:5#config command_prompt AtYourService
Command: config command_prompt AtYourService
Success.
AtYourService:5#
5
MODIFY BANNER AND PROMPT COMMANDS
The Modify Banner and Prompt commands in the Command Line Interface (CLI) are listed (along with the
appropriate parameters) in the following table.
Each command is listed in detail, as follows:
Example usage:
To modify the command prompt to “AtYourService”:
27
Page 40
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
config greeting_message
Purpose
Used to configure the login banner (greeting message).
Syntax
config greeting_message {default}
Description
The config greeting_message command to modify the login
banner (greeting message).
Parameters
default – If the user enters default to the modify banner command,
then the banner will be reset to the original factory banner.
To open the Banner Editor, click Enter after typing the config
greeting_message command. Type the information to be displayed
on the banner by using the commands described on the Banner
Editor:
Quit without save: Ctrl+C
Save and quit: Ctrl+W
Move cursor: Left/Right/Up/Down
Delete line: Ctrl+D
Erase all setting: Ctrl+X
Reload original setting: Ctrl+L
Restrictions
Only Administrator-level users can issue this command. Other
restrictions include:
If the “reset” command is executed, the modified banner will remain
modified. However, the “reset config/reset system” command will
reset the modified banner to the original factory banner.
The capacity of the banner is 6*80. 6 Lines and 80 characters per
line.
Ctrl+W will only save the modified banner in the DRAM. Users need
to type the “save config/save all” command to save it into Flash.
Only valid in threshold level.
To the banner:DGS-1100-06/ME:5#
Command: config greeting_message
Greeting Messages Editor
===========================================================
DGS-1100-06/ME Gigabit Ethernet Switch
Command Line Interface
Copyright(C) 2012 D-Link Corporation. All rights reserved.
============================================================
<Function Key> <Control Key>
Ctrl+C Quit without save left/right/
Ctrl+W Save and quit up/down Move cursor
Ctrl+D Delete line
Ctrl+X Erase all setting
Ctrl+L Reload original setting
Example usage:
28
Page 41
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
show greeting_message
Purpose
Used to view the currently configured greeting message configured
on the Switch.
Syntax
show greeting_message
Description
The show greeting_message command is used to view the
currently configured greeting message on the Switch.
Parameters
None.
Restrictions
None.
DGS-1100-06/ME:5#show greeting_message
Command: show greeting_message
DGS-1100-06/ME Gigabit Ethernet Switch
Command Line Interface
Copyright(C) 2012 D-Link Corporation. All rights reserved.
DGS-1100-06/ME:5#
Example usage:
To view the currently configured greeting message:
29
Page 42
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
Command
Parameter
config ports
[all | <portlist>] medium_type [copper | fiber_100 | fiber_1G] MDI/MDIX [MDI |
MDIX | auto] {description <desc 32> | flow_control [enable | disable] | learning
[enable | disable] | state [enable | disable] | speed [auto | 1000_full | 10_half |
100_full | 100_half | 10_full | 10_half]}
delete ports
[<portlist> | all] medium_type [copper | fiber_100 | fiber_1G] description
show ports
{<portlist> | all} {description | err_disabled}
show duld ports
{all | <portlist>}
config ports
Purpose
To configure the Switch’s Ethernet port settings.
Syntax
config ports [all | <portlist>] medium_type [copper | fiber_100 |
fiber_1G] MDI/MDIX [MDI | MDIX | auto] {description <desc 32> |
flow_control [enable | disable] | learning [enable | disable] |
state [enable | disable] | speed [auto | 1000_full | 10_half |
100_full | 100_half | 10_full | 10_half]}
Description
The config ports command configures the Switch’s Ethernet port
settings. Only the ports listed in the <portlist> are affected.
Parameters
<portlist> − A port or range of ports to be configured.
all − Configures all ports on the Switch.
medium_type [copper | fiber_100 | fiber_1G] − If configuring the
Combo ports, this defines the type of medium being configured.
MDI/MDIX [MDI | MDIX | j auto] − Specifies the MDI or MDIX setting
of the port. The MDIX setting can be auto, normal or cross.
If set to normal state, the port in MDIX mode, can be connected to
PC NIC using a straight cable. If set to cross state, the port in mdi
mode, can be connected to a port (in mdix mode) on another switch
through a straight cable.
description <desc 32> − Enter and alphanumeric string of no more
that 32 characters to describe a selected port interface.
flow_control [enable] – Enables flow control for the specified ports.
flow_control [disable] – Disables flow control for the specified ports.
learning [enable | disable] c Enables or disables the MAC address
learning on the specified range of ports.
state [enable | disable] − Enables or disables the specified range of
ports.
speed – Sets the speed of a port or range of ports, with the addition
of one of the following:
6
SWITCH PORT COMMANDS
The Switch Port commands in the Command Line Interface (CLI) are listed (along with the appropriate
parameters) in the following table.
Each command is listed in detail, as follows:
30
Page 43
auto − Enables auto-negotiation for the specified range of
ports.
[10 | 100 | 1000] − Configures the speed in Mbps for the
specified range of ports.
[half | full] − Configures the specified range of ports as either
full or half-duplex.
Restrictions
Only administrator or operate-level users can issue this command.
DGS-1100-06/ME:5#config ports 1-3 medium_type copper speed 100_full learning
enable state enable
Command: config ports 1-3 medium_type copper speed 100_full learning enable
state enable
Success
DGS-1100-06/ME:5#
delete ports
Purpose
To delete the description of current configuration port.
Syntax
delete ports [<portlist> | all] medium_type [copper | fiber_100 |
fiber_1G] description
Description
The delete ports command deletes the description of current
configuration port or range of ports.
Parameters
[<portlist> | all] − All port or range of ports whose settings are to be
removed.
medium_type [copper | fiber_100 | fiber_1G] − If configuring the
Combo ports, this description the type of medium being removed.
Restrictions
Only administrator or operate-level users can issue this command.
DGS-1100-06/ME:5# delete ports 3 medium_type copper description
Command: delete ports 3 medium_type copper description
DGS-1100-06/ME:5#
show ports
Purpose
To display the current configuration of a range of ports.
Syntax
show ports {<portlist> | all} {description | err_disabled}
Description
The show ports command displays the current configuration of a
port or range of ports.
Parameters
<portlist> − A port or range of ports whose settings are to be
displayed.
all – Specifies all ports to be displayed.
Example usage:
To configure the speed of ports 1-3 to be 100 Mbps, full duplex, learning and state enabled:
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
Example usage:
To delete the description of port 3 on the Switch:
31
Page 44
Restrictions
None.
Example usage:
DGS-1100-06/ME:5# show ports 3
Command: show ports 3
Port State/ Settings Connection Address
Type MDI Speed/Duplex/FlowCtrl Speed/Duplex/FlowCtrl Learning
----- ------ ---- -------------------------------- -------------------------------- ------------
3 Enabled 100M/Full/Enabled Link Down Enabled
MDI
DGS-1100-06/ME:5#
show duld ports
Purpose
To display the Switch’s Ethernet duld port settings.
Syntax
show duld ports {all | <portlist>}
Description
The show duld ports command displays the Switch’s Ethernet duld
port settings.
Parameters
{all | <portlist>} − Specifies all ports or range of ports to be
displayed.
Restrictions
None.
DGS-1100-06/ME:5# show duld ports
Command: show duld ports
port Admin State Oper Status Mode Link Status Discovery Time(Sec)
----- ----------------- ---------------- -------- ----------------- ----------------------------
1 Disabled Disabled Normal Unknown 5
2 Disabled Disabled Normal Unknown 5
3 Disabled Disabled Normal Unknown 5
4 Disabled Disabled Normal Unknown 5
5 Disabled Disabled Normal Unknown 5
6 Disabled Disabled Normal Unknown 5
DGS-1100-06/ME:5#
To display the configuration of port 3 on the Switch:
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
Example usage:
To display the Switch’s Ethernet duld port settings.
32
Page 45
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
Command
Parameter
enable loopdetect
disable loopdetect
config loopdetect mode
[portbase | vlanbase]
config loopdetect ports
[<portlist> | all] [enable | disable]
config loopdetect
interval_time <value 1-32767> lbd_recover_time [0 | <value 60-1000000>]
show loopdetect
{ports [<portlist> | all]}
enable loopdetect
Purpose
To enable the loop back detection on the Switch.
Syntax
enable loopdetect
Description
The enable loopdetect command enables the loop back detection
on the Switch.
Parameters
None.
Restrictions
Only administrator or operate-level users can issue this command.
DGS-1100-06/ME:5#enable loopdetect
Command: enable loopdetect
Success!
DGS-1100-06/ME:5#
disable loopdetect
Purpose
To disable the loop back detection on the Switch.
Syntax
disable loopdetect
Description
The disable loopdetect command disables the loop back detection
on the Switch.
Parameters
None.
Restrictions
Only administrator or operate-level users can issue this command.
7
LOOPBACK DETECTION COMMANDS
The Loopback Detection commands in the Command Line Interface (CLI) are listed (along with the
appropriate parameters) in the following table.
Each command is listed in detail, as follows:
Example usage:
To enable the loopback detection feature on the Switch:
33
Page 46
Example usage:
DGS-1100-06/ME:5#disable loopdetect
Command: disable loopdetect
Success!
DGS-1100-06/ME:5#
config loopdetect mode
Purpose
To configure the loop back detection mode to be portbase or
vlanbase on the Switch.
Syntax
config loopdetect mode [portbase | vlanbase]
Description
The config loopdetect mode command configures loop back
detection mode to be portbase or vlanbase on the Switch.
Parameters
[portbase | vlanbase]] - Specifies the loopdetect mode to be
portbase or vlanbase.
Restrictions
Only administrator or operate-level users can issue this command.
DGS-1100-06/ME:5#config loopdetect mode portbase
Command: config loopdetect mode portbase
Success!
DGS-1100-06/ME:5#
config loopdetect ports
Purpose
To configures the loop back detection to be enabled or disabled for
the specific ports on the Switch.
Syntax
config loopdetect ports [<portlist> | all] [enable | disable]
Description
The config loopdetect ports command configures the loop back
detection to be enabled or disabled for the specific ports on the
Switch.
Parameters
<portlist> − A port or range of ports to be configured.
all − All ports settings are to be configured.
[enabled | disabled] − Specifies the loop back detection is enabled or
disabled for the specified ports on the Switch.
Restrictions
Only administrator or operate-level users can issue this command.
DGS-1100-06/ME:5#config loopdetect ports all enable
Command: config loopdetect ports all enable
To disable the loopback detection feature on the Switch:
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
Example usage:
To configure the loopback detection mode to be portabse on the Switch:
Example usage:
To enable the loop back detection on the Switch:
34
Page 47
Success!
DGS-1100-06/ME:5#
config loopdetect
Purpose
To configure the loop back detection interval time and recover time
on the Switch.
Syntax
config loopdetect interval_time <value 1-32767>
lbd_recover_time [0 | <value 60-1000000>]
Description
The config loopdetect command configures the loop back
detection interval time and recover time on the Switch.
Parameters
interval_time <value 1-32767> − Specifies the interval time of loop
back detection. The range is between 1 and 32767 seconds.
lbd_recover_time [0 | <value 60-10000>] − Specifies the recover
time of loop back detection on the switch. The range is between 60
and 10000 seconds.
Restrictions
Only administrator or operate-level users can issue this command.
DGS-1100-06/ME:5#config loopdetect interval_time 500
Command: config loopdetect interval_time 500
Success!
DGS-1100-06/ME:5#
show loopdetect
Purpose
To display the loop back detection information on the Switch.
Syntax
show loopdetect {ports [<portlist> | all]}
Description
The show loopdetect command displays the loop back detection
information on the Switch.
Parameters
<portlist> − A port or range of ports to be displayed.
all − All ports settings are to be displayed.
Restrictions
None.
DGS-1100-06/ME:5#show loopdetect
Command: show loopdetect
Loopdetect Global Settings
---------------------------------Loopdetect Status : Enabled
Loopdetect Mode : Port-Base
Example usage:
To configure the loop back detection with interval time 500 on the Switch:
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
Example usage:
To display the loop back detection information on the Switch:
35
Page 48
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
Loopdetect Interval : 100
Recover Time : 60
DGS-1100-06/ME:5#
36
Page 49
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
Command
Parameter
config pppoe circuit_id
_insertion state
[enable | disable]
config pppoe
circuit_id_insertion
ports
<portlist> [ circuit_id [ mac | ip | udf <string 32> ] | state [enable | disable ] ]
show pppoe
circuit_id_insertion
show pppoe
circuit_id_insertion
ports
{<portlist>}
config pppoe circuit_id_insertion state
Purpose
Used to enable or disable the PPPoE circuit identifier insertion.
Syntax
config pppoe circuit_id_insertion state [enable | disable]
Description
When PPPoE circuit identifier insertion is enabled, the system will
insert the circuit ID tag to the received PPPoE discover and request
packet if the tag is absent, and remove the circuit ID tag from the
received PPPoE offer and session confirmation packet.
The inserted circuit ID contains the following information:
Client MAC address
Device ID
Port number
By default, the Switch IP address is used as the device ID to encode
the circuit ID option.
Parameters
[enable | disable] – Enables or disable PPPoE circuit ID insertion
globally. The function is disabled by default.
Restrictions
Only administrator or operate-level users can issue this command.
DGS-1100-06/ME:5#config pppoe circuit_id_insertion state enable
Command: config pppoe circuit_id_insertion state enable
8
PPPOE CIRCUIT ID INSERTION COMMANDS
PPPoE Circuit ID Insertion is used to produce the unique subscriber mapping capability that is possible
on ATM networks between ATM-DSL local loop and the PPPoE server. The PPPoE server will use the
inserted Circuit Identifier sub-tag of the received packet to provide AAA services (Authentication,
Authorization and Accounting). Through this method, Ethernet networks can be as the alternative of the
ATM networks.
The PPPoE Circuit ID Insertion commands in the Command Line Interface (CLI) are listed (along with the
appropriate parameters) in the following table.
Each command is listed in detail, as follows:
Example usage:
To globally enable PPPoE circuit identifier insertion:
37
Page 50
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
Success.
DGS-1100-06/ME:5#
config pppoe circuit_id_insertion ports
Purpose
Used to enable and disable PPPoE circuit identifier insertion on a
per port basis and specify how to encode the circuit ID option.
Syntax
config pppoe circuit_id_insertion ports <portlist> [ circuit_id
[ mac | ip | udf <string 32> ] | state [enable | disable ] ]
Description
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, inserted by the system, from the received PPPoE offer
and session confirmation packet.
Parameters
<portlist> – Specifies a list of ports to be configured.
The default settings are enabled for ID insertion per port, but
disabled globally.
circuit_id – Configures the device ID used for encoding of the circuit
ID option.
mac – Specifies that the Switch MAC address be used to encode the
circuit ID option.
ip – Specifies that the Switch IP address be used to encode the
circuit ID option.
udf – A user defined string to be used to encode the circuit ID option.
The maximum length is 32.
The default encoding for the device ID option is the Switch IP
address.
state – Specify to enable or disable PPPoE circuit ID insertion for the
ports listed.
Restrictions
Only administrator or operate-level users can issue this command.
DGS-1100-06/ME:5#config pppoe circuit_id_insertion ports 1-5 circuit_id
mac state enable
Command: config pppoe circuit_id_insertion ports 1-5 circuit_id mac
state enable
Success.
DGS-1100-06/ME:5#
show pppoe circuit_id_insertion
Purpose
Used to display the PPPoE circuit identifier insertion status for the
Switch.
Syntax
show pppoe circuit_id_insertion
Description
The show pppoe circuit_id_insertion command is used to display
Example usage:
To enable port 1~5 PPPoE circuit ID insertion function and use Host MAC:
38
Page 51
the global state configuration of the PPPoE circuit ID insertion
function.
Parameters
None.
Restrictions
None.
Example usage:
DGS-1100-06/ME:5#show pppoe circuit_id_insertion
Command: show pppoe circuit_id_insertion
Status: Enabled
DGS-1100-06/ME:5#
show pppoe circuit_id_insertion ports
Purpose
Used to display the PPPoE ID insertion configuration on a per
port basis.
Syntax
show pppoe circuit_id_insertion ports {<portlist>}
Description
The show pppoe circuit_id_insertion ports command allows
the user to view the configuration of PPPoE ID insertion for each
port.
Parameters
<portlist> - Specifies which ports to display. If no ports are
specified, all ports configuration will be listed.
Restrictions
None.
DGS-1100-06/ME:5#show pppoe circuit_id_insertion ports 2-5
Command: show pppoe circuit_id_insertion ports 2-5
Port State Cirucit ID
---- -------- -------------------------------------
2 Enabled Switch MAC
3 Enabled Switch MAC
4 Enabled Switch MAC
5 Enabled Switch MAC
DGS-1100-06/ME:5#
To view the global PPPoE ID insertion state:
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
Example usage:
To view the PPPoE circuit ID configuration for ports 2 to 5:
39
Page 52
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
SNMP Version
Authentication Method
Description
v1
Community String
Community String is used for authentication - NoAuthNoPriv
v2c
Community String
Community String is used for authentication - NoAuthNoPriv
v3
Username
Username is used for authentication – NoAuthNoPriv
v3
MD5 or SHA
Authentication is based on the HMAC-MD5 or HMAC-SHA
algorithms – AuthNoPriv
v3
MD5 DES or SHA DES
Authentication is based on the HMAC-MD5 or HMAC-SHA
algorithms – AuthPriv. DES 56-bit encryption is added based
on the CBC-DES(DES-56) standard
Command
Parameter
create snmp user
<username 32> <groupname 32> [v1 | v2c | v3 [MD5 <auth_password 32> |
SHA <auth_password 32> | none ] [DES <priv_password 32> | none]]
delete snmp user
<username 32> [v1 | v2c | v3]
show snmp user
create snmp view
<view_name 32> <oid 32> <oid_mask 32 view_type [included | excluded]
delete snmp view
<view_name 32> <oid 32>
show snmp view
{<view_name 32>}
create snmp community
<community_string 32> <username 32>
delete snmp community
<community_string 32>
show snmp community
{<community_string 32>}
config snmp engineID
<snmp_engineID 64>
create snmp group
<groupname 32> [v1 | v2c | v3 [noauth_nopriv | auth_nopriv |
auth_priv]{notify_view <view_name 32>}] {read_view <view_name 32> |
write_view <view_name 32>}
delete snmp group
<groupname 32> [v1 | v2c | v3] [auth_nopriv | auth_priv | noauth_priv]
show snmp groups
show snmp global state
create snmp host
<ipaddr> [v1 <username 32> | v2c <username 32> | v3 [noauth_nopriv |
auth_nopriv | auth_priv] <username 32>]
9
NETWORK MANAGEMENT (SNMP) COMMANDS
The Switch supports the Simple Network Management Protocol (SNMP) versions 1, 2c, and 3. Users can
specify which version of the SNMP users want to use to monitor and control the Switch. The three
versions of SNMP vary in the level of security provided between the management station and the
network device. The following table lists the security features of the three SNMP versions:
The Network Management commands in the Command Line Interface (CLI) are listed (along with the
appropriate parameters) in the following table.
40
Page 53
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
Command
Parameter
delete snmp host
<ipaddr>
show snmp host
{<ipaddr>}
create snmp v6host
<ip6_addr> [v1 <username 32> | v2c <username 32> | v3 [noauth_nopriv |
auth_nopriv | auth_priv] <username 32>]
delete snmp v6host
<ip6_addr>
show snmp v6host
<ip6_addr>
enable snmp traps
disable snmp traps
show snmp traps
enable snmp
authenticate trap
disable snmp
authenticate trap
config syslocation
<string 20>
config sysname
<string 20>
config syslogintimeout
<integer 3-30>
enable snmp
disable snmp
enable snmp
fiber_port_link traps
disable snmp
fiber_port_link traps
enable snmp LBD traps
disable snmp LBD traps
enable snmp
port_security_violation
traps
disable snmp
port_security_violation
traps
enable snmp
system_device_bootup
traps
disable snmp
system_device_bootup
traps
enable snmp
twistedpair_port_link
traps
disable snmp
twistedpair_port_link
41
Page 54
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
Command
Parameter
traps
create snmp user
Purpose
To create a new SNMP user and add the user to an SNMP group.
Syntax
create snmp user <username 32> <groupname 32> [v1 | v2c | v3
[MD5 <auth_password 32> | SHA <auth_password 32> | none ]
[DES <priv_password 32> | none]]
Description
The create snmp user command creates a new SNMP user and
adds the user to an existing SNMP group.
Parameters
<username 32> − The new SNMP username, up to 32 alphanumeric
characters.
<groupname 32> − The SNMP groupname the new SNMP user is
associated with, up to 32 alphanumeric characters.
auth - The user may also choose the type of authentication
algorithms used to authenticate the snmp user. The choices are:
MD5 − Specifies that the HMAC-MD5-96 authentication
level to be used. md5 may be utilized by entering one of the
following:
<auth password 32> - A string of between 1 and 32
alphanumeric characters used to authorize the agent to
receive packets for the host.
SHA − Specifies that the HMAC-SHA-96 authentication level
will be used.
<priv_password 32> - A string of between 1 and 32
alphanumeric characters used to authorize the agent to
receive packets for the host.
DES − Specifies that the DES authentication level will be
used.
Restrictions
Only administrator or operate-level users can issue this command.
DGS-1100-06/ME:5#create snmp user dlink SW22 v3 MD5 1234 DES jklj22
Command: create snmp user dlink SW22 v3 MD5 1234 DES jklj22
Success!
DGS-1100-06/ME:5#
delete snmp user
Purpose
To remove an SNMP user from an SNMP group and also to delete
the associated SNMP group.
Syntax
delete snmp user <username 32> [v1 | v2c | v3]
Each command is listed in detail, as follows:
Example usage:
To create an SNMP user on the Switch:
42
Page 55
Description
The delete snmp user command removes an SNMP user from its
SNMP group and then deletes the associated SNMP group.
Parameters
<username 32> − A string of up to 32 alphanumeric characters that
identifies the SNMP user to be deleted.
Restrictions
Only administrator or operate-level users can issue this command.
Example usage:
DGS-1100-06/ME:5#delete snmp user dlink v3
Command: delete snmp user dlink v3
Success!
DGS-1100-06/ME:5#
show snmp user
Purpose
To display information about each SNMP username in the SNMP
group username table.
Syntax
show snmp user
Description
The show snmp user command displays information about each
SNMP username in the SNMP group username table.
Parameters
None.
Restrictions
None.
DGS-1100-06/ME:5#show snmp user
Command: show snmp user
Username Group Name SNMP Version Auth-Protocol PrivProtocol
-------------- ---------------- ---------------- -------------------- ---------------
ReadOnly ReadOnly V1 None None
ReadOnly ReadOnly V2 None None
ReadWrite ReadWrite V1 None None
ReadWrite ReadWrite V2 None None
Total Entries: 4
DGS-1100-06/ME:5#
create snmp view
Purpose
To assign views to community strings to limit which MIB objects an
SNMP manager can access.
Syntax
create snmp view <view_name 32> <oid 32> <oid_mask 32
To delete a previously created SNMP user on the Switch:
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
Example usage:
To display the SNMP users currently configured on the Switch:
43
Page 56
view_type [included | excluded]
Description
The create snmp view command assigns views to community
strings to limit which MIB objects an SNMP manager can access.
Parameters
<view_name 32> − A string of up to 30 alphanumeric characters that
identifies the SNMP view to be created.
<oid 32> − The object ID that identifies an object tree (MIB tree) to
be included or excluded from access by an SNMP manager.
<oid_mask 32> − The object ID mask that identifies an object tree
(MIB tree) to be included or excluded from access by an SNMP
manager.
included − Includes this object in the list of objects that an SNMP
manager can access.
excluded − Excludes this object from the list of objects that an
SNMP manager can access.
Restrictions
Only administrator or operate-level users can issue this command.
Example usage:
DGS-1100-06/ME:5#create snmp view dlink 1.3.6 1.1.1 view_type excluded
Command: create snmp view dlink 1.3.6 1.1.1 view_type excluded
Success!
DGS-1100-06/ME:5#
delete snmp view
Purpose
To remove an SNMP view entry previously created on the Switch.
Syntax
delete snmp view <view_name 32> <oid 32>
Description
The delete snmp view command removes an SNMP view
previously created on the Switch.
Parameters
<view_name 32> − A string of up to 32 alphanumeric characters that
identifies the SNMP view to be deleted.
<oid 32> − The object ID that identifies an object tree (MIB tree) that
is deleted from the Switch.
Restrictions
Only administrator or operate-level users can issue this command.
DGS-1100-06/ME:5#delete snmp view dlink 1.3.6
Command: delete snmp view dlink 1.3.6
Success.
DGS-1100-06/ME:5#
To create an SNMP view:
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
Example usage:
To delete a previously configured SNMP view from the Switch:
44
Page 57
show snmp view
Purpose
To display an SNMP view previously created on the Switch.
Syntax
show snmp view {<view_name 32>}
Description
The show snmp view command displays an SNMP view previously
created on the Switch.
Parameters
<view_name 32> − A string of up to 30 alphanumeric characters that
identifies the SNMP view to be displayed.
Restrictions
None.
Example usage:
DGS-1100-06/ME:5#show snmp view
Command: show snmp view
SNMP View Table Configuration
View Name Subtree OID OID Mask View Type
------------ ---------------------- ---------------------- ----------------
dlink 1.2.3.4 1.1.1.1 Excluded
ReadWrite 1 1 Included
Total Entries: 2
DGS-1100-06/ME:5#
create snmp community
Purpose
To create an SNMP community string to define the relationship
between the SNMP manager and an SNMP agent.
Syntax
create snmp community <community_string 32> <username
32>
Description
The create snmp community command creates an SNMP
community string and assigns access-limiting characteristics to this
community string. The community string acts like a password to
permit access to the agent on the Switch. One or more of the
following characteristics can be associated with the community
string:
An Access List of IP addresses of SNMP managers that are
permitted to use the community string to gain access to the Switch’s
SNMP agent.
A MIB view that defines the subset of all MIB objects to be
accessible to the SNMP community.
Read/write or read-only level permission for the MIB objects
accessible to the SNMP community.
Parameters
<community_string 32> − A string of up to 32 alphanumeric
characters that is used to identify members of an SNMP community.
This string is used like a password to give remote SNMP managers
access to MIB objects in the Switch’s SNMP agent.
<username 32> − A string of up to 32 alphanumeric characters that
is used to identify the group of MIB objects that a remote SNMP
To display SNMP view configuration:
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
45
Page 58
manager is allowed to access on the Switch.
Restrictions
Only administrator or operate-level users can issue this command.
Example usage:
DGS-1100-06/ME:5#create snmp community dlinkgroup dlink
Command: create snmp community dlinkgroup dlink
Success.
DGS-1100-06/ME:5#
delete snmp community
Purpose
To remove a specific SNMP community string from the Switch.
Syntax
delete snmp community <community_string 32>
Description
The delete snmp community command removes a previously
defined SNMP community string from the Switch.
Parameters
<community_string 32> − A string of up to 32 alphanumeric
characters that is used to identify members of an SNMP community
to delete. This string is used like a password to give remote SNMP
managers access to MIB objects in the Switch’s SNMP agent.
Restrictions
Only administrator or operate-level users can issue this command.
DGS-1100-06/ME:5#delete snmp community dlink
Command: delete snmp community dlink
Success!
DGS-1100-06/ME:5#
show snmp community
Purpose
To display SNMP community strings configured on the Switch.
Syntax
show snmp community {<community_string 32>}
Description
The show snmp community command displays SNMP community
strings that are configured on the Switch.
Parameters
<community_string 32> − A string of up to 20 alphanumeric
characters that is used to identify members of an SNMP community.
This string is used like a password to give remote SNMP managers
access to MIB objects in the Switch’s SNMP agent.
Restrictions
None.
DGS-1100-06/ME:5#show snmp community
To create the SNMP community string ‘dlink:’
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
Example usage:
To delete the SNMP community string ‘dlink’:
Example usage:
To display the currently entered SNMP community strings:
46
Page 59
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
Command: show snmp community
SNMP Community Table
(Maximum Entries : 10)
Community Name User Name
------------------------ ------------
public ReadOnly
private ReadWrite
Total Entries: 2
DGS-1100-06/ME:5#
config snmp engineID
Purpose
To configure a name for the SNMP engine on the Switch.
Syntax
config snmp engineID <snmp_engineID 64>
Description
The config snmp engineID command configures a name for the
SNMP engine on the Switch.
Parameters
<snmp_engineID 64> − A string, of between 10 and 64
alphanumeric characters, to be used to identify the SNMP engine on
the Switch.
Restrictions
Only administrator or operate-level users can issue this command.
DGS-1100-06/ME:5#config snmp engineID 12345678900
Command: config snmp engineID 12345678900
Success!
DGS-1100-06/ME:5#
create snmp group
Purpose
To create a new SNMP group, or a table that maps SNMP users to
SNMP views.
Syntax
create snmp group <groupname 32> [v1 | v2c | v3
[noauth_nopriv | auth_nopriv | auth_priv]{notify_view
<view_name 32>}] {read_view <view_name 32> | write_view
<view_name 32>}
Description
The create snmp group command creates a new SNMP group, or
a table that maps SNMP users to SNMP views.
Parameters
<groupname 32> − A name of up to 30 alphanumeric characters that
identifies the SNMP group the new SNMP user is to be associated
with.
v1 – Specifies that SNMP version 1 is to be used. The Simple
Network Management Protocol (SNMP), version 1, is a network
Example usage:
To give the SNMP agent on the Switch:
47
Page 60
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
management protocol that provides a means to monitor and control
network devices.
v2c – Specifies that SNMP version 2c is to be used. The SNMP v2c
supports both centralized and distributed network management
strategies. It includes improvements in the Structure of Management
Information (SMI) and adds some security features.
v3 – Specifies that the SNMP version 3 is to be used. SNMP v3
provides secure access to devices through a combination of
authentication and encrypting packets over the network. SNMP v3
adds:
Message integrity − Ensures that packets have not been
tampered with during transit.
Authentication − Determines if an SNMP message is from a
valid source.
Encryption − Scrambles the contents of messages to
prevent it from being viewed by an unauthorized source.
noauth_nopriv − Specifies that there is no authorization and no
encryption of packets sent between the Switch and a remote SNMP
manager.
auth_nopriv − Specifies that authorization is required, but there is no
encryption of packets sent between the Switch and a remote SNMP
manager.
auth_priv − Specifies that authorization is required, and that packets
sent between the Switch and a remote SNMP manger are
encrypted.
read_view – Specifies that the SNMP group being created can
request SNMP messages.
<view_name 32> − A string of up to 32 objects that a remote
SNMP manager is allowed to access on the Switch.
write_view – Specifies that the SNMP group being created has write
privileges.
<view_name 32 identifies the group of MIB objects that a
remote SNMP manager is allowed to access on the Switch.
notify_view − Specifies that the SNMP group being created can
receive SNMP trap messages generated by the Switch’s SNMP
agent.
<view_name 32> − A string of up to 32 alphanumeric
characters that identifies the group of MIB objects that a
remote SNMP manager is allowed to access on the Switch.
Restrictions
Only administrator or operate-level users can issue this command.
DGS-1100-06/ME:5#create snmp group sg1 v2c read_view sg1
write_view sg1 notify_view sg1
Command: create snmp group sg1 v2c read_view sg1 write_view
sg1 notify_view sg1
Success!
DGS-1100-06/ME:5#
Example usage:
To create an SNMP group named ‘sg1:’
48
Page 61
delete snmp group
Purpose
To remove an SNMP group from the Switch.
Syntax
delete snmp group <groupname 32> [v1 | v2c | v3 [auth_priv |
noauth_nopriv]]
Description
The delete snmp group command removes an SNMP group from
the Switch.
Parameters
<groupname 32> − A string of that identifies the SNMP group the
new SNMP user will be associated with. Up to 32 alphanumeric
characters.
Restrictions
Only administrator or operate-level users can issue this command.
DGS-1100-06/ME:5#delete snmp group sg1 v3 auth_priv
Command: delete snmp group sg1 v3 auth_priv
Success!
DGS-1100-06/ME:5#
show snmp groups
Purpose
To display the group-names of SNMP groups currently configured
on the Switch. The security model, level, and status of each group
are also displayed.
Syntax
show snmp groups
Description
The show snmp groups command displays the group-names of
SNMP groups currently configured on the Switch. The security
model, level, and status of each group are also displayed.
Parameters
None.
Restrictions
None.
DGS-1100-06/ME:5#show snmp groups
Command: show snmp groups
SNMP Group Table
Group Name Read View Write View Notify View Security Model Security Level
------------------ -------------- ---------------- --------------- ---------------------- -----------------
sg1 df df d v3 AuthPriv
ReadOnly ReadWrite --- ReadWrite v1 NoAuthNoPriv
ReadOnly ReadWrite --- ReadWrite v2c NoAuthNoPriv
ReadWrite ReadWrite ReadWrite ReadWrite v1 NoAuthNoPriv
ReadWrite ReadWrite ReadWrite ReadWrite v2c NoAuthNoPriv
Example usage:
To delete the SNMP group named ‘sg1’:
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
Example usage:
To display the currently configured SNMP groups on the Switch:
49
Page 62
Total Entries: 5
DGS-1100-06/ME:5#
show snmp global state
Purpose
To display the global state of SNMP currently configured on the
Switch.
Syntax
show snmp global state
Description
The show snmp global state command displays the global state of
SNMP groups currently configured on the Switch.
Parameters
None.
Restrictions
None.
DGS-1100-06/ME:5#show snmp global state
Command: show snmp global state
SNMP Global State : Enable
DGS-1100-06/ME:5#
create snmp host
Purpose
To create a recipient of SNMP traps generated by the Switch’s
SNMP agent.
Syntax
create snmp host <ipaddr> [v1 <username 32> | v2c <username
32> | v3 [noauth_nopriv | auth_nopriv | auth_priv] <username
32>] {[InterfaceName <string 20>]}
Description
The create snmp host command creates a recipient of SNMP traps
generated by the Switch’s SNMP agent.
Parameters
<ipaddr> − The IP address of the remote management station to
serve as the SNMP host for the Switch.
v1 – Specifies that SNMP version 1 is to be used. The Simple
Network Management Protocol (SNMP), version 1, is a network
management protocol that provides a means to monitor and control
network devices.
v2c – Specifies that SNMP version 2c is to be used. The SNMP v2c
supports both centralized and distributed network management
strategies. It includes improvements in the Structure of Management
Information (SMI) and adds some security features.
v3 – Specifies that the SNMP version 3 is to be used. SNMP v3
provides secure access to devices through a combination of
authentication and encrypting packets over the network. SNMP v3
adds:
Example usage:
To display the currently configured SNMP global state on the Switch:
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
50
Page 63
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
Message integrity − ensures that packets have not been
tampered with during transit.
Authentication − determines if an SNMP message is from a
valid source.
Encryption − scrambles the contents of messages to prevent
it being viewed by an unauthorized source.
<username 32> − A string of up to 32 alphanumeric characters that
identifies user name of an SNMP community. This string is used like
a password to give remote SNMP managers access to MIB objects
in the Switch’s SNMP agent.
noauth_nopriv − Specifies that there is no authorization and no
encryption of packets sent between the Switch and a remote SNMP
manager.
auth_nopriv − Specifies that authorization is required, but there is no
encryption of packets sent between the Switch and a remote SNMP
manager.
auth_priv − Specifies that authorization is required, and that packets
sent between the Switch and a remote SNMP manger are
encrypted.
InterfaceName <string 20> − Specifies the interface name for v1 and
v2.
Restrictions
Only Administrator and oper-level users can issue this command
DGS-1100-06/ME:5#create snmp host 10.90.90.22 v3 noauth_nopriv dlink
Command: create snmp host 10.90.90.22 v3 noauth_nopriv dlink
Success!
DGS-1100-06/ME:5#
delete snmp host
Purpose
To remove a recipient of SNMP traps generated by the Switch’s
SNMP agent.
Syntax
delete snmp host <ipaddr>
Description
The delete snmp host command deletes a recipient of SNMP traps
generated by the Switch’s SNMP agent.
Parameters
<ipaddr> − The IP address of a remote SNMP manager that
receives SNMP traps generated by the Switch’s SNMP agent.
Restrictions
Only Administrator or operator-level users can issue this command
DGS-1100-06/ME:5#delete snmp host 10.90.90.22
Command: delete snmp host 10.90.90.22
Success!
Example usage:
To create an SNMP host to receive SNMP messages:
Example usage:
To delete an SNMP host entry:
51
Page 64
DGS-1100-06/ME:5#
show snmp host
Purpose
To display the recipient of SNMP traps generated by the Switch’s
SNMP agent.
Syntax
show snmp host {<ipaddr>}
Description
The show snmp host command is used to display the IP addresses
and configuration information of remote SNMP managers that are
designated as recipients of SNMP traps generated by the Switch’s
SNMP agent.
Parameters
<ipaddr> − The IP address of a remote SNMP manager that
receives SNMP traps generated by the Switch’s SNMP agent.
Restrictions
None.
DGS-1100-06/ME:5#show snmp host
Command: show snmp host
SNMP Host Table
(Maximum Entries : 10)
Host IP Address SNMP Version Community Name/SNMPv3 User Name
------------------------ --------------------- -------------------------------------------------------
10.90.90.22 V3-NoAuthNoPriv dlink
Total Entries : 1
DGS-1100-06/ME:5#
create snmp v6host
Purpose
To create a recipient of SNMP traps generated by the Switch’s
SNMP agent.
Syntax
create snmp v6host <ip6_addr> [v1 <username 32> | v2c
<username 32> | v3 [noauth_nopriv | auth_nopriv | auth_priv]
<username 32>] {InterfaceName <string 20>}
Description
The create snmp v6host command creates a recipient of SNMP
traps generated by the Switch’s SNMP agent.
Parameters
<ipv6_addr> − The IPv6 address of the remote management station
to serve as the SNMP host for the Switch.
v1 – Specifies that SNMP version 1 is to be used. The Simple
Network Management Protocol (SNMP), version 1, is a network
management protocol that provides a means to monitor and control
network devices.
v2c – Specifies that SNMP version 2c is to be used. The SNMP v2c
supports both centralized and distributed network management
strategies. It includes improvements in the Structure of Management
Information (SMI) and adds some security features.
Example usage:
To display the currently configured SNMP hosts on the Switch:
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
52
Page 65
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
v3 – Specifies that the SNMP version 3 is to be used. SNMP v3
provides secure access to devices through a combination of
authentication and encrypting packets over the network. SNMP v3
adds:
Message integrity − ensures that packets have not been
tampered with during transit.
Authentication − determines if an SNMP message is from a
valid source.
Encryption − scrambles the contents of messages to prevent
it being viewed by an unauthorized source.
<username 32> − A string of up to 32 alphanumeric characters that
identifies user name of an SNMP community. This string is used like
a password to give remote SNMP managers access to MIB objects
in the Switch’s SNMP agent.
noauth_nopriv − Specifies that there is no authorization and no
encryption of packets sent between the Switch and a remote SNMP
manager.
auth_nopriv − Specifies that authorization is required, but there is no
encryption of packets sent between the Switch and a remote SNMP
manager.
auth_priv − Specifies that authorization is required, and that packets
sent between the Switch and a remote SNMP manger are
encrypted.
InterfaceName <string 20> − Specifies the interface name of v1 and
v2c.
Restrictions
Only Administrator and oper-level users can issue this command
DGS-1100-06/ME:5#create snmp v6host 3000::1 v3 noauth_nopriv dlink
Command: create snmp v6host 3000::1 v3 noauth_nopriv dlink
Success!
DGS-1100-06/ME:5#
delete snmp v6host
Purpose
To remove a recipient of SNMP traps generated by the Switch’s
SNMP agent.
Syntax
delete snmp v6host <ip6_addr>
Description
The delete snmp host command deletes a recipient of SNMP traps
generated by the Switch’s SNMP agent.
Parameters
<ipv6_addr> − The IPv6 address of a remote SNMP manager that
receives SNMP traps generated by the Switch’s SNMP agent.
Restrictions
Only Administrator or operator-level users can issue this command
DGS-1100-06/ME:5#delete snmp v6host 90.90.22
Example usage:
To create an SNMP host to receive SNMP messages:
Example usage:
To delete an SNMP host entry:
53
Page 66
Command: delete snmp host 10.90.90.22
Success!
DGS-1100-06/ME:5#
show snmp v6host
Purpose
To display the recipient of SNMP traps generated by the Switch’s
SNMP agent.
Syntax
show snmp v6host {<ip6_addr>}
Description
The show snmp host command is used to display the IPv6
addresses and configuration information of remote SNMP managers
that are designated as recipients of SNMP traps generated by the
Switch’s SNMP agent.
Parameters
<ip6_addr> − The IPv6 address of a remote SNMP manager that
receives SNMP traps generated by the Switch’s SNMP agent.
Restrictions
None.
DGS-1100-06/ME:5#show snmp v6host
Command: show snmp v6host
SNMP Host Table
(Maximum Entries : 10)
Host IP Address SNMP Version Community or User Name
------------------------------------ -------------------- -------------------------------------
3000::1 V3-NoAuthNoPriv dlink
Success!
DGS-1100-06/ME:5#
enable snmp traps
Purpose
To enable SNMP trap support.
Syntax
enable snmp traps
Description
The enable snmp traps command enables SNMP trap support on
the Switch.
Parameters
None.
Restrictions
Only Administrator or operator-level users can issue this command
DGS-1100-06/ME:5#enable snmp traps
Example usage:
To display the currently configured SNMP hosts on the Switch:
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
Example usage:
To enable SNMP trap support on the Switch:
54
Page 67
Command: enable snmp traps
Success!
DGS-1100-06/ME:5#
disable snmp traps
Purpose
To disable SNMP trap support on the Switch.
Syntax
disable snmp traps
Description
The disable snmp traps command disables SNMP trap support on
the Switch.
Parameters
None.
Restrictions
Only Administrator or operator-level users can issue this command.
DGS-1100-06/ME:5#disable snmp traps
Command: disable snmp traps
Success!
DGS-1100-06/ME:5#
show snmp traps
Purpose
To display SNMP trap support status on the Switch.
Syntax
show snmp traps
Description
The show snmp traps command displays the SNMP trap support
status currently configured on the Switch.
Parameters
None.
Restrictions
None.
DGS-1100-06/ME:5#show snmp traps
Command: show snmp traps
SNMP Traps : Enable
SNMP Authentication Traps : Enable
System Device Bootup : Enable
Fiber Port Link Up / Link Down : Enable
Twisted Pair Port Link Up / Link Down : Enable
Port Security violation State : Enable
Loopback detection State : Enable
DGS-1100-06/ME:5#
Example usage:
To prevent SNMP traps from being sent from the Switch:
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
Example usage:
To view the current SNMP trap support:
55
Page 68
enable snmp authenticate trap
Purpose
To enable SNMP authentication trap support.
Syntax
enable snmp authenticate trap
Description
The enable snmp authenticate trap command enables SNMP
authentication trap support on the Switch.
Parameters
None.
Restrictions
Only Administrator or operator-level users can issue this command
DGS-1100-06/ME:5#enable snmp authenticate traps
Command: enable snmp authenticate traps
Success!
DGS-1100-06/ME:5#
disable snmp authenticate trap
Purpose
To disable SNMP authentication trap support.
Syntax
disable snmp authenticate trap
Description
The disable snmp authenticate trap command disables SNMP
authentication trap support on the Switch.
Parameters
None.
Restrictions
Only Administrator or operator-level users can issue this command
DGS-1100-06/ME:5#disable snmp authenticate traps
Command: disable snmp authenticate traps
Success!
DGS-1100-06/ME:5#
config syslocation
Purpose
To enter a description of the location of the Switch.
Syntax
config syslocation <string 20>
Description
The config syslocation command enters a description of the
location of the Switch. A maximum of 20 characters can be used.
Parameters
<string 20> - A maximum of 20 characters is allowed.
Restrictions
Only Administrator or operator-level users can issue this command.
Example usage:
To turn on SNMP authentication trap support:
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
Example usage:
To disable the SNMP authentication trap support:
Example usage:
To configure the Switch location for ‘HQ5F’:
56
Page 69
DGS-1100-06/ME:5#config syslocation HQ5F
Command: config syslocation HQ5F
Success.
DGS-1100-06/ME:5#
config sysname
Purpose
To define the name for the Switch.
Syntax
config sysname <string 20>
Description
The config sysname command defines the name of the Switch.
Parameters
<string 20> - A maximum of 20 characters is allowed.
Restrictions
Only Administrator or operator-level users can issue this command.
DGS-1100-06/ME:5#config sysname 28ME
Command: config sysname 28ME
Success.
DGS-1100-06/ME:5#
config syslogintimeout
Purpose
To define the login timout for the Switch.
Syntax
config syslogintimeout <integer 3-30>
Description
The config syslogintimeout command defines the login timeout of
the Switch.
Parameters
<integer 3-30> - Specifies the login timeout. The range is from 3-30
minutes.
Restrictions
Only Administrator or operator-level users can issue this command.
DGS-1100-06/ME:5# config syslogintimeout 30
Command: config syslogintimeout 30
Success.
DGS-1100-06/ME:5#
enable snmp
Purpose
To enable SNMP support.
Syntax
enable snmp
Example usage:
To configure the Switch name as ‘28ME’:
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
Example usage:
To configure the login timeout to 30 minutes:
57
Page 70
Description
The enable snmp command enables SNMP support on the Switch.
Parameters
None.
Restrictions
Only Administrator or operator-level users can issue this command.
Example usage:
DGS-1100-06/ME:5#enable snmp
Command: enable snmp
Success!
DGS-1100-06/ME:5#
disable snmp
Purpose
To disable SNMP support.
Syntax
disable snmp
Description
The disable snmp command enables SNMP support on the Switch.
Parameters
None.
Restrictions
Only Administrator or operator-level users can issue this command.
DGS-1100-06/ME:5#disable snmp
Command: disable snmp
Success!
DGS-1100-06/ME:5#
enable snmp fiber_port_link traps
Purpose
To enable SNMP fiber port link traps support on the Switch.
Syntax
enable snmp fiber_port_link traps
Description
The enable snmp fiber_port_link traps command enables SNMP
fiber port link traps support on the Switch. After enables the SNMP
fiber port link traps support, the Switch will send out a trap to the
SNMP manage host when the fiber port is link up or link down.
Parameters
None.
Restrictions
Only Administrator or operator-level users can issue this command
DGS-1100-06/ME:5#enable snmp fiber_port_link traps
Command: enable snmp fiber_port_link traps
To enable SNMP support on the Switch:
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
Example usage:
To disable SNMP support on the Switch:
Example usage:
To enable SNMP fiber port link traps support on the Switch:
58
Page 71
Success!
DGS-1100-06/ME:5#
disable snmp fiber_port_link traps
Purpose
To disable SNMP fiber port link traps.
Syntax
disable snmp fiber_port_link traps
Description
The disable snmp fiber_port_link traps command disables SNMP
fiber port link traps support on the Switch.
Parameters
None.
Restrictions
Only Administrator or operator-level users can issue this command
DGS-1100-06/ME:5#disable snmp fiber_port_link traps
Command: disable snmp fiber_port_link traps
Success!
DGS-1100-06/ME:5#
enable snmp LBD traps
Purpose
To enable SNMP LBD traps.
Syntax
enable snmp LBD traps
Description
The enable snmp LBD traps command enables SNMP LBD traps
support on the Switch.
Parameters
None.
Restrictions
Only Administrator or operator-level users can issue this command.
DGS-1100-06/ME:5#enable snmp LBD traps
Command: enable snmp LBD traps
Success!
DGS-1100-06/ME:5#
disable snmp LBD traps
Purpose
To disable SNMP LBD traps.
Syntax
disable snmp LBD traps
Description
The disable snmp LBD traps command disables SNMP LBD traps
Example usage:
To disable SNMP fiber port link traps support on the Switch:
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
Example usage:
To enable SNMP LBD traps support on the Switch:
59
Page 72
support on the Switch.
Parameters
None.
Restrictions
Only Administrator or operator-level users can issue this command.
Example usage:
DGS-1100-06/ME:5#disable snmp LBD traps
Command: disable snmp LBD traps
Success!
DGS-1100-06/ME:5#
enable snmp port_security_violation traps
Purpose
To enable SNMP port security violation traps.
Syntax
enable snmp port_security_violation traps
Description
The enable snmp port_security_violation traps command
enables SNMP port security violation traps on the Switch.
Parameters
None.
Restrictions
Only Administrator or operator-level users can issue this command.
DGS-1100-06/ME:5#enable snmp port_security_violation traps
Command: enable snmp port_security_violation traps
Success!
DGS-1100-06/ME:5#
disable snmp port_security_violation traps
Purpose
To disable SNMP port security violation traps.
Syntax
disable snmp port_security_violation traps
Description
The disable snmp port_security_violation traps command
disables SNMP port security violation traps on the Switch.
Parameters
None.
Restrictions
Only Administrator or operator-level users can issue this command.
DGS-1100-06/ME:5#disable snmp port_security_violation traps
Command: disable snmp port_security_violation traps
To disable SNMP LBD traps support on the Switch:
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
Example usage:
To enable SNMP port security violation traps support on the Switch:
Example usage:
To disable SNMP port security violation traps support on the Switch:
60
Page 73
Success!
DGS-1100-06/ME:5#
enable snmp system_device_bootup traps
Purpose
To enable SNMP system device bootup traps support on the Switch.
Syntax
enable snmp system_device_bootup traps
Description
The enable snmp system_device_bootup traps command
enables SNMP system device bootup traps support on the Switch.
After enables the SNMP system device bootup traps support, the
Switch will send out a trap to the SNMP manage host when the
device is power on.
Parameters
None.
Restrictions
Only Administrator or operator-level users can issue this command.
DGS-1100-06/ME:5#enable snmp system_device_bootup traps
Command: enable snmp system_device_bootup traps
Success!
DGS-1100-06/ME:5#
disable snmp system_device_bootup traps
Purpose
To disable SNMP system device bootup traps support on the Switch.
Syntax
disable snmp system_device_bootup traps
Description
The disable snmp system_device_bootup traps command
disables SNMP system device bootup traps support on the Switch.
Parameters
None.
Restrictions
Only Administrator or operator-level users can issue this command.
DGS-1100-06/ME:5#disable snmp system_device_bootup traps
Command: disable snmp system_device_bootup traps
Success!
DGS-1100-06/ME:5#
Example usage:
To enable the SNMP system device bootup traps on the Switch:
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
Example usage:
To disable the SNMP system device bootup traps on the Switch:
61
Page 74
enable snmp twistedpair_port_link traps
Purpose
To enable SNMP twisted pair ports link traps support on the Switch.
Syntax
enable snmp twistedpair_port_link traps
Description
The enable snmp twistedpair_port_link traps command enables
SNMP twisted pair ports link traps support on the Switch.
Parameters
None.
Restrictions
Only Administrator or operator-level users can issue this command.
DGS-1100-06/ME:5#enable snmp twistedpair_port_link traps
Command: enable snmp twistedpair_port_link traps
Success!
DGS-1100-06/ME:5#
disable snmp twistedpair_port_link traps
Purpose
To disable SNMP twisted pair ports link traps support on the Switch.
Syntax
disable snmp twistedpair_port_link traps
Description
The disable snmp twistedpair_port_link traps command enables
SNMP twisted pair ports link traps support on the Switch.
Parameters
None.
Restrictions
Only Administrator or operator-level users can issue this command.
DGS-1100-06/ME:5#disable snmp twistedpair_port_link traps
Command: disable snmp twistedpair_port_link traps
Success!
DGS-1100-06/ME:5#
Example usage:
To enable the SNMP twisted pair ports link traps on the Switch:
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
Example usage:
To disable the SNMP twisted pair ports link traps on the Switch:
62
Page 75
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
Command
Parameter
enable discover trap
[ipaddr]
disable discover trap
enable
discover_trap_event
DeviceBoot
disable
discover_trap_event
DeviceBoot
enable
discover_trap_event
FiberPort
disable
discover_trap_event
FiberPort
enable
discover_trap_event
IllegalLogin
disable
discover_trap_event
IllegalLogin
enable
discover_trap_event
LBD
disable
discover_trap_event
LBD
enable
discover_trap_event
PortSecurity
disable
discover_trap_event
PortSecurity
enable
discover_trap_event
TwistedPairPort
disable
discover_trap_event
TwistedPairPort
10
DISCOVERY TRAP COMMANDS
The Discovery Trap commands in the Command Line Interface (CLI) are listed (along with the
appropriate parameters) in the following table.
63
Page 76
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
Command
Parameter
show discover_trap
enable discover_trap
Purpose
To enable the discovery trap from smartconsole support of the
Switch.
Syntax
enable discover_trap [ipaddr]
Description
The enable discover_trap command enables discovery traps
support on the Switch.
Parameters
[ipaddr] – Specifies the IP address to be trapped to.
Restrictions
Only Administrator or operator-level users can issue this command.
DGS-1100-06/ME:5# enable discover_trap 10.90.90.97
Command: enable discover_trap 10.90.90.97
Success.
DGS-1100-06/ME:5#
disable discover_trap
Purpose
To disable the discovery trap from smartconsole support of the
Switch.
Syntax
disable discover_trap
Description
The disable discover_trap command disables discovery traps
support on the Switch.
Parameters
None.
Restrictions
Only Administrator or operator-level users can issue this command.
DGS-1100-06/ME:5# disable discover_trap
Command: disable discover_trap
Success.
DGS-1100-06/ME:5#
enable discover_trap_event DeviceBoot
Purpose
To enable the discovery device bootup trap from smartconsole
Each command is listed in detail, as follows:
Example usage:
To enable the discovery trap to IP 10.90.90.97:
Example usage:
To disable the discovery trap:
64
Page 77
support of the Switch.
Syntax
enable discover_trap_event DeviceBoot
Description
The enable discover_trap_event DeviceBoot command enables
discovery device bootup trap support on the Switch.
Parameters
None.
Restrictions
Only Administrator or operator-level users can issue this command.
Example usage:
DGS-1100-06/ME:5# enable discover_trap_event DeviceBoot
Command: enable discover_trap_event DeviceBoot
Success.
DGS-1100-06/ME:5#
disable discover_trap_event DeviceBoot
Purpose
To disable the discovery device bootup trap from smartconsole
support of the Switch.
Syntax
disable discover_trap_event DeviceBoot
Description
The disable discover_trap_event DeviceBoot command disables
discovery device bootup trap support on the Switch.
Parameters
None.
Restrictions
Only Administrator or operator-level users can issue this command.
DGS-1100-06/ME:5# disable discover_trap_event DeviceBoot
Command: disable discover_trap_event DeviceBoot
Success.
DGS-1100-06/ME:5#
enable discover_trap_event FiberPort
Purpose
To enable the discovery fiber port trap from smartconsole support of
the Switch.
Syntax
enable discover_trap_event FiberPort
Description
The enable discover_trap_event FiberPort command enables
discovery fiber port trap support on the Switch.
Parameters
None.
Restrictions
Only Administrator or operator-level users can issue this command.
To enable the discovery device boot trap:
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
Example usage:
To disable the discovery device boot trap:
Example usage:
To enable the discovery fiber port trap:
65
Page 78
DGS-1100-06/ME:5# enable discover_trap_event FiberPort
Command: enable discover_trap_event FiberPort
Success.
DGS-1100-06/ME:5#
disable discover_trap_event FiberPort
Purpose
To disable the discovery fiber port trap from smartconsole support of
the Switch.
Syntax
disable discover_trap_event FiberPort
Description
The disable discover_trap_event FiberPort command disables
discovery fiber port trap support on the Switch.
Parameters
None.
Restrictions
Only Administrator or operator-level users can issue this command.
DGS-1100-06/ME:5# disable discover_trap_event FiberPort
Command: disable discover_trap_event FiberPort
Success.
DGS-1100-06/ME:5#
enable discover_trap_event IllegalLogin
Purpose
To enable the discovery illegal login trap from smartconsole support
of the Switch.
Syntax
enable discover_trap_event IllegalLogin
Description
The enable discover_trap_event IllegalLogin command enables
discovery illegal login trap support on the Switch.
Parameters
None.
Restrictions
Only Administrator or operator-level users can issue this command.
DGS-1100-06/ME:5# enable discover_trap_event IllegalLogin
Command: enable discover_trap_event IllegalLogin
Success.
DGS-1100-06/ME:5#
Example usage:
To disable the discovery fiber port trap:
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
Example usage:
To enable the discovery illegal login trap:
66
Page 79
disable discover_trap_event IllegalLogin
Purpose
To disable the discovery illegal login trap from smartconsole support
of the Switch.
Syntax
disable discover_trap_event IllegalLogin
Description
The disable discover_trap_event IllegalLogin command disables
discovery illegal login trap support on the Switch.
Parameters
None.
Restrictions
Only Administrator or operator-level users can issue this command.
Example usage:
DGS-1100-06/ME:5# disable discover_trap_event IllegalLogin
Command: disable discover_trap_event IllegalLogin
Success.
DGS-1100-06/ME:5#
enable discover_trap_event LBD
Purpose
To enable the discovery loopback detection trap from smartconsole
support of the Switch.
Syntax
enable discover_trap_event IllegalLogin
Description
The enable discover_trap_event IllegalLogin command enables
discovery loopback detection trap support on the Switch.
Parameters
None.
Restrictions
Only Administrator or operator-level users can issue this command.
DGS-1100-06/ME:5# enable discover_trap_event LBD
Command: enable discover_trap_event LBD
Success.
DGS-1100-06/ME:5#
disable discover_trap_event LBD
Purpose
To disable the discovery loopback detection trap from smartconsole
support of the Switch.
Syntax
disable discover_trap_event LBD
Description
The disable discover_trap_event LBD command disables
discovery loopback detection trap support on the Switch.
Parameters
None.
Restrictions
Only Administrator or operator-level users can issue this command.
To disable the discovery illegal login trap:
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
Example usage:
To enable the discovery loopback detection trap:
67
Page 80
Example usage:
DGS-1100-06/ME:5# disable discover_trap_event LBD
Command: disable discover_trap_event LBD
Success.
DGS-1100-06/ME:5#
enable discover_trap_event PortSecurity
Purpose
To enable the discovery port security trap from smartconsole
support of the Switch.
Syntax
enable discover_trap_event PortSecurity
Description
The enable discover_trap_event PortSecurity command enables
discovery l port security trap support on the Switch.
Parameters
None.
Restrictions
Only Administrator or operator-level users can issue this command.
DGS-1100-06/ME:5# enable discover_trap_event PortSecurity
Command: enable discover_trap_event PortSecurity
Success.
DGS-1100-06/ME:5#
disable discover_trap_event PortSecurity
Purpose
To disable the discovery port security trap from smartconsole
support of the Switch.
Syntax
disable discover_trap_event PortSecurity
Description
The disable discover_trap_event PortSecurity command disables
discovery port security trap support on the Switch.
Parameters
None.
Restrictions
Only Administrator or operator-level users can issue this command.
DGS-1100-06/ME:5# disable discover_trap_event PortSecurity
Command: disable discover_trap_event PortSecurity
Success.
DGS-1100-06/ME:5#
To disable the discovery loopback detection trap:
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
Example usage:
To enable the discovery port security trap:
Example usage:
To disable the discovery port security trap:
68
Page 81
enable discover_trap_event TwistedPairPort
Purpose
To enable the discovery twisted pair port trap from smartconsole
support of the Switch.
Syntax
enable discover_trap_event TwistedPairPort
Description
The enable discover_trap_event TwistedPairPort command
enables discovery twisted pair port trap support on the Switch.
Parameters
None.
Restrictions
Only Administrator or operator-level users can issue this command.
Example usage:
DGS-1100-06/ME:5# enable discover_trap_event TwistedPairPort
Command: enable discover_trap_event TwistedPairPort
Success.
DGS-1100-06/ME:5#
disable discover_trap_event TwistedPairPort
Purpose
To disable the discovery twisted pair port trap from smartconsole
support of the Switch.
Syntax
disable discover_trap_event TwistedPairPort
Description
The disable discover_trap_event TwistedPairPort command
disables discovery twisted pair port trap support on the Switch.
Parameters
None.
Restrictions
Only Administrator or operator-level users can issue this command.
DGS-1100-06/ME:5# disable discover_trap_event TwistedPairPort
Command: disable discover_trap_event TwistedPairPort
Success.
DGS-1100-06/ME:5#
show discover_trap
Purpose
To display the discovery trap information from smartconsole of the
Switch.
Syntax
show discover_trap
Description
The show discover_trap command displays discovery trap
information on the Switch.
Parameters
None.
Restrictions
None.
To enable the discovery twisted pair port trap:
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
Example usage:
To disable the discovery twisted pair port trap:
69
Page 82
Example usage:
DGS-1100-06/ME:5# show discover_trap
Command: show discover_trap
Trap Settings for SmartConsole
--------------------------------------------------------Trap Status : ENABLE
Destination IP : 10.90.90.97
Device Bootup : DISABLE
Illegal Login : ENABLE
Fiber Port Event : ENABLE
Twisted Pair Port Event : ENABLE
Port Security Violation : DISABLE
Loopback detection State: DISABLE
DGS-1100-06/ME:5#
To display the discovery trap:
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
70
Page 83
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
Command
Parameter
download
[configuration [<ipaddr> | <ipv6_addr>] <path_filename 64>] | [firmware
[<ipaddr> | <ipv6_addr>] <string 64>]
upload
[[firmware [<ipaddr> | <ipv6_addr>] <path_filename 64>] | [cfg_toTFTP [<ipaddr>
| <ipv6_addr>] <path_filename 64> config_id <value 1-2>] | [log_toTFTP
[<ipaddr> | <ipv6_addr>] <path_filename 64>]]
download
Purpose
To download and install a firmware, boot, or switch configuration file
from a TFTP server.
Syntax
download [configuration [<ipaddr> | <ipv6_addr>]
<path_filename 64>] | [firmware [<ipaddr> | <ipv6_addr>]
<string 64>]
Description
The download command downloads a firmware, boot, or switch
configuration file from a TFTP server.
Parameters
configuration − Downloads a switch configuration file from a TFTP
server.
<ipaddr> − The IPv4 address of the TFTP server.
<ipv6_addr> − The IPv6 address of the TFTP server.
<path_filename 64> − The DOS path and filename of the switch
configuration file, up to 64 characters, on the TFTP server. For
example, C:\31xx.had.
startup − Indicates the Configuration file is to be downloaded to the
startup config.
firmware − Downloads and installs firmware on the Switch from a
TFTP server.
<string 64> − The DOS path and filename of the firmware file, up to
64 characters, on the TFTP server. For example, C:\31xx.had.
Restrictions
Only Administrator or operator-level users can issue this command.
DGS-1100-06/ME:5#download firmware 1.1.1.23 1\dgs_1100-06me.ros
Command: download firmware 1.1.1.23 1\ dgs_1100-06me.ros
01–Jan–2000 01:19:48 %COPY–I–FILECPY: Files Copy – source URL tftp://1.1.1.23 /1\
dgs_1100-06me.ros destination URL Unit all flash://image
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
11
DOWNLOAD/UPLOAD COMMANDS
The Download/Upload commands in the Command Line Interface (CLI) are listed (along with the
appropriate parameters) in the following table.
Each command is listed in detail, as follows:
Example usage:
To download a firmware file:
71
Page 84
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! !!!!!!!!!!!!!!!!!!!!!!!!!!!!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! !!!!!!!!!!!!!!!!!!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! !!!!!!!!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!01–Jan–2000 01:22:49 %COPY–W–TRAP:
The copy operation was completed successfully
!
3920460 bytes copied in 00:03:01 [hh:mm:ss]
DGS-1100-06/ME:5#
DGS-1100-06/ME:5#download configuration 10.48.74.121 c:\cfg\setting.txt
Overwrite file [startup-config] ?[Yes/press any key for no]....
01-Jan-200003:19:46%COPY-I-FILECPY:FilesCopy-source URL tftp://10.48.74.121/1.txt
destination
URL flash://startup-config
Success.
Success.
.....01-Jan-2000 03:18:40 %COPY-N-TRAP: The copy operation was completed
successfully!
Copy: 267 bytes copied in 00:00:08 [hh:mm:ss]
DGS-1100-06/ME:5#
upload
Purpose
To upload the current switch settings to a TFTP server.
Syntax
upload [[firmware [<ipaddr> | <ipv6_addr>] <path_filename 64>]
| [cfg_toTFTP [<ipaddr> | <ipv6_addr>] <path_filename 64>
config_id <value 1-2>] | [log_toTFTP [<ipaddr> | <ipv6_addr>]
<path_filename 64>]]
Description
The upload command uploads the Switch’s current settings to a
TFTP server.
Parameters
firmware − Specifies that the Switch’s current firmware are to be
uploaded to the TFTP server.
<ipaddr> − The IPv4 address of the TFTP server. The TFTP server
must be on the same IP subnet as the Switch.
<ipv6_addr> − The IPv6 address of the TFTP server. The TFTP
server must be on the same IP subnet as the Switch.
<path_filename 64> − The location of the Switch configuration file on
the TFTP server.
config_id <value 1-2> − Specifies the config id which to be
uploaded.
To download a configuration file:
72
Page 85
Restrictions
Only Administrator or operator-level users can issue this command.
Example usage:
DGS-1100-06/ME:5#upload log_toTFTP 1.1.1.23 dgs_1100-06me.ros
Command: upload log_toTFTP 1.1.1.23 dgs_1100-06me.ros
01–Jan–2000 01:26:11 %COPY–I–FILECPY: Files Copy – source
URL running–config destination URL tftp://1.1.1.23/1\running–
config
…..01–Jan–2000 01:26:16 %COPY–W–TRAP: The copy operation
was completed success fully!
158 bytes copied in 00:00:05 [hh:mm:ss]
DGS-1100-06/ME:5#
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
73
Page 86
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
Command
Parameter
enable dhcp_relay
disable dhcp_relay
config dhcp_relay add
ipif system
<ipaddr>
config dhcp_relay
delete ipif system
<ipaddr>
config dhcp_relay
hops <value 1-16>
config dhcp_relay
option_82
[check [enable | disable] | policy [drop | keep | replace] | remote_id [default |
user_define <string 32>] | state [enable | disable]]
show dhcp_relay
{ipif}
enable
dhcp_local_relay
disable
dhcp_local_relay
config dhcp_local_relay
vlan <vlan_name> | vlanid <vidlist>] state[enable | disable]
show dhcp_local_relay
enable dhcpv6_relay
disable dhcpv6_relay
show dhcpv6_relay
{ipif system}
config dhcpv6_relay
[add | delete] ipif System <ipv6_addr>
config dhcpv6_relay
hop_count
<value 1-32>
enable dhcp_relay
Purpose
To enable DHCP Relay server on the Switch
Syntax
enable dhcp_relay
Description
The enable dhcp_relay command sets the DHCP Relay to be
globally enabled on the Switch and on all existing VLANs.
Parameters
None.
Restrictions
Only Administrator or operate-level users can issue this command.
12
DHCP RELAY COMMANDS
The DHCP Relay commands in the Command Line Interface (CLI) are listed (along with the appropriate
parameters) in the following table.
Each command is listed in detail, as follows:
Example usage:
74
Page 87
To enable DHCP Relay on the Switch:
DGS-1100-06/ME:5#enable dhcp_relay
Command: enable dhcp_relay
Success!
DGS-1100-06/ME:5#
disable dhcp_relay
Purpose
To disable DHCP Relay server on the Switch
Syntax
disable dhcp_relay
Description
The disable dhcp_relay command sets the DHCP Relay to be
globally disabled on the Switch and on all existing VLANs.
Parameters
None.
Restrictions
Only Administrator or operate-level users can issue this command.
DGS-1100-06/ME:5#disable dhcp_relay
Command: disable dhcp_relay
Success!
DGS-1100-06/ME:5#
config dhcp_relay add ipif System
Purpose
To define a DHCP server as a DHCP Relay server
Syntax
config dhcp_relay add ipif System <ipaddr>
Description
The config dhcp_relay add ipif System command adds DHCP
servers as DHCP Relay servers.
Parameters
<ipaddr> − The IP address of the DHCP server. Up to 4 servers can
be defined.
Restrictions
Only Administrator or operate-level users can issue this command.
DGS-1100-06/ME:5#config dhcp_relay add ipif System 10.6.150.49
Command: config dhcp_relay add ipif System 10.6.150.49
Success!
DGS-1100-06/ME:5#
Example usage:
To disable DHCP Relay on the Switch:
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
Example usage:
To add a DHCP server as a DHCP Relay server:
75
Page 88
config dhcp_relay delete ipif System
Purpose
To delete a DHCP server from the DHCP Relay server list.
Syntax
config dhcp_relay delete ipif System <ipaddr>
Description
The config dhcp_relay delete ipif System command deletes a
DHCP servers defined as a DHCP Relay server.
Parameters
<ipaddr> − The IP address of the DHCP server.
Restrictions
Only Administrator or operate-level users can issue this command.
Example usage:
DGS-1100-06/ME:5#config dhcp_relay delete ipif System 10.6.150.49
Command: config dhcp_relay delete ipif System 10.6.150.49
Success!
DGS-1100-06/ME:5#
config dhcp_relay
Purpose
To delete a DHCP server from the DHCP Relay server list.
Syntax
config dhcp_relay hops <value 1-16>
Description
The config dhcp_relay hops command configures the
DHCP/BOOTP relay feature.
Parameters
hops <value 1-16> − Specifies the maximum number of relay agent
hops that the DHCP packets can cross.
Restrictions
Only Administrator or operate-level users can issue this command.
DGS-1100-06/ME:5#config dhcp_relay hops 12
Command: config dhcp_relay hops 12
Success!
DGS-1100-06/ME:5#
To remove a DHCP server from the DHCP Relay server list:
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
Example usage:
To configure the DHCP relay on the Switch:
76
Page 89
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
config dhcp_relay option_82
Purpose
To configure the check, policy and state of DHCP relay agent
information option 82 of the Switch.
Syntax
config dhcp_relay option_82 [check [enable | disable] | policy
[drop | keep | replace] | remote_id [default | user_define <string
32>] | state [enable | disable]]
Description
The config dhcp_relay option_82 is used to configure the check,
policy and state of DHCP relay agent information option 82 of the
Switch
Parameters
check: used to configure the check of DHCP relay agent information
option 82 of the Switch.
enable – When the field is toggled to enable, the relay agent will
check the validity of the packet’s option 82 field. If the switch
receives a packet that contains the option 82 field from a DHCP
client, the switch drops the packet because it is invalid. In packets
received from DHCP servers, the relay agent will drop invalid
messages.
disable – When the field is toggled to disable, the relay agent will not
check the validity of the packet’s option 82 field.
policy: used to configure the re-forwarding policy of DHCP relay
agent information option 82 of the Switch.
replace − The option 82 field will be replaced if the option 82 field
already exists in the packet received from the DHCP client.
drop − The packet will be dropped if the option 82 field already
exists in the packet received from the DHCP client.
keep − The option 82 field will be retained if the option 82 field
already exists in the packet received from the DHCP client.
state: used to configure the state of DHCP relay agent information
option 82 of the Switch.
enable − When this field is toggled to Enabled the relay agent will
insert and remove DHCP relay information (option 82 field) in
messages between DHCP server and client. When the relay agent
receives the DHCP request, it adds the option 82 information, and
the IP address of the relay agent (if the relay agent is configured), to
the packet. Once the option 82 information has been added to the
packet it is sent on to the DHCP server. When the DHCP server
receives the packet, if the server is capable of option 82, it can
implement policies like restricting the number of IP addresses that
can be assigned to a single remote ID or circuit ID. Then the DHCP
server echoes the option 82 field in the DHCP reply. The DHCP
server unicasts the reply to the back to the relay agent if the request
was relayed to the server by the relay agent. The switch verifies that
it originally inserted the option 82 data. Finally, the relay agent
removes the option 82 field and forwards the packet to the switch
port that connects to the DHCP client that sent the DHCP request.
disable − If the field is toggled to disable the relay agent will not
insert and remove DHCP relay information (option 82 field) in
messages between DHCP servers and clients, and the check and
policy settings will have no effect.
Restrictions
Only Administrator or operate-level users can issue this command.
77
Page 90
Example usage:
DGS-1100-06/ME:5#config dhcp_relay option_82 state disable
Command: config dhcp_relay option_82 state disable
Success!
DGS-1100-06/ME:5#
show dhcp_relay
Purpose
To display the DHCP Relay settings on the Switch.
Syntax
show dhcp_relay {ipif}
Description
The show dhcp_relay command displays the DHCP Relay status
and list of servers defined as DHCP Relay servers on the Switch.
Parameters
None.
Restrictions
None.
DGS-1100-06/ME:5#show dhcp_relay
Command: show dhcp_relay
DHCP/BOOTP Relay Status : Disabled
DHCP/BOOTP Hops Count Limit : 4
DHCP/BOOTP Relay Time Threshold : 0
DHCP Relay Agent Information Option 82 State : Disabled
DHCP Relay Agent Information Option 82 Check : Disabled
DHCP Relay Agent Information Option 82 Policy : Replace
DHCP Relay Agent Information Option 82 ID : 00-B2-FD-DA-EE-EB
Interface Server 1 Server 2 Server 3 Server 4
--------- --------------- --------------- -------------- ---------------
DGS-1100-06/ME:5#
enable dhcp_local_relay
Purpose
To enable the DHCP local relay feature globally
Syntax
enable dhcp_local_relay
Description
The enable dhcp_local_relay command enables the DHCP local
relay feature on the Switch.
Parameters
None.
Restrictions
Only Administrator or operator-level users can issue this command.
To disable the DHCP relay option 82 on the Switch:
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
Example usage:
To display DHCP Relay settings:
Example usage:
78
Page 91
To enable the DHCP Local Relay:
DGS-1100-06/ME:5#enable dhcp_local_relay
Command: enable dhcp_local_relay
Success
DGS-1100-06/ME:5#
disable dhcp_local_relay
Purpose
To disable the DHCP local relay feature globally
Syntax
disable dhcp_local_relay
Description
The disable dhcp_local_relay command disables the DHCP local
relay feature on the Switch.
Parameters
None.
Restrictions
Only Administrator or operator-level users can issue this command.
DGS-1100-06/ME:5#disable dhcp_local_relay
Command: disable dhcp_local_relay
Success
DGS-1100-06/ME:5#
config dhcp_local_relay
Purpose
To specify which VLAN’s the feature works on.
Syntax
config dhcp_local_relay [vlan <vlan_name> | vlanid <vidlist>]
state[enable | disable]
Description
Each VLAN which was added to the DHCP Local Relay list
participates in the DHCP Local Relay process – Option 82 is added
to DHCP requests on this VLAN, and Removed from DHCP Replies
on this VLAN.
Parameters
vlan <vlan_name> – the VLAN name identifier
vlanid <vidlist> – The VLAN tag identifier
state [enable | disable] – enable or disable of the DHCP Local Relay
status by VLAN name or VLAN ID.
Restrictions
Only Administrator or operator-level users can issue this command.
DGS-1100-06/ME:5#config dhcp_local_relay vlan vlanid 10 state disable
Command: config dhcp_local_relay vlan vlanid 10 state disable
Example usage:
To disable the DHCP Local Relay:
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
Example usage:
To disable the VLAN ID10 from VLAN of DHCP Local Relay:
79
Page 92
Success
DGS-1100-06/ME:5#
show dhcp_local_relay
Purpose
To display which VLAN’s the feature works on.
Syntax
show dhcp_local_relay
Description
Each VLAN which was added to the DHCP Local Relay list
participates in the DHCP Local Relay process – Option 82 is added
to DHCP requests on this VLAN, and Removed from DHCP Replies
on this VLAN.
Parameters
None.
Restrictions
None.
DGS-1100-06/ME:5#show dhcp_local_relay
Command: show dhcp_local_relay
DHCP/BOOTP Local Relay Status : Disabled
DHCP/BOOTP Local Relay VID List :
DGS-1100-06/ME:5#
enable dhcpv6_relay
Purpose
To enable DHCPv6 Relay function on the Switch
Syntax
enable dhcpv6_relay
Description
The enable dhcpv6_relay command is used to enable the DHCPv6
relay global state on the Switch.
Parameters
None.
Restrictions
Only Administrator or operate-level users can issue this command.
DGS-1100-06/ME:5#enable dhcpc6_relay
Command: enable dhcpc6_relay
Success!
DGS-1100-06/ME:5#
Example usage:
To display the DHCP local relay information on the Switch:
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
Example usage:
To enable DCHPv6 Relay on the Switch:
80
Page 93
disable dhcp6_relay
Purpose
To disable DHCPv6 Relay function on the Switch
Syntax
disable dhcpv6_relay
Description
The disable dhcpv6_relay command is used to disable the
DHCPv6 relay global state on the Switch.
Parameters
None.
Restrictions
Only Administrator or operate-level users can issue this command.
Example usage:
DGS-1100-06/ME:5#disable dhcpv6_relay
Command: disable dhcpv6_relay
Success!
DGS-1100-06/ME:5#
show dhcpv6_relay
Purpose
To display the current DHCPv6 relay configuration.
Syntax
show dhcpv6_relay {ipif system}
Description
The show dhcpv6_relay command displays the current DHCPv6
relay configuration of all interfaces, or if an IP interface name is
specified, the DHCPv6 relay configuration for that IP interface.
Parameters
None.
Restrictions
None.
DGS-1100-06/ME:5#show dhcpv6_relay ipif System
Command: show dhcpv6_relay ipif System
DHCPv6 Relay Global State : Enabled
DHCPv6 Hops Count Limit : 4
---------------------------------------------------------------
IP Interface : Syetem
Server Address :
Total Entries : 0
DGS-1100-06/ME:5#
To disable DHCPv6 Relay on the Switch:
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
Example usage:
To display DHCPv6 Relay settings:
81
Page 94
config dhcpv6_relay
Purpose
Used to add or delete a destination IP address to or from the
switch’s DHCPv6 relay table.
Syntax
config dhcpv6_relay [add | delete] ipif System <ipv6_addr>
Description
The config dhcpv6_relay command can add or delete an IPv6
destination address to forward (relay) DHCPv6 packets.
Parameters
add − Add an IPv6 destination to the DHCPv6 relay table.
delete − Remove an IPv6 destination to the DHCPv6 relay table.
ipif system − The name of the IP interface in which DHCPv6 relay is
to be enabled.
<ipv6_addr> − The DHCPv6 server IP address.
Restrictions
Only Administrator or operate-level users can issue this command.
Example usage:
DGS-1100-06/ME:5#config dhcpv6_relay add ipif System 3000::1
Command: config dhcpv6_relay add ipif System 3000::1
Success!
DGS-1100-06/ME:5#
config dhcpv6_relay hop_count
Purpose
Used to configure the DHCPv6 relay hop count of the switch.
Syntax
config dhcpv6_relay hop_count <value 1-32>
Description
The config dhcpv6_relay hops_count command is used to
configure the DHCPv6 relay hop count of the switch.
Parameters
<value 1-32> − The hop count is the number of relay agents that
have to be relayed in this message. The range is 1 to 32. The
default value is 4.
Restrictions
Only Administrator or operate-level users can issue this command.
DGS-1100-06/ME:5#config dhcpv6_relay hop_count 3
Command: config dhcpv6_relay hop_count 3
Success!
DGS-1100-06/ME:5#
To add the DHCPv6 relay on the Switch:
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
Example usage:
To configure the DHCPv6 relay hop count on the Switch:
82
Page 95
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
Command
Parameter
show packet ports
<portlist>
show error ports
<portlist>
show utilization
[ports {<portlist>} | cpu | mem]
clear counters
clear log
show log
{[index <value 1-500> - <value 1-500>] | module <string 32> | severity [debug |
informational | warning ]}
save log
enable syslog
disable syslog
show syslog
create syslog host
<index 1-4> ipaddress [<ipaddr> | <ipv6addr>] {severity [informational | warning |
debug] | facility [local0 | local1| local2 | local3 | local4 | local5 | local6 | local7] |
state [enable | disable] | udp_port [514 | <udp_port_number 6000-65535>]}
config syslog host
[all | <index 1-4>] {severity [informational | warning | debug] | facility [local0 |
local1 | local2 | local3 | local4 | local5 | local6 | local7] | state [enable | disable] |
udp_port [ 514 | <udp_port_number 6000-65535>] | ipaddress [<ipaddr> |
<ipv6addr>]}
delete syslog host
[<index 1-4> | all]
show syslog host
{<index 1-4>}
cable diagnostic port
[<portlist> | all]
show packet ports
Purpose
To display statistics about the packets sent and received in frames
per second by the Switch.
Syntax
show packet ports <portlist>
Description
The show packet ports command displays statistics about packets
sent and received by ports specified in the port list. The results are
separated into three tables, labeled A, B, and C in the window
below. Table A is relevant to the size of the packets, Table B is
relevant to the type of packets and Table C is relevant to the type of
13
NETWORK MONITORING COMMANDS
The Network Monitoring commands in the Command Line Interface (CLI) are listed (along with the
appropriate parameters) in the following table.
Each command is listed in detail, as follows:
83
Page 96
frame associated with these packets.
Parameters
<portlist> − A port or range of ports whose statistics are to be
displayed.
Restrictions
None.
Example usage:
DGS-1100-06/ME:5#show packet ports 1
Command: show packet ports 1
Port Number : 1
Frame Size Frame Counts Frames/sec Frame Type Total Total/sec
---------------- -------------------- ----------------- ----------------- --------- ---------------
64 0 0 RX Bytes 0 0
65-127 0 0 RX Frames 0 0
128-255 0 0
256-511 0 0 TX Bytes 0 0
512-1023 0 0 TX Frames 0 0
1024-1518 0 0
Unicast RX 0 0
Multicast RX 0 0
Broadcast RX 0 0
CTRL+C ESC q Quit SPACE n Next Page p Previous Page r Refresh
show error ports
Purpose
To display the error statistics for a port or a range of ports.
Syntax
show error ports <portlist>
Description
The show error ports command displays all of the packet error
statistics collected and logged by the Switch for a given port list.
Parameters
<portlist> − A port or range of ports whose error statistics are to be
displayed.
Restrictions
None.
DGS-1100-06/ME:5#show errors port 1
Command: show error ports 1
Port Number : 1
RX Frames TX Frames
----------------- ------------------ CRC Error 0 Excessive Deferral 0
To display the packets analysis for port 1:
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
Example usage:
To display the errors of port 1:
84
Page 97
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
Undersize 0 CRC Error 0
Oversize 0 Late Collision 0
Fragment 8 Excessive Collision 0
Jabber 0 Single Collision 0
Drop Pkts 0 Collision 0
DGS-1100-06/ME:5#
show utilization
Purpose
To display real-time port utilization statistics.
Syntax
show utilization [ports {<portlist>} | cpu | mem]
Description
The show utilization command displays the real-time utilization
statistics for ports in bits per second (bps) for the Switch, and for the
CPU in percentage..
Parameters
ports – Entering this parameter will display the current port utilization
of the Switch.
<portlist> – Specifies a range of ports to be displayed.
cpu – Entering this parameter will display the current CPU utilization
of the Switch.
mem – Entering this parameter will display the current memory
utilization of the Switch.
Restrictions
None.
DGS-1100-06/ME:5#show utilization ports 2
Command: show utilization ports 2
2 0 0 0
Port TX/sec RX/sec Util
------ -------- ---------- --- 2 0 0 0
CTRL+C ESC q Quit SPACE n Next Page p Previous Page r Refresh
DGS-1100-06/ME:5#
DGS-1100-06/ME:5#show utilization cpu
Command: show utilization cpu
Five Seconds - 6 % One Minute - 6 % Five Minutes - 6 %
Five Seconds - 7 % One Minute - 6 % Five Minutes - 6 %
Five Seconds - 7 % One Minute - 6 % Five Minutes - 6 %
CPU Utilization :
To display the port 2 utilization statistics:
To display the cpu utilization statistics:
85
Page 98
-------------------------------------------------------------------------------
Five Seconds - 7 % One Minute - 6 % Five Minutes - 6 %
CTRL+C ESC q Quit SPACE n Next Page p Previous Page r Refresh
DGS-1100-06/ME:5#
clear counters
Purpose
To clear the Switch’s statistics counters.
Syntax
clear counters
Description
The clear counters command clears the counters used by the
Switch to compile statistics.
Parameters
None.
Restrictions
Only Administrator or operator-level users can issue this command.
DGS-1100-06/ME:5# clear counters
Command: clear counters
DGS-1100-06/ME:5#
clear log
Purpose
To clear the Switch’s history log.
Syntax
clear log
Description
The clear log command clears the Switch’s history log.
Parameters
None.
Restrictions
Only administrator-level users can issue this command.
DGS-1100-06/ME:5#clear log
Command: clear log
Success!
DGS-1100-06/ME:5#
show log
Purpose
To display the Switch history log.
Syntax
show log {[index <value 1-500> - <value 1-500>] | module
<string 32> | severity [debug | informational | warning ]}
Description
The show log command displays the contents of the Switch’s
history log.
Example usage:
To clear the counters:
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
Example usage:
To clear the log information:
86
Page 99
Parameters
index <value 1-500> − The number of entries in the history log to
display.
module <string 32> − Specifies the module of log to be displayed.
severity [debug | informational | warning] − Specifies the severity
type to be displayed.
Restrictions
None.
Example usage:
DGS-1100-06/ME:5# show log
Command: show log
Index Time Log Text
------- ----------------------------- ------------------------------------------------------------------------------ 1 Jan 1 00:00:18 2012:SYSTEM-2:System started up
DGS-1100-06/ME:5#
save log
Purpose
To save the Switch history log.
Syntax
save log
Description
The save log command saves the contents of the Switch’s history
log.
Parameters
None.
Restrictions
Only Administrator or operator-level users can issue this command.
DGS-1100-06/ME:5# save log
Command: save log
Success!
DGS-1100-06/ME:5#
enable syslog
Purpose
To enable the system log to be sent to a remote host.
Syntax
enable syslog
Description
The enable syslog command enables the system log to be sent to a
remote host.
Parameters
None.
Restrictions
Only Administrator or operator-level users can issue this command.
To display the Switch history log:
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
Example usage:
To save the Switch history log:
Example usage:
87
Page 100
To enable the syslog function on the Switch:
DGS-1100-06/ME:5#enable syslog
Command: enable syslog
Success!
DGS-1100-06/ME:5#
disable syslog
Purpose
To disable the system log from being sent to a remote host.
Syntax
disable syslog
Description
The disable syslog command disables the system log from being
sent to a remote host.
Parameters
None.
Restrictions
Only Administrator or operator-level users can issue this command.
DGS-1100-06/ME:5#disable syslog
Command: disable syslog
Success!
DGS-1100-06/ME:5#
show syslog
Purpose
To display the syslog protocol status.
Syntax
show syslog
Description
The show syslog command displays the syslog status (enabled or
disabled).
Parameters
None.
Restrictions
None.
DGS-1100-06/ME:5#show syslog
Command: show syslog
Syslog Global State: Enabled
DGS-1100-06/ME:5#
create syslog host
Purpose
To create a new syslog host.
Example usage:
To disable the syslog function on the Switch:
DGS-1100-06/ME Metro Ethernet Managed Switch CLI Reference Guide
Example usage:
To display the current status of the syslog function:
88
Loading...