Migrate/iRedAdmin-Pro/OSE-Pro

From iRedMail

(Difference between revisions)
Jump to: navigation, search
(Quarantining SPAMs and manage them with iRedAdmin-Pro)
 
(13 intermediate revisions not shown)
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 =
It's easy to migrate from iRedAdmin open source edition to iRedAdmin-Pro. Steps:
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.
* 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.
* '''[OPTIONAL]''' Enable quarantining in Amavisd and restart amavisd service.
* '''[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 =
= 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 /path/to/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
+
# 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 0755 iRedAdmin-Pro-x.y.z
+
# chmod -R 0555 iRedAdmin-Pro-x.y.z
-
# chmod -R 0640 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, Mint Linux ==
-
* For Debian/Ubuntu:
+
{{cmd|<pre>
{{cmd|<pre>
-
# tar xjf /path/to/iRedAdmin-Pro-x.y.z.tar.bz2 -C /usr/share/apache2/
+
# tar xjf /root/iRedAdmin-Pro-x.y.z.tar.bz2 -C /usr/share/apache2/
# cd /usr/share/apache2/
# cd /usr/share/apache2/
-
# rm -i /usr/share/apache2/iredadmin                # <- this is a symbol link
+
# 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.
-
# chmod -R 0755 iRedAdmin-Pro-x.y.z
+
# chmod -R 0555 iRedAdmin-Pro-x.y.z
-
# chmod -R 0640 iRedAdmin-Pro-x.y.z/settings.ini
+
# chmod -R 0400 iRedAdmin-Pro-x.y.z/settings.ini
# /etc/init.d/apache2 restart            # <- Restart apache web server
# /etc/init.d/apache2 restart            # <- Restart apache web server
</pre>}}
</pre>}}
-
 
+
== For openSUSE ==
-
* For openSUSE:
+
{{cmd|<pre>
{{cmd|<pre>
-
# tar xjf /path/to/iRedAdmin-Pro-x.y.z.tar.bz2 -C /srv/www/
+
# tar xjf /root/iRedAdmin-Pro-x.y.z.tar.bz2 -C /srv/www/
# cd /srv/www/
# cd /srv/www/
-
# rm -i /srv/www/iredadmin                # <- this is a symbol link
+
# 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.
-
# chmod -R 0755 iRedAdmin-Pro-x.y.z
+
# chmod -R 0555 iRedAdmin-Pro-x.y.z
-
# chmod -R 0640 iRedAdmin-Pro-x.y.z/settings.ini
+
# chmod -R 0400 iRedAdmin-Pro-x.y.z/settings.ini
# /etc/init.d/apache2 restart            # <- Restart apache web server
# /etc/init.d/apache2 restart            # <- Restart apache web server
</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 ==
{{cmd|<pre>
{{cmd|<pre>
-
# tar xjf /path/to/iRedAdmin-Pro-x.y.z.tar.bz2 -C /usr/local/www/
+
# tar xjf /root/iRedAdmin-Pro-x.y.z.tar.bz2 -C /usr/local/www/
# cd /usr/local/www/
# cd /usr/local/www/
-
# rm -i /usr/local/www/iredadmin                # <- this is a symbol link
+
# 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.
-
# chmod -R 0755 iRedAdmin-Pro-x.y.z
+
# chmod -R 0555 iRedAdmin-Pro-x.y.z
-
# chmod -R 0640 iRedAdmin-Pro-x.y.z/settings.ini
+
# chmod -R 0400 iRedAdmin-Pro-x.y.z/settings.ini
# /usr/local/etc/rc.d/apache2 restart          # <- Restart apache web server
# /usr/local/etc/rc.d/apache2 restart          # <- Restart apache web server
</pre>}}
</pre>}}
-
= Quarantining SPAMs and manage them with iRedAdmin-Pro =
+
== 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/
-
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.
+
# 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>}}
 +
 
 +
= Quarantining SPAMs and manage them with iRedAdmin-Pro =
-
iRedMail-0.7.0 has quarantining related settings pre-configured, but users can't manage quarantined mails, so quarantining is disabled by default.
+
Note: This step is '''REQUIRED''' if you want to quarantine spam, virus into SQL (MySQL or PostgreSQL) database, then delete or release them with iRedAdmin-Pro.
-
Since iRedAdmin-Pro supports releasing and deleting quarantined mails, you can easily enable quarantining with below tutorial. (Don't worry, it's easy enough.)
+
Since iRedMail-0.7.0, quarantining related settings are configured but disabled by default, you can easily enable quarantining with below tutorial. (Don't worry, it's easy enough.)
-
* [[IRedMail/FAQ/Quarantining.SPAM |Quarantining VIRUS and SPAM into MySQL database]]
+
* [[IRedMail/FAQ/Quarantining.SPAM |Quarantining VIRUS and SPAM into SQL database]]
= Troubleshooting =
= Troubleshooting =
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/

Current revision as of 15:20, 6 September 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 Linux

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 REQUIRED if you want to quarantine spam, virus into SQL (MySQL or PostgreSQL) database, then delete or release them with iRedAdmin-Pro.

Since iRedMail-0.7.0, quarantining related settings are configured but disabled by default, 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