Commands For Ripng

8.4 Commands for RIPng

8.4.1 clear ipv6 route

Command: clear ipv6 rip route {<ipv6-address >| kernel |static | connected |rip |ospf |isis | bgp |all }
Function: Clear a specific route from the RIPng route table.
Parameters: Clears a route that exactly matches the destination address in the RIPng route table.

  • <ipv6-address>: destination address shown in hex notation with a prefix length.
  • kernel: delete the kernel route from the RIPng route table.
  • static: delete the static route from the RIPng route table.
  • connected: delete the direct route from the RIPng route table.
  • rip: delete the RIP route from the RIPng route table only.
  • ospf: delete the IPv6 OSPF route from the RIPng route table only.
  • bgp: delete the IPv6 BGP route from the RIPng route table only.
  • ISIS: delete the ivp6 isis route from the RIPng route table only.
  • all: delete all routes from the RIPng route table.

Command mode: Admin Mode
Default: No default configuration.
Usage guide: All routes in the RIPng route table will be deleted by using this command with all parameters.
Example: Clear a specific route from the RIPng route table.

active500EM#clear ipv6 rip route 2001:1:1::/64
active500EM#clear ipv6 rip route ospf

 

8.4.2 default-information originate

Command: default-information originate
no default-information originate
Function: Permit redistribution of the network 0:: into RIPng. The no command disables this function.
Parameters: None.
Command mode: Router Mode
Default: Disabled.
Usage guide: Permit redistribution of the the network 0:: into RIPng.
Example: Permit redistribution of the network 0:: into RIPng.

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

 

8.4.3 default-metric

Command: default-metric <value>
no default-metric
Function: Set the default metric route value of the introduced route. The no command restores the default value.
Parameters:

  • <value>: route metric value to be set. The valid range is between 1 and 16.

Command mode: Router Mode
Default: Default route metric value is 1.
Usage guide: The default-metric command is used to set the default route metric value of the routes from other routing protocols when distributed into the RIPng routes. When using the redistribute commands for introducing routes from other protocols, the default route metric value specified by default-metric will be adopted if no specific route metric value is set.
Example: Set the default route metric value of the routes from other routing protocols when distributed into the RIPng routes to 3.

active500EM(config-router)#default-metric 3

Related Command: redistribute
 

8.4.4 distance

Command: distance <number> [<ipv6-address>][<access-list-name|access-list-number>] no distance [<ipv6-address>] Function: Set the managed distance with this command. The no command restores the default value to 120.
Parameters:

  • <number>: distance value. The valid range is between 1 and 255.
  • <ipv6-address>: local link address or its prefix.
  • <access-list-name|access-list-number>: specifies the access-list name or number applied.

Command mode: Router and address-family mode
Default: The default managing distance of RIP is 120.
Usage guide: In case there are routes from two different routing protocols to the same destination, the managed distance is used to select the routes. The less the managed distance of the route protocol, the more reliable the route acquired from the protocol.
Example: Set the managed distance with this command.

active500EM#config terminal
active500EM(config)#router rip
active500EM(config-router)#distance 8 fe80:1111::4200:21ff:fe00:11 mylist

 

8.4.5 distribute-list

Command: distribute-list {<access-list-name> |prefix <prefix-list-name>} {in|out} [<ifname>|vlan <vlan-id>] no distribute-list {access-list-name> |prefix<prefix-list-name>} {in|out} [<ifname>|vlan<vlan-id>] Function: This command uses access-list or prefix-list to filter the route renew messages sent and received. The no command cancels this filter command.
Parameters:

  • <access-list-name>: name or access-list number to be applied.
  • <prefix-list-name>: name of the prefix-list to be applied.
  • <ifname>: name of the interface to be applied with route filtering.
  • <vlan-id>: VLAN ID of an existing VLAN. The valid range is from 1 to 4094.

