appscale-tools 1.6.0

data/LICENSE

@@ -0,0 +1,37 @@
+Software License Agreement (BSD License)
+
+Copyright (c) 2008, Regents of the University of California
+All rights reserved.
+
+Redistribution and use of this software in source and binary forms, with or
+without modification, are permitted provided that the following conditions
+are met:
+
+* Redistributions of source code must retain the above
+  copyright notice, this list of conditions and the
+  following disclaimer.
+
+* Redistributions in binary form must reproduce the above
+  copyright notice, this list of conditions and the
+  following disclaimer in the documentation and/or other
+  materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
+LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGE.  USERS OF THIS SOFTWARE ACKNOWLEDGE THE POSSIBLE
+ PRESENCE OF OTHER OPEN SOURCE LICENSED MATERIAL, COPYRIGHTED MATERIAL OR
+PATENTED MATERIAL IN THIS SOFTWARE, AND IF ANY SUCH MATERIAL IS DISCOVERED THE PARTY
+DISCOVERING IT MAY INFORM DR. CHANDRA KRINTZ AT THE UNIVERSITY OF CALIFORNIA, 
+SANTA BARBARA WHO WILL THEN ASCERTAIN THE MOST APPROPRIATE REMEDY, WHICH
+IN THE REGENTS’ DISCRETION MAY INCLUDE, WITHOUT LIMITATION, REPLACEMENT
+OF THE CODE SO IDENTIFIED, LICENSING OF THE CODE SO IDENTIFIED, OR WITHDRAWAL
+OF THE CODE CAPABILITY TO THE EXTENT NEEDED TO COMPLY WITH ANY SUCH LICENSES
+OR RIGHTS.

data/README

@@ -0,0 +1,17 @@
+AppScale Tools Version 1.6-rc1
+from the UCSB RACELab 
+http://appscale.cs.ucsb.edu
+
+This toolset automates the installation and manipulation of
+the AppScale system. AppScale can be run as a cloud over 
+Eucalyptus or EC2, over a virtualization layer such as Xen,
+or directly on a non-virtualized cluster.
+
+To install the tools run:
+
+sudo bash debian/appscale_build.sh
+
+This will remove any directories /usr/local/appscale-tools*
+and install the tools in /usr/local/appscale-tools.
+If you wish to change the target location, change TOOL_HOME in 
+Makefile.

data/bin/appscale-add-keypair

@@ -0,0 +1,15 @@
+#!/usr/bin/env ruby
+# Programmer: Chris Bunch
+
+$VERBOSE = nil # to supress excessive SSL cert warnings
+
+
+$:.unshift File.join(File.dirname(__FILE__), "..", "lib")
+require 'appscale_tools'
+
+
+if __FILE__ == $0
+  options = ParseArgs.get_vals_from_args(ARGV, AppScaleTools::ADD_KEYPAIR_FLAGS,
+    AppScaleTools::ADD_KEYPAIR_USAGE)
+  AppScaleTools.add_keypair(options)
+end

data/bin/appscale-describe-instances

@@ -0,0 +1,16 @@
+#!/usr/bin/env ruby
+# Programmer: Chris Bunch
+
+$:.unshift File.join(File.dirname(__FILE__), "..", "lib")
+require 'appscale_tools'
+
+
+if __FILE__ == $0
+  options = ParseArgs.get_vals_from_args(ARGV,
+    AppScaleTools::DESCRIBE_INSTANCES_FLAGS, 
+    AppScaleTools::DESCRIBE_INSTANCES_USAGE)
+  instance_info = AppScaleTools.describe_instances(options)
+  instance_info[:result].each { |instance|
+    puts instance
+  }
+end

data/bin/appscale-remove-app

@@ -0,0 +1,13 @@
+#!/usr/bin/env ruby
+# Programmer: Chris Bunch
+
+
+$:.unshift File.join(File.dirname(__FILE__), "..", "lib")
+require 'appscale_tools'
+
+
+if __FILE__ == $0
+  options = ParseArgs.get_vals_from_args(ARGV, AppScaleTools::REMOVE_APP_FLAGS,
+    AppScaleTools::REMOVE_APP_USAGE)
+  AppScaleTools.remove_app(options)
+end

data/bin/appscale-reset-pwd

@@ -0,0 +1,13 @@
+#!/usr/bin/env ruby
+# Programmer: Chris Bunch
+
+
+$:.unshift File.join(File.dirname(__FILE__), "..", "lib")
+require 'appscale_tools'
+
+
+if __FILE__ == $0
+  options = ParseArgs.get_vals_from_args(ARGV, 
+    AppScaleTools::RESET_PASSWORD_FLAGS, AppScaleTools::RESET_PASSWORD_USAGE)
+  AppScaleTools.reset_password(options)
+end

data/bin/appscale-run-instances

@@ -0,0 +1,15 @@
+#!/usr/bin/env ruby
+# Programmer: Chris Bunch
+
+$VERBOSE = nil # to surpress excessive SSL cert warnings
+
+
+$:.unshift File.join(File.dirname(__FILE__), "..", "lib")
+require 'appscale_tools'
+
+
+if __FILE__ == $0
+  options = ParseArgs.get_vals_from_args(ARGV, 
+    AppScaleTools::RUN_INSTANCES_FLAGS, AppScaleTools::RUN_INSTANCES_USAGE)
+  AppScaleTools.run_instances(options)
+end

data/bin/appscale-terminate-instances

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+# Programmer: Chris Bunch
+
+
+$:.unshift File.join(File.dirname(__FILE__), "..", "lib")
+require 'appscale_tools'
+
+
+if __FILE__ == $0
+  options = ParseArgs.get_vals_from_args(ARGV, 
+    AppScaleTools::TERMINATE_INSTANCES_FLAGS, 
+    AppScaleTools::TERMINATE_INSTANCES_USAGE)
+  AppScaleTools.terminate_instances(options)
+end

data/bin/appscale-upload-app

