Installing IMP 2.0.x for PHP 3.0.x with Apache 1.3.x on Red Hat Linux 5.x
by Nathan Wallace
(August 11th, 1999)
This document describes how to install IMP
on Red Hat
Before we Begin
- These instructions assume that you have installed Apache, PHP and IMAP support according to my instructions.
- I created a new server name for my IMP installation:
- I needed to set up a new virtual host for the new IMP server name. You can do the same by using myimp.com and following these instructions.
- Now we have to get both HORDE and IMP.
- Installing HORDE
tar xzvf horde-latest.tar.gz
ln -s horde-1.0.10 horde
- Installing IMP
mv imp-latest.tar.gz horde
tar xzvf imp-latest.tar.gz
ln -s imp-2.0.10 imp
- First we have to build HORDE. Ignore the warning about build.opts, the current HORDE distribution has no options.
- Now we have to build IMP. I am using MySQL for the database.
- We need to create a defaults file. I'm using MySQL so I'll use the include example default file as a starting point.
cp examples/mysql.defaults.php3 defaults.php3
- Now we need to edit that defaults file to set the server names and so on. There are a number of changes to make, my changes are listed below. The first is on line 3, changing the email address that problem reports are sent to.
$default->problem_email = 'email@example.com';
Next you need to specify the name of your local machine on line 16.
$default->localhost = 'ws01.synop.com';
Then setup your IMAP server defaults on lines 19 and 20.
$default->server = 'mail.synop.com';
$default->from_server = 'synop.com';
The security on my MySQL machine is a little messed up and I can't be bothered fixing it since I'm too busy writing code. As a result I needed to remove the default password that is given to the MySQL user impmgr before things would work. It's on line 93. You probably won't need to do this:
$default->db_password = '';
One last change on line 104:
$default->signup_email = 'firstname.lastname@example.org';
- Finally we need to disable the PHP setup script (which we didn't use). This must be done for security reasons.
chmod 000 setup.php3
Setting Up the IMP Database
I'm not sure if I should set up the database for Horde at this point as well. It seemed to work even though I didn't set it up. If I'm wrong let me know...
- We need to define a few tables in the database before IMP will work properly. This is really easy since we are given a script to do it. You need to run this script as the root MySQL user.
mysql --user=rootuser --password=password <mysql_create.sql
- If you don't want to or can't create a new database on your system then you can just edit the script and change the defaults.php3 file (that we edited above) to use your prefered MySQL database and user names.
- Using IMP is now just a matter of restarting your Apache server.
- Now you can just open your browser to http://dev.myimp.com/horde/ to start using it!
- In case you panic, notice the little IMP link in the top left hand corner.
- Also, be aware that some IMP operations can be very slow if you are talking to a mail server over a modem.