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
-[ 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
-[ 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
- 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
- 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
- * 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
- * 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
- <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
- 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
- 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
- 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
-[ 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
- <em>* This requires additional software. Please read the users guide for
0
- information. Please visit our website for technical details and
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
-== Welcome, beta tester
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
-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
+Passenger probably requires no introduction. We kindly refer the reader to
0
+http://www.modrails.com/ for general information.
0
@@ -94,6 +9,11 @@ Run the following script as root:
0
./bin/passenger-install-apache2-module
0
-That's it. :) For troubleshooting, configuration and tips, please read the
0
-file 'doc/Users guide.html'.
0
+For troubleshooting, configuration and tips, please read the Users Guide:
0
+This file is included in the source tarball, may also be viewed online on our
Comments
No one has commented yet.