15-High Availability Command Reference

HomeSupportSwitchesS12500R SeriesReference GuidesCommand ReferencesH3C S12500R Switch Router Series Command References(R51xx)-6W10115-High Availability Command Reference
09-Track commands
Title Size Download
09-Track commands 113.37 KB

Track commands

delay

Use delay to set the period of time that the Track module must wait before notifying the application module of track entry state changes.

Use undo delay to remove the notification delay configuration.

Syntax

delay { negative negative-time | positive positive-time } *

undo delay

Default

The Track module notifies the application module immediately when the track entry state changes.

Views

Track view

Predefined user roles

network-admin

Parameters

negative negative-time: Specifies the delay for notifying the application module that the track entry state has changed to negative. The negative-time argument represents the negative state notification delay in the range of 1 to 300 seconds.

positive positive-time: Specifies the delay for notifying the application module that the track entry state has changed to positive. The positive-time argument represents the positive state notification delay in the range of 1 to 300 seconds.

Usage guidelines

If the Track module immediately notifies the application module of a track entry state change but the route convergence is not complete, a communication failure might occur. In such cases, you can set a notification delay to avoid immediate notification of track entry status changes.

The notification delay settings do not take effect if the track entry is not associated with an application module.

If you execute this command multiple times, the most recent configuration takes effect.

Examples

# Set the negative state notification delay to 50 seconds and the positive state notification delay to 120 seconds for Boolean OR tracked list 101.

<Sysname> system-view

[Sysname] track 101 list boolean or

[Sysname-track-101] delay negative 50 positive 120

Related commands

track bfd

track interface

track ip route reachability

track list boolean

track list threshold percentage

track list threshold weight

track lldp neighbor

track nqa

display track

Use display track to display track entry information.

Syntax

