Sebastian’s blog

• Second part: Database
• Third part: LDAP
• Fourth part: Finish

First some notes.
The installation and compile notes on opengroupware.org are either

• not relevant (wrong distro, wrong architecture) or
• outdated (current release is 1.1.7, compile notes still talk about 1.0beta)

Also, there are a lot of pitfalls when compiling such a huge project.

I had to install OpenGroupware.org on a company machine, so why not document the process?

I’m not the perfect sysadmin and I’ve not written many guides, so I’m sorry if there’s something missing or if I don’t do stuff as they “should be done“. You can always leave comments and I might follow up on them.

This is the first part, where I will compile & install OpenGroupware.org.
The second part will be the database setup & creation.
The third part will cover LDAP connectivity.

Make sure you don’t forget any commands, because the source is so fragile it might not compile anymore after adding a prior dependency.

Install subversion, build-essential & gobjc. Necessary to retrieve & compile the latest OGo release.

sudo apt-get install subversion build-essential gobjc-4.2

Create a new “ogo” directory in your home directory. This is where we will put the code and compile stuff.

mkdir ogo
cd ogo

Check out the SOPE 4.7.1 & OGo 1.1.5 source code:

svn co http://svn.opengroupware.org/SOPE/releases/4.7.1-fwd/
svn co http://svn.opengroupware.org/OpenGroupware.org/releases/1.1.5-moveon/

Build gnustep-make. This is needed as a basis for both SOPE and OGo. Do not install gnustep-make or gnustep-make-ogo from the package archives, they won’t work with the new versions of SOPE and OGo.

cd ~/ogo/4.7.1-fwd/gnustep-make
./configure –with-library-combo=gnu-fd-nil
make
sudo make install

Your GNUstep environment is now in /usr/GNUstep.

Install the optional libraries for SOPE: xml2, ldap, ssl, pq, sqlite3, mysqlclient.

sudo apt-get install libxml2-dev libldap2-dev libssl-dev libpq-dev libsqlite3-dev libmysqlclient15-dev

Compile libFoundation. This is a basis library for objective C development. There is a package for this, but the package had some problems with OGo when it was compiled.

cd ~/ogo/4.7.1-fwd/libFoundation
source /usr/GNUstep/System/Library/Makefiles/GNUstep.sh
./configure
make
sudo make install

libFoundation is now in /usr/GNUstep/System/Libraries/Resources.

Now compile & install SOPE.

cd ~/ogo/4.7.1-fwd
./configure
make
sudo mkdir /usr/local/lib64
sudo make install

It’ll all be installed under /usr/local.

Now build OpenGroupware.

cd ~/ogo/1.1.5-moveon
./configure
make
sudo make install

So far I have not found a way to compile in PDA support (libpisock), because the Ubuntu-supplied one does not work with OGo 1.1.5, and compiling it myself didn’t work out.

OGo uses non-default library paths (/usr/local/lib64), these need to be added to the library search path of the system.

sudo nano /etc/ld.so.conf.d/x86_64-linux-gnu.conf

Add /usr/local/lib64 at the end of the file, save and exit. Now run

sudo ldconfig

to reload the config.

The Apache connector is missing. Install the apache2 development headers and build ngobjweb with:

sudo apt-get install apache2-prefork-dev (depends on your version of apache… threaded or prefork)
cd ~/ogo/4.7.1-fwd/sope-appserver/mod_ngobjweb
sed -i s/ap_http_method/ap_http_scheme/ handler.c
make
sudo make install

Now we need the theme resource files of OpenGroupware:

cd /usr/local/share/opengroupware.org-1.1
sudo rm templates translations
sudo cp -r ~/ogo/1.1.5-moveon/Themes/WebServerResources/ ./www
sudo cp -r ~/ogo/1.1.5-moveon/WebUI/Templates ./templates
sudo cp -r ~/ogo/1.1.5-moveon/WebUI/Resources ./translations

HowTos on setting up an apache2 server can be found anywhere, so I won’t go into details. After it is installed:

cd /etc/apache2/conf.d
sudo nano ngobjweb

The file should look like this:

LoadModule ngobjweb_module /usr/GNUstep/System/Library/WOAdaptors/Apache/mod_ngobjweb.so

<LocationMatch “^/OpenGroupware*”>
SetHandler ngobjweb-adaptor
SetAppPort 20000
</LocationMatch>

Alias /OpenGroupware11.woa/WebServerResources/ \
/usr/local/share/opengroupware.org-1.1/www/

Save & exit.

You should now create a user that will be used to run OpenGroupware.

sudo adduser –system –shell /bin/bash ogo
sudo su ogo
source /usr/GNUstep/System/Library/Makefiles/GNUstep.sh
ogo-webui-1.1

And that’s it. By going to $YOUR_WEBSERVER/OpenGroupware, you should see the OpenGroupware page (with graphics hopefully) showing an error that the database is missing. But for that, see part 2, coming soon.

Update:
1.1.7 was throwing segfaults when accessing project files. This does not happen with 1.1.5, so the above has been changed. Generally, the instructions work for both versions.

Update 2:
Sorry, something else missing.

As your regular user, do:

sudo mkdir /var/lib/ogo
sudo chown ogo.nogroup /var/lib/ogo
sudo chmod 700 /var/lib/ogo
sudo su ogo
source /usr/GNUstep/System/Library/Makefiles/GNUstep.sh
Defaults write NSGlobalDomain LSAttachmentPath /var/lib/ogo

The directory /var/lib/ogo will then serve as file database for OpenGroupware.

Posted on September 13th, 2008 under Linux • RSS 2.0 feed • Leave a response, or trackback