Difference between revisions of "Talk:Sogo"

From SME Server
Jump to navigationJump to search
(Blanked the page)
 
(15 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 +
--[[User:Stephdl|Stephdl]] ([[User talk:Stephdl|talk]]) 14:45, 2 February 2014 (MST) moved as no more needed
 +
=== Upgrade ===
  
 +
Upgrade to a later SOGo version (here: upgrade to 1.3 which was released on 21.7.2010)
 +
 +
yum update --disablerepo=* --enablerepo=sogo
 +
/etc/rc7.d/S85sogod restart
 +
 +
--[[User:Stephdl|Stephdl]] ([[User talk:Stephdl|talk]]) 06:48, 17 August 2014 (MDT) moved here for consideration
 +
 +
=== The memcached - libevent nightmare ===
 +
{{Note box|no more needed as the epel directory is included in the yum command line above}}
 +
Many users have experienced the following dependencies errors (or some kind of them) while trying to install/update SOGo or simply trying to update SME with yum update:
 +
memcached-1.4.2-1.el5.i386 from sogo has depsolving problems
 +
  --> Missing Dependency: libevent-1.1a.so.1 is needed by package memcached-1.4.2-1.el5.i386 (sogo)
 +
Error: Missing Dependency: libevent-1.1a.so.1 is needed by package memcached-1.4.2-1.el5.i386 (sogo)
 +
 +
To solve this issue you need to install memcached form Epel; the repository can be activated according to wiki http://wiki.contribs.org/Epel .
 +
Once configured the repository you can install memcached (The current release available is memcached-1.4.5-1.el5.i386.rpm - may 2012):
 +
yum --enablerepo=epel install memcached
 +
Now you will be able to install/update SOGo and run yum update fine too.
 +
 +
=== Charset issue ===
 +
 +
You may experience some problem in SOGo web interface with international fonts (à, é, ù .....) not correctly displayed. To correct this issue yuo need to edit the following file in your favourite editor (copy the original from /etc/e-smith/templates/etc/httpd/conf/httpd.conf):
 +
/etc/e-smith/templates-custom/etc/httpd/conf/httpd.conf/85SOGoAccess
 +
and add the instruction '''AddDefaultCharset UTF-8''' in this section:
 +
<Location /SOGo>
 +
        order deny,allow
 +
        deny from all
 +
        allow from all
 +
        SSLRequireSSL on
 +
        RequestHeader set "x-webobjects-server-url" "https://{$SystemName}.{$DomainName}/SOGo"
 +
        AddDefaultCharset UTF-8
 +
</Location>
 +
 +
or you can use this command:
 +
sed -i '/x-webobjects/ a\        AddDefaultCharset UTF-8' /etc/e-smith/templates-custom/etc/httpd/conf/httpd.conf/85SOGoAccess
 +
Then expand template and restart httpd:
 +
expand-template /etc/httpd/conf/httpd.conf
 +
/etc/init.d/httpd-e-smith restart
 +
 +
Or you can do :
 +
mkdir -p /etc/e-smith/templates-custom/etc/httpd/conf/httpd.conf/
 +
cp /etc/e-smith/templates/etc/httpd/conf/httpd.conf/85SOGoAccess /etc/e-smith/templates-custom/etc/httpd/conf/httpd.conf/85SOGoAccess
 +
sed -i '/x-webobjects/ a\        AddDefaultCharset UTF-8' /etc/e-smith/templates-custom/etc/httpd/conf/httpd.conf/85SOGoAccess
 +
 +
Expand template and restart you SOGo
 +
expand-template /etc/httpd/conf/httpd.conf
 +
sv t httpd-e-smith
 +
service sogod start
 +
 +
===Login doesn't operate===
 +
according the bug [[bugzilla:7269]] you can not login in sogo even if the user and password are correct. You have to modify the line which concerns the SOGo user in the file /etc/passwd
 +
 +
/etc/passwd not working:
 +
 +
...
 +
smolt:x:454:454:Smolt:/usr/share/smolt:/sbin/nologin
 +
spamd:x:1005:1005:spamassassin daemon user:/var/spool/spamd:/bin/false
 +
memcached:x:455:455:Memcached daemon:/var/run/memcached:/sbin/nologin
 +
sogo:x:456:456:SOGo daemon:'''/var/lib/sogo:/sbin/nologin'''
 +
....
 +
 +
After this customer's modification:
 +
nano /etc/passwd
 +
 +
sogo:x:456:456:SOGo daemon:'''/home/sogo:/bin/bash'''
 +
 +
You will be able to access SOGo but you need to restart the service before
 +
 +
signal-event sogo-modify; /etc/rc7.d/S85sogod restart
 +
=== Enabling customization of "mail from" field ===
 +
 +
To do this you need to edit the following file in your favourite editor (copy the original from /etc/e-smith/templates/home/sogo/GNUstep/Defaults/.GNUstepDefaults):
 +
/etc/e-smith/templates-custom/home/sogo/GNUstep/Defaults/.GNUstepDefaults/10defaults
 +
Put the following instruction under the block  beginning with '''sogod = \{''' :
 +
 +
SOGoMailCustomFromEnabled = YES;
 +
 +
Or you can use this command:
 +
sed -i '/sogod =/ a\        SOGoMailCustomFromEnabled = YES; ' /etc/e-smith/templates-custom/home/sogo/GNUstep/Defaults/.GNUstepDefaults/10defaults
 +
 +
Once saved, then execute the following commands:
 +
 +
signal-event sogo-modify;
 +
/etc/rc7.d/S85sogod restart
 +
=== Timeout issue ===
 +
 +
Once you have installed SOGo you may find that there is a timeout issue in that SOGo keeps logging you out. To stop this, you will need to add the following line to the .GNUstepDefaults file:
 +
 +
OCSSessionsFolderURL = "mysql://sogo:{$sogod{'DbPassword'}}@localhost/sogo/sogo_sessions_folder";
 +
 +
To do this you need to edit the following file in your favourite editor (the code below uses vi):
 +
mkdir -p /etc/e-smith/templates-custom/home/sogo/GNUstep/Defaults/.GNUstepDefaults
 +
cp /etc/e-smith/templates/home/sogo/GNUstep/Defaults/.GNUstepDefaults/10defaults  /etc/e-smith/templates-custom/home/sogo/GNUstep/Defaults/.GNUstepDefaults/10defaults
 +
vi /etc/e-smith/templates-custom/home/sogo/GNUstep/Defaults/.GNUstepDefaults/10defaults
 +
 +
I would put it under the SOGoProfileURL = "mysql://sogo:{$sogod{'DbPassword'}}@localhost/sogo/sogo_user_profile"; line.
 +
 +
Or you can use this command:
 +
sed -i '/SOGoProfileURL/ a\        OCSSessionsFolderURL = "mysql://sogo:{$sogod{'DbPassword'}}@localhost/sogo/sogo_sessions_folder"; ' /etc/e-smith/templates-custom/home/sogo/GNUstep/Defaults/.GNUstepDefaults/10defaults
 +
 +
Once saved, then execute the following commands:
 +
 +
signal-event sogo-modify;
 +
/etc/rc7.d/S85sogod restart
 +
 +
Hopefully now you will no longer experience the time-out issue.
 +
 +
--[[User:Stephdl|Stephdl]] ([[User talk:Stephdl|talk]]) 15:35, 2 February 2014 (MST) End cleaning main page
 +
 +
[[User:Relayer|Relayer]] ([[User talk:Relayer|talk]]) 09:48, 9 February 2014 (MST) Regarding the note box for Thunderbird configuration. As far as I am aware Thunderbird configuration is still needed. The SOGo manual still shows a need for this configuration and I have not been able to get it working without it.
 +
Other comments:
 +
I have not been able to get the server to install the plugins, presumably I am doing something wrong but I cannot find out what. Install them manually and everything works fine though.
 +
The ESR (Extended Support Release) versions of Thunderbird are no longer available, they have been merged into the mainstreem releases.
 +
From a personal view point, I believe SOGo is the best groupware solution for SME Server, I have tried others but SOGo seems the only one to tick all the boxes. Just thought I would throw that into the ring as a personal view.
 +
 +
--[[User:Stephdl|Stephdl]] ([[User talk:Stephdl|talk]]) 11:56, 9 February 2014 (MST) ok :) i have removed the note box , many thanks to follow this howTO. Feel free to reviews others :)
 +
 +
