New: migrate.to.iredmail.easy.html.
This commit is contained in:
Zhang Huangbin
parent
9a3de1da1a
commit
07611127af
|
|
@ -0,0 +1,112 @@
|
|||
# Migrate from iRedMail to iRedMail Easy platform
|
||||
|
||||
[TOC]
|
||||
|
||||
!!! attention
|
||||
|
||||
iRedMail Team can help migrate your iRedMail server, feel free to
|
||||
[Contact Us](https://www.iredmail.org/contact.html).
|
||||
|
||||
## Summary
|
||||
|
||||
iRedMail Easy platform offers deployment, one-click upgrade support and
|
||||
technical support for your iRedMail servers, it's very easy to keep your
|
||||
server up to date with the ease to use web UI, and get issues solved by
|
||||
iRedMail Team quickly.
|
||||
|
||||
For more details about iRedMail Easy platform, please
|
||||
[check our website](https://www.iredmail.org/easy.html).
|
||||
|
||||
## Requirements
|
||||
|
||||
- A working iRedMail server which was deployed with the downlodable installer
|
||||
`iRedMail-0.9.9`, or has been successfully upgraded to the latest
|
||||
iRedMail-0.9.9 release.
|
||||
- Your iRedMail server must be running one of supported Linux/OpenBSD
|
||||
distribution releases:
|
||||
- Ubuntu 18.04 LTS
|
||||
- Debian 9
|
||||
- CentOS 7
|
||||
- OpenBSD 6.4, 6.5
|
||||
|
||||
Unfortunately, FreeBSD is not supported by iRedMail Easy platform.
|
||||
|
||||
## Create required files used by iRedMail Easy
|
||||
|
||||
iRedMail Easy doesn't store any SQL/LDAP passwords, instead it reads from files
|
||||
under `/root/.iredmail/kv/` on your server to get them.
|
||||
|
||||
Please create these files under `/root/.iredmail/kv/` with correct passwords
|
||||
manually, each file should contain only one line, passwords must be in plain
|
||||
text, not the hashed one.
|
||||
|
||||
!!! attention
|
||||
|
||||
You can find all info in the `iRedMail.tips` file under iRedMail
|
||||
installation directory, for example, `/root/iRedMail-0.9.9/iRedMail.tips`.
|
||||
If you don't have this file anymore, you can still find them in other
|
||||
config files.
|
||||
|
||||
* `mysql_root_password`: the MySQL root password. This is required for OpenLDAP
|
||||
and MySQL/MariaDB backends. You can find it in file `/root/.my.cnf` or `/root/.my.cnf-root`.
|
||||
* `pgsql_root_password`: The PostgreSQL root password. This is required for
|
||||
PostgreSQL backend. You can find it in the `.pgpass` file under PostgreSQL
|
||||
data directory.
|
||||
- on CentOS, it's `/var/lib/pgsql/.pgpass`.
|
||||
- on Debian/Ubuntu, it's `/var/lib/postgresql/.pgpass`.
|
||||
- on OpenBSD, it's `/var/postgresql/.pgpass`.
|
||||
* `ldap_root_password`: The password of OpenLDAP root dn (cn=Manager,dc=xx,dc=xx).
|
||||
This is required for OpenLDAP backend.
|
||||
* `ldap_vmail_password`: The password of LDAP dn `cn=vmail,dc=xx,dc=xx`.
|
||||
* `ldap_vmailadmin_password`: The password of LDAP dn `cn=vmailadmin,dc=xx,dc=xx`.
|
||||
* `vmail_db_password`: The password of SQL user `vmail`.
|
||||
* `vmail_db_admin_password`: The password of SQL user `vmailadmin`.
|
||||
* `amavisd_db_password`: The password of SQL user `amavisd`.
|
||||
* `sa_bayes_db_password`: The password of SQL user `sa_bayes`.
|
||||
* `iredadmin_db_password`: The password of SQL user `iredadmin`.
|
||||
* `iredapd_db_password`: The password of SQL user `iredapd`.
|
||||
* `iredapd_srs_secret`: The secret string used by iRedAPD to sign SRS.
|
||||
* `sogo_db_password`: The password of SQL user `sogo`.
|
||||
* `sogo_sieve_master_password`: The Dovecot master user used by SOGo. You can find it in `/etc/sogo/sieve.cred`.
|
||||
* `roundcube_db_password`: The password of SQL user `roundcube`.
|
||||
* `roundcube_des_key`: The DES key used by Roundcube to encrypt the session. You can find it in `/opt/www/roundcubemail/config/config.inc.php`, parameter `$config['des_key'] =`.
|
||||
* `mlmmjadmin_api_token`: The token string used by iRedAdmin-Pro to communicate with mlmmjadmin. You can find it in `/opt/mlmmjadmin/settings.py`, parameter `api_auth_tokens =`.
|
||||
* `netdata_db_password`: The password of SQL user `netdata`. You can find it in `/root/.my.cnf-netdata` or `/opt/netdata/etc/netdata/my.cnf`.
|
||||
* `first_domain_admin_password`: The password of the first mail user created during iRedMail installation.
|
||||
|
||||
## Copy files to new locations
|
||||
|
||||
iRedMail Easy stores SSL cert/key files under `/opt/iredmail/ssl/`, you need to
|
||||
either copy or (symbol) link existing ssl cert/key to this directory with
|
||||
correct files names,
|
||||
|
||||
* `/opt/iredmail/ssl/key.pem`: private key
|
||||
* `/opt/iredmail/ssl/cert.pem`: certificate
|
||||
* `/opt/iredmail/ssl/combined.pem`: full chain
|
||||
|
||||
## Run the full deployment with iRedMail Easy platform
|
||||
|
||||
Please follow our tutorial [Getting start with iRedMail Easy](./iredmail-easy.getting.start.html)
|
||||
to sign up, and add your mail server info, then perform the full deployment.
|
||||
|
||||
## Post-installation setup
|
||||
|
||||
iRedMail Easy will re-generate most config files, custom settings will be
|
||||
loaded from files under `/opt/iredmail/custom/`, so if you have any
|
||||
customizations, you may need to copy your custom settings to files under
|
||||
`/opt/iredmail/custom/`.
|
||||
|
||||
### Postfix config files
|
||||
|
||||
iRedMail Easy will rewrite config files under `/etc/postfix/`, most importantly
|
||||
`main.cf` and `master.cf`. If you have any changes in these 2 files, please
|
||||
read the `[Best Practice](./iredmail-easy.best.practice.html)` document to
|
||||
understand how to customize them with shell script
|
||||
`/opt/iredmail/custom/postfix/custom.sh`.
|
||||
|
||||
For customizations you made in other files under `/etc/postfix/`, you must
|
||||
move the customizations to files under `/opt/iredmail/custom/postfix/` which
|
||||
have same file names.
|
||||
|
||||
For example, if you added some rules in `/etc/postfix/helo_access.pcre`, you
|
||||
should copy these rules to file `/opt/iredmail/custom/postfix/helo_access.pcre`.
|
||||
|
|
@ -79,6 +79,7 @@
|
|||
<li><a href="iredmail-easy.getting.start.html">Getting start with iRedMail Easy - the deployment and support platform</a></li>
|
||||
<li><a href="iredmail-easy.best.practice.html">Best Practice</a></li>
|
||||
<li><a href="iredmail-easy.release.notes.html">Release Notes</a></li>
|
||||
<li><a href="migrate.to.iredmail.easy.html">Migrate from iRedMail to iRedMail Easy platform</a></li>
|
||||
<li><a href="iredmail-easy.unsubscribe.html">How to cancel your subscription</a></li>
|
||||
<li><a href="iredmail-easy.autoconfig.autodiscover.html">Setup DNS records for autoconfig and autodiscover</a></li>
|
||||
<li><a href="iredmail-easy.setup-sudo.html">Setup sudo for deployment with iRedMail Easy</a></li>
|
||||
|
|
|
|||
|
|
@ -0,0 +1,131 @@
|
|||
<!DOCTYPE html>
|
||||
<html>
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
||||
<title>Migrate from iRedMail to iRedMail Easy platform</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;"
|
||||
/>
|
||||
<span>iRedMail</span>
|
||||
</a>
|
||||
// <a href="./index.html">Document Index</a></div><h1 id="migrate-from-iredmail-to-iredmail-easy-platform">Migrate from iRedMail to iRedMail Easy platform</h1>
|
||||
<div class="toc">
|
||||
<ul>
|
||||
<li><a href="#migrate-from-iredmail-to-iredmail-easy-platform">Migrate from iRedMail to iRedMail Easy platform</a><ul>
|
||||
<li><a href="#summary">Summary</a></li>
|
||||
<li><a href="#requirements">Requirements</a></li>
|
||||
<li><a href="#create-required-files-used-by-iredmail-easy">Create required files used by iRedMail Easy</a></li>
|
||||
<li><a href="#copy-files-to-new-locations">Copy files to new locations</a><ul>
|
||||
<li><a href="#ssl-cert">SSL cert</a></li>
|
||||
<li><a href="#postfix-config-files">Postfix config files</a></li>
|
||||
</ul>
|
||||
</li>
|
||||
</ul>
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
<div class="admonition attention">
|
||||
<p class="admonition-title">Attention</p>
|
||||
<p>iRedMail Team can help migrate your iRedMail server, feel free to
|
||||
<a href="https://www.iredmail.org/contact.html">Contact Us</a>.</p>
|
||||
</div>
|
||||
<h2 id="summary">Summary</h2>
|
||||
<p>iRedMail Easy platform offers deployment, one-click upgrade support and
|
||||
technical support for your iRedMail servers, it's very easy to keep your
|
||||
server up to date with the ease to use web UI, and get issues solved by
|
||||
iRedMail Team quickly.</p>
|
||||
<p>For more details about iRedMail Easy platform, please
|
||||
<a href="https://www.iredmail.org/easy.html">check our website</a>.</p>
|
||||
<h2 id="requirements">Requirements</h2>
|
||||
<ul>
|
||||
<li>A working iRedMail server which was deployed with the downlodable installer
|
||||
<code>iRedMail-0.9.9</code>, or has been successfully upgraded to the latest
|
||||
iRedMail-0.9.9 release.</li>
|
||||
<li>Your iRedMail server must be running one of supported Linux/OpenBSD
|
||||
distribution releases:<ul>
|
||||
<li>Ubuntu 18.04 LTS</li>
|
||||
<li>Debian 9</li>
|
||||
<li>CentOS 7</li>
|
||||
<li>OpenBSD 6.4, 6.5</li>
|
||||
</ul>
|
||||
</li>
|
||||
</ul>
|
||||
<p>Unfortunately, FreeBSD is not supported by iRedMail Easy platform.</p>
|
||||
<h2 id="create-required-files-used-by-iredmail-easy">Create required files used by iRedMail Easy</h2>
|
||||
<p>iRedMail Easy doesn't store any SQL/LDAP passwords, instead it reads from files
|
||||
under <code>/root/.iredmail/kv/</code> on your server to get them.</p>
|
||||
<p>Please create these files under <code>/root/.iredmail/kv/</code> with correct passwords
|
||||
manually, each file should contain only one line, passwords must be in plain
|
||||
text, not the hashed one.</p>
|
||||
<div class="admonition attention">
|
||||
<p class="admonition-title">Attention</p>
|
||||
<p>You can find all info in the <code>iRedMail.tips</code> file under iRedMail
|
||||
installation directory, for example, <code>/root/iRedMail-0.9.9/iRedMail.tips</code>.
|
||||
If you don't have this file anymore, you can still find them in other
|
||||
config files.</p>
|
||||
</div>
|
||||
<ul>
|
||||
<li><code>mysql_root_password</code>: the MySQL root password. This is required for OpenLDAP
|
||||
and MySQL/MariaDB backends. You can find it in file <code>/root/.my.cnf</code> or <code>/root/.my.cnf-root</code>.</li>
|
||||
<li><code>pgsql_root_password</code>: The PostgreSQL root password. This is required for
|
||||
PostgreSQL backend. You can find it in the <code>.pgpass</code> file under PostgreSQL
|
||||
data directory.<ul>
|
||||
<li>on CentOS, it's <code>/var/lib/pgsql/.pgpass</code>.</li>
|
||||
<li>on Debian/Ubuntu, it's <code>/var/lib/postgresql/.pgpass</code>.</li>
|
||||
<li>on OpenBSD, it's <code>/var/postgresql/.pgpass</code>.</li>
|
||||
</ul>
|
||||
</li>
|
||||
<li><code>ldap_root_password</code>: The password of OpenLDAP root dn (cn=Manager,dc=xx,dc=xx).
|
||||
This is required for OpenLDAP backend.</li>
|
||||
<li><code>ldap_vmail_password</code>: The password of LDAP dn <code>cn=vmail,dc=xx,dc=xx</code>.</li>
|
||||
<li><code>ldap_vmailadmin_password</code>: The password of LDAP dn <code>cn=vmailadmin,dc=xx,dc=xx</code>.</li>
|
||||
<li><code>vmail_db_password</code>: The password of SQL user <code>vmail</code>.</li>
|
||||
<li><code>vmail_db_admin_password</code>: The password of SQL user <code>vmailadmin</code>.</li>
|
||||
<li><code>amavisd_db_password</code>: The password of SQL user <code>amavisd</code>.</li>
|
||||
<li><code>sa_bayes_db_password</code>: The password of SQL user <code>sa_bayes</code>.</li>
|
||||
<li><code>iredadmin_db_password</code>: The password of SQL user <code>iredadmin</code>.</li>
|
||||
<li><code>iredapd_db_password</code>: The password of SQL user <code>iredapd</code>.</li>
|
||||
<li><code>iredapd_srs_secret</code>: The secret string used by iRedAPD to sign SRS.</li>
|
||||
<li><code>sogo_db_password</code>: The password of SQL user <code>sogo</code>.</li>
|
||||
<li><code>sogo_sieve_master_password</code>: The Dovecot master user used by SOGo. You can find it in <code>/etc/sogo/sieve.cred</code>.</li>
|
||||
<li><code>roundcube_db_password</code>: The password of SQL user <code>roundcube</code>.</li>
|
||||
<li><code>roundcube_des_key</code>: The DES key used by Roundcube to encrypt the session. You can find it in <code>/opt/www/roundcubemail/config/config.inc.php</code>, parameter <code>$config['des_key'] =</code>.</li>
|
||||
<li><code>mlmmjadmin_api_token</code>: The token string used by iRedAdmin-Pro to communicate with mlmmjadmin. You can find it in <code>/opt/mlmmjadmin/settings.py</code>, parameter <code>api_auth_tokens =</code>.</li>
|
||||
<li><code>netdata_db_password</code>: The password of SQL user <code>netdata</code>. You can find it in <code>/root/.my.cnf-netdata</code> or <code>/opt/netdata/etc/netdata/my.cnf</code>.</li>
|
||||
<li><code>first_domain_admin_password</code>: The password of the first mail user created during iRedMail installation.</li>
|
||||
</ul>
|
||||
<h2 id="copy-files-to-new-locations">Copy files to new locations</h2>
|
||||
<h3 id="ssl-cert">SSL cert</h3>
|
||||
<p>iRedMail Easy stores SSL cert/key files under <code>/opt/iredmail/ssl/</code>, you need to
|
||||
either copy or (symbol) link existing ssl cert/key to this directory with
|
||||
correct files names,</p>
|
||||
<ul>
|
||||
<li><code>/opt/iredmail/ssl/key.pem</code>: private key</li>
|
||||
<li><code>/opt/iredmail/ssl/cert.pem</code>: certificate</li>
|
||||
<li><code>/opt/iredmail/ssl/combined.pem</code>: full chain</li>
|
||||
</ul>
|
||||
<h3 id="postfix-config-files">Postfix config files</h3>
|
||||
<p>iRedMail Easy will rewrite config files under <code>/etc/postfix/</code>, most importantly
|
||||
<code>main.cf</code> and <code>master.cf</code>. If you have any changes in these 2 files, please
|
||||
read the <code>[Best Practice](./iredmail-easy.best.practice.html)</code> document to
|
||||
understand how to customize them with shell script
|
||||
<code>/opt/iredmail/custom/postfix/custom.sh</code>.</p><div class="footer">
|
||||
<p style="text-align: center; color: grey;">All documents are available in <a href="https://bitbucket.org/zhb/iredmail-docs/src">BitBucket 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://bitbucket.org/zhb/iredmail-docs/get/tip.tar.bz2">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>
|
||||
Loading…
Reference in New Issue