160 lines
5.8 KiB
HTML
160 lines
5.8 KiB
HTML
<!DOCTYPE html>
|
|
<html>
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
|
<title>Upgrade SOGo from v4 to v5</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="upgrade-sogo-from-v4-to-v5">Upgrade SOGo from v4 to v5</h1>
|
|
<div class="toc">
|
|
<ul>
|
|
<li><a href="#upgrade-sogo-from-v4-to-v5">Upgrade SOGo from v4 to v5</a><ul>
|
|
<li><a href="#upgrade-sogo-on-rhelcentos">Upgrade SOGo On RHEL/CentOS</a></li>
|
|
<li><a href="#upgrade-sogo-on-debianubuntu">Upgrade SOGo On Debian/Ubuntu</a></li>
|
|
<li><a href="#upgrade-sogo-on-freebsd">Upgrade SOGo On FreeBSD</a></li>
|
|
<li><a href="#upgrade-sogo-on-openbsd">Upgrade SOGo On OpenBSD</a></li>
|
|
<li><a href="#troubleshooting">Troubleshooting</a></li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<p>SOGo v5 was released on Aug 10, 2020 by the SOGo team (<a href="https://sogo.nu">https://sogo.nu</a>), and
|
|
nightly build packages for v4 and v4 were removed permanently. All users must
|
|
switch to v5 as soon as possible.</p>
|
|
<h2 id="upgrade-sogo-on-rhelcentos">Upgrade SOGo On RHEL/CentOS</h2>
|
|
<ul>
|
|
<li>Backup config files first:</li>
|
|
</ul>
|
|
<pre><code>mkdir -p /root/sogo-backup/{sogo,sysconfig}
|
|
cp /etc/sogo/* /root/sogo-backup/sogo/
|
|
cp /etc/sysconfig/sogo /root/sogo-backup/sysconfig/
|
|
</code></pre>
|
|
|
|
<ul>
|
|
<li>Backup its SQL database:</li>
|
|
</ul>
|
|
<pre><code>bash /var/vmail/backup/backup_*sql.sh
|
|
bash /var/vmail/backup/backup_sogo.sh
|
|
</code></pre>
|
|
|
|
<ul>
|
|
<li>Open file <code>/etc/yum.repos.d/sogo.repo</code>, change the version number in
|
|
<code>baseurl=</code> line from <code>4</code> to <code>5</code>:</li>
|
|
</ul>
|
|
<pre><code>baseurl=https://packages.inverse.ca/SOGo/nightly/5/rhel/$releasever/$basearch/
|
|
</code></pre>
|
|
|
|
<ul>
|
|
<li>SOGo relies on the GNUstep packages provided by SOGo team, and must not use
|
|
the packages from EPEL repo. Please open file <code>/etc/yum.repos.d/epel.repo</code>,
|
|
make sure you have line like below:</li>
|
|
</ul>
|
|
<pre><code>exclude=gnustep*
|
|
</code></pre>
|
|
|
|
<ul>
|
|
<li>Upgrade SOGo packages:</li>
|
|
</ul>
|
|
<pre><code>yum clean all
|
|
yum update 'sogo*' '*sope*'
|
|
</code></pre>
|
|
|
|
<ul>
|
|
<li>Update config file <code>/etc/sogo/sogo.conf</code>, enable TLS without verifying ssl cert.</li>
|
|
</ul>
|
|
<pre><code> SOGoSMTPServer = "smtp://127.0.0.1:587/?tls=YES&tlsVerifyMode=allowInsecureLocalhost";
|
|
SOGoMailingMechanism = smtp;
|
|
SOGoSMTPAuthenticationType = PLAIN;
|
|
|
|
SOGoSieveServer = "sieve://127.0.0.1:4190/?tls=YES&tlsVerifyMode=allowInsecureLocalhost";
|
|
</code></pre>
|
|
|
|
<ul>
|
|
<li>Restart SOGo and memcached services:</li>
|
|
</ul>
|
|
<pre><code>service memcached restart
|
|
service sogod restart
|
|
</code></pre>
|
|
|
|
<h2 id="upgrade-sogo-on-debianubuntu">Upgrade SOGo On Debian/Ubuntu</h2>
|
|
<ul>
|
|
<li>Backup config files first:</li>
|
|
</ul>
|
|
<pre><code>mkdir -p /root/sogo-backup/{sogo,default}
|
|
cp /etc/sogo/* /root/sogo-backup/sogo/
|
|
cp /etc/default/sogo /root/sogo-backup/default/
|
|
</code></pre>
|
|
|
|
<ul>
|
|
<li>Backup its SQL database:</li>
|
|
</ul>
|
|
<pre><code>bash /var/vmail/backup/backup_*sql.sh
|
|
bash /var/vmail/backup/backup_sogo.sh
|
|
</code></pre>
|
|
|
|
<ul>
|
|
<li>Open file <code>/etc/apt/sources.list</code> or <code>/etc/apt/sources.list.d/sogo-nightly.list</code>,
|
|
change the version number <code>4</code> to <code>5</code>, like below:</li>
|
|
</ul>
|
|
<pre><code># Debian
|
|
https://packages.inverse.ca/SOGo/nightly/5/debian ...
|
|
|
|
# Ubuntu
|
|
https://packages.inverse.ca/SOGo/nightly/5/ubuntu ...
|
|
</code></pre>
|
|
|
|
<ul>
|
|
<li>Upgrade SOGo packages:</li>
|
|
</ul>
|
|
<pre><code>apt-get update
|
|
apt-get install --only-upgrade 'sogo*' '*sope*'
|
|
</code></pre>
|
|
|
|
<ul>
|
|
<li>Update config file <code>/etc/sogo/sogo.conf</code>, enable TLS without verifying ssl cert.</li>
|
|
</ul>
|
|
<pre><code> SOGoSMTPServer = "smtp://127.0.0.1:587/?tls=YES&tlsVerifyMode=allowInsecureLocalhost";
|
|
SOGoMailingMechanism = smtp;
|
|
SOGoSMTPAuthenticationType = PLAIN;
|
|
|
|
SOGoSieveServer = "sieve://127.0.0.1:4190/?tls=YES&tlsVerifyMode=allowInsecureLocalhost";
|
|
</code></pre>
|
|
|
|
<ul>
|
|
<li>Restart SOGo and memcached services:</li>
|
|
</ul>
|
|
<pre><code>service memcached restart
|
|
service sogo restart
|
|
</code></pre>
|
|
|
|
<h2 id="upgrade-sogo-on-freebsd">Upgrade SOGo On FreeBSD</h2>
|
|
<p>FreeBSD ports tree still ships SOGo-4, please wait for v5.</p>
|
|
<h2 id="upgrade-sogo-on-openbsd">Upgrade SOGo On OpenBSD</h2>
|
|
<p>OpenBSD 6.7 still ships SOGo-4, please wait for v5.</p>
|
|
<h2 id="troubleshooting">Troubleshooting</h2>
|
|
<p>If SOGo doesn't work as expected, please check its log file
|
|
<code>/var/log/sogo/sogo.log</code>. If you don't understand what the error message means,
|
|
please extract related error message and post to our online support forum:
|
|
<a href="https://forum.iredmail.org/">https://forum.iredmail.org/</a>.</p><div class="footer">
|
|
<p style="text-align: center; color: grey;">All documents are available in <a href="https://github.com/iredmail/docs/">GitHub 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://github.com/iredmail/docs/archive/master.zip">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> |