15-High Availability Command Reference

HomeSupportReference GuidesCommand ReferencesH3C Access Controllers Command References(R5426P02)-6W10415-High Availability Command Reference
03-Track commands
Title Size Download
03-Track commands 103.09 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 state 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 30 seconds for Boolean OR tracked list 101.

<Sysname> system-view

[Sysname] track 101 list boolean or

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

Related commands

track interface

track interface physical

track interface protocol

track ip route reachability

track list boolean

track list threshold percentage

track list threshold weight

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 a track entry by its ID in the range of 1 to 1024.

all: Specifies all track entries.

negative: Displays information about track entries in Negative state.

positive: Displays information about 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: 2.2.2.2

    Local IP: 1.1.1.1

    Interface: Vlan-interface1

  Tracked by:

    Track-list 6

    Track-list 7

Track ID: 3

  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: Vlan-interface3

    Protocol: IPv4

  Tracked by:

    Track-list 6

    Track-list 7

Track ID: 5

  State: Positive

  Duration: 0 days 0 hours 0 minutes 32 seconds

  Tracked object type: Route

  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 : Vlan-interface4

Track ID: 6

  State: Positive

  Duration: 0 days 0 hours 0 minutes 32 seconds

  Tracked object type: Percentage threshold list

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

  Threshold: Positive 40, Negative 30

  Percentage of positive objects: 50%

  Tracked objects:

    Object 1: Positive

    Object 3: Negative

Track ID: 7

  State: Positive

  Duration: 0 days 0 hours 0 minutes 32 seconds

  Tracked object type: Weight threshold list

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

  Threshold: Positive 50, Negative 30

  Positive weight/total weight: 50/80

  Tracked objects:

    Object 1: Positive, Weight: 50

Object 3: Negative, Weight: 30

Track ID: 8

  State: Positive

  Duration: 0 days 0 hours 0 minutes 32 seconds

  Tracked object type: Boolean and list

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

  Tracked objects:

    Object 1: Positive

    Object 3: Negative(not)

    Object 10: NotReady(not)

# 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 --              --              Vlan2

10   Negative Interface --              --              Vlan3

12   Negative List      --              --              --

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.

Type

Tracked object type:

·     Interface.

·     Route.

·     NQA.

·     List—Tracked list.

This field is displayed only when the display track brief command is executed.

Tracked object type

Tracked object type:

·     Interface.

·     Route.

·     NQA.

·     Boolean and list—Boolean AND list.

·     Boolean or list—Boolean OR list.

·     Percentage threshold list.

·     Weight threshold list.

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.

Threshold: Positive 40, Negative 30

Positive and negative state thresholds.

This field is displayed only when the tracked object type is Percentage threshold list or Weight threshold list.

Percentage of positive objects

Percentage of Positive objects in the tracked list.

This field is displayed only when the tracked object type is Percentage threshold list.

Positive weight/total weight: 50/80

Weight of Positive objects to the total weight of all objects in the tracked list.

This field is displayed only when the tracked object type is Weight threshold list.

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.

Outgoing interface

Outgoing interface of the packets.

VPN instance name

This field is not supported in the current software version.

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.

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.

Object 10 : Positive

State of a tracked object: Positive, NotReady, or Negative.

If the tracked object type is Weight threshold list, the weight of the object is also displayed.

If the (not) attribute is displayed, the tracked list will negate the state of the object.

Tracked by

Track entries that are tracking the track entry (tracked object).

Track-list 6

Tracked list that is tracking the track entry (tracked object).

 

Related commands

track interface

track interface physical

track interface protocol

track ip route reachability

track nqa

object

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

Use undo object to 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 in the range of 1 to 255 to the object. 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-100] object 1

[Sysname-track-100] 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 255. 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 0 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 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.

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.

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

Examples

# Create track entry 1 and associate it with the link state of interface VLAN-interface 10.

<Sysname> system-view

[Sysname] track 1 interface vlan-interface 10

[Sysname-track-1]

Related commands

delay

display ip interface brief (Network Connectivity 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 of a track entry, execute the undo track command to remove the track entry, and then create the track entry again.

Examples

# Create track entry 1 and associate it with the physical state of VLAN-interface 2.

<Sysname> system-view

[Sysname] track 1 interface vlan-interface 2 physical

[Sysname-track-1]

Related commands

delay

display ip interface brief (Network Connectivity Command Reference)

display track

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 the settings of a track entry, execute the undo track command to remove the track entry, and then create the track entry again.

Examples

# Create track entry 1 and associate it with the IPv4 protocol state of interface VLAN-interface 2.

<Sysname> system-view

[Sysname] track 1 interface vlan-interface 2 protocol ipv4

[Sysname-track-1]

Related commands

delay

display ip interface brief (Network Connectivity Command Reference)

display ipv6 interface brief (Network Connectivity 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 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.

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 the settings of a track entry, execute the undo track command to remove the track entry, and then create the track entry 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 problem 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 (Network Connectivity 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 of a track entry, execute the undo track command to remove the track entry, and then create the track entry 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 of a track entry, execute the undo track command to remove the track entry, and then create the track entry 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 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 the settings of a track entry, execute the undo track command to remove the track entry, and then create the track entry 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
新华三官网