elmau
/
iredmail-doc
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

Update iRedMail upgrade tutorial.

This commit is contained in:
Zhang Huangbin 2019-12-09 09:37:20 +08:00
parent 0806900375
commit 8772647131
10 changed files with 66 additions and 94 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
en_US/installation/0-install.iredmail.on.debian.ubuntu.md
View File

@ -82,10 +82,10 @@ mx.example.com
* iRedMail needs official Debian/Ubuntu apt repositories, please enable them in
`/etc/apt/sources.list`.
* Install package `bzip2` so that you can uncompress downloaded iRedMail package.
* Install package `gzip` so that you can uncompress downloaded iRedMail package.
```
# sudo apt-get install bzip2
# sudo apt-get install gzip
```
### Download the latest release of iRedMail
@ -95,13 +95,13 @@ mx.example.com
* Upload iRedMail to your mail server via ftp or scp or whatever method you
can use, login to the server to install iRedMail. We assume you uploaded
it to `/root/iRedMail-x.y.z.tar.bz2` (replace x.y.z by the real version number).
it to `/root/iRedMail-x.y.z.tar.gz` (replace x.y.z by the real version number).
* Uncompress iRedMail tarball:
```
# cd /root/
# tar xjf iRedMail-x.y.z.tar.bz2
# tar zxf iRedMail-x.y.z.tar.gz
```
## Start iRedMail installer

4
en_US/installation/0-install.iredmail.on.freebsd.md
View File

@ -88,13 +88,13 @@ mx.example.com
* Upload iRedMail to your mail server via ftp or scp or whatever method you
can use, login to the server to install iRedMail. We assume you uploaded
it to `/root/iRedMail-x.y.z.tar.bz2` (replace x.y.z by the real version number).
it to `/root/iRedMail-x.y.z.tar.gz` (replace x.y.z by the real version number).
* Uncompress iRedMail tarball:
```
# cd /root/
# tar xjf iRedMail-x.y.z.tar.bz2
# tar zxf iRedMail-x.y.z.tar.gz
```
## Start iRedMail installer

16
en_US/installation/0-install.iredmail.on.openbsd.md
View File

@ -103,14 +103,12 @@ near you on OpenBSD web site:
### Install required packages
Before running iRedMail installer, we need to install few required packages:
```
pkg_add bash bzip2
```
iRedMail is wrote in Bash shell scripting language, so bash shell interpreter
is required. And `bzip2` is used to uncompress downloaded iRedMail package.
is required, install it first:
```
pkg_add bash
```
### Download the latest release of iRedMail
@ -119,13 +117,13 @@ is required. And `bzip2` is used to uncompress downloaded iRedMail package.
* Upload iRedMail to your mail server via ftp or scp or whatever method you
can use, login to the server to install iRedMail. We assume you uploaded
it to `/root/iRedMail-x.y.z.tar.bz2` (replace x.y.z by the real version number).
it to `/root/iRedMail-x.y.z.tar.gz` (replace x.y.z by the real version number).
* Uncompress iRedMail tarball:
```
# cd /root/
# tar xjf iRedMail-x.y.z.tar.bz2
# tar zxf iRedMail-x.y.z.tar.gz
```
## Start iRedMail installer

4
en_US/installation/0-install.iredmail.on.rhel.md
View File

@ -125,13 +125,13 @@ Disable it immediately without rebooting your server.
* Upload iRedMail to your mail server via ftp or scp or whatever method you
can use, login to the server to install iRedMail. We assume you uploaded
it to `/root/iRedMail-x.y.z.tar.bz2` (replace x.y.z by the real version number).
it to `/root/iRedMail-x.y.z.tar.gz` (replace x.y.z by the real version number).
* Uncompress iRedMail tarball:
```
# cd /root/
# tar xjf iRedMail-x.y.z.tar.bz2
# tar zxf iRedMail-x.y.z.tar.gz
```
## Start iRedMail installer

45
en_US/upgrade/0-upgrade.iredmail.0.9.9-1.0.md
View File