== added back to install line ==
 +
 +
If memcached is not available when updating, you still need to install it manually.
 +
 +
I think the custom from stuff is still relevant also
 +
 +
=== Installing SOGo on SME8 64 bit ===
 +
 +
'''Not necessary any more but moved here for history :)'''
 +
 +
{{Note box|No other customization from above sections need to be applied in addition to this section}}
 +
Add the repository to your SME Server 8 modifying the SOGo repo to point to 64 x86_64:
 +
 +
db yum_repositories set sogo repository \
 +
      BaseURL http://inverse.ca/downloads/SOGo/RHEL5/x86_64/ \
 +
      EnableGroups yes \
 +
      GPGCheck no \
 +
      Name "Inverse SOGo Repository" \
 +
      Visible yes \
 +
      status disabled
 +
 +
db yum_repositories set nethsme repository \
 +
      BaseURL http://smeserver.nethesis.it/releases/8/i386 \
 +
      EnableGroups yes \
 +
      GPGCheck yes \
 +
      GPGKey http://smeserver.nethesis.it/releases/RPM-GPG-KEY-nethesis \
 +
      Name "Nethesis SME Repository" \
 +
      Visible yes \
 +
      status disabled
 +
 +
db yum_repositories set epel repository \
 +
      Name 'Epel - EL5' \
 +
      BaseUrl 'http://download.fedoraproject.org/pub/epel/5/$basearch' \
 +
      MirrorList 'http://mirrors.fedoraproject.org/mirrorlist?repo=epel-5&arch=$basearch' \
 +
      EnableGroups no \
 +
      GPGCheck yes \
 +
      GPGKey http://dl.fedoraproject.org/pub/epel/RPM-GPG-KEY-EPEL \
 +
      Visible no \
 +
      status disabled
 +
 +
