RubyGems - webroar - Versions diffs - 0.3.1 → 0.4.0 - Mend

webroar 0.3.1 → 0.4.0

Files changed (97) hide show

data/CHANGELOG +48 -1
data/README +11 -14
data/Rakefile +1 -1
data/conf/mime_type.yml +172 -166
data/conf/server_internal_config.yml +30 -8
data/doc/user-guide.html +294 -153
data/doc/user-guide.txt +9 -13
data/lib/command_runner.rb +1 -0
data/lib/dependencies.rb +18 -15
data/lib/installer.rb +115 -50
data/src/admin_panel/app/controllers/admin_controller.rb +1 -15
data/src/admin_panel/app/controllers/application_controller.rb +2 -2
data/src/admin_panel/app/controllers/application_specification_controller.rb +2 -1
data/src/admin_panel/app/controllers/headers_controller.rb +73 -0
data/src/admin_panel/app/controllers/mail_specification_controller.rb +10 -0
data/src/admin_panel/app/controllers/server_specification_controller.rb +14 -0
data/src/admin_panel/app/helpers/admin_helper.rb +0 -85
data/src/admin_panel/app/models/app.rb +1 -1
data/src/admin_panel/app/models/application_specification.rb +33 -25
data/src/admin_panel/app/models/headers.rb +116 -0
data/src/admin_panel/app/models/mail_specification.rb +20 -5
data/src/admin_panel/app/models/server_specification.rb +2 -7
data/src/admin_panel/app/views/admin/configuration.html.erb +10 -5
data/src/admin_panel/app/views/exceptions/_exception_list_partial.html.erb +4 -4
data/src/admin_panel/app/views/graph/_graph_page.html.erb +3 -0
data/src/admin_panel/app/views/headers/_add_expires_text_box.html.erb +35 -0
data/src/admin_panel/app/views/headers/_expires_by_type_form.html.erb +65 -0
data/src/admin_panel/app/views/headers/_headers_table.html.erb +113 -0
data/src/admin_panel/app/views/mail_specification/_current_spec.html.erb +168 -0
data/src/admin_panel/app/views/{admin → server_specification}/_add_div.html.erb +1 -1
data/src/admin_panel/config/initializers/application_constants.rb +6 -0
data/src/admin_panel/lib/control.rb +6 -3
data/src/admin_panel/lib/scgi.rb +74 -21
data/src/admin_panel/lib/yaml_writer.rb +51 -17
data/src/admin_panel/public/javascripts/application.js +20 -1
data/src/head/wr_access_log.c +2 -2
data/src/head/wr_application.c +294 -236
data/src/head/wr_application.h +8 -8
data/src/head/wr_configurator.c +451 -517
data/src/head/wr_configurator.h +10 -115
data/src/head/wr_connection.c +26 -25
data/src/head/wr_connection.h +2 -3
data/src/head/wr_controller.c +110 -93
data/src/head/wr_controller.h +6 -6
data/src/head/wr_main.c +31 -24
data/src/head/wr_request.c +70 -93
data/src/head/wr_request.h +0 -4
data/src/head/wr_resolver.c +21 -15
data/src/head/wr_resolver.h +2 -2
data/src/head/wr_server.c +36 -26
data/src/head/wr_server.h +5 -5
data/src/head/wr_worker.c +551 -512
data/src/head/wr_worker.h +33 -20
data/src/helper/wr_config.c +316 -0
data/src/helper/wr_config.h +235 -0
data/src/helper/wr_helper.h +1 -5
data/src/helper/wr_logger.c +4 -4
data/src/helper/wr_scgi.c +3 -4
data/src/helper/wr_scgi.h +2 -0
data/src/helper/wr_string.h +2 -2
data/src/helper/wr_util.c +3 -1
data/src/helper/wr_util.h +0 -0
data/src/helper/wr_yaml_parser.c +30 -0
data/src/helper/wr_yaml_parser.h +1 -0
data/src/ruby_lib/exception_tracker/instrumentation/action_controller.rb +2 -1
data/src/ruby_lib/mailer/smtpmail.rb +7 -4
data/src/ruby_lib/profiler/instrumentation/action_controller.rb +2 -1
data/src/ruby_lib/profiler/instrumentation/active_record.rb +3 -0
data/src/ruby_lib/rack/adapter/rails.rb +14 -7
data/src/ruby_lib/ruby_interface/client.rb +1 -1
data/src/ruby_lib/ruby_interface/version.rb +2 -2
data/src/ruby_lib/webroar_app_loader.rb +4 -2
data/src/worker/wkr_controller.c +200 -140
data/src/worker/wkr_http.c +14 -28
data/src/worker/wkr_http.h +4 -4
data/src/worker/wkr_http_request.c +12 -11
data/src/worker/wkr_http_request.h +7 -8
data/src/worker/wkr_http_response.c +10 -14
data/src/worker/wkr_http_response.h +0 -1
data/src/worker/wkr_main.c +74 -140
data/src/worker/wkr_static.c +295 -108
data/src/worker/wkr_static.h +20 -7
data/src/worker/worker.c +245 -70
data/src/worker/worker.h +46 -34
data/tasks/compile.rake +128 -175
data/tasks/test.rake +345 -469
data/test/spec/webroar_command_spec.rb +23 -0
metadata +173 -43
data/src/admin_panel/vendor/plugins/action_mailer_optional_tls/README +0 -34
data/src/admin_panel/vendor/plugins/action_mailer_optional_tls/Rakefile +0 -13
data/src/admin_panel/vendor/plugins/action_mailer_optional_tls/init.rb +0 -5
data/src/admin_panel/vendor/plugins/action_mailer_optional_tls/lib/action_mailer_tls.rb +0 -16
data/src/admin_panel/vendor/plugins/action_mailer_optional_tls/lib/smtp_tls.rb +0 -123
data/src/admin_panel/vendor/plugins/action_mailer_optional_tls/test/tls_test.rb +0 -42
data/src/head/wr_config.h +0 -165
data/src/ruby_lib/mailer/action_mailer_tls.rb +0 -16
data/src/ruby_lib/mailer/smtp_tls.rb +0 -123

