6 %define name myplc-docs
10 %define release %{taglevel}%{?pldistro:.%{pldistro}}%{?date:.%{date}}
12 Summary: PlanetLab Central (PLC) online documentation
17 Group: Applications/Systems
18 Source0: %{name}-%{version}.tar.gz
19 BuildRoot: %{_tmppath}/%{name}-%{version}-%{release}-root
23 Packager: PlanetLab Central <support@planet-lab.org>
24 Distribution: PlanetLab %{plrelease}
25 URL: %(echo %{url} | cut -d ' ' -f 2)
27 BuildRequires: docbook-dtds, docbook-utils-pdf
29 %define debug_package %{nil}
32 This package contains the online documentation for MyPLC, i.e. the
33 reference manuals for the two APIs provided: PLCAPI and NMAPI. A
34 more general introduction to the MyPLC system can be found at
35 http://svn.planet-lab.org/wiki/MyPLCUserGuide
41 rm -rf $RPM_BUILD_ROOT
43 # using the new lowercase names, and handling legacy
44 [ -d PLCAPI ] || ln -s plcapi PLCAPI
45 [ -d Monitor ] || ln -s monitor Monitor
46 [ -d NodeManager ] || ln -s nodemanager NodeManager
47 [ -d MyPLC ] || ln -s myplc MyPLC
50 # beware that making the pdf file somehow overwrites the html
51 make -C doc PLCAPI.pdf
53 make -C doc PLCAPI.html
57 # beware that making the pdf file somehow overwrites the html
60 make -C doc NMAPI.html
64 # beware that making the pdf file somehow overwrites the html
65 make -C docs Monitor.pdf
66 rm -f docs/Monitor.html
67 make -C docs Monitor.html
72 for ext in pdf html; do
73 install -D -m 444 PLCAPI/doc/PLCAPI.$ext $RPM_BUILD_ROOT/var/www/html/planetlab/doc/PLCAPI.$ext
74 install -D -m 444 NodeManager/doc/NMAPI.$ext $RPM_BUILD_ROOT/var/www/html/planetlab/doc/NMAPI.$ext
75 install -D -m 444 Monitor/docs/Monitor.$ext $RPM_BUILD_ROOT/var/www/html/planetlab/doc/Monitor.$ext
78 ./MyPLC/docbook2drupal.sh "PLC API Documentation (%{pldistro})" \
79 $RPM_BUILD_ROOT/var/www/html/planetlab/doc/PLCAPI.html \
80 $RPM_BUILD_ROOT/var/www/html/planetlab/doc/PLCAPI.php
81 ./MyPLC/docbook2drupal.sh "Node Manager API Documentation (%{pldistro})" \
82 $RPM_BUILD_ROOT/var/www/html/planetlab/doc/NMAPI.html \
83 $RPM_BUILD_ROOT/var/www/html/planetlab/doc/NMAPI.php
84 ./MyPLC/docbook2drupal.sh "Monitor API Documentation (%{pldistro})" \
85 $RPM_BUILD_ROOT/var/www/html/planetlab/doc/Monitor.html \
86 $RPM_BUILD_ROOT/var/www/html/planetlab/doc/Monitor.php
89 rm -rf $RPM_BUILD_ROOT
92 %defattr(-,root,root,-)
93 /var/www/html/planetlab/doc/
96 * Tue Mar 15 2011 S.Çağlar Onur <caglar@verivue.com> - myplc-4.3-45
97 - Cherry-pick PHP5 timezone fix form master
99 * Thu Feb 03 2011 S.Çağlar Onur <caglar@cs.princeton.edu> - myplc-4.3-44
100 - pick the greatest version as a kernel
102 * Thu Jan 06 2011 S.Çağlar Onur <caglar@cs.princeton.edu> - myplc-4.3-43
103 - handle directory name changes for myplc-docs package as well
105 * Thu Jan 06 2011 S.Çağlar Onur <caglar@cs.princeton.edu> - myplc-4.3-42
106 - handle directory name changes
108 * Thu Nov 18 2010 Daniel Hokka Zakrisson <dhokka@cs.princeton.edu> - myplc-4.3-41
109 - Use correct resolv.conf file.
111 * Wed Nov 17 2010 Daniel Hokka Zakrisson <dhokka@cs.princeton.edu> - myplc-4.3-40
112 - Make dnsmasq usable.
114 * Wed Nov 17 2010 Daniel Hokka Zakrisson <dhokka@cs.princeton.edu> - myplc-4.3-39
115 - Allow dnsmasq configuration to be extended.
117 * Thu Jul 22 2010 Daniel Hokka Zakrisson <dhokka@cs.princeton.edu> - myplc-4.3-38
119 - Generalize bootcd-kernel.
121 * Sat Jan 09 2010 Thierry Parmentelat <thierry.parmentelat@sophia.inria.fr> - MyPLC-4.3-37
122 - support for fedora 12
123 - new package myplc-config for use by sfa
124 - drupal user registration turned off
126 * Thu Dec 31 2009 Marc Fiuczynski <mef@cs.princeton.edu> - MyPLC-4.3-36
127 - - fix to make sure when API, BOOT, MONITOR are on the same
128 - machine as WWW that the SSL key,cert for WWW takes precedence.
129 - - Do proper setup for SSL CA certficate to be used as the server
132 * Wed Dec 23 2009 Marc Fiuczynski <mef@cs.princeton.edu> - MyPLC-4.3-35
133 - - Change sysctl.conf source to be PlanetLabConfsysctl.con rather than the php script.
135 * Tue Dec 22 2009 Baris Metin <Talip-Baris.Metin@sophia.inria.fr> - MyPLC-4.3-34
136 - depend on pcucontrol
138 * Fri Dec 18 2009 Baris Metin <Talip-Baris.Metin@sophia.inria.fr> - MyPLC-4.3-33
139 - * validate input according to type in plc_config
140 - * added the _genicw system slice
141 - * add tag types for sites and persons
142 - * add new tags for nodes and slices for exemption from myops
144 * Thu Nov 26 2009 Thierry Parmentelat <thierry.parmentelat@sophia.inria.fr> - MyPLC-4.3-32
145 - turn off drupal on a box that acts as BOOT server but not as WWW server
146 - cleanup some obsolete code for old chroot-jail packaging in the process
147 - new bootcd-kernel script for keeping bootcd variants up2date
149 * Mon Nov 09 2009 Daniel Hokka Zakrisson <daniel@hozac.com> - MyPLC-4.3-31
150 - Make the /etc/hosts manipulation optional.
152 * Thu Nov 05 2009 Daniel Hokka Zakrisson <daniel@hozac.com> - MyPLC-4.3-30
155 * Tue Nov 03 2009 Marc Fiuczynski <mef@cs.princeton.edu> - MyPLC-4.3-29
156 - - Added "SetRole()" so that db-config.d/ scriplets can insert roles
158 - - Added the root ssh key handling support back into plc.d/ssh and the
159 - default xml file. This should be identical to the way it was in
161 - - Added support in the db-config.d/01-init script to register the root
162 - ssh public key with the default administrator. In this way the root
163 - ssh key will make it into the root account on the nodes by means of
164 - NodeManager's specialaccounts plugin.
166 * Tue Oct 20 2009 Thierry Parmentelat <thierry.parmentelat@sophia.inria.fr> - MyPLC-4.3-28
167 - db-config ignores sliver tags
168 - sirius's db-config script renamed (was sirious)
170 * Tue Oct 13 2009 Thierry Parmentelat <thierry.parmentelat@sophia.inria.fr> - MyPLC-4.3-27
171 - fix for silverauth - missing tag types now created at plc startup time
173 * Fri Oct 09 2009 Thierry Parmentelat <thierry.parmentelat@sophia.inria.fr> - MyPLC-4.3-26
174 - plc.d/ssl preserves SSL certificates when it thinkfs they're obsolete
176 * Wed Oct 07 2009 Thierry Parmentelat <thierry.parmentelat@sophia.inria.fr> - MyPLC-4.3-25
177 - companion to NM's specialaccounts plugin
178 - do not generate /etc/planetlab/root_ssh_key* anymore
179 - remove related config. variables and conf_files
181 * Sun Sep 20 2009 Stephen Soltesz <soltesz@cs.princeton.edu> - MyPLC-4.3-24
182 - clarified description text to refer only to plcrt and not other optional
185 * Sat Sep 19 2009 Stephen Soltesz <soltesz@cs.princeton.edu> - MyPLC-4.3-23
186 - fixed a bug setting slice multiple attributes with the same tag name
188 * Mon Sep 07 2009 Thierry Parmentelat <thierry.parmentelat@sophia.inria.fr> - MyPLC-4.3-22
189 - SSL setup for monitor box, and related new config variables
190 - new conf_file for /etc/planetlab/extensions
191 - various tweaks in db-config internals, about initscripts among others
192 - also more messages defined in the db
194 * Tue Jul 07 2009 Thierry Parmentelat <thierry.parmentelat@sophia.inria.fr> - MyPLC-4.3-21
195 - create node tags, like e.g. 'arch', that were not handled with 4.3-20
197 * Tue Jul 07 2009 Thierry Parmentelat <thierry.parmentelat@sophia.inria.fr> - MyPLC-4.3-20
198 - bugfix in db-config, tag 4.3-19 would not fly
200 * Mon Jul 06 2009 Marc Fiuczynski <mef@cs.princeton.edu> - MyPLC-4.3-19
201 - Refactored db-config into snippets in db-config.d/.
203 * Thu Jul 02 2009 Thierry Parmentelat <thierry.parmentelat@sophia.inria.fr> - MyPLC-4.3-18
204 - oops, tag 4.3-17 was broken and would not work
206 * Wed Jul 01 2009 Thierry Parmentelat <thierry.parmentelat@sophia.inria.fr> - MyPLC-4.3-17
207 - bugfix - escape sequences inserted in xml configs
209 * Fri Jun 26 2009 Marc Fiuczynski <mef@cs.princeton.edu> - MyPLC-4.3-16
210 - Handle db-config.d files properly.
212 * Tue Jun 23 2009 Marc Fiuczynski <mef@cs.princeton.edu> - MyPLC-4.3-15
213 - - Fix /etc/init.d/plc to have command usage show up on the tty rather
215 - - Fix db-config to be a bit more cautious when
216 - /etc/planetlab/db-config.d doesn't exist
217 - - Clean up db-config approach to ignore .bak, *~, .rpm{save,new}, and
219 - - Refactor generic plc-config-tty code into plc_config.py.
220 - plc-config-tty now contains MyPLC specific paths, "usual" variables,
221 - and the list of validated variables and the corresponding
222 - validator() function. This refactoring lets one reuse plc_config.py
223 - as a generic cmdline configuration tool for highly customer MyPLC
226 * Mon Jun 15 2009 Stephen Soltesz <soltesz@cs.princeton.edu> - MyPLC-4.3-14
227 - update PCU Type descriptions.
228 - updates to init scripts
230 * Wed Jun 03 2009 Thierry Parmentelat <thierry.parmentelat@sophia.inria.fr> - MyPLC-4.3-13
231 - requires monitor-pcucontrol so register-wizard can work
233 * Tue May 26 2009 Thierry Parmentelat <thierry.parmentelat@sophia.inria.fr> - MyPLC-4.3-12
234 - cleaned up plc-config-tty, no more need to configure plc-devel
236 * Tue May 19 2009 Thierry Parmentelat <thierry.parmentelat@sophia.inria.fr> - MyPLC-4.3-11
237 - first draft of plc-orpha-accounts.py, and rename check-ssl-peering into plc-<>
239 * Fri May 15 2009 Thierry Parmentelat <thierry.parmentelat@sophia.inria.fr> - MyPLC-4.3-10
240 - tighter right permissions on site_admin's authorized keys for more robustness
242 * Wed May 06 2009 Thierry Parmentelat <thierry.parmentelat@sophia.inria.fr> - MyPLC-4.3-9
243 - fix issue in db-config that prevented correct operation
245 * Wed May 06 2009 Thierry Parmentelat <thierry.parmentelat@sophia.inria.fr> - MyPLC-4.3-8
246 - remove support for chroot-based packaging - no crond nor syslog step anymore
247 - plc init script now named plc.init instead of former guest.init
249 * Mon May 04 2009 Stephen Soltesz <soltesz@cs.princeton.edu> - MyPLC-4.3-7
250 - add Monitor to docs build
252 * Wed Apr 29 2009 Marc Fiuczynski <mef@cs.princeton.edu> - MyPLC-4.3-6
253 - plc_config.py and plc-config-tty: generalized to work for more diverse
254 - MyPLC configurations.
255 - plc.d/httpd: only update httpd_conf with /data for chroot'ed MyPLC
256 - deployments and increase the memory limits in php.ini
257 - plc.d/crond: add --full option to vacuumdb
259 * Tue Apr 07 2009 Thierry Parmentelat <thierry.parmentelat@sophia.inria.fr> - MyPLC-4.3-5
260 - avoid generating ssl certificates for disabled services among www api boot
262 * Mon Mar 30 2009 Thierry Parmentelat <thierry.parmentelat@sophia.inria.fr> - MyPLC-4.3-4
263 - cleaned up old entries in db-config
266 * Tue Mar 24 2009 Thierry Parmentelat <thierry.parmentelat@sophia.inria.fr> - MyPLC-4.3-3
267 - php include path tweaked for plekit includes
268 - reviewed myplc (fka native) packaging dependencies
271 * Thu Jan 29 2009 Thierry Parmentelat <thierry.parmentelat@sophia.inria.fr> - MyPLC-4.3-2
272 - rename myplc into myplc-chroot and myplc-native into myplc
273 - new settings (shortname & hrn_root) for local peer
275 * Wed Sep 10 2008 Thierry Parmentelat <thierry.parmentelat@sophia.inria.fr> - MyPLC-4.3-1
276 - First iteration of new data model
277 - Bunch of various fixes
279 * Tue May 20 2008 Faiyaz Ahmed <faiyaza@cs.princeton.edu> - MyPLC-4.2-15
280 - Removed proper ops from planetflow slice.
282 * Wed May 14 2008 Thierry Parmentelat <thierry.parmentelat@sophia.inria.fr> - MyPLC-4.2-14
283 - myplc-native requires myplc-docs
284 - fixed doc build by locating locally installed DTDs at build-time
286 * Sun May 11 2008 Thierry Parmentelat <thierry.parmentelat@sophia.inria.fr> - MyPLC-4.2-13
287 - turn myplc-docs off for now
289 * Sat May 10 2008 Thierry Parmentelat <thierry.parmentelat@sophia.inria.fr> - MyPLC-4.2-12
290 - figures in doc package
292 * Fri May 09 2008 Thierry Parmentelat <thierry.parmentelat@sophia.inria.fr> - MyPLC-4.2-11
293 - no more doc packaged outside of myplc-docs - doc/ cleaned up
294 - chroot packaging does not have docs anymore
295 - 'cvs' and 'dev' not required from myplc-native anymore
296 - cosmetic change in kml output
299 %define module_current_branch 4.2