You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@jclouds.apache.org by ev...@apache.org on 2013/10/10 16:52:35 UTC

svn commit: r1531007 - /incubator/jclouds/site-content/documentation/quickstart/rackspace/index.html

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>