/ 
Email-Blaster-0.0001_06
River stage zero No dependents
/ Email::Blaster::Manual::Setup

NAME

Email::Blaster::Manual::Setup

INSTALLATION

Install the Perl module:

% cpan install Email::Blaster
...

Install the database tables (MySQL):

% mysql -u xxx -p
mysql> create database email_blaster;
mysql> quit;
% mysql -u xxx -p email_blaster < sbin/email_blaster.sql

Edit the config file (available under t/conf in this distribution).

% vi conf/email-blaster-config.xml

Insert some fake data to play with:

% perl fake-transmission.pl

Run the bulk blaster:

% perl email-blaster-standalone.pl

Run the *throttled* blaster:

% perl throttled-blaster.pl

STAND-ALONE MODE

Run email-blaster-standalone.pl for stand-alone mode.

CLUSTERING MODE

Run email-blaster-clustered.pl for clustered mode. You will also need to install libmemcached and libevent, as well as Cache::Memcached.

In addition, you will need to adjust the "<cluster>" section of your config file like shown here:

<!-- ONLY NECESSARY FOR "CLUSTERED" EMAIL BLASTERS! -->
<cluster>
  <servers>
    <server>localhost:11211</server>
    <server>another.server.com:11211</server>
    <server>yet-another.server.com:11211</server>
  </servers>
</cluster>

...

<handlers>
  <server_startup>
    <!-- Adds this server to the list of active servers. -->
    <handler>Email::Blaster::ClusteredStartupHandler</handler>
    ...

  <server_shutdown>
    <!-- Removes this server from the list of active servers. -->
    <handler>Email::Blaster::ClusteredShutdownHandler</handler>

SUPPORT

Visit http://www.devstack.com/contact/ or email the author at <jdrago_999@yahoo.com>

Commercial support and installation is available.

AUTHOR

John Drago <jdrago_999@yahoo.com>

COPYRIGHT AND LICENSE

Copyright (C) 2008 by John Drago

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.10.0 or, at your option, any later version of Perl 5 you may have available.