deltacloud-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From mar...@apache.org
Subject svn commit: r1353588 [17/23] - in /deltacloud/trunk/site: ./ content/ content/Scripts/ content/assets/ content/assets/css/ content/assets/img/ content/assets/img/documentation_files/ content/assets/js/ content/assets/less/ content/css/ content/css/blue...
Date Mon, 25 Jun 2012 15:05:57 GMT
Added: deltacloud/trunk/site/output/blob-storage.html
URL: http://svn.apache.org/viewvc/deltacloud/trunk/site/output/blob-storage.html?rev=1353588&view=auto
==============================================================================
--- deltacloud/trunk/site/output/blob-storage.html (added)
+++ deltacloud/trunk/site/output/blob-storage.html Mon Jun 25 15:05:02 2012
@@ -0,0 +1,600 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8">
+    <title>Blob storage</title>
+    <!-- Le HTML5 shim, for IE6-8 support of HTML elements -->
+    <!--[if lt IE 9]>
+    <script src="http://html5shim.googlecode.com/svn/trunk/html5.js"></script>
+    <![endif]-->
+
+    <!-- Le JavaScript -->
+    <script src="/assets/js/jquery-1.7.1.min.js" type="text/javascript"></script>
+    <script src="/assets/js/bootstrap-dropdown.js" type="text/javascript"></script>
+    <script src="/assets/js/jquery.tweet.js" type="text/javascript"></script>
+    <script src="/assets/js/application.js" type="text/javascript"></script>
+    <script src="/assets/js/bootstrap-transition.js"></script>
+    <script src="/assets/js/bootstrap-alert.js"></script>
+    <script src="/assets/js/bootstrap-modal.js"></script>
+    <script src="/assets/js/bootstrap-scrollspy.js"></script>
+    <script src="/assets/js/bootstrap-tab.js"></script>
+    <script src="/assets/js/bootstrap-tooltip.js"></script>
+    <script src="/assets/js/bootstrap-popover.js"></script>
+    <script src="/assets/js/bootstrap-button.js"></script>
+    <script src="/assets/js/bootstrap-collapse.js"></script>
+    <script src="/assets/js/bootstrap-carousel.js"></script>
+    <script src="/assets/js/bootstrap-typeahead.js"></script>
+
+    <!-- Le styles -->
+    <link href="/assets/css/bootstrap.css" rel="stylesheet">
+    <link href="/assets/css/application.css" rel="stylesheet">
+    <link rel="shortcut icon" href="/assets/img/favicon.ico">
+  </head>
+
+  <body>
+
+    <div class="navbar navbar-fixed-top">
+      <div class="navbar-inner">
+        <div class="container">
+          <a class="brand" href="/"><img src="/assets/img/logo.png" width="152"
+            alt="Deltacloud API"/></a>
+          <ul class="nav top-nav">
+  <li><a href="/">Home</a></li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">About<b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/about.html">What is Deltacloud?</a></li>
+      <li><a href="/supported-providers.html">Supported Providers</a></li>
+    </ul>
+  </li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">Installation<b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/install-deltacloud.html">Install Deltacloud</a></li>
+      <li><a href="/run-deltacloud-server.html">Run the Deltacloud Server</a></li>
+    </ul>
+  </li>
+  <li class="dropdown">
+    <a href="/usage.html" class="dropdown-toggle" data-toggle="dropdown">Usage<b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/usage.html#usingapi">Using API</a></li>
+      <li><a href="/usage.html#clients">Client Libraries</a></li>
+      <li><a href="/command-tools.html">Command Line Tools</a></li>
+    </ul>
+  </li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">Contribute<b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/getting-sources.html">Getting Sources</a></li>
+      <li><a href="/how-to-contribute.html">How Can I Contribute?</a></li>
+    </ul>
+  </li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">API<b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/rest-api.html">REST API</a></li>
+      <li><a href="/drivers.html">Drivers API</a></li>
+    </ul>
+  </li>
+  <li><a href="/contact.html">Contact</a></li>
+</ul>
+
+        </div>
+      </div>
+
+    </div>
+
+    <div class="container content">
+
+      <p><br></p>
+
+<div class="row">
+  <div class="span9">
+
+<h3 id="blob">Blob Storage</h3>
+
+<p>
+Blob storage represents a generic key ==&gt; value data store. It is implemented by Amazon S3 or Rackspace Cloudfiles. In Deltacloud, the organisational unit of blob storage is a bucket. Individual data items - blobs are exposed as a subcollection under each bucket.
+</p>
+
+<p>
+A bucket has
+</p>
+
+<ul>
+<li>a <strong>name</strong>;</li>
+  <li>a <strong>size</strong> (denotes the number of blobs it contains); and</li>
+  <li>a list of <strong>links to each blob</strong>.</li>
+</ul>
+<p>
+A blob has:
+</p>
+
+  </div>
+  <div class="span3">
+
+<ul class="nav nav-list well">
+<li class="nav-header">
+    REST API
+  </li>
+  <li><a href="rest-api.html">Introduction</a></li>
+  <li><a href="api-entry-point.html">API entry point</a></li>
+  <li><a href="compute-resources.html">Compute resources</a></li>
+  <li><a href="storage-resources.html">Storage resources</a></li>
+  <ul class="nav nav-list">
+<li><a href="storage-resources.html#volumes">Storage volumes</a></li>
+    <li><a href="storage-snapshots.html">Storage snaphots</a></li>
+    <li class="active"><a href="#blob">Blob storage</a></li>
+  </ul>
+</ul>
+</div>
+</div>
+
+<ul>
+<li>a <strong>content_length</strong>;</li>
+  <li>a <strong>content_type</strong>;</li>
+  <li>a <strong>last_modified</strong> timestamp;</li>
+  <li>a structure containing <strong>user_metadata</strong>;</li>
+  <li>a link to the blob <strong>content</strong>; and</li>
+  <li>a name of the bucket in which this blob exists.</li>
+</ul><p><br></p>
+
+<div class="tabbable">
+
+<ul class="nav nav-pills">
+<li class="active"><a href="#tab1" data-toggle="tab">Get a list of all buckets</a></li>
+  <li><a href="#tab2" data-toggle="tab">Get the details of a bucket</a></li>
+  <li><a href="#tab3" data-toggle="tab">Create/delete a bucket</a></li>
+  <li><a href="#tab4" data-toggle="tab">Get the details of a blob</a></li>
+  <li><a href="#tab5" data-toggle="tab">Create/delete a blob</a></li>
+  <li>   </li>
+  <li><a href="#tab6" data-toggle="tab">Get/update blob metadata</a></li>
+</ul>
+<hr>
+<div class="tab-content">
+  <div class="tab-pane tab-fade active" id="tab1">
+
+<h4>Get a list of all buckets</h4>
+
+<p>
+To return a list of all buckets belonging to the given cloud provider account use call <strong>GET /api/buckets</strong>. The response from the Deltacloud server includes the name and URI of each bucket but not the size or the list of blobs which the bucket contains. These details are available when a client requests (GETs) a specific bucket.
+</p>
+
+<p>Example request:</p>
+
+<pre>
+GET /api/buckets?format=xml HTTP/1.1
+Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
+User-Agent: curl/7.20.1
+Host: localhost:3001
+Accept: */*
+</pre>
+
+<p>Server response:</p>
+
+<pre>
+HTTP/1.1 200 OK
+Content-Type: application/xml
+Content-Length: 597
+&lt;?xml version='1.0' encoding='utf-8' ?&gt;
+&lt;buckets&gt;
+  &lt;bucket href='http://localhost:3001/api/buckets/mybucket1' id='mybucket1'&gt;
+    &lt;name&gt;mybucket1&lt;/name&gt;
+    &lt;size&gt;&lt;/size&gt;
+  &lt;/bucket&gt;
+  &lt;bucket href='http://localhost:3001/api/buckets/mybucket2' id='mybucket2'&gt;
+    &lt;name&gt;mybucket2&lt;/name&gt;
+    &lt;size&gt;&lt;/size&gt;
+  &lt;/bucket&gt;
+  &lt;bucket href='http://localhost:3001/api/buckets/mybucket3' id='mybucket3'&gt;
+    &lt;name&gt;mybucket3&lt;/name&gt;
+    &lt;size&gt;&lt;/size&gt;
+  &lt;/bucket&gt;
+  &lt;bucket href='http://localhost:3001/api/buckets/mybucket4' id='mybucket4'&gt;
+    &lt;name&gt;mybucket4&lt;/name&gt;
+    &lt;size&gt;&lt;/size&gt;
+  &lt;/bucket&gt;
+&lt;/buckets&gt;
+</pre>
+
+  </div>
+  <div class="tab-pane tab-fade" id="tab2">
+
+<h4>Get the details of a specific bucket</h4>
+
+<p>
+To return details of a specific bucket use call <strong>GET /api/buckets/:id</strong>. The Deltacloud server response includes the size of the bucket and the URI for each blob object that it contains.
+</p>
+
+<p>Example request:</p>
+
+<pre>
+GET /api/buckets/mybucket1?format=xml HTTP/1.1
+Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
+User-Agent: curl/7.20.1
+Host: localhost:3001
+Accept: */*
+</pre>
+
+<p>Server response:</p>
+
+<pre>
+HTTP/1.1 200 OK
+Content-Type: application/xml
+Content-Length: 534
+&lt;?xml version='1.0' encoding='utf-8' ?&gt;
+&lt;bucket href='http://localhost:3001/api/buckets/mybucket1' id='mybucket1'&gt;
+  &lt;name&gt;mybucket1&lt;/name&gt;
+  &lt;size&gt;4&lt;/size&gt;
+  &lt;blob href='http://localhost:3001/api/buckets/mybucket1/myfile' id='myfile'&gt;&lt;/blob&gt;
+  &lt;blob href='http://localhost:3001/api/buckets/mybucket1/an_object' id='an_object'&gt;&lt;/blob&gt;
+  &lt;blob href='http://localhost:3001/api/buckets/mybucket1/picture_blob' id='picture_blob'&gt;&lt;/blob&gt;
+  &lt;blob href='http://localhost:3001/api/buckets/mybucket1/some_blob id='some_blob'&gt;&lt;/blob&gt;
+&lt;/bucket&gt;
+</pre>
+
+  </div>
+  <div class="tab-pane tab-fade" id="tab3">
+
+<h4>Create a new bucket</h4>
+
+<p>
+To create a new bucket use call <strong>POST /api/buckets</strong>. You need to specify the name as a parameter. Optionally for Amazon S3 buckets, you can specify a bucket location with the location parameter, as per <a href="http://docs.amazonwebservices.com/general/latest/gr/index.html?rande.html">Regions and Endpoints for Amazon Simple Storage Service</a>. Valid values for S3 bucket location parameter are: "us-west-1", "EU", "ap-southeast-1", "ap-northeast-1" (while not specifying a location default to the "US Standard" region). Note that clients may specify parameters as multipart/form-data or using a content-type of application/x-www-form-urlencoded.
+</p>
+
+<p>
+On succesful creation this call will return a 201 HTTP status, specifying the URI of the newly created bucket in the <strong>Location</strong> header and the newly created bucket object in the response message body. The example request below shows how to create a new bucket in the EU (Ireland) region. If the given back-end cloud does not support locations then the location parameter is ignored.
+</p>
+
+<p>Example request:</p>
+
+<pre>
+POST /api/buckets?format=xml HTTP/1.1
+Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
+User-Agent: curl/7.20.1
+Host: localhost:3001
+Accept: */*
+Content-Length: 31
+Content-Type: application/x-www-form-urlencoded
+
+name=mybucketeurope&amp;location=EU
+</pre>
+
+<p>Server response:</p>
+
+<pre>
+HTTP/1.1 201 Created
+Location: http://localhost:3001/api/buckets/mybucketeurope
+Content-Type: application/xml
+Content-Length: 182
+
+&lt;?xml version='1.0' encoding='utf-8' ?&gt;
+&lt;bucket href='http://localhost:3001/api/buckets/mybucketeurope' id='mybucketeurope'&gt;
+  &lt;name&gt;mybucketeurope&lt;/name&gt;
+  &lt;size&gt;0&lt;/size&gt;
+&lt;/bucket&gt;
+</pre>
+
+<h4>Delete a bucket</h4>
+
+<p>
+To delete the specified bucket use call <strong>DELETE /api/buckets/:id</strong>. The bucket must be empty (otherwise the call will fail with an error response). A succesful operation will return <strong>204 No Content</strong>.
+</p>
+
+<p>Example request:</p>
+
+<pre>
+DELETE /api/buckets/mybucketeurope?format=xml HTTP/1.1
+Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
+User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
+Host: localhost:3001
+Accept: */*
+</pre>
+
+<p>Server response:</p>
+
+<pre>
+HTTP/1.1 204 No Content
+</pre>
+
+  </div>
+  <div class="tab-pane tab-fade" id="tab4">
+
+<h4>Get the details of a blob</h4>
+
+<p>
+To retrieve the details of a specific blob use call <strong>GET /api/buckets/:bucket_id/:blob_id</strong>. The blob content is not returned as part of the response but rather a URI is given from which the content may be retrieved as shown below.
+</p>
+
+<p>Example request:</p>
+
+<pre>
+GET /api/buckets/mariosbucket1/some_more_blob_woo?format=xml HTTP/1.1
+Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
+User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
+Host: localhost:3001
+Accept: */*
+</pre>
+
+<p>Server response:</p>
+
+<pre>
+HTTP/1.1 200 OK
+Content-Type: application/xml
+Content-Length: 586
+&lt;?xml version='1.0' encoding='utf-8' ?&gt;
+&lt;blob href='http://localhost:3001/api/buckets/mariosbucket1/some_more_blob_woo' id='some_more_blob_woo'&gt;
+  &lt;bucket&gt;mariosbucket1&lt;/bucket&gt;
+  &lt;content_length&gt;86&lt;/content_length&gt;
+  &lt;content_type&gt;text/plain&lt;/content_type&gt;
+  &lt;last_modified&gt;Fri Jan 28 12:23:08 UTC 2011&lt;/last_modified&gt;
+  &lt;user_metadata&gt;
+    &lt;entry key='v'&gt;
+      &lt;![CDATA[0.2.0]]&gt;
+    &lt;/entry&gt;
+    &lt;entry key='test'&gt;
+      &lt;![CDATA[value]]&gt;
+    &lt;/entry&gt;
+  &lt;/user_metadata&gt;
+  &lt;content href='http://localhost:3001/api/buckets/mariosbucket1/some_more_blob_woo/content'&gt;&lt;/content&gt;
+&lt;/blob&gt;
+</pre>
+
+<h4>Get the actual blob content</h4>
+
+<p>
+To retrieve the actual blob content use call <strong>GET /api/buckets/:bucket_id/:blob_id/content</strong>. The location of blob content is specified in the content URI returned from the <strong>GET /api/buckets/:bucket_id/:blob_id</strong> call. The content is streamed through the Deltacloud server as soon as it is received from the back-end cloud provider. The aim is to avoid the creation of a temporary file (especially significant in case of large blobs). The Deltacloud server sets <strong>Content-Disposition: attachment; filename=blob_name</strong> in the HTTP response headers.
+</p>
+
+<p>
+Example request:
+</p>
+
+<pre>
+GET /api/buckets/mariosanotherbucketohyeah/Im_a_blob_beholdme/content?format=xml HTTP/1.1
+Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
+User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
+Host: localhost:3001
+Accept: */*
+</pre>
+
+<p>
+Server response:
+</p>
+
+<pre>
+HTTP/1.1 200 OK
+Content-Disposition: attachment; filename=Im_a_blob_beholdme
+Content-Type: text/plain
+Content-Length: 50
+
+&lt;BLOB DATA HERE&gt;
+</pre>
+
+  </div>
+  <div class="tab-pane tab-fade" id="tab5">
+
+<h4>Create a blob object</h4>
+
+<p>
+To create a blob object and set its content use call <strong>PUT /api/buckets/:bucket_id/:blob_id</strong>. If the blob already exists then its data and metadata are overwritten with those specified in this call. The request must specify the name of the blob and the name of the bucket in which the blob is to be placed in the call URI. The client must also specify the <strong>content_length</strong> of the blob data and the <strong>blob data</strong> itself in the HTTP headers. Optionally the call may also specify a <strong>content_type</strong> and any number of <strong>key:value</strong> pairs of user defined metadata. User metadata is defined using 'X-Deltacloud-Blobmeta-' header, e.g. X-Deltacloud-Blobmeta-Version:2.1.
+</p>
+
+<p>
+To eliminate the necessity of creating a local file at the Deltacloud server for each blob created, the Deltacloud server starts to stream the blob data to the back-end cloud provider as soon as the request headers are processed. A succesful operation will return the newly created blob object, as shown below.
+</p>
+
+<p>Example request:</p>
+
+<pre>
+PUT /api/buckets/mybucket/12Jul2011blob?format=xml HTTP/1.1
+Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
+Content-Type: text/plain
+Content-Length: 128988
+X-Deltacloud-Blobmeta-Version:2.1
+X-Deltacloud-Blobmeta-Author:msa
+
+... BLOB DATA ...
+</pre>
+
+<p>Server response:</p>
+
+<pre>
+&lt;?xml version='1.0' encoding='utf-8' ?&gt;
+&lt;blob href='http://localhost:3001/api/buckets/mybucket/12Jul2011blob' id='12Jul2011blob'&gt;
+  &lt;bucket&gt;mybucket&lt;/bucket&gt;
+  &lt;content_length&gt;128988&lt;/content_length&gt;
+  &lt;content_type&gt;text/plain&lt;/content_type&gt;
+  &lt;last_modified&gt;Wed Jul 13 13:27:22 UTC 2011&lt;/last_modified&gt;
+  &lt;user_metadata&gt;
+    &lt;entry key='author'&gt;
+      &lt;![CDATA[msa]]&gt;
+    &lt;/entry&gt;
+    &lt;entry key='version'&gt;
+      &lt;![CDATA[2.1]]&gt;
+    &lt;/entry&gt;
+  &lt;/user_metadata&gt;
+  &lt;content href='http://localhost:3001/api/buckets/mybucket/12Jul2011blob/content'&gt;
+  &lt;/content&gt;
+&lt;/blob&gt;
+</pre>
+
+<p>
+The Deltacloud server also responds to an alternative <strong>POST /api/buckets/:bucket_id</strong> route for creating or updating a blob object. As with the <strong>PUT</strong> method for creating/updating a blob, the client must specify the <strong>bucket</strong> in which the blob is to be created through the call URI (i.e. you <strong>POST</strong> to the specified bucket). The rest of the required fields, that is, the <strong>name</strong> of the blob, the <strong>blob_data</strong> and the <strong>content-length</strong> are specified by the client as <strong>multipart/form-data</strong> (i.e. in <strong>HTTP POST</strong> form fields).
+</p>
+
+<p>
+In order to specify the optional user metadata for a given blob the client must set the form field <strong>meta_params</strong> to specify the number of metadata key/value pairs. The metadata itself is then specified by the client with fields of the form <strong>meta_nameN</strong> and <strong>meta_valueN</strong> where N is an integer from 1 up to the number specified by the <strong>meta_params</strong> field (e.g. meta_name1=author, meta_value1=jrd).
+</p>
+
+<p>
+It should be noted that the <strong>POST</strong> method for creating a blob is non streaming - the Deltacloud server will create a temporary file with the blob data, before the file is transferred to the backend cloud. Thus, it should only be used for blobs with a relatively small content-length and in general the <strong>PUT</strong> method should be preferred for larger blobs. This <strong>POST</strong> method is mainly provided for clients that cannot easily invoke a <strong>HTTP PUT</strong> operation (e.g. web browsers) and can be used for creating/updating a blob through the deltacloud HTML interface (provided for testing purposes).
+</p>
+
+<p>Example request:</p>
+
+<pre>
+POST /api/buckets/mybucket?format=xml HTTP/1.1
+Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
+User-Agent: curl/7.20.1 (i386-redhat-linux-gnu) libcurl/7.20.1 N
+Accept: */*
+Content-Length: 113582
+Expect: 100-continue
+Content-Type: multipart/form-data; boundary=----------------------------517f5f2df858
+
+------------------------------517f5f2df858
+Content-Disposition: form-data; name="blob"
+
+12Jul2011blob
+------------------------------517f5f2df858
+Content-Disposition: form-data; name="blob_data"; filename="small.txt"
+Content-Type: text/plain
+
+&lt;THE_BLOB_DATA_HERE&gt;
+
+------------------------------517f5f2df858
+Content-Disposition: form-data; name="meta_params"
+
+2
+------------------------------517f5f2df858
+Content-Disposition: form-data; name="meta_name1"
+
+author
+------------------------------517f5f2df858
+Content-Disposition: form-data; name="meta_value1"
+jjs
+------------------------------517f5f2df858
+Content-Disposition: form-data; name="meta_name2"
+
+version
+------------------------------517f5f2df858
+Content-Disposition: form-data; name="meta_value2"
+
+2.2
+------------------------------517f5f2df858--
+</pre>
+
+<p>Server response:</p>
+
+<pre>
+&lt;?xml version='1.0' encoding='utf-8' ?&gt;
+&lt;blob href='http://localhost:3001/api/buckets/mybucket/12Jul2011blob' id='12Jul2011blob'&gt;
+  &lt;bucket&gt;mybucket&lt;/bucket&gt;
+  &lt;content_length&gt;112766&lt;/content_length&gt;
+  &lt;content_type&gt;text/plain&lt;/content_type&gt;
+  &lt;last_modified&gt;&lt;/last_modified&gt;
+  &lt;user_metadata&gt;
+    &lt;entry key='x-amz-meta-author'&gt;
+      &lt;![CDATA[jjs]]&gt;
+    &lt;/entry&gt;
+    &lt;entry key='x-amz-meta-version'&gt;
+      &lt;![CDATA[2.2]]&gt;
+    &lt;/entry&gt;
+  &lt;/user_metadata&gt;
+  &lt;content href='http://localhost:3001/api/buckets/mybucket/12Jul2011blob/content'&gt;
+  &lt;/content&gt;
+&lt;/blob&gt;
+</pre>
+
+<h4>Delete a blob object</h4>
+
+<p>
+To delete the specified blob object from the back-end cloud use call <strong>DELETE /api/buckets/:bucket_id/:blob_id</strong>. The names of the blob and the bucket in which this exists are specified the in call URI. After a succesful operation the Deltacloud server responds with a <strong>HTTP 204</strong> (No Content) with no message body.
+</p>
+
+<p>Example request:</p>
+
+<pre>
+DELETE /api/buckets/mybucket/12Jul2011blob?format=xml HTTP/1.1
+Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
+User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
+Host: localhost:3001
+Accept: */*
+</pre>
+
+<p>Server response:</p>
+
+<pre>
+HTTP/1.1 204 No Content
+Connection: close
+Server: thin 1.2.11
+</pre>
+
+  </div>
+  <div class="tab-pane tab-fade" id="tab6">
+
+<h4>Get all metadata fields</h4>
+
+<p>
+To return all user defined metadata fields on a specified blob URI use the HTTP HEAD operation <strong>HEAD /api/buckets/:bucket_id/:blob_id</strong>. As per <a href="http://www.ietf.org/rfc/rfc2616.txt">RFC 2616</a> this <strong>HEAD</strong> operation does not return a message body. Rather, the blob user metadata values are returned in the response X-Deltacloud-Blobmeta- headers (e.g., X-Deltacloud-Blobmeta-version:1.2).
+</p>
+
+<p>Example request:</p>
+
+<pre>
+HEAD /api/buckets/mybucket/myblob?format=xml HTTP/1.1
+Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
+User-Agent: curl/7.20.1
+Host: localhost:3001
+Accept: */*
+</pre>
+
+<p>Server response:</p>
+
+<pre>
+HTTP/1.1 204 No Content
+X-Deltacloud-Blobmeta-version: 1.21
+X-Deltacloud-Blobmeta-author: jrd
+</pre>
+
+<h4>Update the user-defined blob metadata</h4>
+
+<p>
+To update the user-defined blob metadata use call <strong>POST /api/buckets/:bucket_id/:blob_id</strong> on the URI of a blob. This operation will overwrite all previously set user-metadata values (if any) and replace them with those specified in this call. The client must set the user-defined metadata in the X-Deltacloud-Blobmeta- headers (e.g., X-Deltacloud-Blobmeta-Model:2012).
+</p>
+
+<p>Example request:</p>
+
+<pre>
+POST /api/buckets/mybucket/myblob?format=xml HTTP/1.1
+Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
+User-Agent: curl/7.20.1
+Host: localhost:3001
+Accept: */*
+X-Deltacloud-Blobmeta-model: 2012
+X-Deltacloud-Blobmeta-paint: Stannite_Grey
+</pre>
+
+<p>Server response:</p>
+
+<pre>
+HTTP/1.1 204 No Content
+X-Deltacloud-Blobmeta-model: 2012
+X-Deltacloud-Blobmeta-paint: Stannite_Grey
+</pre>
+
+</div>
+</div>
+</div>
+
+      <footer class="footer">
+        <p class="pull-right"><span class='icon-circle-arrow-up'>&nbsp;</span><a href="#">Back to top</a></p>
+        <div class='row'>
+          <div class='span3'>
+            <img src="/assets/img/asf.png" alt="Apache Software Foundation"/>
+          </div>
+          <div class='span9'>
+            <strong>Apache Deltacloud</strong> is a top-level project at the <a
+              href="http://www.apache.org">Apache Software Foundation</a>,
+            having graduated from the ASF Incubator in October
+            2011. Through a collaborative and meritocratic development process, Apache
+            projects deliver enterprise-grade, freely available software products that
+            attract large communities of users. 
+          </div>
+        </div>
+      </footer>
+
+    </div> <!-- /container -->
+
+  </body>
+</html>

