71 lines
2.6 KiB
Plaintext
71 lines
2.6 KiB
Plaintext
# $OpenBSD: README,v 1.6 2015/12/14 07:01:04 sebastia Exp $
|
|
|
|
+-----------------------------------------------------------------------
|
|
| Running ${FULLPKGNAME} on OpenBSD
|
|
+-----------------------------------------------------------------------
|
|
|
|
The OpenGroupware system user
|
|
=============================
|
|
|
|
The system user and group intended to run the OpenGroupware application server
|
|
is called _opengroupware. The users home directory is ${VARBASE}/opengroupware.
|
|
|
|
OpenGroupware with apache-httpd
|
|
===============================
|
|
|
|
OpenGroupware requires the mod_ngobjweb module used with Apache2. The one
|
|
that comes with the OpenGroupware package is built against apache-httpd
|
|
package.
|
|
|
|
Per default the web server runs in a chroot environment. Therefore you have to
|
|
copy some files into the server's chroot environment:
|
|
|
|
# mkdir -p ${VARBASE}/www/htdocs/OpenGroupware55.woa
|
|
# cp -R ${TRUEPREFIX}/share/opengroupware/www \
|
|
${VARBASE}/www/htdocs/OpenGroupware55.woa/WebServerResources
|
|
|
|
The web server needs the ngobjweb Apache module loaded. The following line
|
|
need to be added to ${SYSCONFDIR}/apache2/httpd2.conf:
|
|
|
|
LoadModule ngobjweb_module ${PREFIX}/lib/apache2/ngobjweb_module.so
|
|
|
|
A sample configuration is installed as example
|
|
# cp ${TRUEPREFIX}/share/examples/opengroupware/opengroupware.conf ${SYSCONFDIR}/etc/apache2/extra
|
|
|
|
Enable the loading of that file in ${SYSCONFDIR}/apache2/httpd2.conf:
|
|
Include ${SYSCONFDIR}/extra/opengroupware.conf
|
|
|
|
Then restart apache to make the changes effective
|
|
# rcctl restart apache2
|
|
|
|
OpenGroupware configuration example
|
|
===================================
|
|
|
|
Example configuration files for a simple setup are installed with the package.
|
|
In order to use them, copy the files as user _opengroupware
|
|
to the users Defaults directory:
|
|
|
|
$ cp ${TRUEPREFIX}/share/examples/opengroupware/*.plist ~/GNUstep/Defaults/
|
|
|
|
The example assumes you have all the services necessary to run OpenGroupware
|
|
on the localhost. These are an LDAP server, an IMAP server, and a PostgreSQL
|
|
database.
|
|
|
|
You can edit the OpenGroupware configuration files manually with your
|
|
favourite text editor, but doing so is discouraged. Better use the GNUstep
|
|
defaults(1) tool. See the manual page for advice how to use it.
|
|
|
|
Initializing the database
|
|
=========================
|
|
|
|
Change to the _postgresql user, and create the database:
|
|
|
|
# su - _postgresql
|
|
$ createuser _opengroupware
|
|
$ createdb -O _opengroupware -E UTF-8 -t template0 opengroupware
|
|
$ psql -U _opengroupware opengroupware < \
|
|
${TRUEPREFIX}/lib/opengroupware/commands/OGo.model/Resources/pg-build-schema.psql
|
|
|
|
You may have to edit the pg_hba.conf to grant access for the
|
|
_opengroupware user.
|