Installation

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

Download XARs

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 - Core" and "Messaging and Replication" (in this order).

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. On the GitHub page there is a change log available.

Enabling automatic startup of extension

The 'receivers' of the messaging and replication features can be started by using the xquery functions. To get these 'jms listeners' started at database start, xquery scripts can be added to /db/system/autostart.

More information can be found on the Startup-Triggers page

The XQueryStartupTrigger is available after eXist-db v2.2rc. The xquery functions are available since rev 0.7 of the extension.

---

Notes

It is not recommended and supported but still possible to 'just' install the extension by copying all generated and thirdpary JAR files into ${exist.dir}/lib/user

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

For older versions of the extension (< v0.7) and eXist-db (v2.1), the only option to automatically start the extension, is to start the extension via an conf.xml entry. In this case all JAR files must be extracted from the XAR files and copied into the lib/user directory.