Added: deltacloud/trunk/site/output/clients.html
URL: http://svn.apache.org/viewvc/deltacloud/trunk/site/output/clients.html?rev=1353588&view=auto
==============================================================================
--- deltacloud/trunk/site/output/clients.html (added)
+++ deltacloud/trunk/site/output/clients.html Mon Jun 25 15:05:02 2012
@@ -0,0 +1,111 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8">
+    <title>Clients</title>
+    <!-- Le HTML5 shim, for IE6-8 support of HTML elements -->
+    <!--[if lt IE 9]>
+    <script src="http://html5shim.googlecode.com/svn/trunk/html5.js"></script>
+    <![endif]-->
+
+    <!-- Le JavaScript -->
+    <script src="/assets/js/jquery-1.7.1.min.js" type="text/javascript"></script>
+    <script src="/assets/js/bootstrap-dropdown.js" type="text/javascript"></script>
+    <script src="/assets/js/jquery.tweet.js" type="text/javascript"></script>
+    <script src="/assets/js/application.js" type="text/javascript"></script>
+    <script src="/assets/js/bootstrap-transition.js"></script>
+    <script src="/assets/js/bootstrap-alert.js"></script>
+    <script src="/assets/js/bootstrap-modal.js"></script>
+    <script src="/assets/js/bootstrap-scrollspy.js"></script>
+    <script src="/assets/js/bootstrap-tab.js"></script>
+    <script src="/assets/js/bootstrap-tooltip.js"></script>
+    <script src="/assets/js/bootstrap-popover.js"></script>
+    <script src="/assets/js/bootstrap-button.js"></script>
+    <script src="/assets/js/bootstrap-collapse.js"></script>
+    <script src="/assets/js/bootstrap-carousel.js"></script>
+    <script src="/assets/js/bootstrap-typeahead.js"></script>
+
+    <!-- Le styles -->
+    <link href="/assets/css/bootstrap.css" rel="stylesheet">
+    <link href="/assets/css/application.css" rel="stylesheet">
+    <link rel="shortcut icon" href="/assets/img/favicon.ico">
+  </head>
+
+  <body>
+
+    <div class="navbar navbar-fixed-top">
+      <div class="navbar-inner">
+        <div class="container">
+          <a class="brand" href="/"><img src="/assets/img/logo.png" width="152"
+            alt="Deltacloud API"/></a>
+          <ul class="nav top-nav">
+  <li><a href="/">Home</a></li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">About<b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/about.html">What is Deltacloud?</a></li>
+      <li><a href="/supported-providers.html">Supported Providers</a></li>
+    </ul>
+  </li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">Installation<b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/install-deltacloud.html">Install Deltacloud</a></li>
+      <li><a href="/run-deltacloud-server.html">Run the Deltacloud Server</a></li>
+    </ul>
+  </li>
+  <li class="dropdown">
+    <a href="/usage.html" class="dropdown-toggle" data-toggle="dropdown">Usage<b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/usage.html#usingapi">Using API</a></li>
+      <li><a href="/usage.html#clients">Client Libraries</a></li>
+      <li><a href="/command-tools.html">Command Line Tools</a></li>
+    </ul>
+  </li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">Contribute<b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/getting-sources.html">Getting Sources</a></li>
+      <li><a href="/how-to-contribute.html">How Can I Contribute?</a></li>
+    </ul>
+  </li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">API<b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/rest-api.html">REST API</a></li>
+      <li><a href="/drivers.html">Drivers API</a></li>
+    </ul>
+  </li>
+  <li><a href="/contact.html">Contact</a></li>
+</ul>
+
+        </div>
+      </div>
+
+    </div>
+
+    <div class="container content">
+
+      
+
+      <footer class="footer">
+        <p class="pull-right"><span class='icon-circle-arrow-up'>&nbsp;</span><a href="#">Back to top</a></p>
+        <div class='row'>
+          <div class='span3'>
+            <img src="/assets/img/asf.png" alt="Apache Software Foundation"/>
+          </div>
+          <div class='span9'>
+            <strong>Apache Deltacloud</strong> is a top-level project at the <a
+              href="http://www.apache.org">Apache Software Foundation</a>,
+            having graduated from the ASF Incubator in October
+            2011. Through a collaborative and meritocratic development process, Apache
+            projects deliver enterprise-grade, freely available software products that
+            attract large communities of users. 
+          </div>
+        </div>
+      </footer>
+
+    </div> <!-- /container -->
+
+  </body>
+</html>

