]>
Commit | Line | Data |
---|---|---|
4d916382 DS |
1 | * SAFETY MEASURES: |
2 | ================== | |
3 | ||
4 | Please consider setting this package "on hold" by typing | |
d8e4c438 | 5 | echo "frr hold" | dpkg --set-selections |
4d916382 DS |
6 | and verifying this using |
7 | dpkg --get-selections | grep 'hold$' | |
8 | ||
9 | Setting a package "on hold" means that it will not automatically be upgraded. | |
10 | Instead apt-get only displays a warning saying that a new version would be | |
d8e4c438 | 11 | available forcing you to explicitly type "apt-get install frr" to upgrade it. |
4d916382 DS |
12 | |
13 | ||
d8e4c438 | 14 | * What is frr? |
4d916382 DS |
15 | ================= |
16 | ||
d6180888 | 17 | http://www.frrouting.org/ |
63a79ae1 MW |
18 | FRR is a routing software suite, providing implementations of OSPFv2, |
19 | OSPFv3, RIP v1 and v2, RIPng, ISIS, PIM, BGP and LDP for Unix platforms, particularly | |
20 | FreeBSD and Linux and also NetBSD, to mention a few. FRR is a fork of Quagga | |
21 | which itself is a fork of Zebra. | |
22 | Zebra was developed by Kunihiro Ishiguro. | |
4d916382 DS |
23 | |
24 | ||
b3c4c164 DL |
25 | * Build Profiles used in the upstream debian/ |
26 | ============================================= | |
3b2a8d25 DL |
27 | |
28 | The following Build Profiles have been added: | |
29 | ||
600db12a | 30 | - pkg.frr.nortrlib (pkg.frr.rtrlib) |
3b2a8d25 DL |
31 | controls whether the RPKI module is built. |
32 | Will be enabled by default at some point, adds some extra dependencies. | |
33 | ||
3b2a8d25 DL |
34 | Note that all options have a "no" form; if you want to have your decision |
35 | be sticky regardless of changes to what it defaults to, then always use one | |
36 | of the two. For example, all occurrences of <pkg.frr.rtrlib> will at some | |
37 | point be replaced with <!pkg.frr.nortrlib>. | |
38 | ||
39 | The main frr package has the exact same contents regardless of rtrlib or snmp | |
40 | choices. The options only control frr-snmp and frr-rpki-rtrlib packages. | |
41 | ||
3b2a8d25 | 42 | |
5d2f5756 DL |
43 | * Debian Policy compliance notes |
44 | ================================ | |
45 | ||
46 | - 4.15 Reproducibility | |
47 | FRR build is reproducible as outlined in version 4.2.1 of the Policy, but | |
48 | won't be reproducible when the build directory is varied. This is because | |
49 | configure parameters are burned into the executables which includes CFLAGS | |
50 | like -fdebug-prefix-map=/build/directory/... | |
51 | ||
52 | ||
4d916382 DS |
53 | * Daemon selection: |
54 | =================== | |
55 | ||
d8e4c438 | 56 | The Debian package uses /etc/frr/daemons to tell the |
4d916382 DS |
57 | initscript which daemons to start. It's in the format |
58 | <daemon>=<yes|no|priority> | |
59 | with no spaces (it's simply source-d into the initscript). | |
60 | Default is not to start anything, since it can hose your | |
61 | system's routing table if not set up properly. | |
62 | ||
63 | Priorities were suggested by Dancer <dancer@zeor.simegen.com>. | |
63a79ae1 | 64 | They're used to start the FRR daemons in more than one step |
4d916382 | 65 | (for example start one or two at network initialization and the |
63a79ae1 | 66 | rest later). The number of FRR daemons being small, priorities |
4d916382 | 67 | must be between 1 and 9, inclusive (or the initscript has to be |
d8e4c438 | 68 | changed). /etc/init.d/frr then can be started as |
4d916382 | 69 | |
d8e4c438 | 70 | /etc/init.d/frr <start|stop|restart|<priority>> |
4d916382 DS |
71 | |
72 | where priority 0 is the same as 'stop', priority 10 or 'start' | |
73 | means 'start all' | |
74 | ||
75 | ||
76 | * Error message "privs_init: initial cap_set_proc failed": | |
77 | ========================================================== | |
78 | ||
79 | This error message means that "capability support" has to be built | |
80 | into the kernel. | |
81 | ||
82 | ||
83 | * Error message "netlink-listen: overrun: No buffer space available": | |
84 | ===================================================================== | |
85 | ||
86 | If this message occurs the receive buffer should be increased by adding the | |
9c830772 | 87 | following to /etc/sysctl.conf and "--nl-bufsize" to /etc/frr/daemons. |
4d916382 DS |
88 | > net.core.rmem_default = 262144 |
89 | > net.core.rmem_max = 262144 | |
63a79ae1 | 90 | See message #4525 from 2005-05-09 in the quagga-users mailing list. |
4d916382 DS |
91 | |
92 | ||
93 | * vtysh immediately exists: | |
94 | =========================== | |
95 | ||
d8e4c438 | 96 | Check /etc/pam.d/frr, it probably denies access to your user. The passwords |
685e701e | 97 | configured in /etc/frr/frr.conf are only for telnet access. |
4d916382 | 98 | |
9201c39f OS |
99 | |
100 | -- Ondřej Surý <Ondřej Surý <ondrej@debian.org>>, Fri, 3 Jul 2020 12:39:42 +0200 |