New: upgrade.iredmail.0.9.5-0.9.5-1.html.

This commit is contained in:
Zhang Huangbin 2016-05-10 09:18:28 +08:00
parent 50b45f9093
commit 5e8497108a
7 changed files with 377 additions and 136 deletions

View File

@ -26,6 +26,55 @@ The self-signed SSL certificate generated during iRedMail installation:
* `/etc/ssl/iRedMail.crt`
* Private key: `/etc/ssl/iRedMail.key`
## Postfix
* on `Linux` and OpenBSD, Postfix config files are placed under `/etc/postfix/`.
* on FreeBSD, Postfix config files are placed under `/usr/local/etc/postfix/`.
### Main config files:
* `main.cf`: contains most configurations.
* `master.cf`: contains transport related settings.
* `aliases`: aliases for system accounts.
* `helo_access.pcre`: PCRE regular expressions of HELO check rules.
* `ldap/*.cf`: used to query mail accounts. LDAP backends only.
* `mysql/*.cf`: used to query mail accounts. MySQL/MariaDB backends only.
* `pgsql/*.cf`: used to query mail accounts. PostgreSQL backend only.
### Log files
* on RHEL/CentOS, FreeBSD, OpenBSD, it's `/var/log/maillog`.
* on Debian, Ubuntu, it's `/var/log/mail.log`.
## Dovecot
* on `Linux` and OpenBSD, Dovecot config files are placed under `/etc/dovecot/`.
* on FreeBSD, Dovecot config files are placed under `/usr/local/etc/dovecot/`.
### Config files
Main config file is `dovecot.conf`. It contains most configurations.
Additional config files under `/etc/dovecot/`:
* `dovecot-ldap.conf`: used to query mail users and passwords. LDAP backends only.
* `dovecot-mysql.conf`: used to query mail users and passwords. MySQL/MariaDB backends only.
* `dovecot-pgsql.conf`: used to query mail users and passwords. PostgreSQL backend only.
* `dovecot-used-quota.conf`: used to store and query real-time per-user mailbox quota.
* `dovecot-share-folder.conf`: used to store settings of shared IMAP mailboxes.
* `dovecot-master-users-password` or `dovecot-master-users`: used to store Dovecot master user accounts.
### Log files
* `/var/log/dovecot.log`: main log file. IMAP/POP3 sessions, login, lotout,
some error messages will be logged in this file.
* `/var/log/dovecot-sieve.log`: sieve LDA (Local Delivery Agent) related log.
Mail delivery related log will be logged in this file. NOTE: on old iRedMail
releases, it's `/var/log/sieve.log`.
* `/var/log/dovecot-lmtp.log`: LMTP related log. Mail delivery (via LMTP)
related log will be logged in this file. Note: there's no such file on
iRedMail-0.8.6 and old iRedMail releases.
## Apache
* On RHEL/CentOS: Apache config files are placed under `/etc/httpd/`.
@ -76,54 +125,20 @@ Main config files are `nginx.conf` and `default.conf`.
* On `Linux` and FreeBSD: log files are placed under `/var/log/nginx/`.
* On OpenBSD: log files are placed under `/var/www/logs/` (same as Apache).
## Postfix
## PHP
* on `Linux` and OpenBSD, Postfix config files are placed under `/etc/postfix/`.
* on FreeBSD, Postfix config files are placed under `/usr/local/etc/postfix/`.
Main config file:
### Main config files:
* `main.cf`: contains most configurations.
* `master.cf`: contains transport related settings.
* `aliases`: aliases for system accounts.
* `helo_access.pcre`: PCRE regular expressions of HELO check rules.
* `ldap/*.cf`: used to query mail accounts. LDAP backends only.
* `mysql/*.cf`: used to query mail accounts. MySQL/MariaDB backends only.
* `pgsql/*.cf`: used to query mail accounts. PostgreSQL backend only.
### Log files
* on RHEL/CentOS, FreeBSD, OpenBSD, it's `/var/log/maillog`.
* on Debian, Ubuntu, it's `/var/log/mail.log`.
## Dovecot
* on `Linux` and OpenBSD, Dovecot config files are placed under `/etc/dovecot/`.
* on FreeBSD, Dovecot config files are placed under `/usr/local/etc/dovecot/`.
### Config files
Main config file is `dovecot.conf`. It contains most configurations.
Additional config files under `/etc/dovecot/`:
* `dovecot-ldap.conf`: used to query mail users and passwords. LDAP backends only.
* `dovecot-mysql.conf`: used to query mail users and passwords. MySQL/MariaDB backends only.
* `dovecot-pgsql.conf`: used to query mail users and passwords. PostgreSQL backend only.
* `dovecot-used-quota.conf`: used to store and query real-time per-user mailbox quota.
* `dovecot-share-folder.conf`: used to store settings of shared IMAP mailboxes.
* `dovecot-master-users-password` or `dovecot-master-users`: used to store Dovecot master user accounts.
### Log files
* `/var/log/dovecot.log`: main log file. IMAP/POP3 sessions, login, lotout,
some error messages will be logged in this file.
* `/var/log/dovecot-sieve.log`: sieve LDA (Local Delivery Agent) related log.
Mail delivery related log will be logged in this file. NOTE: on old iRedMail
releases, it's `/var/log/sieve.log`.
* `/var/log/dovecot-lmtp.log`: LMTP related log. Mail delivery (via LMTP)
related log will be logged in this file. Note: there's no such file on
iRedMail-0.8.6 and old iRedMail releases.
* on RHEL/CentOS: it's `/etc/php.ini`
* on Debian/Ubuntu:
* If you're running Apache as web server:
* If you're running PHP-5: it's `/etc/php5/apache2/php.ini` (Debian 8, Ubuntu 14.04)
* If you're running PHP-7: it's `/etc/php/7.0/cli/php.ini` (Ubuntu 16.04)
* If you're running Nginx as web server: it's `/etc/php5/fpm/php.ini`.
* If you're running PHP-5: it's `/etc/php5/fpm/php.ini` (Debian 8, Ubuntu 14.04)
* If you're running PHP-7: it's `/etc/php/7.0/fpm/php.ini` (Ubuntu 16.04)
* on FreeBSD: it's `/usr/local/etc/php.ini`.
* on OpenBSD: it's `/etc/php-5.X.ini`
## OpenLDAP

