13.13. Track Commands

13.13.1. delay up

Command Purpose

Use this command to specify the delay time before communication state of track object changes to up.

Use the no form of this command to restore the default value.

Prerequisites

Platform

Software

License

Comments

AQ-N3000

7.0

Base

-

AQ-N5000

7.0

Base

-

AQ-N6000

7.0

Base

-

Command Syntax

delay up SECONDS

no delay up

Parameter

Parameter Description

Parameter Value

SECONDS

The delay time before the status of track turn up.

1-180 seconds

Command Mode

Track Configuration

Default

By default the delay time is 0.

Usage

None

Examples

In the following example, the delay up command is used to configure delay when object state is turned from down to up:

Switch# configure terminal
Switch(config)# track 1 interface eth-0-1 linkstate
Switch(config-track)# delay up 30

13.13.2. delay down

Command Purpose

Use this command to specify the delay time before communication state of track object changes to down.

Use the no form of this command to restore the default value.

Prerequisites

Platform

Software

License

Comments

AQ-N3000

7.0

Base

-

AQ-N5000

7.0

Base

-

AQ-N6000

7.0

Base

-

Command Syntax

delay down SECONDS

no delay down

Parameter

Parameter Description

Parameter Value

SECONDS

The delay time before the status of track turn down.

1 - 180 seconds

Command Mode

Track Configuration

Default

By default the delay time is 0.

Usage

None

Examples

In the following example, the delay down command is used to configure delay when object state is turned from up to down:

Switch# configure terminal
Switch(config)# track 1 interface eth-0-1 linkstate
Switch(config-track)# delay down 30

Related Commands

delay up

13.13.3. frequency

Command Purpose

Use this command to set the frequency of IP SLA operation.

Use the no form of this command to restore the default value.

Prerequisites

Platform

Software

License

Comments

AQ-N3000

7.0

Base

-

AQ-N5000

7.0

Base

-

AQ-N6000

7.0

Base

-

Command Syntax

frequency SECONDS

no frequency

Parameter

Parameter Description

Parameter Value

SECONDS

The frequency of IP SLA operation

1 - 4800 seconds

Command Mode

IP SLA Configuration

Default

The default value is 60 seconds.

Usage

The frequency value should follow this rule:

frequency > interval * (packets-per-test - 1) + timeout

Examples

In the following example, the frequency command is used to set the rate at which a specified IP SLAs operation repeats:

Switch# configure terminal
Switch(config)# ip sla monitor 1
Switch(config-ipsla)# frequency 10

Related Commands

show ip sla monitor

13.13.4. ip sla monitor

Command Purpose

To create an IP SLA entry and enter IP SLA monitor configuration mode, use ip sla monitor in CONFIG mode.

To delete an IP SLA entry, use the no form of this command.

Prerequisites

Platform

Software

License

Comments

AQ-N3000

7.0

Base

-

AQ-N5000

7.0

Base

-

AQ-N6000

7.0

Base

-

Command Syntax

ip sla monitor ENTRY-NUMBER

no ip sla monitor ENTRY-NUMBER

Parameter

Parameter Description

Parameter Value

ENTRY-NUMBER

Identify of IP SLA monitor entry

1 - 255

Command Mode

Global Config

Default

None

Usage

None

Examples

In the following example, the IP SLA monitor command is used to create an IP SLA monitor entry:

Switch# configure terminal
Switch(config)# ip sla monitor 1
Switch(config-ipsla)#

Related Commands

show ip sla monitor

13.13.5. description string

Command Purpose

To describe the IP SLA entry with a string.

Use the no form of this command to delete it.

Prerequisites

Platform

Software

License

Comments

AQ-N3000

7.0

Base

-

AQ-N5000

7.0

Base

-

AQ-N6000

7.0

Base

-

Command Syntax

description STRING

no description

Parameter

Parameter Description

Parameter Value

STRING

description string for IP SLA

String with up to 255 characters

Command Mode

IP SLA Configuration

Default

None

Usage

None

Examples

In the following example shows how to set IP SLA description:

