########## ELMA 0.2 Quick Installation Guide ##########

Content of this document

1.1 REQUIREMENTS

1.1.1 Debian Etch
1.2 PREPARATIONS

1.2.1 LDAP Server
1.3 INSTALLATION

-----------------------------------------------------

1.1 REQUIREMENTS

The requirements are based on the current Debian GNU/Linux stable branch also known as "Etch". ELMA has been developed and test on that distribution. If you have successfully installed and run it on any other distributions plaese send a short mail and this list will be completed.

1.1.1 Debian Etch

1.2 PREPARATIONS

1.2.1 LDAP Server

ELMA has been testet only to work with OpenLDAP Server.

Install and set up your ldap server as described in your distriubution's manual. There is an example openldap slapd.conf in the ldap subdirectory of the doc folder. First copy the elma-0.2.schema file into you LDAP server schema folder

# cp examples/ldap/elma-0.2.schema /etc/ldap/schema/

To start with an empty LDAP tree, clear your LDAP tree (refer to distriubution's manual) and run

# slapadd -l examples/ldap/example.ldif

from within the directory where this INSTALL file is located. This will create an admin user with the dn "uid=admin,ou=users,o=mybasedn" and the password "adminpass". Also an exim user ("uid=exim4,ou=users,o=mybasedn") with read only access to the LDAP will be created. The password is "exim4pass". I think it is obvious to tell you that you should change the passwords for your installation.
IMPORTANT NOTE: The above step creates the database files who's owner is "root". If you run your LDAP server under an other uid/gid, as you should if you care about security concerns, you will have to change the ownership of the LDAP database files corrosponding to the LDAP servers uid/gid.

1.3 INSTALLATION

Copy the downloaded tarball to your webserver's document root directory (e.g. /var/www).

# cp elma-0.2.tar.gz /var/www

Extract the tarball in your webserver's document root directory.

# tar -xzvf elma-0.2.tar.gz

Create the smart's template cache directory called "template_c" and make it writable for you webserver's user (e.g www-data)

# mkdir /var/www/templates_c/
# chown www-data:www-data /var/www/templates_c/ # chmod 775 /var/www/templates_c/

Now you should be able to log in to ELMA via a webbrowser using the user "admin" with password "adminpass". To change the admin's user password you have to use the ldap tools of you distribution or use something similar to "phpLdapAdmin" or "gq".