After the zero field check is enabled, the router discards RIPv1 messages in which zero fields are non-zero. If all messages are trusty, you can disable this feature to reduce the processing time of the CPU.

Examples

# Disable the zero field check on RIPv1 messages for RIP process 100.

<Sysname> system-view

[Sysname] rip 100

[Sysname-rip-100] undo checkzero

default cost (RIP view)

Syntax

default cost value

undo default cost

View

RIP view

Default level

2: System level

Parameters

value: Specifies a default metric of redistributed routes, in the range of 0 to 16.

Description

Use default cost to configure the default metric for redistributed routes.

Use undo default cost to restore the default.

By default, the default metric of redistributed routes is 0.

When you use the import-route command to redistribute routes from other protocols without specifying a metric, the metric specified by the default cost command applies.

Related command: import-route.

Examples

# Configure the default metric for redistributed routes as 3.

<Sysname> system-view

[Sysname] rip 100

[Sysname-rip-100] default cost 3

default-route

Syntax

default-route { only | originate } [ cost cost ]

undo default-route

View

RIP view

Default level

2: System level

Parameters

only: Advertises only a default route.

originate: Advertises both a default route and other routes.

cost: Specifies a cost for the default route, in the range of 1 to 15. The default is 1.

Description

Use default-route to configure all the interfaces under the RIP process to advertise a default route with the specified metric to RIP neighbors.

Use undo default-route to disable all the interfaces under the RIP process from sending a default route.

By default, no default route is sent to RIP neighbors.

The RIP router with this feature configured will not receive any default routes from RIP neighbors.

Related commands: rip default-route.

Examples

# Configure all the interfaces under RIP process 100 to send only a default route with a metric of 2 to RIP neighbors.

<Sysname> system-view

[Sysname] rip 100

[Sysname-rip-100] default-route only cost 2

display rip

Syntax