Command mode: Router Mode
Default: Function disabled by RIPng.
Usage guide: The filter will be applied to all interfaces if no specific interface is set.
Example: This command uses access-list or prefix-list to filter the route re-new messages sent and received.

active500EM#config terminal
active500EM(config)#router ipv6 rip
active500EM(config-router)#distribute-list prefix myfilter in Vlan1

 

8.4.6 debug ipv6 rip

Command: debug ipv6 rip [events| nsm| packet[recv|send][detail]| all] no debug ipv6 rip [events| nsm| packet[recv|send][detail]| all] Function: Open various RIPng debug switches to show debug messages. The no command closes the corresponding debug switch.
Parameters:

  • events: RIPng event debug messages.
  • nsm: communication messages between RIPng and NSM.
  • packet: RIPng data packet debug messages.
  • recv: received data packet messages.
  • send: sent data packet messages.
  • detail: messages for data packets received or sent.

Command mode: Admin Mode
Default: Not enabled.
Usage guide: Open various RIPng debug switches to show debug messages.
Example: Open various RIPng debug switches to show debug messages.

active500EM#debug ipv6 rip packet
1970/01/01 21:15:08 IMI: SEND[Ethernet1/0/4]: Send to [ff02::9]:521
1970/01/01 21:15:08 IMI: SEND[Ethernet1/0/2]: Send to [ff02::9]:521
1970/01/01 21:15:09 IMI: RECV[Ethernet1/0/4]: Receive from [fe80::20b:46ff:fe57:8e60]:521
1970/01/01 21:15:09 IMI: RECV[Ethernet1/0/4]: 3000:1:1::/64 is filtered by access-list dclist
1970/01/01 21:15:09 IMI: RECV[Ethernet1/0/4]: 3ffe:1:1::/64 is filtered by access-list dclist
1970/01/01 21:15:15 IMI: RECV[Ethernet1/0/2]: Receive from [fe80::203:fff:fe01:257c]:521

 

8.4.7 debug ipv6rip redistribute message send

Command:debug ipv6 rip redistribute message send
no debug ipv6 rip redistribute message send
Function: Enable the debugging of sending messages for routing redistribution messages from OSPFv3 or other external processes for RIPng. The no command disables the debugging messages.
Parameters: None.
Command mode: Admin Mode
Default: Close the debug.
Usage guide: Enable the debugging of sending messages for routing redistribution messages from OSPFv3 or other external processes for RIPng.
Example: Enable the debugging of sending messages for routing redistribution messages from OSPFv3 or other external processes for RIPng.

active500EM#debug ipv6 rip redistribute message send
active500EM#nodebug ipv6 rip redistribute message send

 

8.4.8 debug ipv6 rip redistribute route receive

Command:debug ipv6 rip redistribute route receive
no debug ipv6 rip redistribute route receive
Function: Enable the debug switch received from NSM for redistribution of routing information for RIPng. The no command disables the debugging switch.
Parameters: None.
Command mode: Admin Mode
Default: Close the debug.
Usage guide: Enable the debug switch received from NSM for redistribution of routing information for RIPng.
Example: Enable the debug switch received from NSM for redistribution of routing information for RIPng.

active500EM#debug ipv6 rip redistribute route receive
active500EM#no debug ipv6 rip redistribute route receive

 

8.4.9 ipv6 rip aggregate-address

Command: ipv6 rip aggregate-address <X:X::X:X/M>
no ipv6 rip aggregate-address <X:X::X:X/M>
Function: Configure the IPv6 aggregation route. The no command deletes the IPv6 aggregation route.
Parameters:

  • <X:X::X:X/M>: IPv6 address and prefix length.

Command mode: Router Mode or Interface Configuration Mode
Default: No aggregation route configured.
Usage guide: If configuring the aggregation route under Router Mode, the RIPng protocol must be enabled. If configuring under Interface Configuration Mode, RIPng protocol may not be enabled. However, the aggregation route can operate after the RIPng protocol is enabled on the interface.
Example: Configure the aggregation route to 2001:3f:ed8::99/64 globally.

