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>