T Commands

This chapter describes the Cisco NX-OS object tracking commands that begin with T.

threshold percentage

To set a threshold percentage for a tracked object in a list of objects, use the threshold percentage command. To disable the threshold percentage, use the no form of this command.

threshold percentage {up number [down number] | down number [up number]}

no threshold percentage

Syntax Description

up

Specifies the up threshold.

down

(Optional) Specifies the down threshold.

number

Threshold value. The range is from 0 to 100.


Command Default

None

Command Modes

Tracking configuration mode

Command History

Release
Modification

5.0(3)N1(1)

This command was introduced.


Usage Guidelines

When you configure a tracked list using the track object-number list command, there are two keywords available: boolean and threshold. If you specify the threshold keyword, you can specify either the percentage or weight keywords. If you specify the percentage keyword, the weight keyword is unavailable. If you specify the weight keyword, the percentage keyword is unavailable.

You should configure the up percentage first. The valid range is from 1 to 100. The down percentage depends on what you have configured for up. For example, if you configure 50 percent for up, you see a range from 0 to 49 percent for down.

Examples

This example shows how to configure the tracked list 11 to measure the threshold using an up percentage of 50 and a down percentage of 32: 

switch(config)# track 11 list threshold percentage

switch(config-track)# object 1

switch(config-track)# object 2

switch(config-track)# threshold percentage up 50 down 32

switch(config-track)#

Related Commands

Command
Description

threshold weight

Sets a threshold weight for a tracked object in a list of objects.

track list

Specifies a list of objects to be tracked and the thresholds to be used for comparison.


threshold weight

To set a threshold weight for a tracked object in a list of objects, use the threshold weight command. To disable the threshold weight, use the no form of this command.

threshold weight {up number [down number] | down number [up number]}

no threshold weight

Syntax Description

up

Specifies the up threshold.

down

(Optional) Specifies the down threshold.

number

Threshold value. The range is from 1 to 255.


Command Default

None

Command Modes

Tracking configuration mode

Command History

Release
Modification

5.0(3)N1(1)

This command was introduced.


Usage Guidelines

When you configure a tracked list using the track object-number list command, there are two keywords available: boolean and threshold. If you specify the threshold keyword, you can specify either the percentage or weight keywords. If you specify the percentage keyword, the weight keyword is unavailable. If you specify the weight keyword, the percentage keyword is unavailable.

You should configure the up weight first. The valid range is from 1 to 255. The available down weight depends on what you have configured for the up weight. For example, if you configure 25 for up, you will see a range from 0 to 24 for down.

Examples

This example shows how to configure the tracked list 12 to measure a threshold using a specified weight: 

switch(config)# track 11 list threshold weight

switch(config-track)# object 1

switch(config-track)# object 2

switch(config-track)# threshold weight up 35 down 22

switch(config-track)#

Related Commands

Command
Description

threshold percentage

Sets a threshold percentage for a tracked object in a list of objects.

track list

Specifies a list of objects to be tracked and the thresholds to be used for comparison.


track interface

To configure object tracking on an interface, use the track interface command. To remove the object tracking for this interface, use the no form of this command.

track object-id interface interface-type number {ip routing | line-protocol}

no track object-id [force]

Syntax Description

object-id

Tracking ID. The range can be from 1 to 500.

interface interface-type number

Specifies the interface to track. Use the online ? help to see a list of available interface types.

ip routing

Tracks the IP routing state of the interface.

line-protocol

Tracks the line protocol state of the interface.

force

(Optional) Completely removes the object tracking instance.


Command Default

None

Command Modes

Global configuration mode

Command History

Release
Modification

5.0(3)N1(1)

This command was introduced.


Usage Guidelines

Use the track interface command to track the line protocol status or IPv4 routing state of an interface. This command enters the object tracking command mode. Use the vrf member command in object tracking configuration mode to track objects in a nondefault VRF.

Examples

This example shows how to track the IP routing state on interface Ethernet 1/2: 

switch(config)# track 1 interface ethernet 1/2 ip routing

switch(config-track)#

 
   
 
    
   
 Related Commands
 
   
 
    
 
      
      
      
 
        
        

          Command 
        
 		 
        
        

          Description 
        
 		 
      
 
      
 
       
 show track 
 		 
       
 Displays information about object tracking. 
 		 
      
 
      
 
       
 track ip route reachability 
 		 
       
 Tracks the state of an IPv4 route reachability. 
 		 
      
 
      
 
       
 vrf member 
 		 
       
 Tracks an object in a nondefault VRF. 
 		 
      
 
      
    
 
   
 
   
 
   
 
 
    
   
 
 
     
    
    
   
 track ip route 
 
    
   
 To configure object tracking on an IP route, use the track ip route command. To remove the object tracking for this route, use the no form of this command. 
 
    
   
track object-id ip route ip-prefix/length reachability 
 
    
   
