Installation

There are three steps for installing the software: configuration, compilation, and installation.

Menu

Configure the Software

Build the Software

Install the Software

Menu
Configure the Software
Build the Software
Install the Software

The easiest way to get Zebra running is to issue the following commands:

    % configure
    % make
    % make install

Configure the software

Zebra has an excellent configure script, the configure script automatically detects most host configurations. There are several additional configure options you can use to turn off IPv6 support, to disable the compilation of specific daemons, and to enable SNMP support.

--enable-guile
Turn on compilation of the zebra-guile interpreter. You will need the guile library to make this. zebra-guile implementation is not yet finished. So this option is only useful for zebra-guile developer.
--disable-ipv6
Turn off IPv6 related features and daemons. Zebra configure script automatically detect IPv6 stack. But sometimes you might want to disable IPv6 support of Zebra.
--disable-zebra
Do not build zebra daemon.
--disable-ripd
Do not build ripd.
--disable-ripngd
Do not build ripngd.
--disable-ospfd
Do not build ospfd.
--disable-ospf6d
Do not build ospf6d.
--disable-bgpd
Do not build bgpd.
--disable-bgpd-announce
Make bgpd which does not make bgp announcements at all. This feature is good for using bgpd as BGP announcement listener.
--enable-netlink
Force to enable GNU/Linux netlink interface. Zebra configure script detects netlink interface by checking header file. When header file does not match to the current running kernel configure script will not turn on netlink support.
--enable-snmp
Enable SNMP support. In default, SNMP support is disabled.

You may specify any combination of the above options to the configure script. As well, you may find it useful to change the installation directory; specify the following options to the configure script.

By default, the executables are placed in `/usr/local/sbin' and the configuration files in `/usr/local/etc'. The `/usr/local/' installation prefix may be changed using options to the configuration script.

--prefix=PREFIX
Install architecture-independent files in PREFIX [/usr/local].
--sysconfdir=DIR
Read-only sample configuration file in DIR [PREFIX/etc].

     % ./configure --disable-ipv6

This command will configure zebra and the routing daemons.

There are several options available only to GNU/Linux systems:¹

Footnotes

GNU/Linux has very flexible kernel configuration features. If you use GNU/Linux, make sure that the current kernel configuration is what you want. Zebra will run with any kernel configuration but some recommendations do exist.

CONFIG_NETLINK
Kernel/User netlink socket. This is a brand new feature which enables an advanced interface between the Linux kernel and Zebra (see also Kernel Interface.).
CONFIG_RTNETLINK
Routing messages. This makes it possible to receive netlink routing messages. If you specify this option, `zebra' can detect routing information updates directly from the kernel (see also Kernel Interface.).
CONFIG_IP_MULTICAST
IP: multicasting. This option should be specified when you use ripd or ospfd because these protocols use multicast.

IPv6 supported is added from GNU/Linux kernel version 2.2. If you try to use the Zebra IPv6 feature on a GNU/Linux kernel, please make sure the below library has been installed.

inet6-apps
inet6-apps package includes basic IPv6 related libraries such as inet_ntop and inet_pton. Some basic IPv6 programs such as ping, ftp, inetd are also included. inet-apps can be found at <ftp://ftp.inner.net/pub/ipv6/>.
net-tools
net-tools provides an IPv6 enabled interface and routing utility. It contains ifconfig, route, netstat and other tools. net-tools can be found at <http://www.tazenda.demon.co.uk/phil/net-tools/>.

Build the Software

After configuring the software, you will need to compile it for your system. Simply issue the command `make' in the root of the source directory and the software will be compiled. If you have any problems at this stage, be certain to send a bug report (See also Bug Reports).

     % ./configure
     .
     .
     .
     ./configure output
     .
     .
     .
     % make

Install the Software

Installing the software to your system consists of copying the compiled programs and supporting files to a standard location. After the installation process has completed, these files will have been copied from your work directory to /usr/local/bin, and /usr/local/etc. To install the Zebra suite issue the following command at your shell prompt: make install

     %
     % make install
     %

Zebra daemon's have their own terminal interface or VTY. After installation, you have to setup each beast's port number to connect to them. Please add the following entries to /etc/services.

     zebrasrv      2600/tcp		  # zebra service
     zebra         2601/tcp		  # zebra vty
     ripd          2602/tcp		  # RIPd vty
     ripngd        2603/tcp		  # RIPngd vty
     ospfd         2604/tcp		  # OSPFd vty
     bgpd          2605/tcp		  # BGPd vty
     ospf6d        2606/tcp		  # OSPF6d vty

If you use a FreeBSD newer than 2.2.8, the above entries are already added to /etc/services so there is no need to add it. If you specify a port number when starting the daemon, these entries may not be needed.

You may need to make changes to the config files in /usr/local/etc/*.conf. (See also Config Commands)

This file documents the GNU Zebra software which manages common TCP/IP routing protocols.

This is Edition 0.1, last updated 5 July 2000 of `The GNU Zebra Manual', for Zebra Version 0.88.

Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice are preserved on all copies.

Permission is granted to copy and distribute modified versions of this manual under the conditions for verbatim copying, provided that the entire resulting derived work is distributed under the terms of a permission notice identical to this one.

Permission is granted to copy and distribute translations of this manual into another language, under the above conditions for modified versions, except that this permission notice may be stated in a translation approved by Kunihiro Ishiguro.