Migrate/iRedAdmin-Pro/OSE-Pro

From iRedMail

(Difference between revisions)
Jump to: navigation, search
(Uncompress iRedAdmin-Pro, copy config file, set correct file permission, restart apache)
Line 1: Line 1:
__TOC__
__TOC__
-
This tutorial explains how to migrate iRedAdmin open source edition (v0.1.4 and later versions) to iRedAdmin-Pro (full-featured edition).
+
This tutorial explains how to migrate iRedAdmin open source edition (v0.1.7 and later versions) to iRedAdmin-Pro (full-featured edition).
If it doesn't work for you, please post a new topic in our forum: http://www.iredmail.org/forum/
If it doesn't work for you, please post a new topic in our forum: http://www.iredmail.org/forum/
Some notes:
Some notes:
-
* It works with both iRedAdmin-Pro-MySQL and iRedAdmin-Pro-LDAP.
+
* It works with both iRedAdmin-Pro-LDAP, iRedAdmin-Pro-MySQL and iRedAdmin-Pro-PGSQL.
-
* Please replace 'iRedAdmin-Pro-x.y.z' below with your real edition and version numbers. e.g. iRedAdmin-Pro-MySQL-1.2.1, or iRedAdmin-Pro-LDAP-1.6.1.
+
* Please replace 'iRedAdmin-Pro-x.y.z' below with your real edition and version numbers. e.g. iRedAdmin-Pro-MySQL-1.3.1, iRedAdmin-Pro-LDAP-1.6.3.
= Requirements and Notes =
= Requirements and Notes =
-
* This tutorial is applicable to '''iRedMail-0.7.0''' and later versions. If you're using iRedMail-0.6.1 or earlier versions, please refer to [[Migrate/iRedAdmin-Pro/OSE-Pro/0.6.1 |this tutorial]].
+
* This tutorial is applicable to '''iRedMail-0.8.0''' and later versions. If you're using iRedMail-0.7.4 or earlier versions, please refer to [[Migrate/iRedAdmin-Pro/OSE-Pro/0.7.4 |this tutorial]].
* You '''MUST''' select to install iRedAdmin open source edition during iRedMail installation.
* You '''MUST''' select to install iRedAdmin open source edition during iRedMail installation.
-
* This tutorial works for both iRedAdmin-Pro-LDAP and iRedAdmin-Pro-MySQL.
 
= Summary =
= Summary =
Line 20: Line 19:
* Upload or copy iRedAdmin-Pro to your server which has iRedMail running. We assume you uploaded it to /root/iRedAdmin-Pro-xxx.tar.bz2.
* Upload or copy iRedAdmin-Pro to your server which has iRedMail running. We assume you uploaded it to /root/iRedAdmin-Pro-xxx.tar.bz2.
* Uncompress iRedAdmin-Pro to apache server root directory.
* Uncompress iRedAdmin-Pro to apache server root directory.
-
* Copy config file from open source edition. We assume you're using iRedAdmin-0.1.4 (open source edition) in this tutorial, it's shipped in iRedMail-0.7.0.
+
* Copy config file from open source edition. We assume you're using iRedAdmin-0.1.7 (open source edition) in this tutorial, it's shipped in iRedMail-0.8.0.
* Set correct file permission for iRedAdmin-Pro.
* Set correct file permission for iRedAdmin-Pro.
* Restart apache web server.
* Restart apache web server.
Line 27: Line 26:
= Upload or copy iRedAdmin-Pro to your server =
= Upload or copy iRedAdmin-Pro to your server =
-
Upload or copy iRedAdmin-Pro to your server which has iRedMail running. We assume you uploaded it to /root/iRedAdmin-Pro-LDAP-x.y.z.tar.bz2 or /root/iRedAdmin-Pro-MySQL-x.y.z.tar.bz2.
+
Upload or copy iRedAdmin-Pro to your server which has iRedMail running. We assume you uploaded it to /root/iRedAdmin-Pro-LDAP-x.y.z.tar.bz2 or /root/iRedAdmin-Pro-MySQL-x.y.z.tar.bz2, or /root/iRedAdmin-Pro-PGSQL-x.y.z.tar.bz2.
 +
 
 +
