Author: everett
Date: Thu Oct 10 14:52:35 2013
New Revision: 1531007
URL: http://svn.apache.org/r1531007
Log:
deploy jclouds site content
Modified:
incubator/jclouds/site-content/documentation/quickstart/rackspace/index.html
Modified:
incubator/jclouds/site-content/documentation/quickstart/rackspace/index.html
URL:
http://svn.apache.org/viewvc/incubator/jclouds/site-content/documentation/quickstart/rackspace/index.html?rev=1531007&r1=1531006&r2=1531007&view=diff
==============================================================================
---
incubator/jclouds/site-content/documentation/quickstart/rackspace/index.html
(original)
+++
incubator/jclouds/site-content/documentation/quickstart/rackspace/index.html
Thu Oct 10 14:52:35 2013
@@ -60,6 +60,7 @@
<li><a href="#servers">Your First Cloud Servers App</a></li>
<li><a href="#volumes">Working with Cloud Block Storage</a></li>
<li><a href="#loadbalancers">Working with Cloud Load Balancers</a></li>
+<li><a href="#databases">Working with Cloud Databases</a></li>
<li><a href="#next">Next Steps</a></li>
<li><a href="#providers">Rackspace Cloud Providers</a></li>
<li><a href="#support">Support and Feedback</a></li>
@@ -386,13 +387,13 @@ List Volumes
...
</code></pre>
-<h2><a id="lbs"></a>Working with Cloud Load Balancers</h2>
+<h2><a id="loadbalancers"></a>Working with Cloud Load Balancers</h2>
-<h3><a id="lbs-intro"></a>Introduction</h3>
+<h3><a id="loadbalancers-intro"></a>Introduction</h3>
<p><a href="http://www.rackspace.com/cloud/public/loadbalancers/";>Cloud Load
Balancers</a> distributes workloads across two or more servers, network links,
and other resources to maximize throughput, minimize response time, and avoid
overload. Rackspace Cloud Load Balancers allow you to quickly load balance
multiple Cloud Servers for optimal resource utilization.</p>
-<h3><a id="lbs-apis"></a>APIs</h3>
+<h3><a id="loadbalancers-apis"></a>APIs</h3>
<p>Cloud Load Balancers works with the Rackspace layer in jclouds that is used
to access features specific to the Rackspace load balancer system.</p>
@@ -402,7 +403,7 @@ List Volumes
</ol>
-<h3><a id="lbs-source"></a>The Source Code</h3>
+<h3><a id="loadbalancers-source"></a>The Source Code</h3>
<ol>
<li>Create the directory hierarchy
org/jclouds/examples/rackspace/cloudloadbalancers/ in your jclouds
directory.</li>
@@ -438,7 +439,7 @@ List Volumes
</ol>
-<h3><a id="lbs-compile"></a>Compile and Run</h3>
+<h3><a id="loadbalancers-compile"></a>Compile and Run</h3>
<pre><code>javac -classpath ".:lib/*"
org/jclouds/examples/rackspace/cloudloadbalancers/CreateLoadBalancerWithExistingServers.java
@@ -449,11 +450,76 @@ Create Cloud Load Balancer
Go to http://166.78.34.87
</code></pre>
+<h2><a id="databases"></a>Working with Cloud Databases</h2>
+
+<h3><a id="databases-intro"></a>Introduction</h3>
+
+<p><a href="http://www.rackspace.com/cloud/databases/";>Cloud Databases</a>
provides easily managed cloud MySQL instances with built-in data replication
for speed and reliability.</p>
+
+<h3><a id="databases-apis"></a>APIs</h3>
+
+<p>You can access Cloud Databases with the jclouds openstack-trove API by
specifying the rackspace clouddatabases providers "rackspace-clouddatabases-us"
and "rackspace-clouddatabases-uk". The -us one can be used to access the United
States regions, and the -uk one is for the United Kingdom regions. The examples
use the -us provider, but the providers are interchangeable (but regions will
differ).</p>
+
+<ol>
+<li>The Rackspace compatible API for Cloud Databases is
org.jclouds.openstack.trove.v1.TroveApi - All other APIs for working with Cloud
Databases are accessible via the TroveApi.</li>
+<li>You can find these APIs in the latest <a
href="http://demobox.github.com/jclouds-maven-site/latest/apidocs";>Javadoc</a>.</li>
+</ol>
+
+
+<h3><a id="databases-source"></a>The Source Code</h3>
+
+<ol>
+<li>Create the directory hierarchy
org/jclouds/examples/rackspace/clouddatabases/ in your jclouds directory.</li>
+<li>Create Java source files called CreateInstance.java and Constants.java in
the directory above.</li>
+<li>You should now have a directory with the following structure:
+
+<ul>
+<li><code>jclouds/</code>
+
+<ul>
+<li><code>pom.xml</code></li>
+<li><code>lib/</code>
+
+<ul>
+<li><code>*.jar</code></li>
+</ul>
+</li>
+<li><code>org/jclouds/examples/rackspace/clouddatabases/</code>
+
+<ul>
+<li><code>CreateInstance.java</code></li>
+<li><code>Constants.java</code></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li>Open CreateInstance.java for editing.</li>
+<li>Go to the example code <a
href="https://github.com/jclouds/jclouds-examples/blob/master/rackspace/src/main/java/org/jclouds/examples/rackspace/clouddatabases/CreateInstance.java";>CreateInstance.java</a>,
read it over, and copy the code into your file.</li>
+<li>Open Constants.java for editing.</li>
+<li>Go to the example code <a
href="https://github.com/jclouds/jclouds-examples/blob/master/rackspace/src/main/java/org/jclouds/examples/rackspace/clouddatabases/Constants.java";>Constants.java</a>,
read it over, and copy the code into your file.</li>
+</ol>
+
+
+<h3><a id="databases-compile"></a>Compile and Run</h3>
+
+<p>Note: When providing a java classpath in Windows, the path separator is ';'
instead of ':'</p>
+
+<pre><code>javac -classpath ".:lib/*"
org/jclouds/examples/rackspace/clouddatabases/CreateInstance.java
+
+java -classpath ".:lib/*"
org.jclouds.examples.rackspace.clouddatabases.CreateInstance myUsername myApiKey
+</code></pre>
+
+<h3><a id="databases-advanced"></a>Advanced work with Cloud Databases</h3>
+
+<p>In addition to the create database instance example, by going through the
clouddatabases example code, you will learn to create instances, databases, and
database users as well as delete and modify them. You will also learn how to
set up and access a database from the public internet over JDBC. You can find
the examples documentation here: <a
href="https://github.com/jclouds/jclouds-examples/tree/master/rackspace";>Examples
Documentation</a></p>
+
<h2><a id="jee"></a>jclouds in a Managed Container</h2>
<p>Setting up jclouds to work in a managed container is easy. You simply need
to ensure that jclouds won't spawn any of its own threads. You can do this by
using the ExecutorServiceModule when building your Context.</p>
-<p>An example code snippet.</p>
+<p>An example code snippet:</p>
<div class="highlight"><pre><code class="java"><span class="kn">import</span>
<span class="nn">static</span> <span class="n">com</span><span
class="o">.</span><span class="na">google</span><span class="o">.</span><span
class="na">common</span><span class="o">.</span><span
class="na">util</span><span class="o">.</span><span
class="na">concurrent</span><span class="o">.</span><span
class="na">MoreExecutors</span><span class="o">.</span><span
class="na">sameThreadExecutor</span><span class="o">;</span>
@@ -506,6 +572,8 @@ Create Cloud Load Balancer
<li><code>"rackspace-cloudblockstorage-uk"</code></li>
<li><code>"rackspace-cloudloadbalancers-us"</code></li>
<li><code>"rackspace-cloudloadbalancers-uk"</code></li>
+<li><code>"rackspace-clouddatabases-us"</code></li>
+<li><code>"rackspace-clouddatabases-uk"</code></li>
</ul>
