]>
Commit | Line | Data |
---|---|---|
0efdf0fe | 1 | .. _eigrp: |
42fc5d26 QY |
2 | |
3 | ***** | |
4 | EIGRP | |
5 | ***** | |
6 | ||
7 | EIGRP -- Routing Information Protocol is widely deployed interior gateway | |
a90cfb7f | 8 | routing protocol. EIGRP was developed in the 1990's. EIGRP is a |
dfab2669 | 9 | :term:`distance-vector` protocol and is based on the :term:`dual` algorithms. |
42fc5d26 QY |
10 | As a distance-vector protocol, the EIGRP router send updates to its |
11 | neighbors as networks change, thus allowing the convergence to a | |
12 | known topology. | |
13 | ||
14 | *eigrpd* supports EIGRP as described in RFC7868 | |
15 | ||
0efdf0fe | 16 | .. _starting-and-stopping-eigrpd: |
42fc5d26 QY |
17 | |
18 | Starting and Stopping eigrpd | |
19 | ============================ | |
20 | ||
c1a54c05 QY |
21 | The default configuration file name of *eigrpd*'s is :file:`eigrpd.conf`. When |
22 | invocation *eigrpd* searches directory |INSTALL_PREFIX_ETC|. If | |
23 | :file:`eigrpd.conf` is not there next search current directory. If an | |
24 | integrated config is specified configuration is written into :file:`frr.conf`. | |
42fc5d26 | 25 | |
c1a54c05 QY |
26 | The EIGRP protocol requires interface information maintained by *zebra* daemon. |
27 | So running *zebra* is mandatory to run *eigrpd*. Thus minimum sequence for | |
28 | running EIGRP is: | |
42fc5d26 QY |
29 | |
30 | :: | |
31 | ||
42fc5d26 QY |
32 | # zebra -d |
33 | # eigrpd -d | |
dfab2669 | 34 | |
42fc5d26 QY |
35 | |
36 | Please note that *zebra* must be invoked before *eigrpd*. | |
37 | ||
c1a54c05 QY |
38 | To stop *eigrpd*, please use :: |
39 | kill `cat /var/run/eigrpd.pid` | |
40 | ||
41 | Certain signals have special meanings to *eigrpd*. | |
42fc5d26 | 42 | |
a90cfb7f QY |
43 | +------------------+-----------------------------------------------------------+ |
44 | | Signal | Meaning | | |
45 | +==================+===========================================================+ | |
46 | | SIGHUP & SIGUSR1 | Rotate the log file | | |
47 | +------------------+-----------------------------------------------------------+ | |
48 | | SIGINT & SIGTERM | Sweep all installed EIGRP routes and gracefully terminate | | |
49 | +------------------+-----------------------------------------------------------+ | |
42fc5d26 QY |
50 | |
51 | ||
a90cfb7f | 52 | *eigrpd* invocation options. Common options that can be specified |
0efdf0fe | 53 | (:ref:`common-invocation-options`). |
42fc5d26 | 54 | |
a90cfb7f | 55 | .. program:: eigrpd |
42fc5d26 | 56 | |
a90cfb7f QY |
57 | .. option:: -r |
58 | .. option:: --retain | |
42fc5d26 | 59 | |
a90cfb7f | 60 | When the program terminates, retain routes added by *eigrpd*. |
42fc5d26 | 61 | |
0efdf0fe | 62 | .. _eigrp-configuration: |
42fc5d26 QY |
63 | |
64 | EIGRP Configuration | |
65 | =================== | |
66 | ||
a90cfb7f | 67 | .. index:: router eigrp (1-65535) |
29adcd50 | 68 | .. clicmd:: router eigrp (1-65535) |
c1a54c05 | 69 | |
a90cfb7f QY |
70 | The `router eigrp` command is necessary to enable EIGRP. To disable EIGRP, |
71 | use the `no router eigrp (1-65535)` command. EIGRP must be enabled before | |
72 | carrying out any of the EIGRP commands. | |
42fc5d26 | 73 | |
a90cfb7f | 74 | .. index:: no router eigrp (1-65535) |
29adcd50 | 75 | .. clicmd:: no router eigrp (1-65535) |
c1a54c05 | 76 | |
a90cfb7f | 77 | Disable EIGRP. |
42fc5d26 | 78 | |
a90cfb7f | 79 | .. index:: network NETWORK |
29adcd50 | 80 | .. clicmd:: network NETWORK |
42fc5d26 | 81 | |
c1a54c05 | 82 | .. index:: no network NETWORK |
29adcd50 | 83 | .. clicmd:: no network NETWORK |
c1a54c05 | 84 | |
a90cfb7f QY |
85 | Set the EIGRP enable interface by `network`. The interfaces which |
86 | have addresses matching with `network` are enabled. | |
42fc5d26 | 87 | |
a90cfb7f QY |
88 | This group of commands either enables or disables EIGRP interfaces between |
89 | certain numbers of a specified network address. For example, if the | |
90 | network for 10.0.0.0/24 is EIGRP enabled, this would result in all the | |
91 | addresses from 10.0.0.0 to 10.0.0.255 being enabled for EIGRP. The `no | |
92 | network` command will disable EIGRP for the specified network. | |
42fc5d26 | 93 | |
a90cfb7f QY |
94 | Below is very simple EIGRP configuration. Interface `eth0` and |
95 | interface which address match to `10.0.0.0/8` are EIGRP enabled. | |
42fc5d26 | 96 | |
c1a54c05 | 97 | :: |
dfab2669 | 98 | |
c1a54c05 QY |
99 | ! |
100 | router eigrp 1 | |
101 | network 10.0.0.0/8 | |
102 | ! | |
42fc5d26 | 103 | |
42fc5d26 | 104 | |
a90cfb7f | 105 | .. index:: passive-interface (IFNAME|default) |
29adcd50 | 106 | .. clicmd:: passive-interface (IFNAME|default) |
42fc5d26 | 107 | |
c1a54c05 | 108 | .. index:: no passive-interface IFNAME |
29adcd50 | 109 | .. clicmd:: no passive-interface IFNAME |
c1a54c05 | 110 | |
a90cfb7f | 111 | This command sets the specified interface to passive mode. On passive mode |
c1a54c05 QY |
112 | interface, all receiving packets are ignored and eigrpd does not send either |
113 | multicast or unicast EIGRP packets except to EIGRP neighbors specified with | |
114 | `neighbor` command. The interface may be specified as `default` to make | |
115 | eigrpd default to passive on all interfaces. | |
42fc5d26 | 116 | |
a90cfb7f | 117 | The default is to be passive on all interfaces. |
42fc5d26 | 118 | |
0efdf0fe | 119 | .. _how-to-announce-eigrp-route: |
42fc5d26 QY |
120 | |
121 | How to Announce EIGRP route | |
122 | =========================== | |
123 | ||
a90cfb7f | 124 | .. index:: redistribute kernel |
29adcd50 | 125 | .. clicmd:: redistribute kernel |
42fc5d26 | 126 | |
c1a54c05 | 127 | .. index:: redistribute kernel metric (1-4294967295) (0-4294967295) (0-255) (1-255) (1-65535) |
29adcd50 | 128 | .. clicmd:: redistribute kernel metric (1-4294967295) (0-4294967295) (0-255) (1-255) (1-65535) |
42fc5d26 | 129 | |
c1a54c05 | 130 | .. index:: no redistribute kernel |
29adcd50 | 131 | .. clicmd:: no redistribute kernel |
42fc5d26 | 132 | |
c1a54c05 QY |
133 | `redistribute kernel` redistributes routing information from kernel route |
134 | entries into the EIGRP tables. `no redistribute kernel` disables the routes. | |
42fc5d26 | 135 | |
c1a54c05 | 136 | .. index:: redistribute static |
29adcd50 | 137 | .. clicmd:: redistribute static |
42fc5d26 | 138 | |
c1a54c05 | 139 | .. index:: redistribute static metric (1-4294967295) (0-4294967295) (0-255) (1-255) (1-65535) |
29adcd50 | 140 | .. clicmd:: redistribute static metric (1-4294967295) (0-4294967295) (0-255) (1-255) (1-65535) |
42fc5d26 | 141 | |
c1a54c05 | 142 | .. index:: no redistribute static |
29adcd50 | 143 | .. clicmd:: no redistribute static |
42fc5d26 | 144 | |
c1a54c05 QY |
145 | `redistribute static` redistributes routing information from static route |
146 | entries into the EIGRP tables. `no redistribute static` disables the routes. | |
42fc5d26 | 147 | |
c1a54c05 | 148 | .. index:: redistribute connected |
29adcd50 | 149 | .. clicmd:: redistribute connected |
42fc5d26 | 150 | |
c1a54c05 | 151 | .. index:: redistribute connected metric (1-4294967295) (0-4294967295) (0-255) (1-255) (1-65535) |
29adcd50 | 152 | .. clicmd:: redistribute connected metric (1-4294967295) (0-4294967295) (0-255) (1-255) (1-65535) |
42fc5d26 | 153 | |
c1a54c05 | 154 | .. index:: no redistribute connected |
29adcd50 | 155 | .. clicmd:: no redistribute connected |
42fc5d26 | 156 | |
c1a54c05 QY |
157 | Redistribute connected routes into the EIGRP tables. `no redistribute |
158 | connected` disables the connected routes in the EIGRP tables. This command | |
159 | redistribute connected of the interface which EIGRP disabled. The connected | |
160 | route on EIGRP enabled interface is announced by default. | |
42fc5d26 | 161 | |
c1a54c05 | 162 | .. index:: redistribute ospf |
29adcd50 | 163 | .. clicmd:: redistribute ospf |
42fc5d26 | 164 | |
c1a54c05 | 165 | .. index:: redistribute ospf metric (1-4294967295) (0-4294967295) (0-255) (1-255) (1-65535) |
29adcd50 | 166 | .. clicmd:: redistribute ospf metric (1-4294967295) (0-4294967295) (0-255) (1-255) (1-65535) |
42fc5d26 | 167 | |
c1a54c05 | 168 | .. index:: no redistribute ospf |
29adcd50 | 169 | .. clicmd:: no redistribute ospf |
42fc5d26 | 170 | |
c1a54c05 QY |
171 | `redistribute ospf` redistributes routing information from ospf route |
172 | entries into the EIGRP tables. `no redistribute ospf` disables the routes. | |
42fc5d26 | 173 | |
c1a54c05 | 174 | .. index:: redistribute bgp |
29adcd50 | 175 | .. clicmd:: redistribute bgp |
42fc5d26 | 176 | |
c1a54c05 | 177 | .. index:: redistribute bgp metric (1-4294967295) (0-4294967295) (0-255) (1-255) (1-65535) |
29adcd50 | 178 | .. clicmd:: redistribute bgp metric (1-4294967295) (0-4294967295) (0-255) (1-255) (1-65535) |
42fc5d26 | 179 | |
c1a54c05 | 180 | .. index:: no redistribute bgp |
29adcd50 | 181 | .. clicmd:: no redistribute bgp |
c1a54c05 QY |
182 | |
183 | `redistribute bgp` redistributes routing information from bgp route entries | |
184 | into the EIGRP tables. `no redistribute bgp` disables the routes. | |
42fc5d26 | 185 | |
0efdf0fe | 186 | .. _show-eigrp-information: |
42fc5d26 QY |
187 | |
188 | Show EIGRP Information | |
189 | ====================== | |
190 | ||
a90cfb7f | 191 | .. index:: show ip eigrp topology |
29adcd50 | 192 | .. clicmd:: show ip eigrp topology |
42fc5d26 | 193 | |
013f9762 | 194 | Display current EIGRP status. |
42fc5d26 | 195 | |
c1a54c05 | 196 | :: |
42fc5d26 | 197 | |
c1a54c05 QY |
198 | eigrpd> **show ip eigrp topology** |
199 | # show ip eigrp topo | |
42fc5d26 | 200 | |
c1a54c05 | 201 | EIGRP Topology Table for AS(4)/ID(0.0.0.0) |
42fc5d26 | 202 | |
c1a54c05 QY |
203 | Codes: P - Passive, A - Active, U - Update, Q - Query, R - Reply |
204 | r - reply Status, s - sia Status | |
205 | ||
206 | P 10.0.2.0/24, 1 successors, FD is 256256, serno: 0 | |
207 | via Connected, enp0s3 | |
dfab2669 | 208 | |
42fc5d26 QY |
209 | |
210 | EIGRP Debug Commands | |
211 | ==================== | |
212 | ||
213 | Debug for EIGRP protocol. | |
214 | ||
a90cfb7f | 215 | .. index:: debug eigrp packets |
29adcd50 | 216 | .. clicmd:: debug eigrp packets |
42fc5d26 | 217 | |
c1a54c05 | 218 | Debug eigrp packets |
42fc5d26 | 219 | |
c1a54c05 | 220 | ``debug eigrp`` will show EIGRP packets that are sent and recevied. |
42fc5d26 | 221 | |
c1a54c05 | 222 | .. index:: debug eigrp transmit |
29adcd50 | 223 | .. clicmd:: debug eigrp transmit |
42fc5d26 | 224 | |
c1a54c05 | 225 | Debug eigrp transmit events |
42fc5d26 | 226 | |
c1a54c05 QY |
227 | ``debug eigrp transmit`` will display detailed information about the EIGRP |
228 | transmit events. | |
42fc5d26 | 229 | |
c1a54c05 | 230 | .. index:: show debugging eigrp |
29adcd50 | 231 | .. clicmd:: show debugging eigrp |
42fc5d26 | 232 | |
c1a54c05 QY |
233 | Display *eigrpd*'s debugging option. |
234 | ||
235 | ``show debugging eigrp`` will show all information currently set for eigrpd | |
236 | debug. | |
42fc5d26 | 237 |