data/doc/user-guide.html CHANGED Viewed

@@ -3,7 +3,8 @@
 <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.2.7" />
+<meta name="generator" content="AsciiDoc 8.5.2" />
+<title>WebROaR User Guide</title>
 <style type="text/css">
 /* Debug borders */
 p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 {
@@ -90,7 +91,7 @@ span#author {
 }
 span#email {
 }
-span#revision {
+span#revnumber, span#revdate, span#revremark {
   font-family: sans-serif;
 }
@@ -110,17 +111,21 @@ div#footer-badges {
   padding-bottom: 0.5em;
 }
-div#preamble,
+div#preamble {
+  margin-top: 1.5em;
+  margin-bottom: 1.5em;
+}
 div.tableblock, div.imageblock, div.exampleblock, div.verseblock,
 div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
 div.admonitionblock {
-  margin-right: 10%;
-  margin-top: 1.5em;
+  margin-top: 1.0em;
   margin-bottom: 1.5em;
 }
 div.admonitionblock {
-  margin-top: 2.5em;
-  margin-bottom: 2.5em;
+  margin-top: 2.0em;
+  margin-bottom: 2.0em;
+  margin-right: 10%;
+  color: #606060;
 }
 div.content { /* Block element content. */
@@ -156,26 +161,25 @@ div.sidebarblock > div.content {
   padding: 0.5em;
 }
-div.listingblock {
-  margin-right: 0%;
-}
 div.listingblock > div.content {
   border: 1px solid silver;
   background: #f4f4f4;
   padding: 0.5em;
 }
-div.quoteblock {
-  padding-left: 2.0em;
+div.quoteblock, div.verseblock {
+  padding-left: 1.0em;
+  margin-left: 1.0em;
+  margin-right: 10%;
+  border-left: 5px solid #dddddd;
+  color: #777777;
 }
 div.quoteblock > div.attribution {
   padding-top: 0.5em;
   text-align: right;
 }
-div.verseblock {
-  padding-left: 2.0em;
-}
 div.verseblock > div.content {
   white-space: pre;
 }
@@ -198,17 +202,17 @@ div.admonitionblock .icon {
 }
 div.admonitionblock td.content {
   padding-left: 0.5em;
-  border-left: 2px solid silver;
+  border-left: 3px solid #dddddd;
 }
 div.exampleblock > div.content {
-  border-left: 2px solid silver;
-  padding: 0.5em;
+  border-left: 3px solid #dddddd;
+  padding-left: 0.5em;
 }
 div.imageblock div.content { padding-left: 0; }
-div.imageblock img { border: 1px solid silver; }
 span.image img { border-style: none; }
+a.image:visited { color: white; }
 dl {
   margin-top: 0.8em;
@@ -218,6 +222,7 @@ dt {
   margin-top: 0.5em;
   margin-bottom: 0;
   font-style: normal;
+  color: navy;
 }
 dd > *:first-child {
   margin-top: 0.1em;
@@ -226,44 +231,123 @@ dd > *:first-child {
 ul, ol {
     list-style-position: outside;
 }
-div.olist > ol {
+ol.arabic {
   list-style-type: decimal;
 }
-div.olist2 > ol {
+ol.loweralpha {
   list-style-type: lower-alpha;
 }
+ol.upperalpha {
+  list-style-type: upper-alpha;
+}
+ol.lowerroman {
+  list-style-type: lower-roman;
+}
+ol.upperroman {
+  list-style-type: upper-roman;
+}
+div.compact ul, div.compact ol,
+div.compact p, div.compact p,
+div.compact div, div.compact div {
+  margin-top: 0.1em;
+  margin-bottom: 0.1em;
+}
 div.tableblock > table {
   border: 3px solid #527bbd;
 }
-thead {
+thead, p.table.header {
   font-family: sans-serif;
   font-weight: bold;
 }
 tfoot {
   font-weight: bold;
 }
+td > div.verse {
+  white-space: pre;
+}
+p.table {
+  margin-top: 0;
+}
+/* Because the table frame attribute is overriden by CSS in most browsers. */
+div.tableblock > table[frame="void"] {
+  border-style: none;
+}
+div.tableblock > table[frame="hsides"] {
+  border-left-style: none;
+  border-right-style: none;
+}
+div.tableblock > table[frame="vsides"] {
+  border-top-style: none;
+  border-bottom-style: none;
+}
-div.hlist {
+div.hdlist {
   margin-top: 0.8em;
   margin-bottom: 0.8em;
 }
-div.hlist td {
+div.hdlist tr {
   padding-bottom: 15px;
 }
-td.hlist1 {
+dt.hdlist1.strong, td.hdlist1.strong {
+  font-weight: bold;
+}
+td.hdlist1 {
   vertical-align: top;
   font-style: normal;
   padding-right: 0.8em;
+  color: navy;
 }
-td.hlist2 {
+td.hdlist2 {
   vertical-align: top;
 }
+div.hdlist.compact tr {
+  margin: 0;
+  padding-bottom: 0;
+}
+.comment {
+  background: yellow;
+}
+.footnote, .footnoteref {
+  font-size: 0.8em;
+}
+span.footnote, span.footnoteref {
+  vertical-align: super;
+}
+#footnotes {
+  margin: 20px 0 20px 0;
+  padding: 7px 0 0 0;
+}
+#footnotes div.footnote {
+  margin: 0 0 5px 0;
+}
+#footnotes hr {
+  border: none;
+  border-top: 1px solid silver;
+  height: 1px;
+  text-align: left;
+  margin-left: 0;
+  width: 20%;
+  min-width: 100px;
+}
 @media print {
   div#footer-badges { display: none; }
 }
+div#toc {
+  margin-bottom: 2.5em;
+}
 div#toctitle {
   color: #527bbd;
   font-family: sans-serif;
@@ -324,24 +408,22 @@ div.verseblock-attribution {
 }
 div.exampleblock-content {
-  border-left: 2px solid silver;
+  border-left: 3px solid #dddddd;
   padding-left: 0.5em;
 }
 /* IE6 sets dynamically generated links as visited. */
 div#toc a:visited { color: blue; }
-/* Because IE6 child selector is broken. */
-div.olist2 ol {
-  list-style-type: lower-alpha;
-}
-div.olist2 div.olist ol {
-  list-style-type: decimal;
-}
 </style>
 <script type="text/javascript">
 /*<![CDATA[*/
-window.onload = function(){generateToc(3)}
+window.onload = function(){asciidoc.footnotes(); asciidoc.toc(3);}
+var asciidoc = {  // Namespace.
+/////////////////////////////////////////////////////////////////////
+// Table Of Contents generator
+/////////////////////////////////////////////////////////////////////
 /* Author: Mihai Bazon, September 2002
  * http://students.infoiasi.ro/~mishoo
  *
@@ -353,53 +435,55 @@ window.onload = function(){generateToc(3)}
  */
  /* modified by Troy D. Hanson, September 2006. License: GPL */
- /* modified by Stuart Rackham, October 2006. License: GPL */
-function getText(el) {
-  var text = "";
-  for (var i = el.firstChild; i != null; i = i.nextSibling) {
-    if (i.nodeType == 3 /* Node.TEXT_NODE */) // IE doesn't speak constants.
-      text += i.data;
-    else if (i.firstChild != null)
-      text += getText(i);
-  }
-  return text;
-}
+ /* modified by Stuart Rackham, 2006, 2009. License: GPL */
-function TocEntry(el, text, toclevel) {
-  this.element = el;
-  this.text = text;
-  this.toclevel = toclevel;
-}
+// toclevels = 1..4.
+toc: function (toclevels) {
-function tocEntries(el, toclevels) {
-  var result = new Array;
-  var re = new RegExp('[hH]([2-'+(toclevels+1)+'])');
-  // Function that scans the DOM tree for header elements (the DOM2
-  // nodeIterator API would be a better technique but not supported by all
-  // browsers).
-  var iterate = function (el) {
+  function getText(el) {
+    var text = "";
     for (var i = el.firstChild; i != null; i = i.nextSibling) {
-      if (i.nodeType == 1 /* Node.ELEMENT_NODE */) {
-        var mo = re.exec(i.tagName)
-        if (mo)
-          result[result.length] = new TocEntry(i, getText(i), mo[1]-1);
-        iterate(i);
+      if (i.nodeType == 3 /* Node.TEXT_NODE */) // IE doesn't speak constants.
+        text += i.data;
+      else if (i.firstChild != null)
+        text += getText(i);
+    }
+    return text;
+  }
+  function TocEntry(el, text, toclevel) {
+    this.element = el;
+    this.text = text;
+    this.toclevel = toclevel;
+  }
+  function tocEntries(el, toclevels) {
+    var result = new Array;
+    var re = new RegExp('[hH]([2-'+(toclevels+1)+'])');
+    // Function that scans the DOM tree for header elements (the DOM2
+    // nodeIterator API would be a better technique but not supported by all
+    // browsers).
+    var iterate = function (el) {
+      for (var i = el.firstChild; i != null; i = i.nextSibling) {
+        if (i.nodeType == 1 /* Node.ELEMENT_NODE */) {
+          var mo = re.exec(i.tagName);
+          if (mo && (i.getAttribute("class") || i.getAttribute("className")) != "float") {
+            result[result.length] = new TocEntry(i, getText(i), mo[1]-1);
+          }
+          iterate(i);
+        }
       }
     }
+    iterate(el);
+    return result;
   }
-  iterate(el);
-  return result;
-}
-// This function does the work. toclevels = 1..4.
-function generateToc(toclevels) {
   var toc = document.getElementById("toc");
-  var entries = tocEntries(document.getElementsByTagName("body")[0], toclevels);
+  var entries = tocEntries(document.getElementById("content"), toclevels);
   for (var i = 0; i < entries.length; ++i) {
     var entry = entries[i];
     if (entry.element.id == "")
-      entry.element.id = "toc" + i;
+      entry.element.id = "_toc_" + i;
     var a = document.createElement("a");
     a.href = "#" + entry.element.id;
     a.appendChild(document.createTextNode(entry.text));
@@ -409,11 +493,61 @@ function generateToc(toclevels) {
     toc.appendChild(div);
   }
   if (entries.length == 0)
-    document.getElementById("header").removeChild(toc);
+    toc.parentNode.removeChild(toc);
+},
+/////////////////////////////////////////////////////////////////////
+// Footnotes generator
+/////////////////////////////////////////////////////////////////////
+/* Based on footnote generation code from:
+ * http://www.brandspankingnew.net/archive/2005/07/format_footnote.html
+ */
+footnotes: function () {
+  var cont = document.getElementById("content");
+  var noteholder = document.getElementById("footnotes");
+  var spans = cont.getElementsByTagName("span");
+  var refs = {};
+  var n = 0;
+  for (i=0; i<spans.length; i++) {
+    if (spans[i].className == "footnote") {
+      n++;
+      // Use [\s\S] in place of . so multi-line matches work.
+      // Because JavaScript has no s (dotall) regex flag.
+      note = spans[i].innerHTML.match(/\s*\[([\s\S]*)]\s*/)[1];
+      noteholder.innerHTML +=
+        "<div class='footnote' id='_footnote_" + n + "'>" +
+        "<a href='#_footnoteref_" + n + "' title='Return to text'>" +
+        n + "</a>. " + note + "</div>";
+      spans[i].innerHTML =
+        "[<a id='_footnoteref_" + n + "' href='#_footnote_" + n +
+        "' title='View footnote' class='footnote'>" + n + "</a>]";
+      var id =spans[i].getAttribute("id");
+      if (id != null) refs["#"+id] = n;
+    }
+  }
+  if (n == 0)
+    noteholder.parentNode.removeChild(noteholder);
+  else {
+    // Process footnoterefs.
+    for (i=0; i<spans.length; i++) {
+      if (spans[i].className == "footnoteref") {
+        var href = spans[i].getElementsByTagName("a")[0].getAttribute("href");
+        href = href.match(/#.*/)[0];  // Because IE return full URL.
+        n = refs[href];
+        spans[i].innerHTML =
+          "[<a href='#_footnote_" + n +
+          "' title='View footnote' class='footnote'>" + n + "</a>]";
+      }
+    }
+  }
+}
 }
 /*]]>*/
 </script>
-<title>WebROaR User Guide</title>
 </head>
 <body>
 <div id="header">
@@ -423,16 +557,17 @@ function generateToc(toclevels) {
   <noscript><p><b>JavaScript must be enabled in your browser to display the table of contents.</b></p></noscript>
 </div>
 </div>
+<div id="content">
 <h2 id="_introduction">1. Introduction</h2>
 <div class="sectionbody">
-<div class="para"><p><a href="http://webroar.in">WebROaR</a> is an application server that makes deployments of
+<div class="paragraph"><p><a href="http://webroar.in">WebROaR</a> is an application server that makes deployments of
 ruby web applications extremely simple. It provides an integrated solution to
 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="para"><p>It is 5 to 55% faster than all other comparable deployment stacks for
+<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="ilist"><ul>
+<div class="ulist"><ul>
 <li>
 <p>
 Maximum Performance.
@@ -478,6 +613,16 @@ Generates notifications in case any exceptions occur in any of the deployed
 </li>
 <li>
 <p>
+Zero Downtime Application Upgrades.
+</p>
+</li>
+<li>
+<p>
+Static assets encoding.
+</p>
+</li>
+<li>
+<p>
 SSL support.
 </p>
 </li>
@@ -485,15 +630,15 @@ SSL support.
 </div>
 <h2 id="_supported_operating_systems">2. Supported Operating Systems</h2>
 <div class="sectionbody">
-<div class="para"><p>WebROaR has been tested on Ubuntu 8.10/9.04/9.10, Debian 5 (64 Bit), Mac OS X
-(v10.5 &amp; v10.6), Arch Linux 2009.08 and Cent OS 5.2. Basically, it should be
-able to run on any *IX OS.</p></div>
-<div class="para"><p>Currently it does not support Microsoft&#174; Windows.</p></div>
+<div class="paragraph"><p>WebROaR has been tested on Ubuntu 8.10/9.04/9.10/10.04, Debian 5 (64 Bit),
+Mac OS X (v10.5 &amp; v10.6), Arch Linux 2009.08 and Cent OS 5.2. 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>
 <h2 id="_install">3. Install</h2>
 <div class="sectionbody">
 <h3 id="_prerequisites">3.1. Prerequisites</h3><div style="clear:left"></div>
-<div class="ilist"><ul>
+<div class="ulist"><ul>
 <li>
 <p>
 ruby 1.8.x or 1.9.x
@@ -545,26 +690,12 @@ gnutls-dev 2.4.1 or later (Only necessary in case SSL support is required)
 </p>
 </li>
 </ul></div>
-<div class="admonitionblock">
-<table><tr>
-<td class="icon">
-<img src="./images/icons/note.png" alt="Note" />
-</td>
-<td class="content">
-<div class="title">Ruby Shared Library</div>
-<div class="para"><p>The server needs the shared library - libruby.so to run the ruby web
-applications.</p></div>
-<div class="para"><p>If you are building ruby from source, please ensure you pass the flag
-<strong>&#8212;enable-shared</strong> while executing its ./configure script.</p></div>
-</td>
-</tr></table>
-</div>
 <h3 id="_procedure">3.2. Procedure</h3><div style="clear:left"></div>
-<div class="para"><p>WebROaR can be installed through its gem or directly from its source code. One
+<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>
 <h4 id="_install_using_gem">3.2.1. Install using gem</h4>
-<div class="para"><p>WebROaR can be installed using the following commands:</p></div>
+<div class="paragraph"><p>WebROaR can be installed using the following commands:</p></div>
 <div class="listingblock">
 <div class="content">
 <pre><tt>sudo gem install webroar
@@ -577,21 +708,21 @@ sudo webroar install</tt></pre>
 </td>
 <td class="content">
 <div class="title">SSL Support</div>
-<div class="para"><p>In case you would like to setup SSL support for the server, use the following
+<div class="paragraph"><p>In case you would like to setup SSL support for the server, use the following
 command line switch with <strong>sudo webroar install</strong> command mentioned above.</p></div>
 <div class="listingblock">
 <div class="content">
 <pre><tt>sudo webroar install --ssl-support</tt></pre>
 </div></div>
-<div class="para"><p>Configure further SSL options in the server's admin panel
+<div class="paragraph"><p>Configure further SSL options in the server&#8217;s admin panel
         <strong>http://&lt;yourservername&gt;:&lt;port&gt;/admin-panel/configuration</strong></p></div>
-<div class="para"><p>After restarting the server, admin panel would now also be accessible over SSL.
+<div class="paragraph"><p>After restarting the server, admin panel would now also be accessible over SSL.
 <strong>https://&lt;yourservername&gt;:&lt;port&gt;/admin-panel</strong></p></div>
 </td>
 </tr></table>
 </div>
 <h4 id="_install_from_source_code">3.2.2. Install from source code</h4>
-<div class="para"><p>If you like living in the fast lane, you can install the edge version giving
+<div class="paragraph"><p>If you like living in the fast lane, you can install the edge version giving
 the following commands:</p></div>
 <div class="listingblock">
 <div class="content">
@@ -606,23 +737,23 @@ sudo rake install</tt></pre>
 </td>
 <td class="content">
 <div class="title">SSL Support</div>
-<div class="para"><p>To build with SSL support, use the following additional switch with the
+<div class="paragraph"><p>To build with SSL support, use the following additional switch with the
 <strong>sudo rake install</strong> command:</p></div>
 <div class="listingblock">
 <div class="content">
 <pre><tt>sudo rake install ssl=yes</tt></pre>
 </div></div>
-<div class="para"><p>Configure further SSL options in the server's admin panel
+<div class="paragraph"><p>Configure further SSL options in the server&#8217;s admin panel
         <strong>http://&lt;yourservername&gt;:&lt;port&gt;/admin-panel/configuration</strong></p></div>
-<div class="para"><p>After restarting the server, admin panel would now also be accessible over SSL.
+<div class="paragraph"><p>After restarting the server, admin panel would now also be accessible over SSL.
 <strong>https://&lt;yourservername&gt;:&lt;port&gt;/admin-panel</strong></p></div>
 </td>
 </tr></table>
 </div>
 <h4 id="_non_interactive_install_using_capistrano">3.2.3. Non-Interactive Install using Capistrano</h4>
-<div class="para"><p>You can use following Capistrano script to install the edge version on a
+<div class="paragraph"><p>You can use following Capistrano script to install the edge version on a
 remote machine</p></div>
-<div class="olist"><ol>
+<div class="olist arabic"><ol class="arabic">
 <li>
 <p>
 Create folder &lt;dir&gt;, move to &lt;dir&gt; folder using <strong>cd &lt;dir&gt;</strong>.
@@ -639,8 +770,7 @@ Replace the content of <strong>config/deploy.rb</strong> with the following scri
 </p>
 <div class="listingblock">
 <div class="content">
-<pre><tt>
-set :application, "WebROaR"
+<pre><tt>set :application, "WebROaR"
 set :repository,  "git://github.com/webroar/webroar.git"
 set :scm, :git
@@ -759,7 +889,7 @@ installed gems. (If you use Ubuntu, you might be able to relate to this point
 better.)</td>
 </tr></table>
 </div>
-<div class="ilist"><ul>
+<div class="ulist"><ul>
 <li>
 <p>
 In case auto-installation of dependent gems fails (due to some prehistoric
@@ -774,7 +904,7 @@ rubygems version or any other reason), you can install the following dependent
 <li>
 <p>
 After successful installation of the webroar gem, any errors that occur
-during the setup are saved to the install.log created in the installed gem's
+during the setup are saved to the install.log created in the installed gem&#8217;s
 directory. This can be used to troubleshoot the issues, if any.
 </p>
 </li>
@@ -786,9 +916,18 @@ 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 class="para"><p>The server's admin panel itself is a Ruby on Rails&#8482; web application, and by
-default uses sqlite as it's database. You can edit
+<h3 id="_know_issue">3.4. Know Issue</h3><div style="clear:left"></div>
+<div class="ulist"><ul>
+<li>
+<p>
+WebROaR with SSL build crashes on Ubuntu 10.04 upon execution of
+<strong>gnutls_handshake</strong> by secure connection.
+</p>
+</li>
+</ul></div>
+<h3 id="_setting_up_database_for_server_admin_panel">3.5. Setting up database for server admin panel</h3><div style="clear:left"></div>
+<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
 follow it up by running these commands from the <strong>admin_panel</strong> directory.</p></div>
 <div class="listingblock">
@@ -796,19 +935,19 @@ follow it up by running these commands from the <strong>admin_panel</strong> dir
 <pre><tt>rake db:create
 rake db:migrate</tt></pre>
 </div></div>
-<div class="para"><p><strong>admin_panel</strong> directory would be present under the server's rubygem
+<div class="paragraph"><p><strong>admin_panel</strong> directory would be present under the server&#8217;s rubygem
 directory.</p></div>
 </div>
 <h2 id="_usage">4. Usage</h2>
 <div class="sectionbody">
-<div class="para"><p>Start/Stop/Restart WebROaR:</p></div>
+<div class="paragraph"><p>Start/Stop/Restart WebROaR:</p></div>
 <div class="listingblock">
 <div class="content">
 <pre><tt>sudo webroar start
 sudo webroar stop
 sudo webroar restart</tt></pre>
 </div></div>
-<div class="para"><p>Start/Stop/Restart a deployed application:</p></div>
+<div class="paragraph"><p>Start/Stop/Restart a deployed application:</p></div>
 <div class="listingblock">
 <div class="content">
 <pre><tt>sudo webroar start &lt;Application Name&gt;
@@ -821,18 +960,18 @@ sudo webroar restart &lt;Application Name&gt;</tt></pre>
 <img src="./images/icons/note.png" alt="Note" />
 </td>
 <td class="content">
-<div class="para"><p>You can stop the admin panel application of the server any time, to conserve
+<div class="paragraph"><p>You can stop the admin panel application of the server any time, to conserve
 resources and ensure better security.</p></div>
 <div class="listingblock">
 <div class="content">
 <pre><tt>sudo webroar stop "Admin Panel"</tt></pre>
 </div></div>
-<div class="para"><p>To start it whenever you want, use the following command:</p></div>
+<div class="paragraph"><p>To start it whenever you want, use the following command:</p></div>
 <div class="listingblock">
 <div class="content">
 <pre><tt>sudo webroar start "Admin Panel"</tt></pre>
 </div></div>
-<div class="para"><p>Please note that analytics data and exceptions are still captured by the
+<div class="paragraph"><p>Please note that analytics data and exceptions are still captured by the
 server even when the admin panel is stopped.</p></div>
 </td>
 </tr></table>
@@ -841,10 +980,10 @@ server even when the admin panel is stopped.</p></div>
 <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="para"><p>If the server got installed successfully, you should be able access it's admin
+<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>
-<div class="para"><p>You can log in with the administrator account username and password that you
+<div class="paragraph"><p>You can log in with the administrator account username and password that you
 had entered during server installation. Deploy the ruby web application of
 your choice accessing the <strong>Configuration</strong> link of the admin panel.</p></div>
 <div class="admonitionblock">
@@ -857,15 +996,15 @@ 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 class="para"><p>WebROaR can be easily integrated with Capistrano using the following
+<div class="paragraph"><p>WebROaR can be easily integrated with Capistrano using the following
 instructions.</p></div>
-<div class="para"><p>After installing Capistrano, run the following command in your application's
+<div class="paragraph"><p>After installing Capistrano, run the following command in your application&#8217;s
 root directory:</p></div>
 <div class="listingblock">
 <div class="content">
 <pre><tt>capify .</tt></pre>
 </div></div>
-<div class="para"><p>It would create <strong>Capfile</strong> and <strong>config/deploy.rb</strong> files.
+<div class="paragraph"><p>It would create <strong>Capfile</strong> and <strong>config/deploy.rb</strong> files.
 Modify <strong>config/deploy.rb</strong> file as shown below:</p></div>
 <div class="listingblock">
 <div class="content">
@@ -931,23 +1070,23 @@ end
 after "deploy:update",  "deploy:restart"</tt></pre>
 </div></div>
-<div class="para"><p>Create the application directory structure by running setup command:</p></div>
+<div class="paragraph"><p>Create the application directory structure by running setup command:</p></div>
 <div class="listingblock">
 <div class="content">
 <pre><tt>cap deploy:setup</tt></pre>
 </div></div>
-<div class="para"><p>Deploy the application using command:</p></div>
+<div class="paragraph"><p>Deploy the application using command:</p></div>
 <div class="listingblock">
 <div class="content">
 <pre><tt>cap deploy</tt></pre>
 </div></div>
-<div class="para"><p>Add the application to WebROaR:</p></div>
+<div class="paragraph"><p>Add the application to WebROaR:</p></div>
 <div class="listingblock">
 <div class="content">
 <pre><tt>cap deploy:add</tt></pre>
 </div></div>
-<div class="para"><p>Please note that the application needs to be added to the server only once.</p></div>
-<div class="para"><p>You can use the following commands for starting/stopping/restarting the
+<div class="paragraph"><p>Please note that the application needs to be added to the server only once.</p></div>
+<div class="paragraph"><p>You can use the following commands for starting/stopping/restarting the
 application while upgrading it in the future:</p></div>
 <div class="listingblock">
 <div class="content">
@@ -956,9 +1095,9 @@ 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 class="para"><p>To deploy any Rack based application (other than Rails) the following are
-required in it's root directory:</p></div>
-<div class="ilist"><ul>
+<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>
 <li>
 <p>
 <strong>public</strong> folder containing static files like images and stylesheets
@@ -971,8 +1110,8 @@ contain the complete logic for initializing the application.
 </p>
 </li>
 </ul></div>
-<div class="para"><p>Here are some examples of the Rackup files:</p></div>
-<div class="para"><p><strong>Merb</strong></p></div>
+<div class="paragraph"><p>Here are some examples of the Rackup files:</p></div>
+<div class="paragraph"><p><strong>Merb</strong></p></div>
 <div class="listingblock">
 <div class="content">
 <pre><tt>  require 'rubygems'
@@ -985,7 +1124,7 @@ contain the complete logic for initializing the application.
   Merb::BootLoader.run
   run Merb::Rack::Application.new</tt></pre>
 </div></div>
-<div class="para"><p><strong>Sinatra</strong></p></div>
+<div class="paragraph"><p><strong>Sinatra</strong></p></div>
 <div class="listingblock">
 <div class="content">
 <pre><tt>  require 'rubygems'
@@ -995,32 +1134,32 @@ contain the complete logic for initializing the application.
   set :raise_errors, true
   run Sinatra::Application</tt></pre>
 </div></div>
-<div class="para"><p>You can use following environment variables in <strong>config.ru</strong> to access the few
+<div class="paragraph"><p>You can use following environment variables in <strong>config.ru</strong> to access the few
 application configuration parameters given at a time of application deployment
 in WebROaR.</p></div>
-<div class="ilist"><ul>
+<div class="ulist"><ul>
 <li>
 <p>
-ENV['APP_ROOT'] - To get the application root
+ENV['APP_ROOT\'] - To get the application root
 </p>
 </li>
 <li>
 <p>
-ENV['APP_ENV'] - To get the application environment
+ENV['APP_ENV\'] - To get the application environment
 </p>
 </li>
 <li>
 <p>
-ENV['APP_BASE_URI'] - To get the baseuri
+ENV['APP_BASE_URI\'] - To get the baseuri
 </p>
 </li>
 </ul></div>
 </div>
 <h2 id="_accessing_run_time_statistics">6. Accessing run time statistics</h2>
 <div class="sectionbody">
-<div class="para"><p>For those applications whose Analytics are <strong>Enabled</strong> in their configuration,
+<div class="paragraph"><p>For those applications whose Analytics are <strong>Enabled</strong> in their configuration,
 the following graphs are available under the <strong>Analytics</strong> link of the admin panel.</p></div>
-<div class="olist"><ol>
+<div class="olist arabic"><ol class="arabic">
 <li>
 <p>
 URL Breakdown
@@ -1072,7 +1211,7 @@ Physical Memory Utilization
 </p>
 </li>
 </ol></div>
-<div class="para"><p>Additionally, CPU and Physical Memory usage graphs for the entire server are
+<div class="paragraph"><p>Additionally, CPU and Physical Memory usage graphs for the entire server are
 also available.</p></div>
 <div class="admonitionblock">
 <table><tr>
@@ -1087,10 +1226,10 @@ about a minute for it’s data to show up in the graphs.</td>
 </div>
 <h2 id="_exception_tracking_and_notifications">7. Exception Tracking and Notifications</h2>
 <div class="sectionbody">
-<div class="para"><p>Any exceptions that occur in any of the deployed application are captured by
+<div class="paragraph"><p>Any exceptions that occur in any of the deployed application are captured by
 the server. An email notification is also sent out immediately with details of
 the exception, if the mail settings have been configured in the admin panel.</p></div>
-<div class="para"><p>All the exceptions can be seen under the <strong>Exceptions</strong> link of the server admin
+<div class="paragraph"><p>All the exceptions can be seen under the <strong>Exceptions</strong> link of the server admin
 panel.</p></div>
 <div class="admonitionblock">
 <table><tr>
@@ -1105,7 +1244,7 @@ after it has occurred.</td>
 </div>
 <h2 id="_uninstall">8. Uninstall</h2>
 <div class="sectionbody">
-<div class="para"><p>If you didn't like the server, use the following commands in sequence to
+<div class="paragraph"><p>If you didn&#8217;t like the server, use the following commands in sequence to
 uninstall it.</p></div>
 <div class="listingblock">
 <div class="content">
@@ -1115,16 +1254,16 @@ sudo gem uninstall webroar</tt></pre>
 </div>
 <h2 id="_test_suite">9. Test Suite</h2>
 <div class="sectionbody">
-<div class="para"><p>If you are a programmer and wish to play around with the server's code, you
-might like to use it's test suite to test the robustness of your changes.</p></div>
-<div class="para"><p>It can be run using the following command:</p></div>
+<div class="paragraph"><p>If you are a programmer and wish to play around with the server&#8217;s code, you
+might like to use it&#8217;s test suite to test the robustness of your changes.</p></div>
+<div class="paragraph"><p>It can be run using the following command:</p></div>
 <div class="listingblock">
 <div class="content">
 <pre><tt>sudo webroar test</tt></pre>
 </div></div>
-<div class="para"><p>We execute this suite on our nightly builds and it currently has the following
+<div class="paragraph"><p>We execute this suite on our nightly builds and it currently has the following
 tests:</p></div>
-<div class="ilist"><ul>
+<div class="ulist"><ul>
 <li>
 <p>
 Unit Tests
@@ -1369,9 +1508,11 @@ Build Tests
     Run the test suite</tt></pre>
 </div></div>
 </div>
+</div>
+<div id="footnotes"><hr /></div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2010-03-20 01:17:11 IST
+Last updated 2010-08-09 16:58:48 IST
 </div>
 </div>
 </body>