Migrate/iRedAdmin-Pro/OSE-Pro

From iRedMail
(Difference between revisions)
Jump to: navigation, search
 
(Replaced content with "Document moved: http://www.iredmail.org/docs/migrate.or.upgrade.iredadmin.html")
 
(5 intermediate revisions by one user not shown)
Line 1: Line 1:
__TOC__
+
Document moved: http://www.iredmail.org/docs/migrate.or.upgrade.iredadmin.html
 
+
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 [[Migrate/iRedAdmin-Pro/OSE-Pro/0.7.4 |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 ==
+
 
+
{{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/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/
+
# 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 =
+
 
+
If it doesn't work for you, please post a new topic in our forum: http://www.iredmail.org/forum/
+

Latest revision as of 07:30, 20 December 2014

Document moved: http://www.iredmail.org/docs/migrate.or.upgrade.iredadmin.html

Personal tools