active500EM(config)#router rip
active500EM(config-router)#ipv6 rip agg 2001:3f:ed8::99/64

 

8.4.10 ipv6 rip split-horizon

Command: ipv6 rip split-horizon [poisoned] no ipv6 rip split-horizon
Function: Permit the split horizon. The no command disables the split horizon.
Parameters:

  • poisoned: configures split horizon with poison reverse.

Command mode: Interface Configuration Mode
Default: Split horizon with poison reverse.
Usage guide: The split horizon prevents routing loops. It prevents the Layer 3 switch from broadcasting a route to the interface from which the route is learned. The command can configure an IPv6 tunnel interface.
Example: Permit the split horizon.

active500EM#config terminal
active500EM(config)#interface Vlan1
active500EM(config-if-Vlan1)#ipv6 rip split-horizon poisoned

 

8.4.11 ipv6 router rip

Command: ipv6 router rip
no ipv6 router rip
Function: Enable RIPng on the interface. The no command disables RIPng on the interface.
Parameters: None.
Command mode: Interface Configuration Mode
Default: Not configured
Usage guide: The command can configure an IPv6 tunnel interface.
Example: Enable RIPng on the interface.

active500EM#config terminal
active500EM(config)#interface Vlan1
active500EM(Config-if-Vlan1)#ipv6 router rip

 

8.4.12 neighbor

Command: neighbor <ipv6-address>{<ifname> vlan <vlan-id>}
no neighbor <ipv6-address>{<ifname>vlan <vlan-id>}
Function: Specify the destination address. The no command cancels the specified address defined and restores all trusted gateways.
Parameters:

  • <ipv6-address>: IPv6 Link-local address specified for sending. It is shown in colon hex notation without the prefix length.
  • <ifname>: interface name.
  • <vlan-id>: VLAN ID of an existing VLAN. The valid range is from 1 to 4094.

Command mode: Router Mode
Default: Does not send to a specified destination address.
Usage guide: When using the associated passive-interface command, routing messages can be sent to a specified neighbor only.
Example: Specify the destination address.

active500EM#config terminal
active500EM(config)#router ipv6 rip
active500EM(config-router)#neighbor FE80:506::2 Vlan1

Related Command: passive-interface
 

8.4.13 offset-list

Command: offset-list <access-list-number|access-list-name> {in|out}<number >[<ifname>|vlan <vlan-id>] no offset-list <access-list-number|access-list-name> {in|out }<number >[<ifname>|vlan <vlan-id>] Function: Add an offset value on the routing metric value learned by RIPng. The no command disables this function.
Parameters:

  • <access-list-number |access-list-name>: access-list or name to be applied.
  • <number>: additional offset value. The valid range is between 0 and 16.
  • <ifname>: specific interface name.
  • <vlan-id>: VLAN ID of an existing VLAN. The valid range is from 1 to 4094.

Command mode: Router Mode
Default: The default offset value is the metric value of the interface defined by the system.
Usage guide: Add an offset value on the routing metric value learned by RIPng.
Example: Add an offset value on the routing metric value learned by RIPng.

active500EM#config terminal
active500EM(config)#router ipv6 rip
active500EM(config-router)#offset-list 1 in 5 Vlan1

Related Command: access-list
 

8.4.14 passive-interface

Command: passive-interface {<ifname>|vlan<vlan-id>}
no passive-interface {<ifname>|vlan<vlan-id>}
Function: Set the RIPng Layer 3 switches to block RIPng broadcast on the specified interfaces and only send the RIPng data packet to the Layer 3 switch which is configured with a neighbor.
Parameters:

  • <ifname>: interface name.
  • <vlan-id>: VLAN ID of an existing VLAN. The valid range is from 1 to 4094.

