/* ====================================================================
* Copyright (c) 2000 University of Valencia. All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
*
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
*
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in
* the documentation and/or other materials provided with the
* distribution.
*
* 3. All advertising materials mentioning features or use of this
* software must display the following acknowledgment:
* "This product includes software developed by the University
* of Valencia."
*
* 4. The names "Postman" must not be used to endorse or promote products
* derived from this software without prior written permission.
*
* 5. Redistributions of any form whatsoever must retain the following
* acknowledgment:
* "This product includes software developed by the University of Valencia"
*
* THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR
* IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
* PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL ITS CONTRIBUTORS
* BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
* NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
* LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
* STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
* OF THE POSSIBILITY OF SUCH DAMAGE.
* ====================================================================
*/
Install for Postman v. 1.1
---------------------------
-I have got working Postman in Linux and HP systems. It must be easy got
working on other UNIX systems. If you get it working on other systems,
please email me.
-Compile imap c-client from University of Washington. You do not need make a install
of the imap sources! I have tested with Postman the imap release 4.7 and 2000.
You can get some of then from:
ftp://ftp.cac.washington.edu/imap/
or from our ftp server
ftp://ftp.uv.es/pub/unix/imap-4.7.tar.Z
ftp://ftp.uv.es/pub/unix/imap-2000a.tar.gz
Put the imap sources at the same level that postman sources. Something like:
/sources/imap4.7
/sources/postman
-Create an UNIX user to run the daemons (must be part of the web group).
-Edit and setup the next files: Makefile, Config.h and files/interdaemon.cfg
-Run make
-Run make install
-The directory structure after install must be something like that:
(Root dir)
#ls -dl /var/postman
drwxr-x--- 7 postman www 1024 Jul 11 2000 /var/postman
(for postman users structure)
#ls -al /var/postman/
drwx------ 2 postman www 4096 Jul 11 11:01 locks
drwxrwx--- 2 postman www 4096 Jul 11 11:02 server
drwxr-x--- 2 postman www 4096 Jul 11 11:01 sessions
drwxrwx--- 2 postman www 4096 Jul 11 11:01 tmp
drwx--x--- 2 postman www 4096 Jul 11 11:01 users
-rw-r----- 1 postman www 2621440 Feb 13 00:17 postman.db
(for postman web pages)
#ls -al /usr/local/apache/htdocs/postman/
-rw-r--r-- 1 root www 617 Jul 11 11:01 disabled.html
drwxr-sr-x 2 root www 4096 Jul 11 11:01 help
drwxr-sr-x 2 root www 4096 Jul 11 11:01 icons
-rw-r--r-- 1 root www 1992 Jul 11 11:01 postman_eng.html
-rw-r--r-- 1 root www 2018 Jul 11 11:01 postman_spa.html
-rw-r--r-- 1 root www 2045 Jul 11 11:01 postman_val.html
(for postman web cgi)
#ls -al /usr/local/apache/cgi-bin/
-rwxr-xr-x 1 root www 156008 Jul 11 11:02 postman
(more stuff)
#ls -al /usr/local/etc
-rw-r--r-- 1 root www 320 Jul 11 11:01 interdaemon.cfg
-rw-r--r-- 1 root www 1 Jul 11 11:01 postman.disabledx
-rw-r--r-- 1 root www 76 Jul 11 11:01 postman.mailcap
-rw-r--r-- 1 root www 136 Jul 11 11:01 postman.motd.eng
-rw-r--r-- 1 root www 154 Jul 11 11:01 postman.motd.spa
-rw-r--r-- 1 root www 136 Jul 11 11:01 postman.motd.val
(true daemon and the conf file)
#ls -al /usr/local/sbin
-rwxr-xr-x 1 root staff 997 Jul 11 11:01 interdaemon.ini
-rwxr-xr-x 1 root staff 914424 Jul 11 11:02 interdaemon
-The user postman and his group:
# grep postman /etc/passwd
postman:*:37:102:Postman user:/var/postman:/sbin/sh
# grep postman /etc/group
www::102:www,postman
Moreover, you must have a Web Server (like Apache) in the same computer and
one IMAP server (in the same or other computer).
You can now access to postman with
http://the.httpd.server/cgi-bin/postman?lang=eng
If you want to use postman.db, every user must have the next info:
imapserver char[49]
imapport integer
smtpserver char[49]
maildomain char[49]
Screenshots:
-------------
We have a working Postman in
http://correo.uv.es
Sorry, no demo user.
You can see screenshots in:
http://correo.uv.es/postman/screenshots/screenshots.html
Problems:
----------
-Postman configuration is not yet automatized. The most problems
are for wrong file permission or owners.
-You must have one Apache conf entry like that in /usr/local/apache/conf/httpd.conf
DocumentRoot "/usr/local/apache/htdocs"
ScriptAlias /cgi-bin/ "/usr/local/apache/cgi-bin/"
AllowOverride None
Options None
Order allow,deny
Allow from all
or you can use virtual hosts:
#NON SECURE MAIL
SSLDisable
DocumentRoot /u/www/htdocs
ServerName correo.uv.es
ErrorLog logs/correo_error.log
TransferLog logs/correo_access.log
ScriptAlias /cgi-bin/ /u/www/cgi-bin/
RewriteEngine on
RewriteRule ^/$ /cgi-bin/postman?lang=spa [PT]
#SECURE MAIL
SSLEnable
Port 443
DocumentRoot /u/www/htdocs
ServerName correo.uv.es
ErrorLog logs/correo_secure_error.log
TransferLog logs/correo_secure_access.log
ScriptAlias /cgi-bin/ /u/www/cgi-bin/
RewriteEngine on
RewriteRule ^/$ /cgi-bin/postman?lang=spa [PT]
Copyright:
-------------
Jose Agustin Lopez Bueno (Agustin.Lopez@uv.es) and University of Valencia.