omf_sfa 0.1.1

data/examples/instageni5nodemanifest.rspec

@@ -0,0 +1,150 @@
+<rspec xmlns:flack="http://www.protogeni.net/resources/rspec/ext/flack/1" xmlns:client="http://www.protogeni.net/resources/rspec/ext/client/1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://www.geni.net/resources/rspec/3" type="manifest" generated_by="Flack" generated="2013-05-20T01:22:34Z" xsi:schemaLocation="http://www.geni.net/resources/rspec/3 http://www.geni.net/resources/rspec/3/manifest.xsd " expires="2013-05-26T09:11:32Z">
+  <node xmlns:flack="http://www.protogeni.net/resources/rspec/ext/flack/1" client_id="nodeB" component_manager_id="urn:publicid:IDN+instageni.gpolab.bbn.com+authority+cm" exclusive="false" component_id="urn:publicid:IDN+instageni.gpolab.bbn.com+node+pc1" sliver_id="urn:publicid:IDN+instageni.gpolab.bbn.com+sliver+4538">
+    <sliver_type name="emulab-openvz">
+      <disk_image name="urn:publicid:IDN+instageni.gpolab.bbn.com+image+emulab-net//GIMIomf"/>
+    </sliver_type>
+    <services>
+      <execute command="sudo sh /local/postboot_script.sh" shell="sh"/>
+      <install install_path="/local" url="http://emmy9.casa.umass.edu/InstaGENI_Images/install-script.tar.gz"/>
+    <login authentication="ssh-keys" hostname="pc1.instageni.gpolab.bbn.com" port="30779" username="dbhat"/></services>
+    <interface client_id="VM:if0" component_id="urn:publicid:IDN+instageni.gpolab.bbn.com+interface+pc1:lo0" sliver_id="urn:publicid:IDN+instageni.gpolab.bbn.com+sliver+4545" mac_address="0226ad94606d">
+      <ip address="192.168.4.10" netmask="" type="ipv4"/>
+      <flack:interface_info addressBound="true" bound="false"/>
+    </interface>
+    <interface client_id="VM:if1" component_id="urn:publicid:IDN+instageni.gpolab.bbn.com+interface+pc1:lo0" sliver_id="urn:publicid:IDN+instageni.gpolab.bbn.com+sliver+4547" mac_address="02b197e58375">
+      <ip address="192.168.1.10" netmask="" type="ipv4"/>
+      <flack:interface_info addressBound="true" bound="false"/>
+    </interface>
+    <interface client_id="nodeB:if0" component_id="urn:publicid:IDN+instageni.gpolab.bbn.com+interface+pc1:lo0" sliver_id="urn:publicid:IDN+instageni.gpolab.bbn.com+sliver+4559" mac_address="020cb099b697">
+      <ip address="192.168.2.10" netmask="" type="ipv4"/>
+      <flack:interface_info addressBound="true" bound="false"/>
+    </interface>
+    <flack:node_info x="327" y="67" unbound="true"/>
+  <rs:vnode xmlns:rs="http://www.protogeni.net/resources/rspec/ext/emulab/1" name="pcvm1-3"/><host name="nodeB.dbhatinstageni5.panther.instageni.gpolab.bbn.com"/></node>
+  <node xmlns:flack="http://www.protogeni.net/resources/rspec/ext/flack/1" client_id="nodeA" component_manager_id="urn:publicid:IDN+instageni.gpolab.bbn.com+authority+cm" exclusive="false" component_id="urn:publicid:IDN+instageni.gpolab.bbn.com+node+pc1" sliver_id="urn:publicid:IDN+instageni.gpolab.bbn.com+sliver+4537">
+    <sliver_type name="emulab-openvz">
+      <disk_image name="urn:publicid:IDN+instageni.gpolab.bbn.com+image+emulab-net//GIMIomf"/>
+    </sliver_type>
+    <services>
+      <execute command="sudo sh /local/postboot_script.sh" shell="sh"/>
+      <install install_path="/local" url="http://emmy9.casa.umass.edu/InstaGENI_Images/install-script.tar.gz"/>
+    <login authentication="ssh-keys" hostname="pc1.instageni.gpolab.bbn.com" port="30778" username="dbhat"/></services>
+    <interface client_id="VM-0:if0" component_id="urn:publicid:IDN+instageni.gpolab.bbn.com+interface+pc1:lo0" sliver_id="urn:publicid:IDN+instageni.gpolab.bbn.com+sliver+4544" mac_address="02245bc31345">
+      <ip address="192.168.4.11" netmask="" type="ipv4"/>
+      <flack:interface_info addressBound="true" bound="false"/>
+    </interface>
+    <interface client_id="VM-0:if1" component_id="urn:publicid:IDN+instageni.gpolab.bbn.com+interface+pc1:lo0" sliver_id="urn:publicid:IDN+instageni.gpolab.bbn.com+sliver+4553" mac_address="02b9bd7bb529">
+      <ip address="192.168.5.11" netmask="" type="ipv4"/>
+      <flack:interface_info addressBound="true" bound="false"/>
+    </interface>
+    <flack:node_info x="140" y="164" unbound="true"/>
+  <rs:vnode xmlns:rs="http://www.protogeni.net/resources/rspec/ext/emulab/1" name="pcvm1-1"/><host name="nodeA.dbhatinstageni5.panther.instageni.gpolab.bbn.com"/></node>
+  <node xmlns:flack="http://www.protogeni.net/resources/rspec/ext/flack/1" client_id="nodeD" component_manager_id="urn:publicid:IDN+instageni.gpolab.bbn.com+authority+cm" exclusive="false" component_id="urn:publicid:IDN+instageni.gpolab.bbn.com+node+pc1" sliver_id="urn:publicid:IDN+instageni.gpolab.bbn.com+sliver+4540">
+    <sliver_type name="emulab-openvz">
+      <disk_image name="urn:publicid:IDN+instageni.gpolab.bbn.com+image+emulab-net//GIMIomf"/>
+    </sliver_type>
+    <services>
+      <execute command="sudo sh /local/postboot_script.sh" shell="sh"/>
+      <install install_path="/local" url="http://emmy9.casa.umass.edu/InstaGENI_Images/install-script.tar.gz"/>
+    <login authentication="ssh-keys" hostname="pc1.instageni.gpolab.bbn.com" port="30781" username="dbhat"/></services>
+    <interface client_id="VM-1:if0" component_id="urn:publicid:IDN+instageni.gpolab.bbn.com+interface+pc1:lo0" sliver_id="urn:publicid:IDN+instageni.gpolab.bbn.com+sliver+4548" mac_address="024fd26ba21c">
+      <ip address="192.168.1.13" netmask="" type="ipv4"/>
+      <flack:interface_info addressBound="true" bound="false"/>
+    </interface>
+    <interface client_id="VM-1:if1" component_id="urn:publicid:IDN+instageni.gpolab.bbn.com+interface+pc1:lo0" sliver_id="urn:publicid:IDN+instageni.gpolab.bbn.com+sliver+4550" mac_address="0212bfd4b742">
+      <ip address="192.168.3.13" netmask="" type="ipv4"/>
+      <flack:interface_info addressBound="true" bound="false"/>
+    </interface>
+    <flack:node_info x="564" y="168" unbound="true"/>
+  <rs:vnode xmlns:rs="http://www.protogeni.net/resources/rspec/ext/emulab/1" name="pcvm1-8"/><host name="nodeD.dbhatinstageni5.panther.instageni.gpolab.bbn.com"/></node>
+  <node xmlns:flack="http://www.protogeni.net/resources/rspec/ext/flack/1" client_id="nodeC" component_manager_id="urn:publicid:IDN+instageni.gpolab.bbn.com+authority+cm" exclusive="false" component_id="urn:publicid:IDN+instageni.gpolab.bbn.com+node+pc1" sliver_id="urn:publicid:IDN+instageni.gpolab.bbn.com+sliver+4539">
+    <sliver_type name="emulab-openvz">
+      <disk_image name="urn:publicid:IDN+instageni.gpolab.bbn.com+image+emulab-net//GIMIomf"/>
+    </sliver_type>
+    <services>
+      <execute command="sudo sh /local/postboot_script.sh" shell="sh"/>
+      <install install_path="/local" url="http://emmy9.casa.umass.edu/InstaGENI_Images/install-script.tar.gz"/>
+    <login authentication="ssh-keys" hostname="pc1.instageni.gpolab.bbn.com" port="30780" username="dbhat"/></services>
+    <interface client_id="VM-2:if0" component_id="urn:publicid:IDN+instageni.gpolab.bbn.com+interface+pc1:lo0" sliver_id="urn:publicid:IDN+instageni.gpolab.bbn.com+sliver+4551" mac_address="028d9467cc62">
+      <ip address="192.168.3.12" netmask="" type="ipv4"/>
+      <flack:interface_info addressBound="true" bound="false"/>
+    </interface>
+    <interface client_id="VM-2:if1" component_id="urn:publicid:IDN+instageni.gpolab.bbn.com+interface+pc1:lo0" sliver_id="urn:publicid:IDN+instageni.gpolab.bbn.com+sliver+4554" mac_address="02e9e343d2be">
+      <ip address="192.168.5.12" netmask="" type="ipv4"/>
+      <flack:interface_info addressBound="true" bound="false"/>
+    </interface>
+    <interface client_id="VM-2:if2" component_id="urn:publicid:IDN+instageni.gpolab.bbn.com+interface+pc1:lo0" sliver_id="urn:publicid:IDN+instageni.gpolab.bbn.com+sliver+4556" mac_address="02bc58fc56c1">
+      <ip address="192.168.6.12" netmask="" type="ipv4"/>
+      <flack:interface_info addressBound="true" bound="false"/>
+    </interface>
+    <interface client_id="nodeC:if0" component_id="urn:publicid:IDN+instageni.gpolab.bbn.com+interface+pc1:lo0" sliver_id="urn:publicid:IDN+instageni.gpolab.bbn.com+sliver+4560" mac_address="0248d66a8ce1">
+      <ip address="192.168.2.12" netmask="" type="ipv4"/>
+      <flack:interface_info addressBound="true" bound="false"/>
+    </interface>
+    <flack:node_info x="352" y="252" unbound="true"/>
+  <rs:vnode xmlns:rs="http://www.protogeni.net/resources/rspec/ext/emulab/1" name="pcvm1-6"/><host name="nodeC.dbhatinstageni5.panther.instageni.gpolab.bbn.com"/></node>
+  <node xmlns:flack="http://www.protogeni.net/resources/rspec/ext/flack/1" client_id="nodeE" component_manager_id="urn:publicid:IDN+instageni.gpolab.bbn.com+authority+cm" exclusive="false" component_id="urn:publicid:IDN+instageni.gpolab.bbn.com+node+pc1" sliver_id="urn:publicid:IDN+instageni.gpolab.bbn.com+sliver+4541">
+    <sliver_type name="emulab-openvz">
+      <disk_image name="urn:publicid:IDN+instageni.gpolab.bbn.com+image+emulab-net//GIMIomf"/>
+    </sliver_type>
+    <services>
+      <execute command="sudo sh /local/postboot_script.sh" shell="sh"/>
+      <install install_path="/local" url="http://emmy9.casa.umass.edu/InstaGENI_Images/install-script.tar.gz"/>
+    <login authentication="ssh-keys" hostname="pc1.instageni.gpolab.bbn.com" port="30782" username="dbhat"/></services>
+    <interface client_id="VM-3:if0" component_id="urn:publicid:IDN+instageni.gpolab.bbn.com+interface+pc1:lo0" sliver_id="urn:publicid:IDN+instageni.gpolab.bbn.com+sliver+4557" mac_address="027d3d62dc5d">
+      <ip address="192.168.6.14" netmask="" type="ipv4"/>
+      <flack:interface_info addressBound="true" bound="false"/>
+    </interface>
+    <flack:node_info x="364" y="389" unbound="true"/>
+  <rs:vnode xmlns:rs="http://www.protogeni.net/resources/rspec/ext/emulab/1" name="pcvm1-9"/><host name="nodeE.dbhatinstageni5.panther.instageni.gpolab.bbn.com"/></node>
+  <link xmlns:flack="http://www.protogeni.net/resources/rspec/ext/flack/1" client_id="link0" sliver_id="urn:publicid:IDN+instageni.gpolab.bbn.com+sliver+4543">
+    <component_manager name="urn:publicid:IDN+instageni.gpolab.bbn.com+authority+cm"/>
+    <interface_ref client_id="VM-0:if0" component_id="urn:publicid:IDN+instageni.gpolab.bbn.com+interface+pc1:lo0" sliver_id="urn:publicid:IDN+instageni.gpolab.bbn.com+sliver+4544"/>
+    <interface_ref client_id="VM:if0" component_id="urn:publicid:IDN+instageni.gpolab.bbn.com+interface+pc1:lo0" sliver_id="urn:publicid:IDN+instageni.gpolab.bbn.com+sliver+4545"/>
+    <property source_id="VM-0:if0" dest_id="VM:if0"/>
+    <property source_id="VM:if0" dest_id="VM-0:if0"/>
+    <flack:link_info x="-1" y="-1" unboundVlantag="true"/>
+  </link>
+  <link xmlns:flack="http://www.protogeni.net/resources/rspec/ext/flack/1" client_id="link1" sliver_id="urn:publicid:IDN+instageni.gpolab.bbn.com+sliver+4546">
+    <component_manager name="urn:publicid:IDN+instageni.gpolab.bbn.com+authority+cm"/>
+    <interface_ref client_id="VM:if1" component_id="urn:publicid:IDN+instageni.gpolab.bbn.com+interface+pc1:lo0" sliver_id="urn:publicid:IDN+instageni.gpolab.bbn.com+sliver+4547"/>
+    <interface_ref client_id="VM-1:if0" component_id="urn:publicid:IDN+instageni.gpolab.bbn.com+interface+pc1:lo0" sliver_id="urn:publicid:IDN+instageni.gpolab.bbn.com+sliver+4548"/>
+    <property source_id="VM:if1" dest_id="VM-1:if0"/>
+    <property source_id="VM-1:if0" dest_id="VM:if1"/>
+    <flack:link_info x="-1" y="-1" unboundVlantag="true"/>
+  </link>
+  <link xmlns:flack="http://www.protogeni.net/resources/rspec/ext/flack/1" client_id="link2" sliver_id="urn:publicid:IDN+instageni.gpolab.bbn.com+sliver+4549">
+    <component_manager name="urn:publicid:IDN+instageni.gpolab.bbn.com+authority+cm"/>
+    <interface_ref client_id="VM-1:if1" component_id="urn:publicid:IDN+instageni.gpolab.bbn.com+interface+pc1:lo0" sliver_id="urn:publicid:IDN+instageni.gpolab.bbn.com+sliver+4550"/>
+    <interface_ref client_id="VM-2:if0" component_id="urn:publicid:IDN+instageni.gpolab.bbn.com+interface+pc1:lo0" sliver_id="urn:publicid:IDN+instageni.gpolab.bbn.com+sliver+4551"/>
+    <property source_id="VM-1:if1" dest_id="VM-2:if0"/>
+    <property source_id="VM-2:if0" dest_id="VM-1:if1"/>
+    <flack:link_info x="-1" y="-1" unboundVlantag="true"/>
+  </link>
+  <link xmlns:flack="http://www.protogeni.net/resources/rspec/ext/flack/1" client_id="link3" sliver_id="urn:publicid:IDN+instageni.gpolab.bbn.com+sliver+4552">
+    <component_manager name="urn:publicid:IDN+instageni.gpolab.bbn.com+authority+cm"/>
+    <interface_ref client_id="VM-0:if1" component_id="urn:publicid:IDN+instageni.gpolab.bbn.com+interface+pc1:lo0" sliver_id="urn:publicid:IDN+instageni.gpolab.bbn.com+sliver+4553"/>
+    <interface_ref client_id="VM-2:if1" component_id="urn:publicid:IDN+instageni.gpolab.bbn.com+interface+pc1:lo0" sliver_id="urn:publicid:IDN+instageni.gpolab.bbn.com+sliver+4554"/>
+    <property source_id="VM-0:if1" dest_id="VM-2:if1"/>
+    <property source_id="VM-2:if1" dest_id="VM-0:if1"/>
+    <flack:link_info x="-1" y="-1" unboundVlantag="true"/>
+  </link>
+  <link xmlns:flack="http://www.protogeni.net/resources/rspec/ext/flack/1" client_id="link4" sliver_id="urn:publicid:IDN+instageni.gpolab.bbn.com+sliver+4555">
+    <component_manager name="urn:publicid:IDN+instageni.gpolab.bbn.com+authority+cm"/>
+    <interface_ref client_id="VM-2:if2" component_id="urn:publicid:IDN+instageni.gpolab.bbn.com+interface+pc1:lo0" sliver_id="urn:publicid:IDN+instageni.gpolab.bbn.com+sliver+4556"/>
+    <interface_ref client_id="VM-3:if0" component_id="urn:publicid:IDN+instageni.gpolab.bbn.com+interface+pc1:lo0" sliver_id="urn:publicid:IDN+instageni.gpolab.bbn.com+sliver+4557"/>
+    <property source_id="VM-2:if2" dest_id="VM-3:if0"/>
+    <property source_id="VM-3:if0" dest_id="VM-2:if2"/>
+    <flack:link_info x="-1" y="-1" unboundVlantag="true"/>
+  </link>
+  <link xmlns:flack="http://www.protogeni.net/resources/rspec/ext/flack/1" client_id="link5" sliver_id="urn:publicid:IDN+instageni.gpolab.bbn.com+sliver+4558">
+    <component_manager name="urn:publicid:IDN+instageni.gpolab.bbn.com+authority+cm"/>
+    <interface_ref client_id="nodeB:if0" component_id="urn:publicid:IDN+instageni.gpolab.bbn.com+interface+pc1:lo0" sliver_id="urn:publicid:IDN+instageni.gpolab.bbn.com+sliver+4559"/>
+    <interface_ref client_id="nodeC:if0" component_id="urn:publicid:IDN+instageni.gpolab.bbn.com+interface+pc1:lo0" sliver_id="urn:publicid:IDN+instageni.gpolab.bbn.com+sliver+4560"/>
+    <property source_id="nodeB:if0" dest_id="nodeC:if0"/>
+    <property source_id="nodeC:if0" dest_id="nodeB:if0"/>
+    <flack:link_info x="-1" y="-1" unboundVlantag="true"/>
+  </link>
+  <client:client_info name="Flack" environment="Flash Version: LNX 11,2,202,273, OS: Linux 3.2.0-38-generic-pae, Arch: x86, Screen: 1366x664 @ 72 DPI with touchscreen type none" version="v14.91" url="https://www.emulab.net/protogeni/flack2/flack.swf"/>
+  <flack:slice_info view="graph"/>
+</rspec>

