The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
This chapter describes how to configure object tracking on the Cisco NX-OS device.
This chapter includes the following sections:
Object tracking allows you to track specific objects on the device, such as the interface line protocol state, IP routing, and route reachability, and to take action when the tracked object’s state changes. This feature allows you to increase the availability of the network and shorten recovery time if an object state goes down.
This section includes the following topics:
The object tracking feature allows you to create a tracked object that multiple clients can use to modify the client behavior when a tracked object changes. Several clients register their interest with the tracking process, track the same object, and take different actions when the object state changes.
Clients include the following features:
The object tracking monitors the status of the tracked objects and communicates any changes made to interested clients. Each tracked object is identified by a unique number that clients can use to configure the action to take when a tracked object changes state.
Cisco NX-OS tracks the following object types:
For example, you can configure HSRP to track the line protocol of the interface that connects one of the redundant routers to the rest of the network. If that link protocol goes down, you can modify the priority of the affected HSRP router and cause a switchover to a backup router that has better network connectivity.
An object track list allows you to track the combined states of multiple objects. Object track lists support the following capabilities:
Other entities, such as virtual Port Channels (vPCs) can use an object track list to modify the state of a vPC based on the state of the multiple peer links that create the vPC. See the Cisco Nexus 7000 Series NX-OS Interfaces Configuration Guide, Release 5.x, for more information on vPCs.
See the “Configuring an Object Track List with a Boolean Expression” section for more information on track lists.
Object tracking supports high availability through stateful restarts. A stateful restart occurs when the object tracking process crashes. Object tracking also supports a stateful switchover on a dual supervisor system. Cisco NX-OS applies the runtime configuration after the switchover.
You can also use object tracking to modify the behavior of a client to improve overall network availability.
Object tracking supports Virtual Routing and Forwarding (VRF) instances. VRFs exist within virtual device contexts (VDCs). By default, Cisco NX-OS places you in the default VDC and default VRF unless you specifically configure another VDC and VRF. By default, Cisco NX-OS tracks the route reachability state of objects in the default VRF. If you want to track objects in another VRF, you must configure the object to be a member of that VRF (see the “Configuring Object Tracking for a Nondefault VRF” section).
For more information, see the Cisco Nexus 7000 Series NX-OS Virtual Device Context Configuration Guide, Release 5.x, and see Chapter14, “Configuring Layer 3 Virtualization”
The following table shows the licensing requirements for this feature:
Object tracking has the following prerequisites:
Note For a full list of feature-specific prerequisites, see the platform-specific documentation.
Object tracking has the following configuration guidelines and limitations:
Table 21-1 lists the default settings for object tracking parameters.
|
|
---|---|
This section includes the following topics:
Note If you are familiar with the Cisco IOS CLI, be aware that the Cisco NX-OS commands for this feature might differ from the Cisco IOS commands that you would use.
You can configure Cisco NX-OS to track the line protocol or IPv4 or IPv6 routing state of an interface.
Ensure that you are in the correct VDC (or use the switchto vdc command).
2. track object- id interface interface-type number {{ ip | ipv6 } routing | line-protocol }
This example shows how to configure object tracking for the line protocol state on Ethernet 1/2:
switch(config)# track 1 interface ethernet 1/2 line-protocol
switch(config-track)# copy running-config startup-config
This example shows how to configure object tracking for the IPv4 routing state on Ethernet 1/2:
switch(config)# track 2 interface ethernet 1/2 ip routing
switch(config-track)# copy running-config startup-config
This example shows how to configure object tracking for the IPv6 routing state on Ethernet 1/2:
Ensure that you are in the correct VDC (or use the switchto vdc command).
|
|
|
---|---|---|
Deletes a tracked object for an interface. The object-id range is from 1 to 500. |
This example shows how to delete a object tracking:
You can configure Cisco NX-OS to track the existence and reachability of an IP route or IPv6 route.
Ensure that you are in the correct VDC (or use the switchto vdc command).
2. track object- id { ip | ipv6 } route prefix/length reachability
3. (Optional) show track [ object- id ]
4. (Optional) copy running-config startup-config
This example shows how to configure object tracking for an IPv4 route in the default VRF.
switch(config)# track 4 ip route 192.0.2.0/8 reachability
switch(config-track)# copy running-config startup-config
This example shows how to configure object tracking for an IPv6 route in the default VRF.
switch(config)# track 5 ipv6 route 10::10/128 reachability
switch(config-track)# copy running-config startup-config
You can configure an object track list that contains multiple tracked objects. A tracked list contains one or more objects. The Boolean expression enables two types of calculation by using either "and" or "or" operators. For example, when tracking two interfaces using the "and" operator, up means that both interfaces are up, and down means that either interface is down.
Ensure that you are in the correct VDC (or use the switchto vdc command).
2. track track-number list boolean { and | or }
This example shows how to configure a track list with multiple objects as a Boolean “and”:
switch(config)# track 1 list boolean and
switch(config-track)# object 10
You can configure an object track list that contains a percentage threshold. A tracked list contains one or more objects. The percentage of up objects must exceed the configured track list up percent threshold before the track list is in an up state. For example, if the tracked list has three objects, and you configure an up threshold of 60 percent, two of the objects must be in the up state (66 percent of all objects) for the track list to be in the up state.
Ensure that you are in the correct VDC (or use the switchto vdc command).
2. track track-number list threshold percentage
This example shows how to configure a track list with an up threshold of 70 percent and a down threshold of 30 percent:
switch(config)# track 1 list threshold percentage
switch(config-track)# threshold percentage up 70 down 30
switch(config-track)# object 10
You can configure an object track list that contains a weight threshold. A tracked list contains one or more objects. The combined weight of up objects must exceed the configured track list up weight threshold before the track list is in an up state. For example, if the tracked list has three objects with the default weight of 10 each, and you configure an up threshold of 15, two of the objects must be in the up state (combined weight of 20) for the track list to be in the up state.
Ensure that you are in the correct VDC (or use the switchto vdc command).
2. track track-number list threshold weight
3. threshold weight up up-value down down-value
This example shows how to configure a track list with an up weight threshold of 30 and a down threshold of 10:
switch(config)# track 1 list threshold weight
switch(config-track)# threshold weight up 30 down 10
switch(config-track)# object 10 weight 15
switch(config-track)# object 20 weight 15
switch(config-track)# object 30
In this example, the track list is up if object 10 and object 20 are up, and the track list goes to the down state if all three objects are down.
You can configure a delay for a tracked object or an object track list that delays when the object or list triggers a stage change. The tracked object or track list starts the delay timer when a state change occurs but does not recognize a state change until the delay timer expires. At that point, Cisco NX-OS checks the object state again and records a state change only if the object or list currently has a changed state. Object tracking ignores any intermediate state changes before the delay timer expires.
For example, for an interface line-protocol tracked object that is in the up state with a 20 second down delay, the delay timer starts when the line protocol goes down. The object is not in the down state unless the line protocol is down 20 seconds later.
You can configure independent up delay and down delay for a tracked object or track list. When you delete the delay, object tracking deletes both the up and down delay.
You can change the delay at any point. If the object or list is already counting down the delay timer from a triggered event, the new delay is computed as the following:
Ensure that you are in the correct VDC (or use the switchto vdc command).
2. track object- id { parameters }
3. track track-number list { parameters }
4. delay { up up-time [ down down-time ] | down down-time [ up up-time ]}
This example shows how to configure object tracking for a route and use delay timers:
switch(config)# track 2 ip route 209.165.201.0/8 reachability
switch(config-track)# delay up 20 down 30
switch(config-track)# copy running-config startup-config
This example shows how to configure a track list with an up weight threshold of 30 and a down threshold of 10 with delay timers:
switch(config)# track 1 list threshold weight
switch(config-track)# threshold weight up 30 down 10
switch(config-track)# object 10 weight 15
switch(config-track)# object 20 weight 15
switch(config-track)# object 30
switch(config-track)# delay up 20 down 30
This example shows the delay timer in the show track command output before and after an interface is shut down:
switch(config-track)# show track
Interface loopback1 Line Protocol
1 changes, last change 00:00:13
qadc3-fhrp-ind45(config-track)# interface loopback 1
qadc3-fhrp-ind45(config-if)# shutdown
qadc3-fhrp-ind45(config-if)# show track
Interface loopback1 Line Protocol
Line Protocol is delayed DOWN (8 secs remaining) <------- delay timer counting down
You can configure Cisco NX-OS to track an object in a specific VRF.
Ensure that you are in the correct VDC (or use the switchto vdc command).
2. track object- id { ip | ipv6 } route prefix/length reachability
This example shows how to configure object tracking for a route and use VRF Red to look up reachability information for this object:
switch(config)# track 2 ip route 209.165.201.0/8 reachability
switch(config-track)# vrf member Red
switch(config-track)# copy running-config startup-config
This example shows how to configure object tracking for an IPv6 route and use VRF Red to look up reachability information for this object:
Switch(config)# track 3 ipv6 route 1::2/64 reachability
Switch(config-track)# vrf member Red
Switch(config-track)# copy running-config startup-config
This example shows how to modify tracked object 2 to use VRF Blue instead of VRF Red to look up reachability information for this object:
switch(config-track)# vrf member Blue
switch(config-track)# copy running-config startup-config
To display object tracking configuration information, perform one the following tasks:
This example shows how to configure object tracking for route reachability and use VRF Red to look up reachability information for this route:
switch(config)# track 2 ip route 209.165.201.0/8 reachability
See the following topics for information related to object tracking:
For additional information related to implementing object tracking, see the following sections:
|
|
---|---|
Cisco Nexus 7000 Series NX-OS Unicast Routing Command Reference, Release 5.x |
|
Cisco Nexus 7000 Series NX-OS System Management Configuration Guide, Release 5.x |
|
|
---|---|
No new or modified standards are supported by this feature, and support for existing standards has not been modified by this feature. |
Table 21-2 lists the release history for this feature.
|
|
|
---|---|---|
Added support for object track lists and Boolean expressions. |
||