[extrods] r254 committed - verion 1.0

[codesite...@google.com]

Revision: 254
Author: bing...@yahoo.com
Date: Tue Nov 15 00:42:01 2011
Log: verion 1.0
http://code.google.com/p/extrods/source/detail?r=254

Modified:
/trunk/CrossZoneRepl/readme.txt

=======================================
--- /trunk/CrossZoneRepl/readme.txt Tue Nov 1 23:18:38 2011
+++ /trunk/CrossZoneRepl/readme.txt Tue Nov 15 00:42:01 2011
@@ -1,25 +1,32 @@
The program is used to replicate datasets, including files and
user-defined metadata, from one zone to
another designated zone.

-1. Build the software
- (1) Modify the "IRODS_SRC_HOME" in Makefile so that it points to the
iRODS software directory.
- (2) run 'make'
- (3) The executable, CrossZoneRep, should be created.
-
-2. Edit the configuration file for the cross-zone file replication
service, 'CrossZoneRepl.cfg'.
+1. Build the software: a short version
+ (1) run 'configure'
+ (2) run 'make install'
+ This will install the software in the directory specified in
the 'configure'.
+
+ Example:
+ > ./configure --irods_src_home=/usr/local/iRODS --install_dir=/opt
+ > make install
+ The software will be installed in the
directory '/opt/CrossZoneRepl'.
+
+2. Edit the configuration file for the cross-zone file replication
service, 'crosszonerepl.cfg'.
(1) add the irods source collection info: irods server, user account,
top source collection for replication.
(2) add the irods destination info: irds server, user account, top
iRODS collection for file replication.
-
Note: A sample 'crosszonerepl.cfg' is provided in the package.

3. Manually test the program
- Example: $ CrossZoneRepl
-configfile=/data/bzhu/irods_dev/corsszonerepl.cfg
-
-4. Deployment of the cross-zone file replication service
+ Run the 'run_CrossZoneRepl.sh' in the installation directory.
+ Example: $ cd /opt/CrossZoneRepl
+ $ run_CrossZoneRepl.sh
+ $ more irods_repl.log --> to check the log file.
+
+4. Deployment of the cross-zone data replication service

Method #1: The program can be deployed as a UNIX cron job that scans
a designated source iRODS collection and
its child collections periodically to replicate new files into the
specified destination collection in
- another iRODS zone.
+ another iRODS zone.

Method #2: The program can also be deployed inside iRODS as an micro
service for an external program that runs
- periodically to do corss-zone file replication.
+ periodically to do cross-zone data replication.