no track object-id [force] 
 
    
   
 Syntax Description
 
   
 
    
 
      
      
      
 
       
 object-id 
 		 
       
 Tracking ID. The range can be from 1 to 500. 
 		 
      
 
      
 
       
 ip-prefix/length 
 		 
       
 Prefix of route to track. The IP prefix is in dotted decimal format (X.X.X.X). The length can be from 1 to 32. 
 		 
      
 
      
 
       
 reachability 
 		 
       
 Tracks the reachability state of an IP route. 
 		 
      
 
      
 
       
 force 
 		 
       
 (Optional) Completely removes the object tracking instance. 
 		 
      
 
      
    
 
   
 
   
 
   
 
 
    
   
 Command Default 
 
    
   
 None 
 
    
   
 Command Modes 
 
    
   
 Global configuration mode 
 
    
   
 Command History
 
   
 
    
 
      
      
      
 
        
        

          Release 
        
 		 
        
        

          Modification 
        
 		 
      
 
      
 
       
 5.0(3)N1(1) 
 		 
       
 This command was introduced. 
 		 
      
 
      
    
 
   
 
   
 
   
 
 
    
   
 Usage Guidelines 
 
    
   
 Use the track ip route command to track IP route reachability. This command enters the object tracking command mode. Use the vrf member command in object tracking configuration mode to track objects in a nondefault VRF. 
 
    
   
 Examples 
 
    
   
 This example shows how to track an IP route: 
 
    
   
 
    
switch(config)# track 1 ip route 10.10.10.0/8 reachability 

 
   
 
    
   
 
    
switch(config-track)#

 
   
 
    
   
 
    
 
   
 
    
   
 Related Commands
 
   
 
    
 
      
      
      
 
        
        

          Command 
        
 		 
        
        

          Description 
        
 		 
      
 
      
 
       
 show track 
 		 
       
 Displays information about object tracking. 
 		 
      
 
      
 
       
 track interface 
 		 
       
 Tracks an interface. 
 		 
      
 
      
 
       
 vrf member 
 		 
       
 Tracks an object in a nondefault VRF. 
 		 
      
 
      
    
 
   
 
   
 
   
 
 
    
   
 
 
     
    
    
    
   
 track list 
 
    
   
 To configure object tracking on an object list, use the track list command. To remove the object tracking for this object list, use the no form of this command. 
 
    
   
track object-id list boolean {and | or} 
 
    
   
track object-id list threshold {percentage | weight} 
 
    
   
no track object-id [force] 
 
    
   
 Syntax Description
 
   
 
    
 
      
      
      
 
       
 object-id 
 		 
       
 Tracking ID. The range can be from 1 to 500. 
 		 
      
 
      
 
       
 boolean 
 		 
       
 Combines the tracked object states as a boolean combination. 
 		 
      
 
      
 
       
 and 
 		 
       
 Combines the tracked object states as a boolean AND. 
 		 
      
 
      
 
       
 or 
 		 
       
 Combines the tracked object states as a boolean OR. 
 		 
      
 
      
 
       
 threshold 
 		 
       
 Combines the tracked object states as a percent or weight combination. 
 		 
      
 
      
 
       
 percentage 
 		 
       
 Combines the tracked object states as a percent of the total number of tracked objects in the list. 
 		 
      
 
      
 
       
 weight 
 		 
       
 Combines the tracked object states as a combination of their configured weights. 
 		 
      
 
      
 
       
 force 
 		 
       
 (Optional) Completely removes the object tracking instance. 
 		 
      
 
      
    
 
   
 
   
 
   
 
 
    
   
 Command Default 
 
    
   
 None 
 
    
   
 Command Modes 
 
    
   
 Global configuration mode 
 
    
   
 Command History
 
   
 
    
 
      
      
      
 
        
        

          Release 
        
 		 
        
        

          Modification 
        
 		 
      
 
      
 
       
 5.0(3)N1(1) 
 		 
       
 This command was introduced. 
 		 
      
 
      
    
 
   
 
   
 
   
 
 
    
   
 Usage Guidelines 
 
    
   
 Use the track list command to create a list of objects to combine into one tracked state. Use the boolean and keywords to combine the tracked objects as an AND function (that is, all objects must be up for the track list to be up). Use the boolean or keywords to combine the tracked objects as an OR (that is if any object is up, the tracked state is up). 
 
    
   
 The track list command enters the track command mode. You can configure the following commands in this mode: 
 
    
   
 •object—Configures one or more objects to track in the track list. You can optionally use the not keyword to negate the object track state. (That is, an up state becomes a down state if you use the not keyword) for boolean tracked lists. You can optionally use the weight keyword to assign a weight to an object for a threshold weight tracked list. The default weight is 10. 
 
    
   
 •vrf—Assigns the track list to a VRF. 
 
    
   
 Examples 
 
    
   
 This example shows how to create a track list of two objects and AND their state: 
 
    
   
switch# configure terminal 
 
    
   
 
    
switch(config)# track 1 boolean and

 
   
 
    
   
 
    
switch(config-track)# object 33

 
   
 
    
   
 
    
switch(config-track)# object 30

 
   
 
    
   
 
    
switch(config-track)#

 
   
 
    
   
 
    
 
   
 
    
   
 This example shows how to configure a track list with an up threshold of 70 percent and a down threshold of 30 percent: 
 
    
   
switch# configure terminal 
 
    
   
switch(config)# track 1 list threshold percentage 
 
    
   
switch(config-track)# threshold percentage up 70 down 30 
 
    
   
switch(config-track)# object 10 
 
    
   
switch(config-track)# object 20 
 
    
   
switch(config-track)# object 30 
 
    
   
switch(config-track)# 
 
    
   
 
 
    
   
 This example shows how to configure a track list with an up weight threshold of 30 and a down threshold of 10: 
 
    
   
switch# configure terminal 
 
    
   
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)# 
 
    
   
 
 
    
   
 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. 
 
    
   
 Related Commands
 
   
 
    
 
      
      
      
 
        
        

          Command 
        
 		 
        
        

          Description 
        
 		 
      
 
      
 
       
 show track 
 		 
       
 Displays information about object tracking. 
 		 
      
 
      
 
       
 track ip route 
 		 
       
 Tracks an interface.