7.4. Configuring RIP with CLI

This section provides information on configuring RIP using the command line interface.

Topics in this section include:

7.5. RIP Configuration Overview

7.5.1. Preconfiguration Requirements

Before RIP can be implemented, the following entities must be configured:

  1. policy statements must be defined in the config>router>policy-options context

7.6. Basic RIP Configuration

RIP is configured in the config>router>rip context for network interfaces and IES access interfaces. RIP is configured in the config>service>vprn>rip context for VPRN interfaces when RIP is used as a PE-to-CE routing protocol for VPRN service. For information on configuring RIP under VPRN, refer to the 7705 SAR Services Guide, “Configuring RIP for VPRN”.

RIP configuration commands have three primary configuration levels: rip for global configurations, group group-name for RIP groups, and neighbor ip-int-name for RIP neighbor configurations. Within the different levels, the configuration commands are identical.

Commands and parameters configured at the global level are inherited by the group and neighbor level; however, the command that is most specific to the neighboring router takes precedence. Parameters configured at the neighbor level have precedence over group and global configurations and parameters configured at the group level have precedence over global configurations.

The minimum RIP parameters that must be configured in the config>router>rip context are:

  1. group
  2. neighbor

For a router to accept RIP updates, at least one group and one neighbor must be defined. A 7705 SAR router ignores RIP updates received from routers on interfaces not configured for RIP. Configuring other RIP commands and parameters is optional.

By default, the local router imports all routes from its neighbor and does not advertise routes. The router receives both RIPv1 and RIPv2 update messages with 25 to 255 route entries per message.

The following is an example of a basic RIP configuration.

ALU-A>config>router>rip# info
----------------------------------------------
        group "RIP-ALU-A"
               neighbor "to-ALU-4"
               exit
        exit
----------------------------------------------
ALU-A>config>router>rip#

7.7. Common Configuration Tasks

This section provides a brief overview of the tasks that must be performed to configure RIP and provides the CLI commands.

RIP is configured hierarchically; the global level applies to all peers, the group level applies to all peers in the group, and the neighbor level only applies to a specified peer. By default, group members inherit the group’s configuration parameters, although a parameter can be modified on a per-member basis without affecting the group-level parameters.

All RIP instances must be explicitly created on each 7705 SAR. Once created, RIP is administratively enabled.

To configure RIP, perform the following tasks in order:

  1. configure interfaces
  2. configure policy statements (optional)
  3. enable RIP
  4. configure group parameters
  5. configure neighbor parameters

7.7.1. Configuring Interfaces

The following command sequences create a logical IP interface. The logical interface can associate attributes such as an IP address, port, Link Aggregation Group (LAG), or the system. For more information about configuring interfaces, refer to the 7705 SAR Router Configuration Guide.

To configure a network interface:

CLI Syntax:
config>router
interface ip-int-name
address {ip-addr/mask-length | ip-addr/netmask}
allow-directed-broadcasts
port port-name
Example:
config>router# interface “to-ALU-4”
config>router>if# address 10.10.12.1/8
config>router>if# port 1/1/1
config>router>if# exit

The following example displays the configuration output:

ALU-3>config>router# info
----------------------------------------------
#echo “IP Configuration”
#------------------------------------------
    interface "system"
        address 192.0.2.0/24
    exit
    interface "to-ALU-4"
        address 10.10.12.1/8
        port 1/1/1
    exit
#------------------------------------------
ALU-3>config>router#

The following command sequences create an IES (access) interface that will be added to RIP in the config>router>rip context. For more information about IES interfaces, refer to the 7705 SAR Services Guide, “Internet Enhanced Service”.

To configure an IES interface:

CLI Syntax:
config>service
ies service-id [customer customer-id] [create] [vpn vpn-id]
interface ip-int-name [create]
address {ip-addr/mask | ip-addr/netmask}
allow-directed-broadcasts
sap sap-id [create]
Example:
config>service# ies 4 customer 1 create
config>service>ies# interface “rip_interface” create
config>service>ies>if$ address 172.16.1.1/12
config>service>ies>if$ allow-directed-broadcasts
config>service>ies>if$ sap 1/1/4 create

The following example displays the configuration output:

*A:Sar18 Dut-B>config>service>ies# info
----------------------------------------------
            interface "rip_interface" create
                address 172.16.1.1/12
                allow-directed-broadcasts
                sap 1/1/4 create
                exit
            exit
            no shutdown
