iredadmin-ose / docs / INSTALL.debian

*) Overview

Required components:
    - Apache (2.2+)
    - mod_wsgi (2.1+)
    - Python (2.4+)
    - webpy (0.32)
    - MySQL-python
    - python-ldap

*) Installation

    - Install python related modules and packages: 

        # ---- Install development files ---
        $ sudo apt-get install gcc python-setuptools python-dev libldap2-dev libmysqlclient15-dev libsasl2-dev libssl-dev libapache2-mod-wsgi

        # ---- Install python packages ----
        $ sudo easy_install Jinja2 python-ldap MySQL-python

        # ---- Enable wsgi module in apache.
        $ sudo a2enmod mod-wsgi

*) Setup

    - Copy iRedAdmin to apache document root /usr/share/apache2/:

        $ tar xjf iRedAdmin-x.y.z.tar.bz2
        $ sudo mv iRedAdmin-x.y.z /usr/share/apache2/
        $ cd /usr/share/apache2/
        $ sudo chown -R root:root iRedAdmin-x.y.z
        $ sudo chmod -R 0755 iRedAdmin-x.y.z
        $ sudo ln -s iRedAdmin-x.y.z iRedAdmin

    - Add apache configure file: /etc/apache2/conf.d/iredadmin.conf.

        # ----
        WSGIScriptAlias /iredadmin /usr/share/apache2/iRedAdmin/

        Alias /iredadmin/static /usr/share/apache2/iRedAdmin/static/
        AddType text/html .py

        <Directory /usr/share/apache2/iRedAdmin/>
            Order deny,allow
            Allow from all
        # ----

      Restart apache to enable it:

        $ sudo /etc/init.d/apache2 restart

    - Create MySQL database:

        $ mysql -uroot -p
        mysql> CREATE DATABASE iredadmin DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci;
        mysql> USE iredadmin;
        mysql> SOURCE /var/www/iRedAdmin/docs/samples/iredadmin.sql;

      Add MySQL user and grant privileges:

        mysql> GRANT SELECT,INSERT,UPDATE,DELETE ON iredadmin.* TO iredadmin@localhost IDENTIFIED BY 'secret_passwd';
        mysql> FLUSH PRIVILEGES;

*) Configuration:

    - Copy example config file:

        $ cd /usr/share/apache2/iRedAdmin-x.y.z/config/
        $ cp settings.ini.sample settings.ini

    - Edit settings.ini and set several variables:

        admin =
        debug = False
        lang = en_US
        backend = ldap
        storage_base_directory = /var/vmail/vmail01

        dbn = mysql
        host = localhost
        port = 3306
        db = iredadmin
        user = iredadmin
        passwd = secret_passwd
        db_table_session = sessions

        uri = ldap://
        suffix = dc=iredmail,dc=org
        basedn = o=domains,dc=iredmail,dc=org
        domainadmin_dn = o=domainAdmins,dc=iredmail,dc=org
        bind_dn = cn=vmailadmin,dc=iredmail,dc=org
        bind_pw = passwd

*) Visit below url in your web browser for test:

Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.