Command mode: Router Mode
Default: Not configured.
Usage guide: Set the RIPng Layer 3 switches to block RIPng broadcast on the specified interfaces and only send the RIPng data packet to the Layer 3 switch which is configured with a neighbor.
Example: Set the RIPng Layer 3 switches to block RIPng broadcast on the specified interfaces and only send the RIPng data packet to the layer 3 switch which is configured with a neighbor.

active500EM#config terminal
active500EM(config)#router ipv6 rip
active500EM(config-router)#passive-interface Vlan1

Related Command: show ipv6 rip
 

8.4.15 redistribute

Command: redistribute {kernel |connected| static| ospf| isis| bgp} [metric<value>] [route-map<word>] no redistribute {kernel |connected| static| ospf| isis| bgp} [metric<value>] [route-map<word>] Function: Introduce routes learned from other routing protocols into RIPng.
Parameters:

  • kernel: introduce from kernel routes.
  • connected: introduce from direct routes.
  • static: introduce from static routes.
  • ospf: introduce from IPv6 OSPF routes.
  • isis: introduce from IPv6 ISIS routes.
  • bgp: introduce from IPv6 BGP routes.
  • <value>: metric value assigned to the introduced route. The valid range is between 0 and 16
  • <word>: probe pointing to the route map for introducing routes.

Command mode: Router Mode
Default: None.
Usage guide: Introduce routes learned from other routing protocols into RIPng.
Example: Introduce routes learned from other routing protocols into RIPng.

active500EM#config terminal
active500EM(config)#router ipv6 rip
active500EM(config-router)#redistribute kernel route-map ip

 

8.4.16 redistribute ospf

Command: redistribute ospf[<process-tag>][metric<value>] [route-map<word>] no redistribute ospf[<process-tag>] Function: Redistribute routing information from external OSPFv3 processes to RIPng process. The no command removes the introduced OSPFv3 routing entries.
Parameters:

  • <process-tag>: string tag for the OSPFv3 process with a maximum length limited to 15 characters. If not specified, the default process will be used.
  • <value>: metric for the introduced routing entries. The valid value is between 0 and 16.
  • <word>: pointer to the introduced routing map.

Command mode: RIPng Configuration Mode
Default: Not redistributed.
Usage guide: Redistribute routing information from external OSPFv3 processes to the RIPng process.
Example: Redistribute OSPFv3 ABC routing ro RIPng.

active500EM(config)#router ipv6 rip
active500EM(config-router)#redistribute ospf abc

 

8.4.17 route

Command: route <ipv6-address>
no route <ipv6-address>
Function: This command configures a static RIPng route. The no command deletes this route.
Parameters:

  • <ipv6-address>: destination IPv6 address prefix. The length is shown in colon hex notation.

Command mode: Router Mode
Default: None.
Usage guide: The command adds a static RIPng route and is used for debugging. Routes configured by this command will not appear in the kernel route table but in the RIPng route database. The routes configured can be located by using the ?show ipv6 rip? command.
Example: This command configures a static RIPng route.

active500EM#config terminal
active500EM(config)#router ipv6 rip
active500EM(config-router)#route 3ffe:1234:5678::1/64

 

8.4.18 router ipv6 rip

Command: router ipv6 rip
no router ipv6 rip
Function: Enable the RIPng routing process and enter RIPng mode. The no command disables the RIPng routing protocol.
Parameters: None.
Command mode: Global Mode
Default: RIPng routing not running.
Usage guide: This command enables the RIPng routing protocol. This command should be enabled before performing other global configurations of the RIPng protocol.
Example: Enable the RIPng protocol mode.

active500EM(config)#router ipv6 rip

 

8.4.19 show debugging ipv6 rip

