webroar 0.2.4 → 0.2.5

Sign up to get free protection for your applications and to get access to all the features.
Files changed (39) hide show
  1. data/CHANGELOG +18 -1
  2. data/README +86 -0
  3. data/doc/user-guide.html +116 -74
  4. data/doc/user-guide.txt +3 -2
  5. data/lib/dependencies.rb +1 -1
  6. data/src/admin_panel/config/environment.rb +1 -1
  7. data/src/admin_panel/public/blank_iframe.html +2 -0
  8. data/src/admin_panel/public/images/calendar_date_select/calendar.gif +0 -0
  9. data/src/admin_panel/public/javascripts/calendar_date_select/calendar_date_select.js +443 -0
  10. data/src/admin_panel/public/javascripts/calendar_date_select/format_american.js +34 -0
  11. data/src/admin_panel/public/javascripts/calendar_date_select/format_db.js +27 -0
  12. data/src/admin_panel/public/javascripts/calendar_date_select/format_euro_24hr.js +7 -0
  13. data/src/admin_panel/public/javascripts/calendar_date_select/format_euro_24hr_ymd.js +7 -0
  14. data/src/admin_panel/public/javascripts/calendar_date_select/format_finnish.js +32 -0
  15. data/src/admin_panel/public/javascripts/calendar_date_select/format_hyphen_ampm.js +37 -0
  16. data/src/admin_panel/public/javascripts/calendar_date_select/format_iso_date.js +46 -0
  17. data/src/admin_panel/public/javascripts/calendar_date_select/format_italian.js +24 -0
  18. data/src/admin_panel/public/javascripts/calendar_date_select/locale/de.js +11 -0
  19. data/src/admin_panel/public/javascripts/calendar_date_select/locale/fi.js +10 -0
  20. data/src/admin_panel/public/javascripts/calendar_date_select/locale/fr.js +10 -0
  21. data/src/admin_panel/public/javascripts/calendar_date_select/locale/pl.js +10 -0
  22. data/src/admin_panel/public/javascripts/calendar_date_select/locale/pt.js +11 -0
  23. data/src/admin_panel/public/javascripts/calendar_date_select/locale/ru.js +10 -0
  24. data/src/admin_panel/public/stylesheets/calendar_date_select/blue.css +130 -0
  25. data/src/admin_panel/public/stylesheets/calendar_date_select/default.css +135 -0
  26. data/src/admin_panel/public/stylesheets/calendar_date_select/plain.css +128 -0
  27. data/src/admin_panel/public/stylesheets/calendar_date_select/red.css +135 -0
  28. data/src/admin_panel/public/stylesheets/calendar_date_select/silver.css +133 -0
  29. data/src/head/wr_config.h +1 -1
  30. data/src/ruby_lib/analyzer/db_connect.rb +3 -3
  31. data/src/ruby_lib/mailer/smtpmail.rb +3 -3
  32. data/src/ruby_lib/ruby_interface/version.rb +1 -1
  33. data/src/ruby_lib/webroar_app_loader.rb +62 -57
  34. data/src/worker/wkr_http.c +5 -137
  35. data/src/worker/wkr_main.c +2 -2
  36. data/tasks/gem.rake +4 -3
  37. data/tasks/test.rake +4 -2
  38. data/test/spec/test_app/config/environment.rb +1 -1
  39. metadata +33 -94
data/CHANGELOG CHANGED
@@ -1,3 +1,20 @@
1
+ v0.2.5 - 07-Dec-2009
2
+ --------------------
3
+
4
+ * Tested on Mac OS X v10.6 Snow Leopard & Ubuntu 9.10 (64-bit).
5
+ * Tested on Ruby Enterprise Edition 1.8.7-2009.10.
6
+ * Upgraded rack dependency version to >=1.0.1.
7
+ * Upgraded rails dependency version to >=2.3.5. Resolves Ticket #6.
8
+ * Redirected 'rake spec' output to STDOUT by default to indicate progress
9
+ of test execution.
10
+ * Implemented exception handling (that works both on ruby 1.8 & 1.9) for
11
+ handling errors raised in scripts being run by the embedded interpreter in
12
+ the worker.
13
+ * Redirected standard IO right after logger is initialized in worker.
14
+ * Handled absolute path for install dependencies. Resolves Ticket #3 -
15
+ 'Unable to locate gcc on Snow Leopard during installation'.
16
+
17
+
1
18
  v0.2.4 - 01-Dec-2009
