2015-12-30 08:51:51 -06:00
|
|
|
# Upgrade iRedMail from 0.9.3 to 0.9.4
|
|
|
|
|
|
|
|
[TOC]
|
|
|
|
|
2016-03-30 04:57:49 -06: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-12-30 08:51:51 -06:00
|
|
|
|
2016-03-30 04:57:49 -06:00
|
|
|
## ChangeLog
|
2015-12-30 08:51:51 -06:00
|
|
|
|
2016-01-25 05:31:46 -06:00
|
|
|
* 2016-01-25: Initial publish.
|
|
|
|
|
2015-12-30 08:51:51 -06:00
|
|
|
## General (All backends should apply these steps)
|
|
|
|
|
|
|
|
### Update `/etc/iredmail-release` with new iRedMail version number
|
|
|
|
|
|
|
|
iRedMail stores the release version in `/etc/iredmail-release` after
|
|
|
|
installation, it's recommended to update this file after you upgraded iRedMail,
|
|
|
|
so that you can know which version of iRedMail you're running. For example:
|
|
|
|
|
|
|
|
```
|
|
|
|
# File: /etc/iredmail-release
|
|
|
|
|
|
|
|
0.9.4
|
|
|
|
```
|
|
|
|
|
2016-01-25 05:31:46 -06:00
|
|
|
### Upgrade iRedAPD (Postfix policy server) to the latest 1.8.0
|
2015-12-30 08:51:51 -06:00
|
|
|
|
|
|
|
Please follow below tutorial to upgrade iRedAPD to the latest stable release:
|
|
|
|
[Upgrade iRedAPD to the latest stable release](./upgrade.iredapd.html)
|
|
|
|
|
|
|
|
Detailed release notes are available [here](./iredapd.releases.html).
|
|
|
|
|
2016-01-05 11:08:56 -06:00
|
|
|
### Upgrade iRedAdmin (open source edition) to the latest stable release
|
|
|
|
|
|
|
|
Please follow this tutorial to upgrade iRedAdmin open source edition to the
|
|
|
|
latest stable release:
|
|
|
|
[Upgrade iRedAdmin to the latest stable release](./migrate.or.upgrade.iredadmin.html)
|
|
|
|
|
2015-12-30 08:51:51 -06:00
|
|
|
### Upgrade Roundcube webmail to the latest stable release
|
|
|
|
|
|
|
|
Please follow Roundcube official tutorial to upgrade Roundcube webmail to the
|
2016-05-08 03:25:42 -05:00
|
|
|
latest stable release immediately: [How to upgrade Roundcube](https://github.com/roundcube/roundcubemail/wiki/Upgrade).
|
2015-12-30 08:51:51 -06:00
|
|
|
|
2016-01-03 19:48:49 -06:00
|
|
|
Note: package `rsync` must be installed on your server before upgrading.
|
2016-01-16 10:26:50 -06:00
|
|
|
|
2016-01-17 23:41:00 -06:00
|
|
|
### Fixed: No daily cron job to backup SQL/LDAP database
|
|
|
|
|
|
|
|
In iRedMail-0.9.3, there's no daily cron job to backup SQL/LDAP databases.
|
|
|
|
Please add them manually with command `crontab -e -u root`.
|
|
|
|
|
2016-01-25 21:29:43 -06:00
|
|
|
> If you downloaded iRedMail-0.9.3 right after it had been released, the daily
|
|
|
|
> cron job which is used to backup SQL/LDAP database is missing. We re-packed
|
|
|
|
> iRedMail-0.9.3 with this fix to avoid trouble for users. So if don't have this
|
|
|
|
> cron job, please add it by following steps below. If you already have it,
|
|
|
|
> it's safe to ignore steps below.
|
|
|
|
|
2016-01-17 23:41:00 -06:00
|
|
|
> Notes:
|
|
|
|
>
|
|
|
|
> * Please make sure the path to backup scripts
|
|
|
|
> (`/var/vmail/backup/backup_XXX.sh`) are correct.
|
|
|
|
>
|
|
|
|
> * On FreeBSD and OpenBSD, the path of `bash` shell is `/usr/local/bin/bash`.
|
|
|
|
|
|
|
|
* For OpenLDAP backend, you need 2 daily cron jobs, one for SQL database, one
|
|
|
|
another one for LDAP:
|
|
|
|
|
|
|
|
```
|
|
|
|
# iRedMail: Backup OpenLDAP data (at 03:00 AM)
|
2016-01-22 08:01:35 -06:00
|
|
|
0 3 * * * /bin/bash /var/vmail/backup/backup_openldap.sh
|
2016-01-17 23:41:00 -06:00
|
|
|
|
|
|
|
# iRedMail: Backup MySQL databases (at 03:30AM)
|
2016-01-25 09:18:34 -06:00
|
|
|
30 3 * * * /bin/bash /var/vmail/backup/backup_mysql.sh
|
2016-01-17 23:41:00 -06:00
|
|
|
```
|
|
|
|
|
|
|
|
* For MySQL/MariaDB backends, you need 1 daily cron job:
|
|
|
|
|
|
|
|
```
|
|
|
|
# iRedMail: Backup MySQL databases (at 03:30AM)
|
2016-01-25 09:18:34 -06:00
|
|
|
30 3 * * * /bin/bash /var/vmail/backup/backup_mysql.sh
|
2016-01-17 23:41:00 -06:00
|
|
|
```
|
|
|
|
|
|
|
|
* For PostgreSQL backend, you need 1 daily cron job:
|
|
|
|
```
|
|
|
|
# iRedMail: Backup PostgreSQL databases (at 03:01AM)
|
|
|
|
1 3 * * * /bin/bash /var/vmail/backup/backup_pgsql.sh
|
|
|
|
```
|
2016-01-16 10:26:50 -06:00
|
|
|
|
|
|
|
### FreeBSD: Fix incorrect file permission of /etc/mail/mailer.conf
|
|
|
|
|
|
|
|
> This is applicable to only FreeBSD.
|
|
|
|
|
|
|
|
iRedMail generates /etc/mail/mailer.conf with permission 0600 during
|
|
|
|
installation, but it should be world-readable. Please fix this issue with
|
|
|
|
command below:
|
|
|
|
|
|
|
|
```
|
|
|
|
chmod +r /etc/mail/mailer.conf
|
|
|
|
```
|
2016-01-18 11:17:00 -06:00
|
|
|
|
|
|
|
### OpenBSD: Fixed: Not open port 25 in firewall rule
|
|
|
|
|
|
|
|
> This is applicable to only OpenBSD.
|
|
|
|
|
|
|
|
The sample PF firewall rule shipped in iRedMail-0.9.3 doesn't enable port 25
|
|
|
|
by default, please add service name `smtp` in `mail_services=` manually, then
|
|
|
|
reload pf rules.
|
|
|
|
|
|
|
|
* Add service name `smtp` in parameter `mail_services=` in `/etc/pf.conf`:
|
|
|
|
|
|
|
|
```
|
|
|
|
mail_services="{ ... smtp}"
|
|
|
|
```
|
|
|
|
|
|
|
|
* Reload pf firewall:
|
|
|
|
|
|
|
|
```
|
|
|
|
# pfctl -d
|
|
|
|
# pfctl -ef /etc/pf.conf
|
|
|
|
```
|