2
Modified: Sept 14, 2003
6
This document assumes you're running Apache, and have PHP4 (v 4.1.2 or
7
later) installed. If you are running a version of PHP earlier than 4.1.2,
8
you are STRONGLY encouraged to upgrade.
10
This document will walk you through the steps necessary to setup
11
IlohaMail with a file-based backend. It is possible to setup IlohaMail
12
with a MySQL-backend, which is highly recommended. The calendar/scheduler feature also requires a database back-end.
14
For differences between the two backends, see the FAQ available at:
15
http://ilohamail.org/docs/view.php?id=47
17
If you like IlohaMail, please consider making a donation. Donations can be made via PayPal, by clicking on the "donate" button found on ilohamail.org.
22
See the file UPGRADING for more information on updating older versions.
25
Quick and Dirty Installation
26
============================
27
This is for the impatient. You are ENCOURAGED to follow the "Proper Installation" instructions below. The "Quick and Dirty" installation should only be used for testing the product. For actual deployment, follow the proper installation instructions.
29
IF YOU CHOOSE THE "QUICK AND DIRTY" INSTALLATION, INTERNAL DATA FILES CONTAINING SENSITIVE DATA MAY BE ACCESSIBLE FROM THE PUBLIC. You have been warned.
31
Following instructions assume you're on a UNIX-based system running Apache, have shell (SSH/telnet) access as the root user (or can 'sudo'), and the document root (folder where your HTML files are) is in /usr/local/apache/htdocs. This may be different on your server.
33
1. Download and unpack the IlohaMail source release.
35
$tar xzf IlohaMail-version.tar.gz
37
2. Move (or FTP) the IlohaMail-version/IlohaMail directory to a location inside your document root.
40
$mv IlohaMail /usr/local/apache/htdocs
42
3. Give web server process read/write privileges to all folders in IlohaMail/data
44
$cd /usr/local/apache/IlohaMail
45
$chown -R apache_user data
47
HINT: See "Proper Installation" below for alternatives.
49
4. OPTIONAL: Change the name of the "IlohaMail" folder you moved in step 2 to something easier to remember like "webmail". Alternatively, create a symbolic link in your DOCUMENT_ROOT to the IlohaMail/source directory
51
$cd /usr/local/apache/htdocs
52
$ln -s IlohaMail/source webmail
54
5. Try accessing the interface with your browser. If you did step 4, the URL should be something like:
55
http://yourdomain.com/webmail/
57
Otherwise, it'll be something like:
58
http://yourdomain.com/IlohaMail/
60
6. OPTIONAL: Look in the conf/conf.inc and conf/login.inc files for various configuration options. You may also use a MySQL backend, which is recommended.
65
Following instructions assume you're on a UNIX-based system running Apache, have shell (SSH/telnet) access as root, and the document root (folder where your HTML files are) is in /usr/local/apache/htdocs. This may be different on your server.
67
If you get stuck here, try the "Quick and Dirty" installation above. The "Quick and Dirty" installation works on a wider range server configurations, but should only be used as a last resort, or temporary measure.
69
1. Download and unpack the tar ball, cd into the IlohaMail directory.
71
$tar xzf IlohaMail-version.tar.gz
75
2. Move the IlohaMail directory to any location on the hard drive.
77
$mv IlohaMail /www/IlohaMail
80
3. Tell Apache where IlohaMail is. Use ONE of the following:
82
3a. Add an "Alias" directive in your httpd.conf file, and point it to the IlohaMail/source directory.
84
Alias /webmail /usr/local/apache/IlohaMail/source
86
3b. Alternatively, you might want to setup a different domain like "webmail.yourdomain.com" just for your webmail interface. In this case, add a new VirtualHost entry in your httpd.conf file, and set the DocumentRoot to the IlohaMail/source folder.
88
3c. If you do not have access to the httpd.conf file, you may also create a symbolic link in your document root.
90
$ln -s /www/IlohaMail/source /usr/local/apache/htdocs/webmail
92
3d. If neither 3 nor 3b works, use the "Quick and Dirty" installation (instructions above).
95
4. Set backend folder permissions. Change owner to the user Apache runs as (look in httpd.conf if you're not sure, usually it's something like "nobody" or "www"):
97
$chown -R apache_user /www/IlohaMail/data
99
NOTE: Alternatively, you may change the permissions of the folders to 777. This is NOT recommended, but will work.
102
5. Check your PHP.ini file. You need:
106
6. Restart Apache, and try accessing the program. If it works, give your
107
self a pat on the back.
110
7. Edit conf/conf.inc and conf/login.inc files as necessary. Using the MySQL back-end is also recommended (see documentation insde "Docs" folder).
added
removed
INSTALL