signal-event yum-modify
 +
 +
Then you can install smeserver-sogo package (apply memcached form epel before install):
 +
 +
yum install smeserver-sogo --enablerepo=nethsme,sogo,epel
 +
 +
signal-event post-upgrade; signal-event reboot
 +
 +
Now you must change some path in /etc/httpd.conf. Proceed as follows:
 +
create this folder in /etc/templates-custom:
 +
mkdir -p /etc/e-smith/templates-custom/etc/httpd/conf/httpd.conf/
 +
and copy the SOGo templat efragment in customized template folder:
 +
cp /etc/e-smith/templates/etc/httpd/conf/httpd.conf/85SOGoAccess /etc/e-smith/templates-custom/etc/httpd/conf/httpd.conf/85SOGoAccess
 +
then edit with your favourite editor the template to be customized and change /usr/lib/... paths in /usr/lib64/...
 +
so that the following lines in your template fragment appears modified as follows:
 +
...............                       
 +
Alias /.woa/WebServerResources/ /usr/lib64/GNUstep/SOGo/WebServerResources/
 +
Alias /SOGo.woa/WebServerResources/ /usr/lib64/GNUstep/SOGo/WebServerResources/
 +
Alias /SOGo/WebServerResources/ /usr/lib64/GNUstep/SOGo/WebServerResources/
 +
AliasMatch /SOGo/so/ControlPanel/Products/(.*)/Resources/(.*) /usr/lib64/GNUstep/SOGo/$1.SOGo/Resources$2
 +
...............                         
 +
<Directory "/usr/lib64/GNUstep/SOGo/WebServerResources/">
 +
