iredmail-doc/en_US/howto/upgrade.sogo.4.to.5.md

3.0 KiB

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;

    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*' '*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;

    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/.