Annotation of embedaddon/quagga/solaris/README.txt, revision 1.1.1.1
1.1 misho 1: To build packages for Solaris 10:
2:
3: Requirements:
4: -------------
5:
6: - Development environment including gcc (eg as shipped with Solaris 10)
7:
8: - The Package tools from Solaris 10 or Solaris Nevada/Express.
9:
10: - i.manifest and r.manifest scripts as supplied with Solaris Express
11: in /usr/sadm/install/scripts/ or from OpenSolaris.org:
12:
13: http://cvs.opensolaris.org/source/xref/usr/src/pkgdefs/common_files/i.manifest
14: http://cvs.opensolaris.org/source/xref/usr/src/pkgdefs/common_files/r.manifest
15:
16: i.manifest must be at least version 1.5. Place these scripts in
17: this directory if you are using Solaris 10 GA (which does not ship with
18: these scripts), or in the solaris/ directory in the Quagga source.
19:
20:
21: Package creation instructions:
22: ------------------------------
23:
24: 1. Configure and build Quagga in the top level build directory as per
25: normal, eg:
26:
27: ./configure --prefix=/usr/local/quagga \
28: --localstatedir=/var/run/quagga
29: --enable-gcc-rdynamic --enable-opaque-lsa --enable-ospf-te \
30: --enable-multipath=64 --enable-user=quagga \
31: --enable-ospfclient=yes --enable-ospfapi=yes \
32: --enable-group=quagga --enable-nssa --enable-opaque-lsa
33:
34: You will need /usr/sfw/bin and /usr/ccs/bin in your path.
35:
36: 2. make install in the top-level build directory, it's a good idea to make
37: use of DESTDIR to install to an alternate root, eg:
38:
39: gmake DESTDIR=/var/tmp/qroot install
40:
41: 3. In this directory (solaris/), run make packages, specifying DESTDIR if
42: appropriate, eg:
43:
44: gmake DESTDIR=/var/tmp/qroot packages
45:
46: This should result in 4 packages being created:
47:
48: quagga-libs-...-$ARCH.pkg - QUAGGAlibs
49: quagga-daemons-...-$ARCH.pkg - QUAGGAdaemons
50: quagga-doc-...-$ARCH.pkg - QUAGGAdoc
51: quagga-dev-...-$ARCH.pkg - QUAGGAdev
52: quagga-smf-...-$ARCH.pkg - QUAGGAsmf
53:
54: QUAGGAlibs and QUAGGAdaemons are needed for daemon runtime. QUAGGAsmf
55: provides the required bits for Solaris 10+ SMF support.
56:
57:
58: Install and post-install configuration notes:
59: ---------------------------------------------
60:
61: - If you specified a user/group which does not exist per default on Solaris
62: (eg quagga/quagga) you *must* create these before installing these on a
63: system. The packages do *not* create the users.
64:
65: - The configuration files are not created. You must create the configuration
66: file yourself, either with your complete desired configuration, or else if
67: you wish to use the telnet interface for further configuration you must
68: create them containing at least:
69:
70: password whatever
71:
72: The user which quagga runs as must have write permissions on this file, no
73: other user should have read permissions, and you would also have to enable
74: the telnet interface (see below).
75:
76: - SMF notes:
77:
78: - QUAGGAsmf installs a svc:/network/routing/quagga service, with an
79: instance for each daemon
80:
81: - The state of all instances of quagga service can be inspected with:
82:
83: svcs -l svc:/network/routing/quagga
84:
85: or typically just with a shortcut of 'quagga':
86:
87: svcs -l quagga
88:
89: - A specific instance of the quagga service can be inspected by specifying
90: the daemon name as the instance, ie quagga:<daemon>:
91:
92: svcs -l svc:/network/routing/quagga:zebra
93: svcs -l svc:/network/routing/quagga:ospfd
94: <etc>
95:
96: or typically just with the shortcut of 'quagga:<daemon>' or even
97: <daemon>:
98:
99: svcs -l quagga:zebra
100: svcs -l ospfd
101:
102: Eg:
103:
104: # # svcs -l ripd
105: fmri svc:/network/routing/quagga:ripd
106: name Quagga: ripd, RIPv1/2 IPv4 routing protocol daemon.
107: enabled true
108: state online
109: next_state none
110: state_time Wed Jun 15 16:21:02 2005
111: logfile /var/svc/log/network-routing-quagga:ripd.log
112: restarter svc:/system/svc/restarter:default
113: contract_id 93
114: dependency require_all/restart svc:/network/routing/quagga:zebra (online)
115: dependency require_all/restart file://localhost//usr/local/quagga/etc/ripd.conf (online)
116: dependency require_all/none svc:/system/filesystem/usr:default (online)
117: dependency require_all/none svc:/network/loopback (online)
118:
119: - Configuration of startup options is by way of SMF properties in a
120: property group named 'quagga'. The defaults should automatically be
121: inline with how you configured Quagga in Step 1 above.
122:
123: - By default the VTY interface is disabled. To change this, see below for
124: how to set the 'quagga/vty_port' property as appropriate for
125: /each/ service. Also, the VTY is set to listen only to localhost by
126: default, you may change the 'quagga/vty_addr' property as appropriate
127: for both of the 'quagga' service and specific individual instances of
128: the 'quagga' service (ie quagga:zebra, quagga:ospfd, etc..).
129:
130: - Properties belonging to the 'quagga' service are inherited by all
131: instances. Eg:
132:
133: # svcprop -p quagga svc:/network/routing/quagga
134: quagga/group astring root
135: quagga/retain boolean false
136: quagga/user astring root
137: quagga/vty_addr astring 127.1
138: quagga/vty_port integer 0
139:
140: # svcprop -p quagga svc:/network/routing/quagga:ospfd
141: quagga/retain_routes boolean false
142: quagga/group astring root
143: quagga/retain boolean false
144: quagga/user astring root
145: quagga/vty_addr astring 127.1
146: quagga/vty_port integer 0
147:
148: All instances will inherit these properties, unless the instance itself
149: overrides these defaults. This also implies one can modify properties of
150: the 'quagga' service and have them apply to all daemons.
151:
152: # svccfg -s svc:/network/routing/quagga \
153: setprop quagga/vty_addr = astring: ::1
154:
155: # svcprop -p quagga svc:/network/routing/quagga
156: quagga/group astring root
157: quagga/retain boolean false
158: quagga/user astring root
159: quagga/vty_port integer 0
160: quagga/vty_addr astring ::1
161:
162: # # You *must* refresh instances to have the property change
163: # # take affect for the 'running snapshot' of service state.
164: # svcadm refresh quagga:ospfd
165:
166: # svcprop -p quagga svc:/network/routing/quagga:ospfd
167: quagga/retain_routes boolean false
168: quagga/group astring root
169: quagga/retain boolean false
170: quagga/user astring root
171: quagga/vty_port integer 0
172: quagga/vty_addr astring ::1
173:
174: Other daemon-specific options/properties may be available, however they
175: are not yet honoured/used (eg ospfd/apiserver on svc:/network/ospf).
176:
177: - As SMF is dependency aware, restarting network/zebra will restart all the
178: other daemons.
179:
180: - To upgrade from one set of Quagga packages to a newer release, one must
181: first pkgrm the installed packages. When one pkgrm's QUAGGAsmf all
182: property configuration will be lost, and any customisations will have to
183: redone after installing the updated QUAGGAsmf package.
184:
185: - These packages are not supported by Sun Microsystems, report bugs via the
186: usual Quagga channels, ie Bugzilla. Improvements/contributions of course
187: would be greatly appreciated.
188:
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>
![[BACK]](/icons/cvsweb/back.gif){kind=icon}
Return to README.txt CVS log ![[TXT]](/icons/cvsweb/text.gif){kind=icon}
![[DIR]](/icons/cvsweb/dir.gif){kind=icon}
Up to [ELWIX - Embedded LightWeight unIX -] / embedaddon / quagga / solaris