bounceHammer have been downloaded and used by many users and companies since the first release on March 2010 and has been EOL: End Of Life on February 29, 2016. Thanks for using bounceHammer for a long time. We are now providing Sisimai (the successor of bounceHammer, more faster, more higher precision of analysis) as a bounce mail parser library in BSD 2-Clause License.
After you have installed bounceHammer, you can use some command line tools in INSTALL-DESTINATION/bin directory. All the command are a perl script. Each command of the directory can be executed by anybody.
The first step of start to use bounceHammer is that parse bounce emails by using mailboxparser command.
bounceHammer parses an email as a text data, parses a mailbox saved on your server, parse emails saved on Maildir/.
Old emails on your computer or old mailbox (such as /var/mail/root)
on your server can be parsed by bounceHammer.
bounceHammer parse bounce emails and then find a reason (such as userunknown, mailboxfull, rejected, and so on) why the email bounced, classify recipient into a hostgroup (such as webmail, pc, smartphone ).
mailboxparser command will do this and save results as a file in INSTALL-DESTINATION/var/spool directory.
Parsed data which are created by mailboxparser command are sorted by time, accumulated and saved by each date in INSTALL-DESTINATION/var/log directory.
logger command will do this.
Accumulated data which are created by logger command are saved as a YAML file will be inserted/updated into a database.
databasectl command will do this.
Stored data which are inserted/updated by databasectl command can be searched with conditions, and can be dumped as a YAML/JSON format.
datadumper command and WebUI will do this.
Stored data (created by databsectl command) in a database or the accumulated data (created by logger command) in a log file can be aggregated, and you can get aggregated data and descriptive statistics.
command and WebUI will do this.
You can edit and refer each mastertable (SenderDomains, Destinations, HostGroups, Providers, and Reasons) of bounceHammer by using tablectl command. This operation can be do with WebUI.
command generates a unique string which is created by the combination of an
Addresser(From: address) and a Recipient(To: address).
The unique string is named as "Message Token" in bounceHammer.