RubyGems - webroar - Versions diffs - 0.6.1 → 0.7.0 - Mend

webroar 0.6.1 → 0.7.0

Files changed (402) hide show

data/CHANGELOG CHANGED Viewed

@@ -1,3 +1,10 @@
+v0.7.0 - 14444-Oct-2011
+--------------------
+* Upgraded Admin Panel to Rails 3.0.9.
+* Fixed logic to find out latest installed version.
+* Fixed 'user.yml' file importing issue.
 v0.6.1 - 19-Sep-2011
 --------------------

data/README CHANGED Viewed

@@ -48,7 +48,7 @@ Prerequisites
 - ruby 1.8-dev or 1.9-dev
 - openssl ruby extension (On Ubuntu/Debian it is available as libopenssl-ruby1.X)
 - zlib ruby extension
-- rubygems
+- rubygems 1.3.6 or later
 - C build tools (gcc etc) (e.g. build-essential on Ubuntu, Xcode on MacOS)
 - libsqlite3
 - libsqlite3-dev

data/doc/user-guide.html CHANGED Viewed

@@ -2,15 +2,28 @@
     "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
 <head>
-<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
-<meta name="generator" content="AsciiDoc 8.5.2" />
+<meta http-equiv="Content-Type" content="application/xhtml+xml; charset=UTF-8" />
+<meta name="generator" content="AsciiDoc 8.6.3" />
 <title>WebROaR User Guide</title>
 <style type="text/css">