View File

@ -0,0 +1,109 @@
# Upgrade iRedMail from 0.9.5 to 0.9.5-1
[TOC]
!!! note "Paid Remote Upgrade Support"
We offer remote upgrade support if you don't want to get your hands dirty,
check [the details](../support.html) and [contact us](../contact.html).
## ChangeLog
* May 10, 2016: Initial publish.
## 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:
```
0.9.5-1
```
### Upgrade iRedAPD (Postfix policy server) to the latest stable release (1.9.1)
> iRedAPD-1.9.1 fixes a bug in `tools/spf_to_greylist_whitelists.py` which was
> introduced in iRedAPD-1.9.0.
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).
### Fixed: cannot deliver email to system account.
iRedMail-0.9.5 and early releases have incorrect Postfix settings which causes
emails sent to system account cannot be delivered to mailbox. Please follow
steps below fix it.
Please open file `/etc/postfix/main.cf` (Linux/OpenBSD) or
`/usr/local/etc/postfix/main.cf` (FreeBSD), remove below 2 parameters:
```
home_mailbox = ...
mailbox_command = ...
```
Restarting or reloading Postfix service is required.
### Fixed: Incorrect compress and uncompress command in logrotate config files
> This bug was introduced in iRedMail-0.9.0. If you're upgrading from
> iRedMail-0.9.3 or earlier release, it's safe to ignore this step.
iRedMail-0.9.0 sets incorrect command for parameter `compresscmd` and
`uncompresscmd`, please fix it with commands below:
* On RHEL/CentOS:
```
perl -pi -e 's#\$\(which bzip2\)#/usr/bin/bzip2#g' /etc/logrotate.d/*
perl -pi -e 's#\$\(which bunzip2\)#/usr/bin/bunzip2#g' /etc/logrotate.d/*
```
* On Debian/Ubuntu:
```
perl -pi -e 's#\$\(which bzip2\)#/bin/bzip2#g' /etc/logrotate.d/*
perl -pi -e 's#\$\(which bunzip2\)#/bin/bunzip2#g' /etc/logrotate.d/*
```
* On FreeBSD, OpenBSD: no fix required since FreeBSD/OpenBSD rotates log files
with `newsyslog` (`/etc/newsyslog.conf`), not `logrotate` program.
### Fixed: Allow two functions in PHP
> This bug was introduced in iRedMail-0.9.0. If you're upgrading from
> iRedMail-0.9.3 or earlier release, it's safe to ignore this step.
Roundcube cannot call command to change password without PHP functions:
`popen`, `openlog`, please remove them in PHP config file `php.ini`.
* on RHEL/CentOS: it's `/etc/php.ini`
* on Debian/Ubuntu:
* If you're running Apache as web server:
* If you're running PHP-5: it's `/etc/php5/apache2/php.ini` (Debian 8, Ubuntu 14.04)
* If you're running PHP-7: it's `/etc/php/7.0/cli/php.ini` (Ubuntu 16.04)
* If you're running Nginx as web server: it's `/etc/php5/fpm/php.ini`.
* If you're running PHP-5: it's `/etc/php5/fpm/php.ini` (Debian 8, Ubuntu 14.04)
* If you're running PHP-7: it's `/etc/php/7.0/fpm/php.ini` (Ubuntu 16.04)
* on FreeBSD: it's `/usr/local/etc/php.ini`.
* on OpenBSD: it's `/etc/php-5.X.ini`
Find parameter `disable_functions =`, remove function name `popen` and
`openlog`, then restart Apache or php fpm service.
### [RHEL/CentOS 6] Fixed: Roundcube cannot change password
> This bug was introduced in iRedMail-0.9.0. If you're upgrading from
> iRedMail-0.9.3 or earlier release, it's safe to ignore this step.
Roundcube cannot change password due to miss package `mcrypt`, please install
it as root user with commands below:
```
yum -y install mcrypt
```