Added: deltacloud/trunk/site/output/clients/index.html
URL: http://svn.apache.org/viewvc/deltacloud/trunk/site/output/clients/index.html?rev=1353588&view=auto
==============================================================================
--- deltacloud/trunk/site/output/clients/index.html (added)
+++ deltacloud/trunk/site/output/clients/index.html Mon Jun 25 15:05:02 2012
@@ -0,0 +1,96 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8">
+    <title>Clients</title>
+    <!-- Le HTML5 shim, for IE6-8 support of HTML elements -->
+    <!--[if lt IE 9]>
+    <script src="http://html5shim.googlecode.com/svn/trunk/html5.js"></script>
+    <![endif]-->
+
+    <!-- Le JavaScript -->
+    <script src="/assets/js/jquery-1.7.1.min.js" type="text/javascript"></script>
+    <script src="/assets/js/bootstrap-dropdown.js" type="text/javascript"></script>
+
+    <!-- Le styles -->
+    <link href="/assets/css/bootstrap.css" rel="stylesheet">
+    <link href="/assets/css/application.css" rel="stylesheet">
+    <link rel="shortcut icon" href="/assets/img/favicon.ico">
+  </head>
+
+  <body>
+
+    <div class="navbar navbar-fixed-top">
+      <div class="navbar-inner">
+        <div class="container">
+          <a class="brand" href="/"><img src="/assets/img/logo.png" width="152"
+            alt="Deltacloud API"/></a>
+          <ul class="nav top-nav">
+  <li class="active"><a href="/">Home</a></li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">About <b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/about">What is Deltacloud?</a></li>
+      <li><a href="/supported-providers">Supported Providers</a></li>
+    </ul>
+  </li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">Run API <b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/install-deltacloud">Install Deltacloud</a></li>
+      <li><a href="/run-deltacloud-server">Run the Deltacloud Server</a></li>
+    </ul>
+  </li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">Use API <b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/use-the-api">Using API</a></li>
+      <li><a href="/clients">Clients</a></li>
+    </ul>
+  </li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">Contribute <b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/how-to-contribute">How Can I Contribute?</a></li>
+      <li><a href="/getting-sources">Getting the Sources</a></li>
+    </ul>
+  </li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">API Documentation <b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/rest-api">REST API</a></li>
+      <li><a href="/drivers">Drivers API</a></li>
+      <li><a href="/libdeltacloud">C library libdeltacloud</a></li>
+    </ul>
+  </li>
+  <li><a href="#contact">Contact</a></li>
+</ul>
+
+        </div>
+      </div>
+
+    </div>
+
+    <div class="container">
+
+      
+
+      <footer class="footer">
+        <p class="footer-right">
+          <img src="/assets/img/asf_logo_wide.png" alt="Apache Software
+          Foundation"/>
+        </p>
+        <p>
+        <strong>Apache Deltacloud</strong> is a top-level project at the <a
+          href="http://www.apache.org">Apache Software Foundation</a>,
+          having graduated from the ASF Incubator in October
+          2011. Through a collaborative and meritocratic development process, Apache
+          projects deliver enterprise-grade, freely available software products that
+          attract large communities of users. 
+        </p>
+      </footer>
+
+    </div> <!-- /container -->
+
+  </body>
+</html>

