R Commands

This chapter describes the Cisco NX-OS Enhanced Interior Gateway Routing Protocol (EIGRP) commands that begin with R.

redistribute (EIGRP)

To inject routes from one routing domain into the Enhanced Interior Gateway Routing Protocol (EIGRP), use the redistribute command. To remove the redistribute command from the configuration file and restore the system to its default condition in which the software does not redistribute routes, use the no form of this command.

redistribute {bgp as-number | direct | eigrp id | ospf instance-tag | rip instance-tag | static} [route-map map-name]

no redistribute {bgp as-number | direct | eigrp as-number | ospf instance-tag | rip instance-tag | static}

Syntax Description

bgp as-number

Distributes routes from Border Gateway Protocol (BGP). The as-number is a 2-byte or 4-byte autonomous system number. The range for 2-byte numbers is from 1 to 65535. The range for 4-byte numbers is from 1.0 to 65535.65535.

direct

Distributes routes that are directly connected on an interface.

eigrp id

Specifies the name of an EIGRP instance. The id can be any case-sensitive, alphanumeric string up to 20 characters.

ospf instance-tag

Distributes routes from the OSPF protocol. This protocol is supported in the IPv4 address family. The instance-tag can be a maximum of 20 alphanumeric characters.

rip instance-tag

Distributes routes from the RIP protocol. The instance-tag can be a maximum of 20 alphanumeric characters.

static

Redistributes IP static routes.

route-map map-name

(Optional) Specifies the identifier of a configured route map. Use a route map to filter which routes are redistributed into EIGRP.


Command Default

Disabled

Command Modes

Address family configuration mode
Router configuration mode
Router VRF configuration mode

Command History

Release
Modification

6.0(2)N1(1)

This command was introduced.


Usage Guidelines

Use the redistribute command to import routes from other routing protocols into EIGRP. You should always use a route map to filter these routes to ensure that EIGRP redistributes only the routes that you intend to redistribute.

You must configure a default metric to redistribute routes from another protocol into EIGRP. You can configure the default metric with the default-metric command or with the route map configured with the redistribute command.

This command requires the LAN Base Services license.

Examples

This example shows how to redistribute cause BGP routes into an EIGRP autonomous system: 

switch(config)# router eigrp 209

switch(config-router) address-family ipv4 unicast

switch(config-router-af)# redistribute bgp 64496

switch(config-router-af)

 
   
 
    
   
 Related Commands
 
   
 
    
 
      
      
      
 
        
        

          Command 
        
 		 
        
        

          Description 
        
 		 
      
 
      
 
       
 default-metric (EIGRP) 
 		 
       
 Sets the default metrics for routes redistributed into EIGRP. 
 		 
      
 
      
 
       
 show ip eigrp 
 		 
       
 Displays EIGRP information. 
 		 
      
 
      
    
 
   
 
   
 
   
 
 
    
     
    
    
   
 redistribute maximum-prefix (EIGRP) 
 
    
   
 To limit the number of routes redistributed into Enhanced Interior Gateway Routing Protocol (EIGRP), use the redistribute maximum-prefix command. To return to the default setting, use the no form of this command. 
 
    
   
redistribute maximum-prefix max [threshold] [warning-only | withdraw [num-retries timeout]] 
 
    
   