Command: show debugging ipv6 rip
Function: Show the RIPng debug status for the following debug options: nsm debugging, RIPng event debugging, RIPng packet debugging, and RIPng nsm debugging.
Parameters: None.
Command mode: Admin Mode
Default: None.
Usage guide: Show the RIPng debug status for the following debug options: nsm debugging, RIPng event debugging, RIPng packet debugging, and RIPng nsm debugging.
Example: Show the RIPng debug status for the following debug options: nsm debugging, RIPng event debugging, RIPng packet debugging, and RIPng nsm debugging.

active500EM#show debugging ipv6 rip
RIPng debugging status:
  RIPng event debugging is on
  RIPng packet detail debugging is on
  RIPng NSM debugging is on

 

8.4.20 show ipv6 rip interface

Command: show ipv6 rip interface
Function: Display the interface and line protocols.
Parameters: None.
Command mode: Admin Mode
Default: None.
Usage guide: This command displays the interface and line protocols which allows the user to verify that the interface and line protocols are up.
Example: Display the interface and line protocols.

active500EM(config)#show ipv6 rip interface
Loopback is up, line protocol is up
RIPng is not enabled on this interface
Vlan1 is up, line protocol is up
Routing Protocol: RIPng
Passive interface: Disabled
Split horizon: Enabled with Poisoned Reversed
IPv6 interface address:
3000:1:1::1/64
fe80::203:fff:fe0c:cda/64
Displayed information Explanations
Vlan1 is up, line protocol is up Interface is Up
Routing Protocol: RIP The routing protocol running on the interface is RIPng
Passive interface: Disabled Passive-interface disabled
Split horizon: Enabled with Poisoned Reversed The split horizon is enabled with poisoned reversed on the interface.
IP interface address: 3000:1:1::1/64 fe80::203:fff:fe01:429e/64 IPv6 address of the interface

 

8.4.21 show ipv6 rip redistribute

Command: show ipv6 rip redistribute
Function: Show the configuration of the redistributed IPv6p routing to RIPng.
Parameters: None.
Default: Not shown.
Command Mode: Admin Mode and Configuration Mode.
Default: Not shown.
Usage guide: Show the configuration of the redistributed IPv6p routing to RIPng.
Example: Show the configuration of the redistributed IPv6p routing to RIPng.

active500EM#show ipv6 rip redistribute

 

8.4.22 show ipv6 protocols rip

Command: show ipv6 protocols rip
Function: Show the RIPng process parameters and statistic messages.
Parameters: None.
Command mode: Admin Mode
Default: None.
Usage guide: Show the RIPng process parameters and statistic messages.
Example: Show the RIPng process parameters and statistic messages.

active500EM(config)#show ipv6 protocols rip
Routing Protocol is "RIPng"
Sending updates every 30 seconds with +/-50%, next due in 1 second
Timeout after 180 seconds, garbage collect after 120 seconds
Outgoing update filter list for all interfaces is not set
Incoming update filter list for all interfaces is not set
Ethernet1/0/4 filtered by dclist
Default redistribute metric is 1
Redistributing: static
	Interface
    Vlan10
    Vlan2
	Routing for Networks:
Displayed information Explanations
Sending updates every 30 seconds with +/-50%, next due in 1 seconds Sending updates every 30 seconds
Timeout after 180 seconds, garbage collect after 120 seconds The route timeout time is 180 seconds. The garbage collect time is 120 seconds
Outgoing update filter list for all interfaces is not set Outgoing update filter list for all interfaces is not set
Incoming update filter list for all interfaces is not set Incoming update filter list for all interfaces is not set
Default redistribution metric is 1 Default redistribution metric is 1
Redistributing: static Redistribute the static route into the RIP routes
Interface Vlan10 Vlan2 The interfaces running RIP are Vlan 10 and Vlan 2

 

8.4.23 show ipv6 rip

Command: show ipv6 rip
Function: Show RIPng routing.
Parameters: None.
Command mode: Admin Mode
Default: None.
Usage guide: Show RIPng routing.
Example: Show RIPng routing.