display rip [ process-id | vpn-instance vpn-instance-name ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

process-id: Specifies a RIP process by its ID in the range of 1 to 65535. If no process ID is specified, information about all configured RIP processes is displayed.

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN. vpn-instance-name is a case-sensitive string of 1 to 31 characters. If no VPN is specified, the information of the public network is displayed.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use display rip to display the current status and configuration information of the specified RIP process.

Examples

# Display the current status and configuration information of all configured RIP processes.

<Sysname> display rip

Public VPN-instance name :

RIP process : 1

RIP version : 1

Preference : 100

Checkzero : Enabled

Default-cost : 0

Summary : Enabled

Hostroutes : Enabled

Maximum number of balanced paths : 32

Update time : 30 sec(s) Timeout time : 180 sec(s)

Suppress time : 120 sec(s) Garbage-collect time : 120 sec(s)

update output delay : 20(ms) output count : 3

TRIP retransmit time : 5 sec(s)

TRIP response packets retransmit count : 36

Silent interfaces : None

Default routes : Only Default route cost : 3

Verify-source : Enabled

Networks :

192.168.1.0

Configured peers : None

Triggered updates sent : 0

Number of routes changes : 0

Number of replies to queries : 0

Table 1 Command output

Field	Description
Public VPN-instance name (or Private VPN-instance name)	The RIP process runs under a public VPN instance/The RIP process runs under a private VPN instance.
RIP process	RIP process ID.
RIP version	RIP version 1 or 2.
Preference	RIP route priority.
Checkzero	Indicates whether the zero field check is enabled for RIPv1 messages.
Default-cost	Default cost of the redistributed routes.
Summary	Indicates whether route summarization is enabled.
Hostroutes	Indicates whether to receive host routes.
Maximum number of balanced paths	Maximum number of load balanced routes.
Update time	RIP update interval.
Timeout time	RIP timeout time.
Suppress time	RIP suppress interval.
update output delay	RIP packet sending interval.
output count	Maximum number of RIP packets sent at each interval.
Garbage-collect time	RIP garbage collection interval.
TRIP retransmit time	TRIP retransmit interval for sending update requests and responses.
TRIP response packets retransmit count	Maximum retransmit times for update requests and responses.
Silent interfaces	Number of silent interfaces, which do not periodically send updates.
Default routes	Indicates whether a default route is sent to RIP neighbors. · only—Only a default route is advertised. · originate—A default route is advertised along with other routes. · disable—No default route is advertised.
Default route cost		Cost of the default route.
Verify-source	Indicates whether the source IP address is checked on the received RIP routing updates.
Networks	Networks enabled with RIP.
Configured peers	Configured neighbors.
Triggered updates sent	Number of sent triggered updates.
Number of routes changes	Number of changed routes in the database.
Number of replies to queries	Number of RIP responses.

display rip database

Syntax

display rip process-id database [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

process-id: Specifies a RIP process by its ID in the range of 1 to 65535.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use display rip database to display active routes in the database of the specified RIP process, which are sent in RIP routing updates.

Examples

# Display the active routes in the database of RIP process 100.

<Sysname> display rip 100 database

10.0.0.0/8, cost 1, ClassfulSumm

10.0.0.0/24, cost 1, nexthop 10.0.0.1, Rip-interface

11.0.0.0/8, cost 1, ClassfulSumm

11.0.0.0/24, cost 1, nexthop 10.0.0.1, Imported

Table 2 Command output

Field	Description
X.X.X.X/X	Destination address and subnet mask.
cost	Cost of the route.
classful-summ	Indicates the route is a RIP summary route.
Nexthop	Address of the next hop.
Rip-interface	Routes learnt from a RIP-enabled interface.
imported	Routes redistributed from other routing protocols.

display rip interface

Syntax

display rip process-id interface [ interface-type interface-number ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

process-id: Specifies a RIP process by its ID in the range of 1 to 65535.

interface-type interface-number: Specifies an interface.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use display rip interface to display the RIP interface information of the RIP process.

If no interface is specified, information about all RIP interfaces of the RIP process is displayed.

Examples

# Display all the interface information of RIP process 1.

<Sysname> display rip 1 interface

Interface-name: Vlan-interface11

Address/Mask:1.1.1.1/24 Version:RIPv1

MetricIn:5 MetricIn route policy:123

MetricOut:5 MetricOut route policy:234

Split-horizon/Poison-reverse:on/off Input/Output:on/on

Default route:off

Current packets number/Maximum packets number:234/2000

Table 3 Command output

Field	Description
Interface-name	Name of an interface running RIP.
Address/Mask	IP address and mask of the interface.
Version	RIP version running on the interface.
MetricIn	Additional routing metric added to the incoming routes.
MetricIn route policy	Name of the routing policy used to add the additional routing metric for the incoming routes. If no routing policy is referenced, the field displays Not designated.
MetricOut	Additional routing metric added to the outgoing routes.
MetricOut route policy	Name of the routing policy used to add the additional routing metric for the outgoing routes. If no routing policy is referenced, the field displays Not designated.
Split-horizon	Indicates whether split-horizon is enabled: · on—Enabled. · off—Disabled.
Poison-reverse	Indicates whether poison-reverse is enabled: · on—Enabled. · off—Disabled.
Input/Output	Indicates if the interface is allowed to receive (Input) or send (Output) RIP messages: · on—It is allowed. · off—It is not allowed.
Default route	Indicates whether sending the default route to RIP neighbors is allowed: · on—It is allowed. · off—It is not allowed.
Current packets number/Maximum packets number	Packets to be sent/Maximum packets that can be sent on the interface.

display rip route

Syntax

display rip process-id route [ ip-address { mask | mask-length } | peer ip-address| statistics ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

process-id: Specifies a RIP process by its ID in the range of 1 to 65535.

ip-address { mask | mask-length }: Displays route information about a specified IP address.

peer ip-address: Displays all routing information learned from a specified neighbor.

statistics: Displays the route statistics, including total number of routes and number of routes of each neighbor.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use display rip route to display the routing information of a specified RIP process.

Examples

# Display all routing information of RIP process 1.

<Sysname> display rip 1 route

Route Flags: R - RIP, T - TRIP

P - Permanent, A - Aging, S - Suppressed, G - Garbage-collect

--------------------------------------------------------------------------

Peer 111.1.1.2 on Vlan-interface11

Destination/Mask Nexthop Cost Tag Flags Sec

122.0.0.0/8 111.1.1.2 1 0 RA 22

Table 4 Command output

Field	Description
Route Flags	· R—RIP route. · T—TRIP route. · P—The route never expires. · A—The route is aging. · S—The route is suppressed. · G—The route is in Garbage-collect state.
Peer 21.0.0.23 on Vlan-interface11	Routing information learned on a RIP interface from the specified neighbor.
Destination/Mask	Destination IP address and subnet mask.
Nexthop	Next hop of the route.
Cost	Cost of the route.
Tag	Route tag.
Flags	Indicates the route state.
Sec	Remaining time of the timer corresponding to the route state.

# Display the routing statistics of RIP process 1.

<Sysname> display rip 1 route statistics

Peer Aging Permanent Garbage

111.1.1.2 1 0 0

Total 1 0 0

Table 5 Command output

Field	Description
Peer	IP address of a neighbor.
Aging	Total number of aging routes learned from the specified neighbor.
Permanent	Total number of permanent routes learned from the specified neighbor.
Garbage	Total number of routes in garbage-collection state learned from the specified neighbor.
Total	Total number of routes learned from all RIP neighbors.

fast-reroute

Syntax

fast-reroute route-policy route-policy-name

undo fast-reroute

View

RIP view

Default level

2: System level

Parameters

route-policy route-policy-name: References a routing policy to designate a backup next hop. The route-policy-name argument is a case-sensitive string of 1 to 63 characters.

Description

Use fast-reroute to configure RIP fast reroute (FRR).

Use undo fast-reroute to restore the default.

By default, RIP FRR is disabled.

IMPORTANT:

· RIP FRR is only effective for non-recursive RIP routes that are learned from directly connected neighbors.

· Do not use RIP FRR and BFD for RIP at the same time; otherwise, RIP FRR might fail to take effect.

Example

# Enable RIP FRR and reference routing policy frr to specify a backup next hop.

<Sysname> system-view

[Sysname] bfd echo-source-ip 1.1.1.1

[Sysname] ip ip-prefix abc index 10 permit 100.1.1.0 24

[Sysname] route-policy frr permit node 10

[Sysname-route-policy] if-match ip-prefix abc

[Sysname-route-policy] apply fast-reroute backup-interface Vlan-interface 1000 backup-nexthop 193.1.1.8

[Sysname-route-policy] quit

[Sysname] rip 100

[Sysname-rip-100] fast-reroute route-policy frr

filter-policy export (RIP view)

Syntax

filter-policy { acl-number | ip-prefix ip-prefix-name } export [ protocol [ process-id ] | interface-type interface-number ]

undo filter-policy export [ protocol [ process-id ] | interface-type interface-number ]

View

RIP view

Default level

2: System level

Parameters

acl-number: Specifies an ACL by its number in the range of 2000 to 3999 to filter outbound routes.

ip-prefix ip-prefix-name: Specifies an IP prefix list by its name, a string of 1 to 19 characters, to filter outbound routes.

protocol: Filters outbound routes redistributed from a specified routing protocol, which can be bgp, direct, isis, ospf, rip, and static.

process-id: Specifies the process ID of the specified routing protocol, in the range of 1 to 65535. You need to specify a process ID when the routing protocol is rip, ospf, or isis.

interface-type interface-number: Specifies an interface by its type and number.

Description

Use filter-policy export to configure the filtering of RIP outgoing routes. Only routes not filtered out can be advertised.

Use undo filter-policy export to remove the filtering.

By default, RIP does not filter outbound routes.

· If protocol is specified, RIP filters only the outgoing routes redistributed from the specified routing protocol. Otherwise, RIP filters all routes to be advertised.

· If interface-type interface-number is specified, RIP filters only the routes advertised by the specified interface. Otherwise, RIP filters routes advertised by all RIP interfaces.

· If you want to reference an advanced ACL (with a number from 3000 to 3999) in the command, the ACL should be configured with the rule [ rule-id ] { deny | permit } ip source sour-addr sour-wildcard command to deny/permit a route with the specified destination, or with the rule [ rule-id ] { deny | permit } ip source sour-addr sour-wildcard destination dest-addr dest-wildcard command to deny/permit a route with the specified destination and mask. The source keyword specifies the destination address of a route while the destination keyword specifies the subnet mask of the route (the subnet mask must be valid; otherwise, the configuration is ineffective).

Related commands: ip ip-prefix; acl (ACL and QoS Command Reference).

Examples

# Reference ACL 2000 to filter outbound routes.

<Sysname> system-view

[Sysname] acl number 2000

[Sysname-acl-basic-2000] rule deny ip source 192.168.10.0 0.0.0.255

[Sysname-acl-basic-2000] quit

[Sysname] rip 1

[Sysname-rip-1] filter-policy 2000 export

# Reference IP prefix list abc to filter outbound routes on VLAN-interface 11.

[Sysname-rip-1] filter-policy ip-prefix abc export Vlan-interface 11

# Configure ACL 3000 to permit only route 113.0.0.0/16 to pass, and reference ACL 3000 to filter outbound routes.

<Sysname> system-view

[Sysname] acl number 3000

[Sysname-acl-adv-3000] rule 10 permit ip source 113.0.0.0 0 destination 255.255.0.0 0

[Sysname-acl-adv-3000] rule 100 deny ip

[Sysname-acl-adv-3000] quit

[Sysname] rip 1

[Sysname-rip 1] filter-policy 3000 export

filter-policy import (RIP view)

Syntax

filter-policy { acl-number | gateway ip-prefix-name | ip-prefix ip-prefix-name [ gateway ip-prefix-name ] } import [ interface-type interface-number ]

undo filter-policy import [ interface-type interface-number ]

View

RIP view

Default level

2: System level

Parameters

acl-number: Specifies an ACL by its number in the range of 2000 to 3999 to filter incoming routes.

ip-prefix ip-prefix-name: References an IP prefix list to filter incoming routes. The ip-prefix-name is a string of 1 to 19 characters.

gateway ip-prefix-name: References an IP prefix list to filter routes from the gateway. ip-prefix-name is a string of 1 to 19 characters.

interface-type interface-number: Specifies an interface by its type and number.

Description

Use filter-policy import to configure RIP to filter the incoming routes.

Use undo filter-policy import to restore the default.

If you want to reference an advanced ACL (with a number from 3000 to 3999) in the command, the ACL should be configured with the rule [ rule-id ] { deny | permit } ip source sour-addr sour-wildcard command to deny/permit a route with the specified destination, or with the rule [ rule-id ] { deny | permit } ip source sour-addr sour-wildcard destination dest-addr dest-wildcard command to deny/permit a route with the specified destination and mask. The source keyword specifies the destination address of a route while the destination keyword specifies the subnet mask of the route (the subnet mask must be valid; otherwise, the configuration is ineffective).

By default, RIP does not filter incoming routes.

Related commands: ip ip-prefix; acl (ACL and QoS Command Reference).

Examples

# Reference ACL 2000 to filter incoming routes.

<Sysname> system-view

[Sysname] acl number 2000

[Sysname-acl-basic-2000] rule deny ip source 192.168.10.0 0.0.0.255

[Sysname-acl-basic-2000] quit

[Sysname] rip 1

[Sysname-rip-1] filter-policy 2000 import

# Reference IP prefix list abc on GigabitEthernet 3/0/1 to filter all received RIP routes.

[Sysname-rip-1] filter-policy ip-prefix abc import GigabitEthernet 3/0/1

# Configure ACL 3000 to permit only route 113.0.0.0/16 to pass, and reference ACL 3000 to filter incoming routes.

<Sysname> system-view

[Sysname] acl number 3000

[Sysname-acl-adv-3000] rule 10 permit ip source 113.0.0.0 0 destination 255.255.0.0 0

[Sysname-acl-adv-3000] rule 100 deny ip

[Sysname-acl-adv-3000] quit

[Sysname] rip 1

[Sysname-rip-1] filter-policy 3000 import

host-route

Syntax

host-route

undo host-route

View

RIP view

Default level

2: System level

Parameters

None

Description

Use host-route to enable host route reception.

Use undo host-route to disable host route reception.

By default, receiving host routes is enabled.

In some cases, a router might receive many host routes from the same network segment. These routes are not helpful for routing and occupy a large amount of network resources. You can use the undo host-route command to disable receiving of host routes.

RIPv2 can be disabled from receiving host routes, but RIPv1 cannot.

Examples

# Disable RIP from receiving host routes.

<Sysname> system-view

[Sysname] rip 1

[Sysname-rip-1] undo host-route

import-route (RIP view)

Syntax

import-route protocol [ process-id | all-processes | allow-ibgp ] [ cost cost | route-policy route-policy-name | tag tag ] *

undo import-route protocol [ process-id | all-processes ]

View

RIP view

Default level

2: System level

Parameters

protocol: Specifies a routing protocol from which to redistribute routes. At present, it can be bgp, direct, isis, ospf, rip, or static.

process-id: Specifies a process ID in the range of 1 to 65535. The default is 1. It is available only when the protocol is isis, rip, or ospf.

all-processes: Enables route redistribution from all the processes of a protocol. This keyword takes effect only when the protocol is rip, ospf, or isis.

allow-ibgp: Allows redistribution of IBGP routes. This keyword is available when the protocol argument is set to bgp.

cost: Specifies a cost for redistributed routes, in the range of 0 to 16. If cost is not specified, the default cost specified by the default cost command applies.

tag: Specifies a tag marking redistributed routes, in the range of 0 to 65535. The default is 0.

route-policy-name: Specifies a routing policy by its name, a case-sensitive string of 1 to 63 characters.

Description

Use import-route to enable route redistribution from another routing protocol.

Use undo import-route to disable route redistribution.

By default, RIP does not redistribute routes from other routing protocols.

Related commands: default cost.

The import-route bgp command only redistributes EBGP routes, while the import-route bgp allow-ibgp command additionally redistributes IBGP routes, which might cause routing loops. Be cautious when using it.

Only active routes can be redistributed. You can use the display ip routing-table protocol command to display route state information.

The undo import-route protocol all-processes command removes only the configuration made by the import-route protocol all-processes command, instead of the configuration made by the import-route protocol process-id command.

Examples

# Redistribute static routes, and set the cost to 4.

<Sysname> system-view

[Sysname] rip 1

[Sysname-rip-1] import-route static cost 4

# Configure the default cost for redistributed routes as 3.

[Sysname-rip-1] default cost 3

# Redistribute OSPF routes with the cost being the default cost.

[Sysname-rip-1] import-route ospf

maximum load-balancing (RIP view)

Syntax

maximum load-balancing number

undo maximum load-balancing

View

RIP view

Default level

2: System level

Parameters

number: Specifies the maximum number of ECMP routes, in the range of 1 to 32.

Description

Use maximum load-balancing to specify the maximum number of equal-cost multi-path (ECMP) routes for load balancing.

Use undo maximum load-balancing to restore the default.

By default, the maximum number of ECMP routes is 32.

Examples

# Specify the maximum number of ECMP routes as 2.

<Sysname> system-view

[Sysname] rip

[Sysname-rip-1] maximum load-balancing 2

network

Syntax

network network-address

undo network network-address

View

RIP view

Default level

2: System level

Parameters

network-address: Specifies the IP address of a network segment, which can be the IP network address of any interface.

Description

Use network to enable RIP on the interface attached to the specified network.

Use undo network to disable RIP on the interface attached to the specified network.

By default, RIP is disabled on an interface.

RIP runs only on the interfaces attached to the specified network. For an interface not on the specified network, RIP neither receives/sends routes nor forwards interface route on it. Therefore, you need to specify the network after enabling RIP to validate RIP on a specific interface.

For a single process, you can use the network 0.0.0.0 command to enable RIP on all interfaces, while the command is not applicable in case of multi-process.

If a physical interface is attached to multiple networks, you cannot advertise these networks in different RIP processes.

Examples

# Enable RIP on the interface attached to the network 129.102.0.0.

<Sysname> system-view

[Sysname] rip 100

[Sysname-rip-100] network 129.102.0.0

output-delay

Syntax

output-delay time count count

undo output-delay

View

RIP view

Default level

2: System level

Parameters

time: Specifies the RIP packet sending interval in the range of 10 to 100 milliseconds.

count: Specifies the maximum number of RIP packets sent at each interval. The value range is 1 to 20.

Description

Use output-delay to configure the maximum RIP packets that can be sent at the specified interval for all interfaces under the RIP process.

Use undo output-delay to restore the default.

By default, an interface sends up to three RIP packets every 20 milliseconds.

Examples

# Configure all the interfaces under RIP process 1 to send up to 10 RIP packets every 30 milliseconds.

<Sysname> system-view

[Sysname] rip 1

[Sysname-rip-1] output-delay 30 count 10

peer

Syntax

peer ip-address

undo peer ip-address

View

RIP view

Default level

2: System level

Parameters

ip-address: Specifies the IP address of a RIP neighbor, in dotted decimal notation.

Description

Use peer to specify the IP address of a neighbor in the non-broadcast multi-access (NBMA) network, where routing updates destined for the peer are unicast, rather than multicast or broadcast.

Use undo peer to remove the IP address of a neighbor.

By default, no neighbor is specified.

Note that you need not use the peer ip-address command when the neighbor is directly connected; otherwise the neighbor might receive both the unicast and multicast (or broadcast) of the same routing information.

Examples

# Specify to send unicast updates to peer 202.38.165.1.

<Sysname> system-view

[Sysname] rip 1

[Sysname-rip-1] peer 202.38.165.1

preference

Syntax

preference [ route-policy route-policy-name ] value

undo preference [ route-policy ]

View

RIP view

Default level

2: System level

Parameters

route-policy-name: Specifies a routing policy by its name, a case-sensitive string of 1 to 19 characters.

value: Specifies a priority for RIP route, in the range of 1 to 255. The smaller the value, the higher the priority.

Description

Use preference to specify the RIP route priority.

Use undo preference route-policy to restore the default.

By default, the priority of a RIP route is 100.

You can specify a routing policy using the keyword route-policy to set the specified priority to routes matching the routing policy.

· If a priority is set for matched routes in the routing policy, the priority applies to these routes. The priority of other routes is the one set by the preference command.

· If no priority is set for matched routes in the routing policy, the priority of all routes is the one set by the preference command.

Examples

# Set the RIP route priority to 120.

<Sysname> system-view

[Sysname] rip 1

[Sysname-rip-1] preference 120

reset rip process

Syntax

reset rip process-id process

View

User view

Default level

2: System level

Parameters

process-id: Specifies a RIP process by its ID in the range of 1 to 65535.

Description

Use reset rip process to reset the specified RIP process.

After executing the command, you are prompted whether you want to reset the RIP process.

Examples

# Reset RIP process 100.

<Sysname> reset rip 100 process

Warning : Reset RIP process? [Y/N]:Y

reset rip statistics

Syntax

reset rip process-id statistics

View

User view

Default level

1: Monitor level

Parameters

process-id: Specifies a RIP process by its ID in the range of 1 to 65535.

Description

Use reset rip statistics to clear the statistics of the specified RIP process. This command can be used to clear the statistics of debugging.

Examples

# Clear statistics in RIP process 100.

<Sysname> reset rip 100 statistics

rip

Syntax

rip [ process-id ] [ vpn-instance vpn-instance-name ]

undo rip [ process-id ] [ vpn-instance vpn-instance-name ]

View

System view

Default level

2: System level

Parameters

process-id: Specifies a RIP process by its ID in the range of 1 to 65535. The default is 1.

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN. vpn-instance-name is a case-sensitive string of 1 to 31 characters. If no VPN is specified, the RIP process will run under the public network.

Description

Use rip to create a RIP process and enter RIP view.

Use undo rip to disable a RIP process.

By default, no RIP process runs.

If no VPN instance is specified, the RIP process will run under public network instance.

You must create a VPN instance before you apply a RIP process to it. For related configuration, see the ip vpn-instance command in MPLS Command Reference.

You must enable the RIP process before configuring the global parameters. This limitation is not for configuration of interface parameters.

The configured interface parameters become invalid after you disable the RIP process.

Examples

# Create a RIP process and enter RIP process view.

<Sysname> system-view

[Sysname] rip

[Sysname-rip-1]

rip authentication-mode

Syntax

rip authentication-mode { md5 { rfc2082 [ cipher ] key-string key-id | rfc2453 [ cipher ] key-string } | simple [ cipher ] password }

undo rip authentication-mode

View

Interface view

Default level

2: System level

Parameters

md5: Specifies the MD5 authentication mode.

rfc2082: Uses the message format defined in RFC 2082.

cipher: Sets a ciphertext authentication key or password. If this keyword is not specified, you set a plaintext authentication key or password.

key-string: Specifies the MD5 key string. This argument is case sensitive. It must be a plaintext string of 1 to 16 characters, or a ciphertext string of 33 to 53 characters.

key-id: Specifies an MD5 key number in the range of 1 to 255.

rfc2453: Uses the message format defined in RFC 2453 (IETF standard).

simple: Specifies the simple authentication mode.

password: Sets the password in simple authentication mode. This argument is case sensitive. It must be a plaintext string of 1 to 16 characters, or a ciphertext string of 33 to 53 characters.

Description

Use rip authentication-mode to configure RIPv2 authentication mode and parameters.

Use undo rip authentication-mode to cancel authentication.

A newly configured key string or password overwrites the old one, if any.

For security purposes, all keys or passwords, including keys or passwords configured in plain text, are saved in cipher text.

Related commands: rip version.

Examples

# Configure MD5 authentication on VLAN-interface 10, and specify a plaintext key rose in the format defined in RFC 2453.

<Sysname> system-view

[Sysname] interface vlan-interface 10

[Sysname-Vlan-interface10] rip version 2

[Sysname-Vlan-interface10] rip authentication-mode md5 rfc2453 rose

rip bfd enable

Syntax

rip bfd enable

undo rip bfd enable

View

Interface view

Default level

2: System level

Parameters

None

Description

Use rip bfd enable to enable BFD on the RIP interface.

Use undo rip bfd enable to restore the default and delete the relevant BFD session.

By default, a RIP interface is not enabled with BFD.

BFD echo-mode detection only works for a RIP neighbor one hop away.

Using the undo peer command does not delete the neighbor relationship at once and therefore cannot bring down the BFD session at once.

Examples

# Enable BFD on RIP interface VLAN-interface 11.

<Sysname> system-view

[Sysname] interface vlan-interface 11

[Sysname-Vlan-interface11] rip bfd enable

rip default-route

Syntax

rip default-route { { only | originate } [ cost cost ] | no-originate }

undo rip default-route

View

Interface view

Default level

2: System level

Parameters

only: Advertises only a default route.

originate: Advertises a default route and other routes.

cost: Specifies a cost for the default route, in the range of 1 to 15. The default is 1.

no-originate: Advertises routes other than a default route.

Description

Use rip default-route to configure the RIP interface to advertise a default route with the specified metric.

Use undo rip default-route to disable the RIP interface from sending a default route.

By default, a RIP interface can advertise a default route if the RIP process is configured with default route advertisement.

A RIP router configured to advertise a default route will not receive any default routes from RIP neighbors.

Related commands: default-route.

Examples

# Configure VLAN-interface 10 to advertise only a default route with a metric of 2.

<Sysname> system-view

[Sysname] interface vlan-interface 10

[Sysname-Vlan-interface10] rip default-route only cost 2

rip input

Syntax

rip input

undo rip input

View

Interface view

Default level

2: System level

Parameters

None

Description

Use rip input to enable the interface to receive RIP messages.

Use undo rip input to disable the interface from receiving RIP messages.

By default, an interface is enabled to receive RIP messages.

Related commands: rip output.

Examples

# Disable VLAN-interface 10 from receiving RIP messages.

<Sysname> system-view

[Sysname] interface vlan-interface 10

[Sysname-Vlan-interface10] undo rip input

rip metricin

Syntax

rip metricin [ route-policy route-policy-name ] value

undo rip metricin

View

Interface view

Default level

2: System level

Parameters

route-policy route-policy-name: Specifies the name of a routing policy used to add an additional metric for the routes matching it. The name is a string of 1 to 63 case-sensitive characters.

value: Adds an additional metric to received routes, in the range of 0 to 16.

Description

Use rip metricin to configure the interface to add a metric to the routes it receives.

Use undo rip metricin to restore the default.

By default, the additional metric of a received route is 0.

When a valid RIP route is received, the system adds a metric to it and then installs it into the routing table. Therefore, the metric of the route received on the configured interface is increased. If the sum of the additional metric and the original metric is greater than 16, the metric of the route will be 16.

If a routing policy is referenced with the route-policy keyword:

· Routes matching the policy is added with the metric specified in the apply cost command configured in the policy, while routes not matching it is added with the metric specified in the rip metricout command. Note that, the rip metricout command does not support the + or – keyword (used to add or reduce a metric) specified in the apply cost command. For more information about the apply cost command, see "Routing policy configuration commands."

· If the apply cost command is not configured in the policy, all the advertised routes is added with the metric specified in the rip metricout command.

Related commands: rip metricout.

Examples

# Configure VLAN-interface 10 to add a metric of 6 for incoming route 1.0.0.0/8 and to add a metric of 2 for other incoming routes.

<Sysname> system-view

[Sysname] ip ip-prefix 123 permit 1.0.0.0 8

[Sysname] route-policy abc permit node 0

[Sysname-route-policy] if-match ip-prefix 123

[Sysname-route-policy] apply cost 6

[Sysname] interface vlan-interface 10

[Sysname-Vlan-interface10] rip metricin route-policy abc 2

rip metricout

Syntax

rip metricout [ route-policy route-policy-name ] value

undo rip metricout

View

Interface view

Parameters

route-policy route-policy-name: Specifies the name of a routing policy used to add an additional metric for the routes matching it. The name is a string of 1 to 63 case-sensitive characters.

value: Adds an additional metric to sent routes, in the range of 1 to 16.

Description

Use rip metricout to add a metric to sent routes.

Use undo rip metricout to restore the default.

By default, the additional metric for sent routes is 1.

With the command configured on an interface, the metric of RIP routes sent on the interface will be increased.

If a routing policy is referenced with the route-policy keyword:

· If the apply cost command is not configured in the policy, all the advertised routes is added with the metric specified in the rip metricout command.

Related commands: rip metricin.

Examples

# Configure VLAN-interface 10 to add a metric of 6 for the outgoing route 1.0.0.0/8 and to add a metric of 2 for other outgoing routes.

<Sysname> system-view

[Sysname] ip ip-prefix 123 permit 1.0.0.0 8

[Sysname] route-policy abc permit node 0

[Sysname-route-policy] if-match ip-prefix 123

[Sysname-route-policy] apply cost 6

[Sysname] interface vlan-interface 10

[Sysname-Vlan-interface10] rip metricout route-policy abc 2

rip mib-binding

Syntax

rip mib-binding process-id

undo rip mib-binding

View

System view

Default level

2: System level

Parameters

process-id: Specifies a RIP process by its ID in the range of 1 to 65535.

Description

Use rip mib-binding to bind MIB operations with a specified RIP process, so that the RIP process can receive SNMP requests.

Use undo rip mib-binding to restore the default.

By default, MIB operations are bound to the RIP process 1, that is, RIP process 1 is enabled to receive SNMP requests.

Examples

# Configure RIP 100 to accept SNMP requests.

<Sysname> system-view

[Sysname] rip mib-binding 100

# Restore the default.

[Sysname] undo rip mib-binding

rip output

Syntax

rip output

undo rip output

View

Interface view

Default level

2: System level

Parameters

None

Description

Use rip output to enable the interface to send RIP messages.

Use undo rip output to disable the interface from sending RIP messages.

By default, Sending RIP messages is enabled on an interface.

Related commands: rip input.

Examples

# Disable VLAN-interface 10 from receiving RIP messages.

<Sysname> system-view

[Sysname] interface vlan-interface 10

[Sysname-Vlan-interface10] undo rip output

rip poison-reverse

Syntax

rip poison-reverse

undo rip poison-reverse

View

Interface view

Default level

2: System level

Parameters

None

Description

Use rip poison-reverse to enable the poison reverse function.

Use undo rip poison-reverse to disable the poison reverse function.

By default, the poison reverse function is disabled.

Examples

# Enable the poison reverse function for RIP routing updates on VLAN-interface 10.

<Sysname> system-view

[Sysname] interface vlan-interface 10

[Sysname-Vlan-interface10] rip poison-reverse

rip split-horizon

Syntax

rip split-horizon

undo rip split-horizon

View

Interface view

Default level

2: System level

Parameters

None

Description

Use rip split-horizon to enable the split horizon function.

Use undo rip split-horizon to disable the split horizon function.

By default, the split horizon function is enabled.

The split horizon function is necessary for preventing routing loops. To disable it in special cases, make sure it is necessary.

Only the poison reverse function takes effect if both the split horizon and poison reverse functions are enabled.

Examples

# Enable the split horizon function on VLAN-interface 10.

<Sysname> system-view

[Sysname] interface vlan-interface 10

[Sysname-Vlan-interface10] rip split-horizon

rip summary-address

Syntax

rip summary-address ip-address { mask | mask-length }

undo rip summary-address ip-address { mask | mask-length }

View

Interface view

Default level

2: System level

Parameters

ip-address: Specifies the destination IP address of summary route.

mask: Specifies the subnet mask of summary route, in dotted decimal notation.

mask-length: Specifies the subnet mask length of summary route, in the range of 0 to 32.

Description

Use rip summary-address to configure RIPv2 to advertise a summary route through the interface.

Use undo rip summary-address to remove the configuration.

The summary address is valid only when the automatic summarization is disabled.

Related commands: summary.

Examples

# Advertise a local summary address on VLAN-interface 10.

<Sysname> system-view

[Sysname] interface vlan-interface 10

[Sysname-Vlan-interface10] rip summary-address 10.0.0.0 255.255.255.0

rip version

Syntax

rip version { 1 | 2 [ broadcast | multicast ] }

undo rip version

View

Interface view

Default level

2: System level

Parameters

1: Specifies the RIP version as RIPv1.

2: Specifies the RIP version as RIPv2.

broadcast: Sends RIPv2 messages in broadcast mode.

multicast: Sends RIPv2 messages in multicast mode.

Description

Use rip version to specify a RIP version for the interface.

Use undo rip version to remove the specified RIP version.

By default, no RIP version is configured for an interface, which uses the global RIP version. If the global RIP version is not configured, the interface can only send RIPv1 broadcasts and can receive RIPv1 broadcasts and unicasts, and RIPv2 broadcasts, multicasts, and unicasts.

If RIPv2 is specified with no sending mode configured, RIPv2 messages will be sent in multicast mode.

When RIPv1 runs on an interface, the interface can perform the following operations:

· Sends RIPv1 broadcast messages

· Receives RIPv1 broadcast and unicast messages

When RIPv2 runs on the interface in broadcast mode, the interface can perform the following operations:

· Sends RIPv2 broadcast messages.

· Receives RIPv1 broadcast and unicast messages, and RIPv2 broadcast, multicast, and unicast messages.

When RIPv2 runs on the interface in multicast mode, the interface can perform the following operations:

· Sends RIPv2 multicast messages.

· Receives RIPv2 broadcast, multicast, and unicast messages.

Examples

# Configure VLAN-interface 10 to broadcast RIPv2 messages.

<Sysname> system-view

[Sysname] interface vlan-interface 10

[Sysname-Vlan-interface10] rip version 2 broadcast

silent-interface (RIP view)

Syntax

silent-interface { interface-type interface-number | all }

undo silent-interface { interface-type interface-number | all }

View

RIP view

Default level

2: System level

Parameters

interface-type interface-number: Specifies an interface by its type and number.

all: Silents all interfaces.

Description

Use silent-interface to disable an interface or all interfaces from sending routing updates. That is, the interface only receives but does not send RIP messages.

Use undo silent-interface to restore the default.

By default, all interfaces are allowed to send routing updates.

Examples

# Configure all VLAN interfaces to operate in silent mode, and activate VLAN-interface 10.

<Sysname> system-view

[Sysname] rip 100

[Sysname-rip-100] silent-interface all

[Sysname-rip-100] undo silent-interface vlan-interface 10

[Sysname-rip-100] network 131.108.0.0

summary

Syntax

summary

undo summary

View

RIP view

Default level

2: System level

Parameters

None

Description

Use summary to enable automatic RIPv2 summarization. Natural masks are used to advertise summary routes so as to reduce the size of routing tables.

Use undo summary to disable automatic RIPv2 summarization so that all subnet routes can be broadcast.

By default, automatic RIPv2 summarization is enabled.

Enabling automatic RIPv2 summarization can reduce the size of the routing table to enhance the scalability and efficiency of large networks.

Related commands: rip version.

Examples

# Disable RIPv2 automatic summarization.

<Sysname> system-view

[Sysname] rip

[Sysname-rip-1] undo summary

timers

Syntax

timers { garbage-collect garbage-collect-value | suppress suppress-value | timeout timeout-value | update update-value }*

undo timers { garbage-collect | suppress | timeout | update } *

View

RIP view

Default level

2: System level

Parameters

garbage-collect-value: Specifies the garbage-collect timer time in seconds, in the range of 1 to 3600.

suppress-value: Specifies the suppress timer time in seconds, in the range of 0 to 3600.

timeout-value: Specifies the timeout timer time in seconds, in the range of 1 to 3600.

update-value: Specifies the update timer time in seconds, in the range of 1 to 3600.

Description

Use timers to configure RIP timers. By adjusting RIP timers, you can improve network performance.

Use undo timers to restore the default.

By default, the garbage-collect timer is 120 seconds, the suppress timer 120 seconds, the timeout timer 180 seconds, and the update timer 30 seconds.

RIP is controlled by the above four timers.

· Update timer—Defines the interval between routing updates.

· Timeout timer—defines the route aging time. If no routing update related to a route is received after the aging time, the metric of the route is set to 16 in the routing table.

· Suppress timer—Defines how long a RIP route stays in suppressed state. When the metric of a route is 16, the route enters the suppressed state. In suppressed state, only routes that come from the same neighbor and whose metric is less than 16 will be received by the router to replace unreachable routes.

· Garbage-collect timer—Defines the interval from when the metric of a route becomes 16 to when it is deleted from the routing table. During the Garbage-Collect timer length, RIP advertises the route with the routing metric set to 16. If no routing update is announced for that route after the Garbage-Collect timer expires, the route will be deleted from the routing table.

IMPORTANT:

· H3C recommends not changing the default values of these timers.

· The time lengths of these timers must be kept consistent on all routers in the network.

Examples

# Specifies the update, timeout, suppress, and garbage-collect timers as 5, 15, 15 and 30.

<Sysname> system-view

[Sysname] rip 100

[Sysname-rip-100] timers update 5 timeout 15 suppress 15 garbage-collect 30

trip retransmit count

Syntax

trip retransmit count retransmit-count-value

undo trip retransmit count

View

RIP view

Default level

2: System level

Parameters

retransmit-count-value: Specifies the upper limit for retransmitting an Update Request or Update Response, in the range of 1 to 3600.

Description

Use trip retransmit count to configure the upper limit for retransmitting an Update Request or Update Response.

Use undo validate-source-address to restore the default.

The default upper limit is 36.

Examples

# Configure an upper limit of 20 for retransmitting an Update Request or Update Response.

<Sysname> system-view

[Sysname] rip 100

[Sysname-rip-100] trip retransmit count 20

trip retransmit timer

Syntax

trip retransmit timer retransmit-time-value

undo trip retransmit timer

View

RIP view

Default level

2: System level

Parameters

retransmit-time-value: Specifies the interval in seconds for retransmitting an Update Request or Update Response, in the range of 1 to 3600.

Description

Use trip retransmit timer to configure the interval for retransmitting an Update Request or Update Response.

Use undo validate-source-address to restore the default.

The default interval is 5 seconds.

For two routers on an analog dial-up link, the difference between retransmission intervals on the two ends must be greater than 50 seconds; otherwise, they cannot become TRIP neighbors.

Examples

# Configure an interval of 80 seconds for retransmitting an Update Request or Update Response.

<Sysname> system-view

[Sysname] rip 100

[Sysname-rip-100] trip retransmit timer 80

validate-source-address

Syntax

validate-source-address

undo validate-source-address

View

RIP view

Default level

2: System level

Parameters

None

Description

Use validate-source-address to enable the source IP address validation on incoming RIP routing updates.

Use undo validate-source-address to disable the source IP address validation.

By default, the source IP address validation is enabled.

H3C recommends not disabling the validation in normal cases.

Examples

# Disable source IP address validation on incoming RIP routing updates.

<Sysname> system-view

[Sysname-rip] rip 100

[Sysname-rip-100] undo validate-source-address

version

Syntax

version { 1 | 2 }

undo version

View

RIP view

Default level

2: System level

Parameters

1: Specifies the RIP version as RIPv1.

2: Specifies the RIP version as RIPv2. RIPv2 messages are multicast.

Description

Use version to specify a global RIP version.

Use undo version to remove the configured global RIP version.

By default, if an interface has a RIP version specified, the RIP version takes effect; if it has no RIP version specified, it can send RIPv1 broadcasts, and receive RIPv1 broadcasts and unicasts, and RIPv2 broadcasts, RIPv2 multicasts, and RIPv2 unicasts.

If an interface has an RIP version specified, the RIP version takes precedence over the global RIP version.

If no RIP version is specified for the interface and the global version is RIPv1, the interface inherits RIPv1, and it can send RIPv1 broadcasts, and receive RIPv1 broadcasts and unicasts.

If no RIP version is specified for the interface and the global version is RIPv2, the interface operates in the RIPv2 multicast mode, and it can send RIPv2 multicasts, and receive RIPv2 broadcasts, multicasts, and unicasts.

Examples

# Specify RIPv2 as the global RIP version.

<Sysname> system-view

[Sysname] rip 100

[Sysname-rip-100] version 2

07-Layer 3 - IP Routing Command Reference

default cost (RIP view)

filter-policy export (RIP view)

filter-policy import (RIP view)

host-route

import-route (RIP view)

maximum load-balancing (RIP view)

reset rip process

rip bfd enable

rip metricin

rip metricout

rip output

rip version

silent-interface (RIP view)

summary

Intelligent Terminal Products

Product Support Services

Technical Service Solutions

Resource Center

Policy

Online Help

Become a Partner

Partner Policy & Program

Global Learning

Partner Sales Resources

Service Business

News & Events

Contact Us