Install
Table of content
There are many roads to Rome, so follow the best fitting.
Install on a debian system
Thats easy, 'cause i am a debian nerd myself and pre-build packages for you, which can be easily installed and removed.
There are two packages:
- Decency core
Contains the actual Decency perl modules, scripts and config files. Decency is still not stable, so it will installt itself into /opt/decency - Decency perl module package
Those are all the perl modules you require to run Decency. You can also build them separately via dh-make-perl yourself, or just use this package. However, for now there is only an amd64 version. The perl modules will be installed into /opt/decency/locallib, so no conflicts with your "other" perl modules will occure.
Get the packages from the download page, upload them to your machine and run:
dpkg -i decency*.deb
Thats all, you can now continue with the configuration of the Doorman Server and following the configuration of the Detective Server.
Install via Github
Get a clone of Decency like so:
git clone git://github.com/ukautz/decency.git
Build and install
Now you have to build the perl module. It has a lot of dependencies, which you need to install as well. Perl will guide you through this.
Before you begin, make sure you have your build tools installed (gcc, perl headers and so on).
./Build.PL ./Build ./Build test ./Build install
Setup user and directories
Decency uses per default the following directories:
/var/spool/decency- All temporary, archieved, honey-potted and so on Mails go here./var/log/decency- Logfiles will be outputted here (if directory logging is enabled)./etc/decency- Configuration files.
You can either stick with those and create them or find your own spots of convenience.
However, before creating them, you have to add a Decency user and group. Per default, both are called "decency", but you can use whatever you want.
/usr/sbin/adduser --system --group --home /var/spool/decency \
--gecos "Decency anti spam" \
--disabled-password --quiet decency
Now create the directories and change ownership to the Decency user and group.
Using local::lib for perl packages
Decency tries to use local::lib by default.
Using install dir for additional perl packages
Decency is looking in the following directories for perl modules:
/opt/decency/lib/opt/decency/locallib/opt/decency/locallib/lib/perl5
To install perl modules into a certain directory, you can use this script like so (make it executable beforehand):
./perl-install-dir.sh /opt/decency/locallib Archive::Tar Cache::FastMMap MongoDB
Setup config
Copy all configuration files from the unpack dir conf/ folder into your Decency configuration directory (default: /etc/decency) and read on configuration of the Doorman Server and following configuration of the Detective Server.
Install via CPAN
Warning: The CPAN packages are way!! out of date! Do not use them, until they are updated.
Basically the same as with github, but here you start with:
perl -MCPAN -e 'CPAN::install( "Mail::Decency" )'
Now proceed with "Setup user and directories" from above.