----------------------------------------------
*A:Sar18 Dut-B>config>service>ies#

7.7.2. Configuring a Route Policy

The import route policy command allows you to filter routes being imported by the local router from its neighbors. If no match is found, the local router does not import any routes.

The export route policy command allows you to determine which routes are exported from the route table to RIP. By default, RIP does not export routes it has learned to its neighbors. If no export policy is specified, non-RIP routes will not be exported from the routing table manager to RIP.

If multiple policy names are specified, the policies are evaluated in the order they are specified. The first policy that matches is applied. If multiple export commands are issued, the last command entered will override the previous command. A maximum of five policy names can be specified.

To enter the mode to create or edit route policies, you must enter the begin keyword at the config>router>policy-options prompt. Other editing commands include:

  1. the commit command, saves and enables changes made to route policies during a session
  2. the abort command, discards changes that have been made to route policies during a session

Use the following CLI syntax to configure a policy to use for RIP global, group, and neighbor import and export commands. This section provides brief instructions to configure route policies. For more details and the complete list of policy options commands, refer to the 7705 SAR Router Configuration Guide, “Configuring Route Policies With CLI”.

CLI Syntax:
config>router>policy-options
begin
commit
abort
policy-statement name
description text
default-action {accept | next-entry | next-policy | reject}
entry entry-id
description text
action {accept | next-entry | next-policy | reject}
from
protocol {bgp | direct | ospf | ospf3 | rip | isis | static | aggregate | bgp-vpn | igmp | mld | pim | ldp}
to
protocol {bgp | direct | ospf | ospf3 | rip | isis | static | aggregate | bgp-vpn | igmp | mld | pim | ldp}

The following example displays commands to configure a policy statement. Use the commit command to save the changes.

Example:
config>router>policy-options# begin
policy-options# policy-statement“RIP-policy”
policy-options>policy-statement$ description "this is a
test RIP policy”
policy-options>policy-statement>default# entry 1
policy-options>policy-statement>entry$ action accept
policy-options>policy-statement>entry# exit
policy-options>policy-statement# default-action reject
policy-options>policy-statement# exit
policy-options# commit
ALU-A>config>router>policy-options# info
----------------------------------------------
    policy-statement "RIP-policy"
    description "this is a test RIP policy"
    entry 1
    action accept
    exit
    exit
    default-action reject
    exit
----------------------------------------------
ALU-A>config>router>policy-options>policy-statement#

7.8. Configuring RIP Parameters

Use the CLI syntax below to configure global-level, group-level, and neighbor-level parameters:

CLI Syntax:
config>router
rip
authentication-key {authentication-key | hash-key} [hash | hash2]
authentication-type {none | password | message-digest | message-digest-20}
check-zero {enable | disable}
description description-string
export policy-name [policy-name ...up to 5 max]
import policy-name [policy-name ...up to 5 max]
message-size max-num-of-routes
metric-in metric
metric-out metric
neighbor ip-int-name
authentication-key {authentication-key | hash-key} [hash|hash2]
authentication-type {none | password | message-digest | message-digest-20}
check-zero {enable | disable}
description description-string
export policy-name [policy-name ...up to 5 max]]
import policy-name [policy-name ...up to 5 max]]
message-size max-num-of-routes
metric-in metric
metric-out metric
preference preference
receive receive-type
send send-type
split-horizon {enable | disable}
timers update timeout flush
no shutdown
preference preference
receive receive-type
send send-type
no shutdown
split-horizon {enable|disable}
timers update timeout flush
group group-name
authentication-key {authentication-key | hash-key} [hash | hash2]
authentication-type {none | password | message-digest | message-digest-20}
check-zero {enable | disable}
description description-string
export policy-name [policy-name ...up to 5 max]]
import policy-name [policy-name ...up to 5 max]]
message-size max-num-of-routes
metric-in metric
metric-out metric
preference preference
receive receive-type
send send-type
no shutdown
split-horizon {enable | disable}
timers update timeout flush

7.8.1. Configuring Global-Level Parameters

Once the RIP protocol instance is created, it is administratively enabled automatically; the no shutdown command is not required. To enable RIP on a router, at least one group and one neighbor must be configured. There are no default groups or neighbors. Each group and neighbor must be explicitly configured.

Note:

Careful planning is essential to implement commands that can affect the behavior of global, group, and neighbor levels. Because the RIP commands are hierarchical, analyze the values that can disable features on a particular level.

