Home ›

Scalable OpenGroupware.org

Issue 168

From Issue #168
April 2008

Apr 01, 2008  By Francis Lachapelle
 in
Finally, a scalable groupware solution that matches the offerings from big vendors.
Configuration

The first step in SOGo's configuration is creating a sogo user. The SOGo dæmon runs under this user: 

% adduser sogo

Once you've created the user, you need to configure Apache. Do echo $GNUSTEP_LOCAL_ROOT, and remember the value, as it will be required shortly. Create the file /etc/apache2/conf.d/SOGo.conf (elsewhere if you are not using Debian) with the content shown in Listing 1.

Listing 1. Apache Configuration


Alias   /SOGo.woa/WebServerResources/ \
 <GNUSTEP_LOCAL_ROOT>/Library/SOGo-0.9/WebServerResources/

AliasMatch      /SOGo/so/ControlPanel/Products/(.*)/Resources/(.*) \
 <GNUSTEP_LOCAL_ROOT>/Library/SOGo-0.9/$1.SOGo/Resources/$2

<LocationMatch "^/SOGo*">
        AddDefaultCharset UTF-8
        SetHandler ngobjweb-adaptor
        SetAppPort <sogod-0.9 port>
</LocationMatch>

<LocationMatch "^/SOGo/so/ControlPanel/Products/.*UI/Resources/.*png">
        SetHandler default-handler
</LocationMatch>

<LocationMatch "^/SOGo/so/ControlPanel/Products/.*UI/Resources/.*gif">
        SetHandler default-handler
</LocationMatch>

<LocationMatch "^/SOGo/so/ControlPanel/Products/.*UI/Resources/.*css">
        SetHandler default-handler
</LocationMatch>

<LocationMatch "^/SOGo/so/ControlPanel/Products/.*UI/Resources/.*js">
        SetHandler default-handler
</LocationMatch>

You must replace <GNUSTEP_LOCAL_ROOT> with the echoed value of $GNUSTEP_LOCAL_ROOT (/usr/GNUstep/Local under Debian). Once the file has been created, restart Apache.

Now you can proceed with the SOGo database creation. Because we use PostgreSQL here, perform the following steps: 

% su - postgres
% createuser --no-createdb --no-adduser --encrypted --pwprompt sogo
% createdb -O sogo sogo
% exit

Before starting SOGo, configure it with a basic set of configuration parameters. The configuration file is located in $HOME/GNUstep/Defaults/.GNUstepDefaults, where $HOME is the home directory of your sogo user. Create this file with the content shown in Listing 2.

Listing 2. SOGo Configuration Parameters

NSGlobalDomain = {
};
"sogod-0.9" = {
    AgenorProfileURL = "http://sogo:sogo@127.0.0.1:5432/sogo/
↪sogo_user_profile";
    NGUseUTF8AsURLEncoding = YES;
    OCSFolderInfoURL = "http://sogo:sogo@127.0.0.1:5432/sogo/
↪sogo_folder_info";
    SOGoAppointmentSendEMailNotifications = YES;
    SOGoAuthentificationMethod = LDAP;
    SOGoDefaultLanguage = English;
    SOGoDefaultMailDomain = example.com;
    SOGoDraftsFolderName = INBOX.Drafts;
    SOGoFallbackIMAP4Server = localhost;
    SOGoLDAPSources = (
        {
            CNFieldName = displayName;
            IDFieldName = cn;
            UIDFieldName = cn;
            baseDN = "ou=example,dc=com";
            bindDN = "cn=superuser,ou=Users,dc=example,dc=com";
            bindPassword = 0xdeadk0w;
            canAuthenticate = YES;
            displayName = "Corporate Directory";
            hostname = 127.0.0.1;
            id = public;
            isAddressBook = YES;
            port = 389;
        }
    );
    SOGoMailSpoolPath = "/var/spool/sogo";
    SOGoMailingMechanism = smtp;
    SOGoOtherUsersFolderName = "Other Users";
    SOGoSMTPServer = 127.0.0.1;
    SOGoSentFolderName = INBOX.Sent;
    SOGoServerTimeZone = Canada/Eastern;
    SOGoSharedFolderName = "Shared Folders";
    SOGoSpecialFoldersInRoot = YES;
    SOGoTrashFolderName = INBOX.Trash;
    SOGoUseLocationBasedSentFolder = YES;
    WOMessageUseUTF8 = YES;
    WOParsersUseUTF8 = YES;
    WOPort = 25000;
    WOUseRelativeURLs = NO;
};
}