We will use iRedAdmin-Pro-x.y.z below, please replace x.y.z by the real file name, e.g. iRedAdmin-Pro-LDAP-1.6.3.tar.bz2, etc.
= Uncompress iRedAdmin-Pro, copy config file, set correct file permission, restart apache =
= Uncompress iRedAdmin-Pro, copy config file, set correct file permission, restart apache =
-
* For RHEL/CentOS:
+
 
 +
* For Red Hat Enterprise Linux, CentOS, Scientific Linux:
{{cmd|<pre>
{{cmd|<pre>
# tar xjf /root/iRedAdmin-Pro-x.y.z.tar.bz2 -C /var/www/
# tar xjf /root/iRedAdmin-Pro-x.y.z.tar.bz2 -C /var/www/
# cd /var/www/
# cd /var/www/
-
# rm -i /var/www/iredadmin                 # <- this is a symbol link, it will prompt you to type 'y' to confirm.
+
# rm -i /var/www/iredadmin   # <- this is a symbol link, it will prompt you to type 'y' to confirm.
# ln -s iRedAdmin-Pro-x.y.z iredadmin
# ln -s iRedAdmin-Pro-x.y.z iredadmin
-
# cp -p iRedAdmin-0.1.4/settings.ini iRedAdmin-Pro-x.y.z/
+
# cp -p iRedAdmin-0.1.7/settings.ini iRedAdmin-Pro-x.y.z/
-
# chown -R iredadmin:iredadmin iRedAdmin-Pro-x.y.z/             # <- Set correct file permission for iRedAdmin-Pro.
+
# chown -R iredadmin:iredadmin iRedAdmin-Pro-x.y.z/   # <- Set correct file permission for iRedAdmin-Pro.
# chmod -R 0555 iRedAdmin-Pro-x.y.z
# chmod -R 0555 iRedAdmin-Pro-x.y.z
# chmod -R 0400 iRedAdmin-Pro-x.y.z/settings.ini
# chmod -R 0400 iRedAdmin-Pro-x.y.z/settings.ini
-
# /etc/init.d/httpd restart           # <- Restart apache web server
+
# /etc/init.d/httpd restart   # <- Restart apache web server
</pre>}}
</pre>}}
-
* For Debian/Ubuntu:
+
* For Debian, Ubuntu, Mint:
{{cmd|<pre>
{{cmd|<pre>
Line 53: Line 55:
# rm -i /usr/share/apache2/iredadmin                # <- this is a symbol link, it will prompt you to type 'y' to confirm.
# rm -i /usr/share/apache2/iredadmin                # <- this is a symbol link, it will prompt you to type 'y' to confirm.
# ln -s iRedAdmin-Pro-x.y.z iredadmin
# ln -s iRedAdmin-Pro-x.y.z iredadmin
-
# cp -p iRedAdmin-0.1.4/settings.ini iRedAdmin-Pro-x.y.z/
+
# cp -p iRedAdmin-0.1.7/settings.ini iRedAdmin-Pro-x.y.z/
# chown -R iredadmin:iredadmin iRedAdmin-Pro-x.y.z/              # <- Set correct file permission for iRedAdmin-Pro.
# chown -R iredadmin:iredadmin iRedAdmin-Pro-x.y.z/              # <- Set correct file permission for iRedAdmin-Pro.
Line 61: Line 63:
# /etc/init.d/apache2 restart            # <- Restart apache web server
# /etc/init.d/apache2 restart            # <- Restart apache web server
</pre>}}
</pre>}}
-
 
