[ANN] New Mongrel 0.3.13 Documentation: HOWTO Do Everything

Rails
1

Just a quick note for a few new features/fixes available on the Mongrel
pre-release and a new document that covers nearly all the big features
and configurations for Mongrel.

First, the document is http://mongrel.rubyforge.org/docs/howto.html and
it covers:

  • All the start command options including the fresh -G option to
    generate a config for -C.
  • The format and usage of the MIME type file (-m option).
  • Using a YAML config file to set command line options (-C option).
  • Writing fancy Mongrel co
  • Improved “HOWTO”:/docs/howto.html documentation with all options.nfig
    scripts in Ruby (-S option).
  • The POSIX signals Mongrel uses for restart, stop, and reload.
  • What the super debugging -B option produces and when to use it.
  • Quick start on installing the mongrel_cluster GemPlugin.

The current pre-release now has the following fixes:

  • A fix for --num-procs and --timeout where they weren’t really being
    set.
  • A new -G option for generating YAML configs for the -C option.

Everyone should update from the releases directory with:

$ gem uninstall mongrel
$ gem install mongrel --source=http://mongrel.rubyforge.org/releases/

And try these out. Especially the --num-procs and --timeout since they
weren’t really being set previously (damn that’s dumb).

Luis is also asking to hold off on the official 0.3.13 release until he
can fix up the win32 side and clean up the commands used there. He’s
got goodies in the works so that win32 folks can use the same
mongrel_rails script everyone else is using, but get special win::
commands for managing the services.

Enjoy!

–
Zed A. Shaw

http://mongrel.rubyforge.org/

2

On 5/12/06, Zed S. [email protected] wrote:

Just a quick note for a few new features/fixes available on the Mongrel
pre-release and a new document that covers nearly all the big features
and configurations for Mongrel.

Either something messed up when I installed or something else is just
broken. In trying some commands I’m getting errors:

mongrel_rails --version
INVALID COMMAND: Plugin /–version does not exist in category /commands
Available commands are:

  • restart
  • start
  • stop

Each command takes -h as an option to get help.

mongrel_rails start --version

INVALID COMMAND: uninitialized constant
Mongrel::Command::Base::MONGREL_VERSION
Available commands are:

  • restart
  • start
  • stop

Each command takes -h as an option to get help.

(Was getting errors trying to use the -G option, but that turned out
to be my own fault)

jt

3

On Fri, 2006-05-12 at 19:47 -0400, John T. wrote:

Either something messed up when I installed or something else is just
broken. In trying some commands I’m getting errors:

mongrel_rails --version
INVALID COMMAND: Plugin /–version does not exist in category /commands
Available commands are:

This is sort of right, mongrel_rails itself doesn’t have any options,
it’s just a script that runs other commands. I should probably just make
a version command though.

INVALID COMMAND: uninitialized constant Mongrel::Command::Base::MONGREL_VERSION
Available commands are:

Damn, bug. I’ll fix that up and re-release. Thanks for testing.

Let me know how it works otherwise though.

–
Zed A. Shaw

http://mongrel.rubyforge.org/

4

On Fri, 2006-05-12 at 22:29 -0400, John T. wrote:

-e, --environment ENV            Rails environment to run as
-d, --daemonize                  Whether to run in the background or not

…
-h, --help Show this message
–version Show version

Says there already is one :slight_smile:

Ooooh, a smartass. I love it. :slight_smile:

Well, I don’t want to shoot you down for your enthusiasm, but if you
read the above you got help for the start command, and it says there’s a
–version for that (not for all of mongrel_rails). Sure, it’s missing
the “mongrel_rails start [options]” part but I’m hoping that won’t
prevent the carefully crafted protocol handler or the ternary search
trie URI lookup from functioning correctly.

I’ll see if I can squeeze the one word change to the usage line into the
latest patch for conditional responses from Dan K. tomorrow. It could
be a tough one, but I think it might just make it.

While I’m doing that, do you think you could maybe test something other
than the version string? I don’t know, maybe a Rails application, or
something in Camping, or maybe a nice Nitro app or two. Maybe go grab a
protocol fuzzer and try to break the parser? You could try writing a
handler or a command as a GemPlugin. Maybe some feedback on the actual
options.

Hehe, anyway, thanks for reporting this. Just giving you a hard time
back.

–
Zed A. Shaw

http://mongrel.rubyforge.org/

5

On 5/12/06, Zed S. [email protected] wrote:

This is sort of right, mongrel_rails itself doesn’t have any options,
it’s just a script that runs other commands. I should probably just make
a version command though.

'Cept if you do:

mongrel_rails start -h
Usage: mongrel_rails [options]

-e, --environment ENV            Rails environment to run as
-d, --daemonize                  Whether to run in the background or

not
…
-h, --help Show this message
–version Show version

Says there already is one :slight_smile:

jt