Annotation of embedaddon/quagga/doc/install.texi, revision 1.1.1.3
1.1 misho 1: @node Installation
2: @chapter Installation
3:
4: @cindex How to install Quagga
5: @cindex Installation
6: @cindex Installing Quagga
7: @cindex Building the system
8: @cindex Making Quagga
9:
10: There are three steps for installing the software: configuration,
11: compilation, and installation.
12:
13: @menu
14: * Configure the Software::
15: * Build the Software::
16: * Install the Software::
17: @end menu
18:
19: The easiest way to get Quagga running is to issue the following
20: commands:
21:
22: @example
23: % configure
24: % make
25: % make install
26: @end example
27:
28: @node Configure the Software
29: @section Configure the Software
30:
31: @menu
32: * The Configure script and its options::
33: * Least-Privilege support::
34: * Linux notes::
35: @end menu
36:
37: @node The Configure script and its options
38: @subsection The Configure script and its options
39:
40: @cindex Configuration options
41: @cindex Options for configuring
42: @cindex Build options
43: @cindex Distribution configuration
44: @cindex Options to @code{./configure}
45:
46: Quagga has an excellent configure script which automatically detects most
47: host configurations. There are several additional configure options you can
48: use to turn off IPv6 support, to disable the compilation of specific
49: daemons, and to enable SNMP support.
50:
51: @table @option
52: @item --disable-ipv6
53: Turn off IPv6 related features and daemons. Quagga configure script
54: automatically detects IPv6 stack. But sometimes you might want to
55: disable IPv6 support of Quagga.
56: @item --disable-zebra
57: Do not build zebra daemon.
58: @item --disable-ripd
59: Do not build ripd.
60: @item --disable-ripngd
61: Do not build ripngd.
62: @item --disable-ospfd
63: Do not build ospfd.
64: @item --disable-ospf6d
65: Do not build ospf6d.
66: @item --disable-bgpd
67: Do not build bgpd.
68: @item --disable-bgp-announce
69: Make @command{bgpd} which does not make bgp announcements at all. This
70: feature is good for using @command{bgpd} as a BGP announcement listener.
71: @item --enable-netlink
72: Force to enable @sc{gnu}/Linux netlink interface. Quagga configure
73: script detects netlink interface by checking a header file. When the header
74: file does not match to the current running kernel, configure script will
75: not turn on netlink support.
76: @item --enable-snmp
77: Enable SNMP support. By default, SNMP support is disabled.
1.1.1.2 misho 78: @item --disable-opaque-lsa
79: Disable support for Opaque LSAs (RFC2370) in ospfd.
1.1 misho 80: @item --disable-ospfapi
81: Disable support for OSPF-API, an API to interface directly with ospfd.
82: OSPF-API is enabled if --enable-opaque-lsa is set.
83: @item --disable-ospfclient
84: Disable building of the example OSPF-API client.
1.1.1.2 misho 85: @item --disable-ospf-te
86: Disable support for OSPF Traffic Engineering Extension (internet-draft) this
1.1 misho 87: requires support for Opaque LSAs.
88: @item --enable-multipath=@var{ARG}
89: Enable support for Equal Cost Multipath. @var{ARG} is the maximum number
90: of ECMP paths to allow, set to 0 to allow unlimited number of paths.
1.1.1.2 misho 91: @item --disable-rtadv
92: Disable support IPV6 router advertisement in zebra.
1.1.1.3 ! misho 93: @item --enable-gcc-rdynamic
! 94: Pass the @command{-rdynamic} option to the linker driver. This is in most
! 95: cases neccessary for getting usable backtraces. This option defaults to on
! 96: if the compiler is detected as gcc, but giving an explicit enable/disable is
! 97: suggested.
! 98: @item --enable-backtrace
! 99: Controls backtrace support for the crash handlers. This is autodetected by
! 100: default. Using the switch will enforce the requested behaviour, failing with
! 101: an error if support is requested but not available. On BSD systems, this
! 102: needs libexecinfo, while on glibc support for this is part of libc itself.
1.1 misho 103: @end table
104:
105: You may specify any combination of the above options to the configure
106: script. By default, the executables are placed in @file{/usr/local/sbin}
107: and the configuration files in @file{/usr/local/etc}. The @file{/usr/local/}
108: installation prefix and other directories may be changed using the following
109: options to the configuration script.
110:
111: @table @option
112: @item --prefix=@var{prefix}
113: Install architecture-independent files in @var{prefix} [/usr/local].
114: @item --sysconfdir=@var{dir}
115: Look for configuration files in @var{dir} [@var{prefix}/etc]. Note
116: that sample configuration files will be installed here.
117: @item --localstatedir=@var{dir}
118: Configure zebra to use @var{dir} for local state files, such
119: as pid files and unix sockets.
120: @end table
121:
122: @example
123: % ./configure --disable-ipv6
124: @end example
125:
126: This command will configure zebra and the routing daemons.
127:
128: @node Least-Privilege support
129: @subsection Least-Privilege support
130:
131: @cindex Quagga Least-Privileges
132: @cindex Quagga Privileges
133:
134: Additionally, you may configure zebra to drop its elevated privileges
135: shortly after startup and switch to another user. The configure script will
136: automatically try to configure this support. There are three configure
137: options to control the behaviour of Quagga daemons.
138:
139: @table @option
140: @item --enable-user=@var{user}
141: Switch to user @var{ARG} shortly after startup, and run as user @var{ARG}
142: in normal operation.
143: @item --enable-group=@var{group}
144: Switch real and effective group to @var{group} shortly after
145: startup.
146: @item --enable-vty-group=@var{group}
147: Create Unix Vty sockets (for use with vtysh) with group owndership set to
148: @var{group}. This allows one to create a seperate group which is
149: restricted to accessing only the Vty sockets, hence allowing one to
150: delegate this group to individual users, or to run vtysh setgid to
151: this group.
152: @end table
153:
154: The default user and group which will be configured is 'quagga' if no user
155: or group is specified. Note that this user or group requires write access to
156: the local state directory (see --localstatedir) and requires at least read
157: access, and write access if you wish to allow daemons to write out their
158: configuration, to the configuration directory (see --sysconfdir).
159:
160: On systems which have the 'libcap' capabilities manipulation library
161: (currently only linux), the quagga system will retain only minimal
162: capabilities required, further it will only raise these capabilities for
163: brief periods. On systems without libcap, quagga will run as the user
164: specified and only raise its uid back to uid 0 for brief periods.
165:
166: @node Linux notes
167: @subsection Linux Notes
168:
169: @cindex Configuring Quagga
170: @cindex Building on Linux boxes
171: @cindex Linux configurations
172:
173: There are several options available only to @sc{gnu}/Linux systems:
174: @footnote{@sc{gnu}/Linux has very flexible kernel configuration features}. If
175: you use @sc{gnu}/Linux, make sure that the current kernel configuration is
176: what you want. Quagga will run with any kernel configuration but some
177: recommendations do exist.
178:
179: @table @var
180:
181: @item CONFIG_NETLINK
182: Kernel/User netlink socket. This is a brand new feature which enables an
183: advanced interface between the Linux kernel and zebra (@pxref{Kernel Interface}).
184:
185: @item CONFIG_RTNETLINK
186: Routing messages.
187: This makes it possible to receive netlink routing messages. If you
188: specify this option, @command{zebra} can detect routing information
189: updates directly from the kernel (@pxref{Kernel Interface}).
190:
191: @item CONFIG_IP_MULTICAST
192: IP: multicasting.
193: This option should be specified when you use @command{ripd} (@pxref{RIP}) or
194: @command{ospfd} (@pxref{OSPFv2}) because these protocols use multicast.
195:
196: @end table
197:
198: IPv6 support has been added in @sc{gnu}/Linux kernel version 2.2. If you
199: try to use the Quagga IPv6 feature on a @sc{gnu}/Linux kernel, please
200: make sure the following libraries have been installed. Please note that
201: these libraries will not be needed when you uses @sc{gnu} C library 2.1
202: or upper.
203:
204: @table @code
205:
206: @item inet6-apps
207: The @code{inet6-apps} package includes basic IPv6 related libraries such
208: as @code{inet_ntop} and @code{inet_pton}. Some basic IPv6 programs such
209: as @command{ping}, @command{ftp}, and @command{inetd} are also
210: included. The @code{inet-apps} can be found at
211: @uref{ftp://ftp.inner.net/pub/ipv6/}.
212:
213: @item net-tools
214: The @code{net-tools} package provides an IPv6 enabled interface and
215: routing utility. It contains @command{ifconfig}, @command{route},
216: @command{netstat}, and other tools. @code{net-tools} may be found at
217: @uref{http://www.tazenda.demon.co.uk/phil/net-tools/}.
218:
219: @end table
220: @c A - end of footnote
221:
222: @node Build the Software
223: @section Build the Software
224:
225: After configuring the software, you will need to compile it for your
226: system. Simply issue the command @command{make} in the root of the source
227: directory and the software will be compiled. If you have *any* problems
228: at this stage, be certain to send a bug report @xref{Bug Reports}.
229:
230: @example
231: % ./configure
232: .
233: .
234: .
235: ./configure output
236: .
237: .
238: .
239: % make
240: @end example
241: @c A - End of node, Building the Software
242:
243:
244: @node Install the Software
245: @comment node-name, next, previous, up
246: @section Install the Software
247:
248: Installing the software to your system consists of copying the compiled
249: programs and supporting files to a standard location. After the
250: installation process has completed, these files have been copied
251: from your work directory to @file{/usr/local/bin}, and @file{/usr/local/etc}.
252:
253: To install the Quagga suite, issue the following command at your shell
254: prompt: @command{make install}.
255:
256: @example
257: %
258: % make install
259: %
260: @end example
261:
262: Quagga daemons have their own terminal interface or VTY. After
263: installation, you have to setup each beast's port number to connect to
264: them. Please add the following entries to @file{/etc/services}.
265:
266: @example
267: zebrasrv 2600/tcp # zebra service
268: zebra 2601/tcp # zebra vty
269: ripd 2602/tcp # RIPd vty
270: ripngd 2603/tcp # RIPngd vty
271: ospfd 2604/tcp # OSPFd vty
272: bgpd 2605/tcp # BGPd vty
273: ospf6d 2606/tcp # OSPF6d vty
274: ospfapi 2607/tcp # ospfapi
275: isisd 2608/tcp # ISISd vty
1.1.1.3 ! misho 276: pimd 2611/tcp # PIMd vty
1.1 misho 277: @end example
278:
279: If you use a FreeBSD newer than 2.2.8, the above entries are already
280: added to @file{/etc/services} so there is no need to add it. If you
281: specify a port number when starting the daemon, these entries may not be
282: needed.
283:
284: You may need to make changes to the config files in
285: @file{@value{INSTALL_PREFIX_ETC}/*.conf}. @xref{Config Commands}.
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>