7.2. RIPng Commands

Command Purpose

To enable or configure the Routing Information Protocol next generation (RIPng) routing process, use the router ipv6 rip command in global configuration mode.

To disable the RIPng routing process, use the no form of this command.

Prerequisites

Command Syntax

router ipv6 rip

no router ipv6 rip

Command Mode

Global Config

Default

No RIPng routing process is defined.

Usage

None

Examples

The following example shows how to enable RIPng routing process:

Switch# configure terminal
Switch(config)# router ipv6 rip

Related Commands

None

Command Purpose

To enable RIPng routing process on specifical interface, use the command ipv6 router rip in interface configuration mode.

Use the no parameter with this command to disable RIPng routing process on interface.

Prerequisites

Command Syntax

ipv6 router rip

no ipv6 router rip

Command Mode

Interface Configuration

Default

None.

Usage

None

Examples

The following example shows how to enable RIPng on the interface eth-0-1:

Switch# configure terminal
Switch(config)# interface eth-0-1
Switch(config-if)# no switchport
Switch(config-if)# ipv6 router rip

Related Commands

None

Command Purpose

Use this command to set RIP metric offset in interface mode.

To restore the default metric, use the no form of this command.

Prerequisites

Command Syntax

ipv6 rip metric-offset NUMBER-VALUE

no ipv6 rip metric-offset NUMBER-VALUE

Command Mode

Interface Configuration

Default

Metric offset value is 1.

Usage

Metric offset value is used to add the metric of the network on which the message arrived (as the RFC describes).

Examples

The following example shows how to set metric offset as 2:

Switch# configure terminal
Switch(config)# interface eth-0-1
Switch(config-if)# ipv6 rip metric-offset 2

Related Commands

None

Command Purpose

To enable the split horizon mechanism for Routing Information Protocol next generation (RIPng), use the ipv6 rip split-horizon command in interface configuration mode.

To disable the split horizon mechanism, use the no form of this command.

Prerequisites

Command Syntax

ipv6 rip split-horizon ( poisoned | )

no ipv6 rip split-horizon

Command Mode

Interface Configuration

Default

This command is enabled with poisoned reverse by default.

Usage

In general, changing the default state for the ipv6 rip split-horizon command is not recommended, unless you are certain that your application requires a change in order to properly advertise routes.

Examples

The following example enables split horizon without poisoned reverse:

Switch# configure terminal
Switch(config)# interface eth-0-1
Switch(config-if)# ipv6 rip split- horizon

Related Commands

None

Command Purpose

To generate a default route into Routing Information Protocol next generation (RIPng), use the default-information originate command in router configuration mode.

To disable this feature, use the no form of this command.

Prerequisites

Command Syntax

default-information originate ( route-map NAME | )

no default-information originate ( route-map | )

Command Mode

Router Configuration

Default

This command is disabled by default.

Usage

The default route can be learned by neighbor, but can’t be stored in FIB.

Examples

The following example originates a default route (0::0/0) into RIPng:

Switch# configure terminal
Switch(config)# router ipv6 rip
Switch(config-router)# default-information originate

Related Commands

None

Command Purpose

To specify the metrics to be assigned to redistributed routers for Routing Information Protocol next generation (RIPng), use the default-metric command in router configuration mode.

To return to the default state, use the no form of this command.

Prerequisites

Command Syntax

default-metric NUMBER-VALUE

no default-metric

Command Mode

Router Configuration

Default

By default, the metric is set to 0.

Usage

The default-metric command is used in conjunction with the redistribute router configuration command to cause the current routing protocol to use the same metric value for all redistributed routes. A default metric helps solve the problem of redistributing routes with incompatible metrics. Whenever metrics do not convert, using a default metric provides a reasonable substitute and enables the redistribution to proceed.

Examples

The following example shows a switch using both the RIPng and the Open Shortest Path First (OSPFv3) routing protocols. The example advertises OSPFv3-derived routes using RIPng and assigns the OSPFv3-derived routes a RIPng metric of 10:

Switch# configure terminal
Switch(config)# router ipv6 rip
Switch(config-router)#default-metric 10
Switch(config-router)#redistribute ospfv3

Related Commands

redistribute (RIPng)