* For openSUSE:
* For openSUSE:
Line 69: Line 70:
# rm -i /srv/www/iredadmin                # <- this is a symbol link, it will prompt you to type 'y' to confirm.
# rm -i /srv/www/iredadmin                # <- this is a symbol link, it will prompt you to type 'y' to confirm.
# ln -s iRedAdmin-Pro-x.y.z iredadmin
# ln -s iRedAdmin-Pro-x.y.z iredadmin
-
# cp -p iRedAdmin-0.1.4/settings.ini iRedAdmin-Pro-x.y.z/
+
# cp -p iRedAdmin-0.1.7/settings.ini iRedAdmin-Pro-x.y.z/
# chown -R iredadmin:iredadmin iRedAdmin-Pro-x.y.z/              # <- Set correct file permission for iRedAdmin-Pro.
# chown -R iredadmin:iredadmin iRedAdmin-Pro-x.y.z/              # <- Set correct file permission for iRedAdmin-Pro.
Line 78: Line 79:
</pre>}}
</pre>}}
 +
* For Gentoo Linux:
 +
{{cmd|<pre>
 +
# tar xjf /root/iRedAdmin-Pro-x.y.z.tar.bz2 -C /var/www/
 +
# cd /var/www/
 +
# rm -i /var/www/iredadmin                # <- this is a symbol link, it will prompt you to type 'y' to confirm.
 +
# ln -s iRedAdmin-Pro-x.y.z iredadmin
 +
# cp -p iRedAdmin-0.1.7/settings.ini iRedAdmin-Pro-x.y.z/
 +
 +
# chown -R iredadmin:iredadmin iRedAdmin-Pro-x.y.z/              # <- Set correct file permission for iRedAdmin-Pro.
 +
# chmod -R 0555 iRedAdmin-Pro-x.y.z
 +
# chmod -R 0400 iRedAdmin-Pro-x.y.z/settings.ini
 +
 +
# /etc/init.d/apache2 restart            # <- Restart apache web server
 +
</pre>}}
* For FreeBSD:
* For FreeBSD:
Line 85: Line 100:
# rm -i /usr/local/www/iredadmin                # <- this is a symbol link, it will prompt you to type 'y' to confirm.
# rm -i /usr/local/www/iredadmin                # <- this is a symbol link, it will prompt you to type 'y' to confirm.
# ln -s iRedAdmin-Pro-x.y.z iredadmin
# ln -s iRedAdmin-Pro-x.y.z iredadmin
-
# cp -p iRedAdmin-0.1.4/settings.ini iRedAdmin-Pro-x.y.z/
+
# cp -p iRedAdmin-0.1.7/settings.ini iRedAdmin-Pro-x.y.z/
# chown -R iredadmin:iredadmin iRedAdmin-Pro-x.y.z/              # <- Set correct file permission for iRedAdmin-Pro.
# chown -R iredadmin:iredadmin iRedAdmin-Pro-x.y.z/              # <- Set correct file permission for iRedAdmin-Pro.
Line 92: Line 107:
# /usr/local/etc/rc.d/apache2 restart          # <- Restart apache web server
# /usr/local/etc/rc.d/apache2 restart          # <- Restart apache web server
 +
</pre>}}
 +
 +
* For OpenBSD:
 +
{{cmd|<pre>
 +
# tar xjf /root/iRedAdmin-Pro-x.y.z.tar.bz2 -C /var/www/
 +
# cd /var/www/
 +
# rm -i /var/www/iredadmin                # <- this is a symbol link, it will prompt you to type 'y' to confirm.
 +
# ln -s iRedAdmin-Pro-x.y.z iredadmin
 +
# cp -p iRedAdmin-0.1.7/settings.ini iRedAdmin-Pro-x.y.z/
 +
 +
# chown -R iredadmin:iredadmin iRedAdmin-Pro-x.y.z/              # <- Set correct file permission for iRedAdmin-Pro.
 +
# chmod -R 0555 iRedAdmin-Pro-x.y.z
 +
# chown www:iredadmin iRedAdmin-Pro-x.y.z/settings.ini
 +
# chmod -R 0400 iRedAdmin-Pro-x.y.z/settings.ini
 +
 +
# /etc/rc.d/httpd restart            # <- Restart apache web server
</pre>}}
</pre>}}

Revision as of 04:54, 6 May 2012

Contents


This tutorial explains how to migrate iRedAdmin open source edition (v0.1.7 and later versions) to iRedAdmin-Pro (full-featured edition).

