To send internal
echo messages from one node to another, use the
ping command in
administration EXEC mode.
ping {control-eth | fabric} {fgid id | location node-id} [count pings] [debug] [interval milliseconds] [pattern random] [queue priority] [retries number] [size payload_size] [timeout seconds] [tlate seconds] [uc] [via-egressq] [via-fabricq-1]
Syntax Description
control-eth
|
Specifies a
control ethernet ping test.
|
fabric
|
Specifies a
fabric ping test.
|
fgid
id
|
Specifies
that a multicast ping is sent over a fabric to nodes with the fabric group
identifier (FGID) of 1024 through 1000000. Nodes that receive the ping respond
with a unicast packet.
|
location
node-id
|
Specifies
that a unicast ping is sent a node. The
node-id
argument is entered in the
rack/slot/module notation.
|
count
pings
|
(Optional)
Number of pings to send each time the command is run. The test reports results
and statistics after all pings have been sent and received (or timed out).
Range is from 0 through 4294967295. The default is 1.
|
debug
|
Note
|
This
keyword is available only if you specified the
fgid keyword.
|
(Optional)
Specifies verbose debugging of the multicast ping utility.
|
interval
milliseconds
|
(Optional)
Hold-off time between each ping in milliseconds. Range is from 0 through
4294967295. The total test time is as follows:
(count-1)
* (RTT + interval) + RTT
RTT =
Round Trip Time for the ping.
|
pattern
random
|
(Optional)
Specifies a data pattern for the ping packet payload.
|
queue
priority
|
Note
|
This
keyword is available only if you specified the
fgid keyword.
|
(Optional)
Specifies the priority of the queue. The priority can be 0 or 1.
|
retries
number
|
(Optional)
Maximum number of times a failed ping transmission is sent before the packet
transmission is considered a failure. Range is from 0 through 4294967295.
Note
|
Packet
transmission failure is usually an indication of a server software transient.
In this case, we recommend that you run the
ping command again.
|
|
size
payload_size
|
(Optional)
Specifies the payload size for each ping packet size. Range is from 0 through
4294967295 bytes. The maximum payload size allowed may be limited, depending on
the transport type that is used (fabric or control-ethernet).
|
timeout
seconds
|
(Optional)
Specifies the maximum time to wait for response to a ping. Range is from 0
through 4294967295 seconds.
If a ping
does not receive a response before the configured timeout expires, the ping
statistics reflect it as a discrepancy between the “Sent:” and “Rec'd:” packet
count, and the test is considered failed. Because of this, we recommend that
you do not set the timeout to 0.
|
tlate
seconds
|
Note
|
This
keyword is available only if you specified the
fgid keyword.
|
(Optional)
Specifies the amount of time to wait for a response to a multicast ping. The
amount of time you specify must be less than the value of the
timeout
keyword. Range is from 0 through 4294967295 seconds.
|
uc
|
Note
|
This
keyword is available only if you specified the
fgid keyword.
|
(Optional)
Specifies that unicast pings (instead of multicast pings) are sent to nodes
with the specified FGID.
|
via-egressq
|
(Optional)
Specifies that a unicast or multicast ping packet is routed to the first
fabricq ASIC (instance 0); then, to the egressq ASIC, and finally to the
destination CPU.
By
default, a unicast ping is routed to the first fabricq ASIC (instance 0), then
to the destination CPU. A multicast ping is routed to the constituent fabricq
ASIC instances, then to the destination CPU.
|
via-fabricq-1
|
Note
|
This
keyword is available if you specified the
location
keyword, or both the
fgid and
uc keywords.
|
(Optional)
Specifies that a unicast ping is routed to the current fabricq ASIC (instance
1), then to the egressq ASIC, and finally, to the destination CPU.
By
default, a unicast ping is routed to the first fabricq ASIC (instance 0), then
to the destination CPU.
|
Command Default
No default
behavior or values
Command Modes
Administration EXEC
Command History
Release
|
Modification
|
Release 3.3.0
|
This
command was introduced.
|
Release 3.6.0
|
The
fgid keyword
was added.
|
Release 3.8.0
|
The
via-egressq
and
via-fabricq-1
keywords were added.
|
Usage Guidelines
When you enter the
ping
command, a ping is sent to the node at the specified location or to nodes with
the specified FGID. The received response is compared byte-by-byte to the sent
packet. If a ping response is not received before the specified time-out, or if
the ping response does not match the transmitted ping, the ping is considered
failed.
A node that is
unreachable or intermittently working impacts the total run time for the test
as follows:
(received_packet_count * RTT + lost_packet_count * timeout + (count-1) * interval)
Line cards have
two fabricq ASICs and an egressq ASIC. From the first fabricq ASIC (instance
0), the CPU can be reached directly or via the egressq ASIC. From the second
fabricq ASIC (instance 1), the CPU can be reached only via the egressq ASIC. In
other words, no direct packet path exists between instance 1 and the CPU.
The route
processor (RP) and distributed route processor (DRP) cards have only one
fabricq ASIC per node (CPU) and no egressq ASIC. Therefore, a fabric ping on an
RP or DRP destination specified with the
via-egressq
or
via-fabricq-1
keyword fails.
Task ID
Task ID
|
Operations
|
diag
|
execute
|
Examples
The following
example shows sample output from a control-ethernet ping to an SP node in slot
0/0:
RP/0/RP0/CPU0:router# admin
RP/0/RP0/CPU0:router(admin)# ping control-eth location 0/0/SP count 5
Src node: 529 : 0/RP0/CPU0
Dest node: 0 : 0/0/SP
Local node: 529 : 0/RP0/CPU0
Packet cnt: 5 Packet size: 128 Payload ptn type: default (0)
Hold-off (ms): 300 Time-out(s): 2 Max retries: 5
Destination node has MAC addr 5246.4800.0000
Running CE node ping.
Please wait...
Src: 529:, Dest: 0, Sent: 5, Rec'd: 5, Mismatched: 0
Min/Avg/Max RTT: 0/200/1000
CE node ping succeeded for node: 0
The following
example shows a fabric ping from the active RP to the active RP. In this
example, the ping contains 72 packets of 1 kilobyte each. This command performs
a good coverage test of the entire switch fabric:
RP/0/RP0/CPU0:router# admin
RP/0/RP0/CPU0:router(admin)# ping fabric location 0/RP0/CPU0 count 72 size 1024
Src node: 529 : 0/RP0/CPU0
Dest node: 529 : 0/RP0/CPU0
Local node: 529 : 0/RP0/CPU0
Packet cnt: 72 Packet size: 1024 Payload ptn type: default (0)
Hold-off (ms): 300 Time-out(s): 2 Max retries: 5
Running Fabric node ping.
Please wait...
Src: 529:, Dest: 529, Sent: 72, Rec'd: 72, Mismatched: 0
Min/Avg/Max RTT: 3000/3013/4000
Fabric node ping succeeded for node: 529
The following
example shows a ping to a control Ethernet node that has a problem or does not
exist:
RP/0/RP0/CPU0:router# admin
RP/0/RP0/CPU0:router(admin)# ping control-eth location 0/1/CPU0 count 3
Src node: 529 : 0/RP0/CPU0
Dest node: 17 : 0/1/CPU0
Local node: 529 : 0/RP0/CPU0
Packet cnt: 3 Packet size: 128 Payload ptn type: default (0)
Hold-off (ms): 300 Time-out(s): 2 Max retries: 5
Destination node has MAC addr 5246.4800.0011
Running CE node ping.
Please wait...
Src: 529:, Dest: 17, Sent: 3, Rec'd: 0, Mismatched: 0
Requested ping failed for node: 17
The following
example shows how to send a multicast fabric ping to nodes with the FGID of
1024. The node that sent the multicast ping waits 1 second for a response from
each node.
RP/0/RP0/CPU0:router# admin
RP/0/RP0/CPU0:router(admin)# ping fabric fgid 1024 tlate 1
Src node: 513 : 0/RP0/CPU0
fgid: 1024
Local node: 513 : 0/RP0/CPU0
Packet cnt: 1 Packet size: 128 Payload ptn type: default (0)
Hold-off (ms): 1 Time-out(s): 2 Max retries: 5
DelayTimeout: 1 Priority: High
Running Fabric node ping.
Please wait...
Multicast (Pinging fgid) ...
Node Sent Rcv. Late Lost
______________________________________________________________
0/1/CPU0 (0x11:17) 1 1 0 0
0/4/CPU0 (0x41:65) 1 1 0 0
0/4/CPU1 (0x42:66) 1 1 0 0
0/6/CPU0 (0x61:97) 1 1 0 0
0/RP0/CPU0 (0x201:513) 1 1 0 0
0/RP1/CPU0 (0x211:529) 1 1 0 0
diag_ping: All 6 nodes responded to all 1 pings
The following
example shows how to send a multicast fabric ping to nodes with the FGID of
1024. The ping packets are routed from the first fabricq ASIC (instance 0) to
the destination CPU via the egressq ASIC. The pings to the two line cards
(0/1/CPU0 and 0/6/CPU0) succeeded, while the pings to the RPs (0/RP0/CPU0 and
0/RP1/CPU0) and DRPs (0/4/CPU0 and 0/4/CPU1) failed because they do not have an
egressq ASIC.
RP/0/RP0/CPU0:router# admin
RP/0/RP0/CPU0:router(admin)# ping fabric fgid 1024 count 10 via-egressq
Src node: 513 : 0/RP0/CPU0
fgid: 1024
Local node: 513 : 0/RP0/CPU0
Packet cnt: 10 Packet size: 128 Payload ptn type: default (0)
Hold-off (ms): 1 Time-out(s): 2 Max retries: 5
DelayTimeout: 1 Priority: High
Reaching destination CPUs via egressq
Running Fabric node ping.
Please wait...
Multicast (Pinging fgid) ...
Node Sent Rcv. Late Lost
______________________________________________________________
0/1/CPU0 (0x11:17) 10 10 0 0
0/4/CPU0 (0x41:65) 10 0 0 10
0/4/CPU1 (0x42:66) 10 0 0 10
0/6/CPU0 (0x61:97) 10 10 0 0
0/RP0/CPU0 (0x201:513) 10 0 0 10
0/RP1/CPU0 (0x211:529) 10 0 0 10
diag_ping: Out of 6 node(s), 2 node(s) responded to all 10 pings, 4 node(s) hads
The following
example shows how to send a unicast ping to nodes with the FGID of 1024. The
ping packets are routed from the second fabricq ASIC (instance 1) to the
destination CPU via the egressq ASIC. The pings to the two line cards (0/1/CPU0
and 0/6/CPU0) succeeded, while the pings to the RPs (0/RP0/CPU0 and 0/RP1/CPU0)
and DRPs (0/4/CPU0 and 0/4/CPU1) failed because they do not have a second
fabricq ASIC nor an egressq ASIC.
RP/0/RP0/CPU0:router# admin
RP/0/RP0/CPU0:router(admin)# ping fabric fgid 1024 count 10 uc via-fabricq-1
Src node: 513 : 0/RP0/CPU0
fgid: 1024
Local node: 513 : 0/RP0/CPU0
Packet cnt: 10 Packet size: 128 Payload ptn type: default (0)
Hold-off (ms): 1 Time-out(s): 2 Max retries: 5
DelayTimeout: 1 Priority: High
Using other fabricq instance
Running Fabric node ping.
Please wait...
Multicast (Pinging Individual Sponge Ids) ...
Node Sent Rcv. Late Lost
______________________________________________________________
0/1/CPU0 (0x11:17) 10 10 0 0
0/4/CPU0 (0x41:65) 10 0 0 10
0/4/CPU1 (0x42:66) 10 0 0 10
0/6/CPU0 (0x61:97) 10 10 0 0
0/RP0/CPU0 (0x201:513) 10 0 0 10
0/RP1/CPU0 (0x211:529) 10 0 0 10
diag_ping: Out of 6 node(s), 2 node(s) responded to all 10 pings, 4 node(s) hads