-/* Debug borders */
-p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 {
-/*
-  border: 1px solid red;
-*/
+/* Sans-serif font. */
+h1, h2, h3, h4, h5, h6,
+div.title, caption.title,
+thead, p.table.header,
+div#toctitle,
+span#author, span#revnumber, span#revdate, span#revremark,
+div#footer {
+  font-family: Arial,Helvetica,sans-serif;
+}
+/* Serif font. */
+div.sectionbody {
+  font-family: Georgia,"Times New Roman",Times,serif;
+}
+/* Monospace font. */
+tt {
+  font-size: inherit;
 }
 body {
@@ -36,12 +49,12 @@ strong {
 }
 tt {
+  font-size: inherit;
   color: navy;
 }
 h1, h2, h3, h4, h5, h6 {
   color: #527bbd;
-  font-family: sans-serif;
   margin-top: 1.2em;
   margin-bottom: 0.5em;
   line-height: 1.3;
@@ -61,7 +74,6 @@ h3 + * {
 }
 div.sectionbody {
-  font-family: serif;
   margin-left: 0;
 }
@@ -77,6 +89,8 @@ p {
 ul, ol, li > p {
   margin-top: 0;
 }
+ul > li     { color: #aaa; }
+ul > li > * { color: black; }
 pre {
   padding: 0;
@@ -85,18 +99,15 @@ pre {
 span#author {
   color: #527bbd;
-  font-family: sans-serif;
   font-weight: bold;
   font-size: 1.1em;
 }
 span#email {
 }
 span#revnumber, span#revdate, span#revremark {
-  font-family: sans-serif;
 }
 div#footer {
-  font-family: sans-serif;
   font-size: small;
   border-top: 2px solid silver;
   padding-top: 0.5em;
@@ -135,7 +146,6 @@ div.content { /* Block element content. */
 /* Block element titles. */
 div.title, caption.title {
   color: #527bbd;
-  font-family: sans-serif;
   font-weight: bold;
   text-align: left;
   margin-top: 1.0em;
@@ -157,13 +167,15 @@ div.content + div.title {
 div.sidebarblock > div.content {
   background: #ffffee;
-  border: 1px solid silver;
+  border: 1px solid #dddddd;
+  border-left: 4px solid #f0f0f0;
   padding: 0.5em;
 }
 div.listingblock > div.content {
-  border: 1px solid silver;
-  background: #f4f4f4;
+  border: 1px solid #dddddd;
+  border-left: 5px solid #f0f0f0;
+  background: #f8f8f8;
   padding: 0.5em;
 }
@@ -171,7 +183,7 @@ div.quoteblock, div.verseblock {
   padding-left: 1.0em;
   margin-left: 1.0em;
   margin-right: 10%;
-  border-left: 5px solid #dddddd;
+  border-left: 5px solid #f0f0f0;
   color: #777777;
 }
@@ -180,8 +192,9 @@ div.quoteblock > div.attribution {
   text-align: right;
 }
-div.verseblock > div.content {
-  white-space: pre;
+div.verseblock > pre.content {
+  font-family: inherit;
+  font-size: inherit;
 }
 div.verseblock > div.attribution {
   padding-top: 0.75em;
@@ -258,8 +271,8 @@ div.tableblock > table {
   border: 3px solid #527bbd;
 }
 thead, p.table.header {
-  font-family: sans-serif;
   font-weight: bold;
+  color: #527bbd;
 }
 tfoot {
   font-weight: bold;
@@ -339,6 +352,14 @@ span.footnote, span.footnoteref {
   min-width: 100px;
 }
+div.colist td {
+  padding-right: 0.5em;
+  padding-bottom: 0.3em;
+  vertical-align: top;
+}
+div.colist td img {
+  margin-top: 0.3em;
+}
 @media print {
   div#footer-badges { display: none; }
@@ -350,7 +371,6 @@ div#toc {
 div#toctitle {
   color: #527bbd;
-  font-family: sans-serif;
   font-size: 1.1em;
   font-weight: bold;
   margin-top: 1.0em;
@@ -373,47 +393,7 @@ div.toclevel4 {
   margin-left: 6em;
   font-size: 0.9em;
 }
-/* Workarounds for IE6's broken and incomplete CSS2. */
-div.sidebar-content {
-  background: #ffffee;
-  border: 1px solid silver;
-  padding: 0.5em;
-}
-div.sidebar-title, div.image-title {
-  color: #527bbd;
-  font-family: sans-serif;
-  font-weight: bold;
-  margin-top: 0.0em;
-  margin-bottom: 0.5em;
-}
-div.listingblock div.content {
-  border: 1px solid silver;
-  background: #f4f4f4;
-  padding: 0.5em;
-}
-div.quoteblock-attribution {
-  padding-top: 0.5em;
-  text-align: right;
-}
-div.verseblock-content {
-  white-space: pre;
-}
-div.verseblock-attribution {
-  padding-top: 0.75em;
-  text-align: left;
-}
-div.exampleblock-content {
-  border-left: 3px solid #dddddd;
-  padding-left: 0.5em;
-}
-/* IE6 sets dynamically generated links as visited. */
-div#toc a:visited { color: blue; }
 </style>
 <script type="text/javascript">
 /*<![CDATA[*/
@@ -549,15 +529,16 @@ footnotes: function () {
 /*]]>*/
 </script>
 </head>
-<body>
+<body class="article">
 <div id="header">
 <h1>WebROaR User Guide</h1>
-<div id="toc">
-  <div id="toctitle">Table of Contents</div>
-  <noscript><p><b>JavaScript must be enabled in your browser to display the table of contents.</b></p></noscript>
+<div id="toc">
+  <div id="toctitle">Table of Contents</div>
+  <noscript><p><b>JavaScript must be enabled in your browser to display the table of contents.</b></p></noscript>
 </div>
 </div>
 <div id="content">
+<div class="sect1">
 <h2 id="_introduction">1. Introduction</h2>
 <div class="sectionbody">
 <div class="paragraph"><p><a href="http://webroar.in">WebROaR</a> is an application server that makes deployments of
@@ -566,7 +547,8 @@ view the run time performance numbers and sends email notifications in case any
 exceptions occur in any of the deployed applications.</p></div>
 <div class="paragraph"><p>It is 5 to 55% faster than all other comparable deployment stacks for
 Ruby on Rails applications.</p></div>
-<h3 id="_key_features">1.1. Key Features</h3><div style="clear:left"></div>
+<div class="sect2">
+<h3 id="_key_features">1.1. Key Features</h3>
 <div class="ulist"><ul>
 <li>
 <p>
@@ -628,6 +610,9 @@ SSL support.
 </li>
 </ul></div>
 </div>
+</div>
+</div>
+<div class="sect1">
 <h2 id="_supported_operating_systems">2. Supported Operating Systems</h2>
 <div class="sectionbody">
 <div class="paragraph"><p>WebROaR has been tested on Ubuntu 8.10/9.04/9.10/10.04/10.10/11.04,
@@ -635,9 +620,12 @@ Debian 5 (64 Bit), Mac OS X (v10.5 &amp; v10.6), Arch Linux 2009.08 and Cent OS
 Basically, it should be able to run on any *IX OS.</p></div>
 <div class="paragraph"><p>Currently it does not support Microsoft&#174; Windows.</p></div>
 </div>
+</div>
+<div class="sect1">
 <h2 id="_install">3. Install</h2>
 <div class="sectionbody">
-<h3 id="_prerequisites">3.1. Prerequisites</h3><div style="clear:left"></div>
+<div class="sect2">
+<h3 id="_prerequisites">3.1. Prerequisites</h3>
 <div class="ulist"><ul>
 <li>
 <p>
@@ -661,7 +649,7 @@ zlib ruby extension
 </li>
 <li>
 <p>
-rubygems
+rubygems 1.3.6 or later
 </p>
 </li>
 <li>
@@ -690,10 +678,13 @@ gnutls-dev 2.4.1 or later (Only necessary in case SSL support is required)
 </p>
 </li>
 </ul></div>
-<h3 id="_procedure">3.2. Procedure</h3><div style="clear:left"></div>
+</div>
+<div class="sect2">
+<h3 id="_procedure">3.2. Procedure</h3>
 <div class="paragraph"><p>WebROaR can be installed through its gem or directly from its source code. One
 can also use Capistrano to perform a non-interactive installation of the
 server.</p></div>
+<div class="sect3">
 <h4 id="_install_using_gem">3.2.1. Install using gem</h4>
 <div class="paragraph"><p>WebROaR can be installed using the following commands:</p></div>
 <div class="listingblock">
@@ -721,6 +712,8 @@ command line switch with <strong>sudo webroar install</strong> command mentioned
 </td>
 </tr></table>
 </div>
+</div>
+<div class="sect3">
 <h4 id="_install_from_source_code">3.2.2. Install from source code</h4>
 <div class="paragraph"><p>If you like living in the fast lane, you can install the edge version giving
 the following commands:</p></div>
@@ -750,6 +743,8 @@ sudo rake install</tt></pre>
 </td>
 </tr></table>
 </div>
+</div>
+<div class="sect3">
 <h4 id="_non_interactive_install_using_capistrano">3.2.3. Non-Interactive Install using Capistrano</h4>
 <div class="paragraph"><p>You can use following Capistrano script to install the edge version on a
 remote machine</p></div>
@@ -877,7 +872,10 @@ Update the current version with the latest code from github using
 </p>
 </li>
 </ol></div>
-<h3 id="_troubleshooting">3.3. Troubleshooting</h3><div style="clear:left"></div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_troubleshooting">3.3. Troubleshooting</h3>
 <div class="admonitionblock">
 <table><tr>
 <td class="icon">
@@ -898,7 +896,7 @@ rubygems version or any other reason), you can install the following dependent
 </p>
 <div class="literalblock">
 <div class="content">
-<pre><tt>rails-2.3.9, calendar_date_select, rake, rspec, sqlite3, starling, will_paginate</tt></pre>
+<pre><tt>rails-3.0.9, rake, rspec, sqlite3, starling, will_paginate</tt></pre>
 </div></div>
 </li>
 <li>
@@ -916,7 +914,9 @@ dump file would be created in /tmp if <em>gcore</em> is available on that machin
 </p>
 </li>
 </ul></div>
-<h3 id="_setting_up_database_for_server_admin_panel">3.4. Setting up database for server admin panel</h3><div style="clear:left"></div>
+</div>
+<div class="sect2">
+<h3 id="_setting_up_database_for_server_admin_panel">3.4. Setting up database for server admin panel</h3>
 <div class="paragraph"><p>The server&#8217;s admin panel itself is a Ruby on Rails&#8482; web application, and by
 default uses sqlite as it&#8217;s database. You can edit
 <strong>admin_panel/config/database.yml</strong> to setup a database of your liking and
@@ -929,6 +929,9 @@ rake db:migrate</tt></pre>
 <div class="paragraph"><p><strong>admin_panel</strong> directory would be present under the server&#8217;s rubygem
 directory.</p></div>
 </div>
+</div>
+</div>
+<div class="sect1">
 <h2 id="_usage">4. Usage</h2>
 <div class="sectionbody">
 <div class="paragraph"><p>Start/Stop/Restart WebROaR:</p></div>
@@ -968,9 +971,12 @@ server even when the admin panel is stopped.</p></div>
 </tr></table>
 </div>
 </div>
+</div>
+<div class="sect1">
 <h2 id="_deploying_applications">5. Deploying applications</h2>
 <div class="sectionbody">
-<h3 id="_deploy_using_admin_panel">5.1. Deploy using Admin Panel</h3><div style="clear:left"></div>
+<div class="sect2">
+<h3 id="_deploy_using_admin_panel">5.1. Deploy using Admin Panel</h3>
 <div class="paragraph"><p>If the server got installed successfully, you should be able access it&#8217;s admin
 panel using the link:<br />
 <strong>http://&lt;yourservername&gt;:&lt;port&gt;/admin-panel</strong></p></div>
@@ -986,7 +992,9 @@ your choice accessing the <strong>Configuration</strong> link of the admin panel
 The application starts up automatically after deployment.</td>
 </tr></table>
 </div>
-<h3 id="_deploy_using_capistrano">5.2. Deploy using Capistrano</h3><div style="clear:left"></div>
+</div>
+<div class="sect2">
+<h3 id="_deploy_using_capistrano">5.2. Deploy using Capistrano</h3>
 <div class="paragraph"><p>WebROaR can be easily integrated with Capistrano using the following
 instructions.</p></div>
 <div class="paragraph"><p>After installing Capistrano, run the following command in your application&#8217;s
@@ -1085,7 +1093,9 @@ application while upgrading it in the future:</p></div>
 cap deploy:start
 cap deploy:restart</tt></pre>
 </div></div>
-<h3 id="_rack_applications_other_than_rails">5.3. Rack applications (other than Rails)</h3><div style="clear:left"></div>
+</div>
+<div class="sect2">
+<h3 id="_rack_applications_other_than_rails">5.3. Rack applications (other than Rails)</h3>
 <div class="paragraph"><p>To deploy any Rack based application (other than Rails) the following are
 required in it&#8217;s root directory:</p></div>
 <div class="ulist"><ul>
@@ -1146,6 +1156,9 @@ ENV['APP_BASE_URI\'] - To get the baseuri
 </li>
 </ul></div>
 </div>
+</div>
+</div>
+<div class="sect1">
 <h2 id="_accessing_run_time_statistics">6. Accessing run time statistics</h2>
 <div class="sectionbody">
 <div class="paragraph"><p>For those applications whose Analytics are <strong>Enabled</strong> in their configuration,
@@ -1215,6 +1228,8 @@ about a minute for it’s data to show up in the graphs.</td>
 </tr></table>
 </div>
 </div>
+</div>
+<div class="sect1">
 <h2 id="_exception_tracking_and_notifications">7. Exception Tracking and Notifications</h2>
 <div class="sectionbody">
 <div class="paragraph"><p>Any exceptions that occur in any of the deployed application are captured by
@@ -1233,6 +1248,8 @@ after it has occurred.</td>
 </tr></table>
 </div>
 </div>
+</div>
+<div class="sect1">
 <h2 id="_uninstall">8. Uninstall</h2>
 <div class="sectionbody">
 <div class="paragraph"><p>If you didn&#8217;t like the server, use the following commands in sequence to
@@ -1243,6 +1260,8 @@ uninstall it.</p></div>
 sudo gem uninstall webroar</tt></pre>
 </div></div>
 </div>
+</div>
+<div class="sect1">
 <h2 id="_test_suite">9. Test Suite</h2>
 <div class="sectionbody">
 <div class="paragraph"><p>If you are a programmer and wish to play around with the server&#8217;s code, you
@@ -1287,9 +1306,12 @@ Build Tests
 </li>
 </ul></div>
 </div>
+</div>
+<div class="sect1">
 <h2 id="_command_line_options">10. Command Line Options</h2>
 <div class="sectionbody">
-<h3 id="_webroar_help">10.1. webroar help</h3><div style="clear:left"></div>
+<div class="sect2">
+<h3 id="_webroar_help">10.1. webroar help</h3>
 <div class="listingblock">
 <div class="content">
 <pre><tt>  Usage:
@@ -1307,7 +1329,9 @@ Build Tests
   For help on a particular command, use 'webroar help COMMAND'.</tt></pre>
 </div></div>
-<h3 id="_webroar_install">10.2. webroar install</h3><div style="clear:left"></div>
+</div>
+<div class="sect2">
+<h3 id="_webroar_install">10.2. webroar install</h3>
 <div class="listingblock">
 <div class="content">
 <pre><tt>  Usage:
@@ -1350,7 +1374,9 @@ Build Tests
   Summary:
     Install the server</tt></pre>
 </div></div>
-<h3 id="_webroar_uninstall">10.3. webroar uninstall</h3><div style="clear:left"></div>
+</div>
+<div class="sect2">
+<h3 id="_webroar_uninstall">10.3. webroar uninstall</h3>
 <div class="listingblock">
 <div class="content">
 <pre><tt>  Usage:
@@ -1359,7 +1385,9 @@ Build Tests
   Summary:
     Uninstall the server</tt></pre>
 </div></div>
-<h3 id="_webroar_start">10.4. webroar start</h3><div style="clear:left"></div>
+</div>
+<div class="sect2">
+<h3 id="_webroar_start">10.4. webroar start</h3>
 <div class="listingblock">
 <div class="content">
 <pre><tt>  Usage:
@@ -1376,7 +1404,9 @@ Build Tests
     'start' command without any arguments starts the server. One can start
     multiple applications together by passing multiple names.</tt></pre>
 </div></div>
-<h3 id="_webroar_stop">10.5. webroar stop</h3><div style="clear:left"></div>
+</div>
+<div class="sect2">
+<h3 id="_webroar_stop">10.5. webroar stop</h3>
 <div class="listingblock">
 <div class="content">
 <pre><tt>  Usage:
@@ -1393,7 +1423,9 @@ Build Tests
     'stop' command without any arguments stops the server. One can stop
     multiple applications together by passing multiple names.</tt></pre>
 </div></div>
-<h3 id="_webroar_restart">10.6. webroar restart</h3><div style="clear:left"></div>
+</div>
+<div class="sect2">
+<h3 id="_webroar_restart">10.6. webroar restart</h3>
 <div class="listingblock">
 <div class="content">
 <pre><tt>  Usage:
@@ -1410,7 +1442,9 @@ Build Tests
     'restart' command without any arguments restarts the server. One can
     restart multiple applications together by passing multiple names.</tt></pre>
 </div></div>
-<h3 id="_webroar_add">10.7. webroar add</h3><div style="clear:left"></div>
+</div>
+<div class="sect2">
+<h3 id="_webroar_add">10.7. webroar add</h3>
 <div class="listingblock">
 <div class="content">
 <pre><tt>  Usage:
@@ -1487,7 +1521,9 @@ Build Tests
     or 'config.ru' file in the current directory. If any one of the files found,
     it passes name of the current directory as an application name.</tt></pre>
 </div></div>
-<h3 id="_webroar_remove">10.8. webroar remove</h3><div style="clear:left"></div>
+</div>
+<div class="sect2">
+<h3 id="_webroar_remove">10.8. webroar remove</h3>
 <div class="listingblock">
 <div class="content">
 <pre><tt>  Usage:
@@ -1505,7 +1541,9 @@ Build Tests
     or 'config.ru' file in the current directory. If any one of the files found,
     it passes name of the current directory as an application name.</tt></pre>
 </div></div>
-<h3 id="_webroar_test">10.9. webroar test</h3><div style="clear:left"></div>
+</div>
+<div class="sect2">
+<h3 id="_webroar_test">10.9. webroar test</h3>
 <div class="listingblock">
 <div class="content">
 <pre><tt>  Usage:
@@ -1526,10 +1564,12 @@ Build Tests
 </div></div>
 </div>
 </div>
+</div>
+</div>
 <div id="footnotes"><hr /></div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2011-09-16 12:44:06 IST
+Last updated 2011-10-04 17:33:37 IST
 </div>
 </div>
 </body>