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

Sync iRedMail upgrade tutorial.

This commit is contained in:
Zhang Huangbin 2018-11-01 20:42:19 +01:00
parent 0658c8954c
commit c583081452
8 changed files with 103 additions and 62 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
en_US/integrations/0-integration.mlmmj.ldap.md
View File

@ -152,7 +152,7 @@ query_filter = (&(|(objectClass=mailUser)(&(objectClass=mailList)(enabledServ
``` ```
* Run commands below to create file `/usr/bin/mlmmj-amime-receive` (Linux) or * Run commands below to create file `/usr/bin/mlmmj-amime-receive` (Linux) or
`/usr/local/bin/mlmmj-amime-receive` (Linux/FreeBSD): `/usr/local/bin/mlmmj-amime-receive` (FreeBSD/OpenBSD):
!!! attention !!! attention
@ -230,14 +230,14 @@ We will setup `mlmmjadmin` program to make managing mailing lists easier.
!!! attention !!! attention
We use version `1.8` for example below. We use version `1.9` for example below.
``` ```
cd /root/ cd /root/
wget https://github.com/iredmail/mlmmjadmin/archive/1.8.tar.gz wget https://github.com/iredmail/mlmmjadmin/archive/1.9.tar.gz
tar zxf 1.8.tar.gz -C /opt tar zxf 1.9.tar.gz -C /opt
rm -f 1.8.tar.gz rm -f 1.9.tar.gz
ln -s /opt/mlmmjadmin-1.8 /opt/mlmmjadmin ln -s /opt/mlmmjadmin-1.9 /opt/mlmmjadmin
``` ```
* Generate config file by copying sample file, `settings.py.sample`: * Generate config file by copying sample file, `settings.py.sample`:

12
en_US/integrations/0-integration.mlmmj.mysql.md
View File

@ -170,7 +170,7 @@ query = SELECT maillists.transport FROM maillists,domain WHERE maillists.a
``` ```
* Run commands below to create file `/usr/bin/mlmmj-amime-receive` (Linux) or * Run commands below to create file `/usr/bin/mlmmj-amime-receive` (Linux) or
`/usr/local/bin/mlmmj-amime-receive` (Linux/FreeBSD): `/usr/local/bin/mlmmj-amime-receive` (FreeBSD/OpenBSD):
!!! attention !!! attention
@ -248,14 +248,14 @@ We will setup `mlmmjadmin` program to make managing mailing lists easier.
!!! attention !!! attention
We use version `1.8` for example below. We use version `1.9` for example below.
``` ```
cd /root/ cd /root/
wget https://github.com/iredmail/mlmmjadmin/archive/1.8.tar.gz wget https://github.com/iredmail/mlmmjadmin/archive/1.9.tar.gz
tar zxf 1.8.tar.gz -C /opt tar zxf 1.9.tar.gz -C /opt
rm -f 1.8.tar.gz rm -f 1.9.tar.gz
ln -s /opt/mlmmjadmin-1.8 /opt/mlmmjadmin ln -s /opt/mlmmjadmin-1.9 /opt/mlmmjadmin
``` ```
* Generate config file by copying sample file, `settings.py.sample`: * Generate config file by copying sample file, `settings.py.sample`:

12
en_US/integrations/0-integration.mlmmj.pgsql.md
View File

@ -171,7 +171,7 @@ query = SELECT maillists.transport FROM maillists,domain WHERE maillists.a
``` ```
* Run commands below to create file `/usr/bin/mlmmj-amime-receive` (Linux) or * Run commands below to create file `/usr/bin/mlmmj-amime-receive` (Linux) or
`/usr/local/bin/mlmmj-amime-receive` (Linux/FreeBSD): `/usr/local/bin/mlmmj-amime-receive` (FreeBSD/OpenBSD):
!!! attention !!! attention
@ -249,14 +249,14 @@ We will setup `mlmmjadmin` program to make managing mailing lists easier.
!!! attention !!! attention
We use version `1.8` for example below. We use version `1.9` for example below.
``` ```
cd /root/ cd /root/
wget https://github.com/iredmail/mlmmjadmin/archive/1.8.tar.gz wget https://github.com/iredmail/mlmmjadmin/archive/1.9.tar.gz
tar zxf 1.8.tar.gz -C /opt tar zxf 1.9.tar.gz -C /opt
rm -f 1.8.tar.gz rm -f 1.9.tar.gz
ln -s /opt/mlmmjadmin-1.8 /opt/mlmmjadmin ln -s /opt/mlmmjadmin-1.9 /opt/mlmmjadmin
``` ```
* Generate config file by copying sample file, `settings.py.sample`: * Generate config file by copying sample file, `settings.py.sample`:

51
en_US/upgrade/0-upgrade.iredmail.0.9.8-0.9.9.md
View File

@ -8,13 +8,11 @@
check [the details](https://www.iredmail.org/support.html) and check [the details](https://www.iredmail.org/support.html) and
[contact us](https://www.iredmail.org/contact.html). [contact us](https://www.iredmail.org/contact.html).
## TODO
* Fix `mlmmj-amime-receive` and upgrade mlmmjadmin.
## ChangeLog ## ChangeLog
## General (All backends should apply these steps) * Nov 2, 2018, initial release.
## General (All backends should apply these changes)
### Update `/etc/iredmail-release` with new iRedMail version number ### Update `/etc/iredmail-release` with new iRedMail version number
@ -60,15 +58,6 @@ latest stable release immediately:
* [How to upgrade Roundcube](https://github.com/roundcube/roundcubemail/wiki/Upgrade). * [How to upgrade Roundcube](https://github.com/roundcube/roundcubemail/wiki/Upgrade).
### Fix incorrect file owner/group of mlmmjadmin config file
Please run commands below to fix incorrect file owner/group and permission:
```
chown mlmmj:mlmmj /opt/mlmmjadmin/settings.py
chmod 0400 /opt/mlmmjadmin/settings.py
```
### Fix improper Nginx config files for Roundcube ### Fix improper Nginx config files for Roundcube
Accurate Nginx url match helps avoid namespace conflicts, we need some fixes Accurate Nginx url match helps avoid namespace conflicts, we need some fixes
@ -114,6 +103,40 @@ location ~ ^/plugins/.*/config.inc.php.* { deny all; }
location ~ ^/plugins/enigma/home($|/.*) { deny all; } location ~ ^/plugins/enigma/home($|/.*) { deny all; }
``` ```
### Improve mlmmj script used for appending footer text
Run commands below to create file `/usr/bin/mlmmj-amime-receive` (Linux) or
`/usr/local/bin/mlmmj-amime-receive` (FreeBSD/OpenBSD):
On Linux:
```
cd /usr/bin/
rm -f mlmmj-amime-receive
wget https://bitbucket.org/zhb/iredmail/raw/default/iRedMail/samples/mlmmj/mlmmj-amime-receive
chown mlmmj:mlmmj mlmmj-amime-receive
chmod 0550 mlmmj-amime-receive
```
On FreeBSD or OpenBSD:
```
cd /usr/local/bin/
rm -f mlmmj-amime-receive
wget https://bitbucket.org/zhb/iredmail/raw/default/iRedMail/samples/mlmmj/mlmmj-amime-receive
chown mlmmj:mlmmj mlmmj-amime-receive
chmod 0550 mlmmj-amime-receive
```
### Fix incorrect file owner/group of mlmmjadmin config file
Please run commands below to fix incorrect file owner/group and permission:
```
chown mlmmj:mlmmj /opt/mlmmjadmin/settings.py
chmod 0400 /opt/mlmmjadmin/settings.py
```
### Fix address mapping issue for mlmmj mailing list ### Fix address mapping issue for mlmmj mailing list
With default settings of iRedMail-0.9.8, if you use a per-user alias address With default settings of iRedMail-0.9.8, if you use a per-user alias address

12
html/integration.mlmmj.ldap.html
View File

@ -173,7 +173,7 @@ scope = sub
<ul> <ul>
<li>Run commands below to create file <code>/usr/bin/mlmmj-amime-receive</code> (Linux) or <li>Run commands below to create file <code>/usr/bin/mlmmj-amime-receive</code> (Linux) or
<code>/usr/local/bin/mlmmj-amime-receive</code> (Linux/FreeBSD):</li> <code>/usr/local/bin/mlmmj-amime-receive</code> (FreeBSD/OpenBSD):</li>
</ul> </ul>
<div class="admonition attention"> <div class="admonition attention">
<p class="admonition-title">Attention</p> <p class="admonition-title">Attention</p>
@ -245,15 +245,15 @@ fully integrated.</p>
extract downloaded package to <code>/opt/</code> directory, and create a symbol link:</p> extract downloaded package to <code>/opt/</code> directory, and create a symbol link:</p>
<div class="admonition attention"> <div class="admonition attention">
<p class="admonition-title">Attention</p> <p class="admonition-title">Attention</p>
<p>We use version <code>1.8</code> for example below.</p> <p>We use version <code>1.9</code> for example below.</p>
</div> </div>
</li> </li>
</ul> </ul>
<pre><code>cd /root/ <pre><code>cd /root/
wget https://github.com/iredmail/mlmmjadmin/archive/1.8.tar.gz wget https://github.com/iredmail/mlmmjadmin/archive/1.9.tar.gz
tar zxf 1.8.tar.gz -C /opt tar zxf 1.9.tar.gz -C /opt
rm -f 1.8.tar.gz rm -f 1.9.tar.gz
ln -s /opt/mlmmjadmin-1.8 /opt/mlmmjadmin ln -s /opt/mlmmjadmin-1.9 /opt/mlmmjadmin
</code></pre> </code></pre>
<ul> <ul>

12
html/integration.mlmmj.mysql.html
View File

@ -191,7 +191,7 @@ query = SELECT maillists.transport FROM maillists,domain WHERE maillists.a
<ul> <ul>
<li>Run commands below to create file <code>/usr/bin/mlmmj-amime-receive</code> (Linux) or <li>Run commands below to create file <code>/usr/bin/mlmmj-amime-receive</code> (Linux) or
<code>/usr/local/bin/mlmmj-amime-receive</code> (Linux/FreeBSD):</li> <code>/usr/local/bin/mlmmj-amime-receive</code> (FreeBSD/OpenBSD):</li>
</ul> </ul>
<div class="admonition attention"> <div class="admonition attention">
<p class="admonition-title">Attention</p> <p class="admonition-title">Attention</p>
@ -263,15 +263,15 @@ fully integrated.</p>
extract downloaded package to <code>/opt/</code> directory, and create a symbol link:</p> extract downloaded package to <code>/opt/</code> directory, and create a symbol link:</p>
<div class="admonition attention"> <div class="admonition attention">
<p class="admonition-title">Attention</p> <p class="admonition-title">Attention</p>
<p>We use version <code>1.8</code> for example below.</p> <p>We use version <code>1.9</code> for example below.</p>
</div> </div>
</li> </li>
</ul> </ul>
<pre><code>cd /root/ <pre><code>cd /root/
wget https://github.com/iredmail/mlmmjadmin/archive/1.8.tar.gz wget https://github.com/iredmail/mlmmjadmin/archive/1.9.tar.gz
tar zxf 1.8.tar.gz -C /opt tar zxf 1.9.tar.gz -C /opt
rm -f 1.8.tar.gz rm -f 1.9.tar.gz
ln -s /opt/mlmmjadmin-1.8 /opt/mlmmjadmin ln -s /opt/mlmmjadmin-1.9 /opt/mlmmjadmin
</code></pre> </code></pre>
<ul> <ul>

12
html/integration.mlmmj.pgsql.html
View File

@ -192,7 +192,7 @@ query = SELECT maillists.transport FROM maillists,domain WHERE maillists.a
<ul> <ul>
<li>Run commands below to create file <code>/usr/bin/mlmmj-amime-receive</code> (Linux) or <li>Run commands below to create file <code>/usr/bin/mlmmj-amime-receive</code> (Linux) or
<code>/usr/local/bin/mlmmj-amime-receive</code> (Linux/FreeBSD):</li> <code>/usr/local/bin/mlmmj-amime-receive</code> (FreeBSD/OpenBSD):</li>
</ul> </ul>
<div class="admonition attention"> <div class="admonition attention">
<p class="admonition-title">Attention</p> <p class="admonition-title">Attention</p>
@ -264,15 +264,15 @@ fully integrated.</p>
extract downloaded package to <code>/opt/</code> directory, and create a symbol link:</p> extract downloaded package to <code>/opt/</code> directory, and create a symbol link:</p>
<div class="admonition attention"> <div class="admonition attention">
<p class="admonition-title">Attention</p> <p class="admonition-title">Attention</p>
<p>We use version <code>1.8</code> for example below.</p> <p>We use version <code>1.9</code> for example below.</p>
</div> </div>
</li> </li>
</ul> </ul>
<pre><code>cd /root/ <pre><code>cd /root/
wget https://github.com/iredmail/mlmmjadmin/archive/1.8.tar.gz wget https://github.com/iredmail/mlmmjadmin/archive/1.9.tar.gz
tar zxf 1.8.tar.gz -C /opt tar zxf 1.9.tar.gz -C /opt
rm -f 1.8.tar.gz rm -f 1.9.tar.gz
ln -s /opt/mlmmjadmin-1.8 /opt/mlmmjadmin ln -s /opt/mlmmjadmin-1.9 /opt/mlmmjadmin
</code></pre> </code></pre>
<ul> <ul>

42
html/upgrade.iredmail.0.9.8-0.9.9.html
View File

@ -19,15 +19,15 @@
<div class="toc"> <div class="toc">
<ul> <ul>
<li><a href="#upgrade-iredmail-from-098-to-099">Upgrade iRedMail from 0.9.8 to 0.9.9</a><ul> <li><a href="#upgrade-iredmail-from-098-to-099">Upgrade iRedMail from 0.9.8 to 0.9.9</a><ul>
<li><a href="#todo">TODO</a></li>
<li><a href="#changelog">ChangeLog</a></li> <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="#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="#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-23">Upgrade iRedAPD (Postfix policy server) to the latest stable release (2.3)</a></li> <li><a href="#upgrade-iredapd-postfix-policy-server-to-the-latest-stable-release-23">Upgrade iRedAPD (Postfix policy server) to the latest stable release (2.3)</a></li>
<li><a href="#upgrade-iredadmin-open-source-edition-to-the-latest-stable-release-10">Upgrade iRedAdmin (open source edition) to the latest stable release (1.0)</a></li> <li><a href="#upgrade-iredadmin-open-source-edition-to-the-latest-stable-release-10">Upgrade iRedAdmin (open source edition) to the latest stable release (1.0)</a></li>
<li><a href="#upgrade-roundcube-webmail-to-the-latest-stable-release-138">Upgrade Roundcube webmail to the latest stable release (1.3.8)</a></li> <li><a href="#upgrade-roundcube-webmail-to-the-latest-stable-release-138">Upgrade Roundcube webmail to the latest stable release (1.3.8)</a></li>
<li><a href="#fix-incorrect-file-ownergroup-of-mlmmjadmin-config-file">Fix incorrect file owner/group of mlmmjadmin config file</a></li>
<li><a href="#fix-improper-nginx-config-files-for-roundcube">Fix improper Nginx config files for Roundcube</a></li> <li><a href="#fix-improper-nginx-config-files-for-roundcube">Fix improper Nginx config files for Roundcube</a></li>
<li><a href="#improve-mlmmj-script-used-for-appending-footer-text">Improve mlmmj script used for appending footer text</a></li>
<li><a href="#fix-incorrect-file-ownergroup-of-mlmmjadmin-config-file">Fix incorrect file owner/group of mlmmjadmin config file</a></li>
<li><a href="#fix-address-mapping-issue-for-mlmmj-mailing-list">Fix address mapping issue for mlmmj mailing list</a></li> <li><a href="#fix-address-mapping-issue-for-mlmmj-mailing-list">Fix address mapping issue for mlmmj mailing list</a></li>
</ul> </ul>
</li> </li>
@ -60,11 +60,10 @@
check <a href="https://www.iredmail.org/support.html">the details</a> and 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> <a href="https://www.iredmail.org/contact.html">contact us</a>.</p>
</div> </div>
<h2 id="todo">TODO</h2>
<ul>
<li>Fix <code>mlmmj-amime-receive</code> and upgrade mlmmjadmin.</li>
</ul>
<h2 id="changelog">ChangeLog</h2> <h2 id="changelog">ChangeLog</h2>
<ul>
<li>Nov 2, 2018, initial release.</li>
</ul>
<h2 id="general-all-backends-should-apply-these-steps">General (All backends should apply these steps)</h2> <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> <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 <p>iRedMail stores the release version in <code>/etc/iredmail-release</code> after
@ -103,12 +102,6 @@ latest stable release immediately:</p>
<ul> <ul>
<li><a href="https://github.com/roundcube/roundcubemail/wiki/Upgrade">How to upgrade Roundcube</a>.</li> <li><a href="https://github.com/roundcube/roundcubemail/wiki/Upgrade">How to upgrade Roundcube</a>.</li>
</ul> </ul>
<h3 id="fix-incorrect-file-ownergroup-of-mlmmjadmin-config-file">Fix incorrect file owner/group of mlmmjadmin config file</h3>
<p>Please run commands below to fix incorrect file owner/group and permission:</p>
<pre><code>chown mlmmj:mlmmj /opt/mlmmjadmin/settings.py
chmod 0400 /opt/mlmmjadmin/settings.py
</code></pre>
<h3 id="fix-improper-nginx-config-files-for-roundcube">Fix improper Nginx config files for Roundcube</h3> <h3 id="fix-improper-nginx-config-files-for-roundcube">Fix improper Nginx config files for Roundcube</h3>
<p>Accurate Nginx url match helps avoid namespace conflicts, we need some fixes <p>Accurate Nginx url match helps avoid namespace conflicts, we need some fixes
for Roundcube to get accurate url match.</p> for Roundcube to get accurate url match.</p>
@ -143,6 +136,31 @@ location ~ ^/plugins/.*/config.inc.php.* { deny all; }
location ~ ^/plugins/enigma/home($|/.*) { deny all; } location ~ ^/plugins/enigma/home($|/.*) { deny all; }
</code></pre> </code></pre>
<h3 id="improve-mlmmj-script-used-for-appending-footer-text">Improve mlmmj script used for appending footer text</h3>
<p>Run commands below to create file <code>/usr/bin/mlmmj-amime-receive</code> (Linux) or
<code>/usr/local/bin/mlmmj-amime-receive</code> (FreeBSD/OpenBSD):</p>
<p>On Linux:</p>
<pre><code>cd /usr/bin/
rm -f mlmmj-amime-receive
wget https://bitbucket.org/zhb/iredmail/raw/default/iRedMail/samples/mlmmj/mlmmj-amime-receive
chown mlmmj:mlmmj mlmmj-amime-receive
chmod 0550 mlmmj-amime-receive
</code></pre>
<p>On FreeBSD or OpenBSD:</p>
<pre><code>cd /usr/local/bin/
rm -f mlmmj-amime-receive
wget https://bitbucket.org/zhb/iredmail/raw/default/iRedMail/samples/mlmmj/mlmmj-amime-receive
chown mlmmj:mlmmj mlmmj-amime-receive
chmod 0550 mlmmj-amime-receive
</code></pre>
<h3 id="fix-incorrect-file-ownergroup-of-mlmmjadmin-config-file">Fix incorrect file owner/group of mlmmjadmin config file</h3>
<p>Please run commands below to fix incorrect file owner/group and permission:</p>
<pre><code>chown mlmmj:mlmmj /opt/mlmmjadmin/settings.py
chmod 0400 /opt/mlmmjadmin/settings.py
</code></pre>
<h3 id="fix-address-mapping-issue-for-mlmmj-mailing-list">Fix address mapping issue for mlmmj mailing list</h3> <h3 id="fix-address-mapping-issue-for-mlmmj-mailing-list">Fix address mapping issue for mlmmj mailing list</h3>
<p>With default settings of iRedMail-0.9.8, if you use a per-user alias address <p>With default settings of iRedMail-0.9.8, if you use a per-user alias address
as member of a mailing list, Postfix doesn't not expand it to the final as member of a mailing list, Postfix doesn't not expand it to the final