1 '\" te |
|
2 .\" Copyright (c) 2006, 2011, Oracle and/or its affiliates\&. All rights reserved\&. |
|
3 .TH quagga 1m "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 package: |
|
19 .sp |
|
20 .in +2 |
|
21 .ie t \(bu |
|
22 .el o |
|
23 .mk |
|
24 .in +3 |
|
25 .rt |
|
26 system/network/routing/quagga - Quagga root files |
|
27 .sp |
|
28 .in -3 |
|
29 .in -2 |
|
30 .PP |
|
31 More detailed \fBQuagga\fR documentation is available from |
|
32 http://www.quagga.net/docs, or in the GNU Info format \fBQuagga\fR documentation |
|
33 installed in /usr/share/info. |
|
34 .PP |
|
35 In Solaris, quagga daemons are managed by the following smf(5) services: |
|
36 .PP |
|
37 svc:/network/routing/zebra:quagga zebra routing manager daemon |
|
38 .PP |
|
39 svc:/network/routing/rip:quagga RIPv2 routing daemon |
|
40 .PP |
|
41 svc:/network/routing/ripng:quagga RIPng routing daemon |
|
42 .PP |
|
43 svc:/network/routing/bgp:quagga BGP routing daemon |
|
44 .PP |
|
45 svc:/network/routing/ospf:quagga OSPF routing daemon |
|
46 .PP |
|
47 svc:/network/routing/ospf6:quagga OSPF6 routing daemon |
|
48 .PP |
|
49 \fBQuagga\fR daemons can be configured either via the \fBsmf\fR(5) framework, or via routeadm(1M), |
|
50 the global dynamic routing management utility. |
|
51 .PP |
|
52 Note that quagga was built without the vtysh (unified vty shell) utility, as it depends on a package |
|
53 not currently distributed with Solaris. |
|
54 .PP |
|
55 .SH "COMMANDS" |
|
56 .PP |
|
57 By default, \fBin.routed\fR and \fBin.ripngd\fR, managed by the svc:/network/routing/route |
|
58 and svc:/network/routing/ripng services respectively, are configured as default |
|
59 IPv4/IPv6 routing services. To disable these, either utilize \fBrouteadm\fR (1M) or |
|
60 \fBsvcadm\fR (1M) as follows: |
|
61 .sp |
|
62 .nf |
|
63 \f(CW# routeadm -d route |
|
64 # routeadm -d ripng:default |
|
65 \fR |
|
66 .fi |
|
67 .sp |
|
68 disables in.routed and in.ripngd respectively using \fBrouteadm\fR (1M). |
|
69 .sp |
|
70 .nf |
|
71 \f(CW# svcadm disable route:default |
|
72 # svcadm disable ripng:default |
|
73 \fR |
|
74 .fi |
|
75 .sp |
|
76 disables in.routed and in.ripngd respectively using smf(1). |
|
77 .PP |
|
78 Note that these services must be disabled or their quagga counterparts |
|
79 (rip:quagga, ripng:quagga) will not run, since they services specify to the |
|
80 smf framework that they and their quagga counterparts cannot run |
|
81 simultaneously. |
|
82 .PP |
|
83 To enable quagga services, again either \fBrouteadm\fR(1M) or \fBsvcadm\fR(1M) can be used. |
|
84 Note that quagga services, like in.routed and in.ripngd, specify dependencies |
|
85 on ipv4(6)-routing(forwarding) services, so as with all smf(1) services, ensure the |
|
86 appropriate dependencies are enabled or the services will not start. |
|
87 .PP |
|
88 For example, |
|
89 .sp |
|
90 .nf |
|
91 \f(CW# routeadm -e rip:quagga |
|
92 # routeadm -e ipv4-routing -u |
|
93 \fR |
|
94 .fi |
|
95 .sp |
|
96 enables quagga's RIPv2 daemon (the -u option above is required, as |
|
97 global ip routing/forwarding settings are not applied to the system until next reboot |
|
98 unless the -u is issued). |
|
99 .PP |
|
100 To do the same via \fBsmf\fR(1), |
|
101 .sp |
|
102 .nf |
|
103 \f(CW# svcadm enable -r rip:quagga |
|
104 \fR |
|
105 .fi |
|
106 .sp |
|
107 The "-r" option recursively enables rip:quagga's dependencies, which include |
|
108 the ipv4-routing service. |
|
109 .PP |
|
110 The status of all routing daemon services can be displayed via \fBrouteadm\fR(1M), |
|
111 run without options, or, through smf(1), via the svcs(1) command. |
|
112 .PP |
|
113 Commandline arguments to the quagga daemons can be altered by |
|
114 modifying the routing/daemon-args property, again either via \fBrouteadm\fR(1M) |
|
115 or svccfg(1M): |
|
116 .sp |
|
117 .nf |
|
118 \f(CW# routeadm -m rip:quagga daemon-args="-s" |
|
119 \fR |
|
120 .fi |
|
121 .sp |
|
122 or |
|
123 .sp |
|
124 .nf |
|
125 \f(CW# svccfg -s rip:quagga setprop routing/daemon-args="-s" |
|
126 # svcadm refresh rip:quagga |
|
127 \fR |
|
128 .fi |
|
129 .sp |
|
130 The "refresh" is required to ensure the daemon re-reads its configuration. |
|
131 .SH "DIAGNOSTICS" |
|
132 .PP |
|
133 To see status of all routing services, run \fBrouteadm\fR(1M) without options. |
|
134 .SH "SEE ALSO" |
|
135 .PP |
|
136 \fBripngd\fR(1m), \fBisisd\fR(1m), \fBospfd\fR(1m), \fBospf6d\fR(1m), \fBbgpd\fR(1m), \fBzebra\fR(1m), \fBrouteadm\fR(1M), |
|
137 \fBsvcadm\fR(1M), svcs(1), svccfg(1M), smf(5) |
|
138 .SH "AUTHORS" |
|
139 See <http://www.quagga.net>, or the Info file for an accurate list of authors. |
|