Install/iRedAdmin-Pro/MySQL/OpenBSD - Revision history

ZhangHuangbin: /* Configure iRedAdmin */

ZhangHuangbin — Sun, 06 May 2012 03:58:23 GMT

Configure iRedAdmin

← Older revision		Revision as of 03:58, 6 May 2012
Line 84:		Line 84:
	The major config file of iRedAdmin is file '''/var/www/iredadmin/settings.ini'''.		The major config file of iRedAdmin is file '''/var/www/iredadmin/settings.ini'''.

-	* Copy example config file, and set correct file permission.	+	* Copy example config file, and set correct file owner ('''www''') and permission (0400).
	{{cmd\|<pre>		{{cmd\|<pre>
	# cd /var/www/iredadmin/		# cd /var/www/iredadmin/

ZhangHuangbin: /* Configure iRedAdmin */

ZhangHuangbin — Sun, 06 May 2012 03:57:52 GMT

Configure iRedAdmin

← Older revision		Revision as of 03:57, 6 May 2012
Line 88:		Line 88:
	# cd /var/www/iredadmin/		# cd /var/www/iredadmin/
	# cp settings.ini.mysql.sample settings.ini		# cp settings.ini.mysql.sample settings.ini
-	# chown ~~iredadmin~~:iredadmin settings.ini	+	# chown www:iredadmin settings.ini
	# chmod 0400 settings.ini		# chmod 0400 settings.ini
	</pre>}}		</pre>}}

ZhangHuangbin: /* Download iRedAdmin and configure Apache web server */

ZhangHuangbin — Sun, 06 May 2012 03:57:16 GMT

Download iRedAdmin and configure Apache web server

← Older revision		Revision as of 03:57, 6 May 2012
Line 43:		Line 43:
	AddHandler cgi-script .py		AddHandler cgi-script .py

-	<Directory "~~${IREDADMIN_HTTPD_ROOT_SYMBOL_LINK}~~">	+	<Directory "/var/www/iredadmin">
-	Options +ExecCGI ~~+FollowSymLinks~~	+	Options +ExecCGI
	Order allow,deny		Order allow,deny
	Allow from all		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>		</Directory>
	</pre>}}		</pre>}}

-	* Edit /~~etc~~/~~apache2~~/~~vhosts.d~~/~~00_default_ssl_vhost~~.conf, make iredadmin accessible via HTTPS. Add below lines before </VirtualHost>:	+	* Edit /var/www/conf/httpd.conf, make iredadmin accessible via HTTPS. Add below lines before </VirtualHost>:
-	{{cfg\|/~~etc~~/~~apache2~~/~~vhosts.d~~/~~00_default_ssl_vhost~~.conf\|<pre>	+	{{cfg\|/var/www/conf/httpd.conf\|<pre>
	Alias /iredadmin/static /var/www/iredadmin/static		Alias /iredadmin/static /var/www/iredadmin/static
	ScriptAlias /iredadmin /var/www/iredadmin/iredadmin.py		ScriptAlias /iredadmin /var/www/iredadmin/iredadmin.py

ZhangHuangbin: /* System requirements */

ZhangHuangbin — Sun, 06 May 2012 03:52:16 GMT

System requirements

← Older revision		Revision as of 03:52, 6 May 2012
Line 12:		Line 12:

	= System requirements =		= System requirements =
		+
	* iRedMail-0.8.0 or later releases.		* iRedMail-0.8.0 or later releases.
	* iRedAdmin-Pro-MySQL-1.3.0 or later releases.		* iRedAdmin-Pro-MySQL-1.3.0 or later releases.

	* Required Packages. They all are installed automatically during iRedMail installation.		* Required Packages. They all are installed automatically during iRedMail installation.
-	** '''Apache''', 2.2+. ~~Web server~~.	+	** '''Apache''' Web server. We use the built-in Apache-1.3. '''Note''': iRedAdmin doesn't work with chrooted Apache, so don't forget to add '''-u''' flag in '''httpd_flags''' in /etc/rc.conf.local. For example: {{cmd\|<pre>httpd_flags="-DSSL -u"</pre>}}
	** '''Python''' 2.4+, core programming language. Warning: Python 3.x is not supported yet.		** '''Python''' 2.4+, core programming language. Warning: Python 3.x is not supported yet.
-	** '''Web.py''', 0.32+. A python-powered web framework.	+	*** '''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.		*** '''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~~.	+	iRedAdmin will run as default Apache user '''www'''.

	= Download iRedAdmin and configure Apache web server =		= Download iRedAdmin and configure Apache web server =

ZhangHuangbin: /* Download iRedAdmin and configure Apache web server */

ZhangHuangbin — Sun, 06 May 2012 01:05:26 GMT

Download iRedAdmin and configure Apache web server

← Older revision		Revision as of 01:05, 6 May 2012
Line 37:		Line 37:
	</pre>}}		</pre>}}

