iredmail-doc/html/upgrade.iredmail.0.9.3-0.9....

136 lines
6.9 KiB
HTML
Raw Normal View History

<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Upgrade iRedMail from 0.9.3 to 0.9.4</title>
<link rel="stylesheet" type="text/css" href="./css/markdown.css" />
</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-iredmail-from-093-to-094">Upgrade iRedMail from 0.9.3 to 0.9.4</h1>
<div class="toc">
<ul>
<li><a href="#upgrade-iredmail-from-093-to-094">Upgrade iRedMail from 0.9.3 to 0.9.4</a><ul>
<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-171">Upgrade iRedAPD (Postfix policy server) to the latest 1.7.1</a></li>
2016-01-05 11:08:56 -06:00
<li><a href="#upgrade-iredadmin-open-source-edition-to-the-latest-stable-release">Upgrade iRedAdmin (open source edition) to the latest stable release</a></li>
<li><a href="#upgrade-roundcube-webmail-to-the-latest-stable-release">Upgrade Roundcube webmail to the latest stable release</a></li>
2016-01-17 23:41:00 -06:00
<li><a href="#fixed-no-daily-cron-job-to-backup-sqlldap-database">Fixed: No daily cron job to backup SQL/LDAP database</a></li>
<li><a href="#freebsd-fix-incorrect-file-permission-of-etcmailmailerconf">FreeBSD: Fix incorrect file permission of /etc/mail/mailer.conf</a></li>
2016-01-18 11:17:00 -06:00
<li><a href="#openbsd-fixed-not-open-port-25-in-firewall-rule">OpenBSD: Fixed: Not open port 25 in firewall rule</a></li>
</ul>
</li>
</ul>
</li>
</ul>
</div>
<p><strong>WARNING: THIS IS STILL A DRAFT DOCUMENT, PLEASE DO NOT APPLY IT.</strong></p>
<h2 id="changelog">ChangeLog</h2>
<blockquote>
<p>We offer remote upgrade service, check <a href="../support.html">the price</a> and <a href="../contact.html">contact us</a>.</p>
</blockquote>
<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
installation, it's recommended to update this file after you upgraded iRedMail,
so that you can know which version of iRedMail you're running. For example:</p>
<pre><code># File: /etc/iredmail-release
0.9.4
</code></pre>
<h3 id="upgrade-iredapd-postfix-policy-server-to-the-latest-171">Upgrade iRedAPD (Postfix policy server) to the latest 1.7.1</h3>
<p>Please follow below tutorial to upgrade iRedAPD to the latest stable release:
<a href="./upgrade.iredapd.html">Upgrade iRedAPD to the latest stable release</a></p>
<p>Detailed release notes are available <a href="./iredapd.releases.html">here</a>.</p>
2016-01-05 11:08:56 -06:00
<h3 id="upgrade-iredadmin-open-source-edition-to-the-latest-stable-release">Upgrade iRedAdmin (open source edition) to the latest stable release</h3>
<p>Please follow this tutorial to upgrade iRedAdmin open source edition to the
latest stable release:
<a href="./migrate.or.upgrade.iredadmin.html">Upgrade iRedAdmin to the latest stable release</a></p>
<h3 id="upgrade-roundcube-webmail-to-the-latest-stable-release">Upgrade Roundcube webmail to the latest stable release</h3>
<p>Please follow Roundcube official tutorial to upgrade Roundcube webmail to the
2016-01-03 19:48:49 -06:00
latest stable release immediately: <a href="http://trac.roundcube.net/wiki/Howto_Upgrade">How to upgrade Roundcube</a></p>
<p>Note: package <code>rsync</code> must be installed on your server before upgrading.</p>
2016-01-17 23:41:00 -06:00
<h3 id="fixed-no-daily-cron-job-to-backup-sqlldap-database">Fixed: No daily cron job to backup SQL/LDAP database</h3>
<p>In iRedMail-0.9.3, there's no daily cron job to backup SQL/LDAP databases.
Please add them manually with command <code>crontab -e -u root</code>.</p>
<blockquote>
<p>Notes:</p>
<ul>
<li>
<p>Please make sure the path to backup scripts
(<code>/var/vmail/backup/backup_XXX.sh</code>) are correct.</p>
</li>
<li>
<p>On FreeBSD and OpenBSD, the path of <code>bash</code> shell is <code>/usr/local/bin/bash</code>.</p>
</li>
</ul>
</blockquote>
<ul>
<li>For OpenLDAP backend, you need 2 daily cron jobs, one for SQL database, one
another one for LDAP:</li>
</ul>
<pre><code># iRedMail: Backup OpenLDAP data (at 03:00 AM)
0 3 * * * /bin/bash ${BACKUP_SCRIPT_OPENLDAP}
# iRedMail: Backup MySQL databases (at 03:30AM)
30 3 * * * /bin/bash /var/vmail/backup/backup_pgsql.sh
</code></pre>
<ul>
<li>For MySQL/MariaDB backends, you need 1 daily cron job:</li>
</ul>
<pre><code># iRedMail: Backup MySQL databases (at 03:30AM)
30 3 * * * /bin/bash /var/vmail/backup/backup_pgsql.sh
</code></pre>
<ul>
<li>For PostgreSQL backend, you need 1 daily cron job:</li>
</ul>
<pre><code># iRedMail: Backup PostgreSQL databases (at 03:01AM)
1 3 * * * /bin/bash /var/vmail/backup/backup_pgsql.sh
</code></pre>
<h3 id="freebsd-fix-incorrect-file-permission-of-etcmailmailerconf">FreeBSD: Fix incorrect file permission of /etc/mail/mailer.conf</h3>
<blockquote>
<p>This is applicable to only FreeBSD.</p>
</blockquote>
<p>iRedMail generates /etc/mail/mailer.conf with permission 0600 during
installation, but it should be world-readable. Please fix this issue with
command below:</p>
<pre><code>chmod +r /etc/mail/mailer.conf
2016-01-18 11:17:00 -06:00
</code></pre>
<h3 id="openbsd-fixed-not-open-port-25-in-firewall-rule">OpenBSD: Fixed: Not open port 25 in firewall rule</h3>
<blockquote>
<p>This is applicable to only OpenBSD.</p>
</blockquote>
<p>The sample PF firewall rule shipped in iRedMail-0.9.3 doesn't enable port 25
by default, please add service name <code>smtp</code> in <code>mail_services=</code> manually, then
reload pf rules.</p>
<ul>
<li>Add service name <code>smtp</code> in parameter <code>mail_services=</code> in <code>/etc/pf.conf</code>:</li>
</ul>
<pre><code>mail_services=&quot;{ ... smtp}&quot;
</code></pre>
<ul>
<li>Reload pf firewall:</li>
</ul>
<pre><code># pfctl -d
# pfctl -ef /etc/pf.conf
</code></pre><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. If you found something wrong, please do <a href="http://www.iredmail.org/contact.html">contact us</a> to fix it.<script>
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','//www.google-analytics.com/analytics.js','ga');
ga('create', 'UA-3293801-21', 'auto');
ga('send', 'pageview');
</script>
</body></html>