You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@libcloud.apache.org by bu...@apache.org on 2011/11/02 02:03:27 UTC
svn commit: r797916 - in /websites/staging/libcloud/trunk/content/docs:
compute-base-api.html compute-deployment.html compute-overview.html
debugging.html index.html
Author: buildbot
Date: Wed Nov 2 01:03:26 2011
New Revision: 797916
Log:
Staging update by buildbot
Added:
websites/staging/libcloud/trunk/content/docs/debugging.html
Modified:
websites/staging/libcloud/trunk/content/docs/compute-base-api.html
websites/staging/libcloud/trunk/content/docs/compute-deployment.html
websites/staging/libcloud/trunk/content/docs/compute-overview.html
websites/staging/libcloud/trunk/content/docs/index.html
Modified: websites/staging/libcloud/trunk/content/docs/compute-base-api.html
==============================================================================
--- websites/staging/libcloud/trunk/content/docs/compute-base-api.html (original)
+++ websites/staging/libcloud/trunk/content/docs/compute-base-api.html Wed Nov 2 01:03:26 2011
@@ -45,6 +45,12 @@
<li class="title">Storage</li>
<li class="title">Load Balancer</li>
</ul>
+ <li>Other</li>
+ <ul>
+ <ul>
+ <li><a href="debugging.html">Debugging</a></li>
+ </ul>
+ </ul>
<li><a href="/apidocs">Generated API docs</a></li>
</ul>
Modified: websites/staging/libcloud/trunk/content/docs/compute-deployment.html
==============================================================================
--- websites/staging/libcloud/trunk/content/docs/compute-deployment.html (original)
+++ websites/staging/libcloud/trunk/content/docs/compute-deployment.html Wed Nov 2 01:03:26 2011
@@ -45,6 +45,12 @@
<li class="title">Storage</li>
<li class="title">Load Balancer</li>
</ul>
+ <li>Other</li>
+ <ul>
+ <ul>
+ <li><a href="debugging.html">Debugging</a></li>
+ </ul>
+ </ul>
<li><a href="/apidocs">Generated API docs</a></li>
</ul>
Modified: websites/staging/libcloud/trunk/content/docs/compute-overview.html
==============================================================================
--- websites/staging/libcloud/trunk/content/docs/compute-overview.html (original)
+++ websites/staging/libcloud/trunk/content/docs/compute-overview.html Wed Nov 2 01:03:26 2011
@@ -45,6 +45,12 @@
<li class="title">Storage</li>
<li class="title">Load Balancer</li>
</ul>
+ <li>Other</li>
+ <ul>
+ <ul>
+ <li><a href="debugging.html">Debugging</a></li>
+ </ul>
+ </ul>
<li><a href="/apidocs">Generated API docs</a></li>
</ul>
Added: websites/staging/libcloud/trunk/content/docs/debugging.html
==============================================================================
--- websites/staging/libcloud/trunk/content/docs/debugging.html (added)
+++ websites/staging/libcloud/trunk/content/docs/debugging.html Wed Nov 2 01:03:26 2011
@@ -0,0 +1,122 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+ <title>Apache Libcloud Python library - Debugging</title>
+ <meta http-equiv="Content-Type" content="text/html;charset=utf-8">
+ <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.3.2/jquery.min.js" type="text/javascript"></script>
+ <script src="http://ajax.googleapis.com/ajax/libs/jqueryui/1.7.2/jquery-ui.min.js" type="text/javascript"></script>
+ <script src="/js/clearlink.js" type="text/javascript"></script>
+ <script src="/js/libcloud.js" type="text/javascript"></script>
+ <link rel="stylesheet" href="/css/screen.css" type="text/css">
+ <link rel="stylesheet" href="/css/libcloud.css" type="text/css">
+ <link rel="stylesheet" href="/css/documentation.css" type="text/css">
+ <link rel="stylesheet" href="/css/code.css" type="text/css">
+ <link rel="icon" type="image/png" href="/images/favicon.png"/>
+</head>
+<body>
+ <div class="container">
+ <div id="header" class="span-24 last">
+
+ <h1>Apache Libcloud <span>a unified interface to the cloud</span></h1>
+
+ </div>
+
+ <div id="banner" class="span-24 last">
+
+ <h2>Libcloud
+ Documentation: Debugging</h2>
+
+ </div>
+
+
+ <div id="sidebar" class="span-6 border">
+
+<ul id="menu">
+ <li><a href="/index.html">Website home</a></li>
+ <li><a href="/docs/index.html">Documentation home</a></li>
+ <li>Components</li>
+ <ul>
+ <li class="title">Compute</li>
+ <ul>
+ <li><a href="compute-overview.html">Overview</a></li>
+ <li><a href="compute-base-api.html">Base API</a></li>
+ <li><a href="compute-deployment.html">Deployment</a></li>
+ </ul>
+ <li class="title">Storage</li>
+ <li class="title">Load Balancer</li>
+ </ul>
+ <li>Other</li>
+ <ul>
+ <ul>
+ <li><a href="debugging.html">Debugging</a></li>
+ </ul>
+ </ul>
+ <li><a href="/apidocs">Generated API docs</a></li>
+</ul>
+
+
+
+ </div>
+
+
+ <div id="main" class="span-16 last">
+
+ <h2 id="debugging">Debugging</h2>
+<p>Libcloud has a special debug mode which when enabled outputs all the outgoing
+HTTP requests and all the incoming HTTP responses. Output also includes cURL
+commands which can be used to re-produce the requests.</p>
+<p>When this mode is enabled and if <code>paramiko</code> library is installed (used for
+deployment), paramiko library log level is also set to <code>DEBUG</code> which helps with
+debugging the deployment issues.</p>
+<p>To enable it, set <code>LIBCLOUD_DEBUG</code> environment variable and make it point to a
+file where the output should be saved.</p>
+<p>For example if you want the output to be logged to the standard error (on Unix)
+you can set it to <code>/dev/stderr</code> - <code>LIBCLOUD_DEBUG=/dev/stderr python my_script.py</code>.</p>
+<p>Example output:</p>
+<div class="codehilite"><pre># -------- begin 4431824872 request ----------
+curl -i -X GET -H 'Host: s3.amazonaws.com' -H 'X-LC-Request-ID: 4431824872' -H 'Content-Length: 0' -H 'User-Agent: libcloud/0.6.0-beta1 (Amazon S3 (standard))' 'https://s3.amazonaws.com:443/?AWSAccessKeyId=foo<span class="err">&</span>Signature=bar'
+# -------- begin 4431824872:4431825232 response ----------
+HTTP/1.1 200 OK
+X-Amz-Id-2: 1234
+Server: AmazonS3
+Transfer-Encoding: chunked
+X-Amz-Request-Id: FFFFFFFFFF
+Date: Tue, 01 Nov 2011 22:29:11 GMT
+Content-Type: application/xml
+
+171
+<span class="cp"><?xml version="1.0" encoding="UTF-8"?></span>
+<span class="nt"><ListAllMyBucketsResult</span> <span class="na">xmlns=</span><span class="s">"http://s3.amazonaws.com/doc/2006-03-01/"</span><span class="nt">><Owner><ID></span>sada8932dsa8d30i<span class="nt"></ID><DisplayName></span>kami<span class="nt"></DisplayName></Owner><Buckets><Bucket><Name></span>test34324323<span class="nt"></Name><CreationDate></span>2011-11-01T22:17:23.000Z<span class="nt"></CreationDate></Bucket></Buckets></ListAllMyBucketsResult></span>
+0
+
+# -------- end 4431824872:4431825232 response ----------
+</pre></div>
+
+ </div>
+
+ <div id="footer" class="span-24">
+ <a href="http://www.apache.org/licenses/">License</a> | <a
+ href="/security.html">Security</a> | <a
+ href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a> |
+<a href="http://www.apache.org/foundation/thanks.html">Thanks</a> | <a
+ href="/credits.html">Credits</a> | <a href="/sitemap.html">Sitemap</a><br /><br />
+
+Copyright © 2009-2011, <a href="http://apache.org/">The Apache Software Foundation</a><br />
+Apache Libcloud, Libcloud, Apache, the Apache feather, and the Apache Libcloud
+project logo are trademarks of the Apache Software Foundation. All other marks mentioned may be trademarks or registered trademarks of their respective owners.
+
+ </div>
+ </div>
+<script type="text/javascript">
+var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
+document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
+</script>
+<script type="text/javascript">
+try {
+var pageTracker = _gat._getTracker("UA-23580482-1");
+pageTracker._trackPageview();
+} catch(err) {}
+</script>
+
+</body>
+</html>
Modified: websites/staging/libcloud/trunk/content/docs/index.html
==============================================================================
--- websites/staging/libcloud/trunk/content/docs/index.html (original)
+++ websites/staging/libcloud/trunk/content/docs/index.html Wed Nov 2 01:03:26 2011
@@ -45,6 +45,12 @@
<li class="title">Storage</li>
<li class="title">Load Balancer</li>
</ul>
+ <li>Other</li>
+ <ul>
+ <ul>
+ <li><a href="debugging.html">Debugging</a></li>
+ </ul>
+ </ul>
<li><a href="/apidocs">Generated API docs</a></li>
</ul>