This documentation is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License as
published by the Free Software Foundation; either version 2 of the
License, or (at your option) any later version.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Street #330, Boston, MA 02111-1307, USA.
Here is a quick guide on how to make Binc IMAP work on your system.
=========================================================================
The following library is required for Binc IMAP to compile and run:
OpenSSL - http://www.openssl.org/
For some platforms, the gnugetopt port is also required.
=========================================================================
If you do not plan to modify the original source code, it will suffice
to grab one of the precompiled binary RPM packages from:
http://www.bincimap.andreas.hanssen.name/dl/RPMS
If you can't find a precompiled binary that matches your system, you
can grab a source RPM from here:
http://www.bincimap.andreas.hanssen.name/dl/SRPMS
To create RPM packages for your system, you can run the following
command as root:
rpmbuild --rebuild bincimap-a.b.c-d.src.rpm
At the end of the input, you will see where your binary package has
been generated.
=========================================================================
Here's how to set up the service when building from the tarball:
----------------------
1) Compile the service
----------------------
./configure --prefix=/opt/bincimap --sysconfdir=/etc/opt/bincimap
make
Add --enable-static to ./configure to build a static binary.
The sysconfdir prefix must be supplied for the service and
xinetd files to be generated correctly.
After compiling, copy the binaries to where you want them:
src/bincimapd and src/bincimap-up. If you're feeling brave,
you can try a "make install".
--------------------------------
2) Apply necessary configuration
--------------------------------
Copy conf/bincimap.conf to its destination - for example
/etc/opt/bincimap/bincimap.conf.
mkdir -p /etc/opt/bincimap
cp conf/bincimap.conf /etc/opt/bincimap/bincimap.conf
Edit the destination file. Check each individual setting.
* Note the location of your server's SSL certificate details.
* Note the default path to users' Maildir, relative to the
users' home directories.
* Use the man pages bundled with the distribution, under
the man/ directory.
If using daemontools' supervise, tcpserver and multilog,
create the multilog directores.
mkdir -p /var/opt/log/bincimap{,-ssl}
chown nobody.nobody /var/opt/log/bincimap{,-ssl}
xinetd users will be more familiar with using syslog.
----------------------------
3) Install the service files
----------------------------
With xinetd:
Edit conf/xinetd-bincimap and conf/xinetd-bincimaps and check
that the locations are correct. Note the location of your
authenticator in particular, and use the man pages to find
what options you need to pass.
You may also want to place these files under /etc/opt/bincimap/...
and symlink them to /etc/xinetd.d.
cp conf/xinetd-bincimap /etc/xinetd.d/imap
cp conf/xinetd-bincimaps /etc/xinetd.d/imaps
service xinetd restart
With daemontools' supervise:
Edit service/run, service/log/run, service-ssl/run and
service-ssl/log/run and check that the locations are correct.
Note the location of your authenticator in particular.
Then copy and link the service files in place.
In this example we use /var/service to store run files, and
svscan runs from /service. The RPM uses /etc/opt/bincimap to
store these directories.
mkdir -p /var/service
cp -a service /var/service/imap
cp -a service-ssl /var/service/imaps
ln -s /var/service/imap /service/imap
ln -s /var/service/imaps /service/imaps
=========================================================================
Please report any problems to:
The Binc IMAP mailing list <lists-bincimap@infeline.org>
Author: Andreas Aardal Hanssen <bincimap@andreas.hanssen.name>