View File

@ -1,46 +0,0 @@
# Upgrade iRedMail from 0.9.5 to 0.9.6
[TOC]
<!--
!!! note "Paid Remote Upgrade Support"
We offer remote upgrade support if you don't want to get your hands dirty,
check [the details](../support.html) and [contact us](../contact.html).
-->
!!! warning
THIS IS A DRAFT DOCUMENT, DO NOT APPLY IT.
## ChangeLog
* May 3, 2016: Fixed: cannot deliver email to system account.
## 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:
```
0.9.6
```
### Fixed: cannot deliver email to system account.
iRedMail-0.9.5 and early releases have incorrect Postfix settings which causes
emails sent to system account cannot be delivered to mailbox. Steps below fix
it.
Please open file `/etc/postfix/main.cf` (Linux/OpenBSD) or
`/usr/local/etc/postfix/main.cf` (FreeBSD), remove below 2 parameters:
```
home_mailbox = ...
mailbox_command = ...
```
Restarting or reloading Postfix service is required.

View File

@ -33,6 +33,7 @@
We offer remote upgrade support if you don't want to get your hands dirty,
check [the details](../support.html) and [contact us](../contact.html).
* [0.9.5-1](http://www.iredmail.org/forum/topic.html), May 3, 2016. [Upgrade from iRedMail-0.9.5](./upgrade.iredmail.0.9.5-0.9.5-1.html) (Small bug fix release)
* [0.9.5](http://www.iredmail.org/forum/topic.html), May 3, 2016. [Upgrade from iRedMail-0.9.4](./upgrade.iredmail.0.9.4-0.9.5.html) (contains SQL/LDAP structure changes)
* [0.9.4](http://www.iredmail.org/forum/topic10512.html), Jan 25, 2016. [Upgrade from iRedMail-0.9.3](./upgrade.iredmail.0.9.3-0.9.4.html)
* [0.9.3](http://www.iredmail.org/forum/topic10261.html), Dec 14, 2015. [Upgrade from iRedMail-0.9.2](./upgrade.iredmail.0.9.2-0.9.3.html) (contains SQL/LDAP structure changes)

View File

@ -19,8 +19,6 @@
<ul>
<li><a href="#locations-of-configuration-and-log-files-of-major-components">Locations of configuration and log files of major components</a><ul>
<li><a href="#ssl-certificate">SSL certificate</a></li>
<li><a href="#apache">Apache</a></li>
<li><a href="#nginx">Nginx</a></li>
<li><a href="#postfix">Postfix</a><ul>
<li><a href="#main-config-files">Main config files:</a></li>
<li><a href="#log-files">Log files</a></li>
@ -31,6 +29,9 @@
<li><a href="#log-files_1">Log files</a></li>
</ul>
</li>
<li><a href="#apache">Apache</a></li>
<li><a href="#nginx">Nginx</a></li>
<li><a href="#php">PHP</a></li>
<li><a href="#openldap">OpenLDAP</a></li>
<li><a href="#mysql-mariadb">MySQL, MariaDB</a></li>
<li><a href="#roundcube-webmail">Roundcube webmail</a></li>
@ -81,6 +82,53 @@
</ul>
</li>
</ul>
<h2 id="postfix">Postfix</h2>
<ul>
<li>on <code>Linux</code> and OpenBSD, Postfix config files are placed under <code>/etc/postfix/</code>.</li>
<li>on FreeBSD, Postfix config files are placed under <code>/usr/local/etc/postfix/</code>.</li>
</ul>
<h3 id="main-config-files">Main config files:</h3>
<ul>
<li><code>main.cf</code>: contains most configurations.</li>
<li><code>master.cf</code>: contains transport related settings.</li>
<li><code>aliases</code>: aliases for system accounts.</li>
<li><code>helo_access.pcre</code>: PCRE regular expressions of HELO check rules.</li>
<li><code>ldap/*.cf</code>: used to query mail accounts. LDAP backends only.</li>
<li><code>mysql/*.cf</code>: used to query mail accounts. MySQL/MariaDB backends only.</li>
<li><code>pgsql/*.cf</code>: used to query mail accounts. PostgreSQL backend only.</li>
</ul>
<h3 id="log-files">Log files</h3>
<ul>
<li>on RHEL/CentOS, FreeBSD, OpenBSD, it's <code>/var/log/maillog</code>.</li>
<li>on Debian, Ubuntu, it's <code>/var/log/mail.log</code>.</li>
</ul>
<h2 id="dovecot">Dovecot</h2>
<ul>
<li>on <code>Linux</code> and OpenBSD, Dovecot config files are placed under <code>/etc/dovecot/</code>.</li>
<li>on FreeBSD, Dovecot config files are placed under <code>/usr/local/etc/dovecot/</code>.</li>
</ul>
<h3 id="config-files">Config files</h3>
<p>Main config file is <code>dovecot.conf</code>. It contains most configurations.</p>
<p>Additional config files under <code>/etc/dovecot/</code>:</p>
<ul>
<li><code>dovecot-ldap.conf</code>: used to query mail users and passwords. LDAP backends only.</li>
<li><code>dovecot-mysql.conf</code>: used to query mail users and passwords. MySQL/MariaDB backends only.</li>
<li><code>dovecot-pgsql.conf</code>: used to query mail users and passwords. PostgreSQL backend only.</li>
<li><code>dovecot-used-quota.conf</code>: used to store and query real-time per-user mailbox quota.</li>
<li><code>dovecot-share-folder.conf</code>: used to store settings of shared IMAP mailboxes.</li>
<li><code>dovecot-master-users-password</code> or <code>dovecot-master-users</code>: used to store Dovecot master user accounts.</li>
</ul>
<h3 id="log-files_1">Log files</h3>
<ul>
<li><code>/var/log/dovecot.log</code>: main log file. IMAP/POP3 sessions, login, lotout,
some error messages will be logged in this file.</li>
<li><code>/var/log/dovecot-sieve.log</code>: sieve LDA (Local Delivery Agent) related log.
Mail delivery related log will be logged in this file. NOTE: on old iRedMail
releases, it's <code>/var/log/sieve.log</code>.</li>
<li><code>/var/log/dovecot-lmtp.log</code>: LMTP related log. Mail delivery (via LMTP)
related log will be logged in this file. Note: there's no such file on
iRedMail-0.8.6 and old iRedMail releases.</li>
</ul>
<h2 id="apache">Apache</h2>
<ul>
<li>
@ -140,52 +188,25 @@
<li>On <code>Linux</code> and FreeBSD: log files are placed under <code>/var/log/nginx/</code>.</li>
<li>On OpenBSD: log files are placed under <code>/var/www/logs/</code> (same as Apache).</li>
</ul>
<h2 id="postfix">Postfix</h2>
<h2 id="php">PHP</h2>
<p>Main config file:</p>
<ul>
<li>on <code>Linux</code> and OpenBSD, Postfix config files are placed under <code>/etc/postfix/</code>.</li>
<li>on FreeBSD, Postfix config files are placed under <code>/usr/local/etc/postfix/</code>.</li>
<li>on RHEL/CentOS: it's <code>/etc/php.ini</code></li>
<li>on Debian/Ubuntu:<ul>
<li>If you're running Apache as web server:<ul>
<li>If you're running PHP-5: it's <code>/etc/php5/apache2/php.ini</code> (Debian 8, Ubuntu 14.04)</li>
<li>If you're running PHP-7: it's <code>/etc/php/7.0/cli/php.ini</code> (Ubuntu 16.04)</li>
</ul>
<h3 id="main-config-files">Main config files:</h3>
<ul>
<li><code>main.cf</code>: contains most configurations.</li>
<li><code>master.cf</code>: contains transport related settings.</li>
<li><code>aliases</code>: aliases for system accounts.</li>
<li><code>helo_access.pcre</code>: PCRE regular expressions of HELO check rules.</li>
<li><code>ldap/*.cf</code>: used to query mail accounts. LDAP backends only.</li>
<li><code>mysql/*.cf</code>: used to query mail accounts. MySQL/MariaDB backends only.</li>
<li><code>pgsql/*.cf</code>: used to query mail accounts. PostgreSQL backend only.</li>
</li>
<li>If you're running Nginx as web server: it's <code>/etc/php5/fpm/php.ini</code>.<ul>
<li>If you're running PHP-5: it's <code>/etc/php5/fpm/php.ini</code> (Debian 8, Ubuntu 14.04)</li>
<li>If you're running PHP-7: it's <code>/etc/php/7.0/fpm/php.ini</code> (Ubuntu 16.04)</li>
</ul>
<h3 id="log-files">Log files</h3>
<ul>
<li>on RHEL/CentOS, FreeBSD, OpenBSD, it's <code>/var/log/maillog</code>.</li>
<li>on Debian, Ubuntu, it's <code>/var/log/mail.log</code>.</li>
</li>
</ul>
<h2 id="dovecot">Dovecot</h2>
<ul>
<li>on <code>Linux</code> and OpenBSD, Dovecot config files are placed under <code>/etc/dovecot/</code>.</li>
<li>on FreeBSD, Dovecot config files are placed under <code>/usr/local/etc/dovecot/</code>.</li>
</ul>
<h3 id="config-files">Config files</h3>
<p>Main config file is <code>dovecot.conf</code>. It contains most configurations.</p>
<p>Additional config files under <code>/etc/dovecot/</code>:</p>
<ul>
<li><code>dovecot-ldap.conf</code>: used to query mail users and passwords. LDAP backends only.</li>
<li><code>dovecot-mysql.conf</code>: used to query mail users and passwords. MySQL/MariaDB backends only.</li>
<li><code>dovecot-pgsql.conf</code>: used to query mail users and passwords. PostgreSQL backend only.</li>
<li><code>dovecot-used-quota.conf</code>: used to store and query real-time per-user mailbox quota.</li>
<li><code>dovecot-share-folder.conf</code>: used to store settings of shared IMAP mailboxes.</li>
<li><code>dovecot-master-users-password</code> or <code>dovecot-master-users</code>: used to store Dovecot master user accounts.</li>
</ul>
<h3 id="log-files_1">Log files</h3>
<ul>
<li><code>/var/log/dovecot.log</code>: main log file. IMAP/POP3 sessions, login, lotout,
some error messages will be logged in this file.</li>
<li><code>/var/log/dovecot-sieve.log</code>: sieve LDA (Local Delivery Agent) related log.
Mail delivery related log will be logged in this file. NOTE: on old iRedMail
releases, it's <code>/var/log/sieve.log</code>.</li>
<li><code>/var/log/dovecot-lmtp.log</code>: LMTP related log. Mail delivery (via LMTP)
related log will be logged in this file. Note: there's no such file on
iRedMail-0.8.6 and old iRedMail releases.</li>
</li>
<li>on FreeBSD: it's <code>/usr/local/etc/php.ini</code>.</li>
<li>on OpenBSD: it's <code>/etc/php-5.X.ini</code></li>
</ul>
<h2 id="openldap">OpenLDAP</h2>
<p>Main config file:</p>

View File

@ -62,6 +62,7 @@
check <a href="../support.html">the details</a> and <a href="../contact.html">contact us</a>.</p>
</div>
<ul>
<li><a href="http://www.iredmail.org/forum/topic.html">0.9.5-1</a>, May 3, 2016. <a href="./upgrade.iredmail.0.9.5-0.9.5-1.html">Upgrade from iRedMail-0.9.5</a> (Small bug fix release)</li>
<li><a href="http://www.iredmail.org/forum/topic.html">0.9.5</a>, May 3, 2016. <a href="./upgrade.iredmail.0.9.4-0.9.5.html">Upgrade from iRedMail-0.9.4</a> (contains SQL/LDAP structure changes)</li>
<li><a href="http://www.iredmail.org/forum/topic10512.html">0.9.4</a>, Jan 25, 2016. <a href="./upgrade.iredmail.0.9.3-0.9.4.html">Upgrade from iRedMail-0.9.3</a></li>
<li><a href="http://www.iredmail.org/forum/topic10261.html">0.9.3</a>, Dec 14, 2015. <a href="./upgrade.iredmail.0.9.2-0.9.3.html">Upgrade from iRedMail-0.9.2</a> (contains SQL/LDAP structure changes)</li>

View File

@ -0,0 +1,140 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Upgrade iRedMail from 0.9.5 to 0.9.5-1</title>
<link rel="stylesheet" type="text/css" href="./css/markdown.css" />
</head>
<body>
<div id="navigation">
<a href="/index.html" target="_blank">
<img alt="iRedMail web site"
src="./images/logo-iredmail.png"
style="vertical-align: middle; height: 30px;"
/>&nbsp;
<span>iRedMail</span>
</a>
&nbsp;&nbsp;//&nbsp;&nbsp;<a href="./index.html">Document Index</a></div><h1 id="upgrade-iredmail-from-095-to-095-1">Upgrade iRedMail from 0.9.5 to 0.9.5-1</h1>
<div class="toc">
<ul>
<li><a href="#upgrade-iredmail-from-095-to-095-1">Upgrade iRedMail from 0.9.5 to 0.9.5-1</a><ul>
<li><a href="#changelog">ChangeLog</a></li>
<li><a href="#general-all-backends-should-apply-these-steps">General (All backends should apply these steps)</a><ul>
<li><a href="#update-etciredmail-release-with-new-iredmail-version-number">Update /etc/iredmail-release with new iRedMail version number</a></li>
<li><a href="#upgrade-iredapd-postfix-policy-server-to-the-latest-stable-release-191">Upgrade iRedAPD (Postfix policy server) to the latest stable release (1.9.1)</a></li>
<li><a href="#fixed-cannot-deliver-email-to-system-account">Fixed: cannot deliver email to system account.</a></li>
<li><a href="#fixed-incorrect-compress-and-uncompress-command-in-logrotate-config-files">Fixed: Incorrect compress and uncompress command in logrotate config files</a></li>
<li><a href="#fixed-allow-two-functions-in-php">Fixed: Allow two functions in PHP</a></li>
<li><a href="#rhelcentos-6-fixed-roundcube-cannot-change-password">[RHEL/CentOS 6] Fixed: Roundcube cannot change password</a></li>
</ul>
</li>
</ul>
</li>
</ul>
</div>
<div class="admonition note">
<p class="admonition-title">Paid Remote Upgrade Support</p>
<p>We offer remote upgrade support if you don't want to get your hands dirty,
check <a href="../support.html">the details</a> and <a href="../contact.html">contact us</a>.</p>
</div>
<h2 id="changelog">ChangeLog</h2>
<ul>
<li>May 10, 2016: Initial publish.</li>
</ul>
<h2 id="general-all-backends-should-apply-these-steps">General (All backends should apply these steps)</h2>
<h3 id="update-etciredmail-release-with-new-iredmail-version-number">Update <code>/etc/iredmail-release</code> with new iRedMail version number</h3>
<p>iRedMail stores the release version in <code>/etc/iredmail-release</code> 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:</p>
<pre><code>0.9.5-1
</code></pre>
<h3 id="upgrade-iredapd-postfix-policy-server-to-the-latest-stable-release-191">Upgrade iRedAPD (Postfix policy server) to the latest stable release (1.9.1)</h3>
<blockquote>
<p>iRedAPD-1.9.1 fixes a bug in <code>tools/spf_to_greylist_whitelists.py</code> which was
introduced in iRedAPD-1.9.0.</p>
</blockquote>
<p>Please follow below tutorial to upgrade iRedAPD to the latest stable release:
<a href="./upgrade.iredapd.html">Upgrade iRedAPD to the latest stable release</a></p>
<p>Detailed release notes are available <a href="./iredapd.releases.html">here</a>.</p>
<h3 id="fixed-cannot-deliver-email-to-system-account">Fixed: cannot deliver email to system account.</h3>
<p>iRedMail-0.9.5 and early releases have incorrect Postfix settings which causes
emails sent to system account cannot be delivered to mailbox. Please follow
steps below fix it.</p>
<p>Please open file <code>/etc/postfix/main.cf</code> (Linux/OpenBSD) or
<code>/usr/local/etc/postfix/main.cf</code> (FreeBSD), remove below 2 parameters:</p>
<pre><code>home_mailbox = ...
mailbox_command = ...
</code></pre>
<p>Restarting or reloading Postfix service is required.</p>
<h3 id="fixed-incorrect-compress-and-uncompress-command-in-logrotate-config-files">Fixed: Incorrect compress and uncompress command in logrotate config files</h3>
<blockquote>
<p>This bug was introduced in iRedMail-0.9.0. If you're upgrading from
iRedMail-0.9.3 or earlier release, it's safe to ignore this step.</p>
</blockquote>
<p>iRedMail-0.9.0 sets incorrect command for parameter <code>compresscmd</code> and
<code>uncompresscmd</code>, please fix it with commands below:</p>
<ul>
<li>On RHEL/CentOS:</li>
</ul>
<pre><code>perl -pi -e 's#\$\(which bzip2\)#/usr/bin/bzip2#g' /etc/logrotate.d/*
perl -pi -e 's#\$\(which bunzip2\)#/usr/bin/bunzip2#g' /etc/logrotate.d/*
</code></pre>
<ul>
<li>On Debian/Ubuntu:</li>
</ul>
<pre><code>perl -pi -e 's#\$\(which bzip2\)#/bin/bzip2#g' /etc/logrotate.d/*
perl -pi -e 's#\$\(which bunzip2\)#/bin/bunzip2#g' /etc/logrotate.d/*
</code></pre>
<ul>
<li>On FreeBSD, OpenBSD: no fix required since FreeBSD/OpenBSD rotates log files
with <code>newsyslog</code> (<code>/etc/newsyslog.conf</code>), not <code>logrotate</code> program.</li>
</ul>
<h3 id="fixed-allow-two-functions-in-php">Fixed: Allow two functions in PHP</h3>
<blockquote>
<p>This bug was introduced in iRedMail-0.9.0. If you're upgrading from
iRedMail-0.9.3 or earlier release, it's safe to ignore this step.</p>
</blockquote>
<p>Roundcube cannot call command to change password without PHP functions:
<code>popen</code>, <code>openlog</code>, please remove them in PHP config file <code>php.ini</code>.</p>
<ul>
<li>on RHEL/CentOS: it's <code>/etc/php.ini</code></li>
<li>on Debian/Ubuntu:<ul>
<li>If you're running Apache as web server:<ul>
<li>If you're running PHP-5: it's <code>/etc/php5/apache2/php.ini</code> (Debian 8, Ubuntu 14.04)</li>
<li>If you're running PHP-7: it's <code>/etc/php/7.0/cli/php.ini</code> (Ubuntu 16.04)</li>
</ul>
</li>
<li>If you're running Nginx as web server: it's <code>/etc/php5/fpm/php.ini</code>.<ul>
<li>If you're running PHP-5: it's <code>/etc/php5/fpm/php.ini</code> (Debian 8, Ubuntu 14.04)</li>
<li>If you're running PHP-7: it's <code>/etc/php/7.0/fpm/php.ini</code> (Ubuntu 16.04)</li>
</ul>
</li>
</ul>
</li>
<li>on FreeBSD: it's <code>/usr/local/etc/php.ini</code>.</li>
<li>on OpenBSD: it's <code>/etc/php-5.X.ini</code></li>
</ul>
<p>Find parameter <code>disable_functions =</code>, remove function name <code>popen</code> and
<code>openlog</code>, then restart Apache or php fpm service.</p>
<h3 id="rhelcentos-6-fixed-roundcube-cannot-change-password">[RHEL/CentOS 6] Fixed: Roundcube cannot change password</h3>
<blockquote>
<p>This bug was introduced in iRedMail-0.9.0. If you're upgrading from
iRedMail-0.9.3 or earlier release, it's safe to ignore this step.</p>
</blockquote>
<p>Roundcube cannot change password due to miss package <code>mcrypt</code>, please install
it as root user with commands below:</p>
<pre><code>yum -y install mcrypt
</code></pre><p style="text-align: center; color: grey;">All documents are available in <a href="https://bitbucket.org/zhb/iredmail-docs/src">BitBucket repository</a>, and published under <a href="http://creativecommons.org/licenses/by-nd/3.0/us/" target="_blank">Creative Commons</a> license. If you found something wrong, please do <a href="http://www.iredmail.org/contact.html">contact us</a> to fix it.<script>
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','//www.google-analytics.com/analytics.js','ga');
ga('create', 'UA-3293801-21', 'auto');
ga('send', 'pageview');
</script>
</body></html>