juju-core

Merge lp:~jorge/juju-core/troubleshooting-local-provider-docs into lp:juju-core/docs

  1. troubleshooting-local-provider-docs
  2. Merge into docs
Proposed by Jorge Castro
Status: Merged
Approved by: Nick Veitch
Approved revision: no longer in the source branch.
Merged at revision: 158
Proposed branch: lp:~jorge/juju-core/troubleshooting-local-provider-docs
Merge into: lp:juju-core/docs
Diff against target: 232 lines (+215/-2)
2 files modified
htmldocs/charms-deploying.html (+2/-2)
htmldocs/troubleshooting-local.html (+213/-0)
To merge this branch: bzr merge lp:~jorge/juju-core/troubleshooting-local-provider-docs
Reviewer Review Type Date Requested Status
Nick Veitch Pending
Review via email: mp+193444@code.launchpad.net

Description of the change

This page is incomplete, but please add it to the docs (non-indexed) so I can ask core folks to add to it, thanks!

To post a comment you must log in.
Revision history for this message
Nick Veitch (evilnick) wrote :

lgtm

Preview Diff

[H/L] Next/Prev Comment, [J/K] Next/Prev File, [N/P] Next/Prev Hunk
1=== modified file 'htmldocs/charms-deploying.html'
2--- htmldocs/charms-deploying.html 2013-10-22 18:39:23 +0000
3+++ htmldocs/charms-deploying.html 2013-10-31 15:37:32 +0000
4@@ -138,8 +138,8 @@
5 valid:</p>
6
7 <pre class="prettyprint">
8-juju deploy --repository=. haproxy
9-juju deploy --repository=~/charms/ wordpress</pre>
10+juju deploy --repository=. local:haproxy
11+juju deploy --repository ~/charms/ local:wordpress</pre>
12
13 <p class="note"><strong>Note:</strong> Specifying a
14 local repository makes juju look there
15
16=== added file 'htmldocs/troubleshooting-local.html'
17--- htmldocs/troubleshooting-local.html 1970-01-01 00:00:00 +0000
18+++ htmldocs/troubleshooting-local.html 2013-10-31 15:37:32 +0000
19@@ -0,0 +1,213 @@
20+<!DOCTYPE html>
21+<html>
22+<!--Head-->
23+ <head>
24+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
25+ <title>Juju Documentation</title>
26+ <script src="/wp-content/themes/ubuntu/library/js/all-yui.js"></script>
27+ <link href="https://fonts.googleapis.com/css?family=Ubuntu:400,300,300italic,400italic,700,700italic|Ubuntu+Mono" rel="stylesheet" type="text/css">
28+ <link rel="stylesheet" type="text/css" media="screen" href="https://juju.ubuntu.com/wp-content/themes/juju-website/css/reset.css">
29+ <link rel="shortcut icon" href="//assets.ubuntu.com/sites/ubuntu/latest/u/img/favicon.ico" />
30+ <link rel="stylesheet" type="text/css" media="screen" href="//assets.ubuntu.com/sites/guidelines/css/latest/ubuntu-styles.css" />
31+ <link rel="stylesheet" type="text/css" media="screen" href="//assets.ubuntu.com/sites/ubuntu/latest/u/css/global.css" />
32+ <link rel="stylesheet" type="text/css" media="screen" href="https://juju.ubuntu.com/wp-content/themes/juju-website/css/960.css">
33+ <link rel="stylesheet" type="text/css" media="screen" href="https://juju.ubuntu.com/wp-content/themes/juju-website/css/home-new.css">
34+ <link rel="stylesheet" id="stacktack-css" href="https://juju.ubuntu.com/wp-content/plugins/stacktack/css/stacktack.min.css?ver=3.4.2" type="text/css" media="all">
35+ <link href="./css/main.css" rel="stylesheet" type="text/css">
36+
37+ <!--[if lt IE 9]>
38+ <script type="text/javascript" src="//html5shim.googlecode.com/svn/trunk/html5.js"></script>
39+ <![endif]-->
40+ </head>
41+<!--End-Head-->
42+
43+
44+
45+
46+
47+
48+ <body class="resources">
49+
50+<!--Header-->
51+
52+ <header class="banner global" role="banner">
53+ <nav role="navigation" class="nav-primary nav-right">
54+ <div class="logo">
55+ <a class="logo-ubuntu" href="https://juju.ubuntu.com/">
56+ <img width="118" height="27" src="//assets.ubuntu.com/sites/ubuntu/latest/u/img/logo.png" alt="Juju logo" />
57+ <span>Juju</span>
58+ </a>
59+ </div>
60+ <ul>
61+ <li class="accessibility-aid"><a accesskey="s" href="#main-content">Jump to content</a></li>
62+ <li class="page_item page-item-8"><a href="https://juju.ubuntu.com/charms/">Charms</a></li>
63+ <li class="page_item page-item-10"><a href="https://juju.ubuntu.com/features/">Features</a></li>
64+ <li class="page_item page-item-12"><a href="https://juju.ubuntu.com/deployment/">Deploy</a></li>
65+ <li class="page_item page-item-14"><a href="https://juju.ubuntu.com/resources/">Resources</a></li>
66+ <li class="page_item page-item-16"><a href="https://juju.ubuntu.com/community/">Community</a></li>
67+ <li class="page_item page-item-18"><a href="https://juju.ubuntu.com/download/">Install Juju</a></li>
68+ </ul>
69+ <div id="box-search">
70+ <form class="search-form" method="get" id="searchform" action="https://juju.ubuntu.com/">
71+ <label class="off-left" for="s">Search:</label>
72+ <input class="form-text" type="text" value="" name="s" id="s" />
73+ <button class="off-left form-submit" type="submit" id="searchsubmit">Search</button>
74+ </form>
75+ </div>
76+ </nav>
77+ </header>
78+<!--End-Header-->
79+<!--Preamble-->
80+<div class="wrapper">
81+ <div id="main-content" class="inner-wrapper" role="main">
82+ <div class="row no-border">
83+ <div class="header-navigation-secondary"></div>
84+ <h2 class="pagetitle">Juju documentation</h2>
85+ </div>
86+ <section id="content" class="container-12">
87+ <div class="grid-12 doc-container">
88+ <div id="navlinks" class="grid-3 doc-navigation">LINKS</div>
89+ <div class="grid-9 doc-content">
90+<!--End-Preamble-->
91+ <article>
92+ <section id="troubleshooting_local">
93+ <h1>Troubleshooting the Local Provider</h1>
94+ <p>The local provider uses LXC containers under the hood to provide nodes for you to deploy on. Sometimes things go wrong and you need to debug what is happening on your machine. This page is a collection of best practices from the communtiy on diagnosing and solving Juju local provider issues.</p>
95+ </section>
96+
97+ <section id="bootstrap_fails">
98+ <h2>Bootstrap fails</h2>
99+
100+ <p>Everytime bootstrap fails, you'll need to run <code>sudo juju destroy-environment</code> prior to continuing. First let's rerun a bootstrap in debug mode:</p>
101+
102+<pre class="prettyprint">
103+sudo juju boostrap --show-log --debug
104+</pre>
105+
106+ <p>This will print very verbose output. If you're receiving <code>connection failed, will retry: dial tcp 127.0.0.1:37017: connection refused</code> error at the end of the run, proceed with the troubleshooting guide. If not the error presented will inform you what went wrong.</p>
107+
108+ <p>In certain cases you might get this something similar to thiserror: <code>Get http://10.0.3.1:8040/provider-state: dial tcp 10.0.3.1:8040: connection refused</code>.
109+
110+ <p>This can be solved by removing miscellaneous .jenv files in <code>~/.juju/environments</a> and rerunning the bootstrap command.</p>
111+ </section>
112+
113+ <section id="connection_failed">
114+ <h2>Connection failed, will retry</h2>
115+
116+ <p>This occurs when the juju API server and Database server fail to start within the alloted timeout. This can occur for one of several reasons. After the bootstrap command fails run the following command:</p>
117+
118+<pre class="prettyprint">
119+sudo initctl list | grep juju
120+</pre>
121+
122+ <p>You should see two jobs listed. One that starts with <code>juju-db</code> the other <code>juju-agent</code>. If these are both in a start/running state then your machine took longer than juju expected to get these services started. If you're on an encrypted partition see TODO: INSTRUCTIONS ON THIS. If you're not TODO: <INSTRUCTIONS ON RAM DISK DOES NOT EXIST>.</p>
123+
124+ <p>If either of these have stopped, investigate the logs at <code>/var/log/upstart/juju-db*.log</code> or <code>/var/log/upstart/juju-agent*.log</code> If the juju-db service failed to start with messages of unsupported command-line options, check the version of mongodb installed:</p>
125+
126+<pre class="prettyprint">
127+dpkg -l | grep mongodb-server
128+</pre>
129+
130+ <p>If you have a version less than 1:2.2.4-0ubuntu1 make sure you have either the <a href="https://wiki.ubuntu.com/ServerTeam/CloudToolsArchive">Cloud Tools Archive</a> or ppa:juju/stable added to your system. <code>sudo apt-get update</code> then install juju-local package. Before retrying, make sure you run <code>sudo juju destroy-environment</code>
131+ </section>
132+
133+ <section id="no_machines_start">
134+ <h2>No machines start</h2>
135+
136+ <p>If you get a successful bootstrap, but services you deploy never come up, there's a chance that you have an older version of the Ubuntu Cloud Image cached on you machine. To verify this, check the timestamp of the contents in <code>/var/cache/lxc/cloud-precise/</code>
137+
138+<pre class="prettyprint">
139+ls -lh /var/cache/lxc/cloud-precise/
140+</pre>
141+
142+ <p>If the contents of this directory are older than a few weeks, delete files present, destroy the environment with `sudo juju destroy-environment`, rebootstrap and attempt deployment again.</p>
143+ </section>
144+
145+</article>
146+
147+<!--End-Postamble-->
148+<!--Footer-->
149+ <footer class="global clearfix" role="contentinfo">
150+ <nav role="navigation">
151+ <div class="footer-a">
152+ <div class="clearfix">
153+ <ul>
154+ <li>
155+ <h2><a href="/">Juju</a></h2>
156+ <ul>
157+ <li><a href="/charms">Charms</a></li>
158+ <li><a href="/features">Features</a></li>
159+ <li><a href="/deployment">Deployment</a></li>
160+ </ul>
161+ </li>
162+ <li>
163+ <h2><a href="/resources">Resources</a></h2>
164+ <ul>
165+ <li><a href="/resources/juju-overview/">Overview</a></li>
166+ <li><a href="/docs/">Documentation</a></li>
167+ <li><a href="/resources/the-juju-gui/">The Juju web UI</a></li>
168+ <li><a href="/docs/authors-charm-store.html">The charm store</a></li>
169+ <li><a href="/docs/getting-started.html#test">Tutorial</a></li>
170+ <li><a href="/resources/videos/">Videos</a></li>
171+ <li><a href="/resources/easy-tasks-for-new-developers/">Easy tasks for new developers</a></li>
172+ </ul>
173+ </li>
174+ <li>
175+ <h2><a href="/community">Community</a></h2>
176+ <ul>
177+ <li><a href="/community/blog/">Juju Blog</a></li>
178+ <li><a href="/events/">Events</a></li>
179+ <li><a href="/community/weekly-charm-meeting/">Weekly charm meeting</a></li>
180+ <li><a href="/community/charmers/">Charmers</a></li>
181+ <li><a href="/docs/authors-charm-writing.html">Write a charm</a></li>
182+ <li><a href="/docs/contributing.html">Help with documentation</a></li>
183+ <li><a href="https://bugs.launchpad.net/juju-website/+filebug">File a bug</a></li> <li><a href="/labs/">Juju Labs</a></li>
184+ </ul>
185+ </li>
186+ <li>
187+ <h2><a href="https://jujucharms.com/sidebar/">Try Juju</a></h2>
188+ <ul>
189+ <li><a href="https://jujucharms.com/">Charm store</a></li>
190+ <li><a href="/download/">Download Juju</a></li>
191+ </ul>
192+ </li>
193+ </ul>
194+ </div>
195+ </div>
196+ </nav>
197+ <div class="legal clearfix">
198+ <p>&copy; 2013 Canonical Ltd. Ubuntu and Canonical are registered trademarks of <a href="http://canonical.com">Canonical Ltd</a>.</p>
199+ </div>
200+ </footer>
201+
202+<!--End-Footer-->
203+
204+<!--Scripts-->
205+ <script src="//google-code-prettify.googlecode.com/svn/loader/run_prettify.js?skin=sunburst"></script>
206+ <script type="text/javascript" src="//ajax.googleapis.com/ajax/libs/jquery/1.6.2/jquery.min.js"></script>
207+ <script type="text/javascript" src="//ajax.googleapis.com/ajax/libs/jqueryui/1.8.14/jquery-ui.min.js"></script>
208+ <script src="//d38yea5fb4e2oh.cloudfront.net/jquery.stacktack.min.js"></script>
209+ <script type="text/javascript" src="//code.jquery.com/jquery-1.9.1.js"></script>
210+ <script type="text/javascript" src="./js/main.js"></script>
211+ <script type="text/javascript" src="./js/jquery.details.js"></script>
212+ <script src="//assets.ubuntu.com/sites/ubuntu/latest/u/js/core.js"></script>
213+ <script src="//assets.ubuntu.com/sites/ubuntu/latest/u/js/global.js"></script>
214+ <!-- google analytics -->
215+ <script>
216+ var _gaq = _gaq || [];
217+ _gaq.push(['_setAccount', 'UA-1018242-41']);
218+ _gaq.push(['_trackPageview']);
219+
220+ (function() {
221+ var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
222+ ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
223+ var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
224+ })();
225+ </script>
226+<!--End-Scripts-->
227+
228+
229+
230+
231+
232+</body></html>

Subscribers

People subscribed via source and target branches