- Table of Contents
- Related Documents
-
Title | Size | Download |
---|---|---|
10-Track commands | 89.71 KB |
Contents
Track commands
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
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
Notification delay: Positive 20, Negative 30 (in seconds)
Tracked object:
BFD session mode: Echo
Outgoing interface: Vlan-interface2
VPN instance name: --
Remote IP: 192.168.40.1
Local IP: 192.168.40.2
Track ID: 3
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
Track ID: 4
State: Negative
Duration: 0 days 0 hours 0 minutes 32 seconds
Notification delay: Positive 20, Negative 30 (in seconds)
Tracked object:
CFD service instance: MEP 2 in Ethernet service instance 1
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: BGP
Nexthop interface : Vlan-Interface4
Track ID: 6
State: Positive
Duration: 0 days 0 hours 0 minutes 32 seconds
Notification delay: Positive 20, Negative 30 (in seconds)
Tracked object:
LLDP interface: GigabitEthernet1/0/5
# Display 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
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. |
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 BFD echo packets. |
VPN instance name |
Name of the VPN instance to which BFD session 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. |
LLDP interface |
Monitored LLDP interface. |
Type |
Monitored object type: · BFD. · CFD. · Interface. · LLDP. · NQA. · Route. |
Related commands
track bfd
track cfd
track interface
track interface physical
track interface protocol
track ip route reachability
track lldp neighbor
track nqa
track bfd
Use track bfd to create a track entry and associate it with a BFD session.
Use undo track to remove the track entry.
Syntax
track track-entry-number bfd echo interface interface-type interface-number remote ip remote-ip-address local ip local-ip-address [ 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 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.
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 bfd delay command to modify its notification delay settings. If you execute the track bfd 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 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 a BFD session.
Examples
# Associate track entry 1 with BFD to monitor the link between local IP address 1.1.1.2 and remote IP address 1.1.1.1 by sending BFD echo packets through VLAN-interface 2.
<Sysname> system-view
[Sysname] track 1 bfd echo interface vlan-interface 2 remote ip 1.1.1.1 local ip 1.1.1.2
Related commands
display track
track cfd
Use track cfd to create a track entry and associate it with CFD.
Use undo track to remove the track entry.
Syntax
track track-entry-number cfd cc service-instance instance-id mep mep-id [ 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.
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.
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 cfd delay command to modify its notification delay settings. If you execute the track cfd 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 cfd command again.
Examples
# Create track entry 1 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
Related commands
cfd mep
cfd service-instance
display track
track interface
Use track interface to create a track entry and associate it with the link state of an interface.
Use undo track to remove the track entry.
Syntax
track track-entry-number 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-type interface-number: Specifies an 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
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.
After a track entry is created, you can only use the track interface delay command to modify its notification delay settings. If you execute the track interface 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 interface command 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
Related commands
display ip interface brief (Layer 3—IP Services Command Reference)
display track
track interface physical
Use track interface physical to create a track entry and associate it with the physical state of an interface.
Use undo track to remove the track entry.
Syntax
track track-entry-number interface interface-type interface-number physical [ 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-type interface-number: Specifies an 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 interface physical delay command to modify its notification delay settings. If you execute the track interface physical 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 interface physical command 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
track interface protocol
Use track interface protocol to create a track entry and associate it with the protocol state of an interface.
Use undo track to remove the track entry.
Syntax
track track-entry-number interface interface-type interface-number protocol { ipv4 | ipv6 } [ 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-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.
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 interface protocol delay command to modify its notification delay settings. If you execute the track interface protocol 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 interface protocol command 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
Related commands
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 and associate it with a route entry.
Use undo track to remove the track entry.
Syntax
track track-entry-number ip route [ vpn-instance vpn-instance-name ] ip-address { mask-length | mask } reachability [ 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.
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.
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 ip route reachability delay command to modify its notification delay settings. If you execute the track ip route reachability 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 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 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
Related commands
display ip route (Layer 3—IP Routing Command Reference)
display track
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-enabled 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 Ten-GigabitEthernet 1/0/1.
<Sysname> system-view
[Sysname] track 1 lldp neighbor interface ten-gigabitethernet 1/0/1
Related commands
display track
track nqa
Use track nqa to create a track entry and associate it with the reaction entry of an NQA operation.
Use undo track to remove the track entry.
Syntax
track track-entry-number nqa entry admin-name operation-tag reaction item-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.
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.
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 nqa delay command to modify its notification delay settings. If you execute the track nqa 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 nqa command again.
Examples
# Create track entry 1 and associate it with reaction entry 3 of the NQA operation admin-test.
<Sysname> system-view
[Sysname] track 1 nqa entry admin test reaction 3
Related commands
display track