New: html/upgrade.sogo.2.to.3.html.

This commit is contained in:
Zhang Huangbin 2016-03-27 13:50:53 +08:00
parent dddf6c61ed
commit 142752ec44
6 changed files with 209 additions and 72 deletions

View File

@ -4,11 +4,11 @@ Please follow the tutorial to find Roundcube config file
(`config/config.inc.php`) first:
[Locations of configuration and log files of major components](./file.locations.html#roundcube-webmail)
Then add below settings in `config/config.inc.php`:
Then add settings below in `config/config.inc.php`:
```
// system error reporting, sum of: 1 = log; 4 = show
$config['debug_level'] = 1;
$config['debug_level'] = 4;
// Log SQL queries
$config['sql_debug'] = true;
@ -22,3 +22,8 @@ $config['ldap_debug'] = true;
// Log SMTP conversation
$config['smtp_debug'] = true;
```
No need to restart web service.
Roundcube is configured (by iRedMail) to log to Postfix log file, it's
`/var/log/maillog` or `/var/log/mail.log`.

View File

@ -13,7 +13,7 @@
We offer remote upgrade support if you don't want to get your hands dirty,
check [the details](../support.html) and [contact us](../contact.html).
* 2016-03-23: [OPTIONAL] Switch SOGo to v3 from v2
* 2016-03-23: [OPTIONAL] Upgrade SOGo from v2 to v3
* 2016-03-23: [NEW] Able to enable/disable SOGo access for a single user.
* 2016-03-08: [NEW] Supports Postfix `sender_dependent_relayhost_maps`.
* 2016-02-25:
@ -92,7 +92,9 @@ echo -e '\nvirusalert: root' >> /usr/local/etc/postfix/aliases
postalias /usr/local/etc/postfix/aliases
```
### [OPTIONAL] Switch SOGo to v3 from v2
### [OPTIONAL] Upgrade SOGo from v2 to v3
Note: This upgrade is __OPTIONAL__.
SOGo-3.x has a shinny new web UI, you can try the online demo here:
<http://sogo.nu> (search 'demo' on the page).
@ -101,38 +103,8 @@ SOGo team offers support for both SOGo v3 and v2, so it's totally fine if you
want to stick to SOGo-2.x. In case you want to try SOGo-3.x, please try steps
below.
Before switching, please backup SOGo config file first:
```
cp /etc/sogo/sogo.conf /etc/sogo/sogo.conf.bak
```
* On RHEL/CentOS, please open file `/etc/yum.repos.d/sogo.conf`, change the
`baseurl=` setting to below one:
```
baseurl=http://inverse.ca/rhel-v3/$releasever/$basearch/
```
Remove `sope` and `sogo` packages first, then install SOGo again:
Then run command `yum update` to upgrade SOGo to 3.x.
* On Debian, please open file `/etc/apt/sources.list`, replace URL
`http://inverse.ca/downloads/SOGo/Debian/` by below one:
```
http://inverse.ca/debian-v3/
```
* On Ubuntu, please open file `/etc/apt/sources.list`, replace URL
`http://inverse.ca/downloads/SOGo/Ubuntu/` by below one:
```
http://inverse.ca/ubuntu-v3/
```
FreeBSD and OpenBSD rely on the ports tree, so you have to wait for the update
in ports tree.
To upgrade SOGo, please follow our tutorial here:
[Upgrade SOGo from v2 to v3](./upgrade.sogo.2.to.3.html).
## OpenLDAP backend special

View File

@ -0,0 +1,83 @@
# Upgrade SOGo from v2 to v3
SOGo-3.x has a shinny new web UI, you can try the online demo here:
<http://sogo.nu> (search 'demo' on the page).
SOGo team offers support for both SOGo v3 and v2, so it's totally fine if you
want to stick to SOGo-2.x. In case you want to try SOGo-3.x, please try steps
below.
## On RHEL/CentOS
* Backup 2 config files first:
```
cp /etc/sogo/sogo.conf /etc/sogo/sogo.conf.bak
cp /etc/sysconfig/sogo /etc/sysconfig/sogo.bak
```
* Open file `/etc/yum.repos.d/sogo.repo`, change the `baseurl=` setting to:
```
baseurl=http://inverse.ca/rhel-v3/$releasever/$basearch/
```
* Remove `sope` and `sogo` packages first, then install SOGo again:
```
yum remove "sope*" "sogo*"
yum install sogo sogo-ealarms-notify sogo-tool sogo-activesync sope49-gdl1-mysql sope49-gdl1-postgresql
```
* Restore backup files:
```
cp /etc/sogo/sogo.conf.bak /etc/sogo/sogo.conf
cp /etc/sysconfig/sogo.bak /etc/sysconfig/sogo
```
* Restart SOGo service:
```
service sogod restart
```
## On Debian/Ubuntu
* Backup 2 config files first:
```
cp /etc/sogo/sogo.conf /etc/sogo/sogo.conf.bak
cp /etc/default/sogo /etc/default/sogo.bak
```
* Open file `/etc/apt/sources.list`,
* On Debian, please replace URL `http://inverse.ca/downloads/SOGo/Debian/` by: `http://inverse.ca/debian-v3/`
* On Ubuntu, please replace URL `http://inverse.ca/downloads/SOGo/Ubuntu/` by: `http://inverse.ca/ubuntu-v3/`
* Remove `sope` and `sogo` packages first, then install SOGo again:
```
apt-get remove "sope*" "sogo*"
apt-get update
apt-get install sogo sogo-activesync sope4.9-gdl1-mysql sope4.9-gdl1-postgresql
```
* Restore backup files:
```
cp /etc/sogo/sogo.conf.bak /etc/sogo/sogo.conf
cp /etc/default/sogo.bak /etc/default/sogo
```
* Restart SOGo service:
```
service sogo restart
```
## 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: <http://www.iredmail.org/forum/>.

View File

@ -12,9 +12,9 @@
<p>Please follow the tutorial to find Roundcube config file
(<code>config/config.inc.php</code>) first:
<a href="./file.locations.html#roundcube-webmail">Locations of configuration and log files of major components</a></p>
<p>Then add below settings in <code>config/config.inc.php</code>:</p>
<p>Then add settings below in <code>config/config.inc.php</code>:</p>
<pre><code>// system error reporting, sum of: 1 = log; 4 = show
$config['debug_level'] = 1;
$config['debug_level'] = 4;
// Log SQL queries
$config['sql_debug'] = true;
@ -27,7 +27,11 @@ $config['ldap_debug'] = true;
// Log SMTP conversation
$config['smtp_debug'] = true;
</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>
</code></pre>
<p>No need to restart web service.</p>
<p>Roundcube is configured (by iRedMail) to log to Postfix log file, it's
<code>/var/log/maillog</code> or <code>/var/log/mail.log</code>.</p><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)

