'\" te
.\" Copyright (c) 2006, Sun Microsystems, Inc\&. All Rights Reserved
.TH quagga 8 "01 Aug 2006" "SunOS 5.11" "System Administration Commands"
.SH "NAME"
quagga - advanced routing protocol suite from www.quagga.net
.SH "SYNOPSIS"
.PP
\fBQuagga\fR is an advanced routing software package that provides a suite of
TCP/IP based routing protocols.
.PP
\fBQuagga\fR supports protocols such as RIPv1, RIPv2, RIPng, OSPFv2, OSPFv3,
BGP-4, and BGP-4+. This document is provided for informational purposes to
help users configure quagga under Solaris specifically. Further
documentation on quagga configuration in general is provided at
http://www.quagga.net.
.SH "DESCRIPTION"
.PP
\fBQuagga\fR consists of the following packages:
.sp
.in +2
.ie t \(bu
.el o
.mk
.in +3
.rt
system/network/routing/quagga - Quagga root files
.sp
.in -3
.ie t \(bu
.el o 
.mk
.in +3
.rt
SUNWquagga-daemons - Quagga daemons
.sp
.in -3
.ie t \(bu
.el o 
.mk   
.in +3
.rt   
SUNWquagga-libs - Quagga private shared libraries
.sp
.in -3
.ie t \(bu
.el o 
.mk   
.in +3
.rt   
SUNWquagga-dev - Quagga private shared library headers
.sp
.in -3
.ie t \(bu
.el o 
.mk   
.in +3
.rt   
SUNWquaggaS - Quagga sources
.sp
.in -3
.in -2
.PP
More defailed \fBQuagga\fR documentation is available from
http://www.quagga.net/docs, or in the GNU Info format \fBQuagga\fR documentation
installed in /usr/sfw/share/info.
.PP
The \fBQuagga\fR routing protocol suite replaces \fBSUNWzebra\fR, and
detection of \fBSUNWzebra\fR 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 \fB"routeadm -u"\fR should be run. This will enable the
appropriate quagga services, and run the daemons if those services
dependencies are met.
.PP
In Solaris, quagga daemons are managed by the following smf(5) services:
.PP
svc:/network/routing/zebra:quagga	zebra routing manager daemon
.PP
svc:/network/routing/rip:quagga	RIPv2 routing daemon
.PP
svc:/network/routing/ripng:quagga	RIPng routing daemon
.PP
svc:/network/routing/bgp:quagga	BGP routing daemon
.PP
svc:/network/routing/ospf:quagga	OSPF routing daemon
.PP
svc:/network/routing/ospf6:quagga	OSPF6 routing daemon
.PP
\fBQuagga\fR daemons can be configured either via the \fBsmf\fR(5) framework, or via routeadm(1M),
the global dynamic routing management utility.
.PP
Note that quagga was built without the vtysh (unified vty shell) utility, as it depends on a package
not currently distributed with Solaris.
.PP
.SH "COMMANDS"
.PP
By default, \fBin.routed\fR and \fBin.ripngd\fR, 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 \fBrouteadm\fR (1M) or 
\fBsvcadm\fR (1M) as follows:
.sp
.nf
\f(CW# routeadm -d route
# routeadm -d ripng:default
\fR
.fi
.sp
disables in.routed and in.ripngd respectively using \fBrouteadm\fR (1M). 
.sp
.nf
\f(CW# svcadm disable route:default
# svcadm disable ripng:default
\fR
.fi
.sp
disables in.routed and in.ripngd respectively using smf(1). 
.PP
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.
.PP
To enable quagga services, again either \fBrouteadm\fR(1M) or \fBsvcadm\fR(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.
.PP
For example,
.sp
.nf
\f(CW# routeadm -e rip:quagga
# routeadm -e ipv4-routing -u
\fR
.fi
.sp
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).
.PP
To do the same via \fBsmf\fR(1),
.sp
.nf
\f(CW# svcadm enable -r rip:quagga
\fR
.fi
.sp
The "-r" option recursively enables rip:quagga's dependencies, which include
the ipv4-routing service.
.PP
The status of all routing daemon services can be displayed via \fBrouteadm\fR(1M),
run without options, or, through smf(1), via the svcs(1) command.
.PP
Commandline arguments to the quagga daemons can be altered by
modifying the routing/daemon-args property, again either via \fBrouteadm\fR(1M)
or svccfg(1M):
.sp
.nf
\f(CW# routeadm -m rip:quagga daemon-args="-s"
\fR
.fi
.sp
or
.sp
.nf
\f(CW# svccfg -s rip:quagga setprop routing/daemon-args="-s"
# svcadm refresh rip:quagga
\fR
.fi
.sp
The "refresh" is required to ensure the daemon re-reads its configuration.
.SH "DIAGNOSTICS"
.PP
To see status of all routing services, run \fBrouteadm\fR(1M) without options.
.SH "SEE ALSO"
.PP
\fBripngd\fR(8), \fBospfd\fR(8), \fBospf6d\fR(8), \fBbgpd\fR(8), \fBzebra\fR(8), \fBrouteadm\fR(1M),
\fBsvcadm\fR(1M), svcs(1), svccfg(1M), smf(5)
.SH "AUTHORS"
See <http://www.quagga.net>, or the Info file for an  accurate  list of authors.