Added: deltacloud/trunk/site/output/command-tools.html
URL: http://svn.apache.org/viewvc/deltacloud/trunk/site/output/command-tools.html?rev=1353588&view=auto
==============================================================================
--- deltacloud/trunk/site/output/command-tools.html (added)
+++ deltacloud/trunk/site/output/command-tools.html Mon Jun 25 15:05:02 2012
@@ -0,0 +1,149 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8">
+    <title>Command Line Tools</title>
+    <!-- Le HTML5 shim, for IE6-8 support of HTML elements -->
+    <!--[if lt IE 9]>
+    <script src="http://html5shim.googlecode.com/svn/trunk/html5.js"></script>
+    <![endif]-->
+
+    <!-- Le JavaScript -->
+    <script src="/assets/js/jquery-1.7.1.min.js" type="text/javascript"></script>
+    <script src="/assets/js/bootstrap-dropdown.js" type="text/javascript"></script>
+    <script src="/assets/js/jquery.tweet.js" type="text/javascript"></script>
+    <script src="/assets/js/application.js" type="text/javascript"></script>
+    <script src="/assets/js/bootstrap-transition.js"></script>
+    <script src="/assets/js/bootstrap-alert.js"></script>
+    <script src="/assets/js/bootstrap-modal.js"></script>
+    <script src="/assets/js/bootstrap-scrollspy.js"></script>
+    <script src="/assets/js/bootstrap-tab.js"></script>
+    <script src="/assets/js/bootstrap-tooltip.js"></script>
+    <script src="/assets/js/bootstrap-popover.js"></script>
+    <script src="/assets/js/bootstrap-button.js"></script>
+    <script src="/assets/js/bootstrap-collapse.js"></script>
+    <script src="/assets/js/bootstrap-carousel.js"></script>
+    <script src="/assets/js/bootstrap-typeahead.js"></script>
+
+    <!-- Le styles -->
+    <link href="/assets/css/bootstrap.css" rel="stylesheet">
+    <link href="/assets/css/application.css" rel="stylesheet">
+    <link rel="shortcut icon" href="/assets/img/favicon.ico">
+  </head>
+
+  <body>
+
+    <div class="navbar navbar-fixed-top">
+      <div class="navbar-inner">
+        <div class="container">
+          <a class="brand" href="/"><img src="/assets/img/logo.png" width="152"
+            alt="Deltacloud API"/></a>
+          <ul class="nav top-nav">
+  <li><a href="/">Home</a></li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">About<b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/about.html">What is Deltacloud?</a></li>
+      <li><a href="/supported-providers.html">Supported Providers</a></li>
+    </ul>
+  </li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">Installation<b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/install-deltacloud.html">Install Deltacloud</a></li>
+      <li><a href="/run-deltacloud-server.html">Run the Deltacloud Server</a></li>
+    </ul>
+  </li>
+  <li class="dropdown">
+    <a href="/usage.html" class="dropdown-toggle" data-toggle="dropdown">Usage<b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/usage.html#usingapi">Using API</a></li>
+      <li><a href="/usage.html#clients">Client Libraries</a></li>
+      <li><a href="/command-tools.html">Command Line Tools</a></li>
+    </ul>
+  </li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">Contribute<b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/getting-sources.html">Getting Sources</a></li>
+      <li><a href="/how-to-contribute.html">How Can I Contribute?</a></li>
+    </ul>
+  </li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">API<b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/rest-api.html">REST API</a></li>
+      <li><a href="/drivers.html">Drivers API</a></li>
+    </ul>
+  </li>
+  <li><a href="/contact.html">Contact</a></li>
+</ul>
+
+        </div>
+      </div>
+
+    </div>
+
+    <div class="container content">
+
+      <p><br></p>
+
+<h3 id="command">Using Deltacloud command tool</h3>
+
+<p>Installing the Deltacloud Ruby client also gives you the <strong>deltacloudc</strong> command line tool. This executable uses the Deltacloud client library to speak to the Deltacloud server through the <a href="rest-api.html">REST API</a>. This means that you can control your cloud infrastructure from the command line. The general usage pattern for deltacloudc is:</p><p>
+
+</p><pre>$ deltacloudc collection operation [options]</pre>
+
+<dl>
+<dt>Collection</dt>
+  <dd>
+  refers to the Deltacloud object collections, such as Instances, Images, Buckets, Realms etc., as described in a greater detail in the <a href="rest-api.html">REST API documentation</a>.
+  </dd>
+  <dt>Operation</dt>
+  <dd>
+  is collection dependant. All collections respond to 'index' and 'show' operations (retrieve details on all objects in a given collection or on a specific object). Some collections respond to 'create' and 'destroy' operations. The collection of instances (realized virtual servers) responds to operations for managing the instance lifecycle, such as 'stop' or 'reboot'. 
+  </dd>
+  <dt>Options</dt>
+  <dd>
+  are listed by invoking <strong>deltacloudc -h</strong>. The important option is <strong>-u</strong>, which specifies the API_URL, where the Deltacloud server is running. The API_URL takes the form of <strong>http://[user]:[password]@[api_url]:[port]/[api]</strong>. Alternatively, you can set the API_URL environment variable (e.g., export API_URL=http://mockuser:mockpassword@localhost:3001/api). If your username or your password contains special characters, it's necessary to use options <strong>-U</strong> and <strong>-P</strong> in addition to the option <strong>-u</strong>. Check the <a href="supported-providers.html#credentials"> list of credentials</a> you need for each back-end cloud provider.
+  </dd>
+</dl><p>
+The following examples assume that the Deltacloud server is running on your local machine port 3001 (the <strong>deltacloudd</strong> server daemon defaults to 'localhost:3001') and that it was started with the 'mock' provider (i.e. deltacloudd -i mock ).</p>
+
+<p> List all <strong>collections</strong> available in the current driver:</p>
+
+<pre>$ deltacloudc -l -u http://mockuser:mockpassword@localhost:3001/api</pre>
+
+<p>Get a list of all <strong>images</strong>:</p>
+
+<pre>$ deltacloudc images index -u http://mockuser:mockpassword@localhost:3001/api</pre>
+
+<p>List all operations for the <strong>buckets</strong> collection:</p>
+
+<pre>$ deltacloudc buckets -l -u http://mockuser:mockpassword@localhost:3001/api</pre>
+
+<p>Create a new <strong>blob</strong> in the bucket called 'bucket1':</p>
+
+<pre>$ deltacloudc blob create -i 'my_new_blob' -b 'bucket1' -f /home/marios/file.txt</pre>
+
+      <footer class="footer">
+        <p class="pull-right"><span class='icon-circle-arrow-up'>&nbsp;</span><a href="#">Back to top</a></p>
+        <div class='row'>
+          <div class='span3'>
+            <img src="/assets/img/asf.png" alt="Apache Software Foundation"/>
+          </div>
+          <div class='span9'>
+            <strong>Apache Deltacloud</strong> is a top-level project at the <a
+              href="http://www.apache.org">Apache Software Foundation</a>,
+            having graduated from the ASF Incubator in October
+            2011. Through a collaborative and meritocratic development process, Apache
+            projects deliver enterprise-grade, freely available software products that
+            attract large communities of users. 
+          </div>
+        </div>
+      </footer>
+
+    </div> <!-- /container -->
+
+  </body>
+</html>

