06-Layer 3 - IP Routing Command Reference

HomeSupportRoutersH3C SR8800 Router SeriesReference GuidesCommand ReferencesH3C SR8800 Command Reference-Release3347-6W10306-Layer 3 - IP Routing Command Reference
03-RIP Commands
Title Size Download
03-RIP Commands 199.86 KB

checkzero

Syntax

checkzero

undo checkzero

View

RIP view

Default level

2: System level

Parameters

None

Description

Use the checkzero command to enable zero field check on RIPv1 messages.

Use the undo checkzero command to disable zero field check.

The zero field check function is enabled by default.

After the zero field check is enabled, the router discards RIPv1 messages in which zero fields are non-zero. If all messages are trusty, 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: Default metric of redistributed routes, in the range of 0 to 16.

Description

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

Use the undo default cost command 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: Cost of the default route, in the range of 1 to 15. The default is 1.

Description

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

Use the undo default-route command 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: RIP process 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.

exclude: Displays all lines that do not match the specified regular expression.

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 the display rip command 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 : 8

       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 Output description

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 means only a default route is advertised.

·       originate means a default route is advertised along with other routes.

·       disable means 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: RIP process 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.

exclude: Displays all lines that do not match the specified regular expression.

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 the display rip database command to display active routes in the database of the specified RIP process, which are sent in normal 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 Output description

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 learned 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: RIP process ID, in the range of 1 to 65535.

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

|: 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.

exclude: Displays all lines that do not match the specified regular expression.

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 the display rip interface command 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: GigabitEthernet3/1/1

         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 Output description

Field

Description

Interface-name

The 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—Means it is allowed.

off—Means it is not allowed.

Default route

Indicates whether sending the default route to RIP neighbors is allowed:

on—Means it is allowed.

off—Means 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: RIP process 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.

exclude: Displays all lines that do not match the specified regular expression.

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 the display rip route command 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 GigabitEthernet 3/1/1

      Destination/Mask        Nexthop     Cost    Tag   Flags   Sec

        122.0.0.0/8          111.1.1.2      1       0    RA      22

Table 4 Output description

Field

Description

Route Flags

·       RRIP route.

·       TTRIP 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 GigabitEthernet3/1/1

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 Output description

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 the fast-reroute command to configure RIP fast reroute (FRR).

Use the undo fast-reroute command to restore the default.

By default, RIP FRR is disabled.

 

 

NOTE:

·       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 may 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 GigabitEthernet 3/1/1 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: Number of an ACL used to filter outbound routes, in the range of 2000 to 3999.

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

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

process-id: 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 the filter-policy export command to configure the filtering of RIP outgoing routes. Only routes not filtered out can be advertised.

Use the undo filter-policy export command to remove the filtering.

By default, RIP does not filter outbound routes.

If a protocol is specified, RIP filters only the 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.

 

 

NOTE:

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 and the destination keyword specifies the subnet mask of the route (the subnet mask must be valid; otherwise, the configuration is ineffective).

 

Related commands: import-route and 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 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 GigabitEthernet 3/1/1.

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

# 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: Number of the ACL used for filtering incoming routes, in the range of 2000 to 3999.

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 the filter-policy import command to configure RIP to filter the incoming routes.

Use the undo filter-policy import command to restore the default.

By default, RIP does not filter incoming routes.

 

 

NOTE:

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 and 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 incoming routes.

<Sysname> system-view

[Sysname] acl number 2000

[Sysname-acl-basic-2000] rule deny 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 1/1/2 to filter all received RIP routes.

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

# 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 the host-route command to enable host route reception.

Use the undo host-route command to disable host route reception.

By default, receiving host routes is enabled.

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

 

 

NOTE:

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 ]

View

RIP view

Default level

2: System level

Parameters

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

process-id: 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: When the protocol argument is set to bgp, allow-ibgp is an optional keyword.

cost: 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: Tag marking redistributed routes, in the range of 0 to 65,535. The default is 0.

route-policy route-policy-name: Specifies a routing policy with 1 to 63 case-sensitive characters.

Description

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

Use the undo import-route command to disable route redistribution.

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

 

 

NOTE:

·       The import-route bgp command only redistributes eBGP routes. The import-route bgp allow-ibgp command additionally redistributes iBGP routes, which may cause routing loops.

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

 

Related commands: default cost.

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: Maximum number of equal-cost routes.

Description

Use the maximum load-balancing command to specify the maximum number of equal-cost routes.

Use the undo maximum load-balancing command to restore the default.

By default, the maximum number of equal-cost routes is 8.

Examples

# Specify the maximum number of equal-cost 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: IP address of a network segment, which can be the IP network address of any interface.

Description

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

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

RIP is disabled on an interface by default.

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

For a single process, the network 0.0.0.0 command can enable RIP on all interfaces, but 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: RIP packet sending interval, in milliseconds. It is in the range 10 to 100.