The following example displays a global RIP configuration:

Example:
config>router# rip
config>router>rip# authentication-type password
config>router>rip# authentication-key test123
config>router>rip# receive both
config>router>rip# split-horizon enable
config>router>rip# timers 300 600 600
config>router>rip>group# exit
ALU-A>config>router>rip# info
----------------------------------------------
            authentication-type simple
            authentication-key "ac1865lvz1d" hash
            timers 300 600 600
----------------------------------------------

7.8.2. Configuring Group-Level Parameters

A group is a collection of related RIP peers (neighbors). The group name should be a descriptive name for the group. Follow your group, name, and ID naming conventions for consistency and to help when troubleshooting faults.

All parameters configured for a peer group are applied to the group and are inherited by each peer (neighbor), but a group parameter can be overridden on a specific neighbor-level basis.

The following example displays a group configuration:

Example:
config>router# rip
config>router>rip# group headquarters
config>router>rip>group$ description "Base HQ"
config>router>rip>group# no shutdown
ALA-A>config>router>rip# info
----------------------------------------------
            authentication-type simple
            authentication-key "ac1865lvz1d" hash
            timers 300 600 600
            group "headquarters"
                description "Base HQ"
            exit
----------------------------------------------
ALA-A>config>router>rip#

7.8.3. Configuring Neighbor-Level Parameters

After you create a group name and assign options, add neighbor interfaces within the same group. All parameters configured for the peer group level are applied to each neighbor, but a group parameter can be overridden on a specific neighbor basis.

The following example displays a neighbor configuration:

Example:
config>router# rip
config>router>rip# group headquarters
config>router>rip>group# neighbor ferguson-274
config>router>rip>group>neighbor$ preference 255
config>router>rip>group>neighbor# send both
config>router>rip>group>neighbor# split-horizon enable
config>router>rip>group>neighbor# message-size 255
ALU-A>config>router>rip>group>neighbor# info
----------------------------------------------
                    message-size 255
                    preference 255
                    split-horizon enable
                    no timers
----------------------------------------------
ALU-A>config>router>rip>group>neighbor#

7.9. RIP Configuration Management Tasks

Examples are provided for the following RIP configuration management tasks:

7.9.1. Modifying RIP Parameters

When RIP parameters are modified, added, or removed, the changes are applied immediately. For the complete list of CLI commands, refer to Configuring RIP Parameters.

CLI Syntax:
config>router# rip
group group-name
. . .
neighbor ip-int-name
. . .
Example:
config>router>rip# group "headquarters"
config>router>rip>group# neighbor "ferguson-274"
config>router>rip>group>neighbor# import RIPpolicy
config>router>rip>group>neighbor# message-size 150

The following example displays the updated parameters:

ALU-A>config>router>rip# info
----------------------------------------------
authentication-type simple
authentication-key "ac1865lvz1d" hash
timers 300 600 600
group "headquarters"
description "Mt. View"
neighbor "ferguson-274"
import "RIPpolicy"
message-size 150
preference 255
split-horizon enable
no timers
exit
exit
----------------------------------------------
ALU-A>config>router>rip#

7.9.2. Deleting a RIP Group

A RIP group must be shut down first in order to delete it.

Use the following CLI syntax to shut down and then delete a RIP group.

CLI Syntax:
config>router# rip
group group-name
shutdown
no group group-name
Example:
config>router> rip
config>router>rip# group “RIP-ALU-3”
config>router>rip>group# shutdown
config>router>rip>group# exit
config>router>rip# no group “RIP-ALU-3”

If you try to delete the group without shutting it down first, the following message appears:

INFO: RIP #1204 group should be administratively down -
virtual router index 1,group 
RIP-ALA-4

7.9.3. Deleting a RIP Neighbor

A RIP neighbor must be shut down first in order to delete it.

Use the following CLI syntax to shut down and then delete a RIP neighbor.

CLI Syntax:
config>router# rip
group group-name
neighbor ip-int-name
shutdown
exit
no neighbor ip-int-name
Example:
config>router# rip
config>router>rip# group “RIP-ALU-4”
config>router>rip>group# neighbor “to-ALU-3”
config>router>rip>group>neighbor# shutdown
config>router>rip>group>neighbor# exit
config>router>rip>group# no neighbor “to-ALU-3”

If you try to delete the neighbor before it is shut down, the following message appears:

INFO: RIP #1101 neighbor should be administratively down - virtual router index