Note: in general we recommend to use Apache 1.3 with OGo, but Apache 2.x
reportedly works fine now as well.
Note:
The text is not completely checked against 1.0a packages, please provide
feedback!
OGo Apache Setup Howto
To start the server stand-alone, do the steps shown below.
As always, change the paths to match your local installation.
$ su - ogo
$ ogo-webui-1.0a \
-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:
$ ogo-webui-1.0a \
-WOPort 20000 -WOHttpAllowHost '([your-host],[your-host2])'
First get the mod_ngobjweb sources:
sope-mod_ngobjweb-trunk-latest.tar.gz
(the sources are contained in the SOPE package in sope-appserver/mod_ngobjweb).
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 /OpenGroupware10a.woa/WebServerResources/ \
/usr/local/share/opengroupware.org-1.0a/www/
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 - ogo
$ 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]
$ ogo-webui-1.0a
# now point your webserver to the URL mentioned above