Switch# configure terminal
Switch(config)# ip sla monitor 1
Switch(config-ipsla)#description thisisanexampler

Related Commands

None

13.13.6. ip sla monitor schedule

Command Purpose

To enable an IP SLA entry, use IP SLA monitor schedule command in CONFIG mode.

To disable an IP SLA entry, use the no form of this command.

Prerequisites

Platform

Software

License

Comments

AQ-N3000

7.0

Base

-

AQ-N5000

7.0

Base

-

AQ-N6000

7.0

Base

-

Command Syntax

ip sla monitor schedule (ENTRY-NUMBER)

Parameter

Parameter Description

Parameter Value

ENTRY-NUMBER

Identify of IP SLA monitor entry

1 - 255

Command Mode

Global Config

Default

None

Usage

None

Examples

In the following example, the IP SLA monitor schedule command is used to enable an IP SLA monitor entry:

Switch# configure terminal
Switch(config)# ip sla monitor 1
Switch(config-ipsla)# exit
Switch(config)# ip sla monitor schedule 1

Related Commands

show ip sla monitor

13.13.7. timeout

Command Purpose

Use this command to set the time value which IP SLA operation wait for the response.

Use the no form of this command to restore the default value.

Prerequisites

Platform

Software

License

Comments

AQ-N3000

7.0

Base

-

AQ-N5000

7.0

Base

-

AQ-N6000

7.0

Base

-

Command Syntax

timeout SECONDS

no timeout

Parameter

Parameter Description

Parameter Value

SECONDS

Time out value

1 - 4800 seconds

Command Mode

IP SLA Configuration

Default

The default value is 5 seconds.

Usage

The timeout value should follow this rule:

frequency > interval * (packets-per-test - 1) + timeout

Examples

In the following example, the timeout command is used to set the time range:

Switch# configure terminal
Switch(config)# ip sla monitor 1
Switch(config-ipsla)# timeout 10

Related Commands

show ip sla monitor

13.13.8. threshold

Command Purpose

Use this command to set the upper threshold value for calculating network monitoring statistics created by an IP SLAs operation.

Use the no form of this command to restore the default value.

Prerequisites

Platform

Software

License

Comments

AQ-N3000

7.0

Base

-

AQ-N5000

7.0

Base

-

AQ-N6000

7.0

Base

-

Command Syntax

threshold MILLISECONDS

no threshold

Parameter

Parameter Description

Parameter Value

MILLISECONDS

The upper threshold value for calculating network monitoring statistics created by an IP SLAs operation

1 - 4800000 milliseconds

Command Mode

IP SLA Configuration

Default

The default value is 5000 milliseconds.

Usage

None

Examples

In the following example, the threshold command is used to set the threshold time range:

Switch# configure terminal
Switch(config)# ip sla monitor 1
Switch(config-ipsla)# threshold 10000

Related Commands

show ip sla monitor

13.13.9. interval

Command Purpose

Use this command to set the interval between probe of each IP SLA test.

Use the no form of this command to restore the default value

Prerequisites

Platform

Software

License

Comments

AQ-N3000

7.0

Base

-

AQ-N5000

7.0

Base

-

AQ-N6000

7.0

Base

-

Command Syntax

interval SECONDS

no interval

Parameter

Parameter Description

Parameter Value

SECONDS

The interval between probe of each IP SLA test

1 - 4800 seconds

Command Mode

IP SLA Configuration

Default

The default value is 6 seconds.

Usage

The interval value should follow this rule:

(frequency > interval * (packets-per-test - 1) + timeout)

Examples

In the following example the interval command is used to set the IP SLA interval:

Switch# configure terminal
Switch(config)# ip sla monitor 1
Switch(config-ipsla)# interval 10

Related Commands

show ip sla monitor

13.13.10. ttl

Command Purpose

Use this command to set the TTL of ICMP request send by IPSLA test.

Use the no form of this command to restore the default value.

Prerequisites

Platform

Software

License

Comments

AQ-N3000

7.0

Base

-

AQ-N5000

7.0

Base

-

AQ-N6000

7.0

Base

-

Command Syntax

ttl VALUE

no ttl

Parameter

