README.cluster

eZ Oracle extension [EXTENSION_VERSION] cluster README

Configuration
=============

The instructions to set up eZ Publish clustering configurations on oracle are
available online:

http://doc.ez.no/Extensions/eZ-Publish-extensions/eZ-Publish-Extension-for-Oracle-R-database/5.0/Installation/Clustering

eZDFS instructions:
http://doc.ez.no/eZ-Publish/Technical-manual/4.7/Features/Clustering/Setting-it-up-for-an-eZDFSFileHandler

The main differences to set up clustering modes on oracle are:

Step 2: the value to be used for the DBBackend is eZDFSFileHandlerOracleBackend

also note that the DBHost, DBPort and DBSocket parameters are not used; only the DBName

Step 3: the definition of the database structures to be created can be found in:
  extension/ezoracle/clusterfilehandlers/dfsbackends/oracle.php

Cronjobs: the cluster_maintenance cronjob is

. not effective when using the Oracle eZDFS handler.
  A separate script is provided to the same effect:

  extension/ezoracle/bin/php/oracleclusterbinarypurge.php

  Please note that it can take a long time to run, as it has to scan the complete
  dfs mount point for expired files.
  It can put a lot of strain on the NFS server, too.
  Run it once with the --help option to see all available options for it and take
  advantage of those options to tune its usage to your needs.


Recommendations
===============

We strongly recommend to use a separate oracle schema
for the main content data and for cluster data.
Besides easing backups and maintenance operations, this setup guarantees that
the transactions used to insure correctness of operations in both databases
dot not mix up with each other, which might cause in unexpected (and hard to
track) behavior.

We recommend to use the UTF8 character set for the cluster database (and an
appropriate NLS_LANG environment variable client-side).