Installation

If you are upgrading an existing installation of IlohaMail, consult the "UPGRADING" document included in the package. Depending on the version you're running and changes made to the new version, procedures may differ significantly.

Installation from tar-ball distribution:
The following steps will install IlohaMail with the default file-based backend.

  1. Download and unpack the tar ball, cd into the IlohaMail-version directory.
    e.g.
    $tar xzf IlohaMail-version.tar.gz
    $cd IlohaMail-version

  2. Move the IlohaMail directory to any location on your hard drive. It is recommended that you place all files outside the document root, however, with version 0.7.10, it is safe to install inside the document root.
    e.g.
    $mv IlohaMail /www/IlohaMail

  3. Create a redirect using one of the following methods:
    a. If you have access to the httpd.conf file, add an "Alias" directive in your httpd.conf file, and point it to the IlohaMail/source directory.
    e.g.
    Alias /webmail /www/IlohaMail/source
    b. If you do not have access to the httpd.conf file, you can also create a symbolic link in your document root.
    e.g.(replace {$DOCUMENT_ROOT} with path to your document root.
    $ ln -s /www/IlohaMail/source {$DOCUMENT_ROOT}/webmail
    c. If all else fails, move the IlohaMail directory to inside your document root, and change it's name to something convenient (i.e "webmail"). When accessed, it will redirect users to "source/index.php".

  4. Set folder permissions:
    e.g.
    $chmod -R 733 /www/IlohaMail/data

    Note: Alternatively, you can also change the owner of the folders to the user Apache runs as (usually "www" or "nobody"), and set permissions to 700.

  5. Check PHP configuration:
    short_open_tagOn
    file_uploadsOn

  6. Restart Apache, and try accessing the program. If it works, give your self a pat on the back.

  7. It is strongly recommended that you use a database backend on large scale production environments. You also need a database backend to use all calendar features.