//here is a copy of the procedure://
Setting up web-based e-mail on e-smith 4.0
First, this is tested only with e-smith 4.0 final. It will probably work with some of the later
betas, but it hasn't been tested.
You'll need several files that I've put up here. Here's the breakdown:
MySQL 3.22.32
MySQL-3.22.32-1.i386.rpm is the MySQL server. IMP, the webmail system, uses
MySQL to store its address book and preferences.
MySQL-client-3.22.32-1.i386.rpm is a collection of client programs for MySQL.
This is needed to properly set up IMP.
MySQL-shared-3.22.32-1.i386.rpm contains the MySQL shared library. It is needed for PHP
to interface with MySQL.
e-smith-mysql-1.0.0-1.noarch.rpm integrates MySQL into the e-smith system.
PHP 4.0.1pl2
Required files
These files must be installed for PHP to work properly with IMP and e-smith 4.0.
php-4.0.1pl2-3.i386.rpm is the core file for the PHP Hypertext Preprocessor. PHP
is a scripting language which is used to run IMP.
mod_php-4.0.1pl2-3.i386.rpm is the PHP module for your web server. This allows
your web server touse PHP.
mod_php-imap-4.0.1pl2-3.i386.rpm is a PHP module which interfaces with IMAP.
This is needed to connect to the mail server.
e-smith-php4-4.0.0-3.noarch.rpm reconfigures the Apache configuration files on
the e-smith system to support PHP 4.0.0
Optional files
These files are not all required.
mod_php-ldap-4.0.1pl2-3.i386.rpm is a PHP module which interfaces with LDAP. You
can run IMP without this, but since e-smith includes LDAP anyway, you might as well install it.
mod_php-mysql-4.0.1pl2-3.i386.rpm is a PHP module which interfaces with MySQL.
You need this if you're going to use MySQL as your databse system. If you're following the directions on this page step-by-step, you need this file.
mod_php-pgsql-4.0.1pl2-3.i386.rpm if a PHP module which interfaces with
PostgreSQL. You can use this instead of MySQL if you really want to, but some of the setup scripts only work with MySQL. This file will not work if you do not have PostgreSQL installed.
php-4.0.1pl2-3.src.rpm is not necessary to use IMP, but may be useful for others
who want to see how the PHP RPMs were built.
e-smith-php4-4.0.0-3.src.rpm is not needed to run IMP, but may be of interest to
see how the e-smith-php4 RPM was built.
Horde & IMP
horde-1.2.0-1esmith2.noarch.rpm is the horde system, and provides a framework in
which the mail system can operate. The source RPM is here. The source isn't needed, but it may be of interest.
horde-mysql-1.2.0-1esmith2.noarch.rpm configures horde to use MySQL for session
management, preferences, and contacts. Install this file if you've installed MySQL as suggested above.
horde-pgsql-1.2.0-1esmith2.noarch.rpm configures horde to use PostgreSQL for
session management, preferences, and contacts. Install this file if you're using PostgreSQL instead of MySQL.
imp-2.2.0-1esmith1.noarch.rpm is IMP, which provides the webmail system. The
source RPM is here.
Once you have all the files you need, here's how to install everything.
Install MySQL:
[root@e-smith /root]# rpm -Uvh MySQL* e-smith-mysql*
Once you've installed MySQL, it's a very good idea to change the root password:
[root@e-smith /root]# mysqladmin -u root password mynewpassword
Now, install PHP:
[root@e-smith /root]# rpm -Uvh php* mod_php* e-smith-php*
Once PHP is installed, you can install horde:
[root@e-smith /root]# rpm -Uvh horde-1.2.0-1esmith2.noarch.rpm horde-mysql-1.2.0-1esmith2.noarch.rpm
Following the instructions on the screen, you should now create the database information to use horde correctly:
[root@e-smith /root]# cd /home/e-smith/files/primary/html/horde
[root@e-smith horde]# mysql -p < scripts/database/mysql_create.sql
Enter password: [type the password here]
[root@e-smith horde]# mysqladmin -p reload
Enter password: [type the password here]
And the last one to be installed is IMP:
[root@e-smith /root]# rpm -Uvh imp-2.2.0-1esmith1.noarch.rpm
After you've installed IMP, you need to configure it properly:
[root@e-smith /root]# cd /home/e-smith/files/primary/html/horde
[root@e-smith horde]# sh install.sh
Your blank configuration files have been created, please go to
the configuration utitlity at :
your install path url/setup.php3
After this step, browse to
http://your.server.name/horde/setup.php3 and complete the configuration wizard. If you have any questions about the configuration wizard, check out the page I made to explain it. Then secure the system:
[root@e-smith horde]# sh secure.sh
I have made your configuration files, and libraries mode 0444
which is read for everyone.
And the setup.php3 is mode 0000 which is no access period.
[root@e-smith horde]# sh scripts/database/dbpasswd.sh
Notes
If you're upgrading to Horde 1.2.0 / IMP 2.2.0 from the -pre13 RPMs posted earlier, you'll need to add the --force command to RPM: "rpm -Uvh --force filename". This is because RPM thinks that 1.2.0_pre13 is a later version
than 1.2.0. Also, if you're upgrading, you'll still need to run the dbpasswd.sh script. When you're running the setup wizard, enter the previous password, and then run dbpasswd.sh as noted above.
Credits
Of course, this wouldn't be possible without e-smith or the folks with the Horde project. The horde and imp RPMs rely heavily on the work of Brent Nordquist (I took his .spec files and hacked them did not, in fact, write any of
the software I've posted here. All I've done is package it to work, more or less, within the e-smith system.