2
19
  --------------------
3
20
 
@@ -15,7 +32,7 @@ it connects to head process.
15
32
  * Fixed invalid pointer being used in 'wr_req_resolve_http_req' function.
16
33
  * Fixed creation of rack.input stream object. Resolves Ticket #2 related to
17
34
  error seen on posting form with enctype="multipart/form-data".
18
- * Ensured 'starling-starling' gem is used by WebROaR even is 'starling' is
35
+ * Ensured 'starling-starling' gem is used by WebROaR even if 'starling' is
19
36
  present on the system.
20
37
 
21
38
  v0.2.3 - 25-Nov-2009
data/README ADDED
@@ -0,0 +1,86 @@
1
+ Introduction
2
+ -------------
3
+
4
+ WebROaR is an application server that makes deployments of ruby web
5
+ applications extremely simple. It provides an integrated solution to view
6
+ the run time performance numbers and email notifications in case any
7
+ exceptions occur in any of the deployed applications.
8
+
9
+ It is 5 to 55% faster than all other comparable deployment stacks for
10
+ Ruby on Rails applications.
11
+
12
+ Check out http://webroar.in and doc/user-guide.html for more details.
13
+
14
+ Key Features
15
+ ~~~~~~~~~~~~
16
+
17
+ * Maximum Performance.
18
+ * Simplified Deployment.
19
+ * Runs Ruby on Rails(TM) as well as other Rack compliant applications.
20
+ * Run Multiple Applications Simultaneously.
21
+ * Implements HTTP/1.1 grammar as per RFC 2616 including support for persistent,
22
+ and chunked requests.
23
+ * Intelligent load balancing and dynamic reaping of stuck ruby processing
24
+ instances.
25
+ * Provides run time performance data for the deployed applications.
26
+ * Generates notifications in case any exceptions occur in any of the deployed
27
+ applications.
28
+ * SSL support.
29
+
30
+ Supported Operating Systems
31
+ ---------------------------
32
+
33
+ WebROaR has been tested on Ubuntu 8.10/9.04/9.10, Debian 5 (64 Bit), Mac OS X
34
+ (v10.5 & v10.6) and Cent OS 5.2. Basically, it should be able to run on any
35
+ *IX OS.
36
+
37
+ Currently it does not support Microsoft(R) Windows.
38
+
39
+ Install
40
+ --------
41
+
42
+ Prerequisites
43
+ ~~~~~~~~~~~~~
44
+
45
+ - ruby 1.8.x or 1.9.x
46
+ - ruby 1.8-dev or 1.9-dev
47
+ - openssl ruby extension (On Ubuntu/Debian it is available as libopenssl-ruby1.X)
48
+ - zlib ruby extension
49
+ - rubygems
50
+ - C build tools (gcc etc) (e.g. build-essential on Ubuntu, Xcode on MacOS)
51
+ - libsqlite3
52
+ - libsqlite3-dev
53
+ - gnutls 2.4.1 or later (Only necessary in case SSL support is required)
54
+ - gnutls-dev 2.4.1 or later (Only necessary in case SSL support is required)
55
+
56
+ [NOTE]
57
+ .Ruby Shared Library
58
+ ===============================
59
+ The server needs the shared library - libruby.so to run the ruby web
60
+ applications.
61
+
62
+ If you are building ruby from source, please ensure you pass the flag
63
+ *--enable-shared* while executing its ./configure script.
64
+
65
+ ===============================
66
+
67
+ Procedure
68
+ ~~~~~~~~~
69
+
70
+ WebROaR can installed using the following commands:
71
+
72
+ ----
73
+ gem sources -a http://gems.github.com
74
+ sudo gem install webroar
75
+ sudo webroar install
76
+ ----
77
+
78
+ Or if you like living in the fast lane, you can install the edge version giving
79
+ the following commands:
80
+
81
+ ----
82
+ git clone git://github.com/webroar/webroar.git
83
+ cd webroar
84
+ sudo rake install
85
+ ----
86
+
data/doc/user-guide.html CHANGED
@@ -3,7 +3,8 @@
3
3
  <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
4
4
  <head>
5
5
  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
6
- <meta name="generator" content="AsciiDoc 8.2.7" />
6
+ <meta name="generator" content="AsciiDoc 8.4.4" />
7
+ <title>WebROaR User Guide</title>
7
8
  <style type="text/css">
8
9
  /* Debug borders */
