HPE JL587A Reference guide

HPE FlexFabric 5710 Switch Series

Ne

twork Management and Monitoring

Command Reference

Software version: Release 671x and later

Document version: 6W100-20230822

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

-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

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

Description

traceroute to 1.1.2.2 (1.1.2.2) Display the route that

the IP packets traverse from the current device to the

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

-m

keyword.

bytes each packet Number of bytes of a probe packet.

Page is loading ...

HPE JL587A Reference guide

This manual is also suitable for

HPE JL587A Reference guide

Related papers

Other documents