From iRedMail
Revision as of 02:13, 31 December 2013 by ZhangHuangbin (Talk | contribs)

Jump to: navigation, search



Cluebringer (a.k.a. Policyd v2) is a multi-platform policy server for popular MTAs (e.g. Postfix). This policy daemon is designed mostly for large scale mail hosting environments. The main goal is to implement as many spam combating and email compliance features as possible while at the same time maintaining the portability, stability and performance required for mission critical email hosting of today. Most of the ideas and methods implemented in Policyd v2 stem from Policyd v1 as well as the authors' long time involvement in large scale mail hosting industry.


This tutorial is applicable to Red Hat Enterprise Linux 6, CentOS 6.

Install Cluebringer

Please make sure you have iRedMail yum repository and enabled on your server:

File: /etc/yum.repos.d/iRedMail.repo

You can now install Cluebringer with yum directly:

# yum install cluebringer
  • Main config file of Cluebringer is /etc/policyd/cluebringer.conf.
  • Init script is /etc/init.d/cbpolicyd.

Create SQL database for Cluebringer

  • Cluebringer stores blacklist/whitelist/greylisting and other data in SQL database, so we have to create one for it.
  • Cluebringer RPM package ships a SQL file for sample SQL tables, what we need to do is creating a database then importing this sample SQL file.

For iRedMail with OpenLDAP or MySQL backend

If you're running iRedMail with OpenLDAP or MySQL backend, you have to create a MySQL database to store Cluebringer data.

  • Find the sample SQL file:
# rpm -ql cluebringer | grep 'policyd.mysql.sql'
  • Newest MySQL server doesn't recognize 'TYPE=MyISAM' or 'TYPE=InnoDB' while creating SQL table, so we'd better convert them to 'ENGINE=' before importing it.
# perl -pi -e 's#TYPE=#ENGINE=#g' /usr/share/doc/cluebringer-2.0.14/database/policyd.mysql.sql
  • Now create a SQL database for Cluebringer and import SQL sample file. Important note: iRedAdmin-Pro detects Policyd/Cluebringer by dataabse name, so please do NOT use other database name.
# mysql -uroot -p
mysql> CREATE DATABASE cluebringer;
mysql> USE cluebringer;
mysql> SOURCE /usr/share/doc/cluebringer-2.0.14/database/policyd.mysql.sql;
  • Create SQL user "cluebringer" (with password 'cb_password') for Cluebringer database and grant necessary privileges. Important note: Please 'cb_password' by a long, complex password.
mysql> GRANT SELECT,INSERT,UPDATE,DELETE ON cluebringer.* TO "cluebringer"@"localhost" IDENTIFIED BY 'cb_password';
  • Make sure you can connect to MySQL server with this new SQL username and password:
# mysql -u cluebringer -p

For iRedMail with PostgreSQL backend

If you're running iRedMail with PostgreSQL backend, you have to create a PostgreSQL database to store Cluebringer data.

Configure Cluebringer

Personal tools