From 0561deabc3c0978afcf4a309bec4a18d781a65d4 Mon Sep 17 00:00:00 2001 From: Zhang Huangbin Date: Mon, 14 Sep 2020 11:43:20 +0800 Subject: [PATCH] New: upgrade.sogo.4.to.5.html. --- en_US/upgrade/0-upgrade.sogo.4.to.5.md | 134 ++++++++++++++++++++ html/upgrade.sogo.4.to.5.html | 164 +++++++++++++++++++++++++ 2 files changed, 298 insertions(+) create mode 100644 en_US/upgrade/0-upgrade.sogo.4.to.5.md create mode 100644 html/upgrade.sogo.4.to.5.html diff --git a/en_US/upgrade/0-upgrade.sogo.4.to.5.md b/en_US/upgrade/0-upgrade.sogo.4.to.5.md new file mode 100644 index 00000000..1bfa17fb --- /dev/null +++ b/en_US/upgrade/0-upgrade.sogo.4.to.5.md @@ -0,0 +1,134 @@ +# Upgrade SOGo from v4 to v5 + +[TOC] + +SOGo v5 was released on Aug 10, 2020 by the SOGo team (), 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: +. diff --git a/html/upgrade.sogo.4.to.5.html b/html/upgrade.sogo.4.to.5.html new file mode 100644 index 00000000..eb0e9df7 --- /dev/null +++ b/html/upgrade.sogo.4.to.5.html @@ -0,0 +1,164 @@ + + + + + Upgrade SOGo from v4 to v5 + + + + +

Upgrade SOGo from v4 to v5

+
+ +
+

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

+

All documents are available in GitHub repository, and published under Creative Commons license. You can download the latest version for offline reading. If you found something wrong, please do contact us to fix it.

+
+ + + + \ No newline at end of file