mirror of
https://github.com/vyos/vyos-documentation.git
synced 2025-10-26 08:41:46 +01:00
rip: add all commands and their explanations
This commit is contained in:
Leonid Voronkin
GitHub
parent
3f2b73f244
commit
ed39728bdf
@ -1,5 +1,3 @@
|
||||
.. include:: /_include/need_improvement.txt
|
||||
|
||||
.. _rip:
|
||||
|
||||
###
|
||||
@ -15,8 +13,228 @@ topology. In each update, the distance to any given network will be broadcast
|
||||
to its neighboring router.
|
||||
|
||||
Supported versions of RIP are:
|
||||
* RIPv1 as described in :rfc:`1058`
|
||||
* RIPv2 as described in :rfc:`2453`
|
||||
|
||||
- RIPv1 as described in :rfc:`1058`
|
||||
- RIPv2 as described in :rfc:`2453`
|
||||
|
||||
General Configuration
|
||||
---------------------
|
||||
|
||||
.. cfgcmd:: set protocols rip network <A.B.C.D/M>
|
||||
|
||||
This command enables RIP and sets the RIP enable interface by NETWORK.
|
||||
The interfaces which have addresses matching with NETWORK are enabled.
|
||||
|
||||
.. cfgcmd:: set protocols rip interface <interface>
|
||||
|
||||
This command specifies a RIP enabled interface by interface name. Both
|
||||
the sending and receiving of RIP packets will be enabled on the port
|
||||
specified in this command.
|
||||
|
||||
.. cfgcmd:: set protocols rip neighbor <A.B.C.D>
|
||||
|
||||
This command specifies a RIP neighbor. When a neighbor doesn’t understand
|
||||
multicast, this command is used to specify neighbors. In some cases, not
|
||||
all routers will be able to understand multicasting, where packets are
|
||||
sent to a network or a group of addresses. In a situation where a neighbor
|
||||
cannot process multicast packets, it is necessary to establish a direct
|
||||
link between routers.
|
||||
|
||||
.. cfgcmd:: set protocols rip passive-interface interface <interface>
|
||||
|
||||
This command sets the specified interface to passive mode. On passive mode
|
||||
interface, all receiving packets are processed as normal and VyOS does not
|
||||
send either multicast or unicast RIP packets except to RIP neighbors
|
||||
specified with neighbor command.
|
||||
|
||||
.. cfgcmd:: set protocols rip passive-interface interface default
|
||||
|
||||
This command specifies all interfaces to passive mode.
|
||||
|
||||
|
||||
Optional Configuration
|
||||
----------------------
|
||||
|
||||
.. cfgcmd:: set protocols rip default-distance <distance>
|
||||
|
||||
This command change distance value of RIP. The distance range is 1 to 255.
|
||||
|
||||
.. note:: Routes with a distance of 255 are effectively disabled and not
|
||||
installed into the kernel.
|
||||
|
||||
.. cfgcmd:: set protocols rip network-distance <A.B.C.D/M> distance <distance>
|
||||
|
||||
This command sets default RIP distance to specified value when the route’s
|
||||
source IP address matches the specified prefix.
|
||||
|
||||
.. cfgcmd:: set protocols rip network-distance <A.B.C.D/M> access-list <name>
|
||||
|
||||
This command can be used with previous command to sets default RIP distance
|
||||
to specified value when the route’s source IP address matches the specified
|
||||
prefix and the specified access-list.
|
||||
|
||||
.. cfgcmd:: set protocols rip default-information originate
|
||||
|
||||
This command generate a default route into the RIP.
|
||||
|
||||
.. cfgcmd:: set protocols rip distribute-list access-list <in|out> <number>
|
||||
|
||||
This command can be used to filter the RIP path using access lists.
|
||||
:cfgcmd:`in` and :cfgcmd:`out` this is the direction in which the access
|
||||
lists are applied.
|
||||
|
||||
.. cfgcmd:: set protocols rip distribute-list interface <interface> access-list <in|out> <number>
|
||||
|
||||
This command allows you apply access lists to a chosen interface to
|
||||
filter the RIP path.
|
||||
|
||||
.. cfgcmd:: set protocols rip distribute-list prefix-list <in|out> <name>
|
||||
|
||||
This command can be used to filter the RIP path using prefix lists.
|
||||
:cfgcmd:`in` and :cfgcmd:`out` this is the direction in which the prefix
|
||||
lists are applied.
|
||||
|
||||
.. cfgcmd:: set protocols rip distribute-list interface <interface> prefix-list <in|out> <name>
|
||||
|
||||
This command allows you apply prefix lists to a chosen interface to
|
||||
filter the RIP path.
|
||||
|
||||
.. cfgcmd:: set protocols rip route <A.B.C.D/M>
|
||||
|
||||
This command is specific to FRR and VyOS. The route command makes a static
|
||||
route only inside RIP. This command should be used only by advanced users
|
||||
who are particularly knowledgeable about the RIP protocol. In most cases,
|
||||
we recommend creating a static route in VyOS and redistributing it in RIP
|
||||
using :cfgcmd:`redistribute static.
|
||||
|
||||
.. cfgcmd:: set protocols rip timers update <seconds>
|
||||
|
||||
This command specifies the update timer. Every update timer seconds, the
|
||||
RIP process is awakened to send an unsolicited response message containing
|
||||
the complete routing table to all neighboring RIP routers. The time range
|
||||
is 5 to 2147483647. The default value is 30 seconds.
|
||||
|
||||
.. cfgcmd:: set protocols rip timers timeout <seconds>
|
||||
|
||||
This command specifies the timeout timer. Upon expiration of the timeout,
|
||||
the route is no longer valid; however, it is retained in the routing table
|
||||
for a short time so that neighbors can be notified that the route has been
|
||||
dropped. The time range is 5 to 2147483647. The default value is 180
|
||||
seconds.
|
||||
|
||||
.. cfgcmd:: set protocols rip timers garbage-collection <seconds>
|
||||
|
||||
This command specifies the garbage-collection timer. Upon expiration of
|
||||
the garbage-collection timer, the route is finally removed from the
|
||||
routing table. The time range is 5 to 2147483647. The default value is 120
|
||||
seconds.
|
||||
|
||||
|
||||
Redistribution Configuration
|
||||
----------------------------
|
||||
|
||||
.. cfgcmd:: set protocols rip redistribute <route source>
|
||||
|
||||
This command redistributes routing information from the given route source
|
||||
into the RIP tables. There are five modes available for route source: bgp,
|
||||
connected, kernel, ospf, static.
|
||||
|
||||
.. cfgcmd:: set protocols rip redistribute <route source> metric <metric>
|
||||
|
||||
This command specifies metric for redistributed routes from the given route
|
||||
source. There are five modes available for route source: bgp, connected,
|
||||
kernel, ospf, static. The metric range is 1 to 16.
|
||||
|
||||
.. cfgcmd:: set protocols rip redistribute <route source> route-map <name>
|
||||
|
||||
This command allows to use route map to filter redistributed routes from
|
||||
the given route source. There are five modes available for route source:
|
||||
bgp, connected, kernel, ospf, static.
|
||||
|
||||
.. cfgcmd:: set protocols rip default-metric <metric>
|
||||
|
||||
This command modifies the default metric (hop count) value for redistributed
|
||||
routes. The metric range is 1 to 16. The default value is 1. This command
|
||||
does not affect connected route even if it is redistributed by
|
||||
:cfgcmd:`redistribute connected`. To modify connected route’s metric
|
||||
value, please use :cfgcmd:`redistribute connected metric`.
|
||||
|
||||
|
||||
Interfaces Configuration
|
||||
------------------------
|
||||
|
||||
.. cfgcmd:: set interfaces <inttype> <intname> ip rip authentication plaintext-password <text>
|
||||
|
||||
This command sets the interface with RIP simple password authentication.
|
||||
This command also sets authentication string. The string must be shorter
|
||||
than 16 characters.
|
||||
|
||||
.. cfgcmd:: set interfaces <inttype> <intname> ip rip authentication md5 <id> password <text>
|
||||
|
||||
This command sets the interface with RIP MD5 authentication. This command
|
||||
also sets MD5 Key. The key must be shorter than 16 characters.
|
||||
|
||||
.. cfgcmd:: set interfaces <inttype> <intname> ip rip split-horizon disable
|
||||
|
||||
This command disables split-horizon on the interface. By default, VyOS does
|
||||
not advertise RIP routes out the interface over which they were learned
|
||||
(split horizon).
|
||||
|
||||
.. cfgcmd:: set interfaces <inttype> <intname> ip rip split-horizon poison-reverse
|
||||
|
||||
This command enables poison-reverse on the interface. If both poison reverse
|
||||
and split horizon are enabled, then VyOS advertises the learned routes
|
||||
as unreachable over the interface on which the route was learned.
|
||||
|
||||
|
||||
Operational Mode Commands
|
||||
-------------------------
|
||||
|
||||
.. opcmd:: show ip rip
|
||||
|
||||
This command displays RIP routes.
|
||||
|
||||
.. code-block:: none
|
||||
|
||||
Codes: R - RIP, C - connected, S - Static, O - OSPF, B - BGP
|
||||
Sub-codes:
|
||||
(n) - normal, (s) - static, (d) - default, (r) - redistribute,
|
||||
(i) - interface
|
||||
|
||||
Network Next Hop Metric From Tag Time
|
||||
C(i) 10.0.12.0/24 0.0.0.0 1 self 0
|
||||
C(i) 10.0.13.0/24 0.0.0.0 1 self 0
|
||||
R(n) 10.0.23.0/24 10.0.12.2 2 10.0.12.2 0 02:53
|
||||
|
||||
.. opcmd:: show ip rip status
|
||||
|
||||
The command displays current RIP status. It includes RIP timer, filtering,
|
||||
version, RIP enabled interface and RIP peer information.
|
||||
|
||||
.. code-block:: none
|
||||
|
||||
Routing Protocol is "rip"
|
||||
Sending updates every 30 seconds with +/-50%, next due in 11 seconds
|
||||
Timeout after 180 seconds, garbage collect after 120 seconds
|
||||
Outgoing update filter list for all interface is not set
|
||||
Incoming update filter list for all interface is not set
|
||||
Default redistribution metric is 1
|
||||
Redistributing:
|
||||
Default version control: send version 2, receive any version
|
||||
Interface Send Recv Key-chain
|
||||
eth0 2 1 2
|
||||
eth2 2 1 2
|
||||
Routing for Networks:
|
||||
10.0.12.0/24
|
||||
eth0
|
||||
Routing Information Sources:
|
||||
Gateway BadPackets BadRoutes Distance Last Update
|
||||
10.0.12.2 0 0 120 00:00:11
|
||||
Distance: (default is 120)
|
||||
|
||||
|
||||
Configuration Example
|
||||
---------------------
|
||||
|
||||
Simple RIP configuration using 2 nodes and redistributing connected interfaces.
|
||||
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user