Sync iRedAPD upgrade tutorials.

This commit is contained in:
Zhang Huangbin 2020-06-22 09:47:58 +08:00
parent 7c98cf7e6f
commit d74e1f7933
4 changed files with 179 additions and 73 deletions

View File

@ -3,51 +3,38 @@
!!! attention
* Release Notes are available here: [iRedAPD Release Notes](./iredapd.releases.html).
* If you're trying to upgrade iRedAPD-1.3.x or earlier releases to the latest
iRedAPD, please check this tutorial instead:
[Upgrade iRedAPD from v1.3.x or earlier versions to latest release](./upgrade.old.iredapd.html).
* iRedMail and iRedAdmin-Pro completely drop support for Cluebringer, if
you're still running Cluebringer, please migrate to iRedAPD by following
[our tutorial](./cluebringer.to.iredapd.html).
!!! warning
For iRedMail SQL backends, the latest iRedAPD release requires at least
iRedMail-0.9.7 because it needs the newly introduced SQL table
`vmail.forwardings`.
* iRedAPD-4.0 and later releases __require Python 3.5+__, only listed
distribution releases are qualified to upgrade:
- CentOS 7 and later
- Debian 9 and later
- Ubuntu 16.04 and later
- FreeBSD with latest ports tree
- OpenBSD 6.6 and later
If you're running an old Linux/BSD release which doesn't have Python
3.5+, please stay with iRedAPD-3.6, it's the last release supports Python
2. if you need to upgrade to iRedAPD-3.6, please follow this upgrade
tutorial instead: [Upgrade iRedAPD from v1.3.x or earlier versions to v3.6](./upgrade.iredapd.py2.html).
This tutorial describes how to upgrade iRedAPD from `1.4.0` or later releases
to the latest stable release. It's applicable on all Linux/BSD distributions
supported by iRedMail.
to the latest stable release on listed distribution releases listed above.
1. Download the latest stable release here: <https://dl.iredmail.org/yum/misc/>.
For example, `iRedAPD-3.6.tar.gz`.
1. Upload it to your iRedMail server. Assume it's `/root/iRedAPD-3.6.tar.gz`.
1. Extract downloaded package and execute upgrade script:
!!! attention
If you're running iRedMail with OpenLDAP or MySQL/MariaDB backends,
upgrading from iRedAPD-1.6.0 or earlier releases requires MySQL root username
and password, please get them before you run upgrade script.
Run commands below on your iRedMail server:
```
# cd /root
# tar zxf iRedAPD-3.6.tar.gz
# cd iRedAPD-3.6/tools/
# bash upgrade_iredapd.sh
cd /root
wget -O iRedAPD-4.0.tar.gz https://github.com/iredmail/iRedAPD/archive/4.0.tar.gz
tar zxf iRedAPD-4.0.tar.gz
cd iRedAPD-4.0/tools/
bash upgrade_iredapd.sh
```
That's all.
!!! note "Plugins"
* It's recommended to enable plugin `reject_null_sender` in iRedAPD-1.4.4
or later releases to prevent authenticated user sending spam as null sender.
* Plugin `amavisd_wblist` is required for whitelisting and blacklisting.
## See Also
* [Enable SRS (Sender Rewriting Scheme) support](./srs.html)
* [Migrate Cluebringer to iRedAPD](./cluebringer.to.iredapd.html)

View File

@ -0,0 +1,52 @@
# Upgrade iRedAPD
!!! attention
* Release Notes are available here: [iRedAPD Release Notes](./iredapd.releases.html).
* If you're trying to upgrade iRedAPD-1.3.x or earlier releases to the latest
iRedAPD, please check this tutorial instead:
[Upgrade iRedAPD from v1.3.x or earlier versions to latest release](./upgrade.old.iredapd.html).
* iRedMail and iRedAdmin-Pro completely drop support for Cluebringer, if
you're still running Cluebringer, please migrate to iRedAPD by following
[our tutorial](./cluebringer.to.iredapd.html).
!!! warning
For iRedMail SQL backends, the latest iRedAPD release requires at least
iRedMail-0.9.7 because it needs the newly introduced SQL table
`vmail.forwardings`.
This tutorial describes how to upgrade iRedAPD from `1.4.0` or later releases
to the latest stable release. It's applicable on all Linux/BSD distributions
supported by iRedMail.
1. Download the latest stable release here: <https://dl.iredmail.org/yum/misc/>.
For example, `iRedAPD-3.6.tar.gz`.
1. Upload it to your iRedMail server. Assume it's `/root/iRedAPD-3.6.tar.gz`.
1. Extract downloaded package and execute upgrade script:
!!! attention
If you're running iRedMail with OpenLDAP or MySQL/MariaDB backends,
upgrading from iRedAPD-1.6.0 or earlier releases requires MySQL root username
and password, please get them before you run upgrade script.
```
cd /root
tar zxf iRedAPD-3.6.tar.gz
cd iRedAPD-3.6/tools/
bash upgrade_iredapd.sh
```
That's all.
!!! note "Plugins"
* It's recommended to enable plugin `reject_null_sender` in iRedAPD-1.4.4
or later releases to prevent authenticated user sending spam as null sender.
* Plugin `amavisd_wblist` is required for whitelisting and blacklisting.
## See Also
* [Enable SRS (Sender Rewriting Scheme) support](./srs.html)
* [Migrate Cluebringer to iRedAPD](./cluebringer.to.iredapd.html)

