From 4d72d0fc62ea71880fc0ede0ee1f894178643361 Mon Sep 17 00:00:00 2001 From: zedshaw Date: Wed, 22 Feb 2006 18:29:20 +0000 Subject: Updated all the documentation and wrote more docs for the win32 service support. git-svn-id: svn+ssh://rubyforge.org/var/svn/mongrel/trunk@58 19e92222-5c0b-0410-8929-a290d50e31e9 --- README | 29 ++++++++++++++++++++++++++++- 1 file changed, 28 insertions(+), 1 deletion(-) (limited to 'README') diff --git a/README b/README index 4b34c60..a86f031 100644 --- a/README +++ b/README @@ -14,7 +14,8 @@ scream without too many portability issues. The 0.3.6 release supports Ruby On Rails much better than previously, and also sports the beginning of a command and plugin infrastructure. There is now a more complete CGIWrapper that handles most of the CGI usage, but still doesn't do the -MIME decoding or file upload/send (it leaves that to CGI). +MIME decoding or file upload/send (it leaves that to CGI). Finally, there's a +great mongrel_rails_service script for running under Win32 as a service. After you've installed (either with gem install mongrel or via source) you should have the mongrel_rails command available in your PATH. Then you just do the following: @@ -42,6 +43,32 @@ There are also many more new options for configuring the rails runner including changing to a different directory, adding more MIME types, and setting processor 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 the service is a little problematic right now.* + +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.* + + == Install It doesn't explicitly require Camping, but if you want to run the examples/camping/ -- cgit v1.2.3-24-ge0c7