webroar 0.2.4 → 0.2.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- 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
|