mirror of
https://github.com/puma/puma.git
synced 2022-11-09 13:48:40 -05:00
Updated README with latest information and referred to mongrel site.
git-svn-id: svn+ssh://rubyforge.org/var/svn/mongrel/trunk@420 19e92222-5c0b-0410-8929-a290d50e31e9
This commit is contained in:
parent
2039a4c560
commit
ec6bd6c040
1 changed files with 1 additions and 75 deletions
76
README
76
README
|
@ -9,27 +9,7 @@ What makes Mongrel so fast is the careful use of a C extension to provide fast
|
||||||
HTTP 1.1 protocol parsing and fast URI lookup. This combination makes the server
|
HTTP 1.1 protocol parsing and fast URI lookup. This combination makes the server
|
||||||
scream without too many portability issues.
|
scream without too many portability issues.
|
||||||
|
|
||||||
== Status
|
You can view http://mongrel.rubyforge.org for more information.
|
||||||
|
|
||||||
Mongrel 0.3.9 now supports a fancy RubyGems based plugin system called GemPlugin.
|
|
||||||
It uses the basic machinery of RubyGems to implement dynamically loaded plugins
|
|
||||||
based on dependencies. Writing a plugin is pretty easy, but right now it's
|
|
||||||
not as well documented as it should be. There is a simple example plugin
|
|
||||||
for adding a status command to your mongrel. Just do:
|
|
||||||
|
|
||||||
> gem install mongrel_status
|
|
||||||
|
|
||||||
And you'll then get a new status command. Then just do:
|
|
||||||
|
|
||||||
> cd myrailsapp
|
|
||||||
> mongrel_rails start -d
|
|
||||||
> mongrel_rails status
|
|
||||||
|
|
||||||
And it'll print out the PID your Rails app is running under.
|
|
||||||
|
|
||||||
The GemPlugin project is a sub-project of Mongrel, but it's licensed under
|
|
||||||
the Ruby license and is usable outside Mongrel
|
|
||||||
|
|
||||||
|
|
||||||
== Quick Start
|
== Quick Start
|
||||||
|
|
||||||
|
@ -60,39 +40,6 @@ changing to a different directory, adding more MIME types, and setting processor
|
||||||
threads and timeouts.
|
threads and timeouts.
|
||||||
|
|
||||||
|
|
||||||
=== Win32 Service Support
|
|
||||||
|
|
||||||
Mongrel now has support for running as a Win32 service right out of the
|
|
||||||
box. The support is still rough but works well enough that we decided
|
|
||||||
to release it. You can thank Luis Lavena for working on this and making
|
|
||||||
it so nice.
|
|
||||||
|
|
||||||
After you do the gem install, find a Rails application you want to run
|
|
||||||
and do:
|
|
||||||
|
|
||||||
$ mongrel_rails_service install -n myapp \
|
|
||||||
-r c:\my\path\to\myapp -p 4000 -e production
|
|
||||||
$ mongrel_rails_service start -n myapp
|
|
||||||
|
|
||||||
Now hit the port and poof, works.
|
|
||||||
|
|
||||||
Stopping a service is simple:
|
|
||||||
|
|
||||||
$ mongrel_rails_service stop -n myapp
|
|
||||||
|
|
||||||
If you run into an app that's not running right, my suggestion is to run it with
|
|
||||||
the regular mongrel_rails runner:
|
|
||||||
|
|
||||||
$ cd c:\my\path\to\myapp
|
|
||||||
$ mongrel_rails start -p 4500
|
|
||||||
|
|
||||||
Since that will spit out error messages and stuff to the console. *Use CTRL-Pause/Break to stop.*
|
|
||||||
|
|
||||||
Best thing about the win32 support is that you can simply use the Windows Services
|
|
||||||
in Control Panel->Admin Tools to work with it. You can also install the same
|
|
||||||
Rails app as different installs. For example I've got myapp_dev, and myapp_prod and
|
|
||||||
just start/stop which one I want to work with.
|
|
||||||
|
|
||||||
== Install
|
== Install
|
||||||
|
|
||||||
It doesn't explicitly require Camping, but if you want to run the examples/camping/
|
It doesn't explicitly require Camping, but if you want to run the examples/camping/
|
||||||
|
@ -104,7 +51,6 @@ who can build it for you.
|
||||||
|
|
||||||
Finally, the source includes a setup.rb for those who hate RubyGems.
|
Finally, the source includes a setup.rb for those who hate RubyGems.
|
||||||
|
|
||||||
|
|
||||||
== Usage
|
== Usage
|
||||||
|
|
||||||
The examples/simpletest.rb file has the following code as the simplest
|
The examples/simpletest.rb file has the following code as the simplest
|
||||||
|
@ -135,26 +81,6 @@ This also shows the DirHandler with directory listings. This is still
|
||||||
rough but it should work for basic hosting. *File extension to mime
|
rough but it should work for basic hosting. *File extension to mime
|
||||||
type mapping is missing though.*
|
type mapping is missing though.*
|
||||||
|
|
||||||
|
|
||||||
== Speed
|
|
||||||
|
|
||||||
Like previous releases 0.3.1 continues the trend of making things
|
|
||||||
as fast as possible. It currently might be a little slower than
|
|
||||||
other releases but should hold up pretty good against at least
|
|
||||||
WEBrick (especially when running Rails).
|
|
||||||
|
|
||||||
As before you can control the number of processor threads (and thus
|
|
||||||
ActiveRecord database connections) with:
|
|
||||||
|
|
||||||
h = Mongrel::HttpServer.new("0.0.0.0", "3000", 40)
|
|
||||||
|
|
||||||
Which will make 40 thread processors. Right now the optimal setting is up in
|
|
||||||
the air, but 20 seemed to be about the sweet spot on my systems. The
|
|
||||||
limited processors also means that you can use ActiveRecord as-is and it will
|
|
||||||
create a matching database connection for each processor thread. More on
|
|
||||||
this in future releases.
|
|
||||||
|
|
||||||
|
|
||||||
== Contact
|
== Contact
|
||||||
|
|
||||||
E-mail zedshaw at zedshaw.com and I'll help. Comments about the API are welcome.
|
E-mail zedshaw at zedshaw.com and I'll help. Comments about the API are welcome.
|
||||||
|
|
Loading…
Add table
Add a link
Reference in a new issue