imp_install.html

IMP Installation Overview

Introduction

IMP is the WebMail Application chosen by the WebMail 2000 Evaluation Team. IMP is part of the Horde Project and has been installed successfully on Solaris, Tru64 and Linux machines during our testing.

This document is not a specific set of instructions that will provide you with a working IMP installation. It is an overview that will explain what to expect if you attempt to install IMP on a Solaris, Tru64 or Linux server.

There are links to the software mentioned in the document under the section titled Links.

IMP

IMP is package of scripts written in PHP. PHP is a Server-Side scripting language that is embedded in html code. Apache is the most commonly used http server and has a module (php_mod) that allows it to directly execute PHP script contained within html pages. IMP can connect to POP or IMAP servers; however, we only tested IMAP servers during the evaluation and so this document will deal exclusively with IMAP issues.

IMP uses many other software packages for its optional features. These include but are not limited to:

Mysql - imp will store session data and user preferences
OpenSSL - use this with Apache to enable SSL connections
OpenLDAP - IMP can query an LDAP server for contact information
Mvware - viewing MS Word documents in HTML

This document will focus on setting up a basic IMP/PHP/Apache install.

Notes:

The current stable version of IMP is version 2.2, which can be used with either PHP3 or the newer PHP4. The next major revision of IMP (2.3) is nearing completion. This version will require PHP4.
"The PHP Base Library is a toolkit for PHP3 developers supporting them in the development of Web applications." Before PHP4 was released (May 2000) PHPlib had session management capabilities that were not available in PHP3. IMP uses PHPlib for its session management in IMP version 2.2. IMP 2.3 will drop the use of PHPlib due to PHP4's speed and advanced session management.
On Linux: don't use any RPMs for these packages. The RPMs are not going to be built the exact way necessary. If you are using a Linux machine just retrieve the sources and build it according to this outline.

Retrieve the necessary files:

PHP3

http://www.php.net/download-php3.php

IMP 2.2

http://www.horde.org/imp/2.2/

PHPlib

http://phplib.netuse.de/download/index.php3

Apache 1.3x

http://www.apache.org/dist/

UWimap

http://www.washington.edu/imap/#Software

Make a directory to store all these and then untar them.

The quick install outline:

IMAP
PHP
Apache
Horde/IMP
Configure IMP for your site

UWASH imap

The University of Washington IMAP server is used for its c-client, which is client code that will work with an IMAP server. PHP uses this to build its IMAP client, which IMP will use to connect to the Email Server (see diagram).

Please read the README and Install document for background info about IMAPd before proceeding

make <platform>
cp imapd/imapd /usr/sbin
cp ipopd/ipop2d ipopd/ipop3d /usr/sbin
mkdir include
mkdir lib
cp c-client/*.h include
cp c-client/*.a lib

The PHP install is going to need to find the include and lib files in the directories that you created.

PHP

For PHP, you'll need to first configure Apache, then jump back and build PHP.

Please read the README and Install document for background info before proceeding

Apache:

The apache-base-directory is the directory where you plan on installing apache-- like /usr/local/etc/apache for instance

cd apache-1.3.12;
./configure --prefix<apache-base-directory>

Back in PHP:

cd php-3.0.14
./configure --enable-track-vars --with-imap<path-to-imap-src> \--with-apache<path-to-apache-src>
make
make install
cp php3.ini.dist /usr/local/lib/php3.ini

Apache

Now build apache with the mod_php (and other modules if you are using them)

Please read the README and Install document for background info before proceeding

./configure --activate-modulesrc/modules/php3/libphp3.a \
--prefix<apache-base-directory>
make
make install

edit httpd.conf - uncomment:
AddType application/x-httpd-php3 .php3
AddType application/x-httpd-php3-source .phps
add:
index.php3 to the DirectoryIndex config line

Horde & IMP

This is the tricky part.

Please read the README and Install document for background info before proceeding

tar zxvf horde-1.2.x
mv horde-1.2.x <path-to-web-doc-dir>/horde
cd <path-to-web-doc-dir>/horde
cp -r php <path-to-web-root-dir>

Read the IMP docs: you need to decide what storage system to use for session management and user preferences with phplib, then:

mv <path-to-web-root-dir>/php/horde_phplib.inc <path-to-web-root-dir>/php/local.inc

edit local.inc in <path-to-web-root-dir> and specify settings

tar zxvf imp-2.2.x
mv imp-2.2.x <path-to-web-doc-dir>/horde/imp

edit /usr/local/lib/php3.ini:

add: <path-to-web-root-dir>/php to include_path line
add: prepend.php3 to auto_prepend_file
set: magic_quotes_gpc to On

go to https://<your-server>/hordesetup.php3 and config according to instructions

go to https://<your-server>/horde/imp and login

PHP3	http://www.php.net/download-php3.php
IMP 2.2	http://www.horde.org/imp/2.2/
PHPlib	http://phplib.netuse.de/download/index.php3
Apache 1.3x	http://www.apache.org/dist/
UWimap	http://www.washington.edu/imap/#Software