Installation

This page contains some important notes on installing the extension. Read the instructions for the replication extension closely.

The extension is available in the Public Application Repository. Installing the extension can be done with just a few clicks using the Package Manager. Install the latest "Messaging and Replication - Java libraries" and "Messaging and Replication" (in this order).

At this moment I realise that the names are not well chosen: it should have been resp. "Messaging and Replication" and "Messaging and Replication - User Interface" instead. It will be changed in the future.

Alternatively (e.g. when there is an corporate HTTP proxy involved requiring authorization - the Package Manager does not work in this case) the extension can be downloaded from the GitHub servers. This site contains always the latest and greatest versions of the XARs. Additionally there is a change log available.

---

Important notes for the replication extension

Due to the design of the package manager, the Java class loader adds the JAR files to the class path in a relative late phases during the startup of eXist-db.

The consequence is that the XAR files can not be used for the replication extension, at least not for the 'Receiver' or listener part, which is configured in conf.xml

The work around is to 'unzip' the "Messaging and Replication - Java libraries"-XAR file and put all JAR files in the EXISTHOME/lib/user directory manually.

I do have an idea how to to tackle this issue, a solution will be in place in the future. Issue is filed as Issue 13