Installing the JCR Connector

Setting the workspace

If you already downloaded the packaged modules from the Apogée download page, skip this section and go to the installation one.

Getting the sources

The JCR connector sources are located in the Apogée SVN directory. Run the following commands to checkout the connector projects.

svn co https://svn.nuxeo.org/pub/Apogee/trunk/sync/org.nuxeo.sync.jcr 

svn co https://svn.nuxeo.org/pub/Apogee/trunk/sync/org.nuxeo.sync.jcr.extensions

These two project are corresponding to different modules to install in the Funambol server:

• org.nuxeo.sync.jcr: the main part of the connector implementing the source and its administration panel.
• org.nuxeo.sync.jcr.extensions: JCR repositories handlers to access a RMI repository for example.

Downloading the dependencies

In order to build and install the connector, you will need to download the Funambol bundle version 3.0 Beta 1 (See links below for the download page). The connector works only with this version for the moment, but will be upgraded later.

Building the Funambol modules

The main part

First, cd into theorg.nuxeo.sync.jcr/build directory to run the ant script that will generate the module. Before to run this ant script, you will have to set an environment variable:

ANT_ARGS=funambol.home=/path/to/your/Funambol

Then simply run ant, the module will be created as the output/jcr-sync-X.Y.Z.s4j where X.Y.Z is the version of the module.

The extensions

To build this module, you just have to be sure that the org.nuxeo.sync.jcr project is located in the same directory and execute the following commands:

cd org.nuxeo.sync.jxr.extensions/build
ant

The module corresponds to the file output/jcr-extensions-X.Y.Z.s4j where X.Y.Z is the version of the module.

Installing the modules

To install the connector into the Funambol server, follow the next steps:

1. Copy both generated modules into the ds-server/modules directory of your funambol bundle
2. Start the funambol server if it is not already started
3. Edit the install.properties file in the ds-server directory and add the module names to the modules-to-install line in the following way

   modules-to-install=jcr-sync.X.Y.Z,jcr-extension.x.y.z,other-modules

4. Run the bin/install-modules.sh (or .bat) script to re-install all the modules. When using the Funambol bundle, the parameter to give is tomcat50