Note: this is a bit different for Apache 2.0. In general we recommend using Apache 1.3.29 and up with OGo and not 2.0.x! In addition Apache 2.0.48 seems to work not at all in the moment.

OGo Apache Setup Howto

Note: This part is quite tricky at the moment. For now it it possible to run the OpenGroupware.org server 'standalone' - we will provide a package with pre-built Apache adapters as soon as we can manage. If you really want to use an Apache webserver right now, read on.

To start the server stand-alone, do the steps shown below. As always, change the paths to match your local installation.

$ su - opengroupware
$ cd /usr/lib/opengroupware.org/WOApps
$ ./OpenGroupware.woa/ix86/linux-gnu/gnu-fd-nil/OpenGroupware \
   -WOPort 20000 -WOHttpAllowHost [your-host]

The disadvantage of this step - only the host [your-host] is able to access the server. And no, you can't use wildcards here - the only chance to add some more hosts is by specifying an array like this:

$ ./OpenGroupware.woa/ix86/linux-gnu/gnu-fd-nil/OpenGroupware \
-WOPort 20000 -WOHttpAllowHost '([your-host],[your-host2])'

First get the mod_ngobjweb sources: opengroupware.org-mod_ngobjweb-latest.tar.gz. After you downloaded the archive and extracted the files, adjust the Makefile so that it points to the right directories. You need to have an Apache, its header files and the 'apxs' tool installed on your system. Now type 'make'. After the compilation a file ngobjweb-x.xx.so will be created (where x.xx is your Apache version).

Create the directory /usr/lib/opengroupware.org/WebServer and copy the file there.

Now edit the Apache config file (usually located at /etc/apache/httpd.conf or /etc/httpd/httpd.conf) and add the following entries:

LoadModule ngobjweb_module <path to the ngobjweb module>

AddModule ngobjweb_module.c

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

Alias /OpenGroupware.woa/WebServerResources/ \
  /usr/lib/opengroupware.org/WebServerResources/

Adjust the paths to match your system. Now start the OpenGroupware.org application (for hand by now, init-scripts will be provided soon) and connect to it through 'http://your.web.server/OpenGroupware'.

Below follows a transcript of the steps described above.

$ su - opengroupware
$ tar xzf mod_ngobjweb.tar.gz
$ cd mod_ngobjweb
# [edit the Makefile]
$ make
$ mkdir -p /usr/lib/opengroupware.org/WebServer
$ cp ngobjweb* !$
$ su - root
$ vi /etc/apache/httpd.conf
# [insert the entries shown above]
$ /etc/init.d/apache restart
$ [press CTRL+D]
$ cd /usr/lib/opengroupware.org/WOApps
$ ./OpenGroupware.woa/ix86/linux-gnu/gnu-fd-nil/OpenGroupware
# now point your webserver to the URL mentioned above