View File

@ -20,58 +20,42 @@
<p class="admonition-title">Attention</p>
<ul>
<li>Release Notes are available here: <a href="./iredapd.releases.html">iRedAPD Release Notes</a>.</li>
<li>If you're trying to upgrade iRedAPD-1.3.x or earlier releases to the latest
iRedAPD, please check this tutorial instead:
<a href="./upgrade.old.iredapd.html">Upgrade iRedAPD from v1.3.x or earlier versions to latest release</a>.</li>
<li>iRedMail and iRedAdmin-Pro completely drop support for Cluebringer, if
you're still running Cluebringer, please migrate to iRedAPD by following
<a href="./cluebringer.to.iredapd.html">our tutorial</a>.</li>
</ul>
</div>
<div class="admonition warning">
<p class="admonition-title">Warning</p>
<p>For iRedMail SQL backends, the latest iRedAPD release requires at least
iRedMail-0.9.7 because it needs the newly introduced SQL table
<code>vmail.forwardings</code>.</p>
<ul>
<li>
<p>iRedAPD-4.0 and later releases <strong>require Python 3.5+</strong>, only listed
distribution releases are qualified to upgrade:</p>
<ul>
<li>CentOS 7 and later</li>
<li>Debian 9 and later</li>
<li>Ubuntu 16.04 and later</li>
<li>FreeBSD with latest ports tree</li>
<li>OpenBSD 6.6 and later</li>
</ul>
</li>
</ul>
<p>If you're running an old Linux/BSD release which doesn't have Python
3.5+, please stay with iRedAPD-3.6, it's the last release supports Python
2. if you need to upgrade to iRedAPD-3.6, please follow this upgrade
tutorial instead: <a href="./upgrade.iredapd.py2.html">Upgrade iRedAPD from v1.3.x or earlier versions to v3.6</a>.</p>
</div>
<p>This tutorial describes how to upgrade iRedAPD from <code>1.4.0</code> or later releases
to the latest stable release. It's applicable on all Linux/BSD distributions
supported by iRedMail.</p>
<ol>
<li>Download the latest stable release here: <a href="https://dl.iredmail.org/yum/misc/">https://dl.iredmail.org/yum/misc/</a>.
For example, <code>iRedAPD-3.6.tar.gz</code>.</li>
<li>Upload it to your iRedMail server. Assume it's <code>/root/iRedAPD-3.6.tar.gz</code>.</li>
<li>Extract downloaded package and execute upgrade script:</li>
</ol>
<div class="admonition attention">
<p class="admonition-title">Attention</p>
<p>If you're running iRedMail with OpenLDAP or MySQL/MariaDB backends,
upgrading from iRedAPD-1.6.0 or earlier releases requires MySQL root username
and password, please get them before you run upgrade script.</p>
</div>
<pre><code># cd /root
# tar zxf iRedAPD-3.6.tar.gz
# cd iRedAPD-3.6/tools/
# bash upgrade_iredapd.sh
to the latest stable release on listed distribution releases listed above.</p>
<p>Run commands below on your iRedMail server:</p>
<pre><code>cd /root
wget -O iRedAPD-4.0.tar.gz https://github.com/iredmail/iRedAPD/archive/4.0.tar.gz
tar zxf iRedAPD-4.0.tar.gz
cd iRedAPD-4.0/tools/
bash upgrade_iredapd.sh
</code></pre>
<p>That's all.</p>
<div class="admonition note">
<p class="admonition-title">Plugins</p>
<ul>
<li>
<p>It's recommended to enable plugin <code>reject_null_sender</code> in iRedAPD-1.4.4
or later releases to prevent authenticated user sending spam as null sender.</p>
</li>
<li>
<p>Plugin <code>amavisd_wblist</code> is required for whitelisting and blacklisting.</p>
</li>
</ul>
</div>
<h2 id="see-also">See Also</h2>
<ul>
<li><a href="./srs.html">Enable SRS (Sender Rewriting Scheme) support</a></li>
<li><a href="./cluebringer.to.iredapd.html">Migrate Cluebringer to iRedAPD</a></li>
</ul><div class="footer">
<p style="text-align: center; color: grey;">All documents are available in <a href="https://github.com/iredmail/docs/">GitHub repository</a>, and published under <a href="http://creativecommons.org/licenses/by-nd/3.0/us/" target="_blank">Creative Commons</a> license. You can <a href="https://github.com/iredmail/docs/archive/master.zip">download the latest version</a> for offline reading. If you found something wrong, please do <a href="https://www.iredmail.org/contact.html">contact us</a> to fix it.</p>
</div>

