|
1 '\" te |
|
2 .\" Copyright (c) 2006, Sun Microsystems, Inc\&. All Rights Reserved |
|
3 .TH quagga 8 "01 Aug 2006" "SunOS 5.11" "System Administration Commands" |
|
4 .SH "NAME" |
|
5 quagga - advanced routing protocol suite from www.quagga.net |
|
6 .SH "SYNOPSIS" |
|
7 .PP |
|
8 \fBQuagga\fR is an advanced routing software package that provides a suite of |
|
9 TCP/IP based routing protocols. |
|
10 .PP |
|
11 \fBQuagga\fR supports protocols such as RIPv1, RIPv2, RIPng, OSPFv2, OSPFv3, |
|
12 BGP-4, and BGP-4+. This document is provided for informational purposes to |
|
13 help users configure quagga under Solaris specifically. Further |
|
14 documentation on quagga configuration in general is provided at |
|
15 http://www.quagga.net. |
|
16 .SH "DESCRIPTION" |
|
17 .PP |
|
18 \fBQuagga\fR consists of the following packages: |
|
19 .sp |
|
20 .in +2 |
|
21 .ie t \(bu |
|
22 .el o |
|
23 .mk |
|
24 .in +3 |
|
25 .rt |
|
26 SUNWquaggar - Quagga root files |
|
27 .sp |
|
28 .in -3 |
|
29 .ie t \(bu |
|
30 .el o |
|
31 .mk |
|
32 .in +3 |
|
33 .rt |
|
34 SUNWquagga-daemons - Quagga daemons |
|
35 .sp |
|
36 .in -3 |
|
37 .ie t \(bu |
|
38 .el o |
|
39 .mk |
|
40 .in +3 |
|
41 .rt |
|
42 SUNWquagga-libs - Quagga private shared libraries |
|
43 .sp |
|
44 .in -3 |
|
45 .ie t \(bu |
|
46 .el o |
|
47 .mk |
|
48 .in +3 |
|
49 .rt |
|
50 SUNWquagga-dev - Quagga private shared library headers |
|
51 .sp |
|
52 .in -3 |
|
53 .ie t \(bu |
|
54 .el o |
|
55 .mk |
|
56 .in +3 |
|
57 .rt |
|
58 SUNWquaggaS - Quagga sources |
|
59 .sp |
|
60 .in -3 |
|
61 .in -2 |
|
62 .PP |
|
63 More defailed \fBQuagga\fR documentation is available from |
|
64 http://www.quagga.net/docs, or in the GNU Info format \fBQuagga\fR documentation |
|
65 installed in /usr/sfw/share/info. |
|
66 .PP |
|
67 The \fBQuagga\fR routing protocol suite replaces \fBSUNWzebra\fR, and |
|
68 detection of \fBSUNWzebra\fR configuration during boot will lead to automatic |
|
69 transfer of configuration to quagga. If manual upgrade (without reboot) is |
|
70 required, configuration files under /etc/sfw/zebra should be transferred to |
|
71 /etc/quagga, and \fB"routeadm -u"\fR should be run. This will enable the |
|
72 appropriate quagga services, and run the daemons if those services |
|
73 dependencies are met. |
|
74 .PP |
|
75 In Solaris, quagga daemons are managed by the following smf(5) services: |
|
76 .PP |
|
77 svc:/network/routing/zebra:quagga zebra routing manager daemon |
|
78 .PP |
|
79 svc:/network/routing/rip:quagga RIPv2 routing daemon |
|
80 .PP |
|
81 svc:/network/routing/ripng:quagga RIPng routing daemon |
|
82 .PP |
|
83 svc:/network/routing/bgp:quagga BGP routing daemon |
|
84 .PP |
|
85 svc:/network/routing/ospf:quagga OSPF routing daemon |
|
86 .PP |
|
87 svc:/network/routing/ospf6:quagga OSPF6 routing daemon |
|
88 .PP |
|
89 \fBQuagga\fR daemons can be configured either via the \fBsmf\fR(5) framework, or via routeadm(1M), |
|
90 the global dynamic routing management utility. |
|
91 .PP |
|
92 Note that quagga was built without the vtysh (unified vty shell) utility, as it depends on a package |
|
93 not currently distributed with Solaris. |
|
94 .PP |
|
95 .SH "COMMANDS" |
|
96 .PP |
|
97 By default, \fBin.routed\fR and \fBin.ripngd\fR, managed by the svc:/network/routing/route |
|
98 and svc:/network/routing/ripng services respectively, are configured as default |
|
99 IPv4/IPv6 routing services. To disable these, either utilize \fBrouteadm\fR (1M) or |
|
100 \fBsvcadm\fR (1M) as follows: |
|
101 .sp |
|
102 .nf |
|
103 \f(CW# routeadm -d route |
|
104 # routeadm -d ripng:default |
|
105 \fR |
|
106 .fi |
|
107 .sp |
|
108 disables in.routed and in.ripngd respectively using \fBrouteadm\fR (1M). |
|
109 .sp |
|
110 .nf |
|
111 \f(CW# svcadm disable route:default |
|
112 # svcadm disable ripng:default |
|
113 \fR |
|
114 .fi |
|
115 .sp |
|
116 disables in.routed and in.ripngd respectively using smf(1). |
|
117 .PP |
|
118 Note that these services must be disabled or their quagga counterparts |
|
119 (rip:quagga, ripng:quagga) will not run, since they services specify to the |
|
120 smf framework that they and their quagga counterparts cannot run |
|
121 simultaneously. |
|
122 .PP |
|
123 To enable quagga services, again either \fBrouteadm\fR(1M) or \fBsvcadm\fR(1M) can be used. |
|
124 Note that quagga services, like in.routed and in.ripngd, specify dependencies |
|
125 on ipv4(6)-routing(forwarding) services, so as with all smf(1) services, ensure the |
|
126 appropriate dependencies are enabled or the services will not start. |
|
127 .PP |
|
128 For example, |
|
129 .sp |
|
130 .nf |
|
131 \f(CW# routeadm -e rip:quagga |
|
132 # routeadm -e ipv4-routing -u |
|
133 \fR |
|
134 .fi |
|
135 .sp |
|
136 enables quagga's RIPv2 daemon (the -u option above is required, as |
|
137 global ip routing/forwarding settings are not applied to the system until next reboot |
|
138 unless the -u is issued). |
|
139 .PP |
|
140 To do the same via \fBsmf\fR(1), |
|
141 .sp |
|
142 .nf |
|
143 \f(CW# svcadm enable -r rip:quagga |
|
144 \fR |
|
145 .fi |
|
146 .sp |
|
147 The "-r" option recursively enables rip:quagga's dependencies, which include |
|
148 the ipv4-routing service. |
|
149 .PP |
|
150 The status of all routing daemon services can be displayed via \fBrouteadm\fR(1M), |
|
151 run without options, or, through smf(1), via the svcs(1) command. |
|
152 .PP |
|
153 Commandline arguments to the quagga daemons can be altered by |
|
154 modifying the routing/daemon-args property, again either via \fBrouteadm\fR(1M) |
|
155 or svccfg(1M): |
|
156 .sp |
|
157 .nf |
|
158 \f(CW# routeadm -m rip:quagga daemon-args="-s" |
|
159 \fR |
|
160 .fi |
|
161 .sp |
|
162 or |
|
163 .sp |
|
164 .nf |
|
165 \f(CW# svccfg -s rip:quagga setprop routing/daemon-args="-s" |
|
166 # svcadm refresh rip:quagga |
|
167 \fR |
|
168 .fi |
|
169 .sp |
|
170 The "refresh" is required to ensure the daemon re-reads its configuration. |
|
171 .SH "DIAGNOSTICS" |
|
172 .PP |
|
173 To see status of all routing services, run \fBrouteadm\fR(1M) without options. |
|
174 .SH "SEE ALSO" |
|
175 .PP |
|
176 \fBripngd\fR(8), \fBospfd\fR(8), \fBospf6d\fR(8), \fBbgpd\fR(8), \fBzebra\fR(8), \fBrouteadm\fR(1M), |
|
177 \fBsvcadm\fR(1M), svcs(1), svccfg(1M), smf(5) |
|
178 .SH "AUTHORS" |
|
179 See <http://www.quagga.net>, or the Info file for an accurate list of authors. |