View File

@ -19,7 +19,7 @@
<li><a href="#rhelcentos-fixed-not-enable-cron-job-to-update-spamassassin-rules">[RHEL/CentOS] Fixed: Not enable cron job to update SpamAssassin rules</a></li>
<li><a href="#rhelcentos-fixed-not-create-required-directory-used-to-store-php-session-files">[RHEL/CentOS] Fixed: Not create required directory used to store PHP session files</a></li>
<li><a href="#fixed-not-add-alias-for-virusalert-on-non-debianubuntu-oses">Fixed: not add alias for virusalert on non-Debian/Ubuntu OSes</a></li>
<li><a href="#optional-switch-sogo-to-v3-from-v2">[OPTIONAL] Switch SOGo to v3 from v2</a></li>
<li><a href="#optional-upgrade-sogo-from-v2-to-v3">[OPTIONAL] Upgrade SOGo from v2 to v3</a></li>
</ul>
</li>
<li><a href="#openldap-backend-special">OpenLDAP backend special</a><ul>
@ -74,7 +74,7 @@
check <a href="../support.html">the details</a> and <a href="../contact.html">contact us</a>.</p>
</div>
<ul>
<li>2016-03-23: [OPTIONAL] Switch SOGo to v3 from v2</li>
<li>2016-03-23: [OPTIONAL] Upgrade SOGo from v2 to v3</li>
<li>2016-03-23: [NEW] Able to enable/disable SOGo access for a single user.</li>
<li>2016-03-08: [NEW] Supports Postfix <code>sender_dependent_relayhost_maps</code>.</li>
<li>2016-02-25:<ul>
@ -137,42 +137,15 @@ echo -e '\nvirusalert: root' &gt;&gt; /usr/local/etc/postfix/aliases
postalias /usr/local/etc/postfix/aliases
</code></pre>
<h3 id="optional-switch-sogo-to-v3-from-v2">[OPTIONAL] Switch SOGo to v3 from v2</h3>
<h3 id="optional-upgrade-sogo-from-v2-to-v3">[OPTIONAL] Upgrade SOGo from v2 to v3</h3>
<p>Note: This upgrade is <strong>OPTIONAL</strong>.</p>
<p>SOGo-3.x has a shinny new web UI, you can try the online demo here:
<a href="http://sogo.nu">http://sogo.nu</a> (search 'demo' on the page).</p>
<p>SOGo team offers support for both SOGo v3 and v2, so it's totally fine if you
want to stick to SOGo-2.x. In case you want to try SOGo-3.x, please try steps
below.</p>
<p>Before switching, please backup SOGo config file first:</p>
<pre><code>cp /etc/sogo/sogo.conf /etc/sogo/sogo.conf.bak
</code></pre>
<ul>
<li>On RHEL/CentOS, please open file <code>/etc/yum.repos.d/sogo.conf</code>, change the
<code>baseurl=</code> setting to below one:</li>
</ul>
<pre><code>baseurl=http://inverse.ca/rhel-v3/$releasever/$basearch/
</code></pre>
<pre><code>Remove `sope` and `sogo` packages first, then install SOGo again:
Then run command `yum update` to upgrade SOGo to 3.x.
</code></pre>
<ul>
<li>On Debian, please open file <code>/etc/apt/sources.list</code>, replace URL
<code>http://inverse.ca/downloads/SOGo/Debian/</code> by below one:</li>
</ul>
<pre><code>http://inverse.ca/debian-v3/
</code></pre>
<ul>
<li>On Ubuntu, please open file <code>/etc/apt/sources.list</code>, replace URL
<code>http://inverse.ca/downloads/SOGo/Ubuntu/</code> by below one:</li>
</ul>
<pre><code>http://inverse.ca/ubuntu-v3/
</code></pre>
<p>FreeBSD and OpenBSD rely on the ports tree, so you have to wait for the update
in ports tree.</p>
<p>To upgrade SOGo, please follow our tutorial here:
<a href="./upgrade.sogo.2.to.3.html">Upgrade SOGo from v2 to v3</a>.</p>
<h2 id="openldap-backend-special">OpenLDAP backend special</h2>
<h3 id="new-support-postfix-sender_dependent_relayhost_maps">NEW: Support Postfix <code>sender_dependent_relayhost_maps</code></h3>
<h4 id="summary">Summary</h4>