data/lib/omf-sfa/am/am-rest/REST_API.md

@@ -0,0 +1,301 @@
+# CSS: /assets/css/default.css
+
+Objective
+=========
+
+The AM essentially manipulates collections (slivers) of resoruces and their respective properties
+under certain policies.
+
+This document proposes a RESTful alternative to the existing XML-RPC based AM API. A short descripton
+of REST can be found on [Wikipedia](http://en.wikipedia.org/wiki/Representational_state_transfer).
+
+The current proposal does not yet address access control, but hints on how to achieve that are already present.
+
+To get a better understanding of the strength and weaknesses of this API, an experimental implementation has been 
+deployed at http://srv.mytestbed.net:4040 and the (rather messy) implementation is available on the 
+[OMF Repository](http://omf.mytestbed.net/projects/omf/repository/revisions/sfa/show/omf-sfa/ruby/omf-sfa/am/am-rest).
+
+* API
+* Examples
+* Mapping to XML-RPC API
+* Footnotes
+
+API
+===
+
+* `/resources`
+  * GET: List all resources
+  * PUT: Not allowed
+  * POST: Not allowed
+  * DELETE: Not allowed
+
+* `/slivers`
+  * GET: List all sliver
+  * PUT: Not allowed
+  * POST: Not allowed
+  * DELETE: Not allowed
+
+* `/slivers/_sliver_id_`
+  * GET: Status of sliver 
+  * PUT(rspec): Create sliver if not already exist. Apply body to all sub collection
+  * POST(rspec): Modify all sub collections according to +rspec+.
+  * DELETE: Delete sliver
+
+* `/slivers._sliver_id_/resources`
+  * GET: Status of all resources in sliver 
+  * PUT(rspec): Replace all resources in sliver with those described in +rspec+
+  * POST(rspec): Modify resources in collection. See (1), (2)
+  * DELETE: Remove all resources from sliver
+
+* `/slivers/_slice_id_/resources/_resource_id_`
+  * GET: Status of resource
+  * PUT(rspec): Fully reconfigure resource. Not mentioned properties are set to their default value
+  * POST(rspec): Modify names resource properties
+  * DELETE: Delete resource (remove from sliver)
+
+* `/status` (optional)
+  * GET: Status of AM
+
+* `/version`
+  * GET: Information about capabilites of AM implementation
+
+Examples
+========
+
+List all resources
+------------------
+
+    $ curl http://srv.mytestbed.net:4040/resources
+    <?xml version="1.0"?>
+    <resources_response xmlns="http://schema.mytestbed.net/am_rest/0.1" generated="2011-11-27T23:14:58+00:00" about="/resources">
+      <resources href="/slivers/__DEFAULT__/resources">
+        <node id="c-611570898" component_id="urn:publicid:IDN+mytestbed.net+node+r1" component_manager_id="authority+am" component_name="r1" href="/resources/r1">
+          <available now="true"/>
+          <interface_ref component_id="urn:publicid:IDN+mytestbed.net+interface+interface4"/>
+          <interface_ref component_id="urn:publicid:IDN+mytestbed.net+interface+interface6"/>
+          <interface_ref component_id="urn:publicid:IDN+mytestbed.net+interface+interface13"/>
+          <interface_ref component_id="urn:publicid:IDN+mytestbed.net+interface+interface16"/>
+        </node>
+       ...
+
+List status of a single resource
+--------------------------------
+
+    $ curl http://srv.mytestbed.net:4040/resources/r1<?xml version="1.0"?>
+    <resource_response xmlns="http://schema.mytestbed.net/am_rest/0.1" generated="2011-11-27T23:17:26+00:00" about="/resources/r1">
+      <node id="c-610107898" component_id="urn:publicid:IDN+mytestbed.net+node+r1" component_manager_id="authority+am" component_name="r1" href="/resources/r1">
+        <available now="true"/>
+        <interface_ref component_id="urn:publicid:IDN+mytestbed.net+interface+interface4"/>
+        <interface_ref component_id="urn:publicid:IDN+mytestbed.net+interface+interface6"/>
+        <interface_ref component_id="urn:publicid:IDN+mytestbed.net+interface+interface13"/>
+        <interface_ref component_id="urn:publicid:IDN+mytestbed.net+interface+interface16"/>
+      </node>
+    </resource_response>
+
+List all slivers
+----------------
+
+    $ curl http://srv.mytestbed.net:4040/slivers
+    <?xml version="1.0"?>
+    <slivers_response xmlns="http://schema.mytestbed.net/am_rest/0.1" generated="2011-11-27T23:29:07+00:00" about="/slivers">
+      <slivers href="/slivers"/>
+    </slivers_response>
+
+Create a sliver
+---------------
+
+    $ curl -X PUT -d @req1.xml http://srv.mytestbed.net:4040/slivers/foo
+    <?xml version="1.0"?>
+    <sliver_response xmlns="http://schema.mytestbed.net/am_rest/0.1" generated="2011-11-27T23:30:47+00:00" about="/slivers/foo">
+      <sliver href="/foo">
+        <resources href="/slivers/foo/resources"/>
+        <properties>
+          <expires_at>Sun, 27 Nov 2011 23:40:47 +0000</expires_at>
+        </properties>
+        <assertion/>
+        <policies/>
+      </sliver>
+    </sliver_response>
+
+Status of a sliver
+------------------
+
+    $ curl http://srv.mytestbed.net:4040/slivers/foo
+    <?xml version="1.0"?>
+    <sliver_response xmlns="http://schema.mytestbed.net/am_rest/0.1" generated="2011-11-27T23:18:35+00:00" about="/slivers/foo">
+      <sliver href="/foo">
+        <resources href="/slivers/foo/resources"/>
+        <properties>
+          <expires_at>Sun, 27 Nov 2011 23:28:35 +0000</expires_at>
+        </properties>
+        <assertion/>
+        <policies/>
+      </sliver>
+    </sliver_response>
+
+List all resources in a sliver
+------------------------------
+
+    $ curl http://srv.mytestbed.net:4040/slivers/foo/resources
+    <?xml version="1.0"?>
+    <resources_response xmlns="http://schema.mytestbed.net/am_rest/0.1" generated="2011-11-27T23:20:04+00:00" about="/slivers/foo/resources">
+      <resources href="/slivers/foo/resources">
+        <node id="c-610782628" component_id="urn:publicid:IDN+mytestbed.net+node+r0" component_manager_id="authority+am" component_name="r0" href="/slices/foo/resources/r0">
+          <available now="true"/>
+          <interface_ref component_id="urn:publicid:IDN+mytestbed.net+interface+interface0"/>
+          <interface_ref component_id="urn:publicid:IDN+mytestbed.net+interface+interface2"/>
+          <interface_ref component_id="urn:publicid:IDN+mytestbed.net+interface+interface12"/>
+          <interface_ref component_id="urn:publicid:IDN+mytestbed.net+interface+interface14"/>
+        </node>
+        <node id="c-610782828" component_id="urn:publicid:IDN+mytestbed.net+node+c0_0" component_manager_id="authority+am" component_name="c0_0" href="/slices/foo/resources/c0_0">
+          <available now="true"/>
+          <interface_ref component_id="urn:publicid:IDN+mytestbed.net+interface+interface1"/>
+        </node>
+        <link id="c-610790138" component_id="urn:publicid:IDN+mytestbed.net+link+la0_0" component_manager_id="authority+am" component_name="la0_0" href="/slices/foo/resources/la0_0">
+          <interface_ref component_id="urn:publicid:IDN+mytestbed.net+interface+interface0"/>
+          <interface_ref component_id="urn:publicid:IDN+mytestbed.net+interface+interface1"/>
+        </link>
+      </resources>
+    </resources_response>
+
+Modify resources in sliver
+--------------------------
+
+    $ cat req1.xml   (fetch from http://omf.mytestbed.net/projects/omf/repository/revisions/sfa/entry/omf-sfa/test/req1.xml)
+
+    <resources xmlns="http://schema.mytestbed.net/am_rest/0.1">
+      <node component_id="urn:publicid:IDN+mytestbed.net+node+r0">
+        <interface_ref component_id="urn:publicid:IDN+mytestbed.net+interface+interface0"/>
+        <interface_ref component_id="urn:publicid:IDN+mytestbed.net+interface+interface2"/>
+      </node>
+      <node component_id="urn:publicid:IDN+mytestbed.net+node+c0_0">
+        <interface_ref component_id="urn:publicid:IDN+mytestbed.net+interface+interface1"/>
+      </node>
+      ... 
+
+    $ curl -X PUT -d @req1.xml http://srv.mytestbed.net:4040/slivers/foo/resources
+    <?xml version="1.0"?>
+    <resources_response xmlns="http://schema.mytestbed.net/am_rest/0.1" generated="2011-11-27T23:21:42+00:00" about="/slivers/foo/resources">
+      <resources href="/slivers/foo/resources">
+        <node id="c-611144758" component_id="urn:publicid:IDN+mytestbed.net+node+r0" component_manager_id="authority+am" component_name="r0" href="/slices/foo/resources/r0">
+          <available now="true"/>
+          <interface_ref component_id="urn:publicid:IDN+mytestbed.net+interface+interface0"/>
+          <interface_ref component_id="urn:publicid:IDN+mytestbed.net+interface+interface2"/>
+          <interface_ref component_id="urn:publicid:IDN+mytestbed.net+interface+interface12"/>
+          <interface_ref component_id="urn:publicid:IDN+mytestbed.net+interface+interface14"/>
+        </node>
+        <node id="c-611144958" component_id="urn:publicid:IDN+mytestbed.net+node+c0_0" component_manager_id="authority+am" component_name="c0_0" href="/slices/foo/resources/c0_0">
+          <available now="true"/>
+          <interface_ref component_id="urn:publicid:IDN+mytestbed.net+interface+interface1"/>
+        </node>
+        <node id="c-611145158" component_id="urn:publicid:IDN+mytestbed.net+node+c0_1" component_manager_id="authority+am" component_name="c0_1" href="/slices/foo/resources/c0_1">
+          <available now="true"/>
+          <interface_ref component_id="urn:publicid:IDN+mytestbed.net+interface+interface3"/>
+        </node>
+        .....
+
+Delete individual resources
+---------------------------
+
+    $ curl -X DELETE http://srv.mytestbed.net:4040/slivers/foo/resources/r0
+    <?xml version="1.0"?>
+    <resource_response xmlns="http://schema.mytestbed.net/am_rest/0.1" generated="2011-11-27T23:27:27+00:00" about="/slivers/foo/resources/r0"/>
+
+
+Delete Sliver
+-------------
+
+    $ curl -X DELETE http://srv.mytestbed.net:4040/slivers/foo
+    <?xml version="1.0"?>
+    <sliver_response xmlns="http://schema.mytestbed.net/am_rest/0.1" generated="2011-11-27T23:28:10+00:00" about="/slivers/foo"/>
+
+Simply cool
+-----------
+
+<script type="text/javascript" src="http://mbostock.github.com/d3/d3.js?2.6.0s"></script>
+<script type="text/javascript" src="http://mbostock.github.com/d3/d3.geom.js"></script>
+<script type="text/javascript" src="http://mbostock.github.com/d3/d3.layout.js"></script>
+<script type="text/javascript" src="http://documentcloud.github.com/underscore/underscore.js"></script>
+    
+
+<div id="chart"></div>
+<script type="text/javascript" src="assets/network.js"></script>
+
+Mapping to XML-RPC API
+======================
+
+GetVersion
+----------
+
+    GET /version
+
+ListResources
+-------------
+
+    GET /resources
+    GET /resources?compressed
+    GET /resources?available
+
+    GET /slivers/_sliver_id_/resources
+
+CreateSliver
+------------
+
+    PUT /slivers/_sliver_id_
+
+DeleteSliver
+------------
+
+    DELETE /slivers/_sliver_id_
+
+SliverStatus
+------------
+
+    GET /slivers/_sliver_id_
+    GET /slivers/_sliver_id_/resources
+
+RenewSliver
+-----------
+
+Slivers have options (`/slivers/_sliver_id_/options`) and +expires_at+ maybe one of them which can be
+manipulated through a PUT/POST operation. There is always the option to add a 'pseudo' property which
+achieves the same with a simple call (e.g. `PUT /slivers/_sliver_id_/options/renew`).
+
+Shutdown
+--------
+
+As this is adestructive command (there is no 'restart') we could simply delete the sliver.
+
+    DELETE /slivers/_sliver_id_
+
+An alternative is to have something like a +running+ option which can be set to false or, like
+'RenewSliver' we could handle this through a 'pseudo' option (e.g. `PUT /slivers/_sliver_id_/options/shutdown`)
+
+
+Footnotes:
+==========
+
+(1) Managing many resources in a sliver through a single call
+
+    PUT /slices/_slice_id_
+      <resources>
+        <resource href="/slices/_slice_id_/resources/_resource_id_" op="_OP_">
+          ... 
+        </>
+      </>
+
+Conceptually every `<resource>` in the list results in 'redirect' to 
+
+    _OP_ /slices/_slice_id_/resources/_resource_id_
+      <resource>
+          ... 
+      </>
+
+(2) Managing access control or policy properties of slivers and resources
+
+There are two ways. One is to make it part of the PUT or POST body, the other
+one is using Amazon's S3 example and using sub resources `?acl`, `?policy`.
+The latter would more cleanly map onto `/slivers/_sliver_id_/(acls | policies)`
+
+
+

data/lib/omf-sfa/am/am-rest/account_handler.rb

@@ -0,0 +1,145 @@
+
+require 'omf-sfa/am/am-rest/rest_handler'
+require 'omf-sfa/am/am-rest/resource_handler'
+
+#require 'omf-sfa/resource/sliver'
+
+module OMF::SFA::AM::Rest
+
+  # Handles the collection of accounts on this AM.
+  #
+  class AccountHandler < RestHandler
+
+    def initialize(opts = {})
+      super
+      @resource_class = OMF::SFA::Resource::OAccount
+      opts[:account_handler] = self
+      @coll_handlers = {
+        active_components: (opts[:resource_handler] || ResourceHandler.new(opts))
+      }
+    end
+
+    def show_resource_list(opts)
+      authenticator = Thread.current["authenticator"]
+      prefix = about = opts[:req].path
+      resources = OMF::SFA::Resource::OAccount.all()
+      show_resources(resources, :resources, opts)
+    end
+
+    # def find_handler(path, opts)
+      # account_id = opts[:resource_uri] = path.shift
+      # if account_id
+        # account = opts[:account] = find_account(account_id)
+      # end
+      # return self if path.empty?
+#
+      # case comp = path.shift
+      # when 'resources'
+        # opts[:resource_uri] = path.join('/')
+        # #puts "RESOURCE >>> '#{r}'::#{account.inspect}"
+        # return @res_handler
+      # end
+      # raise UnknownResourceException.new "Unknown sub collection '#{comp}' for account '#{account_id}'."
+    # end
+#
+    # def on_get(account_uri, opts)
+      # debug 'get: account_uri: "', account_uri, '"'
+      # if account_uri
+        # account = opts[:account]
+        # show_account_status(account, opts)
+      # else
+        # show_accounts(opts)
+      # end
+    # end
+#
+    # # def on_put(account_uri, opts)
+      # # account = opts[:account] = OMF::SFA::Resource::Sliver.first_or_create(:name => opts[:account_id])
+      # # configure_sliver(sliver, opts)
+      # # show_sliver_status(sliver, opts)
+    # # end
+#
+    # def on_delete(account_uri, opts)
+      # account = opts[:account]
+      # @am_manager.delete_account(account)
+#
+      # show_account_status(nil, opts)
+    # end
+#
+    # # SUPPORTING FUNCTIONS
+#
+    # def show_account_status(account, opts)
+      # if account
+        # p = opts[:req].path.split('/')[0 .. -2]
+        # p << account.uuid.to_s
+        # prefix = about = p.join('/')
+        # res = {
+          # :about => about,
+          # :type => 'account',
+          # :properties => {
+              # #:href => prefix + '/properties',
+              # :expires_at => (Time.now + 600).rfc2822
+          # },
+          # :resources => {:href => prefix + '/resources'},
+          # :policies => {:href => prefix + '/policies'},
+          # :assertion => {:href => prefix + '/assertion'}
+        # }
+      # else
+        # res = {:error => 'Unknown account'}
+      # end
+#
+      # ['application/json', JSON.pretty_generate({:account_response => res})]
+    # end
+#
+    # def show_accounts(opts)
+      # authenticator = Thread.current["authenticator"]
+      # prefix = about = opts[:req].path
+      # accounts = @am_manager.find_all_accounts(authenticator).collect do |a|
+        # {
+          # :name => a.name,
+          # :urn => a.urn,
+          # :uuid => uuid = a.uuid.to_s,
+          # :href => prefix + '/' + uuid
+        # }
+      # end
+      # res = {
+        # :about => opts[:req].path,
+        # :accounts => accounts
+      # }
+#
+      # ['application/json', JSON.pretty_generate({:accounts_response => res})]
+    # end
+#
+    # # Configure the state of +account+ according to information
+    # # in the http +req+.
+    # #
+    # # Note: It doesn't actually modify the account directly, but parses the
+    # # the body and delegates the individual entries to the relevant
+    # # sub collections, like 'resources', 'policies', ...
+    # #
+    # def configure_account(account, opts)
+      # doc, format = parse_body(opts)
+      # case format
+      # when :xml
+        # doc.xpath("//r:resources", 'r' => 'http://schema.mytestbed.net/am_rest/0.1').each do |rel|
+          # @res_handler.put_components_xml(rel, opts)
+        # end
+      # else
+        # raise BadRequestException.new "Unsupported message format '#{format}'"
+      # end
+    # end
+#
+    # def find_account(account_id)
+      # if account_id.start_with?('urn')
+        # fopts = {:urn => account_id}
+      # else
+        # begin
+          # fopts = {:uuid => UUIDTools::UUID.parse(account_id)}
+        # rescue ArgumentError
+          # fopts = {:name => account_id}
+        # end
+      # end
+      # authenticator = Thread.current["authenticator"]
+      # account = @am_manager.find_account(fopts, authenticator)
+    # end
+  end
+end