For now, the most important parameters in the configuration file from Listing 2 are AgenorProfileURL and OCSFolderInfoURL, which must point to your PostgreSQL database server. SOGoLDAPSources must point to your LDAP server. In this example, the LDAP source will be used not only for authentication but also to provide a shared address book called Corporate Directory, which will be accessible both from the Web and native interfaces.

Finally, launch the SOGo dæmon: 

% /usr/local/sbin/sogod-0.9

From Firefox, you now can access http://localhost/SOGo. You will need to provide the user name/password that you normally use for IMAP. Figure 1 shows SOGo's login window.

Figure 1. Login Window

______________________

Comments

Comment viewing options

Select your preferred way to display the comments and click "Save settings" to activate your changes.

SOGo 1.1.0 with SOPE r1660 compilation

SOGood's picture
Submitted by SOGood (not verified) on Thu, 11/12/2009 - 07:24.

just do apt-get install libmemcached-dev
Enjoy

SOGoCache.h:29:36: warning: libmemcached/memcached.h: No such fi

Anonymous's picture
Submitted by Anonymous (not verified) on Fri, 10/02/2009 - 14:25.

I am having the same issue... Running on Ubuntu 8.04 64 Bit.

SOGO's compilation

Arnaud's picture
Submitted by Arnaud (not verified) on Wed, 09/30/2009 - 03:07.

Hello there,

Francis this is great tutorial!

However, you may need to update it as the option --with-gnustep in

   % cd ../SOGo-trunk
   % ./configure --with-gnustep --enable-strip --disable-debug

doesn't seem to exist anymore.

Then on my Debian Lenny machine, the GNUstep make is located in /usr/share/GNUstep/Makefiles/, no more in /usr/GNUstep/System/Library/Makefiles/

Finally, I still have an error during the SOGo's make : 

   SOGoCache.h:29:36: warning: libmemcached/memcached.h: No such file or directory

Would someone knows how to resolve this issue ?

Best regards,
arnaud

Good Tutorial

nirwan's picture
Submitted by nirwan (not verified) on Wed, 05/13/2009 - 05:04.

Pertamax!!

Webcast
More Resources
How to Build an Optimal Hadoop Cluster to Store and Maintain Unlimited Amounts of Data Using Microservers

Realizing the promise of Apache® Hadoop® requires the effective deployment of compute, memory, storage and networking to achieve optimal results. With its flexibility and multitude of options, it is easy to over or under provision the server infrastructure, resulting in poor performance and high TCO. Join us for an in depth, technical discussion with industry experts from leading Hadoop and server companies who will provide insights into the key considerations for designing and deploying an optimal Hadoop cluster.

Learn More

Sponsored by AMD

White Paper
More Resources
Red Hat White Paper: Using an Open Source Framework to Catch the Bad Guy

Built-in forensics, incident response, and security with Red Hat Enterprise Linux 6

Every security policy provides guidance and requirements for ensuring adequate protection of information and data, as well as high-level technical and administrative security requirements for a system in a given environment. Traditionally, providing security for a system focuses on the confidentiality of the information on it. However, protecting the data integrity and system and data availability is just as important. For example, when processing United States intelligence information, there are three attributes that require protection: confidentiality, integrity, and availability.

Learn more about catching the bad guy in this free white paper.

Learn More

Sponsored by DLT Solutions