...............
 +
 +
or you can enter the following command:
 +
  grep -rl 'usr/lib' /etc/e-smith/templates-custom/etc/httpd/conf/httpd.conf/85SOGoAccess  | xargs sed -i 's/lib/lib64/g'
 +
 +
Expand template and restart you SOGo
 +
expand-template /etc/httpd/conf/httpd.conf
 +
sv t httpd-e-smith
 +
service sogod start
 +
 +
== SOPE install/upgrade instructions missing ==
 +
 +
In an older version of this document (mayne the original one?) there was the need to install SOPE components.
 +
 +
We ran into an issue that our users could not send or forward emails (log showed: "NSInvalidArgumentException REASON:NGMimeMessage(instance) does not recognize setHeader:forKey: INFO:(null)" ) and had to update SOPE according to this thread:
 +
 +
https://lists.inverse.ca/sogo/arc/users/2015-01/msg00006.html
 +
 +
We needed "yum update sope* --enablerepo=sogo". Should we add this here?
 +
Michael

Latest revision as of 05:39, 9 February 2015

--Stephdl (talk) 14:45, 2 February 2014 (MST) moved as no more needed

Upgrade

Upgrade to a later SOGo version (here: upgrade to 1.3 which was released on 21.7.2010)

yum update --disablerepo=* --enablerepo=sogo
/etc/rc7.d/S85sogod restart

--Stephdl (talk) 06:48, 17 August 2014 (MDT) moved here for consideration

The memcached - libevent nightmare

Important.png Note:
no more needed as the epel directory is included in the yum command line above


Many users have experienced the following dependencies errors (or some kind of them) while trying to install/update SOGo or simply trying to update SME with yum update:

memcached-1.4.2-1.el5.i386 from sogo has depsolving problems
 --> Missing Dependency: libevent-1.1a.so.1 is needed by package memcached-1.4.2-1.el5.i386 (sogo)
Error: Missing Dependency: libevent-1.1a.so.1 is needed by package memcached-1.4.2-1.el5.i386 (sogo)

To solve this issue you need to install memcached form Epel; the repository can be activated according to wiki http://wiki.contribs.org/Epel . Once configured the repository you can install memcached (The current release available is memcached-1.4.5-1.el5.i386.rpm - may 2012):

yum --enablerepo=epel install memcached

Now you will be able to install/update SOGo and run yum update fine too.

Charset issue

You may experience some problem in SOGo web interface with international fonts (à, é, ù .....) not correctly displayed. To correct this issue yuo need to edit the following file in your favourite editor (copy the original from /etc/e-smith/templates/etc/httpd/conf/httpd.conf):

/etc/e-smith/templates-custom/etc/httpd/conf/httpd.conf/85SOGoAccess

and add the instruction AddDefaultCharset UTF-8 in this section:

<Location /SOGo>
       order deny,allow
       deny from all
       allow from all
       SSLRequireSSL on
       RequestHeader set "x-webobjects-server-url" "https://{$SystemName}.{$DomainName}/SOGo"
       AddDefaultCharset UTF-8
</Location>

or you can use this command:

sed -i '/x-webobjects/ a\        AddDefaultCharset UTF-8' /etc/e-smith/templates-custom/etc/httpd/conf/httpd.conf/85SOGoAccess

Then expand template and restart httpd:

expand-template /etc/httpd/conf/httpd.conf
/etc/init.d/httpd-e-smith restart

Or you can do :

mkdir -p /etc/e-smith/templates-custom/etc/httpd/conf/httpd.conf/
cp /etc/e-smith/templates/etc/httpd/conf/httpd.conf/85SOGoAccess /etc/e-smith/templates-custom/etc/httpd/conf/httpd.conf/85SOGoAccess
sed -i '/x-webobjects/ a\        AddDefaultCharset UTF-8' /etc/e-smith/templates-custom/etc/httpd/conf/httpd.conf/85SOGoAccess

Expand template and restart you SOGo