@@ -0,0 +1,13 @@
+#!/usr/bin/env ruby
+# Programmer: Chris Bunch
+
+
+$:.unshift File.join(File.dirname(__FILE__), "..", "lib")
+require 'appscale_tools'
+
+
+if __FILE__ == $0
+  options = ParseArgs.get_vals_from_args(ARGV, AppScaleTools::UPLOAD_APP_FLAGS,
+    AppScaleTools::UPLOAD_APP_USAGE)
+  AppScaleTools.upload_app(options)
+end

data/doc/AdvancedNode.html

@@ -0,0 +1,163 @@
+<!DOCTYPE html>
+
+<html>
+<head>
+<meta content="text/html; charset=UTF-8" http-equiv="Content-Type">
+
+<title>class AdvancedNode - RDoc Documentation</title>
+
+<link type="text/css" media="screen" href="./rdoc.css" rel="stylesheet">
+
+<script type="text/javascript">
+  var rdoc_rel_prefix = "./";
+</script>
+
+<script type="text/javascript" charset="utf-8" src="./js/jquery.js"></script>
+<script type="text/javascript" charset="utf-8" src="./js/navigation.js"></script>
+<script type="text/javascript" charset="utf-8" src="./js/search_index.js"></script>
+<script type="text/javascript" charset="utf-8" src="./js/search.js"></script>
+<script type="text/javascript" charset="utf-8" src="./js/searcher.js"></script>
+<script type="text/javascript" charset="utf-8" src="./js/darkfish.js"></script>
+
+
+<body id="top" class="class">
+<nav id="metadata">
+  <nav id="home-section" class="section">
+  <h3 class="section-header">
+    <a href="./index.html">Home</a>
+    <a href="./table_of_contents.html#classes">Classes</a>
+    <a href="./table_of_contents.html#methods">Methods</a>
+  </h3>
+</nav>
+
+
+  <nav id="search-section" class="section project-section" class="initially-hidden">
+  <form action="#" method="get" accept-charset="utf-8">
+    <h3 class="section-header">
+      <input type="text" name="search" placeholder="Search" id="search-field"
+             title="Type to search, Up and Down to navigate, Enter to load">
+    </h3>
+  </form>
+
+  <ul id="search-results" class="initially-hidden"></ul>
+</nav>
+
+
+  <div id="file-metadata">
+    <nav id="file-list-section" class="section">
+  <h3 class="section-header">Defined In</h3>
+  <ul>
+    <li>lib/node_layout.rb
+  </ul>
+</nav>
+
+    
+  </div>
+
+  <div id="class-metadata">
+    
+    <nav id="parent-class-section" class="section">
+  <h3 class="section-header">Parent</h3>
+  
+  <p class="link"><a href="Node.html">Node</a>
+  
+</nav>
+
+    
+    
+  </div>
+
+  <div id="project-metadata">
+    <nav id="fileindex-section" class="section project-section">
+  <h3 class="section-header">Pages</h3>
+
+  <ul>
+  
+    <li class="file"><a href="./lib/sshcopyid.html">sshcopyid</a>
+  
+  </ul>
+</nav>
+
+    <nav id="classindex-section" class="section project-section">
+  <h3 class="section-header">Class and Module Index</h3>
+
+  <ul class="link-list">
+  
+    <li><a href="./AdvancedNode.html">AdvancedNode</a>
+  
+    <li><a href="./AppControllerClient.html">AppControllerClient</a>
+  
+    <li><a href="./AppEngineConfigException.html">AppEngineConfigException</a>
+  
+    <li><a href="./AppScaleException.html">AppScaleException</a>
+  
+    <li><a href="./AppScaleTools.html">AppScaleTools</a>
+  
+    <li><a href="./BadCommandLineArgException.html">BadCommandLineArgException</a>
+  
+    <li><a href="./BadConfigurationException.html">BadConfigurationException</a>
+  
+    <li><a href="./CommonFunctions.html">CommonFunctions</a>
+  
+    <li><a href="./EncryptionHelper.html">EncryptionHelper</a>
+  
+    <li><a href="./GodInterface.html">GodInterface</a>
+  
+    <li><a href="./InfrastructureException.html">InfrastructureException</a>
+  
+    <li><a href="./Node.html">Node</a>
+  
+    <li><a href="./NodeLayout.html">NodeLayout</a>
+  
+    <li><a href="./Object.html">Object</a>
+  
+    <li><a href="./ParseArgs.html">ParseArgs</a>
+  
+    <li><a href="./RemoteLogging.html">RemoteLogging</a>
+  
+    <li><a href="./SimpleNode.html">SimpleNode</a>
+  
+    <li><a href="./UsageText.html">UsageText</a>
+  
+    <li><a href="./UserAppClient.html">UserAppClient</a>
+  
+    <li><a href="./VMTools.html">VMTools</a>
+  
+  </ul>
+</nav>
+
+  </div>
+</nav>
+
+<div id="documentation">
+  <h1 class="class">class AdvancedNode</h1>
+
+  <div id="description" class="description">
+    
+  </div><!-- description -->
+
+  
+  
+  
+  <section id="5Buntitled-5D" class="documentation-section">
+    
+
+    
+
+    
+
+    
+
+    <!-- Methods -->
+    
+  </section><!-- 5Buntitled-5D -->
+
+</div><!-- documentation -->
+
+
+<footer id="validator-badges">
+  <p><a href="http://validator.w3.org/check/referer">[Validate]</a>
+  <p>Generated by <a href="https://github.com/rdoc/rdoc">RDoc</a> 3.12.
+  <p>Generated with the <a href="http://deveiate.org/projects/Darkfish-Rdoc/">Darkfish Rdoc Generator</a> 3.
+</footer>
+

data/doc/AppControllerClient.html

