![]() | Note:
Unless specified otherwise, all hierarchical RIP commands can be modified on different levels. The most specific value is used. A RIP group-specific command takes precedence over a global RIP command. A neighbor-specific command takes precedence over a global RIP or group-specific RIP command. |
This command creates a text description stored in the configuration file for a configuration context.
The no form of the command removes the description string from the context.
no description is associated with the configuration context
This command administratively disables an entity. When disabled, an entity does not change, reset, or remove any configuration settings or statistics.
The operational state of the entity is disabled as well as the operational state of any entities contained within. Many objects must be shut down before they may be deleted.
The no form of this command administratively enables an entity.
Unlike other commands and parameters where the default state is not indicated in the configuration file, the shutdown and no shutdown states are always indicated in system-generated configuration files.
Default administrative states for services and service entities are described in Special Cases.
This command creates the RIP protocol instance and RIP configuration context. RIP is administratively enabled upon creation. To start or suspend execution of the RIP protocol without affecting the configuration, use the [no] shutdown command.
The no form of the command deletes the RIP protocol instance and removes all configuration parameters for the RIP instance.
no rip
This command configures the RIPv2 authentication key.
Authentication is performed between neighboring routers before setting up the RIP session by verifying the password. Authentication is performed using the MD5 message-based digest.
The authentication key can be any combination of ASCII characters up to 255 characters long. The hash-key can be any combination of ASCII characters up to 342 characters long.
The no form of the command removes the authentication password from the configuration and disables authentication.
no authentication-key
This command sets the type of authentication to be used between RIP neighbors. Authentication type can be specified regardless of the configured send and receive parameters, but will only apply to RIPv2 packets.
The type and password must match exactly for the RIP message to be considered authentic and processed.
The no form of the command removes the authentication type from the configuration and disables authentication.
no authentication-type
This command enables checking for zero values in fields specified to be zero by the RIPv1 and RIPv2 specifications.
The check-zero enable command enables checking of the mandatory zero fields in the RIPv1 and RIPv2 specifications and rejecting of non-compliant RIP messages.
The check-zero disable command disables this check and allows the receipt of RIP messages even if the mandatory zero fields are non-zero.
The check-zero command can be enabled at all three RIP levels. The most specific value is used. If no check-zero value is set (no check-zero), the setting from the less-specific level is inherited by the lower level.
The no form of the command disables check-zero on the configuration.
disabled at the RIP global level
This command specifies the export route policy used to determine which routes are advertised to peers. Route policies are configured in the config>router>policy-options context. Refer to the section on “Route Policy” in the 7705 SAR OS Router Configuration Guide.
When multiple policy names are specified, the policies are evaluated in the order in which they are specified. A maximum of five (5) policy names can be configured. The first policy that matches is applied.
When multiple export commands are issued, the last command entered overrides the previous command.
By default, when no export policies are specified, RIP routes are advertised and non-RIP routes are not advertised.
The no form of the command removes the policy association with the RIP instance. To remove association of all policies, use the no export command without arguments.
no export
This command configures the maximum number of routes (prefixes) that can be exported into RIP from the route table. Export-limit can be configured only on the global level.
The no form of the command removes the parameters from the configuration.
no export-limit
This command creates the context for configuring a RIP group of neighbor interfaces.
RIP groups logically associate RIP neighbor interfaces to facilitate a common configuration for RIP interfaces.
The no form of the command deletes the RIP neighbor interface group. Deleting the group also removes the RIP configuration from all of the neighbor interfaces currently assigned to the group.
This command specifies the import route policy to be used to determine which routes are accepted from peers. Route policies are configured in the config>router>policy-options context. Refer to the section on “Route Policy” in the 7705 SAR OS Router Configuration Guide.
When multiple policy names are specified, the policies are evaluated in the order in which they are specified. A maximum of five (5) policy names can be specified. The first policy that matches is applied.
When multiple import commands are issued, the last command entered will override the previous command.
When an import policy is not specified, RIP routes are accepted by default.
The no form of the command removes the policy association with the RIP instance. To remove association of all policies, use no import without arguments.
no import
This command configures the maximum number of routes per RIP update message.
By default, each update can contain a maximum of 25 route advertisements. This limit is imposed by RIP specifications. RIP can be configured to send as many as 255 routes per update.
The no form of the command reverts to the default value.
25
This command configures the metric added to routes received from a RIP neighbor. The specified metric value is added to the hop count and shortens the maximum distance of the route.
When applying an export policy to a RIP configuration, the policy overrides the metric values determined through calculations involving the metric-in and metric-out values.
The no form of the command reverts to the default value.
1
This command configures the metric assigned to routes exported into RIP and advertised to RIP neighbors. The specified metric value is added to the hop count and shortens the maximum distance of the route.
When applying an export policy to a RIP configuration, the policy overrides the metric values determined through calculations involving the metric-in and metric-out values.
The no form of the command reverts to the default value.
1
This command creates the context for configuring a RIP neighbor interface.
By default, interfaces are not activated unless explicitly configured.
The no form of the command deletes the RIP interface configuration for this interface. The shutdown command in the config>router>rip>group group-name>neighbor context can be used to disable an interface without removing the configuration for the interface.
No RIP interfaces are defined by default.
If the IP interface name does not exist or does not have an IP address configured, an error message will be returned.
This command configures the route preference for routes learned from the configured peer(s).
The lower the preference, the higher the chance of the route being the active route. The 7705 SAR assigns the highest default preference to RIP routes as compared to routes that are direct, static, or learned via MPLS or OSPF.
170
This command configures the type of RIP updates that will be accepted and processed.
If you specify version-2 or both, the RIP instance listens for and accepts packets sent to the broadcast (255.255.255.255) and multicast (224.0.0.9) addresses.
If version-1 is specified, the router only listens for and accepts packets sent to the broadcast address.
The default behavior is to accept and process both RIPv1 and RIPv2 messages.
The no form of the command reverts to the default value.
both
both | specifies that RIP updates in either version 1 or version 2 format will be accepted |
none | specifies that RIP updates will not be accepted |
version-1 | specifies that RIP updates in version 1 format only will be accepted |
version-2 | specifies that RIP updates in version 2 format only will be accepted |
This command specifies the type of RIP messages sent to RIP neighbors.
If broadcast or version-1 is specified, the router only listens for and accepts packets sent to the broadcast address.
The no form of the command reverts to the default value.
broadcast
broadcast | sends RIPv2 formatted messages to the broadcast address |
multicast | sends RIPv2 formatted messages to the multicast address |
none | does not to send any RIP messages (silent listener) |
version-1 | sends RIPv1 formatted messages to the broadcast address |
This command enables the use of split-horizon.RIP uses split-horizon with poison-reverse to avoid looping routes propagating through the network. Split-horizon with poison reverse means that routes learned from a neighbor through a given interface are advertised in updates out of the same interface but with a metric of 16 (infinity).The split-horizon disable command enables split horizon without poison reverse. With split horizon enabled, the local router does not readvertise routes learned from a neighbor back to the neighbor. This configuration parameter can be set at three levels: global level (applies to all groups and neighbor interfaces), group level (applies to all neighbor interfaces in the group) or neighbor level (only applies to the specified neighbor interface). The most specific value is used. In particular if no value is set (no split-horizon), the setting from the less specific level is inherited by the lower level.The no form of the command disables split horizon.
enable
This command configures values for the update, timeout, and flush RIP timers.The RIP update timer determines how often RIP updates are sent.If the route is not updated by the time the RIP timeout timer expires, the route is declared invalid but is maintained in the RIP database.The RIP flush timer determines how long a route is maintained in the RIP database after it has been declared invalid. Once the flush timer expires, the route is removed from the RIP database.The no form of the command reverts to the default values.
This command displays the routes in the RIP database.
The following output is an example of RIP database information, and Table 64 describes the fields.
Label | Description |
Destination | The RIP destination for the route |
Peer | The router ID of the peer router |
NextHop | The IP address of the next hop |
Metric | The hop count to rate the value of different hops |
Tag | The value to distinguish between internal routes (learned by RIP) and external routes (learned from other protocols) |
TL | Displays how many seconds the specific route will remain in the routing table. When an entry reaches 0, it is removed from the routing table. |
Valid | Yes — the route is valid No — the route is not valid |
This command displays group information for a RIP peer group. This command can be entered with or without parameters.
When this command is entered without a group name, only information about all peer groups is displayed.
When the command is issued with a specific group name, information only pertaining to that specific peer group is displayed.
The Admin and Oper state fields display the RIP group’s operational state. Valid states are:
The following output is an example of RIP group and detailed RIP group information, and Table 65 describes the fields.
Label | Description |
Group | The RIP group name |
Interface | The interface name |
Adm | Indicates whether the RIP neighbor interface is administratively up or down |
Opr | Indicates whether the RIP neighbor interface is operationally up or down |
Send Mode | Bcast — specifies that RIPv2 formatted messages are sent to the broadcast addressMcast — specifies that RIPv2 formatted messages are sent to the multicast addressNone — specifies that no RIP messages are sent (silent listener)RIPv1 — specifies that RIPv1 formatted messages are sent to the broadcast address |
Recv Mode | Both — specifies that RIP updates in either version 1 or version 2 format will be acceptedNone — specifies that RIP updates will not be acceptedRIPv1 — specifies that RIP updates in version 1 format only are acceptedRIPv2 — specifies that RIP updates in version 2 format only are accepted |
Metric In | The metric added to routes received from a RIP neighbor |
This command displays RIP neighbor information. This command can be entered with or without any parameters.
When this command is issued without any parameters, information about all RIP neighbors displays.
The following outputs are examples of RIP neighbor information:
Label | Description |
Interface | The RIP neighbor name or IP address |
Adm | Indicates whether the RIP neighbor interface is administratively up or down |
Opr | Indicates whether the RIP neighbor interface is operationally up or down |
Primary IP | The primary IP address of the RIP neighbor interface |
Send Mode | Bcast — specifies that RIPv2 formatted messages are sent to the broadcast addressMcast — specifies that RIPv2 formatted messages are sent to the multicast addressNone — specifies that no RIP messages are sent (silent listener)RIPv1 — specifies that RIPv1 formatted messages are sent to the broadcast address |
Recv Mode | Both — specifies that RIP updates in either version 1 or version 2 format will be acceptedNone — specifies that RIP updates will not be acceptedRIPv1 — specifies that RIP updates in version 1 format only are acceptedRIPv2 — specifies that RIP updates in version 2 format only are accepted |
Metric In | The metric added to routes received from a RIP neighbor |
Label | Description |
Neighbor | The RIP neighbor name or IP address |
Description | The RIP neighbor description. No Description Available indicates no description is configured. |
Primary IP | The RIP neighbor interface primary IP address |
Group | The RIP group name of the neighbor interface |
Admin State | Indicates whether the RIP neighbor interface is administratively up or down |
Oper State | Indicates whether the RIP neighbor interface is operationally up or down |
Send Mode | Bcast — specifies that RIPv2 formatted messages are sent to the broadcast addressMcast — specifies that RIPv2 formatted messages are sent to the multicast addressNone — specifies that no RIP messages are sent (silent listener)RIPv1 — specifies that RIPv1 formatted messages are sent to the broadcast address |
Receive Mode | Both — specifies that RIP updates in either version 1 or version 2 format will be acceptedNone — specifies that RIP updates will not be acceptedRIPv1 — specifies that RIP updates in version 1 format only are acceptedRIPv2 — specifies that RIP updates in version 2 format only are accepted |
Metric In | The metric value added to routes received from a RIP neighbor |
Metric Out | The value added to routes exported into RIP and advertised to RIP neighbors |
Split Horizon | Indicates whether split horizon and poison reverse is Enabled or Disabled for the RIP neighbor |
Check Zero | Disabled — the mandatory zero fields in RIP packets are not checked, allowing receipt of RIP messages even if mandatory zero fields are non-zero for the neighborEnabled — mandatory zero fields in RIP packets are checked and non-compliant RIP messages are rejected |
Message Size | The maximum number of routes per RIP update message |
Preference | The preference of RIP routes from the neighbor |
Auth. Type | Specifies the authentication type |
Update Timer | The current setting of the RIP update timer value expressed in seconds |
Timeout Timer | The current RIP timeout timer value expressed in seconds |
Flush Timer | The number of seconds after a route has been declared invalid that it is flushed from the route database |
Export Policies | The export route policy that is used to determine routes advertised to all peers |
Import Policies | The import route policy that is used to determine which routes are accepted from RIP neighbors |
This command displays RIP peer information.
The following output is an example of RIP peer information, and Table 68 describes the fields.
Label | Description |
Peer IP Addr | The IP address of the peer router |
Interface Name | The peer interface name |
Version | The version of RIP running on the peer |
Last Update | The number of days since the last update |
No. of Peers | The number of RIP peers |
This command displays interface level statistics for the RIP protocol.
If no IP address or interface name is specified, then all configured RIP interfaces are displayed.
If an IP address or interface name is specified, then only data about the specified RIP interface is displayed.
The following output is an example of RIP statistics information, and Table 69 describes the fields.
Label | Description |
Learned Routes | The number of RIP learned routes that were exported to RIP neighbors |
Timed Out Routes | The number of routes that have timed out |
Current Memory | The amount of memory used by the RIP router instance |
Maximum Memory | The amount of memory allocated for the RIP router instance |
Interface | Displays the name of each interface configured in RIP and its associated RIP statistics |
Primary IP | The interface IP address |
Update Timer | The current setting of the RIP update timer value expressed in seconds |
Timeout Timer | The current RIP timeout timer value expressed in seconds |
Flush Timer | The number of seconds before a route that has been declared invalid is removed from the route database |
Total | The total number of each corresponding RIP statistic collected |
Last 5 Min | The number of each corresponding RIP statistic collected in the last 5 minutes |
Last 1 Min | The number of each corresponding RIP statistic that was collected in the last minute |
Updates Sent | The total number of RIP updates that have been sent |
Triggered Updates | The number of triggered updates that have been sent. Triggered updates are sent before the RIP routing table is sent. |
Bad Packets Received | The number of RIP updates received on this interface that were discarded as invalid |
RIPv1 Updates Received | The number of RIPv1 updates received |
RIPv1 Updates Ignored | The number of RIPv1 updates ignored |
RIPv1 Bad Routes | The number of bad RIPv1 routes received from the peer |
RIPv1 Requests Received | The number of RIPv1 requests received from other routers |
RIPv1 Requests Ignored | The number of times the router ignored a RIPv1 route request from other routers |
RIPv2 Updates Received | The number of RIPv2 updates received |
RIPv2 Updates Ignored | The number of RIPv2 updates ignored |
RIPv2 Bad Routes | The number of bad RIPv2 routes received from the peer |
RIPv2 Requests Received | The number of RIPv2 requests received from other routers |
RIPv2 Requests Ignored | The number of times the router ignored a RIPv2 route request from other routers |
Authentication Errors | The number of authentication errors that occurred while attempting to secure table updates |
This command deletes all routes in the RIP database.
This command clears RIP neighbor statistics. You can clear statistics for a specific RIP interface or for all RIP interfaces.
none
This command enables debugging for RIP authentication at either the global level or neighbor level.
This command enables debugging for RIP errors at either the global level or neighbor level.
This command enables debugging for RIP events at either the global level or neighbor level.
This command enables debugging for RIP hold-downs at either the global level or neighbor level.
This command enables debugging for RIP packets at either the global level or neighbor level.
This command enables debugging for RIP requests at either the global level or neighbor level.
This command enables debugging for RIP triggers at either the global level or neighbor level.
This command enables debugging for RIP updates at either the global level or neighbor level.