Operational Commands

ping

Syntax

ping ip-address|dns-name[rapid | detail][ttl time-to-live][tos type-of-service][size bytes][pattern pattern][source ip-address][interval seconds][{next-hop ip-address} | {interface interface-name} |[bypass-routing][count requests][do-not-fragment][router router-instance| service-name service-name][timeout timeout][fc fc-name|fc-queuefc-nameprofile{in|out}]

Context

<global>

Description

This command verifies the reachability of a remote host.

Parameters

ip-address

identifies the far-end IP address to which to send the ping request message

Values

ipv4-address         a.b.c.d

ipv6-address         x:x:x:x:x:x:x:x[-interface]

                              x:x:x:x:x:x:d.d.d.d[-interface]

                              x:   [0 to FFFF]H

                              d:   [0 to 255]D

                              interface: 32 chars max, mandatory

                              for link local addresses

dns-name

identifies the DNS name of the far-end device to which to send the ping request message, expressed as a character string up to 63 characters

rapid

changes the units for the interval from seconds to hundredths of seconds

detail

displays detailed information

time-to-live

specifies the TTL value for the MPLS label, expressed as a decimal integer

Values

1 to 128

type-of-service

specifies the service type

Values

0 to 255

bytes

specifies the request packet size in bytes, expressed as a decimal integer

Values

0 to 16384

pattern

specifies the pattern that will be used to fill the date portion in a ping packet. If no pattern is specified, position information will be filled instead.

Values

0 to 65535

source ip-address

specifies the IP address to be used

Values

ipv4-address         a.b.c.d

ipv6-address         x:x:x:x:x:x:x:x (eight 16-bit pieces)

                              x:x:x:x:x:x:d.d.d.d

                              x:   [0 to FFFF]H

                              d:   [0 to 255]D

seconds

defines the minimum amount of time, expressed as a decimal integer, that must expire before the next message request is sent.

This parameter is used to override the default request message send interval. If the interval is set to 1 s, and the timeout value is set to 10 s, the maximum time between message requests is 10 s and the minimum is 1 s. This depends upon the receipt of a message reply corresponding to the outstanding message request.

Values

1 to 10000

Default

1

next-hop ip-address

displays only the static routes with the specified next-hop IP address

Values

ipv4-address         a.b.c.d

ipv6-address         x:x:x:x:x:x:x:x (eight 16-bit pieces)

                              x:x:x:x:x:x:d.d.d.d

                              x:   [0 to FFFF]H

                              d:   [0 to 255]D

interface-name

specifies the name of an IP interface. The name must already exist in the config>router>interface context.

bypass-routing

specifies whether to send the ping request to a host on a directly attached network bypassing the routing table

requests

specifies the number of times to perform an OAM ping probe operation. Each OAM echo message request must either time out or receive a reply before the next message request is sent.

Values

1 to 100000

Default

5

do-not-fragment

sets the DF (Do not fragment) bit in the ICMP ping packet (does not apply to ICMPv6)

router-instance

specifies the router name or service ID

Values

router-name:      Base, management

service-id:           1 to 2147483647

Default

Base

service-name

the service name, up to 64 characters

timeout

specifies the amount of time that the router will wait for a message reply after sending the message request. If the timeout expires, the requesting router assumes that the message response will not be received. Any response received after the request times out will be silently discarded.

This value is used to override the default timeout value.

Values

1 to 10

Default

5

fc fc-name

specifies the forwarding class for ICMP echo-request packets, which controls the dot1p marking of packets based on the configured SAP egress or network QoS policy. The packets use the egress control queue. If the fc option is not specified, the ICMP echo-request packets use the nc forwarding class by default. The DSCP value in the ping packets is determined by the application icmp dscp setting in the sgt-qos configuration (see the 7705 SAR Quality of Service Guide, "Self-generated Traffic Commands", for sgt-qos command descriptions).

Values

be | l2 | af | l1 | h2 | ef | h1 | nc

Default

nc

fc-queue fc-name

specifies that the ICMP echo-request packets should use the egress data queue associated with the specified fc-nameinstead of the egress control queue (see the 7705 SAR Quality of Service Guide, "SGT Redirection" for more information)

Values

be | l2 | af | l1 | h2 | ef | h1 | nc

Default

nc

profile {in | out}

specifies the profile state of packets assigned to the specified forwarding class; this parameter applies only when the fc-queue parameter is configured

shutdown

Syntax

[no] shutdown

Context

config>port>ethernet>efm-oam

config>router>if>eth-cfm>mep

config>saa>test

config>service>epipe>sap>eth-cfm>mep

config>service>epipe>spoke-sdp>eth-cfm>mep

config>service>vpls>sap>eth-cfm>mep

config>service>vpls>mesh-sdp>eth-cfm>mep

config>service>vpls>spoke-sdp>eth-cfm>mep

config>test-oam>ldp-treetrace

config>test-oam>twamp>server

Description

The shutdown command administratively disables a test. A shutdown can only be performed if a test is not executing at the time the command is entered.

When a test is created, it remains in shutdown mode until a no shutdown command is executed.

In order to modify an existing test, it must first be shut down.

When used with the ethernet>efm-oam command, shutdown enables tunneling on the port (see tunneling), and no shutdown enables Ethernet EFM OAM 802.3ah.

The no form of this command sets the state of the test to operational.

Default

shutdown

traceroute

Syntax

traceroute [ip-address|dns-name][ttl ttl][wait milli-seconds][no-dns][source ip-address][tos type-of-service][router router-instance| service-name service-name]

Context

<global>

Description

This command determines the route to a destination address.

Parameters

ip-address

specifies the far-end IP address to which to send the traceroute request message

Values

ipv4-address         a.b.c.d

ipv6-address         x:x:x:x:x:x:x:x

                              x:x:x:x:x:x:d.d.d.d

                              x:   [0 to FFFF]H

                              d:   [0 to 255]D

dns-name

specifies the DNS name of the far-end device to which to send the traceroute request message, expressed as a character string

ttl

specifies the maximum Time-To-Live (TTL) value to include in the traceroute request, expressed as a decimal integer

Values

1 to 255

milli-seconds

specifies the time in milliseconds to wait for a response to a probe, expressed as a decimal integer

Values

10 to 60000

Default

5000

no-dns

when the no-dns keyword is specified, DNS lookups of the responding hosts will not be performed; only the IP addresses will be printed

Default

DNS lookups of the responding hosts are performed

source ip-address

specifies the source IP address to use as the source of the probe packets. If the IP address is not one of the device's interfaces, an error is returned.

Values

ipv4-address         a.b.c.d

ipv6-address         x:x:x:x:x:x:x:x (eight 16-bit pieces)

                              x:x:x:x:x:x:d.d.d.d

                              x:   [0 to FFFF]H

                              d:   [0 to 255]D

type-of-service

specifies the type-of-service (ToS) bits in the IP header of the probe packets, expressed as a decimal integer

Values

0 to 255

router-instance

specifies a router name or service ID

Values

router-name     Base, management

service-id          1 to 2147483647

Default

Base

service-name

the service name, up to 64 characters

Output

The following output is an example of traceroute information.

Destination Address Route Example
*A:ALU-1# traceroute 192.168.xx.xx4
traceroute to 192.168.xx.xx4, 30 hops max, 40 byte packets
 1  192.168.xx.xx4 0.000 ms  0.000 ms  0.000 ms
*A:ALU-1#