count: Maximum number of RIP packets sent at each interval. It is in the range 1 to 20.

Description

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

Use the undo output-delay command 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: IP address of a RIP neighbor, in dotted decimal format.

Description

Use the peer command 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 the undo peer command to remove the IP address of a neighbor.

By default, no neighbor is specified.

You need not use the peer ip-address command when the neighbor is directly connected; otherwise the neighbor may 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: Routing policy name with 1 to 63 case-sensitive characters.

value: Preference for RIP routes, in the range of 1 to 255. The smaller the value, the higher the preference.

Description

Use the preference command to specify the preference for RIP routes.

Use the undo preference command to restore the default.

By default, the preference of RIP routes is 100.

You can specify a routing policy by using the keyword route-policy to set a preference for the matching RIP routes.

·           The preference set by the routing policy applies to all matching RIP routes. The preference of other routes is set by the preference command.

·           If no preference is set by the routing policy, the preference of all RIP routes is set by the preference command.

Examples

# Set the RIP route preference 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

1: Monitor level

Parameters

process-id: RIP process ID, in the range of 1 to 65535.

Description

Use the reset rip process command 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

2: System level

Parameters

process-id: RIP process ID, in the range of 1 to 65535.

Description

Use the reset rip statistics command to clear the statistics of the specified RIP process. This command can 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: RIP process 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 the rip command to create a RIP process and enter RIP view.

Use the undo rip command to disable a RIP process.

By default, no RIP process runs.

 

 

NOTE:

·       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 key-string key-id | rfc2453 key-string } | simple password }

undo rip authentication-mode

View

Interface view

Default level

2: System level

Parameters

md5: MD5 authentication mode.

rfc2082: Uses the message format defined in RFC 2082.

key-string: MD5 key string with 1 to 16 characters in plain text format, or 1 to 24 characters in cipher text format. When the display current-configuration command displays system information, a 24-character cipher string is displayed as the MD5 key string.

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

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

simple: Plain text authentication mode.

password: Plain text authentication string with 1 to 16 characters.

Description

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

Use the undo rip authentication-mode command to cancel authentication.

The key string you configured can overwrite the old one, if any.

Related commands: rip version.

Examples

# Configure MD5 authentication on GigabitEthernet 3/1/1 with the key string being rose in the format defined in RFC 2453.

<Sysname> system-view

[Sysname] interface GigabitEthernet 3/1/1

[Sysname-GigabitEthernet3/1/1] rip version 2

[Sysname-GigabitEthernet3/1/1] 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 the rip bfd enable command to enable BFD on the RIP interface.

Use the undo rip bfd enable command to restore the default.

Disabling BFD on a RIP interface will notify BFD to delete the relevant session.

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

 

 

NOTE:

·       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 cannot bring down the BFD session at once.

 

Examples

# Enable BFD on RIP interface GigabitEthernet 4/1/1.

<Sysname> system-view

[Sysname] interface GigabitEthernet 4/1/1

[Sysname-GigabitEthernet4/1/1] 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: Cost of the default route, in the range 1 to 15. The default is 1.

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

Description

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

Use the undo rip default-route command 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.

 

 

NOTE:

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

 

Related commands: default-route.

Examples

# Configure GigabitEthernet 3/1/1 to advertise only a default route with a metric of 2.

<Sysname> system-view

[Sysname] interface GigabitEthernet 3/1/1

[Sysname-GigabitEthernet3/1/1] 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 the rip input command to enable the interface to receive RIP messages.

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

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

Related commands: rip output.

Examples

# Enable GigabitEthernet 3/1/1 to receive RIP messages.

<Sysname> system-view

[Sysname] interface GigabitEthernet 3/1/1

[Sysname-GigabitEthernet3/1/1] 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: Additional metric added to received routes, in the range of 0 to 16.

Description

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

Use the undo rip metricin command 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. The metric of the route received on the configured interface is then 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, the following operations can be performed:

·           Routes matching the policy is added with the metric specified in the apply cost command configured in the policy. Routes not matching it is added with the metric specified in the rip metricout command. 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 the chapter “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 GigabitEthernet 3/1/1 to add a metric of 6 for the 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 GigabitEthernet 3/1/1

[Sysname-GigabitEthernet3/1/1] 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: Additional metric of sent routes, in the range of 1 to 16.

Description

Use the rip metricout command to add a metric to sent routes.

Use the undo rip metricout command 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, the following operations can be performed:

·           Routes matching the policy is added with the metric specified in the apply cost command configured in the policy. Routes not matching it is added with the metric specified in the rip metricout command. 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 the chapter “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 metricin.

Examples

# Configure GigabitEthernet 3/1/1 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 GigabitEthernet 3/1/1

[Sysname-GigabitEthernet3/1/1] 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: RIP process ID, in the range of 1 to 65535.

Description

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

Use the undo rip mib-binding command to restore the default.

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

Examples

