bounceHammer | an open source software for handling email bounces

Env. For Running

  1. Perl Version
  2. Required Perl Modules
  3. Web Server
  4. System Requirements
  5. Supported Databases

Installation Guides

  1. Get the Tarball
  2. Install Perl Modules
  3. Run ./configure
  4. Make and Make Install
  5. Setting Up Database
  6. Directory Structure
  7. Create bouncehammer.cf
  8. Create webui.cf for WebUI
  9. Create neighbor-domains file
  10. Create available-countries file
  11. Prepare WebUI
  12. Prepare HTTP-API
  13. Register Email Domains
  14. Periodically run by crontab
  15. Uninstall bounceHammer

bounceHammer

bouncehammer Commercial Support bounceHammer
Commercial Support

  • 1Introduction, Setup, Configure
  • 2MTA Module Developement
  • 3Technical Support via Email
  • 4Update Subscription Program
  • 5Providing Parsed Data
Read More

bouncehammer-nails | Commercial MTA Modules

  • 1Commercial MTA Modules on Sale
  • 2Microsoft Exchange, Domino, ...
  • 3Clouds (Amazon SES, SendGrid, ...)
  • 4Appliances (MXLogic, MailFoundry, ...)
  • 5Development Custom MTA Module
Read More

bouncehammer Commercial Support bounceHammer
Commercial Support

  • 1Introduction, Setup, Configure
  • 2MTA Module Developement
  • 3Technical Support via Email
  • 4Update Subscription Program
  • 5Providing Parsed Data
Read More

bouncehammer-nails | Commercial MTA Modules

  • 1Commercial MTA Modules on Sale
  • 2Microsoft Exchange, Domino, ...
  • 3Clouds (Amazon SES, SendGrid, ...)
  • 4Appliances (MXLogic, MailFoundry, ...)
  • 5Development Custom MTA Module
Read More

2. Required Perl Modules

 

Check and install perl modules required by bounceHammer

If there is any missing perl module which is required by bounceHammer (the configure scirpt reported), Use the ./Modules.PL script (places in the top directory of source distribution) to list missing module names.

/usr/local/bin/perl Modules.PL

You can check missing module names by using the ./Modules.PL script (it is called from running configure script) without running the configure script.

List required modules
# export PERL5LIB=/usr/local/bouncehammer/lib/perl5 ⏎
# /usr/local/bin/perl ./Modules.PL check ⏎
*[ NG ] Perl6::Slurp
 [ OK ] List::Util VERSION = 1.18
*[ NG ] Email::AddressParser
 [ OK ] Errno VERSION = 1.0901
 [ OK ] File::Copy VERSION = 2.09
*[WARN] Switch VERSION = 2.1001 is older than 2.13
...
List missing modules only
# /usr/local/bin/perl ./Modules.PL missing ⏎
*[ NG ] Perl6::Slurp
*[ NG ] Email::AddressParser
*[ NG ] DBIx::Skinny
...
#

Use cpanm (App::cpanminus) for installing

Modern installation tool

Install cpanm

cpanm(App::cpanminus) is distributed at http://cpanmin.us/ If cpanm command is already in your system, skip this section. In this page, we will install cpanm command into /usr/local/bin directory.

# cd /usr/local/bin ⏎
 
install via curl
# curl -LO http://xrl.us/cpanm ⏎
 
install via wget
# wget -O- 'http://cpanmin.us/' > ./cpanm ⏎
 
# chmod +x ./cpanm ⏎
# hash -r ⏎

Install Perl Modules

In this section, perl modules which are required by bounceHammer are installed into /usr/local/bouncehammer/lib directory.

Following commands install perl modules with cpanm command using outputs of ./Modules.PL script.

# cd /usr/local/src/bouncehammer-2.7.10 ⏎
# export PERL5LIB=/usr/local/bouncehammer/lib/perl5 ⏎
# perl ./Modules.PL missing ⏎
*[ NG ] Class::Accessor::Fast::XS
*[ NG ] Term::ProgressBar
*[ NG ] Time::Piece
...
Pass outputs above to cpanm command
# mkdir -p /usr/local/bouncehammer ⏎
# perl ./Modules.PL missing | cut -d' ' -f4 | cpanm -L \⏎
> /usr/local/bouncehammer ⏎
...

Required perl modules and dependencies will be installed into /usr/local/bouncehammer/lib/perl5 directory by running cpanm -L /usr/local/bouncehammer.

After you have installed required modules, check these modules are installed correctly using Modules.PL script.

Old version modules

If you found a module name which begin with *[WARN] in the output lines of Modules.PL, it is an installed perl module which version is older than a required version. You may install a newer version module if you can.

Update old modules using cpanm command
# /usr/local/bin/cpanm -L/usr/local/bouncehammer IO::Compress::Bzip2 ⏎
...

Perl modules for Database

You should install a perl module for database you want to use. A database module name is listed at Supported Database page.

Database modules are not checked in running configure and Modules.PL.

Use MySQL as a database
# cpanm -L /usr/local/bouncehammer DBI DBD::mysql ⏎
...
 
Use PostgreSQL # cpanm -L /usr/local/bouncehammer DBI DBD::Pg ⏎
...
 
use SQLite # cpanm -L /usr/local/bouncehammer DBI DBD::SQLite ⏎
DBD::SQLite is up to date (1.29).
DBD::SQLite is already installed

After you have installed required perl modules for bounceHammer, Proceed to Run ./configure page.