View File

@ -0,0 +1,83 @@
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Upgrade iRedAPD</title>
<link rel="stylesheet" type="text/css" href="./css/markdown.css" />
</head>
<body>
<div id="navigation">
<a href="https://www.iredmail.org" 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-iredapd">Upgrade iRedAPD</h1>
<div class="admonition attention">
<p class="admonition-title">Attention</p>
<ul>
<li>Release Notes are available here: <a href="./iredapd.releases.html">iRedAPD Release Notes</a>.</li>
<li>If you're trying to upgrade iRedAPD-1.3.x or earlier releases to the latest
iRedAPD, please check this tutorial instead:
<a href="./upgrade.old.iredapd.html">Upgrade iRedAPD from v1.3.x or earlier versions to latest release</a>.</li>
<li>iRedMail and iRedAdmin-Pro completely drop support for Cluebringer, if
you're still running Cluebringer, please migrate to iRedAPD by following
<a href="./cluebringer.to.iredapd.html">our tutorial</a>.</li>
</ul>
</div>
<div class="admonition warning">
<p class="admonition-title">Warning</p>
<p>For iRedMail SQL backends, the latest iRedAPD release requires at least
iRedMail-0.9.7 because it needs the newly introduced SQL table
<code>vmail.forwardings</code>.</p>
</div>
<p>This tutorial describes how to upgrade iRedAPD from <code>1.4.0</code> or later releases
to the latest stable release. It's applicable on all Linux/BSD distributions
supported by iRedMail.</p>
<ol>
<li>Download the latest stable release here: <a href="https://dl.iredmail.org/yum/misc/">https://dl.iredmail.org/yum/misc/</a>.
For example, <code>iRedAPD-3.6.tar.gz</code>.</li>
<li>Upload it to your iRedMail server. Assume it's <code>/root/iRedAPD-3.6.tar.gz</code>.</li>
<li>Extract downloaded package and execute upgrade script:</li>
</ol>
<div class="admonition attention">
<p class="admonition-title">Attention</p>
<p>If you're running iRedMail with OpenLDAP or MySQL/MariaDB backends,
upgrading from iRedAPD-1.6.0 or earlier releases requires MySQL root username
and password, please get them before you run upgrade script.</p>
</div>
<pre><code>cd /root
tar zxf iRedAPD-3.6.tar.gz
cd iRedAPD-3.6/tools/
bash upgrade_iredapd.sh
</code></pre>
<p>That's all.</p>
<div class="admonition note">
<p class="admonition-title">Plugins</p>
<ul>
<li>It's recommended to enable plugin <code>reject_null_sender</code> in iRedAPD-1.4.4
or later releases to prevent authenticated user sending spam as null sender.</li>
<li>Plugin <code>amavisd_wblist</code> is required for whitelisting and blacklisting.</li>
</ul>
</div>
<h2 id="see-also">See Also</h2>
<ul>
<li><a href="./srs.html">Enable SRS (Sender Rewriting Scheme) support</a></li>
<li><a href="./cluebringer.to.iredapd.html">Migrate Cluebringer to iRedAPD</a></li>
</ul><div class="footer">
<p style="text-align: center; color: grey;">All documents are available in <a href="https://github.com/iredmail/docs/">GitHub repository</a>, and published under <a href="http://creativecommons.org/licenses/by-nd/3.0/us/" target="_blank">Creative Commons</a> license. You can <a href="https://github.com/iredmail/docs/archive/master.zip">download the latest version</a> for offline reading. If you found something wrong, please do <a href="https://www.iredmail.org/contact.html">contact us</a> to fix it.</p>
</div>
<!-- Global site tag (gtag.js) - Google Analytics -->
<script async src="https://www.googletagmanager.com/gtag/js?id=UA-3293801-21"></script>
<script>
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments);}
gtag('js', new Date());
gtag('config', 'UA-3293801-21');
</script>
</body></html>