active500EM#show ipv6 rip
Codes: R - RIP, K - Kernel, C - Connected, S - Static, O - OSPF, I - IS-IS,
       B - BGP, a - aggregate, s - suppressed
   Network                     Next Hop                    If     Met Tag  Time
R  2000:1:1::/64               ::                          Vlan2   1   0
R  2001:1:1::/64               fe80::203:fff:fe01:257c     Vlan2   2   0  02:40
R  3000:1:1::/64               ::                          Vlan10  1   0
R  3010:1:1::/64               ::                          --      1   0

R stands for RIP route, specifically, a RIP route with the destination network address 2001:1:1::/64 and next-hop address at fe80::203:fff:fe01:257c. It is learned from the Ethernet port VLAN2 with a metric value of 2 and has 2 minutes 40 seconds before time out.
Related Command: show ipv6 rip database

8.4.24 show ipv6 rip database

Command: show ipv6 rip database
Function: Show messages related to the RIPng database.
Parameters: None.
Command mode: Admin Mode
Default: None.
Usage guide: Show messages related to the RIPng database.
Example: Show messages related to the RIPng database.

active500EM#show ipv6 rip database

Related Command: show ipv6 rip
 

8.4.25 show ipv6 rip aggregate

Command: show ipv6 rip aggregate
Function: Display the IPv6 aggregation route information.
Parameters: None.
Command mode: Admin and Configuration Mode
Default: None.
Usage guide: This command displays the aggregation route configuration – Metric, Count, and Suppress. If configured under Global Mode, the interface display is ??-?. ?Metric? shows the metric information. ?Count? shows the number of learned aggregation routes. ?Suppress? shows the number of aggregations.
Example: Display the IPv6 aggregation route information.

active500EM(config-router)#show ipv rip agg
RIPng aggregate information
   Network                 Aggregated Ifname     Metric Count Suppress
   2001::/16               Vlan1                  1      2     0
   2001:1::/32             ----                   1      2     0
   2001:1:2::/60           Vlan1                  1      1     1
                           ----                   1      1     1
Displayed information Explanation
Network Route prefix and prefix length.
Aggregated Ifname Configured interface name of the aggregation route. If the route is aggregated globally, ??? is displayed.
Metric Metric of the aggregation route.
Count The number of learned aggregation routes.
Suppress The number of aggregations.

 

8.4.26 show ipv6 rip redistribute

Command: show ipv6 rip redistribute
Function: Display the configuration information of the redistributed ipv6 route to RIPng.
Parameters: None.
Command mode: Admin Mode and Configuration Mode
Default: Not shown.
Usage guide: Displays the configuration information of the redistributed IPv6 route to RIPng.
Example: Display the configuration information of the redistributed IPv6 route to RIPng.

active500EM#show ipv6 rip redistribute

 

8.4.27 timers basic

Command: timers basic <update><invalid><garbage>
no timers basic
Function: Adjust the RIP timer update, timeout, and garbage collection times. The no command restores each parameter to their default values.
Parameters:

  • <update>: sending update packet time interval shown in seconds. The valid range is between 5 and 2147483647.
  • <invalid>: time period after which the RIP route is advertised as dead. The valid value is seconds and ranges between 5 and 2147483647.
  • <garbage>: hold time in which a route remains in the routing table after it is advertised as dead. The valid value is seconds and ranges between 5 and 2147483647.

Command mode: Router Mode
Default: <update> defaulted to 30. <invalid> defaulted to 180. <garbage> defaulted to120
Usage guide: The system defaults to update broadcasting RIPng packets every 30 seconds. The route is considered invalid after 180 seconds but still exists for another 120 seconds before it is deleted from the routing table.
Example: Set the RIP update time to 20 seconds, the timeout period to 80 seconds, and the garbage collection time to 60 seconds.

active500EM(config-router)#timers basic 20 80 60

 


Return to Controller Wired CLI Table of Contents