Apache2::Mogile::Dispatch - An Apache2 MogileFS Dispatcher
Quickly and easily dispatch requests to mogile storage nodes using perlbal.
Quickly and easily use MogileFS + Perlbal instead of Apache for static ( or semi-static SSI ) file serving
Apache2::Mogile::Dispatch is an apache 2.x mod_perl module that makes it easy to dispatch incoming requests between mogile storage nodes and regular web servers. Consider it like a fancy pure perl mod_rewrite replacement that can intelligently reproxy requests.
This is ideal for websites that server a sizable amount of static content and would like to transition to mogileFS.
The goal of this module is to be as small and simple as possible but flexible enough for large websites to run efficiently and effectively. This module is meant to up sub-classed and the default configuration will more than likely NOT work. Please see the section on subclassing for more information. The test suite also includes several example subclasses ranging from simple to complex.
There are two sets of configuration that this module uses: Module and Request.
Module configuration includes the list of mogile trackers, mogile domain, static servers, etc that tell the module how to operate.
Request configuration includes the per request (uri) options and rules which dictate how it is handled.
Both sorts are directly affected and controlled through the sub-classed module.
This module configuration module sets the mogile trackers to use. It is an array ref.
[ 'localhost:11211', 'localhost:11212', '192.168.199.3:11213' ]
This configuration setting tells the dispatcher whether or not to reproxy the request to perlbal using a reproxy service token ('X-REPROXY-SERVICE') or just a reproxy url ('X-REPROXY-URL').
This configuration setting contains a list (array ref) of web servers to reproxy requests to if mogile is not handling the request.
[ 'localhost:80', '192.168.198:80', 'webservice1' ]
This configuration setting contains the mogile domain to use when querying the trackers for a given key. This is passed directly to mogile object creation.
This is the meat of the request handling. If this is defined and set to '1' then the request will be processed through mogile. If it is defined and set to '0' then it will be processed through the static servers or reproxy token.
The 'reproxy' config option is checked before the 'mogile' option. If it is set and the value is a valid URL than the dispatcher will immediately set the 'X-REPROXY-URL' header field and return with Apache2::Const::DONE.
If the neither 'mogile' nor 'reproxy' is set in the request config, the module will return with Apache2::Const::DONE thus nothing will happen. Note this when debugging your subclass.
When supplied with a list of mogile or static servers it will attempt to make a HEAD request to determine if the server can serve the file or not.
Nick Gerakines, <nick at socklabs.com>
<nick at socklabs.com>
Please report any bugs or feature requests to bug-apache2-mogile-dispatch at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Apache2-Mogile-Dispatch. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.
bug-apache2-mogile-dispatch at rt.cpan.org
Add fallback support -- When severing files it should fallback to either mogile or static when it can't find what it wants.
Add more tests to check if the mogile trackers are reachable.
Add more tests for mogile up/down situation
You can find documentation for this module with the perldoc command.
perldoc Apache2::Mogile::Dispatch
You can also look for information at:
AnnoCPAN: Annotated CPAN documentation
http://annocpan.org/dist/Apache2-Mogile-Dispatch
CPAN Ratings
http://cpanratings.perl.org/d/Apache2-Mogile-Dispatch
RT: CPAN's request tracker
http://rt.cpan.org/NoAuth/Bugs.html?Dist=Apache2-Mogile-Dispatch
Search CPAN
http://search.cpan.org/dist/Apache2-Mogile-Dispatch
The socklabs-cpan project page
The project page: http://dev.socklabs.com/projects/cpan/
The SVN repository: http://dev.socklabs.com/svn/cpan/Apache2-Mogile-Dispatch/trunk/
MogileFS project page on Danga Interactive
http://www.danga.com/mogilefs/
Mark Smith requested this module and gave the first requirements. Should also quickly thank everyone who worked on MogileFS, Perlbal and Memcache for making a product worth using. Cheers.
Copyright 2006 Nick Gerakines, all rights reserved.
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
To install Apache2::Mogile::Dispatch, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Apache2::Mogile::Dispatch
CPAN shell
perl -MCPAN -e shell install Apache2::Mogile::Dispatch
For more information on module installation, please visit the detailed CPAN module installation guide.