10) available-countries

Configuration file available-countries is for classifying famous domains which are mainly used other country, and for definition of special MTAs. This configuration file will give the following features.

Control the classification of famous domains in other countries

It controls the classification of famous domains (e.g. mail.ru and yandex.ru in Russia, mail.goo.ne.jp and livedoor.com in Japan) which are used in other country. For example, @MAIL.RU is the most famous free mail service in Russia, but it would not be famous like Gmail, Hotmail, and Yahoo! in other countries. The configuration file is for controlling classification of domains in other countries.

Define special MTAs

When you implement a perl module for special MTA (not famous MTA or service) which is not widely used in the world, The configuration file controls that whether mailboxparser command uses the module or not. In bounceHammer, The special MTA means the MTA which send the bounce message as a unknown format (bounceHammer's parser can not parse it).

bounceHammer will work properly if this configuration file does not exist.

Create and Edit available-countries

Configuration file available-coiuntries is a YAML format file like other ones. Note that If there is any syntax error in the configuration file, bounceHammer will not work properly.

In the default settings of this configuration file, bounceHammer load all the libraries which have been installed in /usr/local/bouncehammer/lib for classification. If there is any library which does not need to load, please edit this configuration file.

Key names for classification

There are some keys in each key which is defined as 2-char country code such as JP=Japan, UK=United Kingdom. The values: 0 = Dont load, 1 = Load are available at these keys (webmail, smartphone, cellphone). If you set the value 0 to these keys, The Hostgroup is set to various, and the provider is set to various in the parsed data which created by mailboxparser command.

Definition of special MTAs

The key name agents is for definition of special MTAs which send an unknown formatted bounce message (bounceHammer cannot parse it). The value is written as a YAML array. Listed MTAs will be loaded from bounceHammer as Kanadzuchi::MTA::2-char country code::MTA's name.

In the default settings of this file, aubyKDDI (Japanese cellular phone company) has been defined, bounceHammer will load INSTALL-DESTINATION/lib/Kanadzuchi/MTA/JP/aubyKDDI.pm Module.

For Example, When you developed a module for your own MTA YourMTA.pm, and you installed the module into INSTALL-DESTINATION/lib/Kanadzuchi/MTA/UK/YourMTA.pm, bounceHammer load the module by the following settings.

"uk":
  "smartphone": 1
  "webmail": 1
  "agents": [ "YourMTA" ]

Next, Proceed to Prepare WebUI page for setting up WebUI (browser based control panel).