If it doesn't work for you, please post a new topic in our forum: http://www.iredmail.org/forum/

Some notes:

  • It works with both iRedAdmin-Pro-LDAP, iRedAdmin-Pro-MySQL and iRedAdmin-Pro-PGSQL.
  • Please replace 'iRedAdmin-Pro-x.y.z' below with your real edition and version numbers. e.g. iRedAdmin-Pro-MySQL-1.3.1, iRedAdmin-Pro-LDAP-1.6.3.

Requirements and Notes

  • This tutorial is applicable to iRedMail-0.8.0 and later versions. If you're using iRedMail-0.7.4 or earlier versions, please refer to this tutorial.
  • You MUST select to install iRedAdmin open source edition during iRedMail installation.

Summary

It's easy to migrate from iRedAdmin open source edition to iRedAdmin-Pro. Steps:

  • Upload or copy iRedAdmin-Pro to your server which has iRedMail running. We assume you uploaded it to /root/iRedAdmin-Pro-xxx.tar.bz2.
  • Uncompress iRedAdmin-Pro to apache server root directory.
  • Copy config file from open source edition. We assume you're using iRedAdmin-0.1.7 (open source edition) in this tutorial, it's shipped in iRedMail-0.8.0.
  • Set correct file permission for iRedAdmin-Pro.
  • Restart apache web server.
  • [OPTIONAL] Enable quarantining in Amavisd and restart amavisd service.

Upload or copy iRedAdmin-Pro to your server

Upload or copy iRedAdmin-Pro to your server which has iRedMail running. We assume you uploaded it to /root/iRedAdmin-Pro-LDAP-x.y.z.tar.bz2 or /root/iRedAdmin-Pro-MySQL-x.y.z.tar.bz2, or /root/iRedAdmin-Pro-PGSQL-x.y.z.tar.bz2.

We will use iRedAdmin-Pro-x.y.z below, please replace x.y.z by the real file name, e.g. iRedAdmin-Pro-LDAP-1.6.3.tar.bz2, etc.

Uncompress iRedAdmin-Pro, copy config file, set correct file permission, restart apache

  • For Red Hat Enterprise Linux, CentOS, Scientific Linux:
Terminal:
# tar xjf /root/iRedAdmin-Pro-x.y.z.tar.bz2 -C /var/www/
# cd /var/www/
# rm -i /var/www/iredadmin    # <- this is a symbol link, it will prompt you to type 'y' to confirm.
# ln -s iRedAdmin-Pro-x.y.z iredadmin
# cp -p iRedAdmin-0.1.7/settings.ini iRedAdmin-Pro-x.y.z/

# chown -R iredadmin:iredadmin iRedAdmin-Pro-x.y.z/    # <- Set correct file permission for iRedAdmin-Pro.
# chmod -R 0555 iRedAdmin-Pro-x.y.z
# chmod -R 0400 iRedAdmin-Pro-x.y.z/settings.ini

# /etc/init.d/httpd restart    # <- Restart apache web server
  • For Debian, Ubuntu, Mint:
Terminal:
# tar xjf /root/iRedAdmin-Pro-x.y.z.tar.bz2 -C /usr/share/apache2/
# cd /usr/share/apache2/
# rm -i /usr/share/apache2/iredadmin                 # <- this is a symbol link, it will prompt you to type 'y' to confirm.
# ln -s iRedAdmin-Pro-x.y.z iredadmin
# cp -p iRedAdmin-0.1.7/settings.ini iRedAdmin-Pro-x.y.z/

# chown -R iredadmin:iredadmin iRedAdmin-Pro-x.y.z/              # <- Set correct file permission for iRedAdmin-Pro.
# chmod -R 0555 iRedAdmin-Pro-x.y.z
# chmod -R 0400 iRedAdmin-Pro-x.y.z/settings.ini

# /etc/init.d/apache2 restart            # <- Restart apache web server
  • For openSUSE:
