Table of Contents
8.4 Commands for RIPng
8.4.1 clear ipv6 route
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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