From 4e4859fe05e4e46c741fbd939da4d29c841c3e20 Mon Sep 17 00:00:00 2001
From: Zhang Huangbin <Zhang Huangbin@localhost>
Date: Tue, 16 Dec 2014 14:58:27 +0800
Subject: [PATCH] New: upgrade/upgrade.iredapd.md.

---
 html/index.html                |  1 +
 html/iredmail.releases.html    |  3 +-
 html/upgrade.iredapd.html      | 62 ++++++++++++++++++++++++++++++++++
 upgrade/1-iredmail.releases.md |  4 ++-
 upgrade/upgrade.iredapd.md     | 38 +++++++++++++++++++++
 5 files changed, 106 insertions(+), 2 deletions(-)
 create mode 100644 html/upgrade.iredapd.html
 create mode 100644 upgrade/upgrade.iredapd.md
diff --git a/html/index.html b/html/index.html
index 447dc7d9..4a9b26bf 100644
--- a/html/index.html
+++ b/html/index.html
@@ -23,6 +23,7 @@
 <ul>
 <li><a href="iredmail.releases.html">iRedMail release notes and upgrade tutorials</a></li>
 <li><a href="iredadmin-pro.releases.html">iRedAdmin-Pro release notes and upgrade tutorial</a></li>
+<li><a href="upgrade.iredapd.html">Upgrade iRedAPD</a></li>
 </ul>
 <h3 id="migrations">Migrations</h3>
 <ul>
diff --git a/html/iredmail.releases.html b/html/iredmail.releases.html
index 7aba2554..855c4a18 100644
--- a/html/iredmail.releases.html
+++ b/html/iredmail.releases.html
@@ -12,7 +12,8 @@
         // <a href="./index.html">Document Index</a>
     </div><h1 id="iredmail-release-notes-and-upgrade-tutorials">iRedMail release notes and upgrade tutorials</h1>
 <blockquote>
-<p><a href="../download.html">Download the latest iRedMail stable release</a></p>
+<p>iRedMail source code is hosted on <a href="https://bitbucket.org/zhb/iredmail/overview">BitBucket</a>.</p>
+<p>Download the <a href="../download.html">latest iRedMail stable release</a>.</p>
 </blockquote>
 <h4 id="upgrading-iredmail">Upgrading iRedMail</h4>
 <ul>