# Enable RIP process 100 to receive 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 the rip output command to enable the interface to send RIP messages.

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

Sending RIP messages is enabled on an interface by default.

Related commands: rip input.

Examples

# Enable GigabitEthernet 2/1/1 to receive RIP messages.

<Sysname> system-view

[Sysname] interface GigabitEthernet 2/1/1

[Sysname-GigabitEthernet2/1/1] 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 the rip poison-reverse command to enable the poison reverse function.

Use the undo rip poison-reverse command 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 GigabitEthernet 2/1/1.

<Sysname> system-view

[Sysname] interface GigabitEthernet 2/1/1

[Sysname-GigabitEthernet2/1/1] 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 the rip split-horizon command to enable the split horizon function.

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

The split horizon function is enabled by default.

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

·           In Frame Relay, X.25 and other non-broadcast multi-access (NBMA) networks, split horizon should be disabled if multiple VCs are configured on the primary and secondary interfaces to ensure route advertisement. For detailed information, see Layer 2—WAN Configuration Guide.

 

 

NOTE:

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 GigabitEthernet 3/1/1.

<Sysname> system-view

[Sysname] interface GigabitEthernet 3/1/1

[Sysname-GigabitEthernet3/1/1] 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: Destination IP address of summary route.

mask: Subnet mask of summary route, in dotted decimal format.

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

Description

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

Use the undo rip summary-address command 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 GigabitEthernet 3/1/1.

<Sysname> system-view

[Sysname] interface GigabitEthernet 3/1/1

[Sysname-GigabitEthernet3/1/1] rip summary-address 10.0.0.0 255.255.255.0

rip triggered

Syntax

rip triggered

undo rip triggered

View

Interface view

Default level

2: System level

Parameters

None

Description

Use the rip triggered command to enable triggered RIP.

Use the undo rip triggered command to disable triggered RIP.

By default, the triggered RIP is disabled.

Triggered RIP can only run on link layer protocols PPP, Frame Relay, and X.25.

Examples

# Enable triggered RIP.

<Sysname> system-view

[Sysname] interface Pos 2/1/2

[Sysname-Pos2/1/2] rip triggered

rip version

Syntax

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

undo rip version

View

Interface view

Default level

2: System level

Parameters

1: RIP version 1.

2: RIP version 2.

broadcast: Sends RIPv2 messages in broadcast mode.

multicast: Sends RIPv2 messages in multicast mode.

Description

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

Use the undo rip version command 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 messages.

·           Receives RIPv1 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 messages.

·           Receives RIPv1 unicast messages.

·           Receives RIPv2 broadcast messages.

·           Receives RIPv2 multicast messages.

·           Receives RIPv2 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 messages.

·           Receives RIPv2 multicast messages.

·           Receives RIPv2 unicast messages.

Examples

# Configure GigabitEthernet 3/1/1 to broadcast RIPv2 messages.

<Sysname> system-view

[Sysname] interface GigabitEthernet 3/1/1

[Sysname-GigabitEthernet3/1/1] 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: Disables all interfaces from sending routing updates.

Description

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

Use the undo silent-interface command to restore the default.

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

Examples

# Configure all interfaces to work in the silent mode, and activate GigabitEthernet 3/1/1.

<Sysname> system-view

[Sysname] rip 100

[Sysname-rip-100] silent-interface all

[Sysname-rip-100] undo silent-interface GigabitEthernet 3/1/1

[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 the summary command to enable automatic RIPv2 summarization. Natural masks are used to advertise summary routes so as to reduce the size of routing tables.

Use the undo summary command 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: Garbage-collect timer time in seconds, in the range of 1 to 3600.

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

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

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

Description

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

Use the undo timers command to restore the default.

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

RIP is controlled by the following 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 which 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.

 

 

NOTE:

·       H3C does not recommend 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 respectively.

<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: Upper limit for retransmitting an Update Request or Update Response, in the range 1 to 3600.

Description

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

Use the undo trip retransmit count command 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: Interval in seconds for retransmitting an Update Request or Update Response, in the range 1 to 3600.

Description

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

Use the undo trip retransmit timer command 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 the validate-source-address command to enable the source IP address validation on incoming RIP routing updates.

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

The source IP address validation is enabled by default.

Typically H3C does not recommend disabling the validation.

Examples

# Disable the 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 the version command to specify a global RIP version.

Use the undo version command 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, RIPv1 unicasts, 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

  • Cloud & AI
  • InterConnect
  • Intelligent Computing
  • Security
  • SMB Products
  • Intelligent Terminal Products
  • Product Support Services
  • Technical Service Solutions
All Services
  • Resource Center
  • Policy
  • Online Help
All Support
  • Become A Partner
  • Partner Policy & Program
  • Global Learning
  • Partner Sales Resources
  • Partner Business Management
  • Service Business
All Partners
  • Profile
  • News & Events
  • Online Exhibition Center
  • Contact Us
All About Us
新华三官网