Parameter Description

Parameter Value

VALUE

TTL value

1 - 255

Command Mode

IP SLA Configuration

Default

64

Usage

None

Examples

The following example shows how to set TTL for IP SLA:

Switch# configure terminal
Switch(config)# ip sla monitor 1
Switch(config-ipsla)# ttl 100

Related Commands

show ip sla monitor

13.13.11. tos

Command Purpose

Use this command to set the TOS of ICMP request send by IP SLA test.

Use the no form of this command to restore the default value.

Prerequisites

Platform

Software

License

Comments

AQ-N3000

7.0

Base

-

AQ-N5000

7.0

Base

-

AQ-N6000

7.0

Base

-

Command Syntax

tos VALUE

no tos

Parameter

Parameter Description

Parameter Value

VALUE

TOS value

0 - 255

Command Mode

IP SLA Configuration

Default

0

Usage

None

Examples

The following example shows how to set TOS for IP SLA:

Switch# configure terminal
Switch(config)# ip sla monitor 1
Switch(config-ipsla)# tos 100

Related Commands

show ip sla monitor

13.13.12. data-size

Command Purpose

Use this command to set the protocol data size in the payload of an IP SLAs operation’s request packet.

Use the no form of this command to restore the default value.

Prerequisites

Platform

Software

License

Comments

AQ-N3000

7.0

Base

-

AQ-N5000

7.0

Base

-

AQ-N6000

7.0

Base

-

Command Syntax

data-size SIZE

no data-size

Parameter

Parameter Description

Parameter Value

SIZE

