debian/README.Debian

   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
 111 * Where is the babeld.8 manpage?
 112 ================================
 113
 114 It conflicted with the one from the babeld package and was therefore be
 115 renamed to quagga-babeld.8.
 116