JL585A

Aruba JL585A, FlexFabric 5710 Switch Series Network, JL586A, JL587A, JL588A, JL689A Reference guide

  • Hello! I am an AI chatbot trained to assist you with the Aruba JL585A Reference guide. I’ve already reviewed the document and can help you find the information you need or explain it in simple terms. Just ask your questions, and providing more details will help me assist you more effectively!
HPE FlexFabric 5710 Switch Series
Ne
twork Management and Monitoring
Command Reference
Software version: Release 671x and later
Document version: 6W100-20230822
© Copyright 2023 Hewlett Packard Enterprise Development LP
The information contained herein is subject to change without notice. The only warranties for Hewlett Packard
Enterprise products and services are set forth in the express warranty statements accompanying such
products and services. Nothing herein should be construed as constituting an additional warranty. Hewlett
Packard Enterprise shall not be liable for technical or editorial errors or omissions contained herein.
Confidential computer software. Valid license from Hewlett Packard Enterprise required for possession, use, or
copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software
Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor’s
standard commercial license.
Links to third-party websites take you outside the Hewlett Packard Enterprise website. Hewlett Packard
Enterprise has no control over and is not responsible for information outside the Hewlett Packard Enterprise
website.
Acknowledgments
Intel®, Itanium®, Pentium®, Intel Inside®, and the Intel Inside logo are trademarks of Intel Corporation in the
United States and other countries.
Microsoft® and Windows® are either registered trademarks or trademarks of Microsoft Corporation in the
United States and/or other countries.
Adobe® and Acrobat® are trademarks of Adobe Systems Incorporated.
Java and Oracle are registered trademarks of Oracle and/or its affiliates.
UNIX® is a registered trademark of The Open Group.
i
Contents
Ping, tracert, and system debugging commands ··········································· 1
debugging ·················································································································································· 1
display debugging ······································································································································ 2
ping ···························································································································································· 2
ping ipv6 ····················································································································································· 5
tracert ························································································································································· 7
tracert ipv6 ··············································································································································· 10
NQA commands ·························································································· 13
NQA client commands ····································································································································· 13
advantage-factor ······································································································································ 13
codec-type ················································································································································ 13
community read ········································································································································ 14
data-fill ······················································································································································ 15
data-size ··················································································································································· 16
description ················································································································································ 17
destination host ········································································································································ 18
destination ip ············································································································································ 18
destination ipv6 ········································································································································ 19
destination port ········································································································································· 20
display nqa history ··································································································································· 21
display nqa reaction counters ·················································································································· 22
display nqa result ····································································································································· 24
display nqa statistics ································································································································ 32
expect data ··············································································································································· 41
expect ip ··················································································································································· 42
expect ipv6 ··············································································································································· 42
expect status ············································································································································ 43
filename ···················································································································································· 44
frequency ················································································································································· 44
history-record enable ······························································································································· 45
history-record keep-time ·························································································································· 46
history-record number ······························································································································ 47
init-ttl ························································································································································· 47
key ···························································································································································· 48
lsr-path ····················································································································································· 48
max-failure ··············································································································································· 49
mode ························································································································································ 50
next-hop ip ··············································································································································· 50
next-hop ipv6 ············································································································································ 51
no-fragment enable ·································································································································· 52
nqa ··························································································································································· 52
nqa agent enable ····································································································································· 53
nqa schedule ············································································································································ 53
nqa template ············································································································································ 55
operation (FTP operation view) ················································································································ 56
operation (HTTP/HTTPS operation view) ································································································ 56
out interface ············································································································································· 57
password ·················································································································································· 58
priority 8021p ··········································································································································· 59
probe count ·············································································································································· 60
probe packet-interval ································································································································ 61
probe packet-number ······························································································································· 61
probe packet-timeout ······························································································································· 62
probe timeout ··········································································································································· 63
raw-request ·············································································································································· 64
reaction checked-element { jitter-ds | jitter-sd } ························································································ 64
ii
reaction checked-element { owd-ds | owd-sd } ························································································ 66
reaction checked-element icpif················································································································· 67
reaction checked-element mos ················································································································ 68
reaction checked-element packet-loss ····································································································· 69
reaction checked-element probe-duration································································································ 70
reaction checked-element probe-fail (for trap) ························································································· 71
reaction checked-element probe-fail (for trigger) ····················································································· 73
reaction checked-element rtt ···················································································································· 73
reaction trap ············································································································································· 75
reaction trigger per-probe ························································································································· 76
reaction trigger probe-fail ························································································································· 77
reaction trigger probe-pass ······················································································································ 77
resolve-target ··········································································································································· 78
resolve-type ·············································································································································· 79
route-option bypass-route ························································································································ 79
source interface (ICMP echo/UDP tracert operation view) ······································································ 80
source ip ··················································································································································· 81
source ipv6 ··············································································································································· 82
source port ··············································································································································· 83
ssl-client-policy ········································································································································· 84
statistics hold-time ···································································································································· 85
statistics interval ······································································································································· 85
statistics max-group ································································································································· 86
target-only ················································································································································ 87
tos ···························································································································································· 87
ttl ······························································································································································ 88
type ·························································································································································· 89
url ····························································································································································· 90
username ················································································································································· 91
version ······················································································································································ 91
vpn-instance ············································································································································· 92
NQA server commands ···································································································································· 93
display nqa server ···································································································································· 93
nqa server enable ···································································································································· 94
nqa server tcp-connect ····························································································································· 94
nqa server udp-echo ································································································································ 95
NTP commands ··························································································· 97
display ntp-service ipv6 sessions ············································································································· 97
display ntp-service sessions ·················································································································· 101
display ntp-service status ······················································································································· 105
display ntp-service trace ························································································································ 107
ntp-service acl ········································································································································ 108
ntp-service authentication enable ·········································································································· 109
ntp-service authentication-keyid ············································································································· 110
ntp-service broadcast-client ··················································································································· 112
ntp-service broadcast-server ·················································································································· 112
ntp-service dscp ····································································································································· 113
ntp-service enable ·································································································································· 114
ntp-service inbound enable ···················································································································· 114
ntp-service ipv6 acl ································································································································ 115
ntp-service ipv6 dscp ····························································································································· 116
ntp-service ipv6 inbound enable ············································································································ 117
ntp-service ipv6 multicast-client ············································································································· 117
ntp-service ipv6 multicast-server ············································································································ 118
ntp-service ipv6 source ·························································································································· 119
ntp-service ipv6 unicast-peer ················································································································· 120
ntp-service ipv6 unicast-server ·············································································································· 122
ntp-service max-dynamic-sessions ········································································································ 123
ntp-service multicast-client ····················································································································· 124
ntp-service multicast-server ··················································································································· 125
ntp-service noquery enable ···················································································································· 126
iii
ntp-service refclock-master ···················································································································· 127
ntp-service reliable authentication-keyid ································································································ 127
ntp-service source ·································································································································· 128
ntp-service time-offset-threshold ············································································································ 129
ntp-service unicast-peer ························································································································· 130
ntp-service unicast-server ······················································································································ 132
SNTP commands······················································································· 134
display sntp ipv6 sessions ······················································································································ 134
display sntp sessions ····························································································································· 134
sntp authentication enable ····················································································································· 135
sntp authentication-keyid ······················································································································· 136
sntp enable ············································································································································· 137
sntp ipv6 unicast-server ························································································································· 138
sntp reliable authentication-keyid ··········································································································· 139
sntp time-offset-threshold ······················································································································· 140
sntp unicast-server ································································································································· 140
PTP commands ························································································· 143
display ptp clock ····································································································································· 143
display ptp corrections ··························································································································· 144
display ptp foreign-masters-record ········································································································· 145
display ptp interface ······························································································································· 146
display ptp parent ··································································································································· 149
display ptp path-trace ····························································································································· 150
display ptp port-history ··························································································································· 151
display ptp statistics ······························································································································· 152
display ptp time-property ························································································································ 153
ptp active force-state ······························································································································ 155
ptp announce-interval ····························································································································· 155
ptp announce-timeout ···························································································································· 156
ptp asymmetry-correction ······················································································································· 157
ptp clock-step ········································································································································· 158
ptp delay-mechanism ····························································································································· 159
ptp destination-mac ································································································································ 160
ptp domain ············································································································································· 161
ptp dscp ·················································································································································· 162
ptp enable ·············································································································································· 163
ptp force-state ········································································································································ 164
ptp global enable ···································································································································· 165
ptp min-delayreq-interval ························································································································ 165
ptp mode ················································································································································ 167
ptp path-trace disable ····························································································································· 168
ptp pdelay-req-interval ··························································································································· 168
ptp port-mode ········································································································································· 169
ptp priority ·············································································································································· 170
ptp profile ··············································································································································· 171
ptp slave-only ········································································································································· 172
ptp source ·············································································································································· 173
ptp syn-interval ······································································································································· 174
ptp transport-protocol ····························································································································· 175
ptp unicast-destination ··························································································································· 175
ptp utc ···················································································································································· 176
ptp utc offset ··········································································································································· 177
ptp vlan ··················································································································································· 178
reset ptp statistics ·································································································································· 179
SNMP commands ······················································································ 181
display snmp-agent community ·············································································································· 181
display snmp-agent context ··················································································································· 183
display snmp-agent group ······················································································································ 183
display snmp-agent local-engineid ········································································································· 184
iv
display snmp-agent mib-node ················································································································ 185
display snmp-agent mib-view ················································································································· 189
display snmp-agent remote ···················································································································· 190
display snmp-agent statistics ················································································································· 191
display snmp-agent sys-info ··················································································································· 193
display snmp-agent trap queue ·············································································································· 194
display snmp-agent trapbuffer drop ······································································································· 194
display snmp-agent trapbuffer send ······································································································· 195
display snmp-agent trap-list ··················································································································· 195
display snmp-agent usm-user ················································································································ 196
enable snmp trap updown ······················································································································ 198
reset snmp-agent trapbuffer ··················································································································· 199
snmp-agent ············································································································································ 199
snmp-agent { inform | trap } source ········································································································ 200
snmp-agent calculate-password ············································································································ 201
snmp-agent community ·························································································································· 203
snmp-agent community-map ·················································································································· 206
snmp-agent configuration-examine interval ··························································································· 207
snmp-agent context ································································································································ 208
snmp-agent group ·································································································································· 208
snmp-agent local-engineid ····················································································································· 211
snmp-agent log ······································································································································ 211
snmp-agent mib-view ····························································································································· 212
snmp-agent packet max-size ················································································································· 213
snmp-agent packet response dscp ········································································································ 214
snmp-agent port ····································································································································· 215
snmp-agent remote ································································································································ 215
snmp-agent sys-info contact ·················································································································· 216
snmp-agent sys-info location ················································································································· 217
snmp-agent sys-info version ·················································································································· 217
snmp-agent target-host ·························································································································· 218
snmp-agent trap enable ························································································································· 221
snmp-agent trap format ·························································································································· 222
snmp-agent trap if-mib link extended ····································································································· 222
snmp-agent trap life ······························································································································· 223
snmp-agent trap log ······························································································································· 224
snmp-agent trap periodical-interval ········································································································ 224
snmp-agent trap queue-size ·················································································································· 225
snmp-agent trap withsn ·························································································································· 226
snmp-agent usm-user { v1 | v2c } ·········································································································· 226
snmp-agent usm-user v3 ······················································································································· 228
snmp-agent usm-user v3 user-role ········································································································ 233
RMON commands ····················································································· 234
display rmon alarm ································································································································· 234
display rmon event ································································································································· 235
display rmon eventlog ···························································································································· 236
display rmon history ······························································································································· 238
display rmon prialarm ····························································································································· 240
display rmon statistics ···························································································································· 241
rmon alarm ············································································································································· 243
rmon event ············································································································································· 245
rmon history ··········································································································································· 246
rmon prialarm ········································································································································· 247
rmon statistics ········································································································································ 249
Event MIB commands ················································································ 251
action ······················································································································································ 251
comparison ············································································································································· 252
context (action-set view) ························································································································ 253
context (trigger view) ······························································································································ 253
delta falling ············································································································································· 254
v
delta rising ·············································································································································· 255
description (event view) ························································································································· 256
description (trigger view) ························································································································ 256
display snmp mib event ·························································································································· 257
display snmp mib event event ················································································································ 258
display snmp mib event object list ·········································································································· 260
display snmp mib event summary ·········································································································· 261
display snmp mib event trigger ·············································································································· 262
event (trigger-Boolean view) ·················································································································· 265
event (trigger-existence view) ················································································································ 265
event enable ··········································································································································· 266
falling ······················································································································································ 267
frequency ··············································································································································· 268
object list (action-notification view)········································································································· 268
object list (trigger view) ·························································································································· 269
object list (trigger-Boolean view) ············································································································ 270
object list (trigger-existence view) ·········································································································· 271
object list (trigger-threshold view) ·········································································································· 271
oid (action-notification view) ··················································································································· 272
oid (action-set view) ······························································································································· 273
oid (trigger view) ····································································································································· 273
rising ······················································································································································· 274
sample ···················································································································································· 275
snmp mib event ······································································································································ 276
snmp mib event object list ······················································································································ 276
snmp mib event sample instance maximum ·························································································· 277
snmp mib event sample minimum ·········································································································· 278
snmp mib event trigger ··························································································································· 279
snmp-agent trap enable event-mib ········································································································ 279
startup (trigger-existence view) ·············································································································· 280
startup (trigger-threshold view) ·············································································································· 281
startup enable ········································································································································ 282
test ························································································································································· 282
trigger enable ········································································································································· 283
type ························································································································································ 284
value (action-set view) ··························································································································· 285
value (trigger-Boolean view) ·················································································································· 285
wildcard context (action-set view) ·········································································································· 286
wildcard context (trigger view) ················································································································ 287
wildcard oid (action-set view) ················································································································· 287
wildcard oid (trigger view) ······················································································································ 288
NETCONF commands ··············································································· 290
display netconf service ··························································································································· 290
display netconf session ·························································································································· 291
netconf capability specific-namespace ··································································································· 292
netconf idle-timeout ································································································································ 293
netconf log ·············································································································································· 294
netconf log xml2cli enable ······················································································································ 295
netconf soap acl ····································································································································· 296
netconf soap domain ······························································································································ 297
netconf soap dscp ·································································································································· 298
netconf soap enable ······························································································································· 299
netconf soap https ssl-server-policy ······································································································· 299
netconf ssh server enable ······················································································································ 300
netconf ssh server port ··························································································································· 301
reset netconf service statistics ··············································································································· 301
reset netconf session statistics ·············································································································· 302
xml ·························································································································································· 302
CWMP commands ····················································································· 304
cwmp ······················································································································································ 304
vi
cwmp acs default password ··················································································································· 304
cwmp acs default url ······························································································································ 305
cwmp acs default username ·················································································································· 306
cwmp acs password ······························································································································· 306
cwmp acs url ·········································································································································· 307
cwmp acs username ······························································································································ 308
cwmp cpe connect interface ··················································································································· 309
cwmp cpe connect retry ························································································································· 309
cwmp cpe inform interval ······················································································································· 310
cwmp cpe inform interval enable············································································································ 311
cwmp cpe inform time ···························································································································· 311
cwmp cpe password ······························································································································· 312
cwmp cpe provision-code ······················································································································· 313
cwmp cpe username ······························································································································ 313
cwmp cpe wait timeout ··························································································································· 314
cwmp enable ·········································································································································· 315
display cwmp configuration ···················································································································· 315
display cwmp status ······························································································································· 317
ssl client-policy ······································································································································· 318
EAA commands ························································································· 320
action cli ················································································································································· 320
action email ············································································································································ 321
action reboot ·········································································································································· 321
action switchover ···································································································································· 322
action syslog ·········································································································································· 323
commit ···················································································································································· 324
display rtm environment ························································································································· 324
display rtm policy ···································································································································· 325
event cli ·················································································································································· 327
event interface ········································································································································ 328
event period ··········································································································································· 330
event process ········································································································································· 331
event snmp oid ······································································································································· 332
event snmp-notification ·························································································································· 333
event syslog ··········································································································································· 334
event track ·············································································································································· 337
rtm cli-policy ··········································································································································· 338
rtm email domain ···································································································································· 339
rtm email max-size ································································································································· 340
rtm email username password ··············································································································· 340
rtm environment ····································································································································· 341
rtm event syslog buffer-size ··················································································································· 342
rtm scheduler suspend ··························································································································· 343
rtm tcl-policy ··········································································································································· 344
running-time ··········································································································································· 344
user-role ················································································································································· 345
Process monitoring and maintenance commands ······································ 347
display exception context ······················································································································· 347
display exception filepath ······················································································································· 351
display kernel deadloop ························································································································· 352
display kernel deadloop configuration ···································································································· 355
display kernel exception ························································································································· 356
display kernel reboot ······························································································································ 359
display kernel starvation ························································································································· 362
display kernel starvation configuration ··································································································· 364
display process ······································································································································ 365
display process cpu ································································································································ 368
display process log ································································································································· 369
display process memory ························································································································ 370
display process memory fragment free ·································································································· 372
vii
display process memory fragment used ································································································ 372
display process memory heap ··············································································································· 374
display process memory heap address·································································································· 375
display process memory heap size ········································································································ 376
exception filepath ··································································································································· 377
monitor kernel deadloop action ·············································································································· 378
monitor kernel deadloop enable ············································································································· 378
monitor kernel deadloop exclude-thread ································································································ 379
monitor kernel deadloop time ················································································································· 380
monitor kernel starvation enable ············································································································ 381
monitor kernel starvation exclude-thread ······························································································· 382
monitor kernel starvation time ················································································································ 383
monitor process ······································································································································ 384
monitor thread ········································································································································ 389
process core ··········································································································································· 392
reset exception context ·························································································································· 393
reset kernel deadloop ····························································································································· 393
reset kernel exception ···························································································································· 394
reset kernel reboot ································································································································· 394
reset kernel starvation ···························································································································· 395
third-part-process start ··························································································································· 395
third-part-process stop ··························································································································· 396
Port mirroring commands ··········································································· 398
display mirroring-group ·························································································································· 398
mirroring-group ······································································································································· 399
mirroring-group mirroring-cpu ················································································································ 399
mirroring-group mirroring-port (interface view) ······················································································· 400
mirroring-group mirroring-port (system view) ························································································· 401
mirroring-group monitor-egress ·············································································································· 403
mirroring-group monitor-port (interface view) ························································································· 404
mirroring-group monitor-port (system view) ··························································································· 405
mirroring-group reflector-port ················································································································· 406
mirroring-group remote-probe vlan ········································································································ 407
Flow mirroring commands ·········································································· 409
mirror-to cpu ··········································································································································· 409
mirror-to interface ··································································································································· 409
sFlow commands ······················································································· 413
display sflow ··········································································································································· 413
sflow agent ············································································································································· 414
sflow collector ········································································································································· 415
sflow counter collector ···························································································································· 416
sflow counter interval ····························································································································· 417
sflow flow collector ································································································································· 417
sflow flow max-header ··························································································································· 418
sflow sampling-mode random ················································································································ 419
sflow sampling-rate ································································································································ 420
sflow source ··········································································································································· 420
Information center commands ··································································· 422
diagnostic-logfile save ···························································································································· 422
display diagnostic-logfile summary ········································································································ 422
display info-center ·································································································································· 423
display info-center filter ·························································································································· 424
display logbuffer ····································································································································· 424
display logbuffer summary ····················································································································· 426
display logfile buffer ······························································································································· 427
display logfile summary ·························································································································· 428
display security-logfile buffer ·················································································································· 428
display security-logfile summary ············································································································ 429
viii
enable log updown ································································································································· 430
info-center diagnostic-logfile directory···································································································· 430
info-center diagnostic-logfile enable······································································································· 431
info-center diagnostic-logfile frequency·································································································· 431
info-center diagnostic-logfile quota ········································································································ 432
info-center enable ·································································································································· 433
info-center filter ······································································································································ 433
info-center format ··································································································································· 434
info-center logbuffer ······························································································································· 435
info-center logbuffer size ························································································································ 436
info-center logfile directory ····················································································································· 436
info-center logfile enable ························································································································ 437
info-center logfile frequency ··················································································································· 437
info-center logfile alarm-threshold ·········································································································· 438
info-center logfile size-quota ·················································································································· 439
info-center logging suppress duplicates ································································································· 439
info-center logging suppress module ····································································································· 440
info-center loghost ·································································································································· 441
info-center loghost locate-info with-sn···································································································· 442
info-center loghost source ······················································································································ 442
info-center security-logfile alarm-threshold ···························································································· 443
info-center security-logfile directory ······································································································· 444
info-center security-logfile enable ·········································································································· 444
info-center security-logfile frequency ····································································································· 445
info-center security-logfile size-quota····································································································· 445
info-center source ·································································································································· 446
info-center synchronous ························································································································· 447
info-center syslog min-age ····················································································································· 448
info-center syslog trap buffersize ··········································································································· 449
info-center timestamp ····························································································································· 450
info-center timestamp loghost ················································································································ 450
info-center trace-logfile quota ················································································································· 451
logfile save ············································································································································· 452
reset logbuffer ········································································································································ 452
security-logfile save ································································································································ 453
snmp-agent trap enable syslog ·············································································································· 453
terminal debugging ································································································································· 454
terminal logging level ····························································································································· 455
terminal monitor ····································································································································· 456
Packet capture commands ········································································ 457
display packet-capture status················································································································· 457
packet-capture interface ························································································································· 457
packet-capture local interface ················································································································ 460
packet-capture read ······························································································································· 462
packet-capture remote interface ············································································································ 462
packet-capture stop ································································································································ 463
VCF fabric commands ··············································································· 464
border enable ········································································································································· 464
display vcf-fabric role ····························································································································· 464
display vcf-fabric topology ······················································································································ 465
display vcf-fabric underlay autoconfigure ······························································································· 466
display vcf-fabric underlay template-version ·························································································· 470
gateway ip ·············································································································································· 471
l2agent enable ········································································································································ 471
l3agent enable ········································································································································ 472
network-type ··········································································································································· 472
neutron ··················································································································································· 473
proxy-arp enable ···································································································································· 473
rabbit durable-queue enable ·················································································································· 474
rabbit host ·············································································································································· 475
ix
rabbit password ······································································································································ 476
rabbit source-ip ······································································································································ 476
rabbit user ·············································································································································· 477
rabbit virtual-host ···································································································································· 478
restful user ············································································································································· 478
vcf-fabric role ·········································································································································· 479
vcf-fabric spine-role master ··················································································································· 480
vcf-fabric topology enable ······················································································································ 480
vcf-fabric underlay autoconfigure ··········································································································· 481
vcf-fabric underlay netconf-username ···································································································· 482
vcf-fabric underlay netconf-password ································································································ 482
vcf-fabric underlay pause ······················································································································· 483
vpn-target export-extcommunity ··········································································································· 484
vpn-target import-extcommunity ············································································································· 484
vsi-mac ··················································································································································· 485
Performance management commands ······················································ 487
binding ···················································································································································· 487
display performance-management statistics ·························································································· 487
display performance-management task ································································································· 490
performance-management ····················································································································· 491
sample interval ······································································································································· 492
statistics interval ····································································································································· 493
statistics enable ······································································································································ 494
statistics task ·········································································································································· 494
Document conventions and icons ······························································ 496
Conventions ··················································································································································· 496
Network topology icons ·································································································································· 497
Support and other resources ····································································· 498
Accessing Hewlett Packard Enterprise Support····························································································· 498
Accessing updates ········································································································································· 498
Websites ················································································································································ 499
Customer self repair ······························································································································· 499
Remote support ······································································································································ 499
Documentation feedback ······················································································································· 499
Index ·········································································································· 501
1
Ping, tracert, and system debugging
commands
debugging
Use debugging to enable debugging for a module.
Use undo debugging to disable debugging for a module or for all modules.
Syntax
debugging module-name [ option ]
undo debugging { all | module-name [ option ] }
Default
Debugging is disabled for all modules.
Views
User view
Predefined user roles
network-admin
Parameters
module-name: Specifies a module by its name, such as arp or device. For a list of supported
modules, use the debugging ? command.
option: Specifies the debugging option for a module. Available options vary by module. To display
the debugging options supported by a module, use the debugging module-name ? command.
all: Specifies all modules.
Usage guidelines
CAUTION:
Output of e
xcessive debugging messages increases the CPU usage and downgrades the system
performance.
To guarantee system performance, enable debugging only for modules that are in an
exceptional condition.
The system sends generated debug messages to the device information center, which then sends
the messages to appropriate destinations based on the log output configuration. For more
information about the information center, see Network Management and Monitoring Configuration
Guide.
To disable all types of debugging by using a shortcut method, press Ctrl+O. To display the shortcut
keys supported by the device, use the display hotkey command. If you log in to the device
through terminal software and shortcut key Ctrl+O has been used by the software, the shortcut key
cannot disable all types of debugging on the device.
Examples
# Enable debugging for the device management module.
<Sysname> debugging dev
Related commands
display debugging
2
display debugging
Use display debugging to display the enabled debugging features for a module or for all
modules.
Syntax
display debugging [ module-name ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
module-name: Specifies a module by its name. For a list of supported modules, use the display
debugging ? command. If you do not specify a module name, this command displays the enabled
debugging features for all modules.
Examples
# Display all enabled debugging features.
<Sysname> display debugging
DEV debugging switch is on
Related commands
debugging
ping
Use ping to test the reachability of the destination IP address and display ping statistics.
Syntax
ping [ ip ] [ -a source-ip | -c count | -f | -h ttl | -i interface-type
interface-number | -m interval | -n | -p pad | -q | -r | -s packet-size | -t
timeout | -tos tos | -v | -vpn-instance vpn-instance-name ] * host
Views
Any view
Predefined user roles
network-admin
Parameters
ip: Distinguishes between a destination host name and the ping command keywords if the name of
the destination host is i, ip, ipv, ipv6, l, ls, or lsp. For example, you must use the command in the
form of ping ip ip instead of ping ip if the destination host name is ip.
-a source-ip: Specifies an IP address of the device as the source IP address of ICMP echo
requests. If this option is not specified, the source IP address of ICMP echo requests is the primary
IP address of the outbound interface.
-c count: Specifies the number of ICMP echo requests that are sent to the destination. The value
range is 1 to 4294967295, and the default is 5.
-f: Sets the "Don’t Fragment" bit in the IP header.
3
-h ttl: Specifies the TTL value of ICMP echo requests. The value range is 1 to 255, and the default
is 255.
-i interface-type interface-number: Specifies the source interface for ICMP echo
requests. If you do not specify this option, the system uses the primary IP address of the matching
route's egress interface as the source interface for ICMP echo requests.
-m interval: Specifies the interval (in milliseconds) to send ICMP echo requests. The value range
is 1 to 65535, and the default is 200.
-n: Disables domain name resolution for the host argument. If the host argument represents the
host name of the destination, and if this keyword is not specified, the device translates host into an
address.
-p pad: Specifies the value of the pad field in an ICMP echo request, in hexadecimal format, 1 to 8
bits. The pad argument is in the range of 0 to ffffffff. If the specified value is less than 8 bits, 0s are
added in front of the value to extend it to 8 bits. For example, if pad is configured as 0x2f, then the
packets are padded with 0x0000002f to make the total length of the packet meet the requirements of
the device. By default, the padded value starts from 0x01 up to 0xff, where another round starts
again if necessary, such as 0x010203…feff01….
-q: Displays only the summary statistics. If this keyword is not specified, the system displays all the
ping statistics.
-r: Records the addresses of the hops (up to 9) the ICMP echo requests passed. If this keyword is
not specified, the addresses of the hops that the ICMP echo requests passed are not recorded.
-s packet-size: Specifies the length (in bytes) of ICMP echo requests (excluding the IP packet
header and the ICMP packet header). The value range is 20 to 9600, and the default is 56.
-t timeout: Specifies the timeout time (in milliseconds) of an ICMP echo reply. The value range is
0 to 65535, and the default is 2000. If the source does not receive an ICMP echo reply within the
timeout, it considers the ICMP echo reply timed out.
-tos tos: Specifies the ToS value of ICMP echo requests. The value range is 0 to 255, and the
default is 0.
-v: Displays non-ICMP echo reply packets. If this keyword is not specified, the system does not
display non-ICMP echo reply packets.
-vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance to which the
destination belongs. The vpn-instance-name argument represents the VPN instance name, a
case-sensitive string of 1 to 31 characters. If the destination is on the public network, do not specify
this option.
host: Specifies the IP address or host name of the destination. The host name is a case-insensitive
string of 1 to 253 characters. It can contain letters, digits, and special characters such as hyphen (-),
underscore (_), and dot (.).
Usage guidelines
To ping a device identified by its host name, configure the DNS settings on the device first. If the DNS
settings are not configured, the ping operation fails.
To abort the ping operation during the execution of the command, press Ctrl+C.
Examples
# Test whether the device with an IP address of 1.1.2.2 is reachable.
<Sysname> ping 1.1.2.2
Ping 1.1.2.2 (1.1.2.2): 56 data bytes, press CTRL+C to break
56 bytes from 1.1.2.2: icmp_seq=0 ttl=254 time=2.137 ms
56 bytes from 1.1.2.2: icmp_seq=1 ttl=254 time=2.051 ms
56 bytes from 1.1.2.2: icmp_seq=2 ttl=254 time=1.996 ms
4
56 bytes from 1.1.2.2: icmp_seq=3 ttl=254 time=1.963 ms
56 bytes from 1.1.2.2: icmp_seq=4 ttl=254 time=1.991 ms
--- Ping statistics for 1.1.2.2 ---
5 packet(s) transmitted, 5 packet(s) received, 0.0% packet loss
round-trip min/avg/max/std-dev = 1.963/2.028/2.137/0.062 ms
# Test whether the device with an IP address of 1.1.2.2 in VPN instance vpn1 is reachable.
<Sysname> ping -vpn-instance vpn1 1.1.2.2
Ping 1.1.2.2 (1.1.2.2): 56 data bytes, press CTRL+C to break
56 bytes from 1.1.2.2: icmp_seq=0 ttl=254 time=2.137 ms
56 bytes from 1.1.2.2: icmp_seq=1 ttl=254 time=2.051 ms
56 bytes from 1.1.2.2: icmp_seq=2 ttl=254 time=1.996 ms
56 bytes from 1.1.2.2: icmp_seq=3 ttl=254 time=1.963 ms
56 bytes from 1.1.2.2: icmp_seq=4 ttl=254 time=1.991 ms
--- Ping statistics for 1.1.2.2 in VPN instance vpn1 ---
5 packet(s) transmitted, 5 packet(s) received, 0.0% packet loss
round-trip min/avg/max/std-dev = 1.963/2.028/2.137/0.062 ms
# Test whether the device with an IP address of 1.1.2.2 is reachable. Only results are displayed.
<Sysname> ping -q 1.1.2.2
Ping 1.1.2.2 (1.1.2.2): 56 data bytes, press CTRL+C to break
--- Ping statistics for 1.1.2.2 ---
5 packet(s) transmitted, 5 packet(s) received, 0.0% packet loss
round-trip min/avg/max/std-dev = 1.962/2.196/2.665/0.244 ms
# Test whether the device with an IP address of 1.1.2.2 is reachable. The IP addresses of the hops
that the ICMP packets passed in the path are displayed.
<Sysname> ping -r 1.1.2.2
Ping 1.1.2.2 (1.1.2.2): 56 data bytes, press CTRL+C to break
56 bytes from 1.1.2.2: icmp_seq=0 ttl=254 time=4.685 ms
RR: 1.1.2.1
1.1.2.2
1.1.1.2
1.1.1.1
56 bytes from 1.1.2.2: icmp_seq=1 ttl=254 time=4.834 ms (same route)
56 bytes from 1.1.2.2: icmp_seq=2 ttl=254 time=4.770 ms (same route)
56 bytes from 1.1.2.2: icmp_seq=3 ttl=254 time=4.812 ms (same route)
56 bytes from 1.1.2.2: icmp_seq=4 ttl=254 time=4.704 ms (same route)
--- Ping statistics for 1.1.2.2 ---
5 packet(s) transmitted, 5 packet(s) received, 0.0% packet loss
round-trip min/avg/max/std-dev = 4.685/4.761/4.834/0.058 ms
The output shows the following information:
•
The destination is reachable.
•
The route is 1.1.1.1 <-> {1.1.1.2; 1.1.2.1} <-> 1.1.2.2.
5
Table 1 Command output
Field
Description
Ping 1.1.2.2 (1.1.2.2): 56 data
bytes, press CTRL+C to break
Test whether the device with IP address 1.1.2.2 is reachable. There
are 56 bytes in each ICMP echo request. Press escape key Ctrl+C to
abort the ping operation. The escape key is configurable by using the
escape-key command. For more information about this
command, see login management commands in Fundamentals
Command Reference.
56 bytes from 1.1.2.2: icmp_seq=0
ttl=254 time=4.685 ms
Received ICMP echo replies from the device whose IP address is
1.1.2.2. If no echo reply is received within the timeout period, no
information is displayed.
• bytes—Number of bytes in the ICMP echo reply.
• icmp_seq—Packet sequence, used to determine whether a
segment is lost, disordered or repeated.
• ttl—TTL value in the ICMP echo reply.
• time—Response time.
RR: Routers through which the ICMP echo request passed. They are
displayed in inversed order, which means the router with a smaller
distance to the destination is displayed first.
--- Ping statistics for 1.1.2.2 --- Statistics on data received and sent in the ping operation.
--- Ping statistics for 1.1.2.2 in VPN
instance vpn1 --- Ping statistics for a device in a VPN instance.
5 packet(s) transmitted Number of ICMP echo requests sent.
5 packet(s) received Number of ICMP echo replies received.
0.0% packet loss Percentage of unacknowledged packets to the total packets sent.
round-trip min/avg/max/std-dev =
4.685/4.761/4.834/0.058 ms Minimum/average/maximum/standard deviation response time, in
milliseconds.
ping ipv6
Use ping ipv6 to test the reachability of the destination IPv6 address and display IPv6 ping
statistics.
Syntax
ping ipv6 [ -a source-ipv6 | -c count | -i interface-type interface-number
| -m interval | -q | -s packet-size | -t timeout | -tc traffic-class| -v |
-vpn-instance vpn-instance-name ] * host
Views
Any view
Predefined user roles
network-admin
Parameters
-a source-ipv6: Specifies an IPv6 address of the device as the source IP address of ICMP echo
requests. If this option is not specified, the source IPv6 address of ICMP echo requests is the IPv6
address of the outbound interface. See RFC 3484 for information about the address selection rule.
-c count: Specifies the number of ICMPv6 echo requests that are sent to the destination. The
value range is 1 to 4294967295, and the default is 5.
6
-i interface-type interface-number: Specifies the source interface for ICMPv6 echo
requests. This option must be specified when the destination address is a multicast address or a link
local address. If you do not specify this option, the system uses the primary IP address of the
matching route's egress interface as the source interface for ICMPv6 echo requests.
-m interval: Specifies the interval (in milliseconds) to send an ICMPv6 echo reply. The value
range is 1 to 65535, and the default is 1000.
-q: Displays only the summary statistics. If you do not specify this keyword, the system displays all
the ping statistics.
-s packet-size: Specifies the length (in bytes) of ICMPv6 echo requests (excluding the IPv6
packet header and the ICMPv6 packet header). The value range is 20 to 9600, and the default is 56.
-t timeout: Specifies the timeout time (in milliseconds) of an ICMPv6 echo reply. The value range
is 0 to 65535, and the default is 2000.
-tc traffic-class: Specifies the traffic class value in an ICMPv6 packet. The value range is 0
to 255 and the default is 0.
-v: Displays detailed information (including the dst field and the idx field) about ICMPv6 echo
replies. If this keyword is not specified, the system only displays brief information (not including the
dst field and the idx field) about ICMPv6 echo replies.
-vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance to which the
destination belongs. The vpn-instance-name argument represents the VPN instance name, a
case-sensitive string of 1 to 31 characters. If the destination is on the public network, do not specify
this option.
host: Specifies the IPv6 address or host name of the destination. The host name is a
case-insensitive string of 1 to 253 characters. It can contain letters, digits, and special characters
such as hyphen (-), underscore (_), and dot (.).
Usage guidelines
To ping a device identified by its host name, configure the DNS settings on the device first. If the DNS
settings are not configured, the IPv6 ping operation fails.
To abort the IPv6 ping operation during the execution of the command, press Ctrl+C.
Examples
# Test whether the IPv6 address (2001::2) is reachable.
<Sysname> ping ipv6 2001::2
Ping6(56 data bytes) 2001::1 --> 2001::2, press CTRL+C to break
56 bytes from 2001::2, icmp_seq=0 hlim=64 time=62.000 ms
56 bytes from 2001::2, icmp_seq=1 hlim=64 time=23.000 ms
56 bytes from 2001::2, icmp_seq=2 hlim=64 time=20.000 ms
56 bytes from 2001::2, icmp_seq=3 hlim=64 time=4.000 ms
56 bytes from 2001::2, icmp_seq=4 hlim=64 time=16.000 ms
--- Ping6 statistics for 2001::2 ---
5 packet(s) transmitted, 5 packet(s) received, 0.0% packet loss
round-trip min/avg/max/std-dev = 4.000/25.000/62.000/20.000 ms
# Test whether the IPv6 address (2001::2) is reachable. Only the statistics are displayed.
<Sysname> ping ipv6 –q 2001::2
Ping6(56 data bytes) 2001::1 --> 2001::2, press CTRL+C to break
--- Ping6 statistics for 2001::2 ---
5 packet(s) transmitted, 5 packet(s) received, 0.0% packet loss
7
round-trip min/avg/max/std-dev = 4.000/25.000/62.000/20.000 ms
# Test whether the IPv6 address (2001::2) is reachable. Detailed ping information is displayed.
<Sysname> ping ipv6 –v 2001::2
Ping6(56 data bytes) 2001::1 --> 2001::2, press CTRL+C to break
56 bytes from 2001::2, icmp_seq=0 hlim=64 dst=2001::1 idx=3 time=62.000 ms
56 bytes from 2001::2, icmp_seq=1 hlim=64 dst=2001::1 idx=3 time=23.000 ms
56 bytes from 2001::2, icmp_seq=2 hlim=64 dst=2001::1 idx=3 time=20.000 ms
56 bytes from 2001::2, icmp_seq=3 hlim=64 dst=2001::1 idx=3 time=4.000 ms
56 bytes from 2001::2, icmp_seq=4 hlim=64 dst=2001::1 idx=3 time=16.000 ms
--- Ping6 statistics for 2001::2 ---
5 packet(s) transmitted, 5 packet(s) received, 0.0% packet loss
round-trip min/avg/max/std-dev = 4.000/25.000/62.000/20.000 ms
Table 2 Command output
Field
Description
Ping6(56 data bytes)
2001::1 --> 2001::2, press CTRL+C
to break
An ICMPv6 echo reply with a data length of 56 bytes is sent from
2001::1 to 2001::2.
Press escape key Ctrl+C to abort the IPv6 ping operation. The
escape key is configurable by using the escape-key
command.
For more information about this command, see login management
commands in Fundamentals Command Reference.
56 bytes from 2001::2,
icmp_seq=1 hlim=64 dst=2001::1
idx=3 time=62.000 ms
Received ICMPv6 echo replies from the device whose IPv6 address
is 2001::2.
• The number of data bytes is 56.
• The packet sequence is 1.
• The hop limit value is 64.
• The destination address is 2001::1. Specify the -v keyword to
display this field.
• The index for the packet inbound interface is 3. Specify the -v
keyword to display this field.
• The response time is 62 milliseconds.
--- Ping6 statistics for 2001::2 ------ Statistics on data received and sent in an IPv6 ping operation.
5 packet(s) transmitted Number of ICMPv6 echo requests sent.
5 packet(s) received Number of ICMPv6 echo replies received.
0.0% packet loss Percentage of unacknowledged packets to the total packets sent.
round-trip min/avg/max/ std-dev
=4.000/25.000/62.000/20.000 ms Minimum/average/maximum/standard deviation response time, in
milliseconds.
tracert
Use tracert to trace the path that the packets traverse from source to destination.
Syntax
tracert [ -a source-ip | –e | -f first-ttl | -m max-ttl | -p port | -q
packet-number | -t tos | -vpn-instance vpn-instance-name [ -resolve-as
{ global | none | vpn } ] | -w timeout ] * host
8
Views
Any view
Predefined user roles
network-admin
Parameters
-a source-ip: Specifies an IP address of the device as the source IP address of probe packets. If
this option is not specified, the source IP address of probe packets is the primary IP address of the
outbound interface.
-e: Enables the device to use a fixed destination port number in probe packets. If you do not specify
this keyword, the device increases the destination port number by 1 each time it sends probe
packets to the destination in a tracert operation. Some firewall devices might falsely identify tracert
probe packets with incremental destination port numbers as port scanning attack packets. If such a
device exists, specify the -e keyword to ensure that the tracert operation can be performed correctly.
-f first-ttl: Specifies the TTL of the first packet sent to the destination. The value range is 1 to
255, and the default is 1. It must be no greater than the value of the max-ttl argument.
-m max-ttl: Specifies the maximum number of hops allowed for a probe packet. The value range
is 1 to 255, and the default is 30. It must be no smaller than the value of the first-ttl argument.
-p port: Specifies an invalid UDP port of the destination. The value range is 1 to 65535, and the
default is 33434.
-q packet-number: Specifies the number of probe packets to send per hop. The value range is 1
to 65535, and the default is 3.
-t tos: Specifies the ToS value of probe packets. The value range is 0 to 255, and the default is 0.
-vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance to which the
destination belongs. The vpn-instance-name argument represents the VPN instance name, a
case-sensitive string of 1 to 31 characters. If the destination is on the public network, do not specify
this option.
-resolve-as: Specifies a routing table for autonomous system (AS) resolution. Tracert searches
the specified routing table for the AS that each hop along the path belongs to. If you do not specify
this keyword, the global routing table is used. If the AS information is found, this command displays
the AS number next to the address of the hop in the probe result.
•
global: Specifies the global routing table.
•
none: Disables AS resolution.
•
vpn: Specifies the VPN routing table.
-w timeout: Specifies the timeout time in milliseconds of the reply packet for a probe packet. The
value range is 1 to 65535, and the default is 5000.
host: Specifies the IP address or host name of the destination. The host name is a case-insensitive
string of 1 to 253 characters. It can contain letters, digits, and special characters such as hyphen (-),
underscore (_), and dot (.).
Usage guidelines
After identifying network failure with the ping command, use the tracert command to locate
failed nodes.
If the destination address is on the public network, you do not need to specify the -resolve-as
keyword to obtain the AS information. The device automatically uses the global routing table for AS
resolution.
If the destination address is on a private network, address information of intermediate hops might be
stored in either the global routing table or the VPN routing table. To learn the AS path that the
9
packets traverse, execute the tracert command twice, once with the -resolve-as global
keywords and again with the -resolve-as vpn keywords.
The output from the tracert command includes IP addresses of all the Layer 3 devices that the
packets traverse from source to destination. Asterisks (* * *) are displayed if the device cannot reply
with an ICMP error message. The reason might be the destination is unreachable or sending ICMP
timeout/destination unreachable packets is disabled.
Before starting a tracert operation, you must enable sending of ICMP destination unreachable
messages on the intermediate devices between the source and destination. The tracert operation
stops if any one of the following ICMP destination unreachable messages is received:
•
!N—Network unreachable.
•
!H—Destination host unreachable.
•
!P—Protocol unreachable. The protocol number is unknown.
•
!F—Fragmentation needed. This message indicates that packet fragmentation is needed but
the "Don’t Fragment" bit is set on an immediate device.
•
!W—Destination host unknown.
•
!Q—Network unreachable for ToS.
•
!T—Host unreachable for ToS.
•
!X—Communication administratively prohibited by filtering policies.
•
!V—Host precedence violation.
•
!C—Precedence cutoff in effect.
To abort the tracert operation during the execution of the command, press Ctrl+C.
Examples
# Display the path that the packets traverse from source to destination (1.1.2.2).
<Sysname> tracert 1.1.2.2
traceroute to 1.1.2.2 (1.1.2.2), 30 hops at most, 40 bytes each packet, press CTRL+C to
break
1 1.1.1.2 (1.1.1.2) 673 ms 425 ms 30 ms
2 1.1.2.2 (1.1.2.2) [AS 100] 580 ms 470 ms 80 ms
# Display the path that the packets traverse from source to destination (1.1.3.2) in VPN instance
vpn1, as well as the AS information of the hops along the path.
<Sysname> tracert –vpn-instance vpn1 –resolve-as vpn 1.1.3.2
traceroute to 1.1.3.2 (1.1.3.2), 30 hops at most, 40 bytes each packet, press CTRL+C to
break
1 1.1.1.2 (1.1.1.2) 673 ms 425 ms 30 ms
2 1.1.2.2 (1.1.2.2) 580 ms 470 ms 80 ms
3 1.1.3.2 (1.1.3.2) [AS 65535] 530 ms 472 ms 380 ms
Table 3 Command output
Field
traceroute to 1.1.2.2 (1.1.2.2) Display the route that
device whose IP address is 1.1.2.2.
hops at most Maximum number of hops of the probe packets, which can be set by the
keyword.
bytes each packet Number of bytes of a probe packet.
/