OpenPaaS ESN Frontend for SabreDAV

Welcome to the OpenPaaS frontend for SabreDAV. This frontend adds calendaring and address book capabilities to your OpenPaaS instance and allows you to access them via standard CalDAV and CardDAV clients like Lightning.

Setting up the Environment

Those are the steps needed on an Ubuntu distribution, but the equivalent can be found for any Linux flavor.

Install esn-sabre

cd /var/www/html
git clone https://ci.open-paas.org/stash/scm/or/esn-sabre.git

The OpenPaaS frontend is managed through composer, all requirements can easily be set up using:

cd esn-sabre
composer update

This command can be repeated to update package versions.

create the configuration file

The configuration file can be created from the example file.

cp config.json.default config.json

or by running the generation script:

sh ./scripts/generate_config.sh > config.json

You then have to modify the configuration to match your setup.

• webserver.baseUri

The local part of the url that bring the esn.php file.

From apache, if you reach esn.php through http://YOUR_ESN_SABRE_IP/esn-sabre/esn.php then your baseUri is /esn-sabre/esn.php.

By using Docker your baseUri is only /.

• webserver.allowOrigin

This setting is used to configure the headers returned by the CalDAV server. It's usefull to configure CORS. Either set the hostname of your ESN server, or leave "*".

• database.esn

This is the configuration to access the ESN datastore

• database.sabre

This is the configuration where the CalDAV server will store its data.

• esn.apiRoot

This is the URL the Caldav server will use to access the OpenPaaS ESN API.

• mail

This is the configuration the Caldav server will use to send emails.

System & Apache environment

esn-sabre requires an Apache server to work.

• Install PHP5 support into Apache

apt-get install libapache2-mod-php5

Ubuntu 16.04

apt install php5.6
apt install libapache2-mod-php5.6

• Install mongodb & curl support in PHP

apt-get install php5-mongo php5-curl

Ubuntu 16.04

apt-get install php5.6-mongo php5.6-curl

If composer update throws an error, you might want to use PECL

apt-get install php5-dev php-pear && pecl install mongo

Ubuntu 16.04

apt-get install php5.6-dev php-pear && pecl install mongo

Depending on your linux version you may need to add mongo extension in php.ini

extension=mongo.so
extension=mbstring.so

• Restart Apache

/etc/init.d/apache2 restart

• Test your environment by pointing a browser to the "esn.php" file

  http://your.server.example.com/esn-sabre/esn.php

Enable the Caldav support in OpenPaaS ESN

The caldav support in OpenPaaS ESN is enabled by telling the system where to find the caldav server. To do so, create a document in the configuration collection, having this structure:

{
        "_id" : "davserver",
        "backend" : {
                "url" : "http://192.168.7.6/esn-sabre/esn.php" // replace 192.168.7.6 by your localhost
        },
        "frontend" : {
                "url" : "http://my-caldav-server.example.com/esn-sabre/esn.php"  // replace my-caldav-server.example.com by your localhost
        }
}

The backend url is used by the ESN SERVER to access the caldav server. The frontend url is used by the user's browser to access the caldav server.

Unit tests and codestyle

A simple Makefile exists to make it easier to run the tests and check code style. The following commands are available:

make test                        # Run all tests
make test TARGET=tests/CalDAV/   # Run only certain tests
make test-report                 # Run tests and create a coverage report

make lint                        # Check code style for the whole project
make lint TARGET=lib/            # Check only certain files for lint

The coverage report will be placed in the tests/report directory, a clickable link will be presented when done.

Docker

Build

docker build -t linagora/esn-sabre .

Run

In order to run, the ESN sabre instance must access to the ESN, and mongo instances. They can be configured from the run command using these optional environment variables:

• SABRE_MONGO_HOST: Mongodb instance used to store sabre data, defaults to 'sabre_mongo'
• SABRE_MONGO_PORT: Port used by the Mongodb instance defined above, defaults to '27017'
• ESN_MONGO_HOST: Mongodb instance of the ESN, used to create principals, defaults to 'esn_mongo'
• ESN_MONGO_PORT: Port of the ESN Mongodb instance, defaults to '27017'
• ESN_MONGO_DBNAME: Database name of the ESN Mongodb instance, defaults to 'esn'
• ESN_HOST: Hostname of the ESN API, defaults to 'esn_host'
• ESN_PORT: Port of the ESN API, defaults to '8080'
• AMQP_HOST: AMQP instance used by Sabre and the ESN, defaults to 'amqp_host'
• AMQP_PORT: Port of the instance defined just above, defaults to '5672'
• MONGO_TIMEOUT: Timeout to connect to Mongodb, defaults to 10000 ms

For example:

docker run -d -p 8001:80 -e "SABRE_MONGO_HOST=192.168.0.1" -e "ESN_MONGO_HOST=192.168.0.1" linagora/esn-sabre

This will launch the Sabre container, create its configuration, launch Sabre and expose on port 8001 on your host.