-	* Add apache configure file: /var/www/conf/iredadmin.conf.	+	* Add apache configure file: /var/www/conf/modules/iredadmin.conf.
-	{{cfg\|/var/www/conf/iredadmin.conf\|<pre>	+	{{cfg\|/var/www/conf/modules/iredadmin.conf\|<pre>
	AddType text/html .py		AddType text/html .py
	AddHandler cgi-script .py		AddHandler cgi-script .py

ZhangHuangbin: Created page with 'TOC 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/iRedAdm…'

ZhangHuangbin — Sun, 06 May 2012 00:54:46 GMT

Created page with '__TOC__ 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/iRedAdm…'

New page

__TOC__

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/iRedAdmin-Pro/OSE-Pro |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 [http://www.iredmail.org/download.html#iredadmin download page].

* Copy iRedAdmin to /var/www/, set correct file permissions, and create symbol link.
{{cmd|<pre>
# 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
</pre>}}

* Add apache configure file: /var/www/conf/iredadmin.conf.
{{cfg|/var/www/conf/iredadmin.conf|<pre>
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>
</pre>}}

* Edit /etc/apache2/vhosts.d/00_default_ssl_vhost.conf, make iredadmin accessible via HTTPS. Add below lines before </VirtualHost>:
{{cfg|/etc/apache2/vhosts.d/00_default_ssl_vhost.conf|<pre>
Alias /iredadmin/static /var/www/iredadmin/static
ScriptAlias /iredadmin /var/www/iredadmin/iredadmin.py
</pre>}}

* Restart apache to enable mod_wsgi:
{{cmd|<pre>
# /etc/rc.d/httpd restart
</pre>}}

= Create necessary MySQL database and grant privileges =

* Create MySQL database: iredadmin. Used to store sessions, admin operation logs, etc.
{{cmd|<pre>
# 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;
</pre>}}

* 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.
{{cmd|<pre>
# mysql -uroot -p
mysql> GRANT SELECT,INSERT,UPDATE,DELETE ON iredadmin.* TO iredadmin@localhost IDENTIFIED BY 'plain_passwd';
mysql> FLUSH PRIVILEGES;
</pre>}}

= Configure iRedAdmin =

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

* Copy example config file, and set correct file permission.
{{cmd|<pre>
# cd /var/www/iredadmin/
# cp settings.ini.mysql.sample settings.ini
# chown iredadmin:iredadmin settings.ini
# chmod 0400 settings.ini
</pre>}}

'''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.
{{cfg|settings.ini|<pre>
[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.
</pre>}}

* Restart apache web server.
{{cmd|<pre>
# /etc/rc.d/httpd restart
</pre>}}

* 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.
{{cfg|settings.ini|<pre>
[general]
debug = True
</pre>}}

Install/iRedAdmin-Pro/MySQL/OpenBSD - Revision history

ZhangHuangbin: /* Configure iRedAdmin */

ZhangHuangbin: /* Configure iRedAdmin */

ZhangHuangbin: /* Download iRedAdmin and configure Apache web server */

ZhangHuangbin: /* System requirements */

ZhangHuangbin: /* Download iRedAdmin and configure Apache web server */

ZhangHuangbin: Created page with '__TOC__ 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/iRedAdm…'

ZhangHuangbin: Created page with 'TOC 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/iRedAdm…'