expand-template /etc/httpd/conf/httpd.conf
sv t httpd-e-smith
service sogod start

Login doesn't operate

according the bug bugzilla:7269 you can not login in sogo even if the user and password are correct. You have to modify the line which concerns the SOGo user in the file /etc/passwd

/etc/passwd not working:
...
smolt:x:454:454:Smolt:/usr/share/smolt:/sbin/nologin
spamd:x:1005:1005:spamassassin daemon user:/var/spool/spamd:/bin/false
memcached:x:455:455:Memcached daemon:/var/run/memcached:/sbin/nologin
sogo:x:456:456:SOGo daemon:/var/lib/sogo:/sbin/nologin
....

After this customer's modification:

nano /etc/passwd
sogo:x:456:456:SOGo daemon:/home/sogo:/bin/bash

You will be able to access SOGo but you need to restart the service before

signal-event sogo-modify; /etc/rc7.d/S85sogod restart

Enabling customization of "mail from" field

To do this you need to edit the following file in your favourite editor (copy the original from /etc/e-smith/templates/home/sogo/GNUstep/Defaults/.GNUstepDefaults):

/etc/e-smith/templates-custom/home/sogo/GNUstep/Defaults/.GNUstepDefaults/10defaults 

Put the following instruction under the block beginning with sogod = \{ :

SOGoMailCustomFromEnabled = YES;

Or you can use this command:

sed -i '/sogod =/ a\        SOGoMailCustomFromEnabled = YES; ' /etc/e-smith/templates-custom/home/sogo/GNUstep/Defaults/.GNUstepDefaults/10defaults

Once saved, then execute the following commands:

signal-event sogo-modify;
/etc/rc7.d/S85sogod restart

Timeout issue

Once you have installed SOGo you may find that there is a timeout issue in that SOGo keeps logging you out. To stop this, you will need to add the following line to the .GNUstepDefaults file:

OCSSessionsFolderURL = "mysql://sogo:{$sogod{'DbPassword'}}@localhost/sogo/sogo_sessions_folder";

To do this you need to edit the following file in your favourite editor (the code below uses vi):

mkdir -p /etc/e-smith/templates-custom/home/sogo/GNUstep/Defaults/.GNUstepDefaults
cp /etc/e-smith/templates/home/sogo/GNUstep/Defaults/.GNUstepDefaults/10defaults  /etc/e-smith/templates-custom/home/sogo/GNUstep/Defaults/.GNUstepDefaults/10defaults 
vi /etc/e-smith/templates-custom/home/sogo/GNUstep/Defaults/.GNUstepDefaults/10defaults 

I would put it under the SOGoProfileURL = "mysql://sogo:{$sogod{'DbPassword'}}@localhost/sogo/sogo_user_profile"; line.

Or you can use this command:

sed -i '/SOGoProfileURL/ a\        OCSSessionsFolderURL = "mysql://sogo:{$sogod{'DbPassword'}}@localhost/sogo/sogo_sessions_folder"; ' /etc/e-smith/templates-custom/home/sogo/GNUstep/Defaults/.GNUstepDefaults/10defaults

Once saved, then execute the following commands:

signal-event sogo-modify;
/etc/rc7.d/S85sogod restart

Hopefully now you will no longer experience the time-out issue.

--Stephdl (talk) 15:35, 2 February 2014 (MST) End cleaning main page

Relayer (talk) 09:48, 9 February 2014 (MST) Regarding the note box for Thunderbird configuration. As far as I am aware Thunderbird configuration is still needed. The SOGo manual still shows a need for this configuration and I have not been able to get it working without it. Other comments: I have not been able to get the server to install the plugins, presumably I am doing something wrong but I cannot find out what. Install them manually and everything works fine though. The ESR (Extended Support Release) versions of Thunderbird are no longer available, they have been merged into the mainstreem releases. From a personal view point, I believe SOGo is the best groupware solution for SME Server, I have tried others but SOGo seems the only one to tick all the boxes. Just thought I would throw that into the ring as a personal view.

--Stephdl (talk) 11:56, 9 February 2014 (MST) ok :) i have removed the note box , many thanks to follow this howTO. Feel free to reviews others :)

