Clustering - Orodan/Hilary GitHub Wiki

At the moment these are more aggregated notes for production Apereo OAE deployments.

For more questions and information in other areas of setting up an Apereo OAE production clusters, please get in touch with the OAE Developers list or send questions to [email protected].

Etherpad Storage

Etherpad storage should be configured away from the default "dirty.db" configuration. That is only suitable for development instances.

The OAE team has contributed a Cassandra storage driver that is now shipped with Etherpad. For detail on how to configure etherpad to point to your OAE cassandra database, you can refer to our puppet etherpad configuration template

Etherpad Clustering

Etherpad doesn't support clustering natively, so we distribute individual collabdoc content items to dedicated pads randomly. The following components come into play:

config.js: The config.js file has a config.etherpad property which defines an array of hosts. The ordering of the hosts in this list defines its numeric index in the cluster. We have an example puppet template of a production config.js for reference.

nginx.conf: In your nginx (or http reverse-proxy) configuration, you'll need to provide a location block to proxy to each of these servers individually. An example nginx.conf template that has these blocks is available in the project team puppet configurations.