Added: deltacloud/trunk/site/output/compute-resources.html
URL: http://svn.apache.org/viewvc/deltacloud/trunk/site/output/compute-resources.html?rev=1353588&view=auto
==============================================================================
--- deltacloud/trunk/site/output/compute-resources.html (added)
+++ deltacloud/trunk/site/output/compute-resources.html Mon Jun 25 15:05:02 2012
@@ -0,0 +1,234 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8">
+    <title>Compute resources</title>
+    <!-- Le HTML5 shim, for IE6-8 support of HTML elements -->
+    <!--[if lt IE 9]>
+    <script src="http://html5shim.googlecode.com/svn/trunk/html5.js"></script>
+    <![endif]-->
+
+    <!-- Le JavaScript -->
+    <script src="/assets/js/jquery-1.7.1.min.js" type="text/javascript"></script>
+    <script src="/assets/js/bootstrap-dropdown.js" type="text/javascript"></script>
+    <script src="/assets/js/jquery.tweet.js" type="text/javascript"></script>
+    <script src="/assets/js/application.js" type="text/javascript"></script>
+    <script src="/assets/js/bootstrap-transition.js"></script>
+    <script src="/assets/js/bootstrap-alert.js"></script>
+    <script src="/assets/js/bootstrap-modal.js"></script>
+    <script src="/assets/js/bootstrap-scrollspy.js"></script>
+    <script src="/assets/js/bootstrap-tab.js"></script>
+    <script src="/assets/js/bootstrap-tooltip.js"></script>
+    <script src="/assets/js/bootstrap-popover.js"></script>
+    <script src="/assets/js/bootstrap-button.js"></script>
+    <script src="/assets/js/bootstrap-collapse.js"></script>
+    <script src="/assets/js/bootstrap-carousel.js"></script>
+    <script src="/assets/js/bootstrap-typeahead.js"></script>
+
+    <!-- Le styles -->
+    <link href="/assets/css/bootstrap.css" rel="stylesheet">
+    <link href="/assets/css/application.css" rel="stylesheet">
+    <link rel="shortcut icon" href="/assets/img/favicon.ico">
+  </head>
+
+  <body>
+
+    <div class="navbar navbar-fixed-top">
+      <div class="navbar-inner">
+        <div class="container">
+          <a class="brand" href="/"><img src="/assets/img/logo.png" width="152"
+            alt="Deltacloud API"/></a>
+          <ul class="nav top-nav">
+  <li><a href="/">Home</a></li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">About<b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/about.html">What is Deltacloud?</a></li>
+      <li><a href="/supported-providers.html">Supported Providers</a></li>
+    </ul>
+  </li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">Installation<b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/install-deltacloud.html">Install Deltacloud</a></li>
+      <li><a href="/run-deltacloud-server.html">Run the Deltacloud Server</a></li>
+    </ul>
+  </li>
+  <li class="dropdown">
+    <a href="/usage.html" class="dropdown-toggle" data-toggle="dropdown">Usage<b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/usage.html#usingapi">Using API</a></li>
+      <li><a href="/usage.html#clients">Client Libraries</a></li>
+      <li><a href="/command-tools.html">Command Line Tools</a></li>
+    </ul>
+  </li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">Contribute<b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/getting-sources.html">Getting Sources</a></li>
+      <li><a href="/how-to-contribute.html">How Can I Contribute?</a></li>
+    </ul>
+  </li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">API<b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/rest-api.html">REST API</a></li>
+      <li><a href="/drivers.html">Drivers API</a></li>
+    </ul>
+  </li>
+  <li><a href="/contact.html">Contact</a></li>
+</ul>
+
+        </div>
+      </div>
+
+    </div>
+
+    <div class="container content">
+
+      <p><br></p>
+
+<div class="row">
+  <div class="span9">
+
+<h3 id="compute">Compute Resources</h3>
+
+<p>
+The compute resources are: instances, instance states, images, realms, hardware profiles, firewalls, load balancers, addresses and keys.
+</p>
+
+<h3 id="realms">Realms</h3>
+
+<p>
+A realm represents a boundary containing resources, such as a data center. The exact definition of a realm is given by the cloud provider. In some cases, a realm may represent different datacenters, different continents or different pools of resources within a single datacenter. A cloud provider may insist that all the resources exist within a single realm in order to cooperate. For instance, storage volumes may only be allowed to be mounted to instances within the same realm. Generally speaking, going from one realm to another within the same cloud may change many aspects of the cloud, such as SLA’s, pricing terms, etc.
+</p>
+
+<h4>Get a list of all realms</h4>
+
+<p>
+To list all realms use call <strong>GET /api/realms</strong>. You can filter the list by adding a request parameter <strong>architecture</strong> to the realms that support a specific architecture, such as <strong>i386</strong>. The example below shows the retrieval of all realms for the AWS EC2 driver, which correspond to EC2 "availability zones":
+</p>
+
+  </div>
+  <div class="span3">
+
+<ul class="nav nav-list well">
+<li class="nav-header">
+    REST API
+  </li>
+  <li><a href="rest-api.html">Introduction</a></li>
+  <li><a href="api-entry-point.html">API entry point</a></li>
+  <li class="active"><a href="compute-resources.html">Compute resources</a></li>
+  <ul class="nav nav-list">
+<li><a href="#realms">Realms</a></li>
+    <li><a href="hardware-profiles.html">Hardware profiles</a></li>
+    <li><a href="images.html">Images</a></li>
+    <li><a href="instance-states.html">Instance states</a></li>
+    <li><a href="instances.html">Instances</a></li>
+    <li><a href="keys.html">Keys</a></li>
+    <li><a href="firewalls.html">Firewalls</a></li>
+    <li><a href="addresses.html">Addresses</a></li>
+    <li><a href="load-balancers.html">Load balancers</a></li>
+  </ul>
+<li><a href="storage-resources.html">Storage resources</a></li>
+</ul>
+</div>
+</div>
+
+<p>Example request:</p>
+
+<pre>
+GET /api/realms?format=xml HTTP/1.1
+Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
+User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
+Host: localhost:3001
+Accept: */*
+</pre>
+
+<p>Server response:</p>
+
+<pre>
+HTTP/1.1 200 OK
+Content-Type: application/xml
+Content-Length: 639
+&lt;?xml version='1.0' encoding='utf-8' ?&gt;
+&lt;realms&gt;
+  &lt;realm href='http://localhost:3001/api/realms/us-east-1a' id='us-east-1a'&gt;
+    &lt;name&gt;us-east-1a&lt;/name&gt;
+    &lt;state&gt;available&lt;/state&gt;
+  &lt;/realm&gt;
+  &lt;realm href='http://localhost:3001/api/realms/us-east-1b' id='us-east-1b'&gt;
+    &lt;name&gt;us-east-1b&lt;/name&gt;
+    &lt;state&gt;available&lt;/state&gt;
+  &lt;/realm&gt;
+  &lt;realm href='http://localhost:3001/api/realms/us-east-1c' id='us-east-1c'&gt;
+    &lt;name&gt;us-east-1c&lt;/name&gt;
+    &lt;state&gt;available&lt;/state&gt;
+  &lt;/realm&gt;
+  &lt;realm href='http://localhost:3001/api/realms/us-east-1d' id='us-east-1d'&gt;
+    &lt;name&gt;us-east-1d&lt;/name&gt;
+    &lt;state&gt;available&lt;/state&gt;
+  &lt;/realm&gt;
+&lt;/realms&gt;
+</pre>
+
+<h4>Get the details of a realm</h4>
+
+<p>
+To provide the details of a realm use call <strong>GET /api/realms/:id</strong>. The server responds with a <strong>name</strong>, a <strong>state</strong> and a <strong>limit</strong> applicable to the current requester. The name is an arbitrary label with no specific meaning in the API. The <strong>state</strong> can be either <strong>AVAILABLE</strong> or <strong>UNAVAILABLE</strong>. 
+</p>
+
+<p>
+The example below shows the realm for the Rackspace driver. Since Rackspace does not currently have a notion of realms, the Deltacloud Rackspace driver provides a single realm called 'US', signifying that all compute resources for that cloud provider are hosted in the United States:
+</p>
+
+<p>Example request:</p>
+
+<pre>
+GET /api/realms/us?format=xml HTTP/1.1
+Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
+User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
+Host: localhost:3002
+Accept: */*
+</pre>
+
+<p>Server response:</p>
+
+<pre>
+HTTP/1.1 200 OK
+Content-Type: application/xml
+Content-Length: 182
+
+&lt;?xml version='1.0' encoding='utf-8' ?&gt;
+&lt;realm href='http://localhost:3001/api/realms/us' id='us'&gt;
+    &lt;name&gt;United States&lt;/name&gt;
+    &lt;state&gt;AVAILABLE&lt;/state&gt;
+    &lt;limit&gt;&lt;/limit&gt;
+&lt;/realm&gt;
+</pre>
+
+<p><a class="btn btn-inverse btn-large" style="float: right" href="hardware-profiles.html">Hardware profiles <i class="icon-arrow-right icon-white" style="vertical-align:baseline"> </i></a></p>
+
+<p><br></p>
+
+      <footer class="footer">
+        <p class="pull-right"><span class='icon-circle-arrow-up'>&nbsp;</span><a href="#">Back to top</a></p>
+        <div class='row'>
+          <div class='span3'>
+            <img src="/assets/img/asf.png" alt="Apache Software Foundation"/>
+          </div>
+          <div class='span9'>
+            <strong>Apache Deltacloud</strong> is a top-level project at the <a
+              href="http://www.apache.org">Apache Software Foundation</a>,
+            having graduated from the ASF Incubator in October
+            2011. Through a collaborative and meritocratic development process, Apache
+            projects deliver enterprise-grade, freely available software products that
+            attract large communities of users. 
+          </div>
+        </div>
+      </footer>
+
+    </div> <!-- /container -->
+
+  </body>
+</html>