display track { track-entry-number | all [ negative | positive ] } [ brief ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

track-entry-number: Specifies the track entry ID in the range of 1 to 1024.

all: Specifies all track entries.

negative: Specifies track entries in Negative state.

positive: Specifies track entries in Positive state.

brief: Displays brief information about track entries.

Examples

# Display information about all track entries.

<Sysname> display track all

Track ID: 1

  State: Positive

  Duration: 0 days 0 hours 0 minutes 7 seconds

  Tracked object type: NQA

  Notification delay: Positive 20, Negative 30 (in seconds)

  Tracked object:

    NQA entry: admin test

    Reaction: 10

    Remote IP/URL: --

    Local IP: --

    Interface: --

Track ID: 2

  State: NotReady

  Duration: 0 days 0 hours 0 minutes 32 seconds

  Tracked object type: BFD

  Notification delay: Positive 20, Negative 30 (in seconds)

  Tracked object:

    BFD session mode: Echo

    Outgoing interface: HundredGigE1/0/1

    VPN instance name: --

    Remote IP: 192.168.40.1

    Local IP: 192.168.40.2

Track ID: 4

  State: Negative

  Duration: 0 days 0 hours 0 minutes 32 seconds

  Tracked object type: Interface

  Notification delay: Positive 20, Negative 30 (in seconds)

  Tracked object:

    Interface: HundredGigE1/0/2

    Protocol: IPv4

Track ID: 5

  State: Positive

  Duration: 0 days 0 hours 0 minutes 32 seconds

  Notification delay: Positive 20, Negative 30 (in seconds)

  Tracked object:

    IP route: 0.0.0.0/0 reachability

    VPN instance name: --

    Protocol: Static

    Nexthop interface : HundredGigE1/0/3

# Display brief information about track entries in Negative state.

<Sysname> display track all negative brief

ID   Status   Type      Remote IP/URL   Local IP        Interface

1    Negative Interface --              --              HGE1/0/1

10   Negative Interface --              --              HGE1/0/2

Table 1 Command output

Field

Description

Track ID

ID of a track entry.

State

States of a track entry:

·     Positive—The tracked object operates correctly.

·     NotReady—The tracked object is invalid.

·     Negative—The tracked object is abnormal.

Duration

Time period during which the track entry stays in the state.

Tracked object type

Tracked object type:

·     BFD.

·     Interface.

·     Route.

·     NQA.

·     List.

·     LLDP.

Notification delay: Positive 20, Negative 30 (in seconds)

·     The Track module notifies the application modules that the status of the track entry changes to Positive after a delay time of 20 seconds.

·     The Track module notifies the application modules that the status of the track entry changes to Negative after a delay time of 30 seconds.

Tracked object

Tracked object associated with the track entry.

NQA entry

NQA operation associated with the track entry.

Reaction

Reaction entry associated with the track entry.

BFD session mode

BFD session mode. Only echo mode is supported.

Outgoing interface

Outgoing interface of the packets.

VPN instance name

Name of the VPN instance to which the packets belong. If the packets belong to the public network, two consecutive hyphens (--) are displayed.

Remote IP/URL

Remote IP address or URL. If no remote IP address or URL exists, two consecutive hyphens (--) are displayed.

Local IP

Local IP address. If no local IP address exists, two consecutive hyphens (--) are displayed.

Interface

Interface to be monitored. If no interface is to be monitored, two consecutive hyphens (--) are displayed.

Protocol

Link states or Layer 3 protocol states of the monitored interface:

·     None—Link status of the monitored interface.

·     IPv4—IPv4 protocol status of the monitored Layer 3 interface.

·     IPv6—IPv6 protocol status of the monitored Layer 3 interface.

IP route

Route associated with the track entry.

VPN instance name

Name of the VPN instance to which the route belongs. If the route belongs to the public network, two consecutive hyphens (--) are displayed.

Protocol

Protocol type of the route. If the route does not exist, N/A is displayed.

Nexthop interface

Next hop of the route. If the route does not exist, N/A is displayed.

Type

Monitored object type:

·     BFD.

·     Interface.

·     NQA.

·     Route.

·     LLDP.

 

Related commands

track bfd

track interface

track interface physical

track interface protocol

track ip route reachability

track lldp neighbor

track nqa

object

Use object to add a track entry as an object to a tracked list.

Use undo object remove the object from a tracked list

Syntax

object track-entry-number [ not ] [ weight weight ]

undo object track-entry-number

Default

A tracked list does not contain any objects.

Views

Track view

Predefined user roles

network-admin

Parameters

track-entry-number: Specifies a track entry by its ID in the range of 1 to 1024.

not: Negates the state of the object. For example, the tracked list regards the object as negative when the object is in positive state. This keyword is supported only by a Boolean list.

weight weight: Assigns a weight to the object, in the range of 1 to 255. This keyword is supported only by a weight threshold list. The default weight is 10.

Usage guidelines

The track entry ID of the object cannot be the same as the ID of the tracked list to which the object is added.

You can add a maximum of 16 objects to a tracked list.

Loops between track entries are not allowed. For example, after you add track entry 1 (object 1) to tracked list 2 and track entry 2 (object 2) to tracked list 3, you cannot add track entry 3 (object 3) to tracked list 1 because a loop will be created.

Examples

# Create Boolean AND list 100 and add track entries 1 and 2 as tracked objects to the list.

<Sysname> system-view

[Sysname] track 100 list boolean and

[Sysname-track-101] object 1

[Sysname-track-101] object 2 not

Related commands

track list boolean

track list threshold percentage

track list threshold weight

threshold percentage

Use threshold percentage to set the threshold values used to determine the state of a percentage threshold list.

Use undo threshold percentage to restore the default.

Syntax

threshold percentage { negative negative-threshold | positive positive-threshold } *

undo threshold percentage

Default

The negative state threshold is 0% and the positive state threshold is 1%.

Views

Track view

Predefined user roles

network-admin

Parameters

negative negative-threshold: Specifies the negative state threshold, in the range of 0 to 100. The percentage of positive objects must be equal to or smaller than the configured negative state threshold for the tracked list to be set to the negative state.

positive positive-threshold: Specifies the positive state threshold in the range of 0 to 100. The percentage of positive objects must be equal to or greater than the configured positive state threshold for the tracked list to be set to the positive state. The positive-threshold must be greater than the negative-threshold.

Usage guidelines

The state of a percentage threshold list remains unchanged if the percentage of positive objects is below the positive state threshold and above the negative state threshold.

This command is supported only by a percentage threshold list.

Examples

# Set the negative state threshold to 30% and the positive state threshold to 50% for percentage threshold list 1.

<Sysname> system-view

[Sysname] track 1 list threshold percentage

[Sysname-track-1] threshold percentage negative 30 positive 50

Related commands

track list threshold percentage

threshold weight

Use threshold weight to set the threshold values used to determine the state of a weight threshold list.

Use undo threshold weight to restore the default.

Syntax

threshold weight { negative negative-threshold | positive positive-threshold } *

undo threshold weight

Default

The negative state threshold is 0 and the positive state threshold is 1.

Views

Track view

Predefined user roles

network-admin

Parameters

negative negative-threshold: Specifies the negative state threshold in the range of 0 to 254. The total weight of positive objects must be equal to or smaller than the configured negative state threshold for the tracked list to be set to the negative state.

positive positive-threshold: Specifies the positive state threshold in the range of 1 to 255. The total weight of positive objects must be equal to or greater than the configured positive state threshold for the tracked list to be set to the positive state. The positive-threshold must be greater than the negative-threshold.

Usage guidelines

The state of a weight threshold list remains unchanged if the total weight of positive objects is below the positive state threshold and above the negative state threshold.

This command is supported only by a weight threshold list.

Examples

# Set the negative state threshold to 30 and the positive state threshold to 50 for weight threshold list 1.

<Sysname> system-view

[Sysname] track 1 list threshold weight

[Sysname-track-1] threshold weight negative 30 positive 50

Related commands

track list threshold weight

track bfd

Use track bfd to create a track entry associated with a BFD session and enter track entry view, or enter the view of an existing track entry.

Use undo track to remove the track entry and all configurations from its view.

Syntax

track track-entry-number bfd echo interface interface-type interface-number remote ip remote-ip-address local ip local-ip-address

undo track track-entry-number

Default

No track entries exist.

Views

System view

Predefined user roles

network-admin

Parameters

track-entry-number: Specifies the track entry ID in the range of 1 to 1024.

interface interface-type interface-number: Specifies the outgoing interface by its type and number of the BFD echo packets.

remote ip remote-ip-address: Specifies the destination IP address of the BFD echo packets.

local ip local-ip-address: Specifies the source IP address of the BFD echo packets.

Usage guidelines

To create a track entry, you must specify the tracked object type, which is bfd in this command.

To enter the view of an existing track entry, use the track track-entry-number command. The tracked object type is not required.

To modify the settings for a track entry, execute the undo track command to remove the track entry, and then execute the track bfd command again.

When you associate Track with BFD, the virtual IP address of a VRRP group cannot be the local or remote address of the BFD session.

Examples

# Associate track entry 1 with BFD to monitor the link between local IP address 192.168.40.2 and remote IP address 192.168.40.1 by sending BFD echo packets through HundredGigE 1/0/1.

<Sysname> system-view

[Sysname] track 1 bfd echo interface hundredgige 1/0/1 remote ip 192.168.40.1 local ip 192.168.40.2

[Sysname-track-1]

Related commands

delay

display track

track cfd

Use track cfd to create a track entry associated with CFD and enter track entry view, or enter the view of an existing track entry.

Use undo track to remove the track entry and all configurations from its view.

Syntax

track track-entry-number cfd cc service-instance instance-id mep mep-id

undo track track-entry-number

Default

No track entries exist.

Views

System view

Predefined user roles

network-admin

Parameters

track-entry-number: Specifies the track entry ID in the range of 1 to 1024.

service-instance instance-id: Specifies a service instance by its ID in the range of 1 to 32767.

mep mep-id: Specifies a MEP by its ID in the range of 1 to 8191.

Usage guidelines

To create a track entry, you must specify the tracked object type, which is cfd in this command.

To enter the view of an existing track entry, use the track track-entry-number command. The tracked object type is not required.

To modify the settings for a track entry, execute the undo track command to remove the track entry, and then execute the track cfd command again.

Examples

# Associate track entry 1 with CFD continuity check and specify the CFD service instance ID as 2 and MEP ID as 3.

<Sysname> system-view

[Sysname] track 1 cfd cc service-instance 2 mep 3

[Sysname-track-1]

Related commands

cfd mep

cfd service-instance

delay

display track

track interface

Use track interface to create a track entry associated with the link state of an interface and enter track entry view, or enter the view of an existing track entry.

Use undo track to remove the track entry and all configurations from its view.

Syntax

track track-entry-number interface interface-type interface-number

undo track track-entry-number

Default

No track entries exist.

Views

System view

Predefined user roles

network-admin

Parameters

track-entry-number: Specifies the track entry ID in the range of 1 to 1024.

interface-type interface-number: Specifies an interface by its type and number.

Usage guidelines

To create a track entry, you must specify the tracked object type, which is interface in this command.

To enter the view of an existing track entry, use the track track-entry-number command. The tracked object type is not required.

To modify the settings for a track entry, execute the undo track command to remove the track entry, and then execute the track interface command again.

When you associate Track with interface management to monitor the link status of an interface, the track entry state changes as follows:

·     The track entry state is positive if the link state of the interface is up.

·     The track entry state is negative if the link state of the interface is down.

To display the link state of an interface, use the display ip interface brief command.

Examples

# Create track entry 1 and associate it with the link state of interface HundredGigE 1/0/1.

<Sysname> system-view

[Sysname] track 1 interface hundredgige 1/0/1

[Sysname-track-1]

Related commands

delay

display ip interface brief (Layer 3—IP Services Command Reference)

display track

track interface physical

Use track interface physical to create a track entry associated with the physical state of an interface and enter track entry view, or enter the view of an existing track entry.

Use undo track to remove the track entry and all configurations from its view.

Syntax

track track-entry-number interface interface-type interface-number physical

undo track track-entry-number

Default

No track entries exist.

Views

System view

Predefined user roles

network-admin

Parameters

track-entry-number: Specifies the track entry ID in the range of 1 to 1024.

interface-type interface-number: Specifies an interface by its type and number.

Usage guidelines

To create a track entry, you must specify the tracked object type, which is interface physical in this command.

To enter the view of an existing track entry, use the track track-entry-number command. The tracked object type is not required.

To modify the settings for a track entry, execute the undo track command to remove the track entry, and then execute the track interface physical command again.

Examples

# Create track entry 1 and associate it with the physical state of HundredGigE 1/0/1.

<Sysname> system-view

[Sysname] track 1 interface hundredgige 1/0/1 physical

[Sysname-track-1]

Related commands

delay

track interface protocol

Use track interface protocol to create a track entry associated with the protocol state of an interface and enter track entry view, or enter the view of an existing track entry.

Use undo track to remove the track entry and all configurations from its view.

Syntax

track track-entry-number interface interface-type interface-number protocol { ipv4 | ipv6 }

undo track track-entry-number

Default

No track entries exist.

Views

System view

Predefined user roles

network-admin

Parameters

track-entry-number: Specifies the track entry ID in the range of 1 to 1024.

interface-type interface-number: Specifies an interface by its type and number.

ipv4: Monitors the IPv4 protocol state. When the IPv4 protocol state of an interface is up, the state of the track object is Positive. When the IPv4 protocol state of an interface is down, the state of the track object is Negative. To display the IPv4 protocol state of an interface, use the display ip interface brief command.

ipv6: Monitors the IPv6 protocol state. When the IPv6 protocol state of an interface is up, the state of the track object is Positive. When the IPv6 protocol state of an interface is down, the state of the track object is Negative. To display the IPv6 protocol state of an interface, use the display ipv6 interface brief command.

Usage guidelines

To create a track entry, you must specify the tracked object type, which is interface protocol in this command.

To enter the view of an existing track entry, use the track track-entry-number command. The tracked object type is not required.

To modify other settings for the track entry, execute the undo track command to remove the track entry, and then execute the track interface protocol command again.

Examples

# Create track entry 1 and associate it with the IPv4 protocol state of interface HundredGigE 1/0/1.

<Sysname> system-view

[Sysname] track 1 interface hundredgige 1/0/1 protocol ipv4

[Sysname-track-1]

Related commands

delay

display ip interface brief (Layer 3—IP Services Command Reference)

display ipv6 interface brief (Layer 3—IP Services Command Reference)

display track

track ip route reachability

Use track ip route reachability to create a track entry associated with a route entry and enter track entry view, or enter the view of an existing track entry.

Use undo track to remove the track entry and all configurations from its view.

Syntax

track track-entry-number ip route [ vpn-instance vpn-instance-name ] ip-address { mask-length | mask } reachability

undo track track-entry-number

Default

No track entries exist.

Views

System view

Predefined user roles

network-admin

Parameters

track-entry-number: Specifies the track entry ID in the range of 1 to 1024.

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this option, this command creates the track entry for routes on the public network.

ip-address: Specifies the IP address of the route entry associated with the track entry in dotted decimal notation.

mask-length: Specifies the mask length in the range of 0 to 32.

mask: Specifies the mask of the IP address, in dotted decimal notation.

Usage guidelines

To create a track entry, you must specify the tracked object type, which is ip route reachability in this command.

To enter the view of an existing track entry, use the track track-entry-number command. The tracked object type is not required.

To modify other settings for the track entry, execute the undo track command to remove the track entry, and then execute the track ip route reachability command again.

Route management does not immediately notify the Track module of the route status changes when the following conditions are met:

·     An active/standby device switchover or a RIB process switchover has occurred.

·     The status of the monitored route entry is changed before the routing protocol completes the graceful restart.

You can resolve the issue by configuring the nonstop routing feature.

Examples

# Create track entry 1 to monitor the status of the route entry 10.1.1.0/24.

<Sysname> system-view

[Sysname] track 1 ip route 10.1.1.0 24 reachability

[Sysname-track-1]

Related commands

delay

display ip route (Layer 3—IP Routing Command Reference)

display track

track list boolean

Use track list boolean to create a Boolean tracked list and enter its view, or enter the view of an existing tracked list.

Use undo track to remove the tracked list and all configurations from its view.

Syntax

track track-entry-number list boolean { and | or }

undo track track-entry-number

Default

No tracked lists exist.

Views

System view

Predefined user roles

network-admin

Parameters

track-entry-number: Specifies an ID for the tracked list in the range of 1 to 1024.

and: Calculates the tracked list state by using the Boolean AND operation.

or: Calculates the tracked list state by using the Boolean OR operation.

Usage guidelines

The state of a Boolean list is determined by the tracked object states based on the Boolean AND or Boolean OR operation.

·     Boolean AND list—The tracked list is set to the positive state only when all objects are in positive state. If one or more objects are in negative state, the tracked list is set to the negative state.

·     Boolean OR list—The tracked list is set to the positive state if any object is in positive state. If all objects are in negative state, the tracked list is set to the negative state.

To create a track entry, you must specify the tracked object type, which is list boolean in this command.

To enter the view of an existing track entry, use the track track-entry-number command. The tracked object type is not required.

To modify the settings for a track entry, execute the undo track command to remove the track entry, and then execute the track list boolean command again.

Examples

# Create Boolean OR list 101 and enter its view.

<Sysname> system-view

[Sysname] track 101 list boolean or

[Sysname-track-101]

Related commands

delay

object

track list threshold percentage

Use track list threshold percentage to create a percentage threshold tracked list and enter its view, or enter the view of an existing tracked list.

Use undo track to remove the tracked list and all configurations from its view.

Syntax

track track-entry-number list threshold percentage

undo track track-entry-number

Default

No tracked lists exist.

Views

System view

Predefined user roles

network-admin

Parameters

track-entry-number: Specifies an ID for the tracked list in the range of 1 to 1024.

Usage guidelines

The state of a percentage threshold list is determined by comparing the percentage of positive objects in the list with the percentage thresholds configured for the list.

To configure the threshold values used to determine the state of a percentage threshold list, use the threshold percentage command.

To create a track entry, you must specify the tracked object type, which is list threshold percentage in this command.

To enter the view of an existing track entry, use the track track-entry-number command. The tracked object type is not required.

To modify the settings for a track entry, execute the undo track command to remove the track entry, and then execute the track list threshold percentage command again.

Examples

# Create percentage threshold list 101 and enter its view.

<Sysname> system-view

[Sysname] track 101 list threshold percentage

[Sysname-track-101]

Related commands

delay

object

threshold percentage

track list threshold weight

Use track list threshold weight to create a weight threshold tracked list and enter its view, or enter the view of an existing tracked list.

Use undo track to remove the tracked list and all configurations from its view.

Syntax

track track-entry-number list threshold weight

undo track track-entry-number

Default

No tracked lists exist.

Views

System view

Predefined user roles

network-admin

Parameters

track-entry-number: Specifies an ID for the tracked list in the range of 1 to 1024.

Usage guidelines

The state of a weight threshold list is determined by comparing the weight of positive objects in the list with the weight thresholds configured for the list.

To configure the threshold values used to determine the state of a weight threshold list, use the threshold weight command.

To create a track entry, you must specify the tracked object type, which is list threshold weight in this command.

To enter the view of an existing track entry, use the track track-entry-number command. The tracked object type is not required.

To modify the settings for a track entry, execute the undo track command to remove the track entry, and then execute the track list threshold weight command again.

Examples

# Create weight threshold tracked list 101 and enter its view.

<Sysname> system-view

[Sysname] track 101 list threshold weight

[Sysname-track-101]

Related commands

delay

object

threshold weight

track lldp neighbor

Use track lldp neighbor to create a track entry and associate it with the neighbor availability status of an LLDP interface.

Use undo track to remove the track entry.

Syntax

track track-entry-number lldp neighbor interface interface-type interface-number [ delay { negative negative-time | positive positive-time } * ]

undo track track-entry-number

Default

No track entries exist.

Views

System view

Predefined user roles

network-admin

Parameters

track-entry-number: Specifies the track entry ID in the range of 1 to 1024.

interface interface-type interface-number: Specifies an LLDP interface by its type and number.

delay: Specifies the delay before the Track module notifies the application modules of the track entry state change. If you do not specify this keyword, the Track module notifies the application modules immediately when the track entry state changes.

negative negative-time: Specifies the delay before the Track module notifies the application modules that the track entry state has changed to Negative. The negative-time argument represents the notification delay in the range of 1 to 300 seconds.

positive positive-time: Specifies the delay before the Track module notifies the application modules that the track entry state has changed to Positive. The positive-time argument represents the notification delay in the range of 1 to 300 seconds.

Usage guidelines

After a track entry is created, you can only use the track lldp neighbor delay command to modify its notification delay settings. If you execute the track lldp neighbor delay command multiple times, the most recent configuration takes effect.

To modify other settings for the track entry, execute the undo track command to remove the track entry, and then execute the track lldp neighbor command again.

Examples

# Create track entry 1 to monitor the neighbor availability status of HundredGigE 1/0/1.

<Sysname> system-view

[Sysname] track 1 lldp neighbor interface hundredgige 1/0/1

Related commands

display track

track nqa

Use track nqa to create a track entry associated with the reaction entry of an NQA operation and enter track entry view, or enter the view of an existing track entry.

Use undo track to remove the track entry and all configurations from its view.

Syntax

track track-entry-number nqa entry admin-name operation-tag reaction item-number

undo track track-entry-number

Default

No track entries exist.

Views

System view

Predefined user roles

network-admin

Parameters

track-entry-number: Specifies the track entry ID in the range of 1 to 1024.

entry admin-name operation-tag: Specifies the NQA operation to be associated with the track entry. The admin-name argument specifies the name of the NQA operation administrator who creates the NQA operation, and is a case-insensitive string of 1 to 32 characters. The operation-tag argument specifies the NQA operation tag, and is a case-insensitive string of 1 to 32 characters.

reaction item-number: Specifies the reaction entry to be associated with the track entry. The item-number argument is the reaction entry ID in the range of 1 to 10.

Usage guidelines

To create a track entry, you must specify the tracked object type, which is nqa in this command.

To enter the view of an existing track entry, use the track track-entry-number command. The tracked object type is not required.

To modify other settings for the track entry, execute the undo track command to remove the track entry, and then execute the track nqa command again.

Examples

# Create track entry 1 and associate it with reaction entry 3 of NQA operation admin-test.

<Sysname> system-view

[Sysname] track 1 nqa entry admin test reaction 3

[Sysname-track-1]

Related commands

delay

display track

  • Cloud & AI
  • InterConnect
  • Intelligent Computing
  • Security
  • SMB Products
  • Intelligent Terminal Products
  • Product Support Services
  • Technical Service Solutions
All Services
  • Resource Center
  • Policy
  • Online Help
All Support
  • Become a Partner
  • Partner Resources
  • Partner Business Management
All Partners
  • Profile
  • News & Events
  • Online Exhibition Center
  • Contact Us
All About Us
新华三官网