New: upgrade.sogo.4.to.5.html.
This commit is contained in:
Zhang Huangbin
parent
fe2addd09c
commit
0561deabc3
|
|
@ -0,0 +1,134 @@
|
|||
# Upgrade SOGo from v4 to v5
|
||||
|
||||
[TOC]
|
||||
|
||||
SOGo v5 was released on Aug 10, 2020 by the SOGo team (<https://sogo.nu>), and
|
||||
nightly build packages for v4 and v4 were removed permanently. All users must
|
||||
switch to v5 as soon as possible.
|
||||
|
||||
## Upgrade SOGo On RHEL/CentOS
|
||||
|
||||
* Backup config files first:
|
||||
|
||||
```
|
||||
mkdir -p /root/sogo-backup/{sogo,sysconfig}
|
||||
cp /etc/sogo/* /root/sogo-backup/sogo/
|
||||
cp /etc/sysconfig/sogo /root/sogo-backup/sysconfig/
|
||||
```
|
||||
|
||||
* Backup its SQL database:
|
||||
|
||||
```
|
||||
bash /var/vmail/backup/backup_*sql.sh
|
||||
bash /var/vmail/backup/backup_sogo.sh
|
||||
```
|
||||
|
||||
* Open file `/etc/yum.repos.d/sogo.repo`, change the version number in
|
||||
`baseurl=` line from `4` to `5`:
|
||||
|
||||
```
|
||||
baseurl=https://packages.inverse.ca/SOGo/nightly/5/rhel/$releasever/$basearch/
|
||||
```
|
||||
|
||||
* SOGo relies on the GNUstep packages provided by SOGo team, and must not use
|
||||
the packages from EPEL repo. Please open file `/etc/yum.repos.d/epel.repo`,
|
||||
make sure you have line like below:
|
||||
|
||||
```
|
||||
exclude=gnustep*
|
||||
```
|
||||
|
||||
* Upgrade SOGo packages:
|
||||
|
||||
```
|
||||
yum clean all
|
||||
yum update 'sogo*' '*sope*'
|
||||
```
|
||||
|
||||
* Update config file `/etc/sogo/sogo.conf`, enable TLS without verifying ssl cert.
|
||||
|
||||
```
|
||||
SOGoSMTPServer = "smtp://127.0.0.1:587/?tls=YES&tlsVerifyMode=allowInsecureLocalhost";
|
||||
SOGoMailingMechanism = smtp;
|
||||
SOGoSMTPAuthenticationType = PLAIN;
|
||||
|
||||
SOGoIMAPServer = "imap://127.0.0.1:143/?tls=YES&tlsVerifyMode=allowInsecureLocalhost";
|
||||
|
||||
SOGoSieveServer = "sieve://127.0.0.1:4190/?tls=YES&tlsVerifyMode=allowInsecureLocalhost";
|
||||
```
|
||||
|
||||
* Restart SOGo and memcached services:
|
||||
|
||||
```
|
||||
service memcached restart
|
||||
service sogod restart
|
||||
```
|
||||
|
||||
## Upgrade SOGo On Debian/Ubuntu
|
||||
|
||||
* Backup config files first:
|
||||
|
||||
```
|
||||
mkdir -p /root/sogo-backup/{sogo,default}
|
||||
cp /etc/sogo/* /root/sogo-backup/sogo/
|
||||
cp /etc/default/sogo /root/sogo-backup/default/
|
||||
```
|
||||
|
||||
* Backup its SQL database:
|
||||
|
||||
```
|
||||
bash /var/vmail/backup/backup_*sql.sh
|
||||
bash /var/vmail/backup/backup_sogo.sh
|
||||
```
|
||||
|
||||
* Open file `/etc/apt/sources.list` or `/etc/apt/sources.list.d/sogo-nightly.list`,
|
||||
change the version number `4` to `5`, like below:
|
||||
|
||||
```
|
||||
# Debian
|
||||
https://packages.inverse.ca/SOGo/nightly/5/debian ...
|
||||
|
||||
# Ubuntu
|
||||
https://packages.inverse.ca/SOGo/nightly/5/ubuntu ...
|
||||
```
|
||||
|
||||
* Upgrade SOGo packages:
|
||||
|
||||
```
|
||||
apt-get update
|
||||
apt-get install --only-upgrade sogo sogo-activesync
|
||||
```
|
||||
|
||||
* Update config file `/etc/sogo/sogo.conf`, enable TLS without verifying ssl cert.
|
||||
|
||||
```
|
||||
SOGoSMTPServer = "smtp://127.0.0.1:587/?tls=YES&tlsVerifyMode=allowInsecureLocalhost";
|
||||
SOGoMailingMechanism = smtp;
|
||||
SOGoSMTPAuthenticationType = PLAIN;
|
||||
|
||||
SOGoIMAPServer = "imap://127.0.0.1:143/?tls=YES&tlsVerifyMode=allowInsecureLocalhost";
|
||||
|
||||
SOGoSieveServer = "sieve://127.0.0.1:4190/?tls=YES&tlsVerifyMode=allowInsecureLocalhost";
|
||||
```
|
||||
|
||||
* Restart SOGo and memcached services:
|
||||
|
||||
```
|
||||
service memcached restart
|
||||
service sogo restart
|
||||
```
|
||||
|
||||
## Upgrade SOGo On FreeBSD
|
||||
|
||||
FreeBSD ports tree still ships SOGo-4, please wait for v5.
|
||||
|
||||
## Upgrade SOGo On OpenBSD
|
||||
|
||||
OpenBSD 6.7 still ships SOGo-4, please wait for v5.
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
If SOGo doesn't work as expected, please check its log file
|
||||
`/var/log/sogo/sogo.log`. If you don't understand what the error message means,
|
||||
please extract related error message and post to our online support forum:
|
||||
<https://forum.iredmail.org/>.
|
||||
|
|
@ -0,0 +1,164 @@
|
|||
<!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;
|
||||
|
||||
SOGoIMAPServer = "imap://127.0.0.1:143/?tls=YES&tlsVerifyMode=allowInsecureLocalhost";
|
||||
|
||||
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 sogo-activesync
|
||||
</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;
|
||||
|
||||
SOGoIMAPServer = "imap://127.0.0.1:143/?tls=YES&tlsVerifyMode=allowInsecureLocalhost";
|
||||
|
||||
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>
|
||||
Loading…
Reference in New Issue