Modified: deltacloud/trunk/site/output/contact.html
URL: http://svn.apache.org/viewvc/deltacloud/trunk/site/output/contact.html?rev=1353588&r1=1353587&r2=1353588&view=diff
==============================================================================
--- deltacloud/trunk/site/output/contact.html (original)
+++ deltacloud/trunk/site/output/contact.html Mon Jun 25 15:05:02 2012
@@ -1,110 +1,122 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html>
+<!DOCTYPE html>
+<html lang="en">
   <head>
-    <title>
-      Deltacloud - Contact
-    </title>
-    <meta content='' name='keywords' />
-    <meta content='' name='description' />
-    <meta content='text/html; charset=utf-8' http-equiv='Content-Type' />
-    <link href='./styles/favicon.ico' rel='shortcut icon' type='image/x-icon' />
-    <link href='./styles/default.css' rel='StyleSheet' title='Main style' type='text/css' />
-    <link href='./styles/default-debug.css' rel='Alternate StyleSheet' title='Debug main style' type='text/css' />
+    <meta charset="utf-8">
+    <title>Contact</title>
+    <!-- Le HTML5 shim, for IE6-8 support of HTML elements -->
+    <!--[if lt IE 9]>
+    <script src="http://html5shim.googlecode.com/svn/trunk/html5.js"></script>
+    <![endif]-->
+
+    <!-- Le JavaScript -->
+    <script src="/assets/js/jquery-1.7.1.min.js" type="text/javascript"></script>
+    <script src="/assets/js/bootstrap-dropdown.js" type="text/javascript"></script>
+    <script src="/assets/js/jquery.tweet.js" type="text/javascript"></script>
+    <script src="/assets/js/application.js" type="text/javascript"></script>
+    <script src="/assets/js/bootstrap-transition.js"></script>
+    <script src="/assets/js/bootstrap-alert.js"></script>
+    <script src="/assets/js/bootstrap-modal.js"></script>
+    <script src="/assets/js/bootstrap-scrollspy.js"></script>
+    <script src="/assets/js/bootstrap-tab.js"></script>
+    <script src="/assets/js/bootstrap-tooltip.js"></script>
+    <script src="/assets/js/bootstrap-popover.js"></script>
+    <script src="/assets/js/bootstrap-button.js"></script>
+    <script src="/assets/js/bootstrap-collapse.js"></script>
+    <script src="/assets/js/bootstrap-carousel.js"></script>
+    <script src="/assets/js/bootstrap-typeahead.js"></script>
+
+    <!-- Le styles -->
+    <link href="/assets/css/bootstrap.css" rel="stylesheet">
+    <link href="/assets/css/application.css" rel="stylesheet">
+    <link rel="shortcut icon" href="/assets/img/favicon.ico">
   </head>
+
   <body>
-    <div id='header'>
-      <div class='container'>
-        <div id='headerLogo' onclick="location.href='index.html';" style='cursor: pointer;'>
-          <h1>
-            Deltacloud - Many clouds. One API. No problem.
-          </h1>
+
+    <div class="navbar navbar-fixed-top">
+      <div class="navbar-inner">
+        <div class="container">
+          <a class="brand" href="/"><img src="/assets/img/logo.png" width="152"
+            alt="Deltacloud API"/></a>
+          <ul class="nav top-nav">
+  <li><a href="/">Home</a></li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">About<b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/about.html">What is Deltacloud?</a></li>
+      <li><a href="/supported-providers.html">Supported Providers</a></li>
+    </ul>
+  </li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">Installation<b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/install-deltacloud.html">Install Deltacloud</a></li>
+      <li><a href="/run-deltacloud-server.html">Run the Deltacloud Server</a></li>
+    </ul>
+  </li>
+  <li class="dropdown">
+    <a href="/usage.html" class="dropdown-toggle" data-toggle="dropdown">Usage<b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/usage.html#usingapi">Using API</a></li>
+      <li><a href="/usage.html#clients">Client Libraries</a></li>
+      <li><a href="/command-tools.html">Command Line Tools</a></li>
+    </ul>
+  </li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">Contribute<b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/getting-sources.html">Getting Sources</a></li>
+      <li><a href="/how-to-contribute.html">How Can I Contribute?</a></li>
+    </ul>
+  </li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">API<b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/rest-api.html">REST API</a></li>
+      <li><a href="/drivers.html">Drivers API</a></li>
+    </ul>
+  </li>
+  <li><a href="/contact.html">Contact</a></li>
+</ul>
+
         </div>
       </div>
+
     </div>
-    <div id='navigation'>
-      <div class='container' id='menu'>
-        <ul class='l0'>
-          <li>
-            <a class='inactive' href='./index.html' title='Deltacloud Home'>Home</a>
-          </li>
-          <li>
-            <a class='inactive' href='./download.html' title='Get the latest releases'>Download</a>
-          </li>
-          <li>
-            <a class='inactive' href='./developers.html' title='Information for developers'>Developers</a>
-          </li>
-          <li>
-            <a class='inactive' href='./documentation.html' title='Project documentation'>Documentation</a>
-          </li>
-          <li>
-            <a class='active' href='./contact.html' title='Contact us!'>Contact</a>
-          </li>
-        </ul>
-      </div>
-    </div>
-    <div id='frontpageHeader'></div>
-    <div id='main'>
-      <div class='container' id='content-deltacloud'>
-        <h1>Contact us!</h1>
-        
-        <p>We'd love to hear about your experiences with Deltacloud:</p>
-        
-        <ul>
-        <li><a href="http://mail-archives.apache.org/mod_mbox/deltacloud-dev/">dev@deltacloud.apache.org</a>
-        is our mailing list where you can ask questions or see all the latest patches and development activity
-        at the bleeding edge of the project,</li>
-        <li>The <a href="http://webchat.freenode.net/">#deltacloud</a> irc channel on Freenode is where
-        the developers hang out and where you can usually get the fastest answers to your questions,</li>
-        <li>Our <a href="http://teambox.com/projects/deltacloud">Teambox</a> page is where we keep the latest
-        task lists and where you can comment on or suggest new features for the project,</li>
-        <li>We have a <a href="https://github.com/apache/deltacloud">github</a> page which is a mirror of the
-        apache git repo, if you prefer to get the code or contribute that way.</li>
-        <li>We track bugs in <a href="https://issues.apache.org/jira/browse/DTACLOUD">Apache JIRA</a>. If you are
-        have found a problem with Deltacloud you can check if it is already known to the Deltacloud
-        developers or <a href="https://issues.apache.org/jira/secure/CreateIssue!default.jspa">report it here</a>.</li>
-        </ul>
-        
-        
-        <p>Please don't hesitate to get in touch if you have any questions about the project,
-        if you've had any issues with installing or using Deltacloud or even just to tell us
-        how great you think Deltacloud is! You might want to contribute a translation of
-        the Deltacloud documentation (or even this webpage), you may want to contribute
-        to the code and need some help getting started.</p>
-      </div>
-    </div>
-    <div id='footer-deltacloud'>
-      <div class='container'>
-        <p>
-          <a href='http://www.apache.org'>
-            <img alt='Apache Software Foundation Logo' src='http://www.apache.org/images/asf_logo_wide.png' />
-          </a>
-        </p>
-        <p id='disclaimer'>
-          Apache Deltacloud is a top-level project at the Apache
-          Software Foundation, having graduated from the ASF Incubator
-          in October 2011. Through a collaborative and meritocratic
-          development process, Apache projects deliver enterprise-grade,
-          freely available software products that attract large communities of users.
-        </p>
-      </div>
-    </div>
+
+    <div class="container content">
+
+      <p><br></p>
+<h2>Contact us!</h2>
+
+<p>We'd love to hear about your experiences with Deltacloud.</p>
+
+<ul>
+<li>
+  <a href="http://mail-archives.apache.org/mod_mbox/deltacloud-dev/">dev@deltacloud.apache.org</a> is our mailing list where you can ask questions or see all the latest patches and development activity at the bleeding edge of the project.
+  </li>
+  <li>The <a href="http://webchat.freenode.net/">#deltacloud</a> irc channel on Freenode is a place where the developers hang out and where you can usually get the fastest answers to your questions.
+  </li>
+</ul><p>Please don't hesitate to get in touch if you have any questions about the project, if you've had any issues with installing or using Deltacloud or even just to tell us how great you think Deltacloud is!</p>
+
+      <footer class="footer">
+        <p class="pull-right"><span class='icon-circle-arrow-up'>&nbsp;</span><a href="#">Back to top</a></p>
+        <div class='row'>
+          <div class='span3'>
+            <img src="/assets/img/asf.png" alt="Apache Software Foundation"/>
+          </div>
+          <div class='span9'>
+            <strong>Apache Deltacloud</strong> is a top-level project at the <a
+              href="http://www.apache.org">Apache Software Foundation</a>,
+            having graduated from the ASF Incubator in October
+            2011. Through a collaborative and meritocratic development process, Apache
+            projects deliver enterprise-grade, freely available software products that
+            attract large communities of users. 
+          </div>
+        </div>
+      </footer>
+
+    </div> <!-- /container -->
+
   </body>
