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

Update en_US/installation/0-install.iredmail.with.remote.mysql.server.md with new installation parameters.

This commit is contained in:
Zhang Huangbin 2017-03-02 19:44:52 +08:00
parent 16bb24ab78
commit 1955c9630c
10 changed files with 40 additions and 72 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

31
en_US/installation/0-install.iredmail.with.remote.mysql.server.md
View File

@ -4,9 +4,8 @@
## Summary
This article describes how to install iRedMail (iRedMail-0.8.6 or later
releases) with a remote MySQL server, and you must choose MySQL backend in
iRedMail installation wizard.
This article introduces how to install iRedMail-__0.9.6__ with an existing remote
MySQL server.
We use below server IP addresses in our example:
@ -15,7 +14,8 @@ We use below server IP addresses in our example:
on this server.
iRedMail won't install MySQL server (RPM/DEB package) on localhost with remote
MySQL server, but MySQL client tools are still required for remote connection.
MySQL server, but MySQL client tools are still required for remote SQL
connection.
## Requirements
@ -98,21 +98,21 @@ mysql> DROP USER 'vmailadmin'@'192.168.1.200';
Please follow iRedMail installation guide strictly, but start iRedMail
installer with below command instead of the original one (`bash iRedMail.sh`):
> WARNING:
>
> * The variable names (`MYSQL_SERVER_ADDRESS`, `MYSQL_SERVER_PORT`,
> `MYSQL_ROOT_USER`, `MYSQL_GRANT_HOST`) are __CASE SENSITIVE__.
> * With `iRedMail-0.9.2` and earlier releases, it's `MYSQL_SERVER`, not
> `MYSQL_SERVER_ADDRESS`.
```
# MYSQL_SERVER_ADDRESS='192.168.1.100' MYSQL_SERVER_PORT='3306' MYSQL_ROOT_USER='admin_iredmail' MYSQL_ROOT_PASSWD='admin_password' MYSQL_GRANT_HOST='192.168.1.200' bash iRedMail.sh
USE_EXISTING_MYSQL='YES' \
MYSQL_SERVER_ADDRESS='192.168.1.100' \
MYSQL_SERVER_PORT='3306' \
MYSQL_ROOT_USER='admin_iredmail' \
MYSQL_ROOT_PASSWD='admin_password' \
MYSQL_GRANT_HOST='192.168.1.200' \
bash iRedMail.sh
```
It will launch iRedMail installation wizard as usual.
Parameters we used in above command line:
* `USE_EXISTING_MYSQL`: Remote MySQL server address.
* `MYSQL_SERVER_ADDRESS`: Remote MySQL server address.
* `MYSQL_SERVER_PORT`: Remote MySQL server port. Default is `3306`.
* `MYSQL_ROOT_USER`: MySQL user name we created on remote MySQL server before installing iRedMail.
@ -123,9 +123,10 @@ iRedMail will create new SQL users for applications like Postfix, Amavisd,
Roundcube webmail, etc, and grant proper privileges to them which will connect
from iRedMail server.
One more optional parameter is `MYSQL_SERVER_PORT`. it specifies listen port
of remote MySQL server. Default one is `3306`, you can change it if remote
MySQL server is running on a different port.
One more optional parameter is `INITIALIZE_SQL_DATA`. If you don't want
iRedMail installer to initialize any sql records, please set
`INITIALIZE_SQL_DATA=NO`. This way iRedMail installer will just configure
related config files to use remote MySQL server.
## After iRedMail installation

6
en_US/mua/1-activesync.android.md
View File

