D-Link DGS-1100-06/ME Cli Reference Manual

D-Link™ DGS-1100-06/ME Ver.A1
Metro Ethernet Managed Switch
CLI Reference Guide
V1.0
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
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
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
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
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
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
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
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
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
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
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 Web­based management agent using the above IP address to connect to the Switch.
1
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
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 sub­commands, 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
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
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
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
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
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
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
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
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
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
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 Web­based 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
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
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
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
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
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
Loading...
+ 245 hidden pages