Command Purpose

To define an administrative distance for routes that are inserted into the routing table, use the distance command in router configuration mode.

To return the administrative distance to its default distance definition, use the no form of this command.

An administrative distance is a rating of the trustworthiness of a routing information source, such as an individual switch or a group of switches. Numerically, an administrative distance is an integer from 0 to 255. In general, the higher the value is, the lower the trust rating. An administrative distance of 255 means the routing information source cannot be trusted at all and should be ignored.

Prerequisites

Command Syntax

distance DISTANCE

no distance

Command Mode

Router Configuration

Default

By default, the distance is 120.

Usage

Examples

The following example set the distance of RIPng U50474 200:

Switch# configure terminal
Switch(config)# router ipv6 rip
Switch(config-router)#distance 200

Related Commands

None

Command Purpose

To specify a neighboring router to which to notify routing updating information, use the neighbor command in router configuration mode.

To remove the neighbor, use the no form of this command.

Prerequisites

Command Syntax

neighbor IPV6_ADDR IFNAME

no neighbor IP-ADDRESS IFNAME

Command Mode

Router Configuration

Default

No neighboring switches are defined.

Usage

Especially use the neighbor command in conjunction with the passive-interface command to send routing updates to specific neighbors. This command permits the point-to-point (non-multicast) notification of routing update information. Multiple neighbors can be configured

Examples

In the following example, RIPng updates are sent to all interfaces which have been enabled RIPng routing except eth-0-1. However, in this case a neighbor switch configuration command is included. This command permits the sending of routing updates to specific neighbors:

Switch# configure terminal
Switch(config)# router ipv6 rip
Switch(config-router)# passive-interface eth-0-1
Switch(config-router)# neighbor fe80:db8::1 eth-0-1

Related Commands

router rip

Command Purpose

To add an offset to incoming and outgoing metrics to routes exchanging via Routing Information Protocol next generation (RIPng), use the offset-list command in router configuration mode.

To remove an offset list, use the no form of this command.

Prerequisites

Command Syntax

offset-list ACCESSS-LIST-NAME ( in | out ) METRIC-OFFSET ( IFNAME | )

no offset-list ( in | out ) ( IFNAME | )

Command Mode

Router Configuration

Default

This command is configured by default.

Usage

Especially if the offset value is added to the routing metric by offset-list, the default action where the metric updates when RIPng message arrives (as RFC defined) is ignored, but outputs will be added.

The offset value is added to the routing metric. An offset list with an interface is considered extended and takes precedence over an offset list that is not extended. Therefore, if an entry passes the extended offset list and the normal offset list, the offset of the extended offset list is added to the metric.

Examples

In the following example, the switch applies an offset of 10 if access list 21 permits:

Switch# configure terminal
Switch(config)# router ipv6 rip
Switch(config-router)# offset-list 21 out 10

Related Commands

None

Command Purpose

To disable sending routing updates for the Routing Information Protocol next generation (RIPng) on an interface, use the passive-interface command in router configuration mode.

To enable the sending of routing updates, use the no form of this command.

Prerequisites

Command Syntax

passive-interface IFNAME

no passive-interface IFNAME

Command Mode

Router Configuration

Default

Interface is active by default.

Usage

The command disable the sending of routing updates and ignore the request message from neighbor on an interface, but updates from other routers on that interface should be received and processed.

Examples

The following example sets the interface eth-0-1 as passive:

Switch# configure terminal
Switch(config)# router ipv6 rip
Switch(config-router)# passive-interface eth-0-1

Related Commands

router ipv6 rip

Command Purpose

To redistribute routes from one routing domain into RIPng routing domain, use the redistribute command in router configuration mode.

To disable redistribution, use the no form of this command.

Prerequisites

Command Syntax

redistribute PROTOCOL { [ metric VALUE ] | route-map NAME }

no redistribute PROTOCOL

Command Mode

Router Configuration

Default

Route redistribution is disabled.

Metric-value: 0

Usage

The metric value specified in the redistribute command supersedes the metric value specified using the default-metric command.

Examples

The following example redistributes the static routes into RIPng with metric 10:

Switch# configure terminal
Switch(config)# router ipv6 rip
Switch(config-router)#redistribute static metric 10

