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
`/usr/local/bin/mlmmj-amime-receive` (Linux/FreeBSD):
`/usr/local/bin/mlmmj-amime-receive` (FreeBSD/OpenBSD):
!!! attention
@ -230,14 +230,14 @@ We will setup `mlmmjadmin` program to make managing mailing lists easier.
!!! attention
We use version `1.8` for example below.
We use version `1.9` for example below.
```
cd /root/
wget https://github.com/iredmail/mlmmjadmin/archive/1.8.tar.gz
tar zxf 1.8.tar.gz -C /opt
rm -f 1.8.tar.gz
ln -s /opt/mlmmjadmin-1.8 /opt/mlmmjadmin
wget https://github.com/iredmail/mlmmjadmin/archive/1.9.tar.gz
tar zxf 1.9.tar.gz -C /opt
rm -f 1.9.tar.gz
ln -s /opt/mlmmjadmin-1.9 /opt/mlmmjadmin
```
* 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
`/usr/local/bin/mlmmj-amime-receive` (Linux/FreeBSD):
`/usr/local/bin/mlmmj-amime-receive` (FreeBSD/OpenBSD):
!!! attention
@ -248,14 +248,14 @@ We will setup `mlmmjadmin` program to make managing mailing lists easier.
!!! attention
We use version `1.8` for example below.
We use version `1.9` for example below.
```
cd /root/
wget https://github.com/iredmail/mlmmjadmin/archive/1.8.tar.gz
tar zxf 1.8.tar.gz -C /opt
rm -f 1.8.tar.gz
ln -s /opt/mlmmjadmin-1.8 /opt/mlmmjadmin
wget https://github.com/iredmail/mlmmjadmin/archive/1.9.tar.gz
tar zxf 1.9.tar.gz -C /opt
rm -f 1.9.tar.gz
ln -s /opt/mlmmjadmin-1.9 /opt/mlmmjadmin
```
* 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
`/usr/local/bin/mlmmj-amime-receive` (Linux/FreeBSD):
`/usr/local/bin/mlmmj-amime-receive` (FreeBSD/OpenBSD):
!!! attention
@ -249,14 +249,14 @@ We will setup `mlmmjadmin` program to make managing mailing lists easier.
!!! attention
We use version `1.8` for example below.
We use version `1.9` for example below.
```
cd /root/
wget https://github.com/iredmail/mlmmjadmin/archive/1.8.tar.gz
tar zxf 1.8.tar.gz -C /opt
rm -f 1.8.tar.gz
ln -s /opt/mlmmjadmin-1.8 /opt/mlmmjadmin
wget https://github.com/iredmail/mlmmjadmin/archive/1.9.tar.gz
tar zxf 1.9.tar.gz -C /opt
rm -f 1.9.tar.gz
ln -s /opt/mlmmjadmin-1.9 /opt/mlmmjadmin
```
* 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
[contact us](https://www.iredmail.org/contact.html).
## TODO
* Fix `mlmmj-amime-receive` and upgrade mlmmjadmin.
## 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
@ -60,15 +58,6 @@ latest stable release immediately:
* [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
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; }
```
### 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
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>
<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>
<div class="admonition attention">
<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>
<div class="admonition attention">
<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>
</li>
</ul>
<pre><code>cd /root/
wget https://github.com/iredmail/mlmmjadmin/archive/1.8.tar.gz
tar zxf 1.8.tar.gz -C /opt
rm -f 1.8.tar.gz
ln -s /opt/mlmmjadmin-1.8 /opt/mlmmjadmin
wget https://github.com/iredmail/mlmmjadmin/archive/1.9.tar.gz
tar zxf 1.9.tar.gz -C /opt
rm -f 1.9.tar.gz
ln -s /opt/mlmmjadmin-1.9 /opt/mlmmjadmin
</code></pre>
<ul>

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

@ -191,7 +191,7 @@ query = SELECT maillists.transport FROM maillists,domain WHERE maillists.a
<ul>
<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>
<div class="admonition attention">
<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>
<div class="admonition attention">
<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>
</li>
</ul>
<pre><code>cd /root/
wget https://github.com/iredmail/mlmmjadmin/archive/1.8.tar.gz
tar zxf 1.8.tar.gz -C /opt
rm -f 1.8.tar.gz
ln -s /opt/mlmmjadmin-1.8 /opt/mlmmjadmin
wget https://github.com/iredmail/mlmmjadmin/archive/1.9.tar.gz
tar zxf 1.9.tar.gz -C /opt
rm -f 1.9.tar.gz
ln -s /opt/mlmmjadmin-1.9 /opt/mlmmjadmin
</code></pre>
<ul>

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

@ -192,7 +192,7 @@ query = SELECT maillists.transport FROM maillists,domain WHERE maillists.a
<ul>
<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>
<div class="admonition attention">
<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>
<div class="admonition attention">
<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>
</li>
</ul>
<pre><code>cd /root/
wget https://github.com/iredmail/mlmmjadmin/archive/1.8.tar.gz
tar zxf 1.8.tar.gz -C /opt
rm -f 1.8.tar.gz
ln -s /opt/mlmmjadmin-1.8 /opt/mlmmjadmin
wget https://github.com/iredmail/mlmmjadmin/archive/1.9.tar.gz
tar zxf 1.9.tar.gz -C /opt
rm -f 1.9.tar.gz
ln -s /opt/mlmmjadmin-1.9 /opt/mlmmjadmin
</code></pre>
<ul>

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

@ -19,15 +19,15 @@
<div class="toc">
<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="#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-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-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="#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>
</ul>
</li>
@ -60,11 +60,10 @@
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="todo">TODO</h2>
<ul>
<li>Fix <code>mlmmj-amime-receive</code> and upgrade mlmmjadmin.</li>
</ul>
<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>
<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
@ -103,12 +102,6 @@ latest stable release immediately:</p>
<ul>
<li><a href="https://github.com/roundcube/roundcubemail/wiki/Upgrade">How to upgrade Roundcube</a>.</li>
</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>
<p>Accurate Nginx url match helps avoid namespace conflicts, we need some fixes
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; }
</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>
<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