4.3 KiB

Raw Blame History

Install iRedAdmin on OpenBSD

[TOC]

This tutorial is used to install iRedAdmin from scratch, running under Apache web server.

If you already have iRedAdmin open source edition or old iRedAdmin-Pro release installed, you can simply migrate it to the latest iRedAdmin by follow our short tutorial: Migrate or upgrade iRedAdmin.

NOTE: This tutorial must be rewritten to use Nginx as web server since OpenBSD 5.6 removes Apache-1.3 in base system, and Nginx will be removed since OpenBSD 5.7.

Requirements

iRedMail will install all required packages for you, you don't need to install them manually, below info just for your reference.

The latest iRedMail release. Download the latest iRedMail. NOTE: You must have iRedMail installed on server first.
Apache 1.3+, the built-in Apache web server in base system.
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. Required if you store mail accounts in OpenLDAP, MySQL or MariaDB.
- Python-LDAP 2.3.7+: An object-oriented API to access LDAP directory servers from Python programs. Required if you store mail accounts in OpenLDAP.
- Python-psycopg2: interface to the PostgreSQL database server from Python programs. Required if you store mail accounts in PostgreSQL.

Download iRedAdmin and configure Apache web server

Download iRedAdmin open source edition here. If you're trying to install iRedAdmin-Pro, please contact us to get download link of iRedAdmin-Pro.
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 0555 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 /var/www/iredadmin/>
    Options +ExecCGI
    Order deny,allow
    Allow from all
</Directory>

Edit /var/www/conf/httpd.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 required MySQL database and grant privileges

Create MySQL database: iredadmin.

# 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 'secret_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 'secret_passwd';
mysql> FLUSH PRIVILEGES;

Configure iRedAdmin

Copy sample config file, and make it not world-writeable.
- settings.py.ldap.sample: sample config file for OpenLDAP backend
- settings.py.mysql.sample: sample config file for MySQL/MariaDB backend
- settings.py.pgsql.sample: sample config file for PostgreSQL backend

# cd /var/www/iredadmin/
# cp settings.py.[backend].sample settings.py
# chown iredadmin:iredadmin settings.py
# chmod 0400 settings.py

Update settings.py with correct values. Please read settings.py for more information, it's self-documented.
Restart apache web server.

# /etc/rc.d/httpd restart

Access iRedAdmin

Open your web browser to access iRedAdmin: httpS://your_server_ip_address/iredadmin/

Make sure you use HTTPS:// instead of HTTP://.

Troubleshooting & Debug

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

4.3 KiB Raw Blame History