@@ -0,0 +1,831 @@
+<!DOCTYPE html>
+
+<html>
+<head>
+<meta content="text/html; charset=UTF-8" http-equiv="Content-Type">
+
+<title>class AppControllerClient - RDoc Documentation</title>
+
+<link type="text/css" media="screen" href="./rdoc.css" rel="stylesheet">
+
+<script type="text/javascript">
+  var rdoc_rel_prefix = "./";
+</script>
+
+<script type="text/javascript" charset="utf-8" src="./js/jquery.js"></script>
+<script type="text/javascript" charset="utf-8" src="./js/navigation.js"></script>
+<script type="text/javascript" charset="utf-8" src="./js/search_index.js"></script>
+<script type="text/javascript" charset="utf-8" src="./js/search.js"></script>
+<script type="text/javascript" charset="utf-8" src="./js/searcher.js"></script>
+<script type="text/javascript" charset="utf-8" src="./js/darkfish.js"></script>
+
+
+<body id="top" class="class">
+<nav id="metadata">
+  <nav id="home-section" class="section">
+  <h3 class="section-header">
+    <a href="./index.html">Home</a>
+    <a href="./table_of_contents.html#classes">Classes</a>
+    <a href="./table_of_contents.html#methods">Methods</a>
+  </h3>
+</nav>
+
+
+  <nav id="search-section" class="section project-section" class="initially-hidden">
+  <form action="#" method="get" accept-charset="utf-8">
+    <h3 class="section-header">
+      <input type="text" name="search" placeholder="Search" id="search-field"
+             title="Type to search, Up and Down to navigate, Enter to load">
+    </h3>
+  </form>
+
+  <ul id="search-results" class="initially-hidden"></ul>
+</nav>
+
+
+  <div id="file-metadata">
+    <nav id="file-list-section" class="section">
+  <h3 class="section-header">Defined In</h3>
+  <ul>
+    <li>lib/app_controller_client.rb
+  </ul>
+</nav>
+
+    
+  </div>
+
+  <div id="class-metadata">
+    
+    <nav id="parent-class-section" class="section">
+  <h3 class="section-header">Parent</h3>
+  
+  <p class="link"><a href="Object.html">Object</a>
+  
+</nav>
+
+    
+    <!-- Method Quickref -->
+<nav id="method-list-section" class="section">
+  <h3 class="section-header">Methods</h3>
+
+  <ul class="link-list">
+    
+    <li><a href="#method-c-new">::new</a>
+    
+    <li><a href="#method-i-app_is_running-3F">#app_is_running?</a>
+    
+    <li><a href="#method-i-done_uploading">#done_uploading</a>
+    
+    <li><a href="#method-i-get_all_public_ips">#get_all_public_ips</a>
+    
+    <li><a href="#method-i-get_role_info">#get_role_info</a>
+    
+    <li><a href="#method-i-get_status">#get_status</a>
+    
+    <li><a href="#method-i-get_userappserver_ip">#get_userappserver_ip</a>
+    
+    <li><a href="#method-i-is_done_initializing-3F">#is_done_initializing?</a>
+    
+    <li><a href="#method-i-is_done_loading-3F">#is_done_loading?</a>
+    
+    <li><a href="#method-i-is_live-3F">#is_live?</a>
+    
+    <li><a href="#method-i-kill">#kill</a>
+    
+    <li><a href="#method-i-make_call">#make_call</a>
+    
+    <li><a href="#method-i-set_parameters">#set_parameters</a>
+    
+    <li><a href="#method-i-status">#status</a>
+    
+    <li><a href="#method-i-stop_app">#stop_app</a>
+    
+    <li><a href="#method-i-update">#update</a>
+    
+  </ul>
+</nav>
+
+  </div>
+
+  <div id="project-metadata">
+    <nav id="fileindex-section" class="section project-section">
+  <h3 class="section-header">Pages</h3>
+
+  <ul>
+  
+    <li class="file"><a href="./lib/sshcopyid.html">sshcopyid</a>
+  
+  </ul>
+</nav>
+
+    <nav id="classindex-section" class="section project-section">
+  <h3 class="section-header">Class and Module Index</h3>
+
+  <ul class="link-list">
+  
+    <li><a href="./AdvancedNode.html">AdvancedNode</a>
+  
+    <li><a href="./AppControllerClient.html">AppControllerClient</a>
+  
+    <li><a href="./AppEngineConfigException.html">AppEngineConfigException</a>
+  
+    <li><a href="./AppScaleException.html">AppScaleException</a>
+  
+    <li><a href="./AppScaleTools.html">AppScaleTools</a>
+  
+    <li><a href="./BadCommandLineArgException.html">BadCommandLineArgException</a>
+  
+    <li><a href="./BadConfigurationException.html">BadConfigurationException</a>
+  
+    <li><a href="./CommonFunctions.html">CommonFunctions</a>
+  
+    <li><a href="./EncryptionHelper.html">EncryptionHelper</a>
+  
+    <li><a href="./GodInterface.html">GodInterface</a>
+  
+    <li><a href="./InfrastructureException.html">InfrastructureException</a>
+  
+    <li><a href="./Node.html">Node</a>
+  
+    <li><a href="./NodeLayout.html">NodeLayout</a>
+  
+    <li><a href="./Object.html">Object</a>
+  
+    <li><a href="./ParseArgs.html">ParseArgs</a>
+  
+    <li><a href="./RemoteLogging.html">RemoteLogging</a>
+  
+    <li><a href="./SimpleNode.html">SimpleNode</a>
+  
+    <li><a href="./UsageText.html">UsageText</a>
+  
+    <li><a href="./UserAppClient.html">UserAppClient</a>
+  
+    <li><a href="./VMTools.html">VMTools</a>
+  
+  </ul>
+</nav>
+
+  </div>
+</nav>
+
+<div id="documentation">
+  <h1 class="class">class AppControllerClient</h1>
+
+  <div id="description" class="description">
+    
+  </div><!-- description -->
+
+  
+  
+  
+  <section id="5Buntitled-5D" class="documentation-section">
+    
+
+    
+
+    
+
+    
+    <!-- Attributes -->
+    <section id="attribute-method-details" class="method-section section">
+      <h3 class="section-header">Attributes</h3>
+
+      
+      <div id="attribute-i-conn" class="method-detail">
+        <div class="method-heading attribute-method-heading">
+          <span class="method-name">conn</span><span
+            class="attribute-access-type">[R]</span>
+        </div>
+
+        <div class="method-description">
+        
+        
+        
+        </div>
+      </div>
+      
+      <div id="attribute-i-ip" class="method-detail">
+        <div class="method-heading attribute-method-heading">
+          <span class="method-name">ip</span><span
+            class="attribute-access-type">[R]</span>
+        </div>
+
+        <div class="method-description">
+        
+        
+        
+        </div>
+      </div>
+      
+      <div id="attribute-i-secret" class="method-detail">
+        <div class="method-heading attribute-method-heading">
+          <span class="method-name">secret</span><span
+            class="attribute-access-type">[R]</span>
+        </div>
+
+        <div class="method-description">
+        
+        
+        
+        </div>
+      </div>
+      
+    </section><!-- attribute-method-details -->
+    
+
+    <!-- Methods -->
+    
+     <section id="public-instance-5Buntitled-5D-method-details" class="method-section section">
+      <h3 class="section-header">Public Instance Methods</h3>
+
+    
+      <div id="method-i-app_is_running-3F" class="method-detail ">
+        
+        <div class="method-heading">
+          <span class="method-name">app_is_running?</span><span
+            class="method-args">(appname)</span>
+          <span class="method-click-advice">click to toggle source</span>
+        </div>
+        
+
+        <div class="method-description">
+          
+          
+          
+
+          
+          <div class="method-source-code" id="app_is_running-3F-source">
+            <pre><span class="ruby-comment"># File lib/app_controller_client.rb, line 164</span>
+<span class="ruby-keyword">def</span> <span class="ruby-identifier">app_is_running?</span>(<span class="ruby-identifier">appname</span>)
+  <span class="ruby-identifier">make_call</span>(<span class="ruby-constant">NO_TIMEOUT</span>, <span class="ruby-constant">RETRY_ON_FAIL</span>) { 
+    <span class="ruby-ivar">@conn</span>.<span class="ruby-identifier">is_app_running</span>(<span class="ruby-identifier">appname</span>, <span class="ruby-ivar">@secret</span>) 
+  }
+<span class="ruby-keyword">end</span></pre>
+          </div><!-- app_is_running-3F-source -->
+          
+        </div>
+
+        
+
+        
+      </div><!-- app_is_running-3F-method -->
+
+    
+      <div id="method-i-done_uploading" class="method-detail ">
+        
+        <div class="method-heading">
+          <span class="method-name">done_uploading</span><span
+            class="method-args">(appname, location)</span>
+          <span class="method-click-advice">click to toggle source</span>
+        </div>
+        
+
+        <div class="method-description">
+          
+          
+          
+
+          
+          <div class="method-source-code" id="done_uploading-source">
+            <pre><span class="ruby-comment"># File lib/app_controller_client.rb, line 157</span>
+<span class="ruby-keyword">def</span> <span class="ruby-identifier">done_uploading</span>(<span class="ruby-identifier">appname</span>, <span class="ruby-identifier">location</span>)
+  <span class="ruby-identifier">make_call</span>(<span class="ruby-constant">NO_TIMEOUT</span>, <span class="ruby-constant">RETRY_ON_FAIL</span>) { 
+    <span class="ruby-ivar">@conn</span>.<span class="ruby-identifier">done_uploading</span>(<span class="ruby-identifier">appname</span>, <span class="ruby-identifier">location</span>, <span class="ruby-ivar">@secret</span>) 
+  }
+<span class="ruby-keyword">end</span></pre>
+          </div><!-- done_uploading-source -->
+          
+        </div>
+
+        
+
+        
+      </div><!-- done_uploading-method -->
+
+    
+      <div id="method-i-get_all_public_ips" class="method-detail ">
+        
+        <div class="method-heading">
+          <span class="method-name">get_all_public_ips</span><span
+            class="method-args">()</span>
+          <span class="method-click-advice">click to toggle source</span>
+        </div>
+        
+
+        <div class="method-description">
+          
+          
+          
+
+          
+          <div class="method-source-code" id="get_all_public_ips-source">
+            <pre><span class="ruby-comment"># File lib/app_controller_client.rb, line 139</span>
+<span class="ruby-keyword">def</span> <span class="ruby-identifier">get_all_public_ips</span>()
+  <span class="ruby-identifier">make_call</span>(<span class="ruby-value">30</span>, <span class="ruby-constant">RETRY_ON_FAIL</span>) { <span class="ruby-ivar">@conn</span>.<span class="ruby-identifier">get_all_public_ips</span>(<span class="ruby-ivar">@secret</span>) }
+<span class="ruby-keyword">end</span></pre>
+          </div><!-- get_all_public_ips-source -->
+          
+        </div>
+
+        
+
+        
+      </div><!-- get_all_public_ips-method -->
+
+    
+      <div id="method-i-get_role_info" class="method-detail ">
+        
+        <div class="method-heading">
+          <span class="method-name">get_role_info</span><span
+            class="method-args">()</span>
+          <span class="method-click-advice">click to toggle source</span>
+        </div>
+        
+
+        <div class="method-description">
+          
+          <p>Asks the AppController to see what roles each node is running in AppScale.
+The result is an Array, where each item is a Hash that contains information
+about the given node.</p>
+          
+
+          
+          <div class="method-source-code" id="get_role_info-source">
+            <pre><span class="ruby-comment"># File lib/app_controller_client.rb, line 174</span>
+<span class="ruby-keyword">def</span> <span class="ruby-identifier">get_role_info</span>()
+  <span class="ruby-identifier">make_call</span>(<span class="ruby-constant">NO_TIMEOUT</span>, <span class="ruby-constant">ABORT_ON_FAIL</span>) { 
+    <span class="ruby-ivar">@conn</span>.<span class="ruby-identifier">get_role_info</span>(<span class="ruby-ivar">@secret</span>) 
+  }
+<span class="ruby-keyword">end</span></pre>
+          </div><!-- get_role_info-source -->
+          
+        </div>
+
+        
+
+        
+      </div><!-- get_role_info-method -->
+
+    
+      <div id="method-i-get_status" class="method-detail ">
+        
+        <div class="method-heading">
+          <span class="method-name">get_status</span><span
+            class="method-args">()</span>
+          <span class="method-click-advice">click to toggle source</span>
+        </div>
+        
+
+        <div class="method-description">
+          
+          
+          
+
+          
+          <div class="method-source-code" id="get_status-source">
+            <pre><span class="ruby-comment"># File lib/app_controller_client.rb, line 127</span>
+<span class="ruby-keyword">def</span> <span class="ruby-identifier">get_status</span>()
+  <span class="ruby-identifier">make_call</span>(<span class="ruby-value">10</span>, <span class="ruby-constant">RETRY_ON_FAIL</span>) { <span class="ruby-ivar">@conn</span>.<span class="ruby-identifier">status</span>(<span class="ruby-ivar">@secret</span>) }
+<span class="ruby-keyword">end</span></pre>
+          </div><!-- get_status-source -->
+          
+        </div>
+
+        
+
+        
+      </div><!-- get_status-method -->
+
+    
+      <div id="method-i-get_userappserver_ip" class="method-detail ">
+        
+        <div class="method-heading">
+          <span class="method-name">get_userappserver_ip</span><span
+            class="method-args">(verbose_level="low")</span>
+          <span class="method-click-advice">click to toggle source</span>
+        </div>
+        
+
+        <div class="method-description">
+          
+          
+          
+
+          
+          <div class="method-source-code" id="get_userappserver_ip-source">
+            <pre><span class="ruby-comment"># File lib/app_controller_client.rb, line 89</span>
+<span class="ruby-keyword">def</span> <span class="ruby-identifier">get_userappserver_ip</span>(<span class="ruby-identifier">verbose_level</span>=<span class="ruby-string">&quot;low&quot;</span>) 
+  <span class="ruby-identifier">userappserver_ip</span>, <span class="ruby-identifier">status</span>, <span class="ruby-identifier">state</span>, <span class="ruby-identifier">new_state</span> = <span class="ruby-string">&quot;&quot;</span>, <span class="ruby-string">&quot;&quot;</span>, <span class="ruby-string">&quot;&quot;</span>, <span class="ruby-string">&quot;&quot;</span>
+  <span class="ruby-identifier">loop</span> {
+    <span class="ruby-identifier">status</span> = <span class="ruby-identifier">get_status</span>()
+
+    <span class="ruby-identifier">new_state</span> = <span class="ruby-identifier">status</span>.<span class="ruby-identifier">scan</span>(<span class="ruby-regexp">%rCurrent State: ([\w\s\d\.,]+)\n/</span>).<span class="ruby-identifier">flatten</span>.<span class="ruby-identifier">to_s</span>.<span class="ruby-identifier">chomp</span>
+    <span class="ruby-keyword">if</span> <span class="ruby-identifier">verbose_level</span> <span class="ruby-operator">==</span> <span class="ruby-constant">LOGS_VERBOSE</span> <span class="ruby-keyword">and</span> <span class="ruby-identifier">new_state</span> <span class="ruby-operator">!=</span> <span class="ruby-identifier">state</span>
+      <span class="ruby-identifier">puts</span> <span class="ruby-identifier">new_state</span>
+      <span class="ruby-identifier">state</span> = <span class="ruby-identifier">new_state</span>
+    <span class="ruby-keyword">end</span>
+  
+    <span class="ruby-keyword">if</span> <span class="ruby-identifier">status</span> <span class="ruby-operator">==</span> <span class="ruby-string">&quot;false: bad secret&quot;</span>
+      <span class="ruby-identifier">abort</span>(<span class="ruby-node">&quot;\nWe were unable to verify your secret key with the head node specified in your locations file. Are you sure you have the correct secret key and locations file?\n\nSecret provided: [#{@secret}]\nHead node IP address: [#{@ip}]\n&quot;</span>)
+    <span class="ruby-keyword">end</span>
+      
+    <span class="ruby-keyword">if</span> <span class="ruby-identifier">status</span> <span class="ruby-operator">=~</span> <span class="ruby-node">%rDatabase is at (#{IP_OR_FQDN})/</span> <span class="ruby-keyword">and</span> <span class="ruby-node">$1</span> <span class="ruby-operator">!=</span> <span class="ruby-string">&quot;not-up-yet&quot;</span>
+      <span class="ruby-identifier">userappserver_ip</span> = <span class="ruby-node">$1</span>
+      <span class="ruby-keyword">break</span>
+    <span class="ruby-keyword">end</span>
+    
+    <span class="ruby-identifier">sleep</span>(<span class="ruby-value">10</span>)
+  }
+  
+  <span class="ruby-keyword">return</span> <span class="ruby-identifier">userappserver_ip</span>
+<span class="ruby-keyword">end</span></pre>
+          </div><!-- get_userappserver_ip-source -->
+          
+        </div>
+
+        
+
+        
+      </div><!-- get_userappserver_ip-method -->
+
+    
+      <div id="method-i-is_done_initializing-3F" class="method-detail ">
+        
+        <div class="method-heading">
+          <span class="method-name">is_done_initializing?</span><span
+            class="method-args">()</span>
+          <span class="method-click-advice">click to toggle source</span>
+        </div>
+        
+
+        <div class="method-description">
+          
+          
+          
+
+          
+          <div class="method-source-code" id="is_done_initializing-3F-source">
+            <pre><span class="ruby-comment"># File lib/app_controller_client.rb, line 147</span>
+<span class="ruby-keyword">def</span> <span class="ruby-identifier">is_done_initializing?</span>()
+  <span class="ruby-identifier">make_call</span>(<span class="ruby-constant">NO_TIMEOUT</span>, <span class="ruby-constant">RETRY_ON_FAIL</span>) { 
+    <span class="ruby-ivar">@conn</span>.<span class="ruby-identifier">is_done_initializing</span>(<span class="ruby-ivar">@secret</span>) 
+  }
+<span class="ruby-keyword">end</span></pre>
+          </div><!-- is_done_initializing-3F-source -->
+          
+        </div>
+
+        
+
+        
+      </div><!-- is_done_initializing-3F-method -->
+
+    
+      <div id="method-i-is_done_loading-3F" class="method-detail ">
+        
+        <div class="method-heading">
+          <span class="method-name">is_done_loading?</span><span
+            class="method-args">()</span>
+          <span class="method-click-advice">click to toggle source</span>
+        </div>
+        
+
+        <div class="method-description">
+          
+          
+          
+
+          
+          <div class="method-source-code" id="is_done_loading-3F-source">
+            <pre><span class="ruby-comment"># File lib/app_controller_client.rb, line 153</span>
+<span class="ruby-keyword">def</span> <span class="ruby-identifier">is_done_loading?</span>()
+  <span class="ruby-identifier">make_call</span>(<span class="ruby-constant">NO_TIMEOUT</span>, <span class="ruby-constant">RETRY_ON_FAIL</span>) { <span class="ruby-ivar">@conn</span>.<span class="ruby-identifier">is_done_loading</span>(<span class="ruby-ivar">@secret</span>) }
+<span class="ruby-keyword">end</span></pre>
+          </div><!-- is_done_loading-3F-source -->
+          
+        </div>
+
+        
+
+        
+      </div><!-- is_done_loading-3F-method -->
+
+    
+      <div id="method-i-is_live-3F" class="method-detail ">
+        
+        <div class="method-heading">
+          <span class="method-name">is_live?</span><span
+            class="method-args">()</span>
+          <span class="method-click-advice">click to toggle source</span>
+        </div>
+        
+
+        <div class="method-description">
+          
+          
+          
+
+          
+          <div class="method-source-code" id="is_live-3F-source">
+            <pre><span class="ruby-comment"># File lib/app_controller_client.rb, line 76</span>
+<span class="ruby-keyword">def</span> <span class="ruby-identifier">is_live?</span>
+  <span class="ruby-identifier">uri</span> = <span class="ruby-node">&quot;https://#{@ip}:17443&quot;</span>
+
+  <span class="ruby-keyword">begin</span>
+    <span class="ruby-constant">Timeout</span><span class="ruby-operator">::</span><span class="ruby-identifier">timeout</span>(<span class="ruby-value">5</span>) {
+      <span class="ruby-identifier">make_call</span>(<span class="ruby-value">1</span>, <span class="ruby-constant">ABORT_ON_FAIL</span>, <span class="ruby-identifier">want_output</span>=<span class="ruby-keyword">false</span>) { <span class="ruby-ivar">@conn</span>.<span class="ruby-identifier">status</span>(<span class="ruby-ivar">@secret</span>) }
+    }
+    <span class="ruby-keyword">return</span> <span class="ruby-keyword">true</span>
+  <span class="ruby-keyword">rescue</span> <span class="ruby-constant">Exception</span>
+    <span class="ruby-keyword">return</span> <span class="ruby-keyword">false</span>
+  <span class="ruby-keyword">end</span>
+<span class="ruby-keyword">end</span></pre>
+          </div><!-- is_live-3F-source -->
+          
+        </div>
+
+        
+
+        
+      </div><!-- is_live-3F-method -->
+
+    
+      <div id="method-i-kill" class="method-detail ">
+        
+        <div class="method-heading">
+          <span class="method-name">kill</span><span
+            class="method-args">()</span>
+          <span class="method-click-advice">click to toggle source</span>
+        </div>
+        
+
+        <div class="method-description">
+          
+          
+          
+
+          
+          <div class="method-source-code" id="kill-source">
+            <pre><span class="ruby-comment"># File lib/app_controller_client.rb, line 143</span>
+<span class="ruby-keyword">def</span> <span class="ruby-identifier">kill</span>()
+  <span class="ruby-identifier">make_call</span>(<span class="ruby-constant">NO_TIMEOUT</span>, <span class="ruby-constant">RETRY_ON_FAIL</span>) { <span class="ruby-ivar">@conn</span>.<span class="ruby-identifier">kill</span>(<span class="ruby-ivar">@secret</span>) }
+<span class="ruby-keyword">end</span></pre>
+          </div><!-- kill-source -->
+          
+        </div>
+
+        
+
+        
+      </div><!-- kill-method -->
+
+    
+      <div id="method-i-make_call" class="method-detail ">
+        
+        <div class="method-heading">
+          <span class="method-name">make_call</span><span
+            class="method-args">(time, retry_on_except, want_output=true) { || ... }</span>
+          <span class="method-click-advice">click to toggle source</span>
+        </div>
+        
+
+        <div class="method-description">
+          
+          
+          
+
+          
+          <div class="method-source-code" id="make_call-source">
+            <pre><span class="ruby-comment"># File lib/app_controller_client.rb, line 41</span>
+<span class="ruby-keyword">def</span> <span class="ruby-identifier">make_call</span>(<span class="ruby-identifier">time</span>, <span class="ruby-identifier">retry_on_except</span>, <span class="ruby-identifier">want_output</span>=<span class="ruby-keyword">true</span>)
+  <span class="ruby-identifier">refused_count</span> = <span class="ruby-value">0</span>
+  <span class="ruby-identifier">max</span> = <span class="ruby-value">10</span>
+
+  <span class="ruby-keyword">begin</span>
+    <span class="ruby-constant">Timeout</span><span class="ruby-operator">::</span><span class="ruby-identifier">timeout</span>(<span class="ruby-identifier">time</span>) {
+      <span class="ruby-keyword">yield</span> <span class="ruby-keyword">if</span> <span class="ruby-identifier">block_given?</span>
+    }
+  <span class="ruby-keyword">rescue</span> <span class="ruby-constant">Errno</span><span class="ruby-operator">::</span><span class="ruby-constant">ECONNREFUSED</span>
+    <span class="ruby-keyword">if</span> <span class="ruby-identifier">refused_count</span> <span class="ruby-operator">&gt;</span> <span class="ruby-identifier">max</span>
+      <span class="ruby-keyword">if</span> <span class="ruby-identifier">want_output</span>
+        <span class="ruby-identifier">abort</span>(<span class="ruby-node">&quot;Connection with #{@ip} was refused. Is the AppController running?&quot;</span>)
+      <span class="ruby-keyword">else</span>
+        <span class="ruby-identifier">raise</span> <span class="ruby-constant">Exception</span>
+      <span class="ruby-keyword">end</span>
+    <span class="ruby-keyword">else</span>
+      <span class="ruby-identifier">refused_count</span> <span class="ruby-operator">+=</span> <span class="ruby-value">1</span>
+      <span class="ruby-constant">Kernel</span>.<span class="ruby-identifier">sleep</span>(<span class="ruby-value">1</span>)
+      <span class="ruby-keyword">retry</span>
+    <span class="ruby-keyword">end</span>
+  <span class="ruby-keyword">rescue</span> <span class="ruby-constant">OpenSSL</span><span class="ruby-operator">::</span><span class="ruby-constant">SSL</span><span class="ruby-operator">::</span><span class="ruby-constant">SSLError</span>, <span class="ruby-constant">NotImplementedError</span>, <span class="ruby-constant">Errno</span><span class="ruby-operator">::</span><span class="ruby-constant">EPIPE</span>, <span class="ruby-constant">Timeout</span><span class="ruby-operator">::</span><span class="ruby-constant">Error</span>, <span class="ruby-constant">Errno</span><span class="ruby-operator">::</span><span class="ruby-constant">ECONNRESET</span>
+    <span class="ruby-keyword">retry</span>
+  <span class="ruby-keyword">rescue</span> <span class="ruby-constant">Exception</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">except</span>
+    <span class="ruby-keyword">if</span> <span class="ruby-identifier">retry_on_except</span>
+      <span class="ruby-keyword">retry</span>
+    <span class="ruby-keyword">else</span>
+      <span class="ruby-keyword">if</span> <span class="ruby-identifier">want_output</span>
+        <span class="ruby-identifier">abort</span>(<span class="ruby-node">&quot;We saw an unexpected error of the type #{except.class} with the following message:\n#{except}.&quot;</span>)
+      <span class="ruby-keyword">else</span>
+        <span class="ruby-identifier">raise</span> <span class="ruby-identifier">except</span>
+      <span class="ruby-keyword">end</span>
+    <span class="ruby-keyword">end</span>
+  <span class="ruby-keyword">end</span>
+<span class="ruby-keyword">end</span></pre>
+          </div><!-- make_call-source -->
+          
+        </div>
+
+        
+
+        
+      </div><!-- make_call-method -->
+
+    
+      <div id="method-i-set_parameters" class="method-detail ">
+        
+        <div class="method-heading">
+          <span class="method-name">set_parameters</span><span
+            class="method-args">(locations, creds, apps_to_start)</span>
+          <span class="method-click-advice">click to toggle source</span>
+        </div>
+        
+
+        <div class="method-description">
+          
+          
+          
+
+          
+          <div class="method-source-code" id="set_parameters-source">
+            <pre><span class="ruby-comment"># File lib/app_controller_client.rb, line 115</span>
+<span class="ruby-keyword">def</span> <span class="ruby-identifier">set_parameters</span>(<span class="ruby-identifier">locations</span>, <span class="ruby-identifier">creds</span>, <span class="ruby-identifier">apps_to_start</span>)
+  <span class="ruby-identifier">result</span> = <span class="ruby-string">&quot;&quot;</span>
+  <span class="ruby-identifier">make_call</span>(<span class="ruby-value">10</span>, <span class="ruby-constant">ABORT_ON_FAIL</span>) { 
+    <span class="ruby-identifier">result</span> = <span class="ruby-identifier">conn</span>.<span class="ruby-identifier">set_parameters</span>(<span class="ruby-identifier">locations</span>, <span class="ruby-identifier">creds</span>, <span class="ruby-identifier">apps_to_start</span>, <span class="ruby-ivar">@secret</span>)
+  }  
+  <span class="ruby-identifier">abort</span>(<span class="ruby-identifier">result</span>) <span class="ruby-keyword">if</span> <span class="ruby-identifier">result</span> <span class="ruby-operator">=~</span> <span class="ruby-regexp">%rError:/</span>
+<span class="ruby-keyword">end</span></pre>
+          </div><!-- set_parameters-source -->
+          
+        </div>
+
+        
+
+        
+      </div><!-- set_parameters-method -->
+
+    
+      <div id="method-i-status" class="method-detail ">
+        
+        <div class="method-heading">
+          <span class="method-name">status</span><span
+            class="method-args">()</span>
+          <span class="method-click-advice">click to toggle source</span>
+        </div>
+        
+
+        <div class="method-description">
+          
+          
+          
+
+          
+          <div class="method-source-code" id="status-source">
+            <pre><span class="ruby-comment"># File lib/app_controller_client.rb, line 123</span>
+<span class="ruby-keyword">def</span> <span class="ruby-identifier">status</span>()
+  <span class="ruby-keyword">return</span> <span class="ruby-node">&quot;Status of node at #{ip}:\n&quot;</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">get_status</span>()
+<span class="ruby-keyword">end</span></pre>
+          </div><!-- status-source -->
+          
+        </div>
+
+        
+
+        
+      </div><!-- status-method -->
+
+    
+      <div id="method-i-stop_app" class="method-detail ">
+        
+        <div class="method-heading">
+          <span class="method-name">stop_app</span><span
+            class="method-args">(app_name)</span>
+          <span class="method-click-advice">click to toggle source</span>
+        </div>
+        
+
+        <div class="method-description">
+          
+          
+          
+
+          
+          <div class="method-source-code" id="stop_app-source">
+            <pre><span class="ruby-comment"># File lib/app_controller_client.rb, line 131</span>
+<span class="ruby-keyword">def</span> <span class="ruby-identifier">stop_app</span>(<span class="ruby-identifier">app_name</span>)
+  <span class="ruby-identifier">make_call</span>(<span class="ruby-value">30</span>, <span class="ruby-constant">RETRY_ON_FAIL</span>) { <span class="ruby-ivar">@conn</span>.<span class="ruby-identifier">stop_app</span>(<span class="ruby-identifier">app_name</span>, <span class="ruby-ivar">@secret</span>) }
+<span class="ruby-keyword">end</span></pre>
+          </div><!-- stop_app-source -->
+          
+        </div>
+
+        
+
+        
+      </div><!-- stop_app-method -->
+
+    
+      <div id="method-i-update" class="method-detail ">
+        
+        <div class="method-heading">
+          <span class="method-name">update</span><span
+            class="method-args">(app_names)</span>
+          <span class="method-click-advice">click to toggle source</span>
+        </div>
+        
+
+        <div class="method-description">
+          
+          
+          
+
+          
+          <div class="method-source-code" id="update-source">
+            <pre><span class="ruby-comment"># File lib/app_controller_client.rb, line 135</span>
+<span class="ruby-keyword">def</span> <span class="ruby-identifier">update</span>(<span class="ruby-identifier">app_names</span>)
+  <span class="ruby-identifier">make_call</span>(<span class="ruby-value">30</span>, <span class="ruby-constant">RETRY_ON_FAIL</span>) { <span class="ruby-ivar">@conn</span>.<span class="ruby-identifier">update</span>(<span class="ruby-identifier">app_names</span>, <span class="ruby-ivar">@secret</span>) }
+<span class="ruby-keyword">end</span></pre>
+          </div><!-- update-source -->
+          
+        </div>
+
+        
+
+        
+      </div><!-- update-method -->
+
+    
+    </section><!-- public-instance-method-details -->
+  
+     <section id="public-class-5Buntitled-5D-method-details" class="method-section section">
+      <h3 class="section-header">Public Class Methods</h3>
+
+    
+      <div id="method-c-new" class="method-detail ">
+        
+        <div class="method-heading">
+          <span class="method-name">new</span><span
+            class="method-args">(ip, secret)</span>
+          <span class="method-click-advice">click to toggle source</span>
+        </div>
+        
+
+        <div class="method-description">
+          
+          
+          
+
+          
+          <div class="method-source-code" id="new-source">
+            <pre><span class="ruby-comment"># File lib/app_controller_client.rb, line 23</span>
+<span class="ruby-keyword">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">ip</span>, <span class="ruby-identifier">secret</span>)
+  <span class="ruby-ivar">@ip</span> = <span class="ruby-identifier">ip</span>
+  <span class="ruby-ivar">@secret</span> = <span class="ruby-identifier">secret</span>
+  
+  <span class="ruby-ivar">@conn</span> = <span class="ruby-constant">SOAP</span><span class="ruby-operator">::</span><span class="ruby-constant">RPC</span><span class="ruby-operator">::</span><span class="ruby-constant">Driver</span>.<span class="ruby-identifier">new</span>(<span class="ruby-node">&quot;https://#{@ip}:17443&quot;</span>)
+  <span class="ruby-ivar">@conn</span>.<span class="ruby-identifier">add_method</span>(<span class="ruby-string">&quot;set_parameters&quot;</span>, <span class="ruby-string">&quot;djinn_locations&quot;</span>, <span class="ruby-string">&quot;database_credentials&quot;</span>, <span class="ruby-string">&quot;app_names&quot;</span>, <span class="ruby-string">&quot;secret&quot;</span>)
+  <span class="ruby-ivar">@conn</span>.<span class="ruby-identifier">add_method</span>(<span class="ruby-string">&quot;status&quot;</span>, <span class="ruby-string">&quot;secret&quot;</span>)
+  <span class="ruby-ivar">@conn</span>.<span class="ruby-identifier">add_method</span>(<span class="ruby-string">&quot;update&quot;</span>, <span class="ruby-string">&quot;app_names&quot;</span>, <span class="ruby-string">&quot;secret&quot;</span>)
+  <span class="ruby-ivar">@conn</span>.<span class="ruby-identifier">add_method</span>(<span class="ruby-string">&quot;done_uploading&quot;</span>, <span class="ruby-string">&quot;appname&quot;</span>, <span class="ruby-string">&quot;location&quot;</span>, <span class="ruby-string">&quot;secret&quot;</span>)
+  <span class="ruby-ivar">@conn</span>.<span class="ruby-identifier">add_method</span>(<span class="ruby-string">&quot;is_done_initializing&quot;</span>, <span class="ruby-string">&quot;secret&quot;</span>)
+  <span class="ruby-ivar">@conn</span>.<span class="ruby-identifier">add_method</span>(<span class="ruby-string">&quot;is_done_loading&quot;</span>, <span class="ruby-string">&quot;secret&quot;</span>)
+  <span class="ruby-ivar">@conn</span>.<span class="ruby-identifier">add_method</span>(<span class="ruby-string">&quot;is_app_running&quot;</span>, <span class="ruby-string">&quot;appname&quot;</span>, <span class="ruby-string">&quot;secret&quot;</span>)
+  <span class="ruby-ivar">@conn</span>.<span class="ruby-identifier">add_method</span>(<span class="ruby-string">&quot;stop_app&quot;</span>, <span class="ruby-string">&quot;app_name&quot;</span>, <span class="ruby-string">&quot;secret&quot;</span>)    
+  <span class="ruby-ivar">@conn</span>.<span class="ruby-identifier">add_method</span>(<span class="ruby-string">&quot;get_all_public_ips&quot;</span>, <span class="ruby-string">&quot;secret&quot;</span>)
+  <span class="ruby-ivar">@conn</span>.<span class="ruby-identifier">add_method</span>(<span class="ruby-string">&quot;kill&quot;</span>, <span class="ruby-string">&quot;secret&quot;</span>)
+  <span class="ruby-ivar">@conn</span>.<span class="ruby-identifier">add_method</span>(<span class="ruby-string">&quot;get_role_info&quot;</span>, <span class="ruby-string">&quot;secret&quot;</span>)
+<span class="ruby-keyword">end</span></pre>
+          </div><!-- new-source -->
+          
+        </div>
+
+        
+
+        
+      </div><!-- new-method -->
+
+    
+    </section><!-- public-class-method-details -->
+  
+  </section><!-- 5Buntitled-5D -->
+
+</div><!-- documentation -->
+
+
+<footer id="validator-badges">
+  <p><a href="http://validator.w3.org/check/referer">[Validate]</a>
+  <p>Generated by <a href="https://github.com/rdoc/rdoc">RDoc</a> 3.12.
+  <p>Generated with the <a href="http://deveiate.org/projects/Darkfish-Rdoc/">Darkfish Rdoc Generator</a> 3.
+</footer>
+