@ -11,11 +11,7 @@
* Outlook 2010 for Windows supports MAPI.
iRedMail doesn't integrate [OpenChange](http://www.openchange.org) and
[Samba4](http://www.samba.org) for native MAPI support, so SOGo groupware
in iRedMail doesn't provide full support for Microsoft Outlook clients,
Mac OS X Mail.app and all iOS devices, don't try to add your mail account
as an `Exchange` account in these mail clients. You have to add account as
POP3/IMAP account, caldav/carddav account instead.
[Samba4](http://www.samba.org) for native MAPI support.
## Requirements

6
en_US/mua/1-activesync.bb10.md
View File

@ -11,11 +11,7 @@
* Outlook 2010 for Windows supports MAPI.
iRedMail doesn't integrate [OpenChange](http://www.openchange.org) and
[Samba4](http://www.samba.org) for native MAPI support, so SOGo groupware
in iRedMail doesn't provide full support for Microsoft Outlook clients,
Mac OS X Mail.app and all iOS devices, don't try to add your mail account
as an `Exchange` account in these mail clients. You have to add account as
POP3/IMAP account, caldav/carddav account instead.
[Samba4](http://www.samba.org) for native MAPI support.
## Requirements

6
en_US/mua/1-activesync.ios.md
View File

@ -11,11 +11,7 @@
* Outlook 2010 for Windows supports MAPI.
iRedMail doesn't integrate [OpenChange](http://www.openchange.org) and
[Samba4](http://www.samba.org) for native MAPI support, so SOGo groupware
in iRedMail doesn't provide full support for Microsoft Outlook clients,
Mac OS X Mail.app and all iOS devices, don't try to add your mail account
as an `Exchange` account in these mail clients. You have to add account as
POP3/IMAP account, caldav/carddav account instead.
[Samba4](http://www.samba.org) for native MAPI support.
## Requirements

6
en_US/mua/1-activesync.outlook.md
View File

@ -11,11 +11,7 @@
* Outlook 2010 for Windows supports MAPI.
iRedMail doesn't integrate [OpenChange](http://www.openchange.org) and
[Samba4](http://www.samba.org) for native MAPI support, so SOGo groupware
in iRedMail doesn't provide full support for Microsoft Outlook clients,
Mac OS X Mail.app and all iOS devices, don't try to add your mail account
as an `Exchange` account in these mail clients. You have to add account as
POP3/IMAP account, caldav/carddav account instead.
[Samba4](http://www.samba.org) for native MAPI support.
## Requirements

6
html/activesync.android.html
View File

@ -28,11 +28,7 @@
<li>Outlook 2010 for Windows supports MAPI.</li>
</ul>
<p>iRedMail doesn't integrate <a href="http://www.openchange.org">OpenChange</a> and
<a href="http://www.samba.org">Samba4</a> for native MAPI support, so SOGo groupware
in iRedMail doesn't provide full support for Microsoft Outlook clients,
Mac OS X Mail.app and all iOS devices, don't try to add your mail account
as an <code>Exchange</code> account in these mail clients. You have to add account as
POP3/IMAP account, caldav/carddav account instead.</p>
<a href="http://www.samba.org">Samba4</a> for native MAPI support.</p>
</div>
<h2 id="requirements">Requirements</h2>
<ul>

6
html/activesync.bb10.html
View File

@ -28,11 +28,7 @@
<li>Outlook 2010 for Windows supports MAPI.</li>
</ul>
<p>iRedMail doesn't integrate <a href="http://www.openchange.org">OpenChange</a> and
<a href="http://www.samba.org">Samba4</a> for native MAPI support, so SOGo groupware
in iRedMail doesn't provide full support for Microsoft Outlook clients,
Mac OS X Mail.app and all iOS devices, don't try to add your mail account
as an <code>Exchange</code> account in these mail clients. You have to add account as
POP3/IMAP account, caldav/carddav account instead.</p>
<a href="http://www.samba.org">Samba4</a> for native MAPI support.</p>
</div>
<h2 id="requirements">Requirements</h2>
<ul>

6
html/activesync.ios.html
View File

@ -28,11 +28,7 @@
<li>Outlook 2010 for Windows supports MAPI.</li>
</ul>
<p>iRedMail doesn't integrate <a href="http://www.openchange.org">OpenChange</a> and
<a href="http://www.samba.org">Samba4</a> for native MAPI support, so SOGo groupware
in iRedMail doesn't provide full support for Microsoft Outlook clients,
Mac OS X Mail.app and all iOS devices, don't try to add your mail account
as an <code>Exchange</code> account in these mail clients. You have to add account as
POP3/IMAP account, caldav/carddav account instead.</p>
<a href="http://www.samba.org">Samba4</a> for native MAPI support.</p>
</div>
<h2 id="requirements">Requirements</h2>
<ul>

6
html/activesync.outlook.html
View File

@ -28,11 +28,7 @@
<li>Outlook 2010 for Windows supports MAPI.</li>
</ul>
<p>iRedMail doesn't integrate <a href="http://www.openchange.org">OpenChange</a> and
<a href="http://www.samba.org">Samba4</a> for native MAPI support, so SOGo groupware
in iRedMail doesn't provide full support for Microsoft Outlook clients,
Mac OS X Mail.app and all iOS devices, don't try to add your mail account
as an <code>Exchange</code> account in these mail clients. You have to add account as
POP3/IMAP account, caldav/carddav account instead.</p>
<a href="http://www.samba.org">Samba4</a> for native MAPI support.</p>
</div>
<h2 id="requirements">Requirements</h2>
<ul>

33
html/install.iredmail.with.remote.mysql.server.html
View File

@ -28,9 +28,8 @@
</ul>
</div>
<h2 id="summary">Summary</h2>
<p>This article describes how to install iRedMail (iRedMail-0.8.6 or later
releases) with a remote MySQL server, and you must choose MySQL backend in
iRedMail installation wizard.</p>
<p>This article introduces how to install iRedMail-<strong>0.9.6</strong> with an existing remote
MySQL server.</p>
<p>We use below server IP addresses in our example:</p>
<ul>
<li><code>192.168.1.100</code>: Remote MySQL server.</li>
@ -38,7 +37,8 @@ iRedMail installation wizard.</p>
on this server.</li>
</ul>
<p>iRedMail won't install MySQL server (RPM/DEB package) on localhost with remote
MySQL server, but MySQL client tools are still required for remote connection.</p>
MySQL server, but MySQL client tools are still required for remote SQL
connection.</p>
<h2 id="requirements">Requirements</h2>
<p>In our case, remote MySQL server runs on server <code>192.168.1.100</code>. It must accept
remote connection from iRedMail server <strong>BEFORE</strong> installing iRedMail, and we
@ -115,21 +115,19 @@ mysql&gt; DROP USER 'vmailadmin'@'192.168.1.200';
<h2 id="install-iredmail">Install iRedMail</h2>
<p>Please follow iRedMail installation guide strictly, but start iRedMail
installer with below command instead of the original one (<code>bash iRedMail.sh</code>):</p>
<blockquote>
<p>WARNING:</p>
<ul>
<li>The variable names (<code>MYSQL_SERVER_ADDRESS</code>, <code>MYSQL_SERVER_PORT</code>,
<code>MYSQL_ROOT_USER</code>, <code>MYSQL_GRANT_HOST</code>) are <strong>CASE SENSITIVE</strong>.</li>
<li>With <code>iRedMail-0.9.2</code> and earlier releases, it's <code>MYSQL_SERVER</code>, not
<code>MYSQL_SERVER_ADDRESS</code>.</li>
</ul>
</blockquote>
<pre><code># MYSQL_SERVER_ADDRESS='192.168.1.100' MYSQL_SERVER_PORT='3306' MYSQL_ROOT_USER='admin_iredmail' MYSQL_ROOT_PASSWD='admin_password' MYSQL_GRANT_HOST='192.168.1.200' bash iRedMail.sh
<pre><code>USE_EXISTING_MYSQL='YES' \
MYSQL_SERVER_ADDRESS='192.168.1.100' \
MYSQL_SERVER_PORT='3306' \
MYSQL_ROOT_USER='admin_iredmail' \
MYSQL_ROOT_PASSWD='admin_password' \
MYSQL_GRANT_HOST='192.168.1.200' \
bash iRedMail.sh
</code></pre>
<p>It will launch iRedMail installation wizard as usual.</p>
<p>Parameters we used in above command line:</p>
<ul>
<li><code>USE_EXISTING_MYSQL</code>: Remote MySQL server address.</li>
<li><code>MYSQL_SERVER_ADDRESS</code>: Remote MySQL server address.</li>
<li><code>MYSQL_SERVER_PORT</code>: Remote MySQL server port. Default is <code>3306</code>.</li>
<li><code>MYSQL_ROOT_USER</code>: MySQL user name we created on remote MySQL server before installing iRedMail.</li>
@ -139,9 +137,10 @@ installer with below command instead of the original one (<code>bash iRedMail.sh
<p>iRedMail will create new SQL users for applications like Postfix, Amavisd,
Roundcube webmail, etc, and grant proper privileges to them which will connect
from iRedMail server.</p>
<p>One more optional parameter is <code>MYSQL_SERVER_PORT</code>. it specifies listen port
of remote MySQL server. Default one is <code>3306</code>, you can change it if remote
MySQL server is running on a different port.</p>
<p>One more optional parameter is <code>INITIALIZE_SQL_DATA</code>. If you don't want
iRedMail installer to initialize any sql records, please set
<code>INITIALIZE_SQL_DATA=NO</code>. This way iRedMail installer will just configure
related config files to use remote MySQL server.</p>
<h2 id="after-iredmail-installation">After iRedMail installation</h2>
<p>As mentioned above, it's now ok to delete the new MySQL user <code>admin_iredmail</code>
on remote MySQL server. It will not be used anymore.</p>