-  <script type='text/javascript'>
-    var pkBaseURL = (("https:" == document.location.protocol) ? "https://stats.salasaga.org/aeolus/piwik/" : "http://stats.salasaga.org/aeolus/piwik/");
-    document.write(unescape("%3Cscript src='" + pkBaseURL + "piwik.js' type='text/javascript'%3E%3C/script%3E"));
-  </script>
-  <script type='text/javascript'>
-    //<![CDATA[
-      try {
-        var piwikTracker = Piwik.getTracker(pkBaseURL + "piwik.php", 2);
-        piwikTracker.trackPageView();
-        piwikTracker.enableLinkTracking();
-      } catch( err ) {}
-    //]]>
-  </script>
-  <noscript>
-    <p>
-      <img alt='' src='http://stats.salasaga.org/aeolus/piwik/piwik.php?idsite=2' style='border:0' />
-    </p>
-  </noscript>
 </html>

Added: deltacloud/trunk/site/output/contribute.html
URL: http://svn.apache.org/viewvc/deltacloud/trunk/site/output/contribute.html?rev=1353588&view=auto
==============================================================================
--- deltacloud/trunk/site/output/contribute.html (added)
+++ deltacloud/trunk/site/output/contribute.html Mon Jun 25 15:05:02 2012
@@ -0,0 +1,111 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8">
+    <title>Contribute</title>
+    <!-- Le HTML5 shim, for IE6-8 support of HTML elements -->
+    <!--[if lt IE 9]>
+    <script src="http://html5shim.googlecode.com/svn/trunk/html5.js"></script>
+    <![endif]-->
+
+    <!-- Le JavaScript -->
+    <script src="/assets/js/jquery-1.7.1.min.js" type="text/javascript"></script>
+    <script src="/assets/js/bootstrap-dropdown.js" type="text/javascript"></script>
+    <script src="/assets/js/jquery.tweet.js" type="text/javascript"></script>
+    <script src="/assets/js/application.js" type="text/javascript"></script>
+    <script src="/assets/js/bootstrap-transition.js"></script>
+    <script src="/assets/js/bootstrap-alert.js"></script>
+    <script src="/assets/js/bootstrap-modal.js"></script>
+    <script src="/assets/js/bootstrap-scrollspy.js"></script>
+    <script src="/assets/js/bootstrap-tab.js"></script>
+    <script src="/assets/js/bootstrap-tooltip.js"></script>
+    <script src="/assets/js/bootstrap-popover.js"></script>
+    <script src="/assets/js/bootstrap-button.js"></script>
+    <script src="/assets/js/bootstrap-collapse.js"></script>
+    <script src="/assets/js/bootstrap-carousel.js"></script>
+    <script src="/assets/js/bootstrap-typeahead.js"></script>
+
+    <!-- Le styles -->
+    <link href="/assets/css/bootstrap.css" rel="stylesheet">
+    <link href="/assets/css/application.css" rel="stylesheet">
+    <link rel="shortcut icon" href="/assets/img/favicon.ico">
+  </head>
+
+  <body>
+
+    <div class="navbar navbar-fixed-top">
+      <div class="navbar-inner">
+        <div class="container">
+          <a class="brand" href="/"><img src="/assets/img/logo.png" width="152"
+            alt="Deltacloud API"/></a>
+          <ul class="nav top-nav">
+  <li><a href="/">Home</a></li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">About<b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/about.html">What is Deltacloud?</a></li>
+      <li><a href="/supported-providers.html">Supported Providers</a></li>
+    </ul>
+  </li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">Installation<b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/install-deltacloud.html">Install Deltacloud</a></li>
+      <li><a href="/run-deltacloud-server.html">Run the Deltacloud Server</a></li>
+    </ul>
+  </li>
+  <li class="dropdown">
+    <a href="/usage.html" class="dropdown-toggle" data-toggle="dropdown">Usage<b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/usage.html#usingapi">Using API</a></li>
+      <li><a href="/usage.html#clients">Client Libraries</a></li>
+      <li><a href="/command-tools.html">Command Line Tools</a></li>
+    </ul>
+  </li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">Contribute<b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/getting-sources.html">Getting Sources</a></li>
+      <li><a href="/how-to-contribute.html">How Can I Contribute?</a></li>
+    </ul>
+  </li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">API<b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/rest-api.html">REST API</a></li>
+      <li><a href="/drivers.html">Drivers API</a></li>
+    </ul>
+  </li>
+  <li><a href="/contact.html">Contact</a></li>
+</ul>
+
+        </div>
+      </div>
+
+    </div>
+
+    <div class="container content">
+
+      
+
+      <footer class="footer">
+        <p class="pull-right"><span class='icon-circle-arrow-up'>&nbsp;</span><a href="#">Back to top</a></p>
+        <div class='row'>
+          <div class='span3'>
+            <img src="/assets/img/asf.png" alt="Apache Software Foundation"/>
+          </div>
+          <div class='span9'>
+            <strong>Apache Deltacloud</strong> is a top-level project at the <a
+              href="http://www.apache.org">Apache Software Foundation</a>,
+            having graduated from the ASF Incubator in October
+            2011. Through a collaborative and meritocratic development process, Apache
+            projects deliver enterprise-grade, freely available software products that
+            attract large communities of users. 
+          </div>
+        </div>
+      </footer>
+
+    </div> <!-- /container -->
+
+  </body>
+</html>

Added: deltacloud/trunk/site/output/contribute/index.html
URL: http://svn.apache.org/viewvc/deltacloud/trunk/site/output/contribute/index.html?rev=1353588&view=auto
==============================================================================
--- deltacloud/trunk/site/output/contribute/index.html (added)
+++ deltacloud/trunk/site/output/contribute/index.html Mon Jun 25 15:05:02 2012
@@ -0,0 +1,96 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8">
+    <title>Contribute</title>
+    <!-- Le HTML5 shim, for IE6-8 support of HTML elements -->
+    <!--[if lt IE 9]>
+    <script src="http://html5shim.googlecode.com/svn/trunk/html5.js"></script>
+    <![endif]-->
+
+    <!-- Le JavaScript -->
+    <script src="/assets/js/jquery-1.7.1.min.js" type="text/javascript"></script>
+    <script src="/assets/js/bootstrap-dropdown.js" type="text/javascript"></script>
+
+    <!-- Le styles -->
+    <link href="/assets/css/bootstrap.css" rel="stylesheet">
+    <link href="/assets/css/application.css" rel="stylesheet">
+    <link rel="shortcut icon" href="/assets/img/favicon.ico">
+  </head>
+
+  <body>
+
+    <div class="navbar navbar-fixed-top">
+      <div class="navbar-inner">
+        <div class="container">
+          <a class="brand" href="/"><img src="/assets/img/logo.png" width="152"
+            alt="Deltacloud API"/></a>
+          <ul class="nav top-nav">
+  <li class="active"><a href="/">Home</a></li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">About <b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/about">What is Deltacloud?</a></li>
+      <li><a href="/supported-providers">Supported Providers</a></li>
+    </ul>
+  </li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">Run API <b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/install-deltacloud">Install Deltacloud</a></li>
+      <li><a href="/run-deltacloud-server">Run the Deltacloud Server</a></li>
+    </ul>
+  </li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">Use API <b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/use-the-api">Using API</a></li>
+      <li><a href="/clients">Clients</a></li>
+    </ul>
+  </li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">Contribute <b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/how-to-contribute">How Can I Contribute?</a></li>
+      <li><a href="/getting-sources">Getting the Sources</a></li>
+    </ul>
+  </li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">API Documentation <b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/rest-api">REST API</a></li>
+      <li><a href="/drivers">Drivers API</a></li>
+      <li><a href="/libdeltacloud">C library libdeltacloud</a></li>
+    </ul>
+  </li>
+  <li><a href="#contact">Contact</a></li>
+</ul>
+
+        </div>
+      </div>
+
+    </div>
+
+    <div class="container">
+
+      
+
+      <footer class="footer">
+        <p class="footer-right">
+          <img src="/assets/img/asf_logo_wide.png" alt="Apache Software
+          Foundation"/>
+        </p>
+        <p>
+        <strong>Apache Deltacloud</strong> is a top-level project at the <a
+          href="http://www.apache.org">Apache Software Foundation</a>,
+          having graduated from the ASF Incubator in October
+          2011. Through a collaborative and meritocratic development process, Apache
+          projects deliver enterprise-grade, freely available software products that
+          attract large communities of users. 
+        </p>
+      </footer>
+
+    </div> <!-- /container -->
+
+  </body>
+</html>