The protocol data size in the payload of an IP SLAs operation`s request packet

0 - 8100

Command Mode

IP SLA Configuration

Default

28

Usage

None

Examples

Switch# configure terminal
Switch(config)# ip sla monitor 1
Switch(config-ipsla)# data-size 100

Related Commands

show ip sla monitor

13.13.13. data-pattern

Command Purpose

Use this command to set the hexadecimal value for data pattern.

Use the no form of this command to restore the default value.

Prerequisites

Platform

Software

License

Comments

AQ-N3000

7.0

Base

-

AQ-N5000

7.0

Base

-

AQ-N6000

7.0

Base

-

Command Syntax

data-pattern HEX_STRING

no data-pattern

Parameter

Parameter Description

Parameter Value

HEX_STRING

Hex string for data patten

0 - 0xFFFFFFFF

Command Mode

IP SLA Configuration

Default

ABCDABCD

Usage

None

Examples

Switch# configure terminal
Switch(config)# ip sla monitor 1
Switch(config-ipsla)# data-pattern abababab

Related Commands

show ip sla monitor

13.13.14. fail-percent

Command Purpose

Use this command to set the fail percent used to judge test result.

Use the no form of this command to restore the default value.

Prerequisites

Platform

Software

License

Comments

AQ-N3000

7.0

Base

-

AQ-N5000

7.0

Base

-

AQ-N6000

7.0

Base

-

Command Syntax

fail-percent PERCENT

no fail-percent

Parameter

Parameter Description

Parameter Value

PERCENT

The fail percent used to judge test result

1 - 100

Command Mode

IP SLA Configuration

Default

100

Usage

None

Examples

Switch# configure terminal
Switch(config)# ip sla monitor 1
Switch(config-ipsla)# fail-percent 100

Related Commands

show ip sla monitor

13.13.15. packets-per-test

Command Purpose

Use this command to set the probe count of each test.

Use the no form of this command to restore the default value.

Prerequisites

Platform

Software

License

Comments

AQ-N3000

7.0

Base

-

AQ-N5000

7.0

Base

-

AQ-N6000

7.0

Base

-

Command Syntax

packets-per-test NUMBER

no packets-per-test

Parameter

Parameter Description

Parameter Value

NUMBER

The probe count of each test

1 - 10

Command Mode

IP SLA Configuration

Default

3

Usage

The packets-per-test value should follow this rule:

(frequency \> interval \* (packets-per-test - 1) + timeout)

Examples

Switch# configure terminal
Switch(config)# ip sla monitor 1
Switch(config-ipsla)# packets-per-test 5

Related Commands

show ip sla monitor

13.13.16. statistics (packet \|test)

Command Purpose

Use this command to set the statistics number of packet and recent test.

Use the no form of this command to restore the default value.

Prerequisites

Platform

Software

License

Comments

AQ-N3000

7.0

Base

-

AQ-N5000

7.0

Base

-

AQ-N6000

7.0

Base

-

Command Syntax

statistics (packet PKT_CNT|test TEST_CNT)

no statistics packet

no statistics test

Parameter

Parameter Description

Parameter Value

PKT_CNT

Packet Number for statistic

0 - 1000

TEST_CNT

The count of test for statistic

1 - 10

Command Mode

IP SLA Configuration

Default

packet: 50; test: 5

Usage

None

Examples

Switch# configure terminal
Switch(config)# ip sla monitor 1
Switch(config-ipsla)# statistics packet 60
Switch(config-ipsla)# statistics test 6

Related Commands

show ip sla monitor

13.13.17. clear ip sla statistics

Command Purpose

Use this command to clear IP SLA statistics.

Prerequisites

Platform

Software

License

Comments

AQ-N3000

7.0

Base

-

AQ-N5000

7.0

Base

-

AQ-N6000

7.0

Base

-

Command Syntax

clear ip sla statistics ENTRY_ID

Parameter

Parameter Description

Parameter Value

ENTRY_ID

IP SLA entry ID

1 - 255

Command Mode

Privileged EXEC

Default

None

Usage

None

Examples

Switch# clear ip sla statistics 1

Related Commands

show ip sla monitor

13.13.18. track

Command Purpose

To configure a track object, use the track command in Global Configuration mode.

Prerequisites

Platform

Software

License

Comments

AQ-N3000

7.0

Base

-

AQ-N5000

7.0

Base

-

AQ-N6000

7.0

Base

-

Command Syntax

track OBJECT_ID

Parameter

Parameter Description

Parameter Value

OBJECT_ID

Object identity is used to identify track object

1 - 500

Command Mode

Global Config

Default

None

Usage

None

Examples

In the following example, the track command is used to create a track object:

Switch# configure terminal
Switch(config)# track 1 interface eth-0-1 linkstate
Switch(config-track)#

Related Commands

show track

13.13.19. track interface linkstate

Command Purpose

Use this command to create a track object and track the state of an interface

Prerequisites

Platform

Software

License

Comments

AQ-N3000

7.0

Base

-

AQ-N5000

7.0

Base

-

AQ-N6000

7.0

Base

-

Command Syntax

track OBJECT_ID interface IFNAME linkstate

no track OBJECT_ID

Parameter

Parameter Description

Parameter Value

OBJECT_ID

Object identity is used to identify track object

1 - 500

IFNAME

Interface name

Physical/aggregation/loopback/VLAN/tunnelports

Command Mode

Global Config

Default

None

Usage

None

Examples

In the following example, the track interface linkstate command is used to create an track object:

Switch# configure terminal
Switch(config)# track 1 interface eth-0-1 linkstate
Switch(config-track)#

Related Commands

show track

13.13.20. track rtr reachability

Command Purpose

Create a track object and track the state of an IP SLA entry, use the track RTR reachability to command in Global Config mode. To remove a track, use the no form of this command.

When the state of IP SLA entry is OK or over-threshold, track object state is up; otherwise track object state is down.

Prerequisites

Platform

Software

License

Comments

AQ-N3000

7.0

Base

-

AQ-N5000

7.0

Base

-

AQ-N6000

7.0

Base

-

Command Syntax

track OBJECT_ID rtr ENTRY_ID reachability

no track OBJECT_ID

Parameter

Parameter Description

Parameter Value

OBJECT_ID

Object identity is used to identify track object

1 - 500

ENTRY_ID

IP SLA entry ID

1 - 255

Command Mode

Global Config

Default

None

Usage

None

Examples

In the following example, the track RTR reachability command is used to create a track object:

Switch# configure terminal
Switch(config)# ip sla monitor 1
Switch(config-ipsla)# exit
Switch(config)# track 1 rtr 1 reachability
Switch(config-track)#

Related Commands

show track

13.13.21. track rtr state

Command Purpose

Create a track object and track the state of an IP SLA entry, use the track RTR state command in Global Config mode. To remove a track, use the no form of this command.

When the state of IP SLA entry is OK, track object state is up; otherwise track object state is down.

Prerequisites

Platform

Software

License

Comments

AQ-N3000

7.0

Base

-

AQ-N5000

7.0

Base

-

AQ-N6000

7.0

Base

-

Command Syntax

track OBJECT_ID rtr ENTRY_ID state

no track OBJECT_ID

Parameter

Parameter Description

Parameter Value

OBJECT_ID

Object identity is used to identify track object

1 - 500

ENTRY_ID

IP SLA entry ID

1 - 255

Command Mode

Global Config

Default

None

Usage

None

Examples

In the following example, the track RTR state command is used to create a track object:

Switch# configure terminal
Switch(config)# ip sla monitor 1
Switch(config-ipsla)# exit
Switch(config)# track 1 rtr 1 state
Switch(config-track)#

Related Commands

show track

13.13.22. track bfd

Command Purpose

Create a track object and track the state of BFD session, use the track BFD command in Global Config mode. To remove a track, use the no form of this command.

When the state of BFD session is up, track object state is up; otherwise track object state is down.

Prerequisites

Platform

Software

License

Comments

AQ-N3000

7.0

Base

-

AQ-N5000

7.0

Base

-

AQ-N6000

7.0

Base

-

Command Syntax

track OBJECT_ID bfd source interface IFNAME destination IP_ADDR

no track OBJECT_ID

Parameter

Parameter Description

Parameter Value

OBJECT_ID

Object identity is used to identify track object

1 - 500

IFNAME

Interface name

Physical/aggregation/vlan/ports

IP_ADDR

Destination IP address of the BFD session

IPv4 Address

Command Mode

Global Config

Default

None

Usage

The source interface should be a Layer 3 interface and IP address should be configured.

The destination IP address should be in the same network of the interface IP address.

Examples

In the following example, the track BFD command is used to create a track object:

Switch# configure terminal
Switch(config)# interface eth-0-9
Switch(config-if)# no switchport
Switch(config-if)# no shutdown
Switch(config-if)# ip address 9.9.9.1/24
Switch(config-if)# quit
Switch(config)# track 1 bfd source interface eth-0-9 destination 9.9.9.2
Switch(config-track)#

Related Commands

show track

13.13.23. track cfm

Command Purpose

Create a track object and track the state of CFM, use the track CFM command in Global Config mode. To remove a track, use the no form of this command.

When the state of CFM is up, track object state is up; otherwise track object state is down.

Prerequisites

Platform

Software

License

Comments

AQ-N3000

7.0

Base

-

AQ-N5000

7.0

Base

-

AQ-N6000

7.0

Base

-

Command Syntax

track OBJECT_ID cfm domain DOMAIN_NAME service CSI_ID (rmepid MEPID| ) (rdi-trigger| )

no track OBJECT_ID

Parameter

Parameter Description

Parameter Value

OBJECT_ID

Object identity is used to identify track object

1 - 500

DOMAIN_NAME

Maintenance domain name

String with up to 43 characters

CSI_ID

Maintenance association name

The first character should be a-z or A-Z, character only can be 0-9A-Za-z.-_ and the max len is 43. MD (Maintenance domain) name and MA(Maintenance association) name totally up to 44 characters.

MEPID

Remote MEP ID

1 - 8191

Command Mode

Global Config

Default

None

Usage

None

Examples

In the following example, the track CFM command is used to create a track object:

Switch# configure terminal
Switch(config)# track 1 cfm domain tst service tst

Related Commands

show track

13.13.24. type icmp-echo

Command Purpose

Use this command to defines an Echo operation with ICMP packet and enters destination IP address.

Use the no form of this command to delete an Echo operation and destination IP address.

Prerequisites

Platform

Software

License

Comments

AQ-N3000

7.0

Base

-

AQ-N5000

7.0

Base

-

AQ-N6000

7.0

Base

-

Command Syntax

type icmp-echo IP_ADDR (source-interface IFNAME| ) (source-ip SRC_IP_ADDR| )

type icmp-echo IPv6_ADDR (source-interface IFNAME| ) (source-ip SRC_IPv6_ADDR| )

no type icmp-echo

Parameter

Parameter Description

Parameter Value

IP_ADDR

Destionation IP address of sending ICMP packet

IPv4 Address

IPv6_ADDR

Destionation IPv6 address of sending ICMPv6 packet

IPv6 Address

source-interface IFNAME

Source interface of sending ICMP packet

physical/aggregation/vlan/ports

SRC_IP_ADDR

Source IP address of sending ICMP packet

IPv4 Address

Command Mode

IP SLA Configuration

Default

None

Usage

If the interface specified by source-interface is not one of the out interfaces by routing, packets may not be sent out.

Examples

In the following example, the type echo protocol ipIcmpEcho command is used to set ICMP packet and destination IP address:

Switch# configure terminal
Switch(config)# ip sla monitor 1
Switch(config-ipsla)# type icmp-echo 192.168.0.1

In the following example, the type echo protocol ipIcmpEcho command is used to set ICMPv6 packet and destination IPv6 address:

Switch# configure terminal
Switch(config)# ip sla monitor 1
Switch(config-ipsla)# type icmp-echo 3000::3

Related Commands

show ip sla monitor

13.13.25. show ip sla monitor

Command Purpose

To show IP SLA entries, packet statistics and recent test result, use show IP SLA monitor in EXEC mode.

Prerequisites

Platform

Software

License

Comments

AQ-N3000

7.0

Base

-

AQ-N5000

7.0

Base

-

AQ-N6000

7.0

Base

-

Command Syntax

show ip sla monitor (ENTRY_ID) (statistics (packet|test)| )

Parameter

Parameter Description

Parameter Value

ENTRY_ID

Entry number is used to identify IP SLA monitor entry, its range is from 1 to 255

1 - 255

Command Mode

Privileged EXEC

Default

None

Usage

None

Examples

In the following example, the show IP SLA monitor command is used to show IP SLA monitor entries:

Switch# show ip sla monitor
Entry 1
Type : Echo
Admin state : Enable
Destination address : 192.168.0.1
Frequency : 3 seconds
Timeout : 2 seconds
Threshold : 1 seconds
Running Frequency : 3 seconds
Vrf : vpn1
Return code : OK

Related Commands

ip sla monitor

13.13.26. show track

Command Purpose

To show TRACK entries, use show track in EXEC mode.

Prerequisites

Platform

Software

License

Comments

AQ-N3000

7.0

Base

-

AQ-N5000

7.0

Base

-

AQ-N6000

7.0

Base

-

Command Syntax

show track OBJECT_ID

Parameter

Parameter Description

Parameter Value

OBJECT_ID

Object identity is used to identify track object

1 - 500

Command Mode

Privileged EXEC

Default

None

Usage

None

Examples

In the following example, the show track command is used to show track entries:

Switch# show track
Track 2
Type : Response Time Reporter(RTR) Reachability
Interface : eth-0-2
State : down
Delay up : 30 seconds
Delay down : 30 seconds

Related Commands

track

13.13.27. vrf

Command Purpose

To use IP SLA operations in VPNs, use VRF in IPSLA mode. To remove VPN feathers from IP SLA operations, use the no form of this command.

Prerequisites

Platform

Software

License

Comments

AQ-N3000

7.0

Base

-

AQ-N5000

7.0

Base

-

AQ-N6000

7.0

Base

-

Command Syntax

vrf NAME

no vrf

Parameter

Parameter Description

Parameter Value

NAME

VRF name

String with up to 15 characters

Command Mode

IP SLA Configuration

Default

None

Usage

None

Examples

In the following example, the VRF command is used to use IP SLA monitor entry in VPN:

Switch# configure terminal
Switch(config)# ip sla monitor 1
Switch(config-ipsla)# vrf vpn1

Related Commands

show ip sla monitor