View File

@ -0,0 +1,100 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Upgrade SOGo from v2 to v3</title>
<link rel="stylesheet" type="text/css" href="./css/markdown.css" />
</head>
<body>
<div id="navigation">
<a href="/index.html" target="_blank"><img alt="iRedMail web site" src="images/logo-iredmail.png" style="vertical-align: middle; height: 30px;"/> <span>iRedMail</span></a>
&nbsp;&nbsp;//&nbsp;&nbsp;<a href="./index.html">Document Index</a></div><h1 id="upgrade-sogo-from-v2-to-v3">Upgrade SOGo from v2 to v3</h1>
<p>SOGo-3.x has a shinny new web UI, you can try the online demo here:
<a href="http://sogo.nu">http://sogo.nu</a> (search 'demo' on the page).</p>
<p>SOGo team offers support for both SOGo v3 and v2, so it's totally fine if you
want to stick to SOGo-2.x. In case you want to try SOGo-3.x, please try steps
below.</p>
<h2 id="on-rhelcentos">On RHEL/CentOS</h2>
<ul>
<li>Backup 2 config files first:</li>
</ul>
<pre><code>cp /etc/sogo/sogo.conf /etc/sogo/sogo.conf.bak
cp /etc/sysconfig/sogo /etc/sysconfig/sogo.bak
</code></pre>
<ul>
<li>Open file <code>/etc/yum.repos.d/sogo.repo</code>, change the <code>baseurl=</code> setting to:</li>
</ul>
<pre><code>baseurl=http://inverse.ca/rhel-v3/$releasever/$basearch/
</code></pre>
<ul>
<li>Remove <code>sope</code> and <code>sogo</code> packages first, then install SOGo again:</li>
</ul>
<pre><code>yum remove &quot;sope*&quot; &quot;sogo*&quot;
yum install sogo sogo-ealarms-notify sogo-tool sogo-activesync sope49-gdl1-mysql sope49-gdl1-postgresql
</code></pre>
<ul>
<li>Restore backup files:</li>
</ul>
<pre><code>cp /etc/sogo/sogo.conf.bak /etc/sogo/sogo.conf
cp /etc/sysconfig/sogo.bak /etc/sysconfig/sogo
</code></pre>
<ul>
<li>Restart SOGo service:</li>
</ul>
<pre><code>service sogod restart
</code></pre>
<h2 id="on-debianubuntu">On Debian/Ubuntu</h2>
<ul>
<li>Backup 2 config files first:</li>
</ul>
<pre><code>cp /etc/sogo/sogo.conf /etc/sogo/sogo.conf.bak
cp /etc/default/sogo /etc/default/sogo.bak
</code></pre>
<ul>
<li>
<p>Open file <code>/etc/apt/sources.list</code>,</p>
<ul>
<li>On Debian, please replace URL <code>http://inverse.ca/downloads/SOGo/Debian/</code> by: <code>http://inverse.ca/debian-v3/</code></li>
<li>On Ubuntu, please replace URL <code>http://inverse.ca/downloads/SOGo/Ubuntu/</code> by: <code>http://inverse.ca/ubuntu-v3/</code></li>
</ul>
</li>
<li>
<p>Remove <code>sope</code> and <code>sogo</code> packages first, then install SOGo again:</p>
</li>
</ul>
<pre><code>apt-get remove &quot;sope*&quot; &quot;sogo*&quot;
apt-get update
apt-get install sogo sogo-activesync sope4.9-gdl1-mysql sope4.9-gdl1-postgresql
</code></pre>
<ul>
<li>Restore backup files:</li>
</ul>
<pre><code>cp /etc/sogo/sogo.conf.bak /etc/sogo/sogo.conf
cp /etc/default/sogo.bak /etc/default/sogo
</code></pre>
<ul>
<li>Restart SOGo service:</li>
</ul>
<pre><code>service sogo restart
</code></pre>
<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="http://www.iredmail.org/forum/">http://www.iredmail.org/forum/</a>.</p><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>