j-greyd - Greylist database server

j-chkmail has two configuration options which control how they handle greylisting. The configuration option GREY_MODE can take value STANDALONE or CLIENT. In standalone mode the filter manages all greylisting data, while in client mode, it manages its own database, the same way as in standalone mode but when the information it needs isn't found locally, it contacts a greylisting server and ask him what to do. Also, when it updates some information locally, it signals the greylisting server.

The client mode is useful when you want to synchronize all your MXs, or if you have more than one main MX with the same weight.

Normally, the filter default configuration options are :

GREY_MODE                          CLIENT
GREY_SOCKET                        inet:2012@127.0.0.1

Some thoughs about the interest of using a centralized or distributed greylisting architecture can be find here

j-greyd configuration options can be found at :

• /etc/mail/jchkmail/j-chkmail.cf - j-greyd can share the main configuration file for j-chkmail and has its own configuration section.

#
# Configuration options shared with j-chkmail
#
GREY_LOG_FILE                    file:j-grey-expire
GREY_MIN_DELAY_NORMAL            10m
GREY_MIN_DELAY_NULLSENDER        10m
GREY_MAX_DELAY_NORMAL            3d
GREY_MAX_DELAY_NULLSENDER        6h
GREY_VALIDLIST_LIFETIME          1w
GREY_WHITELIST_LIFETIME          2w
GREY_BLACKLIST_LIFETIME          1d
GREY_PENDING_NORMAL              1000
GREY_PENDING_NULLSENDER          1000
GREY_IP_COMPONENT                NET
GREY_FROM_COMPONENT              HOST
GREY_TO_COMPONENT                FULL
GREY_CLEANUP_INTERVAL            10m
GREY_DEWHITE_FLAGS               DomainMatch
#
# Configuration options exclusive to j-greyd
#
GREYD_SOCKET_LISTEN              inet:2012@0.0.0.0
GREYD_LOG_FACILITY               local6
GREYD_LOG_LEVEL                  10
GREYDDIR                         /var/jchkmail/jgreydb
GREYD_PID_FILE                   /var/run/jchkmail/j-greyd.pid
GREYD_CLIENT_IDLE_MAX            300

• j-policy.txt database - j-greyd shares (read-only mode) this database with j-chkmail. Sharing this database ease the management of data used by greylisting filter. Other than the data shared with j-chkmail you can define j-greyd access data :

GreydAccess:default         REJECT
GreydAccess:127.0.0.1       OK
GreydAccess:10.3.5.5        OK

• /etc/default/jgreyd - this is a sh script called when launching j-greyd. You can define here some environment variables used by j-greyd.

• Command line options - some configuration options are are available as command line options. Most of them are there for historic reasons - it's better to use the shared configuration file to specify configuration options. See j-greyd -h for all available options.

• /etc/init.d/jgreyd

You can use j-ndc the same way as you do with j-chkmail, if j-greyd is listening on an INET port. But j-greyd accepts much less commands than j-chkmail. Useful commands are :

# re-read j-chkmail configuration file
$ j-ndc -p 2015 reconfig
# re open j-policy database
$ j-ndc -p 2015 reopendb