quagga(8)						  System Administration Commands						 quagga(8)

NAME

       quagga - advanced routing protocol suite from www.quagga.net

SYNOPSIS

       Quagga is an advanced routing software package that provides a suite of TCP/IP based routing protocols.

       Quagga  supports protocols such as RIPv1, RIPv2, RIPng, OSPFv2, OSPFv3, BGP-4, and BGP-4+. This document is provided for informational pur-
       poses to help users configure quagga under Solaris specifically. Further documentation on quagga configuration in general  is  provided	at
       http://www.quagga.net.

DESCRIPTION

       Quagga consists of the following packages:

	 o  SUNWquaggar - Quagga root files

	 o  SUNWquagga-daemons - Quagga daemons

	 o  SUNWquagga-libs - Quagga private shared libraries

	 o  SUNWquagga-dev - Quagga private shared library headers

	 o  SUNWquaggaS - Quagga sources

       More  defailed  Quagga documentation is available from http://www.quagga.net/docs, or in the GNU Info format Quagga documentation installed
       in /usr/sfw/share/info.

       The Quagga routing protocol suite replaces SUNWzebra, and detection of SUNWzebra configuration during boot will lead to automatic  transfer
       of  configuration to quagga. If manual upgrade (without reboot) is required, configuration files under /etc/sfw/zebra should be transferred
       to /etc/quagga, and "routeadm -u" should be run. This will enable the appropriate quagga services, and run the daemons  if  those  services
       dependencies are met.

       In Solaris, quagga daemons are managed by the following smf(5) services:

       svc:/network/routing/zebra:quagga  zebra routing manager daemon

       svc:/network/routing/rip:quagga	  RIPv2 routing daemon

       svc:/network/routing/ripng:quagga  RIPng routing daemon

       svc:/network/routing/bgp:quagga	  BGP routing daemon

       svc:/network/routing/ospf:quagga   OSPF routing daemon

       svc:/network/routing/ospf6:quagga  OSPF6 routing daemon

       Quagga daemons can be configured either via the smf(5) framework, or via routeadm(1M), the global dynamic routing management utility.

       Note  that  quagga  was	built  without	the  vtysh  (unified vty shell) utility, as it depends on a package not currently distributed with
       Solaris.

COMMANDS

       By default, in.routed and in.ripngd, managed by the svc:/network/routing/route and svc:/network/routing/ripng  services	respectively,  are
       configured as default IPv4/IPv6 routing services. To disable these, either utilize routeadm(1M) or svcadm(1M) as follows:

       # routeadm -d route
       # routeadm -d ripng:default

       disables in.routed and in.ripngd respectively using routeadm(1M).

       # svcadm disable route:default
       # svcadm disable ripng:default

       disables in.routed and in.ripngd respectively using smf(1).

       Note that these services must be disabled or their quagga counterparts (rip:quagga, ripng:quagga) will not run, since they services specify
       to the smf framework that they and their quagga counterparts cannot run simultaneously.

       To enable quagga services, again either routeadm(1M) or svcadm(1M) can be used.	Note that quagga services, like in.routed  and	in.ripngd,
       specify	dependencies  on  ipv4(6)-routing(forwarding)  services,  so  as with all smf(1) services, ensure the appropriate dependencies are
       enabled or the services will not start.

       For example,

       # routeadm -e rip:quagga
       # routeadm -e ipv4-routing -u

       enables quagga's RIPv2 daemon (the -u option above is required, as global ip routing/forwarding settings are  not  applied  to  the  system
       until next reboot unless the -u is issued).

       To do the same via smf(1),

       # svcadm enable -r rip:quagga

       The "-r" option recursively enables rip:quagga's dependencies, which include the ipv4-routing service.

       The  status of all routing daemon services can be displayed via routeadm(1M), run without options, or, through smf(1), via the svcs(1) com-
       mand.

       Commandline arguments to the quagga daemons can be altered by modifying the routing/daemon-args property, again either via routeadm(1M)	or
       svccfg(1M):

       # routeadm -m rip:quagga daemon-args="-s"

       or

       # svccfg -s rip:quagga setprop routing/daemon-args="-s"
       # svcadm refresh rip:quagga

       The "refresh" is required to ensure the daemon re-reads its configuration.

DIAGNOSTICS

       To see status of all routing services, run routeadm(1M) without options.

SEE ALSO

       ripngd(8), ospfd(8), ospf6d(8), bgpd(8), zebra(8), routeadm(1M), svcadm(1M), svcs(1), svccfg(1M), smf(5)

AUTHORS

       See <http://www.quagga.net>, or the Info file for an  accurate  list of authors.

SunOS 5.11							    01 Aug 2006 							 quagga(8)