oracular (3) FCGI::Engine::Manager.3pm.gz

Provided by: libfcgi-engine-perl_0.22-2_all bug

NAME
       FCGI::Engine::Manager - Manage multiple FCGI::Engine instances


SYNOPSIS
         #!/usr/bin/perl

         my $m = FCGI::Engine::Manager->new(
             conf => 'conf/my_app_conf.yml'
         );

         my ($command, $server_name) = @ARGV;

         $m->start($server_name)        if $command eq 'start';
         $m->stop($server_name)         if $command eq 'stop';
         $m->restart($server_name)      if $command eq 'restart';
         $m->graceful($server_name)     if $command eq 'graceful';
         print $m->status($server_name) if $command eq 'status';

         # on the command line

         perl all_my_fcgi_backends.pl start
         perl all_my_fcgi_backends.pl stop
         perl all_my_fcgi_backends.pl restart foo.server
         # etc ...


DESCRIPTION
       This module handles multiple FCGI::Engine instances for you, it can start, stop and provide basic status
       info. It is configurable using Config::Any, but only really the YAML format has been tested.

   Use with Catalyst
       Since FCGI::Engine is pretty much compatible with Catalyst::Engine::FastCGI, this module can also be used
       to manage your Catalyst::Engine::FastCGI based apps as well as your FCGI::Engine based apps.

   Use with Plack
       Plack support is provided via the FCGI::Engine::Manager::Server::Plackup module. All that is required is
       setting the "server_class" parameter in the configuarion and it will Just Work.


EXAMPLE CONFIGURATION
       Here is an example configuration in YAML, it should be noted that the options for each server are
       basically the constructor params to FCGI::Engine::Manager::Server and are passed verbatim to it.  This
       means that if you subclass FCGI::Engine::Manager::Server and set the "server_class:" option
       appropriately, it should pass any new options you added to your subclass automatically. The third server
       in the list shows exactly how this is used with a Plack application.

         ---
         - name:            "foo.server"
           server_class:    "FCGI::Engine::Manager::Server"
           scriptname:      "t/scripts/foo.pl"
           nproc:            1
           pidfile:         "/tmp/foo.pid"
           socket:          "/tmp/foo.socket"
           additional_args: [ "-I", "lib/" ]
         - name:       "bar.server"
           scriptname: "t/scripts/bar.pl"
           nproc:       1
           pidfile:    "/tmp/bar.pid"
           socket:     "/tmp/bar.socket"
         - name:            "baz.server"
           server_class:    "FCGI::Engine::Manager::Server::Plackup"
           scriptname:      "t/scripts/baz.psgi" # the .psgi file
           nproc:            1
           pidfile:         "/tmp/baz.pid"
           socket:          "/tmp/baz.socket"
           additional_args: [ "-E", "production" ] # plackup specific option


BUGS
       All complex software has bugs lurking in it, and this module is no exception. If you find a bug please
       either email me, or add the bug to cpan-RT.


AUTHOR
       Stevan Little <stevan@iinteractive.com>


       Copyright 2007-2010 by Infinity Interactive, Inc.

       <http://www.iinteractive.com>

       This library is free software; you can redistribute it and/or modify it under the same terms as Perl
       itself.