Related Commands

default-metric

Command Purpose

To adjust Routing Information Protocol next generation (RIPng) network timers, use the timers basic command in router configuration mode.

To restore the default timers, use the no form of this command.

Prerequisites

Command Syntax

timers basic UPDATE TIMEOUT INVALID

no timers basic

Command Mode

Router Configuration

Default

Update timer: 30 seconds

Timeout timer: 180 seconds

Invalid timer: 120 seconds

Usage

The basic timing parameters for RIPng are adjustable. Because RIPng is executing a distributed, asynchronous routing algorithm, these timers must be the same for all switches and access servers in the network.

Examples

The following example sets updates to every 5 seconds. If a switch is not learned from in 15 seconds, the route is declared unusable. And after 15 seconds the invalid route will be removed from RIPng routing database:

Switch# configure terminal
Switch(config)# router ipv6 rip
Switch(config-router)#timers basic 5 15 15

Related Commands

None

Command Purpose

To filter networks in routing updates, use the distribute-list command in router configuration mode.

To restore the default value, use the no form of this command.

Prerequisites

Command Syntax

distribute-list ( prefix NAME | ACCESSS-LIST-NAME ) ( in | out ) ( IFNAME | )

no distribute-list ( prefix name | ACCESSS-LIST-NAME ) ( in | out ) ( IFNAME | )

Command Mode

Router Configuration

Default

None

Usage

None

Examples

The following example filters the received RIPng routes:

Switch# configure terminal
Switch(config)# router ipv6 rip
Switch(config-router)# distribute-list prefix 1 in

Related Commands

ipv6 prefix-list

Command Purpose

To specify an aggregate RIPng route announcement, use the aggregate-address command in router configuration mode.

To disable this feature, use the no form of this command.

Prerequisites

Command Syntax

aggregate-address IPV6_PREFIX ( avoid-feedback | ) IFNAME

no aggregate-address IP-ADDRESS IFNAME

Command Mode

Router Configuration

Default

No aggregate address is defined.

Usage

If the routing info is suppressed by aggregate-address, it is still stored in RIPng database, but willn’t be notified to neighbor. On the other hand the aggregate-address will be notified to neighbor.

The command only be useful when the interface is L3.

Examples

In the following example, RIPng specify an aggregate address into RIPng database:

Switch# configure terminal
Switch(config)# router ipv6 rip
Switch(config-router)# aggregate-address 2001:db8::/32

Related Commands

None

Command Purpose

Use this command to set a route map for input or output filtering on a specified interface. Use the no parameter with this command to disable this function.

Prerequisites

Command Syntax

route-map NAME ( in | out ) IFNAME

no route-map name ( in | out ) IFNAME

Command Mode

Router Configuration

Default

None.

Usage

None

Examples

In the following example, set a route map for input filtering interface eth-0-1:

Switch# configure terminal
Switch(config)# router ipv6 rip
Switch(config-router)# route-map routemap10 in eth-0-1

Related Commands

None

Command Purpose

Use this command to configure the maximum prefix. Use the no parameter with this command to disable the limiting of the number of RIPng routes in the routing table.

Prerequisites

Command Syntax

maximum-prefix NUMBER-VALUE ( PERCENTAGE-VALUE | )

no maximum-prefix

Command Mode

Router Configuration

Default

None.

Usage

Use this command to configure the maximum prefix.

Examples

In the following example, set maximum RIPng prefix is 700 and warning percentage is 70%:

Switch# configure terminal
Switch(config)# router ipv6 rip
Switch(config-router)# maximum-prefix 700 70

Related Commands

None

Command Purpose

Use this command to display RIPng information database.

Prerequisites

Command Syntax

show ipv6 rip database

Command Mode

Privileged EXEC

Default

None

Usage

None

Examples

The following is sample output from the show ip rip database command:

Switch# show ipv6 rip database

Codes: R - RIP, Rc - RIP connected, Rs - RIP static, Ra - RIP aggregated,
       Rcx - RIP connect suppressed, Rsx - RIP static suppressed,
       K - Kernel, C - Connected, S - Static, O - OSPF, I - IS-IS, B - BGP
   Network                     Next Hop                  If     Met Tag  Time
