webroar 0.2.4 → 0.2.5
Sign up to get free protection for your applications and to get access to all the features.
- data/CHANGELOG +18 -1
- data/README +86 -0
- data/doc/user-guide.html +116 -74
- data/doc/user-guide.txt +3 -2
- data/lib/dependencies.rb +1 -1
- data/src/admin_panel/config/environment.rb +1 -1
- data/src/admin_panel/public/blank_iframe.html +2 -0
- data/src/admin_panel/public/images/calendar_date_select/calendar.gif +0 -0
- data/src/admin_panel/public/javascripts/calendar_date_select/calendar_date_select.js +443 -0
- data/src/admin_panel/public/javascripts/calendar_date_select/format_american.js +34 -0
- data/src/admin_panel/public/javascripts/calendar_date_select/format_db.js +27 -0
- data/src/admin_panel/public/javascripts/calendar_date_select/format_euro_24hr.js +7 -0
- data/src/admin_panel/public/javascripts/calendar_date_select/format_euro_24hr_ymd.js +7 -0
- data/src/admin_panel/public/javascripts/calendar_date_select/format_finnish.js +32 -0
- data/src/admin_panel/public/javascripts/calendar_date_select/format_hyphen_ampm.js +37 -0
- data/src/admin_panel/public/javascripts/calendar_date_select/format_iso_date.js +46 -0
- data/src/admin_panel/public/javascripts/calendar_date_select/format_italian.js +24 -0
- data/src/admin_panel/public/javascripts/calendar_date_select/locale/de.js +11 -0
- data/src/admin_panel/public/javascripts/calendar_date_select/locale/fi.js +10 -0
- data/src/admin_panel/public/javascripts/calendar_date_select/locale/fr.js +10 -0
- data/src/admin_panel/public/javascripts/calendar_date_select/locale/pl.js +10 -0
- data/src/admin_panel/public/javascripts/calendar_date_select/locale/pt.js +11 -0
- data/src/admin_panel/public/javascripts/calendar_date_select/locale/ru.js +10 -0
- data/src/admin_panel/public/stylesheets/calendar_date_select/blue.css +130 -0
- data/src/admin_panel/public/stylesheets/calendar_date_select/default.css +135 -0
- data/src/admin_panel/public/stylesheets/calendar_date_select/plain.css +128 -0
- data/src/admin_panel/public/stylesheets/calendar_date_select/red.css +135 -0
- data/src/admin_panel/public/stylesheets/calendar_date_select/silver.css +133 -0
- data/src/head/wr_config.h +1 -1
- data/src/ruby_lib/analyzer/db_connect.rb +3 -3
- data/src/ruby_lib/mailer/smtpmail.rb +3 -3
- data/src/ruby_lib/ruby_interface/version.rb +1 -1
- data/src/ruby_lib/webroar_app_loader.rb +62 -57
- data/src/worker/wkr_http.c +5 -137
- data/src/worker/wkr_main.c +2 -2
- data/tasks/gem.rake +4 -3
- data/tasks/test.rake +4 -2
- data/test/spec/test_app/config/environment.rb +1 -1
- 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
|
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.
|
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
|
-
|
232
|
+
ol.arabic {
|
230
233
|
list-style-type: decimal;
|
231
234
|
}
|
232
|
-
|
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.
|
285
|
+
div.hdlist {
|
248
286
|
margin-top: 0.8em;
|
249
287
|
margin-bottom: 0.8em;
|
250
288
|
}
|
251
|
-
div.
|
289
|
+
div.hdlist tr {
|
252
290
|
padding-bottom: 15px;
|
253
291
|
}
|
254
|
-
td.
|
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.
|
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="
|
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="
|
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="
|
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="
|
489
|
-
and Cent OS 5.2. Basically, it should be able to run on any
|
490
|
-
|
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 & 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® 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="
|
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="
|
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="
|
557
|
-
<strong
|
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="
|
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="
|
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="
|
624
|
+
<div class="paragraph"><p>Configure further SSL options in the server’s admin panel
|
583
625
|
<strong>http://<yourservername>:<port>/admin-panel/configuration</strong></p></div>
|
584
|
-
<div class="
|
626
|
+
<div class="paragraph"><p>After restarting the server, admin panel would now also be accessible over SSL.
|
585
627
|
<strong>https://<yourservername>:<port>/admin-panel</strong></p></div>
|
586
628
|
</td>
|
587
629
|
</tr></table>
|
588
630
|
</div>
|
589
|
-
<div class="
|
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="
|
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="
|
652
|
+
<div class="paragraph"><p>Configure further SSL options in the server’s admin panel
|
611
653
|
<strong>http://<yourservername>:<port>/admin-panel/configuration</strong></p></div>
|
612
|
-
<div class="
|
654
|
+
<div class="paragraph"><p>After restarting the server, admin panel would now also be accessible over SSL.
|
613
655
|
<strong>https://<yourservername>:<port>/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="
|
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
|
686
|
+
during the setup are saved to the install.log created in the installed gem’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="
|
658
|
-
default uses sqlite as it
|
699
|
+
<div class="paragraph"><p>The server’s admin panel itself is a Ruby on Rails™ web application, and by
|
700
|
+
default uses sqlite as it’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="
|
708
|
+
<div class="paragraph"><p><strong>admin_panel</strong> directory would be present under the server’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="
|
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="
|
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 <Application Name>
|
@@ -688,18 +730,18 @@ sudo webroar restart <Application Name></tt></pre>
|
|
688
730
|
<img src="./images/icons/note.png" alt="Note" />
|
689
731
|
</td>
|
690
732
|
<td class="content">
|
691
|
-
<div class="
|
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="
|
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="
|
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="
|
752
|
+
<div class="paragraph"><p>If the server got installed successfully, you should be able access it’s admin
|
711
753
|
panel using the link:<br />
|
712
754
|
<strong>http://<yourservername>:<port>/admin-panel</strong></p></div>
|
713
|
-
<div class="
|
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="
|
727
|
-
required in it
|
728
|
-
<div class="
|
768
|
+
<div class="paragraph"><p>To deploy any Rack based application (other than Rails) the following are
|
769
|
+
required in it’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="
|
742
|
-
<div class="
|
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="
|
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="
|
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="
|
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="
|
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="
|
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="
|
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="
|
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="
|
917
|
+
<div class="paragraph"><p>If you didn’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="
|
885
|
-
might like to use it
|
886
|
-
<div class="
|
926
|
+
<div class="paragraph"><p>If you are a programmer and wish to play around with the server’s code, you
|
927
|
+
might like to use it’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="
|
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="
|
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-
|
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.
|
35
|
-
and Cent OS 5.2. Basically, it should be able to run on any
|
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.
|
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')
|
Binary file
|