Migrate/iRedAdmin-Pro/OSE-Pro

From iRedMail

(Difference between revisions)
Jump to: navigation, search
(Quarantining SPAMs and manage them with iRedAdmin-Pro)
 
(32 intermediate revisions not shown)
Line 1: Line 1:
__TOC__
__TOC__
-
This tutorial explains how to migrate iRedAdmin open source edition (v0.1.4) 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/
+
This tutorial explains how to migrate iRedAdmin open source edition (v0.1.7 and later versions) to iRedAdmin-Pro (full-featured edition).
-
'''Note''':
+
If it doesn't work for you, please post a new topic in our forum: http://www.iredmail.org/forum/
-
* 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]].
+
Some notes:
-
* This tutorial works for both iRedAdmin-Pro-LDAP and iRedAdmin-Pro-MySQL.
+
* 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 [[Migrate/iRedAdmin-Pro/OSE-Pro/0.7.4 |this tutorial]].
 +
* You '''MUST''' select to install iRedAdmin open source edition during iRedMail installation.
= Summary =
= Summary =
-
iRedMail ships iRedAdmin open source edition since iRedMail-0.5.1, it's easy to migrate from open source edition to iRedAdmin-Pro. 5 steps:
+
It's easy to migrate from iRedAdmin open source edition to iRedAdmin-Pro. Steps:
-
* Uncompress iRedAdmin-Pro to apache document root
+
* Upload or copy iRedAdmin-Pro to your server which has iRedMail running. We assume you uploaded it to /root/iRedAdmin-Pro-xxx.tar.bz2.
-
* 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.
+
* 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.
* Set correct file permission for iRedAdmin-Pro.
* Restart apache web server.
* 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 ==
-
= Uncompress iRedAdmin-Pro to apache document root =
 
{{cmd|<pre>
{{cmd|<pre>
-
# ---- RHEL/CentOS ----
+
# tar xjf /root/iRedAdmin-Pro-x.y.z.tar.bz2 -C /var/www/
-
# tar xjf /path/to/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 iRedMail-0.1.4/settings.ini iredadmin/      # <- Copy config file from open source edition.
+
# cp -p iRedAdmin-0.1.7/settings.ini iRedAdmin-Pro-x.y.z/
-
# ---- Debian/Ubuntu ----
+
# chown -R iredadmin:iredadmin iRedAdmin-Pro-x.y.z/   # <- Set correct file permission for iRedAdmin-Pro.
-
# tar xjf /path/to/iRedAdmin-Pro-x.y.z.tar.bz2 -C /usr/share/apache2/
+
# 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
 +
</pre>}}
 +
 
 +
== For Debian, Ubuntu, Mint Linux ==
 +
 
 +
{{cmd|<pre>
 +
# 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 iRedMail-0.1.4/settings.ini iredadmin/      # <- Copy config file from open source edition.
+
# cp -p iRedAdmin-0.1.7/settings.ini iRedAdmin-Pro-x.y.z/
-
# ---- OpenSuSE ----
+
# chown -R iredadmin:iredadmin iRedAdmin-Pro-x.y.z/              # <- Set correct file permission for iRedAdmin-Pro.
-
# tar xjf /path/to/iRedAdmin-Pro-x.y.z.tar.bz2 -C /srv/www/
+
# 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 openSUSE ==
 +
{{cmd|<pre>
 +
# 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 iRedMail-0.1.4/settings.ini iredadmin/      # <- Copy config file from open source edition.
+
# cp -p iRedAdmin-0.1.7/settings.ini iRedAdmin-Pro-x.y.z/
-
# ---- FreeBSD ----
+
# chown -R iredadmin:iredadmin iRedAdmin-Pro-x.y.z/              # <- Set correct file permission for iRedAdmin-Pro.
-
# tar xjf /path/to/iRedAdmin-Pro-x.y.z.tar.bz2 -C /usr/local/www/
+
# chmod -R 0555 iRedAdmin-Pro-x.y.z
-
# cd /usr/local/www/
+
# chmod -R 0400 iRedAdmin-Pro-x.y.z/settings.ini
-
# rm -i /usr/local/www/iredadmin                # <- this is a symbol link
+
 
 +
# /etc/init.d/apache2 restart            # <- Restart apache web server
 +
</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
# ln -s iRedAdmin-Pro-x.y.z iredadmin
-
# cp iRedMail-0.1.4/settings.ini iredadmin/       # <- Copy config file from open source edition.
+
# 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>}}
</pre>}}
-
Set correct file permission:
+
== For FreeBSD ==
{{cmd|<pre>
{{cmd|<pre>
-
# chown -R iredadmin:iredadmin iredadmin             # <- openSUSE should use: chown -R iredadmin iredadmin
+
# tar xjf /root/iRedAdmin-Pro-x.y.z.tar.bz2 -C /usr/local/www/
-
# chmod -R 0755 iredadmin
+
# cd /usr/local/www/
-
# chmod -R 0640 iredadmin/settings.ini
+
# 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
</pre>}}
</pre>}}
-
= Restart web server to make it work =
+
== For OpenBSD ==
{{cmd|<pre>
{{cmd|<pre>
-
# ---- RHEL/CentOS ----
+
# tar xjf /root/iRedAdmin-Pro-x.y.z.tar.bz2 -C /var/www/
-
# /etc/init.d/httpd restart
+
# 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/
-
# ---- Debian/Ubuntu/openSUSE ----
+
# chown -R iredadmin:iredadmin iRedAdmin-Pro-x.y.z/             # <- Set correct file permission for iRedAdmin-Pro.
-
# /etc/init.d/apache2 restart
+
# 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
-
# ---- FreeBSD ----
+
# /etc/rc.d/httpd restart           # <- Restart apache web server
-
# /usr/local/etc/rc.d/apache2 restart
+
</pre>}}
</pre>}}
 +
 +
= 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.)
 +
 +
* [[IRedMail/FAQ/Quarantining.SPAM |Quarantining VIRUS and SPAM into SQL database]]
 +
 +
= Troubleshooting =
 +
 +
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