public
Description: Phusion Passenger (mod_rails)
Homepage: http://www.modrails.com/
Clone URL: git://github.com/FooBarWidget/passenger.git
Search Repo:
Click here to lend your support to: passenger and make a donation at www.pledgie.com !
Add more references to Users Guide. For some reason too many people 
overlook its existance.
Hongli Lai (Phusion) (author)
Fri Apr 04 03:43:01 -0700 2008
commit  0924ccfafd0a6f6cc509539cb3586f51ba8c7875
tree    5b0694be947a14f3e3001fb7ee8151f819578558
parent  24fac9b9d32918c24671031d25d05e8e7a0490d1
...
 
 
...
1
2
0
@@ -0,0 +1,2 @@
0
+Please read the file 'doc/Users guide.html' for installation instructions,
0
+configuration instructions and troubleshooting tips.
0
...
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
 
 
90
91
92
...
94
95
96
97
98
 
 
 
 
 
99
 
 
...
1
2
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
3
4
5
6
7
...
9
10
11
 
 
12
13
14
15
16
17
18
19
0
@@ -1,92 +1,7 @@
0
 == Introduction
0
 
0
-Passenger is an Apache module, which makes deploying Ruby on Rails applications
0
-on Apache a breeze. It follows the usual Ruby on Rails conventions, such as
0
-"Don't-Repeat-Yourself" and ease of setup. Passenger's key goals are:
0
-
0
-[ Ease of use (for the developer) ]
0
- Deploying a Rails application is as easy as uploading the files to the web
0
- server. The applications should _Just Work(tm)_ without any further manual
0
- configurations.
0
-
0
-[ Ease of installation ]
0
- It is possible to install Passenger in less than 3 minutes, with minimal
0
- reading of documentation. The system administrator should not have to edit
0
- 30 configuration files to get Passenger working.
0
-
0
-[ Stability ]
0
- We strive for the highest level of stability. Passenger should never crash,
0
- and should never leave Apache into an unusable state which requires a
0
- restart.
0
-
0
-[ Zero maintenance ]
0
- Software that is the easiest to maintain is software that doesn't have to be
0
- maintained. Just like a (train) passenger, who can step into a train and
0
- enjoy the trip, Passenger strives to allow the developer and system
0
- administrator to sit back, enjoy, and relax.
0
-
0
- * Ruby on Rails applications are started and stopped automatically based on
0
- site traffic. There should be no need to think about application server
0
- management.
0
- * Passenger makes no use of temporary files or sockets, so even after a hard
0
- system crash, the administrator does not have to manually clean up stale
0
- files. *
0
-
0
- <em>* This is only possible on Linux. On systems such as BSD, Passenger
0
- falls back to using temporary Unix sockets.</em>
0
- * If Passenger encounters an error, and it knows that it can be automatically
0
- recovered, then Passenger will do that. The administrator should not have
0
- to run server monitoring software to monitor Rails applications. Rails
0
- applications that crash are automatically restarted.
0
-
0
-[ Security ]
0
- We take security very seriously. We review our code for security issues to
0
- the best of our ability. Design- and implementation issues that have security
0
- implications are carefully documented, making it possible for third parties to
0
- review Passenger's security, in the true spirit in Open Source.
0
-
0
- A key security feature of Passenger is the ability to run different Ruby on
0
- Rails applications under different users, in an efficient manner. This is
0
- perfect for shared hosts. And in the line of ease of installation, this can
0
- be done automatically without any further need for configuration.
0
-
0
-[ Performance ]
0
- Performance is an important issue, so we strive for the highest possible
0
- performance. We use the performance of Mongrel, a popular Ruby on Rails
0
- application server, as our performance base line. We carefully consider every
0
- aspect of Passenger, and under no circumstances must Passenger perform
0
- significantly worse than Mongrel.
0
-
0
-[ Efficient resource usage ]
0
- Unlike other Ruby on Rails deployment systems, Passenger makes efficient use
0
- of memory when possible. Passenger allows different Ruby on Rails
0
- applications to share memory with each other, resulting in as much of 30%
0
- memory saving on average. *
0
-
0
- <em>* This requires additional software. Please read the users guide for
0
- information. Please visit our website for technical details and
0
- measurements.</em>
0
-
0
-[ Well-documented ]
0
- We know that documentation is of great importance to everybody. We put a
0
- great deal of effort into documenting Passenger, for system administrators
0
- who use Passenger, as well as developers who want to contribute to Passenger.
0
-
0
-
0
-== Welcome, beta tester
0
-
0
-Since Passenger hasn't been released yet, if you're reading this, then you must
0
-be a beta tester. :) We only ask of you not to give out this software to
0
-others. Even though it's going to be open source, we want the first release to
0
-leave a good - no, GREAT - impression. Leaking an unfinished beta will likely
0
-spoil peoples' first impression. Thank you for your understanding.
0
-
0
-We're pretty confident that the current version is pretty stable: we have lots
0
-of tests, and we've even tested the insertion of random errors, and so far we
0
-haven't been able to make it crash. But we're not done yet, and there is a lot
0
-more to test before we're confident enough that it can be released to the
0
-public.
0
-
0
+Passenger probably requires no introduction. We kindly refer the reader to
0
+http://www.modrails.com/ for general information.
0
 
0
 == Installation
0
 
0
@@ -94,6 +9,11 @@ Run the following script as root:
0
 
0
  ./bin/passenger-install-apache2-module
0
 
0
-That's it. :) For troubleshooting, configuration and tips, please read the
0
-file 'doc/Users guide.html'.
0
+That's it. :)
0
+
0
+For troubleshooting, configuration and tips, please read the Users Guide:
0
+
0
+ doc/Users guide.html
0
 
0
+This file is included in the source tarball, may also be viewed online on our
0
+website.
...
349
350
351
 
352
353
354
...
349
350
351
352
353
354
355
0
@@ -349,6 +349,7 @@ spec = Gem::Specification.new do |s|
0
     'README',
0
     'DEVELOPERS.TXT',
0
     'LICENSE',
0
+    'INSTALL',
0
     'lib/**/*.rb',
0
     'lib/passenger/templates/*',
0
     'bin/*',

Comments

    No one has commented yet.