[OGo-MacOSX] Howto: build OGo on Mac OS X

[Marcus Müller]

Hi folks,

this question has been asked quite frequently in the last couple of 
weeks, so I'll write down the current steps for all to read/verify.

Prerequisites:
--------------

The current build of OGo is based on gstep-make. We don't expect that 
to change too soon, as we don't have Xcode projects for OGo - and 
setting up and maintaining Xcode projects for a project of this size is 
quite a hassle (not to mention the handling of update conflicts etc.).

So, in order to get OGo up and running, a fairly new version of the 
GNUstep make package (gstep-make) is required.
Get gstep-make here: 
http://ftp.gnustep.org/pub/gnustep/core/gnustep-make-1.10.0.tar.gz

Also, we use Subversion (http://subversion.tigris.org) as our 
versioning system. In order to check out the sources from our anonymous 
Subversion repository, you need to have a Subversion client of some 
sort on your system. A very well done binary package of the commandline 
client for Mac OS X can be downloaded here: 
http://metissian.com/projects/macosx/subversion/

The last prerequisite is PostgreSQL. Pre-built binaries are available 
here: http://www.entropy.ch/software/macosx/postgresql/
If you're really die-hard and feel like having to kill some time, you 
can build PostgreSQL from source. Apple provides instructions how to do 
that here: http://developer.apple.com/internet/opensource/postgres.html

Building:
---------

1) Install gstep-make
a) Setup gstep-make like this:
OGoROOT="$HOME/OGoRoot"
./configure --prefix=$OGoROOT \
         --without-system-root           \
         --with-user-root=$OGoROOT       \
         --with-local-root=$OGoROOT      \
         --with-network-root=$OGoROOT    \
         --with-library-combo=apple

Note: the location of OGoROOT can be chosen arbitrarily, but having it 
somewhere in your home directory has the benefit of not having to be 
root during installs (this rule is imposed by gstep-make).

b) install gstep-make
make install

c) suck in the gstep-make shell environment. This depends on the shell 
you are using.
c) 1) If you're using bash, do
       source $OGoROOT/Library/Makefiles/GNUstep.sh
c) 2) If you're using tcsh, do
       source $OGoROOT/Library/Makefiles/GNUstep.csh

Note: this step is really important and always(!) required if you spawn 
a new shell and want to do something with OGo! It's suboptimal to have 
it this way, but as long as we don't have an FHS install on Mac OS X, 
this will remain a requirement.

2) If you don't already have the source, get it from 
svn.opengroupware.org. The following is the syntax you will use if you 
have the commandline client installed:
svn co http://svn.opengroupware.org/ThirdParty/trunk ThirdParty
svn co http://svn.opengroupware.org/SOPE/trunk SOPE
svn co http://svn.opengroupware.org/OGo/trunk OGo

This will check out the trunks of the three major required components 
to build OGo.

3) Build & install libical from ThirdParty:
./cfg-gnustep
make -s install

4) Build & install SOPE:
make -s debug=yes install

5) Build & install OGo:
make -s debug=yes install

Note: continue reading here: 
http://www.opengroupware.org/en/devs/build/ogo.html
The last steps including configuration are identical on all platforms.

Note 2: configuration requires quite some steps! You need to get the DB 
schema in your PostgreSQL database, set some defaults etc. This has to 
be done only once, though.

Cheers,

   Marcus

-- 
Marcus Mueller  .  .  .  crack-admin/coder ;-)
Mulle kybernetiK  .  http://www.mulle-kybernetik.com
Current projects: finger znek@mulle-kybernetik.com