11 %define release %{taglevel}%{?pldistro:.%{pldistro}}%{?date:.%{date}}
13 Summary: PlanetLab Central API
18 Group: System Environment/Daemons
19 Source0: %{name}-%{version}.tar.gz
20 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)
29 # We use set everywhere
30 Requires: python >= 2.4
31 Requires: postgresql >= 8.2, postgresql-server >= 8.2
32 Requires: postgresql-python
33 Requires: python-psycopg2
34 Requires: python-pycurl
39 # for the RebootNodeWithPCU method
43 Requires: python-twisted-words
44 Requires: python-twisted-web
46 ### avoid having yum complain about updates, as stuff is moving around
48 Conflicts: MyPLC <= 4.3
52 # but we don't need to rebuild it as we depend on distro's packages - baris
53 # BuildRequires: postgresql-devel
55 # Standard xmlrpc.so that ships with PHP does not marshal NULL
56 BuildRequires: php-devel
60 # PostgreSQL and SOAPpy are necessary to run the API server, but not
61 # plcsh. Since the only supported method of running the server is via
62 # MyPLC anyway, don't be so stringent about binary requirements, in
63 # case people want to install this package just for plcsh.
64 # Requires: postgresql-server, SOAPpy
68 The PLCAPI package provides an XML-RPC and SOAP API for accessing the
69 PlanetLab Central (PLC) database. The API may be accessed directly via
70 the Python shell program plcsh, through a toy standalone server, or
71 through Apache mod_python.
77 # python-pycurl and python-psycopg2 avail. from fedora 5
78 # we used to ship our own version of psycopg2 and pycurl, for fedora4
79 # starting with 4.3, support for these two modules is taken out
81 # Build __init__.py metafiles and PHP API.
82 %{__make} %{?_smp_mflags}
86 rm -rf $RPM_BUILD_ROOT
87 %{__make} %{?_smp_mflags} install DESTDIR="$RPM_BUILD_ROOT" datadir="%{_datadir}" bindir="%{_bindir}"
89 # Install shell symlink
90 mkdir -p $RPM_BUILD_ROOT/%{_bindir}
91 ln -s %{_datadir}/plc_api/plcsh $RPM_BUILD_ROOT/%{_bindir}/plcsh
93 mkdir -p $RPM_BUILD_ROOT/%{_sysconfdir}/php.d
94 cat > $RPM_BUILD_ROOT/%{_sysconfdir}/php.d/xmlrpc.ini <<EOF
95 ; Enable xmlrpc extension module
100 echo "* Installing initscripts"
101 find plc.d | cpio -p -d -u ${RPM_BUILD_ROOT}/etc/
102 chmod 755 ${RPM_BUILD_ROOT}/etc/plc.d/*
104 # Install db-config.d files
105 echo "* Installing db-config.d files"
106 mkdir -p ${RPM_BUILD_ROOT}/etc/planetlab/db-config.d
107 cp db-config.d/* ${RPM_BUILD_ROOT}/etc/planetlab/db-config.d
108 chmod 444 ${RPM_BUILD_ROOT}/etc/planetlab/db-config.d/*
111 echo "* Installing wsdl"
112 install -D -m 644 wsdl/plcapi.wsdl $RPM_BUILD_ROOT/var/www/html/wsdl/plcapi.wsdl
114 # Install omf_slicemgr.py
115 install -D -m 755 omf/omf_slicemgr.py $RPM_BUILD_ROOT/usr/bin/omf_slicemgr.py
116 install -D -m 755 omf/reset_xmpp_pubsub_nodes.py $RPM_BUILD_ROOT/usr/bin/reset_xmpp_pubsub_nodes.py
117 mkdir -p $RPM_BUILD_ROOT/var/log/omf
120 rm -rf $RPM_BUILD_ROOT
122 %define php_extension_dir %(php-config --extension-dir)
125 %defattr(-,root,root,-)
126 %dir %{_datadir}/plc_api
128 %{_datadir}/plc_api/*
130 %{php_extension_dir}/xmlrpc.so
131 %{_sysconfdir}/php.d/xmlrpc.ini
132 %config (noreplace) %{_datadir}/plc_api/PLC/Accessors/Accessors_site.py
134 /etc/planetlab/db-config.d
135 /var/www/html/wsdl/plcapi.wsdl
136 /usr/bin/omf_slicemgr.py*
137 /usr/bin/reset_xmpp_pubsub_nodes.py*
141 * Wed Apr 14 2010 Thierry Parmentelat <thierry.parmentelat@sophia.inria.fr> - PLCAPI-5.0-8
142 - previous tag had gone wrong
144 * Wed Apr 14 2010 Talip Baris Metin <Talip-Baris.Metin@sophia.inria.fr> - PLCAPI-5.0-6
145 - fix pubsub hostname
147 * Fri Apr 02 2010 Thierry Parmentelat <thierry.parmentelat@sophia.inria.fr> - PLCAPI-5.0-5
148 - tweaks for the omf support (xmpp groups and RC-controlled slices)
149 - BootNodeUpdate supports also ssh_rsa_key (and logs only changes)
150 - GetNodeFlavour exposes fcdistro
152 * Sun Mar 14 2010 Thierry Parmentelat <thierry.parmentelat@sophia.inria.fr> - PLCAPI-5.0-4
153 - do not use UpdateNode for handling the 'hrn' tag - should fix refresh peer & foreign nodes more generally
155 * Fri Mar 12 2010 Thierry Parmentelat <thierry.parmentelat@sophia.inria.fr> - PLCAPI-5.0-3
156 - slice tag 'omf_control' supported for getting OMF's resource controller shipped to slivers
157 - pyaspect hooks allow to maintain the namespace xmpp groups
158 - new omf_slicemgr is a proxy to xmpp, used by these hooks
159 - nodes have their hrn exposed in the 'hrn' tag
160 - node hrn exposed in GetSlivers, as well as the overall xmpp config
161 - system slice 'drl' gets created by db-config
162 - daniel's changes to Filter for supporting wildcards in lists
163 - AddSliceTag consistency check tweaked
165 * Thu Feb 11 2010 Thierry Parmentelat <thierry.parmentelat@sophia.inria.fr> - PLCAPI-5.0-2
167 - get rid of all 4.2-related legacy code
168 - reset the migrations code, planetlab5.sql somes with (5,100)
169 - uses hashlib module when available
171 * Fri Jan 29 2010 Thierry Parmentelat <thierry.parmentelat@sophia.inria.fr> - PLCAPI-5.0-1
172 - first working version of 5.0:
173 - pld.c/, db-config.d/ and nodeconfig/ scripts should now sit in the module they belong to
174 - nodefamily is 3-fold with pldistro-fcdistro-arch
175 - site and person tags
176 - new methods GetSliceFamily and GetNodeFlavour
177 - deprecated the dummynet stuff that were for the external dummyboxes
178 - tags definition : more consistency between db-config scripts and accessors
179 - (get accessor to create the tag type too if absent)
180 - logging an event for AddSliceToNodes
182 * Sat Jan 09 2010 Thierry Parmentelat <thierry.parmentelat@sophia.inria.fr> - PLCAPI-4.3-32
183 - support for fedora 12
184 - fix subtle bug in filtering with ] and quotes
186 * Fri Dec 18 2009 Baris Metin <Talip-Baris.Metin@sophia.inria.fr> - PLCAPI-4.3-31
187 - * patch for php-5.3 (the one in f12)
188 - * validate email addresses with regex
189 - * add PersonTags and SiteTags
190 - * add additional accessors for node tags (kvariant, serial, ..)
192 * Tue Nov 03 2009 Marc Fiuczynski <mef@cs.princeton.edu> - PLCAPI-4.3-30
193 - Redacting password, session, and authstring values from the event log.
195 * Mon Oct 19 2009 Thierry Parmentelat <thierry.parmentelat@sophia.inria.fr> - PLCAPI-4.3-29
196 - let AddSite set ext_consortium_id - required for the poorman registration pages
197 - drop version constraint on Requires: postgresql-python
198 - don't log system calls nor ReportRunLevel
200 * Thu Oct 15 2009 Daniel Hokka Zakrisson <daniel@hozac.com> - PLCAPI-4.3-28
201 - Fix requires for CentOS.
203 * Fri Oct 09 2009 Baris Metin <Talip-Baris.Metin@sophia.inria.fr> - PLCAPI-4.3-27
204 - Require postgresql 8.2 (for array operators && and @>)
206 * Thu Oct 08 2009 Thierry Parmentelat <thierry.parmentelat@sophia.inria.fr> - PLCAPI-4.3-26
207 - Filter now supports the | and & features to match in sequence values
208 - bugfix in the postgresql wrapper for sequence filter values
209 - reviewed GetSlivers to export admin keys more efficiently
210 - fix checking roles in UpdateSliceTag
212 * Sat Sep 26 2009 Marc Fiuczynski <mef@cs.princeton.edu> - PLCAPI-4.3-25
213 - - Some typos in the documentation were fixed.
214 - - UpdateSliceTag check if a node's min_role_id is >= (rather than >)
215 - to the tag's min_role_id.
217 * Fri Sep 18 2009 anil vengalil <avengali@sophia.inria.fr> - PLCAPI-4.3-24
219 * Mon Sep 07 2009 Thierry Parmentelat <thierry.parmentelat@sophia.inria.fr> - PLCAPI-4.3-23
220 - Ongoing work to add upcalls, using new SFA class
221 - new methods BindObjectToPeer, UnBindObjectFromPeer, still for SFA
222 - reviewed type-checking for the 3 taggable classes node-interface-slice
223 - cleanup ald dummynet stuff
224 - expose the 'extensions' accessors to the API
225 - tweaked checks in AddSliceTag
226 - GetPersons exposes roles by default
227 - bugfix in ReportRunLevel for non-string levels
228 - tweaks in GetSlivers ( seems that it now exposes the keys for the root context )
230 * Fri Jul 10 2009 Thierry Parmentelat <thierry.parmentelat@sophia.inria.fr> - PLCAPI-4.3-22
231 - new BindObjectToPeer method for sfa
232 - AddSliceTag and UpdateSliceTag open to the 'node' auth method with restrictions
234 * Wed Jul 01 2009 Thierry Parmentelat <thierry.parmentelat@sophia.inria.fr> - PLCAPI-4.3-21
235 - getbootmedium supports options as tags (serial, cramfs, kvariant, kargs, no-hangcheck )
236 - reportrunlevel logs its calls only when run_level changes
237 - pycurl more robust wrt to xmlrpclib.Transport
239 * Tue Jun 16 2009 Thierry Parmentelat <thierry.parmentelat@sophia.inria.fr> - PLCAPI-4.3-20
240 - produce a wsdl interface
241 - bugfix in getbootmedium for nodes with interface tags
243 * Sun Jun 07 2009 Thierry Parmentelat <thierry.parmentelat@sophia.inria.fr> - PLCAPI-4.3-19
244 - bugfix for some rare pattern-based filters
246 * Wed Jun 03 2009 Thierry Parmentelat <thierry.parmentelat@sophia.inria.fr> - PLCAPI-4.3-18
247 - improvements in the 4.2 legacy layer
249 * Sat May 30 2009 Thierry Parmentelat <thierry.parmentelat@sophia.inria.fr> - PLCAPI-4.3-17
250 - bugfix required for slice tags set on nodegroups
252 * Thu May 28 2009 Thierry Parmentelat <thierry.parmentelat@sophia.inria.fr> - PLCAPI-4.3-16
253 - more complete compatibility layer - second iteration, with legacy code isolated in Legacy/
255 * Tue May 26 2009 Thierry Parmentelat <thierry.parmentelat@sophia.inria.fr> - PLCAPI-4.3-15
256 - more powerful legacy layer with 4.2
258 * Fri May 15 2009 Thierry Parmentelat <thierry.parmentelat@sophia.inria.fr> - PLCAPI-4.3-14
259 - RefreshPeer sets lock per-peer to avoid multiple concurent instances
260 - migration script has an option for running interactively
262 * Wed May 06 2009 Thierry Parmentelat <thierry.parmentelat@sophia.inria.fr> - PLCAPI-4.3-13
263 - skips already added entries
265 * Tue Apr 28 2009 Thierry Parmentelat <thierry.parmentelat@sophia.inria.fr> - PLCAPI-4.3-12
266 - yet another set of fixes for external dummynet boxes
268 * Wed Apr 22 2009 Thierry Parmentelat <thierry.parmentelat@sophia.inria.fr> - PLCAPI-4.3-11
269 - GetDummyBoxMedium returns a base64-encoded boot image, doc is updated
270 - and tmp file is cleaned up
272 * Wed Apr 22 2009 Thierry Parmentelat <thierry.parmentelat@sophia.inria.fr> - PLCAPI-4.3-10
273 - restore missing ResolveSlices
275 * Mon Apr 20 2009 Thierry Parmentelat <thierry.parmentelat@sophia.inria.fr> - PLCAPI-4.3-9
276 - new method GetDummyBoxMedium
278 * Fri Apr 17 2009 Thierry Parmentelat <thierry.parmentelat@sophia.inria.fr> - PLCAPI-4.3-8
279 - remove duplicate in Methods/__init__ that was breaking build of myplc-docs
281 * Fri Apr 17 2009 Thierry Parmentelat <thierry.parmentelat@sophia.inria.fr> - PLCAPI-4.3-7
282 - support for external dummynet boxes back in 4.3 - first draft
284 * Thu Apr 09 2009 Thierry Parmentelat <thierry.parmentelat@sophia.inria.fr> - PLCAPI-4.3-6
285 - fixes for smooth federation between 4.2 and 4.3
286 - peername is not UNIQUE in schema anymore, was preventing delete/recreate
288 * Tue Apr 07 2009 Thierry Parmentelat <thierry.parmentelat@sophia.inria.fr> - PLCAPI-4.3-5
289 - support for BootCD variants (GetBootMedium ['variant:centos5'])
290 - fix corner case with filters like {'~slice_id':[]}
291 - fix transaction leak that caused the db connections pool to exhaust
292 - properly expose all methods, including Legacy/, and not only Methods/
294 * Tue Mar 24 2009 Thierry Parmentelat <thierry.parmentelat@sophia.inria.fr> - PLCAPI-4.3-4
296 - nodes have new fields run_level (in addition to boot_state) and verified
297 - tweaked migration from 4.2
298 - tuned rpm dependencies
299 - doc generation more explicit about errors like missing python modules
300 - removed obsolete method GetSlicesMD5
302 * Wed Jan 28 2009 Thierry Parmentelat <thierry.parmentelat@sophia.inria.fr> - PLCAPI-4.3-3
304 - renamed interface settings into interface tags and slice attributes into slice tags
305 - nodes have a node_type
306 - various changes on the way to 4.3
308 * Thu Nov 27 2008 Thierry Parmentelat <thierry.parmentelat@sophia.inria.fr> - PLCAPI-4.3-2
309 - Checkpointing : this version still has interface settings and slice attributes
311 * Wed Sep 10 2008 Thierry Parmentelat <thierry.parmentelat@sophia.inria.fr> - PLCAPI-4.3-1
312 - first iteration with taggable nodes/interfaces/slices
314 - cleaned up boot states
315 - migration script moslty complete
317 * Wed May 14 2008 Thierry Parmentelat <thierry.parmentelat@sophia.inria.fr> - PLCAPI-4.2-8
318 - fixed doc build by locating locally installed DTDs at build-time
320 * Fri May 09 2008 Thierry Parmentelat <thierry.parmentelat@sophia.inria.fr> - PLCAPI-4.2-7
321 - no more doc packaged outside of myplc-docs - doc/ cleaned up
322 - enhancements in doc on filters
323 - bootcd-aware GetBootMedium merged from onelab
325 * Thu May 08 2008 Thierry Parmentelat <thierry.parmentelat@sophia.inria.fr> - PLCAPI-4.2-6
326 - checkpoint while the new myplc-docs package is underway
327 - bugfix: GetSlivers & conf files
328 - doc: removed target files
330 * Wed Apr 23 2008 Stephen Soltesz <soltesz@cs.princeton.edu> - PLCAPI-4.2-5
331 - Removed conditions on the persons, site, and nodes indexes. previsouly only
332 - the non-deleted fields were index, resulting in massivly slow queries.
335 * Wed Mar 26 2008 Thierry Parmentelat <thierry.parmentelat@sophia.inria.fr> - PLCAPI-4.2-3 PLCAPI-4.2-4
336 - plcsh: better handling of options when running as a shell script
337 - getbootmedium exports compute_key
338 - tweaks for accepted args in GetPCUTypes and BootNotifyOwners
340 * Thu Feb 14 2008 Thierry Parmentelat <thierry.parmentelat@sophia.inria.fr> - PLCAPI-4.2-2 PLCAPI-4.2-3
341 - GetBootMedium support for build.sh full options, incl. serial & console_spec
342 - GetBootMedium simpler, cleaner and safer use of tmpdirs in (dated from bootcustom.sh)
344 * Fri Feb 01 2008 Thierry Parmentelat <thierry.parmentelat@sophia.inria.fr> - PLCAPI-4.2-1 PLCAPI-4.2-2
345 - refresh peer script to use a month-dependent logfile
346 - tracking the starting point for UniPi integration of the dummynet boxes
348 * Thu Jan 31 2008 Thierry Parmentelat <thierry.parmentelat@sophia.inria.fr> - PLCAPI-4.2-0 PLCAPI-4.2-1
349 - plcsh adds its own path to sys.path
350 - fix so GetNodes can be called from a Node
352 * Fri Oct 27 2006 Mark Huang <mlhuang@CS.Princeton.EDU> -
355 %define module_current_branch 4.3