added back to install line

If memcached is not available when updating, you still need to install it manually.

I think the custom from stuff is still relevant also

Installing SOGo on SME8 64 bit

Not necessary any more but moved here for history :)


Important.png Note:
No other customization from above sections need to be applied in addition to this section


Add the repository to your SME Server 8 modifying the SOGo repo to point to 64 x86_64:

db yum_repositories set sogo repository \
     BaseURL http://inverse.ca/downloads/SOGo/RHEL5/x86_64/ \
     EnableGroups yes \
     GPGCheck no \
     Name "Inverse SOGo Repository" \
     Visible yes \
     status disabled

db yum_repositories set nethsme repository \
     BaseURL http://smeserver.nethesis.it/releases/8/i386 \
     EnableGroups yes \
     GPGCheck yes \
     GPGKey http://smeserver.nethesis.it/releases/RPM-GPG-KEY-nethesis \
     Name "Nethesis SME Repository" \
     Visible yes \
     status disabled

db yum_repositories set epel repository \
     Name 'Epel - EL5' \
     BaseUrl 'http://download.fedoraproject.org/pub/epel/5/$basearch' \
     MirrorList 'http://mirrors.fedoraproject.org/mirrorlist?repo=epel-5&arch=$basearch' \
     EnableGroups no \
     GPGCheck yes \
     GPGKey http://dl.fedoraproject.org/pub/epel/RPM-GPG-KEY-EPEL \
     Visible no \
     status disabled
signal-event yum-modify

Then you can install smeserver-sogo package (apply memcached form epel before install):

yum install smeserver-sogo --enablerepo=nethsme,sogo,epel
signal-event post-upgrade; signal-event reboot

Now you must change some path in /etc/httpd.conf. Proceed as follows: create this folder in /etc/templates-custom:

mkdir -p /etc/e-smith/templates-custom/etc/httpd/conf/httpd.conf/

and copy the SOGo templat efragment in customized template folder:

cp /etc/e-smith/templates/etc/httpd/conf/httpd.conf/85SOGoAccess /etc/e-smith/templates-custom/etc/httpd/conf/httpd.conf/85SOGoAccess

then edit with your favourite editor the template to be customized and change /usr/lib/... paths in /usr/lib64/... so that the following lines in your template fragment appears modified as follows:

...............                        
Alias /.woa/WebServerResources/ /usr/lib64/GNUstep/SOGo/WebServerResources/
Alias /SOGo.woa/WebServerResources/ /usr/lib64/GNUstep/SOGo/WebServerResources/
Alias /SOGo/WebServerResources/ /usr/lib64/GNUstep/SOGo/WebServerResources/
AliasMatch /SOGo/so/ControlPanel/Products/(.*)/Resources/(.*) /usr/lib64/GNUstep/SOGo/$1.SOGo/Resources$2
...............                          
<Directory "/usr/lib64/GNUstep/SOGo/WebServerResources/">
...............

or you can enter the following command:

 grep -rl 'usr/lib' /etc/e-smith/templates-custom/etc/httpd/conf/httpd.conf/85SOGoAccess  | xargs sed -i 's/lib/lib64/g'

Expand template and restart you SOGo

expand-template /etc/httpd/conf/httpd.conf
sv t httpd-e-smith
service sogod start

SOPE install/upgrade instructions missing

In an older version of this document (mayne the original one?) there was the need to install SOPE components.

We ran into an issue that our users could not send or forward emails (log showed: "NSInvalidArgumentException REASON:NGMimeMessage(instance) does not recognize setHeader:forKey: INFO:(null)" ) and had to update SOPE according to this thread:

https://lists.inverse.ca/sogo/arc/users/2015-01/msg00006.html

We needed "yum update sope* --enablerepo=sogo". Should we add this here? Michael