]>
Commit | Line | Data |
---|---|---|
4d916382 DS |
1 | * SAFETY MEASURES: |
2 | ================== | |
3 | ||
4 | Please consider setting this package "on hold" by typing | |
5 | echo "quagga hold" | dpkg --set-selections | |
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 | |
11 | available forcing you to explicitly type "apt-get install quagga" to upgrade it. | |
12 | ||
13 | ||
14 | * What is quagga? | |
15 | ================= | |
16 | ||
17 | http://www.quagga.net/ | |
18 | > Quagga is a routing software suite, providing implementations of OSPFv2, | |
19 | > OSPFv3, RIP v1 and v2, RIPv3 and BGPv4 for Unix platforms, particularly | |
20 | > FreeBSD and Linux and also NetBSD, to mention a few. Quagga is a fork of GNU | |
21 | > Zebra which was developed by Kunihiro Ishiguro. Development of GNU Zebra | |
22 | > slowed dramatically to the point where eventually GNU Zebra was forked into | |
23 | > Quagga. | |
24 | ||
25 | > The Quagga tree is an attempt to provide a zebra tree with at least the | |
26 | > bug-fixes, which have accumulated, applied, while tracking any significant | |
27 | > changes made to the zebra.org tree. Ultimately, this tree hopes to revitalise | |
28 | > development of this code base. | |
29 | ||
30 | I packaged zebra-pj which was then renamed to quagga to get people used to it | |
31 | and offer Debian users the choice which versions they like to use. I hope this | |
32 | brings quagga some feedback and helps it evolving to a good successor of the | |
33 | orphaned zebra. | |
34 | ||
35 | -- Christian Hammers <ch@debian.org>, Jul/Aug 2003 | |
36 | ||
37 | ||
38 | * Why has SNMP support been disabled? | |
39 | ===================================== | |
40 | Quagga used to link against the NetSNMP libraries to provide SNMP | |
41 | support. Those libraries sadly link against the OpenSSL libraries | |
42 | to provide crypto support for SNMPv3 among others. | |
43 | OpenSSL now is not compatible with the GNU GENERAL PUBLIC LICENSE (GPL) | |
44 | licence that Quagga is distributed under. For more explanation read: | |
45 | http://www.gnome.org/~markmc/openssl-and-the-gpl.html | |
46 | http://www.gnu.org/licenses/gpl-faq.html#GPLIncompatibleLibs | |
47 | Updating the licence to explecitly allow linking against OpenSSL | |
48 | would requite the affirmation of all people that ever contributed | |
49 | a significant part to Zebra or Quagga and thus are the collective | |
50 | "copyright holder". That's too much work. Using a shrinked down | |
51 | version of NetSNMP without OpenSSL or convincing the NetSNMP people | |
52 | to change to GnuTLS are maybe good solutions but not reachable | |
53 | during the last days before the Sarge release :-( | |
54 | ||
55 | *BUT* | |
56 | ||
57 | It is allowed by the used licence mix that you fetch the sources and | |
58 | build Quagga yourself with SNMP with | |
59 | <remove the "grep ^smux" block at the end of debian/quagga.preinst> | |
60 | # export WANT_SNMP=1 | |
61 | # apt-get -b source quagga | |
62 | Just distributing it in binary form, linked against OpenSSL, is forbidden. | |
63 | ||
64 | ||
65 | * Daemon selection: | |
66 | =================== | |
67 | ||
68 | The Debian package uses /etc/quagga/daemons to tell the | |
69 | initscript which daemons to start. It's in the format | |
70 | <daemon>=<yes|no|priority> | |
71 | with no spaces (it's simply source-d into the initscript). | |
72 | Default is not to start anything, since it can hose your | |
73 | system's routing table if not set up properly. | |
74 | ||
75 | Priorities were suggested by Dancer <dancer@zeor.simegen.com>. | |
76 | They're used to start the Quagga daemons in more than one step | |
77 | (for example start one or two at network initialization and the | |
78 | rest later). The number of Quagga daemons being small, priorities | |
79 | must be between 1 and 9, inclusive (or the initscript has to be | |
80 | changed). /etc/init.d/quagga then can be started as | |
81 | ||
82 | /etc/init.d/quagga <start|stop|restart|<priority>> | |
83 | ||
84 | where priority 0 is the same as 'stop', priority 10 or 'start' | |
85 | means 'start all' | |
86 | ||
87 | ||
88 | * Error message "privs_init: initial cap_set_proc failed": | |
89 | ========================================================== | |
90 | ||
91 | This error message means that "capability support" has to be built | |
92 | into the kernel. | |
93 | ||
94 | ||
95 | * Error message "netlink-listen: overrun: No buffer space available": | |
96 | ===================================================================== | |
97 | ||
98 | If this message occurs the receive buffer should be increased by adding the | |
99 | following to /etc/sysctl.conf and "--nl-bufsize" to /etc/quagga/debian.conf. | |
100 | > net.core.rmem_default = 262144 | |
101 | > net.core.rmem_max = 262144 | |
102 | See message #4525 from 2005-05-09 in the quagga-users mailing list. | |
103 | ||
104 | ||
105 | * vtysh immediately exists: | |
106 | =========================== | |
107 | ||
108 | Check /etc/pam.d/quagga, it probably denies access to your user. The passwords | |
109 | configured in /etc/quagga/Quagga.conf are only for telnet access. | |
110 |