Migrate/iRedAdmin-Pro/OSE-Pro

From iRedMail
(Difference between revisions)
Jump to: navigation, search
 
 
(4 intermediate revisions by one user not shown)
Line 1: Line 1:
 
__TOC__
 
__TOC__
  
This tutorial explains how to migrate iRedAdmin open source edition (v0.1.7 and later versions) to iRedAdmin-Pro (full-featured edition).
+
This tutorial is used to migrate iRedAdmin open source edition or old iRedAdmin-Pro release to the latest 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/
+
= Requirements =
  
Some notes:
+
* You '''MUST''' have iRedAdmin open source edition or old iRedAdmin-Pro release installed on server before upgrading.
* 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 =
+
= Steps =
  
* 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]].
+
* Upload or copy the latest iRedAdmin-Pro to your server which has iRedAdmin open source edition or old iRedAdmin-Pro release 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.
* You '''MUST''' select to install iRedAdmin open source edition during iRedMail installation.
+
  
= Summary =
+
* Uncompress iRedAdmin-Pro
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 ==
+
  
 
{{cmd|<pre>
 
{{cmd|<pre>
# tar xjf /root/iRedAdmin-Pro-x.y.z.tar.bz2 -C /var/www/
+
# cd /root/
# cd /var/www/
+
# tar xjf iRedAdmin-Pro-x.y.z.tar.bz2
# rm -i /var/www/iredadmin    # <- this is a symbol link, it will prompt you to type 'y' to confirm.
+
# cd iRedAdmin-Pro-x.y.z/tools/
# ln -s iRedAdmin-Pro-x.y.z iredadmin
+
# bash upgrade_iredadmin.sh
# cp -p iRedAdmin-0.3/settings.py 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.py
+
 
+
# /etc/init.d/httpd restart    # <- Restart apache web server
+
 
</pre>}}
 
</pre>}}
  
== For Debian, Ubuntu, Mint Linux ==
+
* Quarantining SPAMs and manage them with iRedAdmin-Pro: [[IRedMail/FAQ/Quarantining.SPAM |Quarantining VIRUS and SPAM into SQL database]]
 
+
** Note: This step is '''REQUIRED''' if you want to quarantine spam, virus into SQL (MySQL or PostgreSQL) database, and manage (delete/release) them with iRedAdmin-Pro.
{{cmd|<pre>
+
# 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.3/settings.py 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.py
+
 
+
# /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/
+
# 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.3/settings.py 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.py
+
 
+
# /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
+
# cp -p iRedAdmin-0.3/settings.py 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.py
+
 
+
# /etc/init.d/apache2 restart            # <- Restart apache web server
+
</pre>}}
+
 
+
== For FreeBSD ==
+
{{cmd|<pre>
+
# 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.3/settings.py 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.py
+
 
+
# /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.3/settings.py 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.py
+
# chmod -R 0400 iRedAdmin-Pro-x.y.z/settings.py
+
 
+
# /etc/rc.d/httpd restart            # <- Restart apache web server
+
</pre>}}
+
 
+
= Converting old config file to new format =
+
If your old iRedAdmin-Pro still uses "settings.ini" as config file, you have to convert it to new config file format (and new file name) with below commands. All commands are executed under your iRedAdmin-Pro directory:
+
 
+
{{cmd|<pre>
+
# bash tools/convert_ini_to_py.sh settings.ini      # <- It will convert settings.ini to new config file "settings.py"
+
# chown iredadmin:iredadmin settings.py
+
# chmod 0400 settings.py
+
# rm settings.ini
+
</pre>}}
+
 
+
Please restart Apache service after you converted config file.
+
 
+
= 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 =
 
= 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/

Latest revision as of 17:35, 4 June 2014

Contents


This tutorial is used to migrate iRedAdmin open source edition or old iRedAdmin-Pro release to the latest iRedAdmin-Pro (full-featured edition).

[edit] Requirements

  • You MUST have iRedAdmin open source edition or old iRedAdmin-Pro release installed on server before upgrading.

[edit] Steps

  • Upload or copy the latest iRedAdmin-Pro to your server which has iRedAdmin open source edition or old iRedAdmin-Pro release 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
Terminal:
# cd /root/
# tar xjf iRedAdmin-Pro-x.y.z.tar.bz2
# cd iRedAdmin-Pro-x.y.z/tools/
# bash upgrade_iredadmin.sh
  • Quarantining SPAMs and manage them with iRedAdmin-Pro: Quarantining VIRUS and SPAM into SQL database
    • Note: This step is REQUIRED if you want to quarantine spam, virus into SQL (MySQL or PostgreSQL) database, and manage (delete/release) them with iRedAdmin-Pro.

[edit] Troubleshooting

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

Personal tools