OpenGroupware.org Installation Guide
====================================


Prerequisites
=============

SOPE 4.3
- gnustep-make (eg ThirdParty/gstep-make)
- Foundation library (eg ThirdParty/libFoundation)
- libxml2/libxml2-dev
- autoconf
- openldap2/openldap2-dev
- libical (eg ThirdParty/libical)
- postgresql-dev

PDA
- libpisock (eg ThirdParty/pilot-link or libpisock-dev on Debian)

(Internal) Dependencies
=======================

Logic
- SOPE 4.3

DocumentAPI
- Logic

WebUI
- Logic
- DocumentAPI

Tools
- Logic
- DocumentAPI

XmlRpcAPI
- Logic
- DocumentAPI

ZideStore
- Logic

PDA
- Logic
- DocumentAPI

Building
========

If the prerequisites are properly fulfilled, building OpenGroupware.org is
a simple:

  make -s debug=yes strip=yes all

Get a coffee, compiling all the OGo packages takes about 8 minutes on Debian 
Athlon 1.8+ (and about 17 minutes on a MacOSX G4 1.25).

Installation:

  make -s debug=yes strip=yes install

Important: ensure that GNUstep.sh from gnustep-make is properly loaded into the
           shell environment, otherwise you will see errors like "/common.make"
           not being found.

Configuration
=============

TODO: write configuration guide for OGo 1.0.

- mod_ngobjweb setup
- init script
- starting OGo on the shell
- ZideStore
- nhsd

- links
  - pushd $GNUSTEP_USER_ROOT
  - ln -s ~/myogosrctree/WebUI/Resources .
  - ln -s ~/myogosrctree/Themes/WebServerResources .

- database
  - su - postgres
  - createuser OGo
  - createdb   OGo
  - psql -h localhost OGo OGo (must work)
  - cd Database/PostgreSQL/
  - psql -h localhost OGo OGo < pg-build-schema.psql

- defaults
  - LSConnectionDictionary
  - NGBundlePath
    Defaults write NSGlobalDomain NGBundlePath \
      '"$(GNUSTEP_USER_ROOT)/Library/OpenGroupware.org-1.0a/Commands:$(GNUSTEP_USER_ROOT)/Library/OpenGroupware.org-1.0a/DataSources:$(GNUSTEP_USER_ROOT)/Library/OpenGroupware.org-1.0a/WebUI:$(GNUSTEP_USER_ROOT)/Library/OpenGroupware.org-1.0a/"'