@ -2,10 +2,6 @@
[TOC]
!!! warning
This is still a __DRAFT__ document, do __NOT__ apply it.
!!! note "Paid Remote Upgrade Support"
We offer remote upgrade support if you don't want to get your hands dirty,
@ -14,7 +10,7 @@
## ChangeLog
TODO
* Dec 9, 2019, initial release.
## General (All backends should apply these changes)
@ -28,7 +24,7 @@ so that you can know which version of iRedMail you're running. For example:
1.0
```
### Upgrade iRedAPD (Postfix policy server) to the latest stable release
### Upgrade iRedAPD (Postfix policy server) to the latest stable release: 3.3
!!! attention
@ -39,7 +35,7 @@ so that you can know which version of iRedMail you're running. For example:
Please follow below tutorial to upgrade iRedAPD to the latest stable release:
[Upgrade iRedAPD to the latest stable release](./upgrade.iredapd.html)
### Upgrade iRedAdmin (open source edition) to the latest stable release (0.9.6)
### Upgrade iRedAdmin (open source edition) to the latest stable release: 0.9.9
Please follow this tutorial to upgrade iRedAdmin open source edition to the
latest stable release:
@ -50,26 +46,17 @@ latest stable release:
Please follow below tutorial to upgrade mlmmjadmin to the latest stable release:
[Upgrade mlmmjadmin to the latest stable release](./upgrade.mlmmjadmin.html)
### Upgrade Roundcube webmail to the latest stable release
### Upgrade Roundcube webmail to the latest stable release: 1.4.1
!!! warning "Roundcube 1.3"
!!! warning "Roundcube 1.4"
* Roundcube 1.3 requires at least __PHP 5.4__. If your server is still running
PHP 5.3 and cannot upgrade to 5.4, please upgrade Roundcube to the latest
1.2 branch (1.2.5) instead.
* Roundcube 1.3 no longer supports IE < 10 and old versions of Firefox,
Chrome and Safari.
* Roundcube 1.3 uses jQuery 3.2 and will not work with current jQuery
mobile plugin. If you use any third-party plugin, please check its
website to make sure it's compatible with Roundcube 1.3 before upgrading.
With the release of Roundcube 1.3.0, the previous stable release branches
1.2.x and 1.1.x will switch in to LTS low maintenance mode which means
they will only receive important security updates but no longer any regular
improvement updates.
Since Roundcube 1.3, at least __PHP 5.4__ is required. If your server is
running PHP 5.3 and cannot upgrade to 5.4, please upgrade Roundcube
the latest 1.2 branch instead.
The latest Roundcube webmail 1.4.1 offers a shiny new web UI.
Please follow Roundcube official tutorial to upgrade Roundcube webmail to the
latest stable release (1.3.10):
latest stable release (1.4.1):
* [How to upgrade Roundcube](https://github.com/roundcube/roundcubemail/wiki/Upgrade).
@ -160,8 +147,8 @@ Please follow commands below to get the updated filter rules.
```
cd /etc/fail2ban/filter.d/
wget -O postfix.iredmail.conf https://bitbucket.org/zhb/iredmail/raw/default/iRedMail/samples/fail2ban/filter.d/postfix.iredmail.conf
wget -O dovecot.iredmail.conf https://bitbucket.org/zhb/iredmail/raw/default/iRedMail/samples/fail2ban/filter.d/dovecot.iredmail.conf
wget -O postfix.iredmail.conf https://github.com/iredmail/iRedMail/raw/master/samples/fail2ban/filter.d/postfix.iredmail.conf
wget -O dovecot.iredmail.conf https://github.com/iredmail/iRedMail/raw/master/samples/fail2ban/filter.d/dovecot.iredmail.conf
```
Restarting Fail2ban service is required.
@ -189,7 +176,7 @@ this service.
```
cd /root/
wget https://bitbucket.org/zhb/iredmail/raw/default/extra/update/updateLDAPValues_099_to_1.py
wget https://github.com/iredmail/iRedMail/raw/master/update/ldap/updateLDAPValues_099_to_1.py
```
* Open downloaded file `updateLDAPValues_099_to_1.py`, set LDAP server
@ -212,7 +199,7 @@ of them have read-write privilege to update mail accounts.
* Execute this script, it will add required data:
```
# python updateLDAPValues_099_to_1.py
# python2 updateLDAPValues_099_to_1.py
```
#### Enable quota-status service in Dovecot
@ -287,7 +274,7 @@ Download plain SQL file used to create required column and index, then import
it directly as MySQL root user (Please run commands below as `root` user):
```
wget -O /tmp/iredmail.mysql https://bitbucket.org/zhb/iredmail/raw/default/extra/update/1.0/iredmail.mysql
wget -O /tmp/iredmail.mysql https://github.com/iredmail/iRedMail/raw/master/update/1.0/iredmail.mysql
mysql vmail < /tmp/iredmail.mysql
rm -f /tmp/iredmail.mysql
```
@ -363,7 +350,7 @@ According to the Dovecot settings configured by iRedMail, a new SQL column
* Download plain SQL file used to create required column and index:
```
wget -O /tmp/iredmail.pgsql https://bitbucket.org/zhb/iredmail/raw/default/extra/update/1.0/iredmail.pgsql
wget -O /tmp/iredmail.pgsql https://github.com/iredmail/iRedMail/raw/master/update/1.0/iredmail.pgsql
```
* Connect to PostgreSQL server as `postgres` user and import the SQL file:

8
html/install.iredmail.on.debian.ubuntu.html
View File

@ -111,9 +111,9 @@ mx.example.com
<ul>
<li>iRedMail needs official Debian/Ubuntu apt repositories, please enable them in
<code>/etc/apt/sources.list</code>.</li>
<li>Install package <code>bzip2</code> so that you can uncompress downloaded iRedMail package.</li>
<li>Install package <code>gzip</code> so that you can uncompress downloaded iRedMail package.</li>
</ul>
<pre><code># sudo apt-get install bzip2
<pre><code># sudo apt-get install gzip
</code></pre>
<h3 id="download-the-latest-release-of-iredmail">Download the latest release of iRedMail</h3>
@ -125,14 +125,14 @@ mx.example.com
<li>
<p>Upload iRedMail to your mail server via ftp or scp or whatever method you
can use, login to the server to install iRedMail. We assume you uploaded
it to <code>/root/iRedMail-x.y.z.tar.bz2</code> (replace x.y.z by the real version number).</p>
it to <code>/root/iRedMail-x.y.z.tar.gz</code> (replace x.y.z by the real version number).</p>
</li>
<li>
<p>Uncompress iRedMail tarball:</p>
</li>
</ul>
<pre><code># cd /root/
# tar xjf iRedMail-x.y.z.tar.bz2
# tar zxf iRedMail-x.y.z.tar.gz
</code></pre>
<h2 id="start-iredmail-installer">Start iRedMail installer</h2>

4
html/install.iredmail.on.freebsd.html
View File

@ -113,14 +113,14 @@ mx.example.com
<li>
<p>Upload iRedMail to your mail server via ftp or scp or whatever method you
can use, login to the server to install iRedMail. We assume you uploaded
it to <code>/root/iRedMail-x.y.z.tar.bz2</code> (replace x.y.z by the real version number).</p>
it to <code>/root/iRedMail-x.y.z.tar.gz</code> (replace x.y.z by the real version number).</p>
</li>
<li>
<p>Uncompress iRedMail tarball:</p>
</li>
</ul>
<pre><code># cd /root/
# tar xjf iRedMail-x.y.z.tar.bz2
# tar zxf iRedMail-x.y.z.tar.gz
</code></pre>
<h2 id="start-iredmail-installer">Start iRedMail installer</h2>

11
html/install.iredmail.on.openbsd.html
View File

@ -131,12 +131,11 @@ mirror site will speed up package installation. You can find mirror list
near you on OpenBSD web site:
<a href="http://www.openbsd.org/ftp.html#http">Getting OpenBSD</a>.</p>
<h3 id="install-required-packages">Install required packages</h3>
<p>Before running iRedMail installer, we need to install few required packages:</p>
<pre><code>pkg_add bash bzip2
<p>iRedMail is wrote in Bash shell scripting language, so bash shell interpreter
is required, install it first:</p>
<pre><code>pkg_add bash
</code></pre>
<p>iRedMail is wrote in Bash shell scripting language, so bash shell interpreter
is required. And <code>bzip2</code> is used to uncompress downloaded iRedMail package.</p>
<h3 id="download-the-latest-release-of-iredmail">Download the latest release of iRedMail</h3>
<ul>
<li>
@ -146,14 +145,14 @@ is required. And <code>bzip2</code> is used to uncompress downloaded iRedMail pa
<li>
<p>Upload iRedMail to your mail server via ftp or scp or whatever method you
can use, login to the server to install iRedMail. We assume you uploaded
it to <code>/root/iRedMail-x.y.z.tar.bz2</code> (replace x.y.z by the real version number).</p>
it to <code>/root/iRedMail-x.y.z.tar.gz</code> (replace x.y.z by the real version number).</p>
</li>
<li>
<p>Uncompress iRedMail tarball:</p>
</li>
</ul>
<pre><code># cd /root/
# tar xjf iRedMail-x.y.z.tar.bz2
# tar zxf iRedMail-x.y.z.tar.gz
</code></pre>
<h2 id="start-iredmail-installer">Start iRedMail installer</h2>

4
html/install.iredmail.on.rhel.html
View File

@ -155,14 +155,14 @@ used by iRedMail team to build the binary packages are available
<li>
<p>Upload iRedMail to your mail server via ftp or scp or whatever method you
can use, login to the server to install iRedMail. We assume you uploaded
it to <code>/root/iRedMail-x.y.z.tar.bz2</code> (replace x.y.z by the real version number).</p>
it to <code>/root/iRedMail-x.y.z.tar.gz</code> (replace x.y.z by the real version number).</p>
</li>
<li>
<p>Uncompress iRedMail tarball:</p>
</li>
</ul>
<pre><code># cd /root/
# tar xjf iRedMail-x.y.z.tar.bz2
# tar zxf iRedMail-x.y.z.tar.gz
</code></pre>
<h2 id="start-iredmail-installer">Start iRedMail installer</h2>

56
html/upgrade.iredmail.0.9.9-1.0.html
View File

@ -22,10 +22,10 @@
<li><a href="#changelog">ChangeLog</a></li>
<li><a href="#general-all-backends-should-apply-these-changes">General (All backends should apply these changes)</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">Upgrade iRedAPD (Postfix policy server) to the latest stable release</a></li>
<li><a href="#upgrade-iredadmin-open-source-edition-to-the-latest-stable-release-096">Upgrade iRedAdmin (open source edition) to the latest stable release (0.9.6)</a></li>
<li><a href="#upgrade-iredapd-postfix-policy-server-to-the-latest-stable-release-33">Upgrade iRedAPD (Postfix policy server) to the latest stable release: 3.3</a></li>
<li><a href="#upgrade-iredadmin-open-source-edition-to-the-latest-stable-release-099">Upgrade iRedAdmin (open source edition) to the latest stable release: 0.9.9</a></li>
<li><a href="#upgrade-mlmmjadmin-to-the-latest-stable-release-21">Upgrade mlmmjadmin to the latest stable release (2.1)</a></li>
<li><a href="#upgrade-roundcube-webmail-to-the-latest-stable-release">Upgrade Roundcube webmail to the latest stable release</a></li>
<li><a href="#upgrade-roundcube-webmail-to-the-latest-stable-release-141">Upgrade Roundcube webmail to the latest stable release: 1.4.1</a></li>
<li><a href="#upgrade-netdata-to-the-latest-stable-release-1190">Upgrade netdata to the latest stable release (1.19.0)</a></li>
<li><a href="#fixed-improper-order-of-postfix-smtpd_sender_restriction-rules">Fixed: improper order of Postfix smtpd_sender_restriction rules</a></li>
<li><a href="#fixed-fix-improper-helo-rule-which-blocks-new-facebook-servers">Fixed: fix improper HELO rule which blocks new Facebook servers</a></li>
@ -64,10 +64,6 @@
</li>
</ul>
</div>
<div class="admonition warning">
<p class="admonition-title">Warning</p>
<p>This is still a <strong>DRAFT</strong> document, do <strong>NOT</strong> apply it.</p>
</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,
@ -75,7 +71,9 @@ check <a href="https://www.iredmail.org/support.html">the details</a> and
<a href="https://www.iredmail.org/contact.html">contact us</a>.</p>
</div>
<h2 id="changelog">ChangeLog</h2>
<p>TODO</p>
<ul>
<li>Dec 9, 2019, initial release.</li>
</ul>
<h2 id="general-all-backends-should-apply-these-changes">General (All backends should apply these changes)</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
@ -84,7 +82,7 @@ so that you can know which version of iRedMail you're running. For example:</p>
<pre><code>1.0
</code></pre>
<h3 id="upgrade-iredapd-postfix-policy-server-to-the-latest-stable-release">Upgrade iRedAPD (Postfix policy server) to the latest stable release</h3>
<h3 id="upgrade-iredapd-postfix-policy-server-to-the-latest-stable-release-33">Upgrade iRedAPD (Postfix policy server) to the latest stable release: 3.3</h3>
<div class="admonition attention">
<p class="admonition-title">Attention</p>
<p>iRedAPD offers SRS (Sender Rewriting Scheme) support in this release, but
@ -93,33 +91,23 @@ issues and how to enable it: <a href="./srs.html">Enable SRS (Sender Rewriting S
</div>
<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>
<h3 id="upgrade-iredadmin-open-source-edition-to-the-latest-stable-release-096">Upgrade iRedAdmin (open source edition) to the latest stable release (0.9.6)</h3>
<h3 id="upgrade-iredadmin-open-source-edition-to-the-latest-stable-release-099">Upgrade iRedAdmin (open source edition) to the latest stable release: 0.9.9</h3>
<p>Please follow this tutorial to upgrade iRedAdmin open source edition to the
latest stable release:
<a href="./migrate.or.upgrade.iredadmin.html">Upgrade iRedAdmin to the latest stable release</a></p>
<h3 id="upgrade-mlmmjadmin-to-the-latest-stable-release-21">Upgrade mlmmjadmin to the latest stable release (2.1)</h3>
<p>Please follow below tutorial to upgrade mlmmjadmin to the latest stable release:
<a href="./upgrade.mlmmjadmin.html">Upgrade mlmmjadmin to the latest stable release</a></p>
<h3 id="upgrade-roundcube-webmail-to-the-latest-stable-release">Upgrade Roundcube webmail to the latest stable release</h3>
<h3 id="upgrade-roundcube-webmail-to-the-latest-stable-release-141">Upgrade Roundcube webmail to the latest stable release: 1.4.1</h3>
<div class="admonition warning">
<p class="admonition-title">Roundcube 1.3</p>
<ul>
<li>Roundcube 1.3 requires at least <strong>PHP 5.4</strong>. If your server is still running
PHP 5.3 and cannot upgrade to 5.4, please upgrade Roundcube to the latest
1.2 branch (1.2.5) instead.</li>
<li>Roundcube 1.3 no longer supports IE &lt; 10 and old versions of Firefox,
Chrome and Safari.</li>
<li>Roundcube 1.3 uses jQuery 3.2 and will not work with current jQuery
mobile plugin. If you use any third-party plugin, please check its
website to make sure it's compatible with Roundcube 1.3 before upgrading.</li>
</ul>
<p>With the release of Roundcube 1.3.0, the previous stable release branches
1.2.x and 1.1.x will switch in to LTS low maintenance mode which means
they will only receive important security updates but no longer any regular
improvement updates.</p>
<p class="admonition-title">Roundcube 1.4</p>
<p>Since Roundcube 1.3, at least <strong>PHP 5.4</strong> is required. If your server is
running PHP 5.3 and cannot upgrade to 5.4, please upgrade Roundcube
the latest 1.2 branch instead.</p>
</div>
<p>Please follow Roundcube official tutorial to upgrade Roundcube webmail to the
latest stable release (1.3.10):</p>
<p>The latest Roundcube webmail 1.4.1 offers a shiny new web UI.
Please follow Roundcube official tutorial to upgrade Roundcube webmail to the
latest stable release (1.4.1):</p>
<ul>
<li><a href="https://github.com/roundcube/roundcubemail/wiki/Upgrade">How to upgrade Roundcube</a>.</li>
</ul>
@ -198,8 +186,8 @@ iRedMail, so we decide to remove the filter rule used to match Postfix log
<li>On Linux:</li>
</ul>
<pre><code>cd /etc/fail2ban/filter.d/
wget -O postfix.iredmail.conf https://bitbucket.org/zhb/iredmail/raw/default/iRedMail/samples/fail2ban/filter.d/postfix.iredmail.conf
wget -O dovecot.iredmail.conf https://bitbucket.org/zhb/iredmail/raw/default/iRedMail/samples/fail2ban/filter.d/dovecot.iredmail.conf
wget -O postfix.iredmail.conf https://github.com/iredmail/iRedMail/raw/master/samples/fail2ban/filter.d/postfix.iredmail.conf
wget -O dovecot.iredmail.conf https://github.com/iredmail/iRedMail/raw/master/samples/fail2ban/filter.d/dovecot.iredmail.conf
</code></pre>
<p>Restarting Fail2ban service is required.</p>
@ -220,7 +208,7 @@ this service.</p>
<li>Download script used to update existing mail accounts:</li>
</ul>
<pre><code>cd /root/
wget https://bitbucket.org/zhb/iredmail/raw/default/extra/update/updateLDAPValues_099_to_1.py
wget https://github.com/iredmail/iRedMail/raw/master/update/ldap/updateLDAPValues_099_to_1.py
</code></pre>
<ul>
@ -242,7 +230,7 @@ of them have read-write privilege to update mail accounts.</p>
<ul>
<li>Execute this script, it will add required data:</li>
</ul>
<pre><code># python updateLDAPValues_099_to_1.py
<pre><code># python2 updateLDAPValues_099_to_1.py
</code></pre>
<h4 id="enable-quota-status-service-in-dovecot">Enable quota-status service in Dovecot</h4>
@ -300,7 +288,7 @@ to process this email (e.g. spam/virus scanning), and avoids bounce message.</p>
<code>mailbox.enablequota-status</code> is required.</p>
<p>Download plain SQL file used to create required column and index, then import
it directly as MySQL root user (Please run commands below as <code>root</code> user):</p>
<pre><code>wget -O /tmp/iredmail.mysql https://bitbucket.org/zhb/iredmail/raw/default/extra/update/1.0/iredmail.mysql
<pre><code>wget -O /tmp/iredmail.mysql https://github.com/iredmail/iRedMail/raw/master/update/1.0/iredmail.mysql
mysql vmail &lt; /tmp/iredmail.mysql
rm -f /tmp/iredmail.mysql
</code></pre>
@ -361,7 +349,7 @@ to process this email (e.g. spam/virus scanning), and avoids bounce message.</p>
<ul>
<li>Download plain SQL file used to create required column and index:</li>
</ul>
<pre><code>wget -O /tmp/iredmail.pgsql https://bitbucket.org/zhb/iredmail/raw/default/extra/update/1.0/iredmail.pgsql
<pre><code>wget -O /tmp/iredmail.pgsql https://github.com/iredmail/iRedMail/raw/master/update/1.0/iredmail.pgsql
</code></pre>
<ul>