2014-12-04 08:19:58 -06:00
|
|
|
# Migrate or upgrade iRedAdmin
|
2014-09-26 02:38:58 -05:00
|
|
|
|
|
|
|
|
[TOC]
|
|
|
|
|
|
2016-05-03 22:08:55 -05:00
|
|
|
!!! note "Paid Remote Upgrade Support"
|
|
|
|
|
|
|
|
|
|
We offer remote upgrade support if you don't want to get your hands dirty,
|
2017-11-16 21:48:44 -06:00
|
|
|
check [the details](https://www.iredmail.org/support.html) and
|
|
|
|
|
[contact us](https://www.iredmail.org/contact.html).
|
2015-05-16 20:56:21 -05:00
|
|
|
|
2018-12-19 06:49:51 -06:00
|
|
|
!!! attention
|
|
|
|
|
|
|
|
|
|
Since iRedAdmin-0.9.2 (open source edition), and iRedAdmin-Pro-SQL-3.0,
|
|
|
|
|
iRedAdmin-Pro-LDAP-3.2, iRedAdmin or iRedAdmin-Pro is running as a
|
|
|
|
|
standalone service named "iredadmin", each time you modified its config
|
|
|
|
|
file, please restart the service ("iredadmin").
|
|
|
|
|
|
2014-12-03 08:51:42 -06:00
|
|
|
This tutorial describes how to update or migrate iRedAdmin (either open source
|
|
|
|
|
edition or old iRedAdmin-Pro release) to the latest iRedAdmin release (again,
|
|
|
|
|
either open source edition or iRedAdmin-Pro).
|
2014-09-26 02:38:58 -05:00
|
|
|
|
|
|
|
|
## Requirements
|
|
|
|
|
|
2015-12-14 09:00:43 -06:00
|
|
|
1. The latest iRedAdmin-Pro always requires the latest iRedMail stable release,
|
|
|
|
|
so you __MUST__ upgrade iRedMail to the latest stable release before
|
|
|
|
|
upgrading iRedAdmin-Pro.
|
2014-09-26 02:38:58 -05:00
|
|
|
|
2016-05-03 22:08:55 -05:00
|
|
|
* If you run the latest iRedAdmin-Pro with old iRedMail release, you may
|
|
|
|
|
get error due to missing some required ldap attribute/value pairs
|
|
|
|
|
(OpenLDAP backend), or missing some required SQL columns.
|
2019-06-06 02:36:43 -05:00
|
|
|
|
2016-05-03 22:08:55 -05:00
|
|
|
* If you run the latest iRedMail with old iRedAdmin-Pro, you may get error
|
|
|
|
|
due to missing dropped SQL columns, or created accounts may miss some
|
|
|
|
|
properties required by the latest iRedMail.
|
2015-12-14 09:00:43 -06:00
|
|
|
|
|
|
|
|
1. You __MUST__ have iRedAdmin open source edition or old iRedAdmin-Pro release
|
|
|
|
|
installed and running on your server before upgrading.
|
2015-01-04 00:21:04 -06:00
|
|
|
|
2015-12-14 09:00:43 -06:00
|
|
|
## Download the latest iRedAdmin
|
2015-01-04 00:21:04 -06:00
|
|
|
|
2017-11-16 21:48:44 -06:00
|
|
|
* iRedAdmin open source edition is available for download [here](https://dl.iredmail.org/yum/misc/).
|
2015-12-14 09:00:43 -06:00
|
|
|
* iRedAdmin-Pro customers can get download link of new release by following
|
|
|
|
|
steps below:
|
2015-01-04 00:21:04 -06:00
|
|
|
* Login to iRedAdmin-Pro as global admin.
|
|
|
|
|
* Click `License` button on the top-right corner. it will show you basic
|
|
|
|
|
license info and a `Download` button if new version is available.
|
|
|
|
|
* Click `Download` button, your mailbox (license owner) will receive an email
|
|
|
|
|
with download link in a short time. Note: if your mail server has greylisting
|
|
|
|
|
enabled, it may take longer, please be patient and don't request download
|
|
|
|
|
link again and again.
|
|
|
|
|
|
2017-11-16 21:48:44 -06:00
|
|
|
If you cannot download iRedAdmin-Pro for some reason, please [contact us](https://www.iredmail.org/contact.html).
|
2015-01-04 00:21:04 -06:00
|
|
|
|
2014-09-26 02:38:58 -05:00
|
|
|
## Upgrade Steps
|
|
|
|
|
|
2014-12-23 08:42:44 -06:00
|
|
|
* Upload or copy the latest iRedAdmin to your server which has iRedAdmin
|
2015-12-14 09:00:43 -06:00
|
|
|
open source edition or old iRedAdmin-Pro release running. We assume you
|
2016-05-03 22:08:55 -05:00
|
|
|
uploaded it to `/root/iRedAdmin-x.y.z.tar.bz2` (`x.y.z` is a placeholder of
|
|
|
|
|
the version number).
|
2014-12-23 08:42:44 -06:00
|
|
|
* Uncompress and upgrade iRedAdmin:
|
2014-09-26 02:38:58 -05:00
|
|
|
|
2017-10-30 23:40:38 -06:00
|
|
|
!!! warning
|
|
|
|
|
|
|
|
|
|
Do not rename the extracted directory (`iRedAdmin-x.y.z`), otherwise
|
|
|
|
|
upgrade may fail.
|
|
|
|
|
|
2014-09-26 02:38:58 -05:00
|
|
|
```
|
|
|
|
|
# cd /root/
|
2014-12-23 08:42:44 -06:00
|
|
|
# tar xjf iRedAdmin-x.y.z.tar.bz2
|
|
|
|
|
# cd iRedAdmin-x.y.z/tools/
|
2014-09-26 02:38:58 -05:00
|
|
|
# bash upgrade_iredadmin.sh
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
That's all. If it doesn't work for you, please post a new topic in our
|
2017-10-26 08:13:46 -05:00
|
|
|
[online support forum](https://forum.iredmail.org/).
|
