Modified: jclouds/site-content/index.html URL: http://svn.apache.org/viewvc/jclouds/site-content/index.html?rev=1923693&r1=1923692&r2=1923693&view=diff ============================================================================== --- jclouds/site-content/index.html (original) +++ jclouds/site-content/index.html Mon Feb 10 07:25:53 2025 @@ -185,23 +185,17 @@ - <div id="quicknews" class="alert alert-info"> </div> - - - <script type="text/javascript"> $('#quicknews').hide(); </script> - - <div class="section-divider"> <span class="text">CLOUDS</span> </div> @@ -237,19 +231,18 @@ </div> <div class="panel-body"> -<div class="highlight"><pre><code class="java"><span class="n">ComputeService</span> <span class="n">compute</span> <span class="o">=</span> <span class="n">ContextBuilder</span><span class="o">.</span><span class="na">newBuilder</span><span class="o">(</span><span class="s">"aws-ec2"</span><span class="o">)</span> - <span class="o">.</span><span class="na">credentials</span><span class="o">(</span><span class="s">"identity"</span><span class="o">,</span> <span class="s">"credential"</span><span class="o">)</span> - <span class="o">.</span><span class="na">buildView</span><span class="o">(</span><span class="n">ComputeServiceContext</span><span class="o">.</span><span class="na">class</span><span class="o">)</span> +<figure class="highlight"><pre><code class="language-java" data-lang="java"><span class="nc">ComputeService</span> <span class="n">compute</span> <span class="o">=</span> <span class="nc">ContextBuilder</span><span class="o">.</span><span class="na">newBuilder</span><span class="o">(</span><span class="s">"aws-ec2"</span><span class="o">)</span> + <span class="o">.</span><span class="na">credentials</span><span class="o">(</span><span class="s">"identity"</span><span class="o">,</span> <span class="s">"credential"</span><span class="o">)</span> + <span class="o">.</span><span class="na">buildView</span><span class="o">(</span><span class="nc">ComputeServiceContext</span><span class="o">.</span><span class="na">class</span><span class="o">)</span> <span class="o">.</span><span class="na">getComputeService</span><span class="o">();</span> -<span class="n">Template</span> <span class="n">template</span> <span class="o">=</span> <span class="n">compute</span><span class="o">.</span><span class="na">templateBuilder</span><span class="o">()</span> - <span class="o">.</span><span class="na">osFamily</span><span class="o">(</span><span class="n">OsFamily</span><span class="o">.</span><span class="na">UBUNTU</span><span class="o">)</span> +<span class="nc">Template</span> <span class="n">template</span> <span class="o">=</span> <span class="n">compute</span><span class="o">.</span><span class="na">templateBuilder</span><span class="o">()</span> + <span class="o">.</span><span class="na">osFamily</span><span class="o">(</span><span class="nc">OsFamily</span><span class="o">.</span><span class="na">UBUNTU</span><span class="o">)</span> <span class="o">.</span><span class="na">minRam</span><span class="o">(</span><span class="mi">2048</span><span class="o">)</span> <span class="o">.</span><span class="na">options</span><span class="o">(</span><span class="n">inboundPorts</span><span class="o">(</span><span class="mi">22</span><span class="o">,</span> <span class="mi">80</span><span class="o">))</span> <span class="o">.</span><span class="na">build</span><span class="o">();</span> -<span class="n">compute</span><span class="o">.</span><span class="na">createNodesInGroup</span><span class="o">(</span><span class="s">"jclouds"</span><span class="o">,</span> <span class="mi">1</span><span class="o">,</span> <span class="n">template</span><span class="o">);</span> -</code></pre></div> +<span class="n">compute</span><span class="o">.</span><span class="na">createNodesInGroup</span><span class="o">(</span><span class="s">"jclouds"</span><span class="o">,</span> <span class="mi">1</span><span class="o">,</span> <span class="n">template</span><span class="o">);</span></code></pre></figure> </div> </div> @@ -261,19 +254,18 @@ </div> <div class="panel-body"> -<div class="highlight"><pre><code class="java"><span class="n">BlobStore</span> <span class="n">blobStore</span> <span class="o">=</span> <span class="n">ContextBuilder</span><span class="o">.</span><span class="na">newBuilder</span><span class="o">(</span><span class="s">"aws-s3"</span><span class="o">)</span> - <span class="o">.</span><span class="na">credentials</span><span class="o">(</span><span class="s">"identity"</span><span class="o">,</span> <span class="s">"credential"</span><span class="o">)</span> - <span class="o">.</span><span class="na">buildView</span><span class="o">(</span><span class="n">BlobStoreContext</span><span class="o">.</span><span class="na">class</span><span class="o">)</span> +<figure class="highlight"><pre><code class="language-java" data-lang="java"><span class="nc">BlobStore</span> <span class="n">blobStore</span> <span class="o">=</span> <span class="nc">ContextBuilder</span><span class="o">.</span><span class="na">newBuilder</span><span class="o">(</span><span class="s">"aws-s3"</span><span class="o">)</span> + <span class="o">.</span><span class="na">credentials</span><span class="o">(</span><span class="s">"identity"</span><span class="o">,</span> <span class="s">"credential"</span><span class="o">)</span> + <span class="o">.</span><span class="na">buildView</span><span class="o">(</span><span class="nc">BlobStoreContext</span><span class="o">.</span><span class="na">class</span><span class="o">)</span> <span class="o">.</span><span class="na">getBlobStore</span><span class="o">();</span> -<span class="n">blobStore</span><span class="o">.</span><span class="na">createContainerInLocation</span><span class="o">(</span><span class="n">location</span><span class="o">,</span> <span class="s">"container-name"</span><span class="o">);</span> +<span class="n">blobStore</span><span class="o">.</span><span class="na">createContainerInLocation</span><span class="o">(</span><span class="n">location</span><span class="o">,</span> <span class="s">"container-name"</span><span class="o">);</span> -<span class="n">ByteSource</span> <span class="n">payload</span> <span class="o">=</span> <span class="n">ByteSource</span><span class="o">.</span><span class="na">wrap</span><span class="o">(</span><span class="k">new</span> <span class="kt">byte</span><span class="o">[]</span> <span class="o">{</span><span class="mi">1</span><span class="o">,</span> <span class="mi">2</span><span class="o">,</span> <span class="mi">3</span><span class="o">,</span> <span class="mi">4</span><span class="o">});</span> -<span class="n">Blob</span> <span class="n">blob</span> <span class="o">=</span> <span class="n">blobStore</span><span class="o">.</span><span class="na">blobBuilder</span><span class="o">(</span><span class="s">"blob-name"</span><span class="o">)</span> +<span class="nc">ByteSource</span> <span class="n">payload</span> <span class="o">=</span> <span class="nc">ByteSource</span><span class="o">.</span><span class="na">wrap</span><span class="o">(</span><span class="k">new</span> <span class="kt">byte</span><span class="o">[]</span> <span class="o">{</span><span class="mi">1</span><span class="o">,</span> <span class="mi">2</span><span class="o">,</span> <span class="mi">3</span><span class="o">,</span> <span class="mi">4</span><span class="o">});</span> +<span class="nc">Blob</span> <span class="n">blob</span> <span class="o">=</span> <span class="n">blobStore</span><span class="o">.</span><span class="na">blobBuilder</span><span class="o">(</span><span class="s">"blob-name"</span><span class="o">)</span> <span class="o">.</span><span class="na">payload</span><span class="o">(</span><span class="n">payload</span><span class="o">)</span> <span class="o">.</span><span class="na">contentLength</span><span class="o">(</span><span class="n">payload</span><span class="o">.</span><span class="na">size</span><span class="o">())</span> <span class="o">.</span><span class="na">build</span><span class="o">();</span> -<span class="n">blobStore</span><span class="o">.</span><span class="na">putBlob</span><span class="o">(</span><span class="s">"container-name"</span><span class="o">,</span> <span class="n">blob</span><span class="o">);</span> -</code></pre></div> +<span class="n">blobStore</span><span class="o">.</span><span class="na">putBlob</span><span class="o">(</span><span class="s">"container-name"</span><span class="o">,</span> <span class="n">blob</span><span class="o">);</span></code></pre></figure> </div> </div>
Modified: jclouds/site-content/news/gsoc2014/index.html URL: http://svn.apache.org/viewvc/jclouds/site-content/news/gsoc2014/index.html?rev=1923693&r1=1923692&r2=1923693&view=diff ============================================================================== --- jclouds/site-content/news/gsoc2014/index.html (original) +++ jclouds/site-content/news/gsoc2014/index.html Mon Feb 10 07:25:53 2025 @@ -149,24 +149,23 @@ <div class="page-header"> <h1>Google Summer Of Code 2014</h1> </div> - <p style="text-align:center;"> <a href="https://www.google-melange.com/gsoc/homepage/google/gsoc2014";><img src="/img/gsoc2014.png" alt="Google Summer of Code 2014" /></a></p> + <p>-> <a href="https://www.google-melange.com/gsoc/homepage/google/gsoc2014";><img src="/img/gsoc2014.png" alt="Google Summer of Code 2014" /></a> <-</p> <p>Google Summer of Code is a global program that offers post-secondary student developers ages 18 and older stipends to write code for various open source software projects. Apache jclouds is one of the participants in the program, and encourages anyone interested in it to submit their project ideas.</p> <p>You can find more information about Google Summer of Code in <a href="https://developers.google.com/open-source/soc/";>the official site</a>, and the <a href="https://www.google-melange.com/gsoc/homepage/google/gsoc2014";>GSoC 2014 site</a>.</p> -<h2>How to participate</h2> +<h2 id="how-to-participate">How to participate</h2> <p>If you want to participate in the project, just let us know!</p> <ul> -<li>Subscribe to the <a href="/community">dev mailing list</a> and send us an email telling who you are and what you would like to do.</li> -<li>Search the <a href="https://issues.apache.org/jira/issues/?jql=project%20%3D%20JCLOUDS%20AND%20labels%20%3D%20gsoc2014";>existing project ideas</a> and see if you would like working on them.</li> -<li><strong>Propose your own ideas!</strong></li> + <li>Subscribe to the <a href="/community">dev mailing list</a> and send us an email telling who you are and what you would like to do.</li> + <li>Search the <a href="https://issues.apache.org/jira/issues/?jql=project%20%3D%20JCLOUDS%20AND%20labels%20%3D%20gsoc2014";>existing project ideas</a> and see if you would like working on them.</li> + <li><strong>Propose your own ideas!</strong></li> </ul> - -<h3>The mentors</h3> +<h3 id="the-mentors">The mentors</h3> <table class="table table-striped table-hover"> <thead> @@ -195,7 +194,6 @@ </tbody> </table> - <div class="row clearfix"> <div id="footer" class="col-md-12 column"> <div id="footer"> Modified: jclouds/site-content/reference/configuration/index.html URL: http://svn.apache.org/viewvc/jclouds/site-content/reference/configuration/index.html?rev=1923693&r1=1923692&r2=1923693&view=diff ============================================================================== --- jclouds/site-content/reference/configuration/index.html (original) +++ jclouds/site-content/reference/configuration/index.html Mon Feb 10 07:25:53 2025 @@ -149,51 +149,49 @@ <div class="page-header"> <h1>Configuration</h1> </div> - <h2>Enterprise</h2> + <h2 id="enterprise">Enterprise</h2> +<p>Enterprise configuration attempts to make the best choices for you, with regards to which components to use to power your connections to the cloud. Specifically, this chooses <code class="language-plaintext highlighter-rouge">joda</code> dates, <code class="language-plaintext highlighter-rouge">bouncycastle</code> encryption, and <code class="language-plaintext highlighter-rouge">apache HTTP Client 4.0</code> connection pools.</p> -<p>Enterprise configuration attempts to make the best choices for you, with regards to which components to use to power your connections to the cloud. Specifically, this chooses <code>joda</code> dates, <code>bouncycastle</code> encryption, and <code>apache HTTP Client 4.0</code> connection pools.</p> +<p>You can also add further configuration, by passing it in the set of modules to configure. For example, hereâs how to change the default connection and thread limits, and add log4j.</p> -<p>You can also add further configuration, by passing it in the set of modules to configure. For example, here's how to change the default connection and thread limits, and add log4j.</p> - -<div class="highlight"><pre><code class="java"><span class="kn">import</span> <span class="nn">static</span> <span class="n">org</span><span class="o">.</span><span class="na">jclouds</span><span class="o">.</span><span class="na">Constants</span><span class="o">.*;</span> +<figure class="highlight"><pre><code class="language-java" data-lang="java"><span class="kn">import</span> <span class="nn">static</span> <span class="n">org</span><span class="o">.</span><span class="na">jclouds</span><span class="o">.</span><span class="na">Constants</span><span class="o">.*;</span> <span class="o">...</span> -<span class="n">Properties</span> <span class="n">overrides</span> <span class="o">=</span> <span class="k">new</span> <span class="n">Properties</span><span class="o">();</span> -<span class="n">overrides</span><span class="o">.</span><span class="na">setProperty</span><span class="o">(</span><span class="n">PROPERTY_MAX_CONNECTIONS_PER_CONTEXT</span><span class="o">,</span> <span class="mi">20</span> <span class="o">+</span> <span class="s">""</span><span class="o">);</span> -<span class="n">overrides</span><span class="o">.</span><span class="na">setProperty</span><span class="o">(</span><span class="n">PROPERTY_MAX_CONNECTIONS_PER_HOST</span><span class="o">,</span> <span class="mi">0</span> <span class="o">+</span> <span class="s">""</span><span class="o">);</span> -<span class="n">overrides</span><span class="o">.</span><span class="na">setProperty</span><span class="o">(</span><span class="n">PROPERTY_CONNECTION_TIMEOUT</span><span class="o">,</span> <span class="mi">5000</span> <span class="o">+</span> <span class="s">""</span><span class="o">);</span> -<span class="n">overrides</span><span class="o">.</span><span class="na">setProperty</span><span class="o">(</span><span class="n">PROPERTY_SO_TIMEOUT</span><span class="o">,</span> <span class="mi">5000</span> <span class="o">+</span> <span class="s">""</span><span class="o">);</span> -<span class="n">overrides</span><span class="o">.</span><span class="na">setProperty</span><span class="o">(</span><span class="n">PROPERTY_IO_WORKER_THREADS</span><span class="o">,</span> <span class="mi">20</span> <span class="o">+</span> <span class="s">""</span><span class="o">);</span> +<span class="nc">Properties</span> <span class="n">overrides</span> <span class="o">=</span> <span class="k">new</span> <span class="nc">Properties</span><span class="o">();</span> +<span class="n">overrides</span><span class="o">.</span><span class="na">setProperty</span><span class="o">(</span><span class="no">PROPERTY_MAX_CONNECTIONS_PER_CONTEXT</span><span class="o">,</span> <span class="mi">20</span> <span class="o">+</span> <span class="s">""</span><span class="o">);</span> +<span class="n">overrides</span><span class="o">.</span><span class="na">setProperty</span><span class="o">(</span><span class="no">PROPERTY_MAX_CONNECTIONS_PER_HOST</span><span class="o">,</span> <span class="mi">0</span> <span class="o">+</span> <span class="s">""</span><span class="o">);</span> +<span class="n">overrides</span><span class="o">.</span><span class="na">setProperty</span><span class="o">(</span><span class="no">PROPERTY_CONNECTION_TIMEOUT</span><span class="o">,</span> <span class="mi">5000</span> <span class="o">+</span> <span class="s">""</span><span class="o">);</span> +<span class="n">overrides</span><span class="o">.</span><span class="na">setProperty</span><span class="o">(</span><span class="no">PROPERTY_SO_TIMEOUT</span><span class="o">,</span> <span class="mi">5000</span> <span class="o">+</span> <span class="s">""</span><span class="o">);</span> +<span class="n">overrides</span><span class="o">.</span><span class="na">setProperty</span><span class="o">(</span><span class="no">PROPERTY_IO_WORKER_THREADS</span><span class="o">,</span> <span class="mi">20</span> <span class="o">+</span> <span class="s">""</span><span class="o">);</span> <span class="c1">// unlimited user threads</span> -<span class="n">overrides</span><span class="o">.</span><span class="na">setProperty</span><span class="o">(</span><span class="n">PROPERTY_USER_THREADS</span><span class="o">,</span> <span class="mi">0</span> <span class="o">+</span> <span class="s">""</span><span class="o">);</span> +<span class="n">overrides</span><span class="o">.</span><span class="na">setProperty</span><span class="o">(</span><span class="no">PROPERTY_USER_THREADS</span><span class="o">,</span> <span class="mi">0</span> <span class="o">+</span> <span class="s">""</span><span class="o">);</span> -<span class="n">Set</span><span class="o"><</span><span class="n">Module</span><span class="o">></span> <span class="n">wiring</span> <span class="o">=</span> <span class="n">ImmutableSet</span><span class="o">.</span><span class="na">of</span><span class="o">(</span><span class="k">new</span> <span class="n">EnterpriseConfigurationModule</span><span class="o">(),</span> <span class="k">new</span> <span class="n">Log4JLoggingModule</span><span class="o">());</span> +<span class="nc">Set</span><span class="o"><</span><span class="nc">Module</span><span class="o">></span> <span class="n">wiring</span> <span class="o">=</span> <span class="nc">ImmutableSet</span><span class="o">.</span><span class="na">of</span><span class="o">(</span><span class="k">new</span> <span class="nc">EnterpriseConfigurationModule</span><span class="o">(),</span> <span class="k">new</span> <span class="nc">Log4JLoggingModule</span><span class="o">());</span> <span class="c1">// same properties and wiring can be used for many services, although the limits are per context</span> -<span class="n">blobStoreContext</span> <span class="o">=</span> <span class="n">ContextBuilder</span><span class="o">.</span><span class="na">newBuilder</span><span class="o">(</span><span class="s">"s3"</span><span class="o">)</span> +<span class="n">blobStoreContext</span> <span class="o">=</span> <span class="nc">ContextBuilder</span><span class="o">.</span><span class="na">newBuilder</span><span class="o">(</span><span class="s">"s3"</span><span class="o">)</span> <span class="o">.</span><span class="na">credentials</span><span class="o">(</span><span class="n">account</span><span class="o">,</span> <span class="n">key</span><span class="o">)</span> <span class="o">.</span><span class="na">modules</span><span class="o">(</span><span class="n">wiring</span><span class="o">)</span> <span class="o">.</span><span class="na">overrides</span><span class="o">(</span><span class="n">overrides</span><span class="o">)</span> - <span class="o">.</span><span class="na">buildView</span><span class="o">(</span><span class="n">BlobStoreContext</span><span class="o">.</span><span class="na">class</span><span class="o">);</span> -<span class="n">computeContext</span> <span class="o">=</span> <span class="n">ContextBuilder</span><span class="o">.</span><span class="na">newBuilder</span><span class="o">(</span><span class="s">"ec2"</span><span class="o">)</span> + <span class="o">.</span><span class="na">buildView</span><span class="o">(</span><span class="nc">BlobStoreContext</span><span class="o">.</span><span class="na">class</span><span class="o">);</span> +<span class="n">computeContext</span> <span class="o">=</span> <span class="nc">ContextBuilder</span><span class="o">.</span><span class="na">newBuilder</span><span class="o">(</span><span class="s">"ec2"</span><span class="o">)</span> <span class="o">.</span><span class="na">credentials</span><span class="o">(</span><span class="n">account</span><span class="o">,</span> <span class="n">key</span><span class="o">)</span> <span class="o">.</span><span class="na">modules</span><span class="o">(</span><span class="n">wiring</span><span class="o">)</span> <span class="o">.</span><span class="na">overrides</span><span class="o">(</span><span class="n">overrides</span><span class="o">)</span> - <span class="o">.</span><span class="na">buildView</span><span class="o">(</span><span class="n">ComputeServiceContext</span><span class="o">.</span><span class="na">class</span><span class="o">);</span> -</code></pre></div> - + <span class="o">.</span><span class="na">buildView</span><span class="o">(</span><span class="nc">ComputeServiceContext</span><span class="o">.</span><span class="na">class</span><span class="o">);</span></code></pre></figure> -<h3>Timeout</h3> +<h3 id="timeout">Timeout</h3> -<p>Aggregate commands will take as long as necessary to complete, as controlled by <code>FutureIterables.awaitCompletion</code>. If you need to increase or decrease this, you will need to adjust the property <code>jclouds.request-timeout</code> or <code>Constants.PROPERTY_REQUEST_TIMEOUT</code>. This is described in the Advanced Configuration section.</p> +<p>Aggregate commands will take as long as necessary to complete, as controlled by <code class="language-plaintext highlighter-rouge">FutureIterables.awaitCompletion</code>. If you need to increase or decrease this, you will need to adjust the property <code class="language-plaintext highlighter-rouge">jclouds.request-timeout</code> or <code class="language-plaintext highlighter-rouge">Constants.PROPERTY_REQUEST_TIMEOUT</code>. This is described in the Advanced Configuration section.</p> -<h2><em>NULL</em> Return values</h2> +<h2 id="null-return-values"><em>NULL</em> Return values</h2> <p>All API methods, either provider or API specific, must return <em>null</em> when a requested object is not found. Throwing exceptions is only appropriate when there is a state problem. For example, when requesting an object from a container that does not exist.</p> + <div class="row clearfix"> <div id="footer" class="col-md-12 column"> <div id="footer"> Modified: jclouds/site-content/reference/javadoc/index.html URL: http://svn.apache.org/viewvc/jclouds/site-content/reference/javadoc/index.html?rev=1923693&r1=1923692&r2=1923693&view=diff ============================================================================== --- jclouds/site-content/reference/javadoc/index.html (original) +++ jclouds/site-content/reference/javadoc/index.html Mon Feb 10 07:25:53 2025 @@ -150,16 +150,15 @@ <h1>Javadoc for Apache jclouds</h1> </div> <ul> -<li><a href="/reference/javadoc/2.3.x/">2.3.x</a></li> -<li><a href="/reference/javadoc/2.2.x/">2.2.x</a></li> -<li><a href="/reference/javadoc/2.1.x/">2.1.x</a></li> -<li><a href="/reference/javadoc/2.0.x/">2.0.x</a></li> -<li><a href="/reference/javadoc/1.9.x/">1.9.x</a></li> -<li><a href="/reference/javadoc/1.8.x/">1.8.x</a></li> -<li><a href="/reference/javadoc/1.7.x/">1.7.x</a></li> + <li><a href="/reference/javadoc/2.3.x/">2.3.x</a></li> + <li><a href="/reference/javadoc/2.2.x/">2.2.x</a></li> + <li><a href="/reference/javadoc/2.1.x/">2.1.x</a></li> + <li><a href="/reference/javadoc/2.0.x/">2.0.x</a></li> + <li><a href="/reference/javadoc/1.9.x/">1.9.x</a></li> + <li><a href="/reference/javadoc/1.8.x/">1.8.x</a></li> + <li><a href="/reference/javadoc/1.7.x/">1.7.x</a></li> </ul> - <div class="row clearfix"> <div id="footer" class="col-md-12 column"> <div id="footer"> Modified: jclouds/site-content/reference/logging/index.html URL: http://svn.apache.org/viewvc/jclouds/site-content/reference/logging/index.html?rev=1923693&r1=1923692&r2=1923693&view=diff ============================================================================== --- jclouds/site-content/reference/logging/index.html (original) +++ jclouds/site-content/reference/logging/index.html Mon Feb 10 07:25:53 2025 @@ -150,22 +150,21 @@ <h1>Logging</h1> </div> <ol> -<li><a href="#install">Install</a></li> -<li><a href="#configure">Configure</a></li> -<li><a href="#enable">Enable</a></li> -<li><a href="#proxy">HTTP(S) Proxy</a></li> + <li><a href="#install">Install</a></li> + <li><a href="#configure">Configure</a></li> + <li><a href="#enable">Enable</a></li> + <li><a href="#proxy">HTTP(S) Proxy</a></li> </ol> - -<p>Logging in jclouds can save you time and effort when developing your code or looking for help. If your code is not behaving how you expect it to, enabling and configuring logging in jclouds can quickly give you valuable insight into the root cause of the issue. If you need help from the <a href="/community/">community</a>, the logs can help the people there assist you. The logs can be verbose so it's often best to simply copy and paste them into a <a href="https://gist.github.com/";>gist</a> or <a href="http://pastie.org/";>pastie</a> and just post the link on the mailing list.</p> +<p>Logging in jclouds can save you time and effort when developing your code or looking for help. If your code is not behaving how you expect it to, enabling and configuring logging in jclouds can quickly give you valuable insight into the root cause of the issue. If you need help from the <a href="/community/">community</a>, the logs can help the people there assist you. The logs can be verbose so itâs often best to simply copy and paste them into a <a href="https://gist.github.com/";>gist</a> or <a href="http://pastie.org/";>pastie</a> and just post the link on the mailing list.</p> <p>By default, jclouds does no logging whatsoever for maximum performance.</p> -<h2><a id="install"></a>Install Logging</h2> +<h2 id="install-logging"><a id="install"></a>Install Logging</h2> <p><a href="https://www.slf4j.org/";>SLF4J</a> is the logging facade for jclouds. To use SLF4J you need the jclouds-slf4j-X.X.X.jar and the implementation logback-*.jar (<a href="https://logback.qos.ch/download.html";>download</a>) files on your classpath. To get them via Maven add the following dependencies to your pom.xml file.</p> -<div class="highlight"><pre><code class="xml"><span class="nt"><dependencies></span> +<figure class="highlight"><pre><code class="language-xml" data-lang="xml"><span class="nt"><dependencies></span> <span class="nt"><dependency></span> <span class="nt"><groupId></span>org.apache.jclouds.driver<span class="nt"></groupId></span> <span class="nt"><artifactId></span>jclouds-slf4j<span class="nt"></artifactId></span> @@ -176,23 +175,21 @@ <span class="nt"><artifactId></span>logback-classic<span class="nt"></artifactId></span> <span class="nt"><version></span>1.0.13<span class="nt"></version></span> <span class="nt"></dependency></span> -<span class="nt"></dependencies></span> -</code></pre></div> - +<span class="nt"></dependencies></span></code></pre></figure> -<h2><a id="configure"></a>Configure Logging</h2> +<h2 id="configure-logging"><a id="configure"></a>Configure Logging</h2> -<p>You'll also need a logback.xml configuration file on your classpath. Here's an example.</p> +<p>Youâll also need a logback.xml configuration file on your classpath. Hereâs an example.</p> -<div class="highlight"><pre><code class="xml"><span class="cp"><?xml version="1.0"?></span> -<span class="nt"><configuration</span> <span class="na">scan=</span><span class="s">"false"</span><span class="nt">></span> - <span class="nt"><appender</span> <span class="na">name=</span><span class="s">"STDOUT"</span> <span class="na">class=</span><span class="s">"ch.qos.logback.core.ConsoleAppender"</span><span class="nt">></span> +<figure class="highlight"><pre><code class="language-xml" data-lang="xml"><span class="cp"><?xml version="1.0"?></span> +<span class="nt"><configuration</span> <span class="na">scan=</span><span class="s">"false"</span><span class="nt">></span> + <span class="nt"><appender</span> <span class="na">name=</span><span class="s">"STDOUT"</span> <span class="na">class=</span><span class="s">"ch.qos.logback.core.ConsoleAppender"</span><span class="nt">></span> <span class="nt"><encoder></span> <span class="nt"><pattern></span>%m%n<span class="nt"></pattern></span> <span class="nt"></encoder></span> <span class="nt"></appender></span> - <span class="nt"><appender</span> <span class="na">name=</span><span class="s">"FILE"</span> <span class="na">class=</span><span class="s">"ch.qos.logback.core.FileAppender"</span><span class="nt">></span> + <span class="nt"><appender</span> <span class="na">name=</span><span class="s">"FILE"</span> <span class="na">class=</span><span class="s">"ch.qos.logback.core.FileAppender"</span><span class="nt">></span> <span class="nt"><file></span>log/jclouds.log<span class="nt"></file></span> <span class="nt"><encoder></span> @@ -200,7 +197,7 @@ <span class="nt"></encoder></span> <span class="nt"></appender></span> - <span class="nt"><appender</span> <span class="na">name=</span><span class="s">"WIREFILE"</span> <span class="na">class=</span><span class="s">"ch.qos.logback.core.FileAppender"</span><span class="nt">></span> + <span class="nt"><appender</span> <span class="na">name=</span><span class="s">"WIREFILE"</span> <span class="na">class=</span><span class="s">"ch.qos.logback.core.FileAppender"</span><span class="nt">></span> <span class="nt"><file></span>log/jclouds-wire.log<span class="nt"></file></span> <span class="nt"><encoder></span> @@ -208,7 +205,7 @@ <span class="nt"></encoder></span> <span class="nt"></appender></span> - <span class="nt"><appender</span> <span class="na">name=</span><span class="s">"COMPUTEFILE"</span> <span class="na">class=</span><span class="s">"ch.qos.logback.core.FileAppender"</span><span class="nt">></span> + <span class="nt"><appender</span> <span class="na">name=</span><span class="s">"COMPUTEFILE"</span> <span class="na">class=</span><span class="s">"ch.qos.logback.core.FileAppender"</span><span class="nt">></span> <span class="nt"><file></span>log/jclouds-compute.log<span class="nt"></file></span> <span class="nt"><encoder></span> @@ -216,7 +213,7 @@ <span class="nt"></encoder></span> <span class="nt"></appender></span> - <span class="nt"><appender</span> <span class="na">name=</span><span class="s">"SSHFILE"</span> <span class="na">class=</span><span class="s">"ch.qos.logback.core.FileAppender"</span><span class="nt">></span> + <span class="nt"><appender</span> <span class="na">name=</span><span class="s">"SSHFILE"</span> <span class="na">class=</span><span class="s">"ch.qos.logback.core.FileAppender"</span><span class="nt">></span> <span class="nt"><file></span>log/jclouds-ssh.log<span class="nt"></file></span> <span class="nt"><encoder></span> @@ -225,115 +222,107 @@ <span class="nt"></appender></span> <span class="nt"><root></span> - <span class="nt"><level</span> <span class="na">value=</span><span class="s">"info"</span> <span class="nt">/></span> + <span class="nt"><level</span> <span class="na">value=</span><span class="s">"info"</span> <span class="nt">/></span> <span class="nt"></root></span> - <span class="nt"><logger</span> <span class="na">name=</span><span class="s">"org.jclouds"</span><span class="nt">></span> - <span class="nt"><level</span> <span class="na">value=</span><span class="s">"DEBUG"</span> <span class="nt">/></span> - <span class="nt"><appender-ref</span> <span class="na">ref=</span><span class="s">"FILE"</span> <span class="nt">/></span> + <span class="nt"><logger</span> <span class="na">name=</span><span class="s">"org.jclouds"</span><span class="nt">></span> + <span class="nt"><level</span> <span class="na">value=</span><span class="s">"DEBUG"</span> <span class="nt">/></span> + <span class="nt"><appender-ref</span> <span class="na">ref=</span><span class="s">"FILE"</span> <span class="nt">/></span> <span class="nt"></logger></span> - <span class="nt"><logger</span> <span class="na">name=</span><span class="s">"jclouds.compute"</span><span class="nt">></span> - <span class="nt"><level</span> <span class="na">value=</span><span class="s">"DEBUG"</span> <span class="nt">/></span> - <span class="nt"><appender-ref</span> <span class="na">ref=</span><span class="s">"COMPUTEFILE"</span> <span class="nt">/></span> + <span class="nt"><logger</span> <span class="na">name=</span><span class="s">"jclouds.compute"</span><span class="nt">></span> + <span class="nt"><level</span> <span class="na">value=</span><span class="s">"DEBUG"</span> <span class="nt">/></span> + <span class="nt"><appender-ref</span> <span class="na">ref=</span><span class="s">"COMPUTEFILE"</span> <span class="nt">/></span> <span class="nt"></logger></span> - <span class="nt"><logger</span> <span class="na">name=</span><span class="s">"jclouds.wire"</span><span class="nt">></span> - <span class="nt"><level</span> <span class="na">value=</span><span class="s">"DEBUG"</span> <span class="nt">/></span> - <span class="nt"><appender-ref</span> <span class="na">ref=</span><span class="s">"WIREFILE"</span> <span class="nt">/></span> + <span class="nt"><logger</span> <span class="na">name=</span><span class="s">"jclouds.wire"</span><span class="nt">></span> + <span class="nt"><level</span> <span class="na">value=</span><span class="s">"DEBUG"</span> <span class="nt">/></span> + <span class="nt"><appender-ref</span> <span class="na">ref=</span><span class="s">"WIREFILE"</span> <span class="nt">/></span> <span class="nt"></logger></span> - <span class="nt"><logger</span> <span class="na">name=</span><span class="s">"jclouds.headers"</span><span class="nt">></span> - <span class="nt"><level</span> <span class="na">value=</span><span class="s">"DEBUG"</span> <span class="nt">/></span> - <span class="nt"><appender-ref</span> <span class="na">ref=</span><span class="s">"WIREFILE"</span> <span class="nt">/></span> + <span class="nt"><logger</span> <span class="na">name=</span><span class="s">"jclouds.headers"</span><span class="nt">></span> + <span class="nt"><level</span> <span class="na">value=</span><span class="s">"DEBUG"</span> <span class="nt">/></span> + <span class="nt"><appender-ref</span> <span class="na">ref=</span><span class="s">"WIREFILE"</span> <span class="nt">/></span> <span class="nt"></logger></span> - <span class="nt"><logger</span> <span class="na">name=</span><span class="s">"jclouds.ssh"</span><span class="nt">></span> - <span class="nt"><level</span> <span class="na">value=</span><span class="s">"DEBUG"</span> <span class="nt">/></span> - <span class="nt"><appender-ref</span> <span class="na">ref=</span><span class="s">"SSHFILE"</span> <span class="nt">/></span> + <span class="nt"><logger</span> <span class="na">name=</span><span class="s">"jclouds.ssh"</span><span class="nt">></span> + <span class="nt"><level</span> <span class="na">value=</span><span class="s">"DEBUG"</span> <span class="nt">/></span> + <span class="nt"><appender-ref</span> <span class="na">ref=</span><span class="s">"SSHFILE"</span> <span class="nt">/></span> <span class="nt"></logger></span> - <span class="nt"><logger</span> <span class="na">name=</span><span class="s">"net.schmizz"</span><span class="nt">></span> - <span class="nt"><level</span> <span class="na">value=</span><span class="s">"DEBUG"</span> <span class="nt">/></span> - <span class="nt"><appender-ref</span> <span class="na">ref=</span><span class="s">"SSHFILE"</span> <span class="nt">/></span> + <span class="nt"><logger</span> <span class="na">name=</span><span class="s">"net.schmizz"</span><span class="nt">></span> + <span class="nt"><level</span> <span class="na">value=</span><span class="s">"DEBUG"</span> <span class="nt">/></span> + <span class="nt"><appender-ref</span> <span class="na">ref=</span><span class="s">"SSHFILE"</span> <span class="nt">/></span> <span class="nt"></logger></span> -<span class="nt"></configuration></span> -</code></pre></div> - +<span class="nt"></configuration></span></code></pre></figure> -<h2><a id="enable"></a>Enable Logging</h2> +<h2 id="enable-logging"><a id="enable"></a>Enable Logging</h2> -<p>Below is some example code of how to enable your code to use SLF4J. The <code>SLF4JLoggingModule</code> needs to be added to the <code>modules</code> collection that is passed into the <code>ContextBuilder.modules(Iterable)</code> method of whatever Context or Api you're building.</p> +<p>Below is some example code of how to enable your code to use SLF4J. The <code class="language-plaintext highlighter-rouge">SLF4JLoggingModule</code> needs to be added to the <code class="language-plaintext highlighter-rouge">modules</code> collection that is passed into the <code class="language-plaintext highlighter-rouge">ContextBuilder.modules(Iterable)</code> method of whatever Context or Api youâre building.</p> -<div class="highlight"><pre><code class="java"><span class="n">Iterable</span><span class="o"><</span><span class="n">Module</span><span class="o">></span> <span class="n">modules</span> <span class="o">=</span> <span class="n">ImmutableSet</span><span class="o">.<</span><span class="n">Module</span><span class="o">></span> <span class="n">of</span><span class="o">(</span> +<figure class="highlight"><pre><code class="language-java" data-lang="java"><span class="nc">Iterable</span><span class="o"><</span><span class="nc">Module</span><span class="o">></span> <span class="n">modules</span> <span class="o">=</span> <span class="nc">ImmutableSet</span><span class="o">.<</span><span class="nc">Module</span><span class="o">></span> <span class="nf">of</span><span class="o">(</span> <span class="k">new</span> <span class="nf">SLF4JLoggingModule</span><span class="o">());</span> -<span class="n">MyContext</span> <span class="n">context</span> <span class="o">=</span> <span class="n">ContextBuilder</span><span class="o">.</span><span class="na">newBuilder</span><span class="o">(</span><span class="s">"my-cloud-provider"</span><span class="o">)</span> - <span class="o">.</span><span class="na">credentials</span><span class="o">(</span><span class="s">"myIdentity"</span><span class="o">,</span> <span class="s">"myCredential"</span><span class="o">)</span> +<span class="nc">MyContext</span> <span class="n">context</span> <span class="o">=</span> <span class="nc">ContextBuilder</span><span class="o">.</span><span class="na">newBuilder</span><span class="o">(</span><span class="s">"my-cloud-provider"</span><span class="o">)</span> + <span class="o">.</span><span class="na">credentials</span><span class="o">(</span><span class="s">"myIdentity"</span><span class="o">,</span> <span class="s">"myCredential"</span><span class="o">)</span> <span class="o">.</span><span class="na">modules</span><span class="o">(</span><span class="n">modules</span><span class="o">)</span> - <span class="o">.</span><span class="na">buildView</span><span class="o">(</span><span class="n">MyContext</span><span class="o">.</span><span class="na">class</span><span class="o">);</span> + <span class="o">.</span><span class="na">buildView</span><span class="o">(</span><span class="nc">MyContext</span><span class="o">.</span><span class="na">class</span><span class="o">);</span> <span class="c1">// Or</span> -<span class="n">MyApi</span> <span class="n">myApi</span> <span class="o">=</span> <span class="n">ContextBuilder</span><span class="o">.</span><span class="na">newBuilder</span><span class="o">(</span><span class="s">"my-cloud-provider"</span><span class="o">)</span> - <span class="o">.</span><span class="na">credentials</span><span class="o">(</span><span class="s">"myIdentity"</span><span class="o">,</span> <span class="s">"myCredential"</span><span class="o">)</span> +<span class="nc">MyApi</span> <span class="n">myApi</span> <span class="o">=</span> <span class="nc">ContextBuilder</span><span class="o">.</span><span class="na">newBuilder</span><span class="o">(</span><span class="s">"my-cloud-provider"</span><span class="o">)</span> + <span class="o">.</span><span class="na">credentials</span><span class="o">(</span><span class="s">"myIdentity"</span><span class="o">,</span> <span class="s">"myCredential"</span><span class="o">)</span> <span class="o">.</span><span class="na">modules</span><span class="o">(</span><span class="n">modules</span><span class="o">)</span> - <span class="o">.</span><span class="na">buildApi</span><span class="o">(</span><span class="n">MyApi</span><span class="o">.</span><span class="na">class</span><span class="o">);</span> -</code></pre></div> + <span class="o">.</span><span class="na">buildApi</span><span class="o">(</span><span class="nc">MyApi</span><span class="o">.</span><span class="na">class</span><span class="o">);</span></code></pre></figure> - -<h2><a id="proxy"></a>HTTP(S) Proxy</h2> +<h2 id="https-proxy"><a id="proxy"></a>HTTP(S) Proxy</h2> <p>This is optional and not necessary for regular jclouds logging.</p> -<p>There may be times when you need to see every bit and byte being sent with jclouds to/from a cloud provider. To do this you can use an HTTP(S) proxy to capture all traffic that's being transmitted, like <a href="https://www.charlesproxy.com/";>Charles Proxy</a> or <a href="https://www.telerik.com/fiddler";>Fiddler</a>.</p> +<p>There may be times when you need to see every bit and byte being sent with jclouds to/from a cloud provider. To do this you can use an HTTP(S) proxy to capture all traffic thatâs being transmitted, like <a href="https://www.charlesproxy.com/";>Charles Proxy</a> or <a href="https://www.telerik.com/fiddler";>Fiddler</a>.</p> <p>For example, to work with an HTTPS endpoint of a cloud provider using Charles you need to enable SSL Proxying:</p> <ol> -<li>Proxy > Proxy Settings > SSL tab</li> -<li>Check Enable SSL Proxying</li> -<li>Add Locations, e.g. - -<ol> -<li>*.rackspacecloud.com</li> -<li>*.clouddrive.com</li> -</ol> -</li> + <li>Proxy > Proxy Settings > SSL tab</li> + <li>Check Enable SSL Proxying</li> + <li>Add Locations, e.g. + <ol> + <li>*.rackspacecloud.com</li> + <li>*.clouddrive.com</li> + </ol> + </li> </ol> - <p>jclouds also requires some configuration to use a proxy.</p> -<div class="highlight"><pre><code class="java"><span class="kn">import</span> <span class="nn">static</span> <span class="n">org</span><span class="o">.</span><span class="na">jclouds</span><span class="o">.</span><span class="na">Constants</span><span class="o">.*;</span> +<figure class="highlight"><pre><code class="language-java" data-lang="java"><span class="kn">import</span> <span class="nn">static</span> <span class="n">org</span><span class="o">.</span><span class="na">jclouds</span><span class="o">.</span><span class="na">Constants</span><span class="o">.*;</span> <span class="c1">// snip</span> -<span class="n">Properties</span> <span class="n">overrides</span> <span class="o">=</span> <span class="k">new</span> <span class="n">Properties</span><span class="o">();</span> -<span class="n">overrides</span><span class="o">.</span><span class="na">setProperty</span><span class="o">(</span><span class="n">PROPERTY_PROXY_HOST</span><span class="o">,</span> <span class="s">"localhost"</span><span class="o">);</span> -<span class="n">overrides</span><span class="o">.</span><span class="na">setProperty</span><span class="o">(</span><span class="n">PROPERTY_PROXY_PORT</span><span class="o">,</span> <span class="s">"8888"</span><span class="o">);</span> -<span class="n">overrides</span><span class="o">.</span><span class="na">setProperty</span><span class="o">(</span><span class="n">PROPERTY_TRUST_ALL_CERTS</span><span class="o">,</span> <span class="s">"true"</span><span class="o">);</span> +<span class="nc">Properties</span> <span class="n">overrides</span> <span class="o">=</span> <span class="k">new</span> <span class="nc">Properties</span><span class="o">();</span> +<span class="n">overrides</span><span class="o">.</span><span class="na">setProperty</span><span class="o">(</span><span class="no">PROPERTY_PROXY_HOST</span><span class="o">,</span> <span class="s">"localhost"</span><span class="o">);</span> +<span class="n">overrides</span><span class="o">.</span><span class="na">setProperty</span><span class="o">(</span><span class="no">PROPERTY_PROXY_PORT</span><span class="o">,</span> <span class="s">"8888"</span><span class="o">);</span> +<span class="n">overrides</span><span class="o">.</span><span class="na">setProperty</span><span class="o">(</span><span class="no">PROPERTY_TRUST_ALL_CERTS</span><span class="o">,</span> <span class="s">"true"</span><span class="o">);</span> -<span class="n">Iterable</span><span class="o"><</span><span class="n">Module</span><span class="o">></span> <span class="n">modules</span> <span class="o">=</span> <span class="n">ImmutableSet</span><span class="o">.<</span><span class="n">Module</span><span class="o">></span> <span class="n">of</span><span class="o">(</span> +<span class="nc">Iterable</span><span class="o"><</span><span class="nc">Module</span><span class="o">></span> <span class="n">modules</span> <span class="o">=</span> <span class="nc">ImmutableSet</span><span class="o">.<</span><span class="nc">Module</span><span class="o">></span> <span class="nf">of</span><span class="o">(</span> <span class="k">new</span> <span class="nf">SLF4JLoggingModule</span><span class="o">());</span> -<span class="n">MyContext</span> <span class="n">context</span> <span class="o">=</span> <span class="n">ContextBuilder</span><span class="o">.</span><span class="na">newBuilder</span><span class="o">(</span><span class="s">"my-cloud-provider"</span><span class="o">)</span> - <span class="o">.</span><span class="na">credentials</span><span class="o">(</span><span class="s">"myIdentity"</span><span class="o">,</span> <span class="s">"myCredential"</span><span class="o">)</span> +<span class="nc">MyContext</span> <span class="n">context</span> <span class="o">=</span> <span class="nc">ContextBuilder</span><span class="o">.</span><span class="na">newBuilder</span><span class="o">(</span><span class="s">"my-cloud-provider"</span><span class="o">)</span> + <span class="o">.</span><span class="na">credentials</span><span class="o">(</span><span class="s">"myIdentity"</span><span class="o">,</span> <span class="s">"myCredential"</span><span class="o">)</span> <span class="o">.</span><span class="na">modules</span><span class="o">(</span><span class="n">modules</span><span class="o">)</span> <span class="o">.</span><span class="na">overrides</span><span class="o">(</span><span class="n">overrides</span><span class="o">)</span> - <span class="o">.</span><span class="na">buildView</span><span class="o">(</span><span class="n">MyContext</span><span class="o">.</span><span class="na">class</span><span class="o">);</span> + <span class="o">.</span><span class="na">buildView</span><span class="o">(</span><span class="nc">MyContext</span><span class="o">.</span><span class="na">class</span><span class="o">);</span> <span class="c1">// Or</span> -<span class="n">MyApi</span> <span class="n">myApi</span> <span class="o">=</span> <span class="n">ContextBuilder</span><span class="o">.</span><span class="na">newBuilder</span><span class="o">(</span><span class="s">"my-cloud-provider"</span><span class="o">)</span> - <span class="o">.</span><span class="na">credentials</span><span class="o">(</span><span class="s">"myIdentity"</span><span class="o">,</span> <span class="s">"myCredential"</span><span class="o">)</span> +<span class="nc">MyApi</span> <span class="n">myApi</span> <span class="o">=</span> <span class="nc">ContextBuilder</span><span class="o">.</span><span class="na">newBuilder</span><span class="o">(</span><span class="s">"my-cloud-provider"</span><span class="o">)</span> + <span class="o">.</span><span class="na">credentials</span><span class="o">(</span><span class="s">"myIdentity"</span><span class="o">,</span> <span class="s">"myCredential"</span><span class="o">)</span> <span class="o">.</span><span class="na">modules</span><span class="o">(</span><span class="n">modules</span><span class="o">)</span> <span class="o">.</span><span class="na">overrides</span><span class="o">(</span><span class="n">overrides</span><span class="o">)</span> - <span class="o">.</span><span class="na">buildApi</span><span class="o">(</span><span class="n">MyApi</span><span class="o">.</span><span class="na">class</span><span class="o">);</span> -</code></pre></div> - + <span class="o">.</span><span class="na">buildApi</span><span class="o">(</span><span class="nc">MyApi</span><span class="o">.</span><span class="na">class</span><span class="o">);</span></code></pre></figure> -<p>When you make requests to an API through Charles, you'll see that all request/response information has been captured in one of it's sessions.</p> +<p>When you make requests to an API through Charles, youâll see that all request/response information has been captured in one of itâs sessions.</p> <div class="row clearfix"> <div id="footer" class="col-md-12 column"> Modified: jclouds/site-content/reference/providers/index.html URL: http://svn.apache.org/viewvc/jclouds/site-content/reference/providers/index.html?rev=1923693&r1=1923692&r2=1923693&view=diff ============================================================================== --- jclouds/site-content/reference/providers/index.html (original) +++ jclouds/site-content/reference/providers/index.html Mon Feb 10 07:25:53 2025 @@ -152,32 +152,27 @@ <p>The following is the list of providers that are supported by the jclouds API.</p> <ol> -<li><a href="#compute">ComputeService</a> - -<ol> -<li><a href="#compute-providers">ComputeService Providers</a></li> -<li><a href="#compute-apis">ComputeService APIs</a></li> -</ol> -</li> -<li><a href="#blobstore">BlobStore</a> - -<ol> -<li><a href="#blobstore-providers">BlobStore Providers</a></li> -<li><a href="#blobstore-apis">BlobStore APIs</a></li> -</ol> -</li> -<li><a href="#loadbalancer">LoadBalancer</a> (Beta) - -<ol> -<li><a href="#loadbalancer-providers">LoadBalancer Providers</a></li> -</ol> -</li> + <li><a href="#compute">ComputeService</a> + <ol> + <li><a href="#compute-providers">ComputeService Providers</a></li> + <li><a href="#compute-apis">ComputeService APIs</a></li> + </ol> + </li> + <li><a href="#blobstore">BlobStore</a> + <ol> + <li><a href="#blobstore-providers">BlobStore Providers</a></li> + <li><a href="#blobstore-apis">BlobStore APIs</a></li> + </ol> + </li> + <li><a href="#loadbalancer">LoadBalancer</a> (Beta) + <ol> + <li><a href="#loadbalancer-providers">LoadBalancer Providers</a></li> + </ol> + </li> </ol> - -<h2><a id="compute"></a>ComputeService</h2> - -<h3><a id="compute-providers"></a>Providers</h3> +<h2 id="computeservice"><a id="compute"></a>ComputeService</h2> +<h3 id="providers"><a id="compute-providers"></a>Providers</h3> <p>The Maven Group ID for all supported providers below is <a href="https://search.maven.org/#search%7Cga%7C1%7Corg.apache.jclouds.provider";>org.apache.jclouds.provider</a>. Providers in labs (denoted by *) are under <a href="https://search.maven.org/#search%7Cga%7C1%7Corg.apache.jclouds.labs";>org.apache.jclouds.labs</a>.</p> @@ -353,15 +348,14 @@ <tr> <td><a href="/guides/softlayer/">SoftLayer</a></td> <td>softlayer</td> - <td>SG,US-CA,US-TX,US-VA,US-WA,<p/>NL,HK,NSFTW-IL,AU,CA-ON,GB</td> + <td>SG,US-CA,US-TX,US-VA,US-WA,<p />NL,HK,NSFTW-IL,AU,CA-ON,GB</td> </tr> </tbody> </table> +<h3 id="apis"><a id="compute-apis"></a>APIs</h3> -<h3><a id="compute-apis"></a>APIs</h3> - -<p>You can also set the context property <code>[Artifact ID].endpoint</code> to use the following APIs for your private cloud.</p> +<p>You can also set the context property <code class="language-plaintext highlighter-rouge">[Artifact ID].endpoint</code> to use the following APIs for your private cloud.</p> <p>The Maven Group ID for all supported APIs below is <a href="https://search.maven.org/#search%7Cga%7C1%7Corg.apache.jclouds.api";>org.apache.jclouds.api</a>. Providers in labs (denoted by *) are under <a href="https://search.maven.org/#search%7Cga%7C1%7Corg.apache.jclouds.labs";>org.apache.jclouds.labs</a>.</p> @@ -412,10 +406,8 @@ </tbody> </table> - -<h2><a id="blobstore"></a>BlobStore</h2> - -<h3><a id="blobstore-providers"></a>Providers</h3> +<h2 id="blobstore"><a id="blobstore"></a>BlobStore</h2> +<h3 id="providers-1"><a id="blobstore-providers"></a>Providers</h3> <p>The Maven Group ID for all supported providers below is <a href="https://search.maven.org/#search%7Cga%7C1%7Corg.apache.jclouds.provider";>org.apache.jclouds.provider</a>. Providers in labs (denoted by *) are under <a href="https://search.maven.org/#search%7Cga%7C1%7Corg.apache.jclouds.labs";>org.apache.jclouds.labs</a>.</p> @@ -454,10 +446,9 @@ </tbody> </table> +<h3 id="apis-1"><a id="blobstore-apis"></a>APIs</h3> -<h3><a id="blobstore-apis"></a>APIs</h3> - -<p>You can also set the context property <code>[Artifact ID].endpoint</code> to use the following APIs for your private cloud.</p> +<p>You can also set the context property <code class="language-plaintext highlighter-rouge">[Artifact ID].endpoint</code> to use the following APIs for your private cloud.</p> <p>The Maven Group ID for all supported APIs below is <a href="https://search.maven.org/#search%7Cga%7C1%7Corg.apache.jclouds.api";>org.apache.jclouds.api</a>. Providers in labs (denoted by *) are under <a href="https://search.maven.org/#search%7Cga%7C1%7Corg.apache.jclouds.labs";>org.apache.jclouds.labs</a>.</p> @@ -488,10 +479,8 @@ </tbody> </table> - -<h2><a id="loadbalancer"></a>LoadBalancer (Beta)</h2> - -<h3><a id="loadbalancer-providers"></a>Providers</h3> +<h2 id="loadbalancer-beta"><a id="loadbalancer"></a>LoadBalancer (Beta)</h2> +<h3 id="providers-2"><a id="loadbalancer-providers"></a>Providers</h3> <p>The Maven Group ID for all supported providers below is <a href="https://search.maven.org/#search%7Cga%7C1%7Corg.apache.jclouds.provider";>org.apache.jclouds.provider</a>. Providers in labs (denoted by *) are under <a href="https://search.maven.org/#search%7Cga%7C1%7Corg.apache.jclouds.labs";>org.apache.jclouds.labs</a>.</p> @@ -518,7 +507,6 @@ </tbody> </table> - <div class="row clearfix"> <div id="footer" class="col-md-12 column"> <div id="footer"> Modified: jclouds/site-content/reference/report-a-bug/index.html URL: http://svn.apache.org/viewvc/jclouds/site-content/reference/report-a-bug/index.html?rev=1923693&r1=1923692&r2=1923693&view=diff ============================================================================== --- jclouds/site-content/reference/report-a-bug/index.html (original) +++ jclouds/site-content/reference/report-a-bug/index.html Mon Feb 10 07:25:53 2025 @@ -149,7 +149,7 @@ <div class="page-header"> <h1>Report a Bug</h1> </div> - <p>If you run into a bug while using jclouds, we encourage you to report it. To help us help you, please collect as much of the following information as possible. If you can't get everything, that's okay. Send what you can.</p> + <p>If you run into a bug while using jclouds, we encourage you to report it. To help us help you, please collect as much of the following information as possible. If you canât get everything, thatâs okay. Send what you can.</p> <p>Bugs can be reported in <a href="https://issues.apache.org/jira/browse/JCLOUDS";>JIRA</a> or via the <a href="/community/">jclouds user mailing list</a>.</p> @@ -159,49 +159,45 @@ <tbody> <tr> <td><strong>jclouds version</strong></td> - <td>The version of jclouds can be found in the name of the JAR files you are using in your application or the pom.xml file of your application if you're using Maven.<br/> + <td>The version of jclouds can be found in the name of the JAR files you are using in your application or the pom.xml file of your application if you're using Maven.<br /> <em>e.g. 1.7.1</em></td> </tr> <tr> <td><strong>Provider or API version</strong></td> - <td>If you are using a private cloud such as OpenStack, CloudStack, or vCloud, you might be able to report the Cloud and API version.<br/> + <td>If you are using a private cloud such as OpenStack, CloudStack, or vCloud, you might be able to report the Cloud and API version.<br /> <em>e.g. Cloud and API Version: OpenStack Havana, Cinder API v2</em></td> </tr> <tr> <td><strong>Operating system</strong></td> - <td>The Operating System Version you're using.<br/> + <td>The Operating System Version you're using.<br /> <em>e.g. Operating System Version: Mac OS X 10.7.5</em></td> </tr> <tr> <td><strong>Java version</strong></td> - <td>The Java version you're using.<br/> + <td>The Java version you're using.<br /> <em>e.g. "1.7.0_51"</em></td> </tr> </tbody> </table> - - - <div class="alert alert-danger"> <span class="glyphicon glyphicon-exclamation-sign" aria-hidden="true"></span> Please remember to <strong>remove all credentials and other sensitive information</strong> from anything you share! </div> +<h2 id="collecting-logs"><a id="logs"></a>Collecting logs</h2> -<h2><a id="logs"></a>Collecting logs</h2> - -<p>Sending us the stack trace from the exception is helpful but often the root cause of the problem can be revealed by examining what's being sent over the wire. Please read <a href="/reference/logging/">Logging</a> to install, configure, and enable logging.</p> +<p>Sending us the stack trace from the exception is helpful but often the root cause of the problem can be revealed by examining whatâs being sent over the wire. Please read <a href="/reference/logging/">Logging</a> to install, configure, and enable logging.</p> -<p>If you are reporting the bug in JIRA, you can simply attach the <code>jclouds-wire.log</code> and other logs to the issue. If you are sending the report to the user mailing list, please put the logs into a <a href="https://gist.github.com/";>gist</a> or <a href="http://pastie.org/";>pastie</a> and include the link in the email.</p> +<p>If you are reporting the bug in JIRA, you can simply attach the <code class="language-plaintext highlighter-rouge">jclouds-wire.log</code> and other logs to the issue. If you are sending the report to the user mailing list, please put the logs into a <a href="https://gist.github.com/";>gist</a> or <a href="http://pastie.org/";>pastie</a> and include the link in the email.</p> -<h2><a id="code"></a>Providing relevant code</h2> +<h2 id="providing-relevant-code"><a id="code"></a>Providing relevant code</h2> -<p>If you can isolate the problem within a single Java file, send us that file so we can attempt to immediately reproduce the error. If you can't isolate the problem, send us as large a code snippet as possible around the problem code.</p> +<p>If you can isolate the problem within a single Java file, send us that file so we can attempt to immediately reproduce the error. If you canât isolate the problem, send us as large a code snippet as possible around the problem code.</p> <p>If you are reporting the bug in JIRA, you can simply attach the code to the issue. If you are sending the report to the user mailing list, please put the code into a <a href="https://gist.github.com/";>gist</a> or <a href="http://pastie.org/";>pastie</a> and include the link in the email.</p> -<h2><a id="doc"></a>Reporting documentation issues</h2> +<h2 id="reporting-documentation-issues"><a id="doc"></a>Reporting documentation issues</h2> <p>If you find a bug in the documentation, you can report that via JIRA or the user mailing list too. However it is quite easy to fix the documentation (this website) and we encourage you to do so by reading <a href="https://cwiki.apache.org/confluence/display/JCLOUDS/How+to+Contribute+Documentation";>How to Contribute Documentation</a>.</p> Modified: jclouds/site-content/reference/troubleshooting/index.html URL: http://svn.apache.org/viewvc/jclouds/site-content/reference/troubleshooting/index.html?rev=1923693&r1=1923692&r2=1923693&view=diff ============================================================================== --- jclouds/site-content/reference/troubleshooting/index.html (original) +++ jclouds/site-content/reference/troubleshooting/index.html Mon Feb 10 07:25:53 2025 @@ -149,94 +149,83 @@ <div class="page-header"> <h1>Troubleshooting</h1> </div> - <p>This reference will give you some tips on general jclouds troubleshooting as well as solutions to specific classes of problems. If you have a tip or solution to add, please click the "Fix This Page" link at the bottom of this page!</p> + <p>This reference will give you some tips on general jclouds troubleshooting as well as solutions to specific classes of problems. If you have a tip or solution to add, please click the âFix This Pageâ link at the bottom of this page!</p> <ul> -<li><a href="#general">General Tips</a> - -<ul> -<li><a href="#logging">Logging</a></li> -<li><a href="#classpath">Classpath</a></li> -<li><a href="#source">Source Code</a></li> -</ul> -</li> -<li><a href="#specific">Specific Solutions</a> - -<ul> -<li><a href="#NoSuchElementException">NoSuchElementException</a></li> -<li><a href="#ConfigurationException">ConfigurationException</a></li> -</ul> -</li> + <li><a href="#general">General Tips</a> + <ul> + <li><a href="#logging">Logging</a></li> + <li><a href="#classpath">Classpath</a></li> + <li><a href="#source">Source Code</a></li> + </ul> + </li> + <li><a href="#specific">Specific Solutions</a> + <ul> + <li><a href="#NoSuchElementException">NoSuchElementException</a></li> + <li><a href="#ConfigurationException">ConfigurationException</a></li> + </ul> + </li> </ul> +<h2 id="general-tips"><a id="general"></a>General Tips</h2> -<h2><a id="general"></a>General Tips</h2> - -<h3><a id="logging"></a>Logging</h3> +<h3 id="logging"><a id="logging"></a>Logging</h3> <p><a href="/reference/logging/">Enabling logging</a> in jclouds will give you a lot of insight into what jclouds is doing.</p> -<h3><a id="classpath"></a>Classpath</h3> +<h3 id="classpath"><a id="classpath"></a>Classpath</h3> -<p>Check your classpath to ensure you're using the JARs you think you are and that your jclouds JARs are all of the same version.</p> +<p>Check your classpath to ensure youâre using the JARs you think you are and that your jclouds JARs are all of the same version.</p> <p>In the directory with your Maven pom.xml file run the command</p> -<p><code>mvn dependency:tree</code></p> +<p><code class="language-plaintext highlighter-rouge">mvn dependency:tree</code></p> <p>This will tell you exactly what all of your dependencies are and all of their versions.</p> <p>To determine what JARs are actually being loaded when your application runs, read the answers to <a href="https://stackoverflow.com/questions/2179858/how-to-find-which-jars-and-in-what-order-are-loaded-by-a-classloader";>How to find which jars and in what order are loaded by a classloader?</a></p> -<p>If you're using Java 8, you can use the <a href="https://docs.oracle.com/javase/8/docs/technotes/tools/unix/jdeps.html";>jdeps</a> to analyze dependencies.</p> +<p>If youâre using Java 8, you can use the <a href="https://docs.oracle.com/javase/8/docs/technotes/tools/unix/jdeps.html";>jdeps</a> to analyze dependencies.</p> -<h3><a id="source"></a>Source Code</h3> +<h3 id="source-code"><a id="source"></a>Source Code</h3> <p>Having a look a the source code will tell you exactly what jclouds is doing. The source code can be viewed directly on <a href="https://github.com/apache/jclouds";>GitHub</a> or <a href="https://www.apache.org/dyn/closer.cgi/jclouds";>downloaded</a> from an ASF mirror repository.</p> -<h2><a id="specfic"></a>Specific Solutions</h2> +<h2 id="specific-solutions"><a id="specfic"></a>Specific Solutions</h2> -<h3><a id="NoSuchElementException"></a>NoSuchElementException</h3> +<h3 id="nosuchelementexception"><a id="NoSuchElementException"></a>NoSuchElementException</h3> -<pre><code>java.util.NoSuchElementException: key [openstack-nova] not in the list of providers or apis: +<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>java.util.NoSuchElementException: key [openstack-nova] not in the list of providers or apis: {apis=[transient, openstack-cinder, openstack-glance, openstack-keystone, openstack-marconi, openstack-neutron, openstack-trove, swift, swift-keystone]} -</code></pre> +</code></pre></div></div> <p>This can be caused by a missing dependency (JAR file) on your classpath. In the exception above, the cloud provider name being used is openstack-nova but the openstack-nova-X.X.X.jar is not on the classpath. Run through the <a href="#classpath">Classpath</a> tip to determine how and why that JAR is missing.</p> -<p>This can also be caused by a misspelling of the cloud provider name. Read the name after "key" very carefully, it must match the prefix of the name of the JAR file exactly. The "key" is inputted when creating a view or api.</p> - -<div class="highlight"><pre><code class="java"><span class="n">NovaApi</span> <span class="n">novaApi</span> <span class="o">=</span> <span class="n">ContextBuilder</span><span class="o">.</span><span class="na">newBuilder</span><span class="o">(</span><span class="s">"openstack-nova"</span><span class="o">)</span> - <span class="o">.</span><span class="na">credentials</span><span class="o">(</span><span class="n">USERNAME</span><span class="o">,</span> <span class="n">API_KEY</span><span class="o">)</span> - <span class="o">.</span><span class="na">buildApi</span><span class="o">(</span><span class="n">NovaApi</span><span class="o">.</span><span class="na">class</span><span class="o">);</span> -</code></pre></div> - +<p>This can also be caused by a misspelling of the cloud provider name. Read the name after âkeyâ very carefully, it must match the prefix of the name of the JAR file exactly. The âkeyâ is inputted when creating a view or api.</p> -<h3><a id="ConfigurationException"></a>ConfigurationException</h3> +<figure class="highlight"><pre><code class="language-java" data-lang="java"><span class="nc">NovaApi</span> <span class="n">novaApi</span> <span class="o">=</span> <span class="nc">ContextBuilder</span><span class="o">.</span><span class="na">newBuilder</span><span class="o">(</span><span class="s">"openstack-nova"</span><span class="o">)</span> + <span class="o">.</span><span class="na">credentials</span><span class="o">(</span><span class="no">USERNAME</span><span class="o">,</span> <span class="no">API_KEY</span><span class="o">)</span> + <span class="o">.</span><span class="na">buildApi</span><span class="o">(</span><span class="nc">NovaApi</span><span class="o">.</span><span class="na">class</span><span class="o">);</span></code></pre></figure> -<pre><code>com.google.inject.ConfigurationException: Guice configuration errors: +<h3 id="configurationexception"><a id="ConfigurationException"></a>ConfigurationException</h3> +<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>com.google.inject.ConfigurationException: Guice configuration errors: 1) No implementation for org.jclouds.rackspace.cloudfiles.v1.CloudFilesApi was bound. while locating org.jclouds.rackspace.cloudfiles.v1.CloudFilesApi ... -</code></pre> +</code></pre></div></div> <p>This is caused by a misconfiguration when creating a view or api.</p> -<div class="highlight"><pre><code class="java"><span class="n">CloudFilesApi</span> <span class="n">cloudFilesApi</span> <span class="o">=</span> <span class="n">ContextBuilder</span><span class="o">.</span><span class="na">newBuilder</span><span class="o">(</span><span class="s">"openstack-swift"</span><span class="o">)</span> +<figure class="highlight"><pre><code class="language-java" data-lang="java"><span class="nc">CloudFilesApi</span> <span class="n">cloudFilesApi</span> <span class="o">=</span> <span class="nc">ContextBuilder</span><span class="o">.</span><span class="na">newBuilder</span><span class="o">(</span><span class="s">"openstack-swift"</span><span class="o">)</span> <span class="o">.</span><span class="na">credentials</span><span class="o">(</span><span class="n">username</span><span class="o">,</span> <span class="n">apiKey</span><span class="o">)</span> - <span class="o">.</span><span class="na">buildApi</span><span class="o">(</span><span class="n">CloudFilesApi</span><span class="o">.</span><span class="na">class</span><span class="o">);</span> -</code></pre></div> + <span class="o">.</span><span class="na">buildApi</span><span class="o">(</span><span class="nc">CloudFilesApi</span><span class="o">.</span><span class="na">class</span><span class="o">);</span></code></pre></figure> +<p>The provider String you pass to <code class="language-plaintext highlighter-rouge">ContextBuilder.newBuilder(String)</code> must match the view or api you are creating.</p> -<p>The provider String you pass to <code>ContextBuilder.newBuilder(String)</code> must match the view or api you are creating.</p> - -<div class="highlight"><pre><code class="java"><span class="n">CloudFilesApi</span> <span class="n">cloudFilesApi</span> <span class="o">=</span> <span class="n">ContextBuilder</span><span class="o">.</span><span class="na">newBuilder</span><span class="o">(</span><span class="s">"rackspace-cloudfiles-us"</span><span class="o">)</span> +<figure class="highlight"><pre><code class="language-java" data-lang="java"><span class="nc">CloudFilesApi</span> <span class="n">cloudFilesApi</span> <span class="o">=</span> <span class="nc">ContextBuilder</span><span class="o">.</span><span class="na">newBuilder</span><span class="o">(</span><span class="s">"rackspace-cloudfiles-us"</span><span class="o">)</span> <span class="o">.</span><span class="na">credentials</span><span class="o">(</span><span class="n">username</span><span class="o">,</span> <span class="n">apiKey</span><span class="o">)</span> - <span class="o">.</span><span class="na">buildApi</span><span class="o">(</span><span class="n">CloudFilesApi</span><span class="o">.</span><span class="na">class</span><span class="o">);</span> -</code></pre></div> - - + <span class="o">.</span><span class="na">buildApi</span><span class="o">(</span><span class="nc">CloudFilesApi</span><span class="o">.</span><span class="na">class</span><span class="o">);</span></code></pre></figure> <div class="row clearfix">
