11-High Availability

HomeSupportResource CenterH3C Access Controllers Command References(E5208P03 E5215P01 R5215P01)-6W10211-High Availability
02-Track commands
Title Size Download
02-Track commands 102.34 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 30 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 interface

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

all: Specifies all track entries.

negative: Displays track entries in Negative state.

positive: Displays 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: GigabitEthernet1/0/1

  Tracked by:

    Track-list 6

    Track-list 7

Track ID: 2

  State: Negative

  Duration: 0 days 0 hours 0 minutes 32 seconds

  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: 3

  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: 4

  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: 5

  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 --              --              GE1/0/1

10   Negative Interface --              --              GE1/0/2

12   Negative List      --              --              --

Table 1 Command output

Field

Description

Track ID

ID of a track entry.

State

States of a track entry:

·     PositiveThe tracked object operates correctly.

·     NotReadyThe tracked object is invalid.

·     NegativeThe tracked object is abnormal.

Duration

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

Type

Tracked object type:

·     Interface.

·     NQA.

·     List—Tracked list.

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

Tracked object type

Tracked object type:

·     Interface.

·     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.

IP route

Route associated with the track entry.

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

Protocol type of the route. This field displays N/A if the route does not exist.

Nexthop interface

Next hop of the route. This field displays N/A if the route does not exist.

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

Other track entries that are tracking the object.

This field is not displayed if the object type is tracked list.

 

Related commands

·     track interface

·     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 remove an 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 1 to 100. The percentage of negative 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 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 in the following conditions:

·     The percentage of positive objects is smaller than the positive state threshold value.

·     The percentage of negative objects is greater than the negative state threshold value.

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 negative 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 in the following conditions:

·     The total weight of positive objects is smaller than the positive state threshold value.

·     The total weight of negative objects is greater than the negative state threshold value.

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 to monitor 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.

For a track entry that monitors 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 to monitor the link state of VLAN-interface 10 and enter track entry view.

<Sysname> system-view

[Sysname] track 1 interface vlan-interface 10

[Sysname-track-1]

Related commands

·     delay

·     display track

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

track interface physical

Use track interface physical to create a track entry to monitor 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 to monitor the physical state of GigabitEthernet 1/0/1 and enter track entry view.

<Sysname> system-view

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

[Sysname-track-1]

Related commands

delay

track interface protocol

Use track interface protocol to create a track entry to monitor 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 the interface is up, the state of the track object is Positive. When the IPv4 protocol state of the 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 the interface is up, the state of the track object is Positive. When the IPv6 protocol state of the 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 for a 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 to monitor the IPv4 protocol state of VLAN-interface 2 and enter track entry view.

<Sysname> system-view

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

[Sysname-track-1]

Related commands

·     delay

·     display track

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

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

track ip route reachability

Use track ip route reachability to create a track entry to monitor the reachability of an IP route 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 destination IP address of the route in dotted decimal notation.

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

mask: Specifies the subnet mask of route 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 for a 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 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 IP route 10.1.1.0/24 and enter track entry view.

<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 and negative 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 and negative 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 to monitor 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 an NQA operation. The admin-name argument is a case-insensitive string of 1 to 32 characters that specifies the name of the administrator who created the NQA operation. The operation-tag argument is a case-insensitive string of 1 to 32 characters that specifies the NQA operation tag.

reaction item-number: Specifies a reaction entry of the NQA operation. The item-number argument specifies 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 for a 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 to monitor reaction entry 3 of NQA operation admin-test and enter track entry view.

<Sysname> system-view

[Sysname] track 1 nqa entry admin test reaction 3

[Sysname-track-1]

Related commands

·     delay

·     display track