9
10
  p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 {
@@ -110,11 +111,13 @@ div#footer-badges {
110
111
  padding-bottom: 0.5em;
111
112
  }
112
113
 
113
- div#preamble,
114
+ div#preamble {
115
+ margin-top: 1.5em;
116
+ margin-bottom: 1.5em;
117
+ }
114
118
  div.tableblock, div.imageblock, div.exampleblock, div.verseblock,
115
119
  div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
116
120
  div.admonitionblock {
117
- margin-right: 10%;
118
121
  margin-top: 1.5em;
119
122
  margin-bottom: 1.5em;
120
123
  }
@@ -156,9 +159,6 @@ div.sidebarblock > div.content {
156
159
  padding: 0.5em;
157
160
  }
158
161
 
159
- div.listingblock {
160
- margin-right: 0%;
161
- }
162
162
  div.listingblock > div.content {
163
163
  border: 1px solid silver;
164
164
  background: #f4f4f4;
@@ -167,6 +167,7 @@ div.listingblock > div.content {
167
167
 
168
168
  div.quoteblock {
169
169
  padding-left: 2.0em;
170
+ margin-right: 10%;
170
171
  }
171
172
  div.quoteblock > div.attribution {
172
173
  padding-top: 0.5em;
@@ -175,6 +176,7 @@ div.quoteblock > div.attribution {
175
176
 
176
177
  div.verseblock {
177
178
  padding-left: 2.0em;
179
+ margin-right: 10%;
178
180
  }
179
181
  div.verseblock > div.content {
180
182
  white-space: pre;
@@ -218,6 +220,7 @@ dt {
218
220
  margin-top: 0.5em;
219
221
  margin-bottom: 0;
220
222
  font-style: normal;
223
+ color: navy;
221
224
  }
222
225
  dd > *:first-child {
223
226
  margin-top: 0.1em;
@@ -226,12 +229,28 @@ dd > *:first-child {
226
229
  ul, ol {
227
230
  list-style-position: outside;
228
231
  }
229
- div.olist > ol {
232
+ ol.arabic {
230
233
  list-style-type: decimal;
231
234
  }
232
- div.olist2 > ol {
235
+ ol.loweralpha {
233
236
  list-style-type: lower-alpha;
234
237
  }
238
+ ol.upperalpha {
239
+ list-style-type: upper-alpha;
240
+ }
241
+ ol.lowerroman {
242
+ list-style-type: lower-roman;
243
+ }
244
+ ol.upperroman {
245
+ list-style-type: upper-roman;
246
+ }
247
+
248
+ div.compact ul, div.compact ol,
249
+ div.compact p, div.compact p,
250
+ div.compact div, div.compact div {
251
+ margin-top: 0.1em;
252
+ margin-bottom: 0.1em;
253
+ }
235
254
 
236
255
  div.tableblock > table {
237
256
  border: 3px solid #527bbd;
@@ -243,22 +262,53 @@ thead {
243
262
  tfoot {
244
263
  font-weight: bold;
245
264
  }
265
+ td > div.verse {
266
+ white-space: pre;
267
+ }
268
+ p.table {
269
+ margin-top: 0;
270
+ }
271
+ /* Because the table frame attribute is overriden by CSS in most browsers. */
272
+ div.tableblock > table[frame="void"] {
273
+ border-style: none;
274
+ }
275
+ div.tableblock > table[frame="hsides"] {
276
+ border-left-style: none;
277
+ border-right-style: none;
278
+ }
279
+ div.tableblock > table[frame="vsides"] {
280
+ border-top-style: none;
281
+ border-bottom-style: none;
282
+ }
283
+
246
284
 
247
- div.hlist {
285
+ div.hdlist {
248
286
  margin-top: 0.8em;
249
287
  margin-bottom: 0.8em;
250
288
  }
251
- div.hlist td {
289
+ div.hdlist tr {
252
290
  padding-bottom: 15px;
253
291
  }
254
- td.hlist1 {
292
+ dt.hdlist1.strong, td.hdlist1.strong {
293
+ font-weight: bold;
294
+ }
295
+ td.hdlist1 {
255
296
  vertical-align: top;
256
297
  font-style: normal;
257
298
  padding-right: 0.8em;
299
+ color: navy;
258
300
  }
259
- td.hlist2 {
301
+ td.hdlist2 {
260
302
  vertical-align: top;
261
303
  }
304
+ div.hdlist.compact tr {
305
+ margin: 0;
306
+ padding-bottom: 0;
307
+ }
308
+
309
+ .comment {
310
+ background: yellow;
311
+ }
262
312
 
263
313
  @media print {
264
314
  div#footer-badges { display: none; }
@@ -330,14 +380,6 @@ div.exampleblock-content {
330
380
 
331
381
  /* IE6 sets dynamically generated links as visited. */
332
382
  div#toc a:visited { color: blue; }
333
-
334
- /* Because IE6 child selector is broken. */
335
- div.olist2 ol {
336
- list-style-type: lower-alpha;
337
- }
338
- div.olist2 div.olist ol {
339
- list-style-type: decimal;
340
- }
341
383
  </style>
342
384
  <script type="text/javascript">
343
385
  /*<![CDATA[*/
@@ -413,7 +455,6 @@ function generateToc(toclevels) {
413
455
  }
414
456
  /*]]>*/
415
457
  </script>
416
- <title>WebROaR User Guide</title>
417
458
  </head>
418
459
  <body>
419
460
  <div id="header">
@@ -425,14 +466,14 @@ function generateToc(toclevels) {
425
466
  </div>
426
467
  <h2 id="_introduction">1. Introduction</h2>
427
468
  <div class="sectionbody">
428
- <div class="para"><p><a href="http://webroar.in">WebROaR</a> is an application server that makes deployments of ruby web
469
+ <div class="paragraph"><p><a href="http://webroar.in">WebROaR</a> is an application server that makes deployments of ruby web
429
470
  applications extremely simple. It provides an integrated solution to view
430
471
  the run time performance numbers and sends email notifications in case any
431
472
  exceptions occur in any of the deployed applications.</p></div>
432
- <div class="para"><p>It is 5 to 55% faster than all other comparable deployment stacks for
473
+ <div class="paragraph"><p>It is 5 to 55% faster than all other comparable deployment stacks for
433
474
  Ruby on Rails applications.</p></div>
434
475
  <h3 id="_key_features">1.1. Key Features</h3><div style="clear:left"></div>
435
- <div class="ilist"><ul>
476
+ <div class="ulist"><ul>
436
477
  <li>
437
478
  <p>
438
479
  Maximum Performance.
@@ -485,14 +526,15 @@ SSL support.
485
526
  </div>
486
527
  <h2 id="_supported_operating_systems">2. Supported Operating Systems</h2>
487
528
  <div class="sectionbody">
488
- <div class="para"><p>WebROaR has been tested on Ubuntu 8.1/9.04, Debian 5 (64 Bit), Mac OS X (10.5)
489
- and Cent OS 5.2. Basically, it should be able to run on any *IX OS.</p></div>
490
- <div class="para"><p>Currently it does not support Microsoft&#174; Windows.</p></div>
529
+ <div class="paragraph"><p>WebROaR has been tested on Ubuntu 8.10/9.04/9.10, Debian 5 (64 Bit), Mac OS X
530
+ (v10.5 &amp; v10.6) and Cent OS 5.2. Basically, it should be able to run on any
531
+ *IX OS.</p></div>
532
+ <div class="paragraph"><p>Currently it does not support Microsoft&#174; Windows.</p></div>
491
533
  </div>
492
534
  <h2 id="_install">3. Install</h2>
493
535
  <div class="sectionbody">
494
536
  <h3 id="_prerequisites">3.1. Prerequisites</h3><div style="clear:left"></div>
495
- <div class="ilist"><ul>
537
+ <div class="ulist"><ul>
496
538
  <li>
497
539
  <p>
498
540
  ruby 1.8.x or 1.9.x
@@ -551,15 +593,15 @@ gnutls-dev 2.4.1 or later (Only necessary in case SSL support is required)
551
593
  </td>
552
594
  <td class="content">
553
595
  <div class="title">Ruby Shared Library</div>
554
- <div class="para"><p>The server needs the shared library - libruby.so to run the ruby web
596
+ <div class="paragraph"><p>The server needs the shared library - libruby.so to run the ruby web
555
597
  applications.</p></div>
556
- <div class="para"><p>If you are building ruby from source, please ensure you pass the flag
557
- <strong>&#8212;enable-shared</strong> while executing its ./configure script.</p></div>
598
+ <div class="paragraph"><p>If you are building ruby from source, please ensure you pass the flag
599
+ <strong>--enable-shared</strong> while executing its ./configure script.</p></div>
558
600
  </td>
559
601
  </tr></table>
560
602
  </div>
561
603
  <h3 id="_procedure">3.2. Procedure</h3><div style="clear:left"></div>
562
- <div class="para"><p>WebROaR can installed using the following commands:</p></div>
604
+ <div class="paragraph"><p>WebROaR can installed using the following commands:</p></div>
563
605
  <div class="listingblock">
564
606
  <div class="content">
565
607
  <pre><tt>gem sources -a http://gems.github.com
@@ -573,20 +615,20 @@ sudo webroar install</tt></pre>
573
615
  </td>
574
616
  <td class="content">
575
617
  <div class="title">SSL Support</div>
576
- <div class="para"><p>In case you would like to setup SSL support for the server, use the following
618
+ <div class="paragraph"><p>In case you would like to setup SSL support for the server, use the following
577
619
  command line switch with <strong>sudo webroar install</strong> command mentioned above.</p></div>
578
620
  <div class="listingblock">
579
621
  <div class="content">
580
622
  <pre><tt>sudo webroar install --ssl-support</tt></pre>
581
623
  </div></div>
582
- <div class="para"><p>Configure further SSL options in the server's admin panel
624
+ <div class="paragraph"><p>Configure further SSL options in the server&#8217;s admin panel
583
625
  <strong>http://&lt;yourservername&gt;:&lt;port&gt;/admin-panel/configuration</strong></p></div>
584
- <div class="para"><p>After restarting the server, admin panel would now also be accessible over SSL.
626
+ <div class="paragraph"><p>After restarting the server, admin panel would now also be accessible over SSL.
585
627
  <strong>https://&lt;yourservername&gt;:&lt;port&gt;/admin-panel</strong></p></div>
586
628
  </td>
587
629
  </tr></table>
588
630
  </div>
589
- <div class="para"><p>Or if you like living in the fast lane, you can install the edge version giving
631
+ <div class="paragraph"><p>Or if you like living in the fast lane, you can install the edge version giving
590
632
  the following commands:</p></div>
591
633
  <div class="listingblock">
592
634
  <div class="content">
@@ -601,15 +643,15 @@ sudo rake install</tt></pre>
601
643
  </td>
602
644
  <td class="content">
603
645
  <div class="title">SSL Support</div>
604
- <div class="para"><p>To build with SSL support, use the following additional switch with the
646
+ <div class="paragraph"><p>To build with SSL support, use the following additional switch with the
605
647
  <strong>sudo rake install</strong> command:</p></div>
606
648
  <div class="listingblock">
607
649
  <div class="content">
608
650
  <pre><tt>sudo rake install ssl=yes</tt></pre>
609
651
  </div></div>
610
- <div class="para"><p>Configure further SSL options in the server's admin panel
652
+ <div class="paragraph"><p>Configure further SSL options in the server&#8217;s admin panel
611
653
  <strong>http://&lt;yourservername&gt;:&lt;port&gt;/admin-panel/configuration</strong></p></div>
612
- <div class="para"><p>After restarting the server, admin panel would now also be accessible over SSL.
654
+ <div class="paragraph"><p>After restarting the server, admin panel would now also be accessible over SSL.
613
655
  <strong>https://&lt;yourservername&gt;:&lt;port&gt;/admin-panel</strong></p></div>
614
656
  </td>
615
657
  </tr></table>
@@ -626,7 +668,7 @@ installed gems. (If you use Ubuntu, you might be able to relate to this point
626
668
  better.)</td>
627
669
  </tr></table>
628
670
  </div>
629
- <div class="ilist"><ul>
671
+ <div class="ulist"><ul>
630
672
  <li>
631
673
  <p>
632
674
  In case auto-installation of dependent gems fails (due to some prehistoric
@@ -641,7 +683,7 @@ rubygems version or any other reason), you can install the following dependent
641
683
  <li>
642
684
  <p>
643
685
  After successful installation of the webroar gem, any errors that occur
644
- during the setup are saved to the install.log created in the installed gem's
686
+ during the setup are saved to the install.log created in the installed gem&#8217;s
645
687
  directory. This can be used to troubleshoot the issues, if any.
646
688
  </p>
647
689
  </li>
@@ -654,8 +696,8 @@ dump file would be created in /tmp if <em>gcore</em> is available on that machin
654
696
  </li>
655
697
  </ul></div>
656
698
  <h3 id="_setting_up_database_for_server_admin_panel">3.4. Setting up database for server admin panel</h3><div style="clear:left"></div>
657
- <div class="para"><p>The server's admin panel itself is a Ruby on Rails&#8482; web application, and by
658
- default uses sqlite as it's database. You can edit
699
+ <div class="paragraph"><p>The server&#8217;s admin panel itself is a Ruby on Rails&#8482; web application, and by
700
+ default uses sqlite as it&#8217;s database. You can edit
659
701
  <strong>admin_panel/config/database.yml</strong> to setup a database of your liking and
660
702
  follow it up by running these commands from the <strong>admin_panel</strong> directory.</p></div>
661
703
  <div class="listingblock">
@@ -663,19 +705,19 @@ follow it up by running these commands from the <strong>admin_panel</strong> dir
663
705
  <pre><tt>rake db:create
664
706
  rake db:migrate</tt></pre>
665
707
  </div></div>
666
- <div class="para"><p><strong>admin_panel</strong> directory would be present under the server's rubygem
708
+ <div class="paragraph"><p><strong>admin_panel</strong> directory would be present under the server&#8217;s rubygem
667
709
  directory.</p></div>
668
710
  </div>
669
711
  <h2 id="_usage">4. Usage</h2>
670
712
  <div class="sectionbody">
671
- <div class="para"><p>Start/Stop/Restart WebROaR:</p></div>
713
+ <div class="paragraph"><p>Start/Stop/Restart WebROaR:</p></div>
672
714
  <div class="listingblock">
673
715
  <div class="content">
674
716
  <pre><tt>sudo webroar start
675
717
  sudo webroar stop
676
718
  sudo webroar restart</tt></pre>
677
719
  </div></div>
678
- <div class="para"><p>Start/Stop/Restart a deployed application:</p></div>
720
+ <div class="paragraph"><p>Start/Stop/Restart a deployed application:</p></div>
679
721
  <div class="listingblock">
680
722
  <div class="content">
681
723
  <pre><tt>sudo webroar start &lt;Application Name&gt;
@@ -688,18 +730,18 @@ sudo webroar restart &lt;Application Name&gt;</tt></pre>
688
730
  <img src="./images/icons/note.png" alt="Note" />
689
731
  </td>
690
732
  <td class="content">
691
- <div class="para"><p>You can stop the admin panel application of the server any time, to conserve
733
+ <div class="paragraph"><p>You can stop the admin panel application of the server any time, to conserve
692
734
  resources and ensure better security.</p></div>
693
735
  <div class="listingblock">
694
736
  <div class="content">
695
737
  <pre><tt>sudo webroar stop "Admin Panel"</tt></pre>
696
738
  </div></div>
697
- <div class="para"><p>To start it whenever you want, use the following command:</p></div>
739
+ <div class="paragraph"><p>To start it whenever you want, use the following command:</p></div>
698
740
  <div class="listingblock">
699
741
  <div class="content">
700
742
  <pre><tt>sudo webroar start "Admin Panel"</tt></pre>
701
743
  </div></div>
702
- <div class="para"><p>Please note that analytics data and exceptions are still captured by the
744
+ <div class="paragraph"><p>Please note that analytics data and exceptions are still captured by the
703
745
  server even when the admin panel is stopped.</p></div>
704
746
  </td>
705
747
  </tr></table>
@@ -707,10 +749,10 @@ server even when the admin panel is stopped.</p></div>
707
749
  </div>
708
750
  <h2 id="_deploying_applications">5. Deploying applications</h2>
709
751
  <div class="sectionbody">
710
- <div class="para"><p>If the server got installed successfully, you should be able access it's admin
752
+ <div class="paragraph"><p>If the server got installed successfully, you should be able access it&#8217;s admin
711
753
  panel using the link:<br />
712
754
  <strong>http://&lt;yourservername&gt;:&lt;port&gt;/admin-panel</strong></p></div>
713
- <div class="para"><p>You can log in with the administrator account username and password that you
755
+ <div class="paragraph"><p>You can log in with the administrator account username and password that you
714
756
  had entered during server installation. Deploy the ruby web application of
715
757
  your choice accessing the <strong>Configuration</strong> link of the admin panel.</p></div>
716
758
  <div class="admonitionblock">
@@ -723,9 +765,9 @@ The application starts up automatically after deployment.</td>
723
765
  </tr></table>
724
766
  </div>
725
767
  <h3 id="_rack_applications_other_than_rails">5.1. Rack applications (other than Rails)</h3><div style="clear:left"></div>
726
- <div class="para"><p>To deploy any Rack based application (other than Rails) the following are
727
- required in it's root directory:</p></div>
728
- <div class="ilist"><ul>
768
+ <div class="paragraph"><p>To deploy any Rack based application (other than Rails) the following are
769
+ required in it&#8217;s root directory:</p></div>
770
+ <div class="ulist"><ul>
729
771
  <li>
730
772
  <p>
731
773
  <strong>public</strong> folder containing static files like images and stylesheets
@@ -738,8 +780,8 @@ contain the complete logic for initializing the application.
738
780
  </p>
739
781
  </li>
740
782
  </ul></div>
741
- <div class="para"><p>Here are some examples of the Rackup files:</p></div>
742
- <div class="para"><p><strong>Merb</strong></p></div>
783
+ <div class="paragraph"><p>Here are some examples of the Rackup files:</p></div>
784
+ <div class="paragraph"><p><strong>Merb</strong></p></div>
743
785
  <div class="listingblock">
744
786
  <div class="content">
745
787
  <pre><tt> require 'rubygems'
@@ -752,7 +794,7 @@ contain the complete logic for initializing the application.
752
794
  Merb::BootLoader.run
753
795
  run Merb::Rack::Application.new</tt></pre>
754
796
  </div></div>
755
- <div class="para"><p><strong>Sinatra</strong></p></div>
797
+ <div class="paragraph"><p><strong>Sinatra</strong></p></div>
756
798
  <div class="listingblock">
757
799
  <div class="content">
758
800
  <pre><tt> require 'rubygems'
@@ -762,32 +804,32 @@ contain the complete logic for initializing the application.
762
804
  set :raise_errors, true
763
805
  run Sinatra::Application</tt></pre>
764
806
  </div></div>
765
- <div class="para"><p>You can use following environment variables in <strong>config.ru</strong> to access the few
807
+ <div class="paragraph"><p>You can use following environment variables in <strong>config.ru</strong> to access the few
766
808
  application configuration parameters given at a time of application deployment
767
809
  in WebROaR.</p></div>
768
- <div class="ilist"><ul>
810
+ <div class="ulist"><ul>
769
811
  <li>
770
812
  <p>
771
- ENV['APP_ROOT'] - To get the application root
813
+ ENV['APP_ROOT\'] - To get the application root
772
814
  </p>
773
815
  </li>
774
816
  <li>
775
817
  <p>
776
- ENV['APP_ENV'] - To get the application environment
818
+ ENV['APP_ENV\'] - To get the application environment
777
819
  </p>
778
820
  </li>
779
821
  <li>
780
822
  <p>
781
- ENV['APP_BASE_URI'] - To get the baseuri
823
+ ENV['APP_BASE_URI\'] - To get the baseuri
782
824
  </p>
783
825
  </li>
784
826
  </ul></div>
785
827
  </div>
786
828
  <h2 id="_accessing_run_time_statistics">6. Accessing run time statistics</h2>
787
829
  <div class="sectionbody">
788
- <div class="para"><p>For those applications whose Analytics are <strong>Enabled</strong> in their configuration,
830
+ <div class="paragraph"><p>For those applications whose Analytics are <strong>Enabled</strong> in their configuration,
789
831
  the following graphs are available under the <strong>Analytics</strong> link of the admin panel.</p></div>
790
- <div class="olist"><ol>
832
+ <div class="olist arabic"><ol class="arabic">
791
833
  <li>
792
834
  <p>
793
835
  URL Breakdown
@@ -839,7 +881,7 @@ Physical Memory Utilization
839
881
  </p>
840
882
  </li>
841
883
  </ol></div>
842
- <div class="para"><p>Additionally, CPU and Physical Memory usage graphs for the entire server are
884
+ <div class="paragraph"><p>Additionally, CPU and Physical Memory usage graphs for the entire server are
843
885
  also available.</p></div>
844
886
  <div class="admonitionblock">
845
887
  <table><tr>
@@ -854,10 +896,10 @@ about a minute for it’s data to show up in the graphs.</td>
854
896
  </div>
855
897
  <h2 id="_exception_tracking_and_notifications">7. Exception Tracking and Notifications</h2>
856
898
  <div class="sectionbody">
857
- <div class="para"><p>Any exceptions that occur in any of the deployed application are captured by
899
+ <div class="paragraph"><p>Any exceptions that occur in any of the deployed application are captured by
858
900
  the server. An email notification is also sent out immediately with details of
859
901
  the exception, if the mail settings have been configured in the admin panel.</p></div>
860
- <div class="para"><p>All the exceptions can be seen under the <strong>Exceptions</strong> link of the server admin
902
+ <div class="paragraph"><p>All the exceptions can be seen under the <strong>Exceptions</strong> link of the server admin
861
903
  panel.</p></div>
862
904
  <div class="admonitionblock">
863
905
  <table><tr>
@@ -872,7 +914,7 @@ after it has occurred.</td>
872
914
  </div>
873
915
  <h2 id="_uninstall">8. Uninstall</h2>
874
916
  <div class="sectionbody">
875
- <div class="para"><p>If you didn't like the server, use the following commands in sequence to uninstall it.</p></div>
917
+ <div class="paragraph"><p>If you didn&#8217;t like the server, use the following commands in sequence to uninstall it.</p></div>
876
918
  <div class="listingblock">
877
919
  <div class="content">
878
920
  <pre><tt>sudo webroar uninstall
@@ -881,16 +923,16 @@ sudo gem uninstall webroar</tt></pre>
881
923
  </div>
882
924
  <h2 id="_test_suite">9. Test Suite</h2>
883
925
  <div class="sectionbody">
884
- <div class="para"><p>If you are a programmer and wish to play around with the server's code, you
885
- might like to use it's test suite to test the robustness of your changes.</p></div>
886
- <div class="para"><p>It can be run using the following command:</p></div>
926
+ <div class="paragraph"><p>If you are a programmer and wish to play around with the server&#8217;s code, you
927
+ might like to use it&#8217;s test suite to test the robustness of your changes.</p></div>
928
+ <div class="paragraph"><p>It can be run using the following command:</p></div>
887
929
  <div class="listingblock">
888
930
  <div class="content">
889
931
  <pre><tt>sudo webroar test</tt></pre>
890
932
  </div></div>
891
- <div class="para"><p>We execute this suite on our nightly builds and it currently has the following
933
+ <div class="paragraph"><p>We execute this suite on our nightly builds and it currently has the following
892
934
  tests:</p></div>
893
- <div class="ilist"><ul>
935
+ <div class="ulist"><ul>
894
936
  <li>
895
937
  <p>
896
938
  Unit Tests
@@ -925,7 +967,7 @@ Build Tests
925
967
  </div>
926
968
  <div id="footer">
927
969
  <div id="footer-text">
928
- Last updated 2009-11-20 22:16:52 IST
970
+ Last updated 2009-12-07 17:56:58 IST
929
971
  </div>
930
972
  </div>
931
973
  </body>
data/doc/user-guide.txt CHANGED
@@ -31,8 +31,9 @@ Key Features
31
31
  Supported Operating Systems
32
32
  ---------------------------
33
33
 
34
- WebROaR has been tested on Ubuntu 8.1/9.04, Debian 5 (64 Bit), Mac OS X (10.5)
35
- and Cent OS 5.2. Basically, it should be able to run on any *IX OS.
34
+ WebROaR has been tested on Ubuntu 8.10/9.04/9.10, Debian 5 (64 Bit), Mac OS X
35
+ (v10.5 & v10.6) and Cent OS 5.2. Basically, it should be able to run on any
36
+ *IX OS.
36
37
 
37
38
  Currently it does not support Microsoft(R) Windows.
38
39
 
data/lib/dependencies.rb CHANGED
@@ -71,7 +71,7 @@ module Webroar
71
71
 
72
72
  def find_command(name)
73
73
  ENV['PATH'].split(File::PATH_SEPARATOR).detect do |directory|
74
- path = File.join(directory, name)
74
+ path = File.join(directory, File.basename(name))
75
75
  if File.executable?(path)
76
76
  flag="\e[32mfound\e[0m at #{path}."
77
77
  return flag
@@ -5,7 +5,7 @@
5
5
  # ENV['RAILS_ENV'] ||= 'production'
6
6
 
7
7
  # Specifies gem version of Rails to use when vendor/rails is not present
8
- RAILS_GEM_VERSION = '2.3.2' unless defined? RAILS_GEM_VERSION
8
+ #RAILS_GEM_VERSION = '2.3.5' unless defined? RAILS_GEM_VERSION
9
9
 
10
10
  # Bootstrap the Rails environment, frameworks, and default configuration
11
11
  require File.join(File.dirname(__FILE__), 'boot')
@@ -0,0 +1,2 @@
1
+ <!-- Nothing here; part of the calendar_date_select plugin -->
2
+ <html><head></head><body></body></html>