$OpenBSD: README-main,v 1.23 2015/01/31 10:01:54 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
=================================

See the following URL for other MTA integration:
    http://www.zarafa.com/wiki/index.php?title=MTA_integration&oldid=2487

Alternatively 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}

Configuration is done in the file
    ${INSTDIR}/config.php

With Apache, AllowOverride settings are required on the ${INSTDIR}
directory. You can configure this as follows:
    # ln -sf ${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

The Zarafa webaccess will be accessible from
    http://<hostname>/webaccess/

HTTP server locale
------------------
LANG needs to be set to an UTF-8 compliant locale on the Web server.
When using httpd(8), 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:\
	:tc=daemon:

Documentation and help
======================

Each zarafa-* command has its corresponding manpage.

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