diff --git a/html/upgrade.iredapd.html b/html/upgrade.iredapd.html
new file mode 100644
index 00000000..c0fb56dc
--- /dev/null
+++ b/html/upgrade.iredapd.html
@@ -0,0 +1,62 @@
+<html>
+    <head>
+        <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+        <title>Upgrade iRedAPD</title>
+        <link href="./css/markdown.css" rel="stylesheet"></head>
+    </head>
+    <body>
+    
+    <div id="navigation">
+        <a href="http://www.iredmail.org" target="_blank">iRedMail web site</a>
+    
+        // <a href="./index.html">Document Index</a>
+    </div><h1 id="upgrade-iredapd">Upgrade iRedAPD</h1>
+<blockquote>
+<p>iRedAPD source code is hosted on <a href="https://bitbucket.org/zhb/iredapd/overview">BitBucket</a>.</p>
+</blockquote>
+<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>
+<ul>
+<li>Download the latest stable release here: <a href="http://www.iredmail.org/yum/misc/">http://www.iredmail.org/yum/misc/</a>
+  For example, iRedAPD-1.4.4.tar.bz2.</li>
+<li>Upload it to your iRedMail server. Assume it's <code>/root/iRedAPD-1.4.4.tar.bz2</code>.</li>
+<li>Extract downloaded package and execute upgrade script:</li>
+</ul>
+<pre><code># cd /root
+# tar xjf iRedAPD-1.4.4.tar.bz2
+# cd iRedAPD-1.4.4/tools/
+# bash upgrade_iredapd.sh
+</code></pre>
+
+<p>That's all.</p>
+<p>Notes:</p>
+<ul>
+<li>
+<p>It's recommended to enable plugin <code>reject_null_sender</code> in iRedAPD-1.4.4 or
+  newer releases to prevent authenticated user sending spam as null sender.</p>
+</li>
+<li>
+<p>Since version 1.4.4, iRedAPD supports Postfix smtp protocol state
+  <code>END-OF-MESSAGE</code>, so you can enable iRedAPD in Postfix parameter
+  <code>smtpd_end_of_data_restrictions</code> like below:</p>
+<p><code>smtpd_end_of_data_restrictions = check_policy_service inet:127.0.0.1:7777, ...</code></p>
+<p>Currently, only plugin <code>amavisd_message_size_limit</code> works in <code>END-OF-MESSAGE</code>
+state, other plugins work in <code>RCPT</code> state.</p>
+</li>
+<li>
+<p>If you want to develop your own plugin for iRedAPD, please read document
+  <code>README_PLUGINS.md</code> in iRedAPD source code.</p>
+</li>
+</ul><p style="text-align: center; color: grey;">Document published under a <a href="http://creativecommons.org/licenses/by-nd/3.0/us/" target="_blank">CC BY-ND 3.0</a> license. If you found something wrong, please do <a href="http://www.iredmail.org/contact.html">contact us</a> to fix it.<!-- Google Analytics -->
+<script type="text/javascript">
+    var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
+    document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
+</script>
+<script type="text/javascript">
+    try {
+        var pageTracker = _gat._getTracker("UA-3293801-14");
+        pageTracker._trackPageview();
+    } catch(err) {}
+</script>
+</body></html>
\ No newline at end of file
diff --git a/upgrade/1-iredmail.releases.md b/upgrade/1-iredmail.releases.md
index 07b2a06e..89344929 100644
--- a/upgrade/1-iredmail.releases.md
+++ b/upgrade/1-iredmail.releases.md
@@ -1,6 +1,8 @@
 # iRedMail release notes and upgrade tutorials
 
-> [Download the latest iRedMail stable release](../download.html)
+> iRedMail source code is hosted on [BitBucket](https://bitbucket.org/zhb/iredmail/overview).
+
+> Download the [latest iRedMail stable release](../download.html).
 
 #### Upgrading iRedMail
 
diff --git a/upgrade/upgrade.iredapd.md b/upgrade/upgrade.iredapd.md
new file mode 100644
index 00000000..47a6ac26
--- /dev/null
+++ b/upgrade/upgrade.iredapd.md
@@ -0,0 +1,38 @@
+# Upgrade iRedAPD
+
+> iRedAPD source code is hosted on [BitBucket](https://bitbucket.org/zhb/iredapd/overview).
+
+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.
+
+* Download the latest stable release here: [http://www.iredmail.org/yum/misc/](http://www.iredmail.org/yum/misc/)
+  For example, iRedAPD-1.4.4.tar.bz2.
+* Upload it to your iRedMail server. Assume it's `/root/iRedAPD-1.4.4.tar.bz2`.
+* Extract downloaded package and execute upgrade script:
+
+```
+# cd /root
+# tar xjf iRedAPD-1.4.4.tar.bz2
+# cd iRedAPD-1.4.4/tools/
+# bash upgrade_iredapd.sh
+```
+
+That's all.
+
+Notes:
+
+* It's recommended to enable plugin `reject_null_sender` in iRedAPD-1.4.4 or
+  newer releases to prevent authenticated user sending spam as null sender.
+
+* Since version 1.4.4, iRedAPD supports Postfix smtp protocol state
+  `END-OF-MESSAGE`, so you can enable iRedAPD in Postfix parameter
+  `smtpd_end_of_data_restrictions` like below:
+
+    ```smtpd_end_of_data_restrictions = check_policy_service inet:127.0.0.1:7777, ...```
+
+    Currently, only plugin `amavisd_message_size_limit` works in `END-OF-MESSAGE`
+    state, other plugins work in `RCPT` state.
+  
+* If you want to develop your own plugin for iRedAPD, please read document
+  `README_PLUGINS.md` in iRedAPD source code.