no redistribute maximum-prefix max [threshold] [warning-only | withdraw [num-retries timeout] 
 
    
   
 Syntax Description
 
   
 
    
 
      
      
      
 
       
 max 
 		 
       
 Maximum number of prefixes that EIGRP will distribute. The range is from 0 to 65536. 
 		 
      
 
      
 
       
 threshold 
 		 
       
 (Optional) Percentage of maximum prefixes that triggers a warning message. The range is from 1 to 100. The default is 75 percent. 
 		 
      
 
      
 
       
 warning-only 
 		 
       
 (Optional) Logs a warning message when the maximum number of prefixes is exceeded. 
 		 
      
 
      
 
       
 widthdraw 
 		 
       
 (Optional) Withdraws all redistributed routes. 
 		 
      
 
      
 
       
 num-retries 
 		 
       
 (Optional) Number of times EIGRP tries to retrieve the redistributed routes. The range is from 1 to 12. The default is 1. 
 		 
      
 
      
 
       
 timeout 
 		 
       
 (Optional) Time between retry attempts. The range is from 60 to 600 seconds. The default is 300. 
 		 
      
 
      
    
 
   
 
   
 
   
 
 
    
   
 Command Default 
 
    
   
 No limit 
 
    
   
 Command Modes 
 
    
   
 Router configuration mode
VRF configuration mode 
 
    
   
 Command History
 
   
 
    
 
      
      
      
 
        
        

          Release 
        
 		 
        
        

          Modification 
        
 		 
      
 
      
 
       
 6.0(2)N1(1) 
 		 
       
 This command was introduced. 
 		 
      
 
      
    
 
   
 
   
 
   
 
 
    
   
 Usage Guidelines 
 
    
   
 Use the redistribute maximim-prefix command to limit the number of routes redistributed into EIGRP. Use the clear ip eigrp redistribute command if all routes are withdrawn. 
 
    
   
 Examples 
 
    
   
 This example shows how to limit the number of redistributed routes into EIGRP: 
 
    
   
switch# configure terminal 
 
    
   
switch(config)# router eigrp 201 
 
    
   
switch(config-router)# address-family ipv4 unicast 
 
    
   
switch(config-router-af)# redistribute bgp route-map FilterExternalBGP 
 
    
   
switch(config-router-af)# redistribute maximum-prefix 1000 75 
 
    
   
 
    
switch(config-router-af)#

 
   
 
    
   
 Related Commands
 
   
 
    
 
      
      
      
 
        
        

          Command 
        
 		 
        
        

          Description 
        
 		 
      
 
      
 
       
 copy running-config startup-config 
 		 
       
 Saves the configuration changes to the startup configuration file. 
 		 
      
 
      
 
       
 feature eigrp 
 		 
       
 Enables the EIGRP feature. 
 		 
      
 
      
 
       
 redistribute (EIGRP) 
 		 
       
 Configures route redistribution for EIGRP. 
 		 
      
 
      
 
       
 show running-config eigrp 
 		 
       
 Displays the EIGRP running configuration. 
 		 
      
 
      
    
 
   
 
   
 
   
 
 
    
   
 
 
     
    
    
   
 restart eigrp (EIGRP) 
 
    
   
 To restart an Enhanced Interior Gateway Routing Protocol (EIGRP) instance and remove all associated neighbors, use the restart command. 
 
    
   
restart eigrp instance-tag 
 
    
   
 Syntax Description
 
   
 
    
 
      
      
      
 
       
 instance-tag 
 		 
       
 Name for an EIGRP routing instance. The name can be a maximum of 20 alphanumeric characters. 
 		 
      
 
      
    
 
   
 
   
 
   
 
 
    
   
 Command Default 
 
    
   
 None 
 
    
   
 Command Modes 
 
    
   
 Global configuration mode 
 
    
   
 Command History
 
   
 
    
 
      
      
      
 
        
        

          Release 
        
 		 
        
        

          Modification 
        
 		 
      
 
      
 
       
 6.0(2)N1(1) 
 		 
       
 This command was introduced. 
 		 
      
 
      
    
 
   
 
   
 
   
 
 
    
   
 Usage Guidelines 
 
    
   
 This command requires the LAN Base Services license. 
 
    
   
 Examples 
 
    
   
 This example shows how to restart the OSPFv2 instance and remove all neighbors: 
 
    
   
 
    
switch# configure terminal

 
   
 
    
   
 
    
switch(config)# restart eigrp Test1

 
   
 
    
   
 
    
switch(config)#

 
   
 
    
   
 
    
 
   
 
    
   
 Related Commands
 
   
 
    
 
      
      
      
 
        
        

          Command 
        
 		 
        
        

          Description 
        
 		 
      
 
      
 
       
 copy running-config startup-config 
 		 
       
 Saves the configuration in the startup configuration file. 
 		 
      
 
      
 
       
 show ip eigrp interfaces 
 		 
       
 Displays information about EIGRP interfaces. 
 		 
      
 
      
    
 
   
 
   
 
   
 
 
    
   
 
 
     
    
    
   
 router eigrp 
 
    
   
 To configure a routing process and enter router configuration mode for Enhanced Interior Gateway Routing Protocol (EIGRP), use the router eigrp command. To turn off the EIGRP routing process, use the no form of this command. 
 
    
   
router eigrp instance-tag 
 
    
   
no router eigrp instance-tag 
 
    
   
 Syntax Description
 
   
 
    
 
      
      
      
 
       
 instance-tag 
 		 
       
 Name of an EIGRP instance. The instance-tag can be any case-sensitive, alphanumeric string up to 20 characters. 
 		 
      
 
      
    
 
   
 
   
 
   
 
 
    
   
 Command Default 
 
    
   
 None 
 
    
   
 Command Modes 
 
    
   
 Global configuration mode 
 
    
   
 Command History
 
   
 
    
 
      
      
      
 
        
        

          Release 
        
 		 
        
        

          Modification 
        
 		 
      
 
      
 
       
 6.0(2)N1(1) 
 		 
       
 This command was introduced. 
 		 
      
 
      
    
 
   
 
   
 
   
 
 
    
   
 Usage Guidelines 
 
    
   
 This command requires the LAN Base Services license. 
 
    
   
 Examples 
 
    
   
 This example shows how to configure a routing process for EIGRP: 
 
    
   
 
    
switch(config)# router eigrp 1

 
   
 
    
   
 
    
switch(config-router)#

 
   
 
    
   
 Related Commands
 
   
 
    
 
      
      
      
 
        
        

          Command 
        
 		 
        
        

          Description 
        
 		 
      
 
      
 
       
 default-information 
 		 
       
 Controls the distribution of a default route. 
 		 
      
 
      
 
       
 default-metric 
 		 
       
 Configures the default metric for routes redistributed into EIGRP. 
 		 
      
 
      
 
       
 distance 
 		 
       
 Configures the administrative distance. 
 		 
      
 
      
 
       
 maximum-paths 
 		 
       
 Configures the maximum number of equal-cost paths. 
 		 
      
 
      
 
       
 redistribute 
 		 
       
 Configures route redistribution for EIGRP. 
 		 
      
 
      
 
       
 router-id 
 		 
       
 Configures the router ID. 
 		 
      
 
      
 
       
 timers 
 		 
       
 Configures the EIGRP timers. 
 		 
      
 
      
    
 
   
 
   
 
   
 
 
     
    
    
   
 router-id (EIGRP) 
 
    
   
 To configure a router ID for an Enhanced Interior Gateway Routing Protocol (EIGRP) process, use the router-id command. To cause the software to use the default method of determining the router ID, use the no form of this command. 
 
    
   
router-id router-id 
 
    
   
no router-id 
 
    
   
 Syntax Description
 
   
 
    
 
      
      
      
 
       
 router-id 
 		 
       
 32-bit router ID value specified in four-part, dotted-decimal notation. 
 		 
      
 
      
    
 
   
 
   
 
   
 
 
    
   
 Command Default 
 
    
   
 If this command is not configured, EIGRP chooses an IPv4 address as the router ID from one of its interfaces. 
 
    
   
 Command Modes 
 
    
   
 Address family configuration mode
Router configuration mode
Router VRF configuration mode 
 
    
   
 Command History
 
   
 
    
 
      
      
      
 
        
        

          Release 
        
 		 
        
        

          Modification 
        
 		 
      
 
      
 
       
 6.0(2)N1(1) 
 		 
       
 This command was introduced. 
 		 
      
 
      
    
 
   
 
   
 
   
 
 
    
   
 Usage Guidelines 
 
    
   
 Use the router-id command to manually specify a unique 32-bit numeric value for the router ID. This action ensures that EIGRP can function regardless of the interface address configuration. 
 
    
   
 This command requires the LAN Base Services license. 
 
    
   
 Examples 
 
    
   
 This example shows how to assign the IP address of 192.0.2.1 to the EIGRP process 1: 
 
    
   
 
    
switch(config)# router eigrp 1

 
   
 
    
   
 
    
switch(config-router) address-family ipv4

 
   
 
    
   
 
    
switch(config-router-af)# router-id 192.0.2.1

 
   
 
    
   
 
    
 
   
 
    
   
 Related Commands
 
   
 
    
 
      
      
      
 
        
        

          Command 
        
 		 
        
        

          Description 
        
 		 
      
 
      
 
       
 show ip eigrp 
 		 
       
 Displays a summary of the EIGRP processes.