Rc 2001:db8:0:6::/64           ::                        eth-0-9   0   0 
Rc 2001:db8:0:49::/64          ::                        eth-0-48   0   0  

Related Commands

show ipv6 rip interface

Command Purpose

To display summary information of Routing Information Protocol next generation (RIPng) for a specific interface, use the show ip rip interface command in privileged EXEC mode.

Prerequisites

Command Syntax

show ipv6 rip interface ( IFNAME | )

Command Mode

Privileged EXEC

Default

None

Usage

None

Examples

The following is sample output from the show ip rip interface command:

Switch# show ipv6 rip interface eth-0-9

eth-0-9 is up, line protocol is up
  Routing Protocol: RIPng
    Passive interface: Disabled
    Split horizon: Enabled with Poisoned Reversed
    IPv6 interface address:
      2001:db8:0:6::2/64
      fe80::b4df:82ff:fe70:ec00/10

Related Commands

show ipv6 rip database

Command Purpose

Use this command to display the summary statistics for RIPng database.

Prerequisites

Command Syntax

show ipv6 rip database database-summary

Command Mode

Privileged EXEC

Default

None

Usage

None

Examples

The following is sample output from the show ip rip database database-summary command:

Switch# show ipv6 rip database database-summary

Type                  Count
RIPng connected       2
Total                 2

Related Commands

show ipv6 rip database

Command Purpose

To show Routing Information Protocol next generation (RIPng), use the show ipv6 protocol rip command in privileged EXEC mode.

Prerequisites

Command Syntax

show ipv6 protocol rip

Command Mode

Privileged EXEC

Default

None

Usage

None

Examples

The following is sample output from the show ipv6 rip interface command:

Switch# show ipv6 protocol rip

Routing Protocol is "ripng"
Sending updates every 30 seconds with +/-50%, next due in 2949331570 seconds
  Timeout after 180 seconds, garbage collect after 120 seconds
  Outgoing update filter list for all interface is not set
  Incoming update filter list for all interface is not set
  Default redistribute metric is 0
  Redistributing:
  Interface
    eth-0-9          
    eth-0-48         
  Routing for Networks:
  Number of routes (including connected): 2
  Distance: (default is 120)

Related Commands

None

Command Purpose

Use this command to specify the options for the displayed debugging information for RIPng events, RIPng packets.

Use the no parameter with this command to disable all debugging.

Prerequisites

Command Syntax

debug ipv6 rip ( all | events | packet | )

no debug ripv6 ( all | events | packet | )

no debug all ipv6 ( rip | )

Command Mode

Privileged EXEC

Default

Disabled

Usage

None

Examples

The following example displays information about the ripng packets that are received and sent out from the connected router:

Switch# debug ipv6 rip packet

Related Commands

show debugging rip

Command Purpose

Use this command to display the RIP debugging status for these debugging options: nsm debugging, RIP event debugging, RIP packet debugging.

Prerequisites

Command Syntax

show debugging ipv6 rip

Command Mode

Privileged EXEC

Default

None

Usage

Use this command to display the debug status of RIPng.

Examples

The following is sample output from the show debugging ripng command:

Switch# show debugging ipv6 rip

RIPng debugging status:
  RIPng event debugging is on

Related Commands

debug ipv6 rip

Command Purpose

Use this command to display the route resources used by RIPng protocol.

Prerequisites

Command Syntax

show resource ipv6 rip

Command Mode

Privileged EXEC

Default

None

Usage

None

Examples

The following is sample output from the show resource ipv6 rip command:

Switch# show resource ipv6 rip

RIPng
Resource                         Used          Capability
=============================================================
Routes                           2              728

Related Commands

show ipv6 rip database

Command Purpose

To clear the specifical route in RIPng routing table, use the command clear ipv6 rip router in privileged exec mode.

Prerequisites

Command Syntax

clear ipv6 rip route ( IPV6_PREFIX | connected | static | ospfv3 | bgp | all )

Command Mode

Privileged EXEC

Default

None.

Usage

Use this command to clear specific data from the RIPng routing table.

Examples

In the following example, clear the entire RIPng routing table:

Switch# clear ipv6 rip route all

Related Commands

None