From iRedMail

Revision as of 01:05, 6 May 2012

If you already have iRedAdmin open source edition installed, you can migrate from iRedAdmin open source edition to iRedAdmin-Pro with just few steps:

• Migrate from iRedAdmin open source edition to iRedAdmin-Pro

Summary

• This installation guide is used to install iRedAdmin-Pro-MySQL on Gentoo Linux.
• iRedAdmin-Pro is official web-based admin panel for iRedMail. There're three editions available:
  • iRedAdmin-Pro-LDAP: works with OpenLDAP backend.
  • iRedAdmin-Pro-MySQL: works with MySQL backend.
  • iRedAdmin-Pro-PGSQL: works with PostgreSQL backend.

System requirements

• iRedMail-0.8.0 or later releases.
• iRedAdmin-Pro-MySQL-1.3.0 or later releases.

• Required Packages. They all are installed automatically during iRedMail installation.
  • Apache, 2.2+. Web server.
  • Python 2.4+, core programming language. Warning: Python 3.x is not supported yet.
  • Web.py, 0.32+. A python-powered web framework.
    • MySQLdb. A thread-compatible interface to the popular MySQL database server that provides the Python database API.

iRedAdmin will run with a low-privileged system user: iredadmin, which is created automatically during iRedMail installation, too.

Download iRedAdmin and configure Apache web server

• Get iRedAdmin:
  • If you purchased iRedAdmin-Pro-MySQL, you should already have it. If not, please mail to support@ iredmail.org to get a download link.
  • If you didn't purchase iRedAdmin-Pro-MySQL, download iRedAdmin open source edition from download page.

• Copy iRedAdmin to /var/www/, set correct file permissions, and create symbol link.

# tar xjf iRedAdmin-x.y.z.tar.bz2 -C /var/www/
# cd /var/www/
# chown -R iredadmin:iredadmin iRedAdmin-x.y.z
# chmod -R 0755 iRedAdmin-x.y.z
# ln -s iRedAdmin-x.y.z iredadmin

• Add apache configure file: /var/www/conf/modules/iredadmin.conf.

AddType text/html .py
AddHandler cgi-script .py

<Directory "${IREDADMIN_HTTPD_ROOT_SYMBOL_LINK}">
    Options +ExecCGI +FollowSymLinks
    Order allow,deny
    Allow from all

    <IfModule mod_rewrite.c>
        RewriteEngine on
        RewriteBase /
        RewriteCond %{REQUEST_FILENAME} !-f
        RewriteCond %{REQUEST_FILENAME} !-d
        RewriteCond %{REQUEST_URI} !^/favicon.ico$
        RewriteCond %{REQUEST_URI} !^(/.*)+iredadmin.py/
        RewriteRule ^(.*)$ iredadmin.py/$1 [PT]
        RewriteRule ^/(static/.*)$ /static/$1 [QSA,L,PT]
    </IfModule>
</Directory>

• Edit /etc/apache2/vhosts.d/00_default_ssl_vhost.conf, make iredadmin accessible via HTTPS. Add below lines before </VirtualHost>:

Alias /iredadmin/static /var/www/iredadmin/static
ScriptAlias /iredadmin /var/www/iredadmin/iredadmin.py

• Restart apache to enable mod_wsgi:

# /etc/rc.d/httpd restart

Create necessary MySQL database and grant privileges

• Create MySQL database: iredadmin. Used to store sessions, admin operation logs, etc.

# 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;

• Grant privileges to iredadmin user and set password for it.

WARNING: Here we use 'plain_passwd' as password of iredadmin user, please replace it with your own password.

# mysql -uroot -p
mysql> GRANT SELECT,INSERT,UPDATE,DELETE ON iredadmin.* TO iredadmin@localhost IDENTIFIED BY 'plain_passwd';
mysql> FLUSH PRIVILEGES;

Configure iRedAdmin

The major config file of iRedAdmin is file /var/www/iredadmin/settings.ini.

• Copy example config file, and set correct file permission.

# cd /var/www/iredadmin/
# cp settings.ini.mysql.sample settings.ini
# chown iredadmin:iredadmin settings.ini
# chmod 0400 settings.ini

NOTE: If you are installing iRedAdmin-Pro, and have iRedAdmin open source edition installed, you can simply copy settings.ini from open source edition. Don't forget to set correct file owner and permission after copied.

• Edit settings.ini.

NOTE:

• • All required usernames/passwords are stored in iRedMail.tips which generated during iRedMail installation, placed under iRedMail directory. e.g. /root/iRedMail-0.8.0/iRedMail.tips.
  • For more inforamtion, please open settings.ini, it's self-documented.

[general]
# General settings ...

[iredadmin]
# Database "iredadmin". required by iRedAdmin.

[vmaildb]
# Database "vmail", stored all mail accounts.

[policyd]
# Database "policyd". Required for policyd integration.

[amavisd]
# Database "amavisd". Required for Amavisd-New integration. includes spam quarantining/releasing.

• Restart apache web server.

# /etc/rc.d/httpd restart

• Open your web browser to access iRedAdmin: https://your_server_ip_address/iredadmin/
  • NOTE: Make sure you use HTTPS:// instead of HTTP://.

Troubleshooting

If iRedAdmin doesn't work as expected, you can set debug = True in settings.ini to turn on debug mode, restart apache web server, use your favourite web browser to access it again, create a new forum topic and paste error message in forum topic.

[general]
debug = True