Added: deltacloud/trunk/site/output/credentials.html
URL: http://svn.apache.org/viewvc/deltacloud/trunk/site/output/credentials.html?rev=1353588&view=auto
==============================================================================
--- deltacloud/trunk/site/output/credentials.html (added)
+++ deltacloud/trunk/site/output/credentials.html Mon Jun 25 15:05:02 2012
@@ -0,0 +1,242 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8">
+    <title>Credentials</title>
+    <!-- Le HTML5 shim, for IE6-8 support of HTML elements -->
+    <!--[if lt IE 9]>
+    <script src="http://html5shim.googlecode.com/svn/trunk/html5.js"></script>
+    <![endif]-->
+
+    <!-- Le JavaScript -->
+    <script src="/assets/js/jquery-1.7.1.min.js" type="text/javascript"></script>
+    <script src="/assets/js/bootstrap-dropdown.js" type="text/javascript"></script>
+    <script src="/assets/js/jquery.tweet.js" type="text/javascript"></script>
+    <script src="/assets/js/application.js" type="text/javascript"></script>
+    <script src="/assets/js/bootstrap-transition.js"></script>
+    <script src="/assets/js/bootstrap-alert.js"></script>
+    <script src="/assets/js/bootstrap-modal.js"></script>
+    <script src="/assets/js/bootstrap-scrollspy.js"></script>
+    <script src="/assets/js/bootstrap-tab.js"></script>
+    <script src="/assets/js/bootstrap-tooltip.js"></script>
+    <script src="/assets/js/bootstrap-popover.js"></script>
+    <script src="/assets/js/bootstrap-button.js"></script>
+    <script src="/assets/js/bootstrap-collapse.js"></script>
+    <script src="/assets/js/bootstrap-carousel.js"></script>
+    <script src="/assets/js/bootstrap-typeahead.js"></script>
+
+    <!-- Le styles -->
+    <link href="/assets/css/bootstrap.css" rel="stylesheet">
+    <link href="/assets/css/application.css" rel="stylesheet">
+    <link rel="shortcut icon" href="/assets/img/favicon.ico">
+  </head>
+
+  <body>
+
+    <div class="navbar navbar-fixed-top">
+      <div class="navbar-inner">
+        <div class="container">
+          <a class="brand" href="/"><img src="/assets/img/logo.png" width="152"
+            alt="Deltacloud API"/></a>
+          <ul class="nav top-nav">
+  <li><a href="/">Home</a></li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">About<b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/about.html">What is Deltacloud?</a></li>
+      <li><a href="/supported-providers.html">Supported Providers</a></li>
+    </ul>
+  </li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">Installation<b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/install-deltacloud.html">Install Deltacloud</a></li>
+      <li><a href="/run-deltacloud-server.html">Run the Deltacloud Server</a></li>
+    </ul>
+  </li>
+  <li class="dropdown">
+    <a href="/usage.html" class="dropdown-toggle" data-toggle="dropdown">Usage<b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/usage.html#usingapi">Using API</a></li>
+      <li><a href="/usage.html#clients">Client Libraries</a></li>
+      <li><a href="/command-tools.html">Command Line Tools</a></li>
+    </ul>
+  </li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">Contribute<b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/getting-sources.html">Getting Sources</a></li>
+      <li><a href="/how-to-contribute.html">How Can I Contribute?</a></li>
+    </ul>
+  </li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">API<b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/rest-api.html">REST API</a></li>
+      <li><a href="/drivers.html">Drivers API</a></li>
+    </ul>
+  </li>
+  <li><a href="/contact.html">Contact</a></li>
+</ul>
+
+        </div>
+      </div>
+
+    </div>
+
+    <div class="container content">
+
+      <p><br></p>
+<h3>Cloud provider credentials</h3>
+<table class="table-bordered table-striped table-condensed">
+<thead><tr>
+<th>Cloud</th>
+      <th>Driver</th>
+      <th>Username</th>
+      <th>Password</th>
+      <th>Notes</th>
+    </tr></thead>
+<tbody>
+<tr>
+<td style="text-align:left">
+        <strong>mock</strong>
+      </td>
+      <td style="text-align:left"><span style="font-size:x-small">mock</span></td>
+      <td style="text-align:left"><span style="font-size:x-small">mockuser</span></td>
+      <td style="text-align:left"><span style="font-size:x-small">mockpassword</span></td>
+      <td style="text-align:left">The mock driver doesn't talk to any cloud; it just pretends to be a cloud.</td>
+    </tr>
+<tr>
+<td style="text-align:left">
+        <strong>Amazon EC2/S3</strong>
+      </td>
+      <td style="text-align:left"><span style="font-size:x-small">ec2</span></td>
+      <td style="text-align:left">Access Key ID</td>
+      <td style="text-align:left">Secret Access Key</td>
+      <td style="text-align:left">This information can be found on the <a href="http://aws-portal.amazon.com/gp/aws/developer/account/index.html?action=access-key">Security Credentials</a> page in your AWS account.</td>
+    </tr>
+<tr>
+<td style="text-align:left">
+        <strong>Eucalyptus</strong>
+      </td>
+      <td style="text-align:left"><span style="font-size:x-small">eucalyptus</span></td>
+      <td style="text-align:left">Access Key ID</td>
+      <td style="text-align:left">Secret Access Key</td>
+      <td style="text-align:left"></td>
+    </tr>
+<tr>
+<td style="text-align:left">
+        <strong>GoGrid</strong>
+      </td>
+      <td style="text-align:left"><span style="font-size:x-small">gogrid</span></td>
+      <td style="text-align:left">API Key</td>
+      <td style="text-align:left">Shared Secret</td>
+      <td style="text-align:left">Go to <span style="font-size:x-small">My Account &gt; API Keys</span> for <a href="https://my.gogrid.com/gogrid/com.servepath.gogrid.GoGrid/index.html">your account</a> and click on the key you want to use to find the shared secret.</td>
+    </tr>
+<tr>
+<td style="text-align:left">
+        <strong>IBM SBC</strong>
+      </td>
+      <td style="text-align:left"><span style="font-size:x-small">sbc</span></td>
+      <td style="text-align:left">Username</td>
+      <td style="text-align:left">Password</td>
+      <td style="text-align:left"></td>
+    </tr>
+<tr>
+<td style="text-align:left">
+        <strong>Microsoft Azure (Storage Account only)</strong>
+      </td>
+      <td style="text-align:left"><span style="font-size:x-small">azure</span></td>
+      <td style="text-align:left">Public Storage Account Name</td>
+      <td style="text-align:left">Primary Access Key</td>
+      <td style="text-align:left">The Storage Account Name is chosen when you create the service (e.g. name in http://name.blob.core.windows.net/). This and the access key are available from the service control panel.</td>
+    </tr>
+<tr>
+<td style="text-align:left">
+        <strong>OpenNebula</strong>
+      </td>
+      <td style="text-align:left"><span style="font-size:x-small">opennebula</span></td>
+      <td style="text-align:left">OpenNebula user</td>
+      <td style="text-align:left">OpenNebula password</td>
+      <td style="text-align:left">Set the environment variable OCCI_URL to the address on which OpenNebula's OCCI server is listening.</td>
+    </tr>
+<tr>
+<td style="text-align:left">
+        <strong>Rackspace Cloud Servers/Cloud Files</strong>
+      </td>
+      <td style="text-align:left"><span style="font-size:x-small">rackspace</span></td>
+      <td style="text-align:left">Rackspace user name</td>
+      <td style="text-align:left">API Key</td>
+      <td style="text-align:left">Obtain the key from the <a href="https://manage.rackspacecloud.com/APIAccess.do">API Access</a> page in your control panel.</td>
+    </tr>
+<tr>
+<td style="text-align:left">
+        <strong>RHEV-M</strong>
+      </td>
+      <td style="text-align:left"><span style="font-size:x-small">rhevm</span></td>
+      <td style="text-align:left">
+<a href="http://markmc.fedorapeople.org/rhevm-api/en-US/html/chap-REST_API_Guide-Authentication.html">RHEV-M user name plus Windows domain</a>, <span style="font-size:x-small"> e.g., admin@rhevm.example.com</span>
+</td>
+      <td style="text-align:left">RHEV-M password</td>
+      <td style="text-align:left">Set environment variable API_PROVIDER to the URL of the RHEV-M REST API endpoint. </td>
+    </tr>
+<tr>
+<td style="text-align:left">
+        <strong>Rimuhosting</strong>
+      </td>
+      <td style="text-align:left"><span style="font-size:x-small">rimuhosting</span></td>
+      <td style="text-align:left">not used (?)</td>
+      <td style="text-align:left">API Key</td>
+      <td style="text-align:left"></td>
+    </tr>
+<tr>
+<td style="text-align:left">
+        <strong>Terremark</strong>
+      </td>
+      <td style="text-align:left"><span style="font-size:x-small">terremark</span></td>
+      <td style="text-align:left">Username</td>
+      <td style="text-align:left">Password</td>
+      <td style="text-align:left"></td>
+    </tr>
+<tr>
+<td style="text-align:left">
+        <strong>VMware vSphere</strong>
+      </td>
+      <td style="text-align:left"><span style="font-size:x-small">vsphere</span></td>
+      <td style="text-align:left">vSphere user</td>
+      <td style="text-align:left">vSphere user password</td>
+      <td style="text-align:left">Set environment variable API_PROVIDER to the hostname of the vSphere server.</td>
+    </tr>
+<tr>
+<td style="text-align:left">
+        <strong>OpenStack</strong>
+      </td>
+      <td style="text-align:left"><span style="font-size:x-small">openstack</span></td>
+      <td style="text-align:left">OpenStack user</td>
+      <td style="text-align:left">OpenStack user password</td>
+      <td style="text-align:left">Set environment variable API_PROVIDER to the URL of OpenStack API entrypoint.</td>
+    </tr>
+</tbody>
+</table>
+
+      <footer class="footer">
+        <p class="pull-right"><span class='icon-circle-arrow-up'>&nbsp;</span><a href="#">Back to top</a></p>
+        <div class='row'>
+          <div class='span3'>
+            <img src="/assets/img/asf.png" alt="Apache Software Foundation"/>
+          </div>
+          <div class='span9'>
+            <strong>Apache Deltacloud</strong> is a top-level project at the <a
+              href="http://www.apache.org">Apache Software Foundation</a>,
+            having graduated from the ASF Incubator in October
+            2011. Through a collaborative and meritocratic development process, Apache
+            projects deliver enterprise-grade, freely available software products that
+            attract large communities of users. 
+          </div>
+        </div>
+      </footer>
+
+    </div> <!-- /container -->
+
+  </body>
+</html>



Mime
View raw message