$OpenBSD: README-main,v 1.15 2011/12/22 17:10:04 ajacoutot Exp $

+-----------------------------------------------------------------------
| Running ${FULLPKGNAME} on OpenBSD
+-----------------------------------------------------------------------

*** Upgrading users: refer to zarafa documentation on the web to check
*** if any particular step is required after upgrading to a new version. 

6.40 -> 7.0 upgrade
===================
See http://doc.zarafa.com/trunk/Release_Notes/en-US/html/_upgrading_to_zcp_7_0.html

The zarafa7-upgrade script is available at:
    ${TRUEPREFIX}/share/doc/zarafa/zarafa7-upgrade
Note that this script requires the py-mysql package.

Post-install/update instructions for Zarafa
===========================================
By default the server is configured to accept SOAP connections on port
236. If you wish to connect Outlook clients on port 80, please setup
your web server to proxy HTTP requests with URI=/zarafa to
http://localhost:236.

It is advised to tune the MySQL installation according to:
    http://doc.zarafa.com/trunk/Administrator_Manual/en-US/html/_memory_usage_setup.html
    http://zarafa.com/wiki/index.php/MySQL_tuning
(especially for max_allowed_packet)

Before Starting zarafa-server for the first time
------------------------------------------------
A MySQL datatabase access needs to be configured in
    ${SYSCONFDIR}/zarafa/server.cfg

After zarafa-server was started for the first time
--------------------------------------------------
Creating the public store.
    # ${TRUEPREFIX}/bin/zarafa-admin -s

Adding an admin user -- see zarafa-admin(1).
    # ${TRUEPREFIX}/bin/zarafa-admin -c zadmin -p secret \
        -e zarafa.admin@domain.tld -f "John Doe" -a 2

Mail delivery agent configuration
=================================
The easiest way to use zarafa-dagent system-wide under a stock OpenBSD
sendmail(8) installation is to use procmail(1).
See the following URL for other MTA integration:
    http://www.zarafa.com/faq/mta/mta

Anyway, here are the 3 ways of integrating Zarafa with sendmail(8).

* Using procmail.

First, install the procmail package and configure ${SYSCONFDIR}/procmailrc
the following way:

:0w
* ^X-Spam-Status: Yes
| ${TRUEPREFIX}/bin/zarafa-dagent -j $LOGNAME
EXITCODE=$?

:0w
| ${TRUEPREFIX}/bin/zarafa-dagent $LOGNAME
EXITCODE=$?

Next, you need to add the following line to your sendmail.mc file then
restart sendmail(8):
    FEATURE(`local_procmail')dnl

* Configuring sendmail to use the zarafa-dagent directly.

To enable the Zarafa dagent delivery from localhost, add the following
lines to your sendmail.mc and restart sendmail(8):
    FEATURE(`local_zarafa')dnl
To enable the Zarafa dagent for all other deliveries, add the following:
    MAILER(`zarafa')dnl

* Using a .forward file.

Add the following .forward file under the user(s) home directory that
will use Zarafa:
"|${TRUEPREFIX}/bin/zarafa-dagent <username>"

You can automate this step by copying
    ${TRUEPREFIX}/share/examples/zarafa/createuser.dotforward
to
    ${SYSCONFDIR}/zarafa/userscripts/createuser.d/
The .forward will be automatically generated when a new user is added to
Zarafa.

Zarafa webaccess
================
Zarafa webaccess is installed under
    ${INSTDIR}

You need to edit the config.php file installed under
${INSTDIR} for regular web client access.

With Apache, AllowOverride settings are required on the ${INSTDIR}
directory. You can configure this as follows:
    # ln -s ${PREFIX-web}/conf/modules.sample/zarafa.conf \
        /var/www/conf/modules

If you want to debug the webaccess, copy the following file
   ${INSTDIR}/debug.php.disabled
to
   ${INSTDIR}/debug.php
The debugging output will then be available under:
   ${INSTDIR}/debug.txt

You need to enable the PHP mapi module by creating a symbolic link from
${SYSCONFDIR}/php-${MODPHP_VERSION}.sample/${MODULE_NAME}.ini to ${SYSCONFDIR}/php-${MODPHP_VERSION}/${MODULE_NAME}.ini:

    # ln -fs ${SYSCONFDIR}/php-${MODPHP_VERSION}.sample/${MODULE_NAME}.ini \
        ${SYSCONFDIR}/php-${MODPHP_VERSION}/${MODULE_NAME}.ini

The PHP mapi module and OpenBSD Apache
--------------------------------------
When using the OpenBSD Apache server, the runtime loader will need to
pre-load the pthread shared library. While the php binary is linked with
-pthread, httpd is not and the PHP mapi module needs the
pthread_mutex_init(3) function. LANG will also need to be set to an
UTF-8 compliant locale.
To do so, create a login(1) class under /etc/login.conf(5) called after
the Apache rc.d(8) script, i.e. "httpd":

httpd:\
	:setenv=LANG=en_US.UTF-8\
	,LD_PRELOAD=/usr/lib/libpthread.so:\
	:tc=daemon:

Clients (Outlook) auto-update
=============================

When using the auto-update feature for Microsoft Outlook (TM) clients,
it is advised to clean-up old update logs by running the following
script from cron(8) once per day:
    ${TRUEPREFIX}/share/examples/zarafa/zarafa-client-update

Documentation and help
======================
Each zarafa-* command has its corresponding manpage.

Some documentation is also available on the Internet:
    http://www.zarafa.com/wiki/index.php/Main_Page
    http://www.zarafa.com/content/documentation
    http://doc.zarafa.com/trunk/Administrator_Manual/en-US/html/