Terminal:
# tar xjf /root/iRedAdmin-Pro-x.y.z.tar.bz2 -C /srv/www/
# cd /srv/www/
# rm -i /srv/www/iredadmin                 # <- this is a symbol link, it will prompt you to type 'y' to confirm.
# ln -s iRedAdmin-Pro-x.y.z iredadmin
# cp -p iRedAdmin-0.1.7/settings.ini iRedAdmin-Pro-x.y.z/

# chown -R iredadmin:iredadmin iRedAdmin-Pro-x.y.z/              # <- Set correct file permission for iRedAdmin-Pro.
# chmod -R 0555 iRedAdmin-Pro-x.y.z
# chmod -R 0400 iRedAdmin-Pro-x.y.z/settings.ini

# /etc/init.d/apache2 restart            # <- Restart apache web server
  • For Gentoo Linux:
Terminal:
# tar xjf /root/iRedAdmin-Pro-x.y.z.tar.bz2 -C /var/www/
# cd /var/www/
# rm -i /var/www/iredadmin                 # <- this is a symbol link, it will prompt you to type 'y' to confirm.
# ln -s iRedAdmin-Pro-x.y.z iredadmin
# cp -p iRedAdmin-0.1.7/settings.ini iRedAdmin-Pro-x.y.z/

# chown -R iredadmin:iredadmin iRedAdmin-Pro-x.y.z/              # <- Set correct file permission for iRedAdmin-Pro.
# chmod -R 0555 iRedAdmin-Pro-x.y.z
# chmod -R 0400 iRedAdmin-Pro-x.y.z/settings.ini

# /etc/init.d/apache2 restart            # <- Restart apache web server
  • For FreeBSD:
Terminal:
# tar xjf /root/iRedAdmin-Pro-x.y.z.tar.bz2 -C /usr/local/www/
# cd /usr/local/www/
# rm -i /usr/local/www/iredadmin                 # <- this is a symbol link, it will prompt you to type 'y' to confirm.
# ln -s iRedAdmin-Pro-x.y.z iredadmin
# cp -p iRedAdmin-0.1.7/settings.ini iRedAdmin-Pro-x.y.z/

# chown -R iredadmin:iredadmin iRedAdmin-Pro-x.y.z/              # <- Set correct file permission for iRedAdmin-Pro.
# chmod -R 0555 iRedAdmin-Pro-x.y.z
# chmod -R 0400 iRedAdmin-Pro-x.y.z/settings.ini

# /usr/local/etc/rc.d/apache2 restart          # <- Restart apache web server
  • For OpenBSD:
Terminal:
# tar xjf /root/iRedAdmin-Pro-x.y.z.tar.bz2 -C /var/www/
# cd /var/www/
# rm -i /var/www/iredadmin                 # <- this is a symbol link, it will prompt you to type 'y' to confirm.
# ln -s iRedAdmin-Pro-x.y.z iredadmin
# cp -p iRedAdmin-0.1.7/settings.ini iRedAdmin-Pro-x.y.z/

# chown -R iredadmin:iredadmin iRedAdmin-Pro-x.y.z/              # <- Set correct file permission for iRedAdmin-Pro.
# chmod -R 0555 iRedAdmin-Pro-x.y.z
# chown www:iredadmin iRedAdmin-Pro-x.y.z/settings.ini
# chmod -R 0400 iRedAdmin-Pro-x.y.z/settings.ini

# /etc/rc.d/httpd restart            # <- Restart apache web server

Quarantining SPAMs and manage them with iRedAdmin-Pro

Note: This step is OPTIONAL. You can apply it if you want to quarantine SPAM mails into MySQL database, then delete or release them with iRedAdmin-Pro.

iRedMail-0.7.0 has quarantining related settings pre-configured, but users can't manage quarantined mails without iRedAdmin-Pro, so quarantining is disabled by default.

Since iRedAdmin-Pro supports releasing and deleting quarantined mails, you can easily enable quarantining with below tutorial. (Don't worry, it's easy enough.)

Troubleshooting

If it doesn't work for you, please post a new topic in our forum: http://www.iredmail.org/forum/

Personal tools