Environment for running bounceHammer
bounceHammer can run on *BSD UNIX (such as OpenBSD, FreeBSD, and FreeBSD) and Linux.
More information about an environment for runnning bounceHammer available at the following pages:
Required Perl Modules
Web Server for running WebUI
Supported Database softwares
You can build bounceHammer with the configure script and the make(1)
program like compiling Apache, PostgreSQL, and generic GNU software.
Visit the following links to build, install, and configure bounceHammer.
Get the tarball of bounceHammer
Download and expand it.
Required Perl modules |
Install perl modules which are required by bounceHammer
Preparation before building(make)
make && make install |
Build and install
Setting up database |
Setting Up database for storing parsed data
Directory structure |
Check directory structure created by the installer
Creating configuration files of bounceHammer
After you have installed bounceHammer successfully,
please create and edit configuration files of bounceHammer with referring the following
| Create a main configuration file
| Create a configuration file for WebUI
| Create a configuration file for your own classification
| Create a configuration file to define your MTA
Configuration and Operation
After you have created the configuration files of bounceHammer,
Visit the following pages.
Prepare WebUI(Browser based control panel)
Register email domain names which are under your control
Periodically run bounceHammer by /etc/crontab
Features of bounceHammer
Following pages explain features of bounceHammer, data structure, and internal flow.
We provide command line tools for server administrators, WebUI (browser based control panel) for
webmasters, and HTTP-API for developers.
Command line tools of bounceHammer
Following pages explain command line tools of bounceHammer which are
installed undef bin/ directory by the installer.
| Parse bounce emails and output results as a YAML/JSON format
| Integrate parsed data by date
| Insert or update parsed data into your database
| Dump parsed data from your database as a YAML/JSON
| Print simple statistics of parsed data
| Register, update, and delete a record in the master table.
| Generate a message token by a sender address and a recipient addresss
Classification of parsed data generated by bounceHammer
Following pages describe about classifications of parsed data in bounceHammer.
Classifications are good for putting in order parsed data, for using search conditions.
| Classification by a domain name of a recipient(PC,Webmail,and so on)
| Classification by a provider name or service name(Gmail, Yahoo!, and so on)
| Reasons of email bounce
WebUI on bounceHammer
Following pages explain about WebUI: Browser based control panel for webmasters.
You can search a recipient address, register a your email domain on WebUI.
| First page of WebUI, It display email bounce status of today and yesterday
| Finding details of email bounce searching by an email address and so on.
| Check details of email bounce on WebUI
| Show the number of email bounces with ratio and some graph
| Show aggregated data on your database
Edit master table
| Edit master table to manage your email domains
| Daily updates of email bounces
| Upload a bounce email in your PC to WebUI and parse it
bounceHammer provide HTTP-API for developers.
HTTP-API have 2 methods for searching parsed data and they return results as a JSON format.
It is good for implement a feature that verifying email bounce into your site.
| Get a parsed record by a message token or ID (on DB)
| Get some parsed records by some fields