Page History

...

This Add-On also integrates DSpace with DuraCloud for users that wish to easily back up their content into DuraCloud directly from their DSpace administrative interface.

Info

title	2013-May-3: New Release of Replication Task Suite

On May 316, 2013, two new versions of the Replication Task Suite (RTS) were released:

RTS, version 3.12- compatible with DSpace 3.x releases (this release is nearly identical to the below 1.1 2 release, except for minor DSpace 3.x compatibility fixes)
- To upgrade to RTS 3.1 from 3.0-SNAPSHOT2 from a previous version, simply change your pom.xml (see Installation on DSpace 3.x) to reference 'dspace-replicate' version 3.12. Then rebuild DSpace & re-run 'ant update'. Your existing RTS 3.x configuration files will still work with RTS 3.12.
RTS, version 1.12 - bug-fix release, compatible with DSpace 1.8.x releases. This fixes a Java 6 incompatibility bug in version 1.1 (see Pull Request #10). It also includes fixes for several small bugs in 1.0 (namely with the event consumer utilized during Automatic Replication). The exact fixes between 1.0 and 1.1 are detailed in Pull Request #7 and (fixed in 1.1), Pull Request #8 (fixed in 1.1) and Pull Request #10 (fixed in 1.2) .
- To upgrade to RTS version 1.1 from 1.02 from a previous release, simply change your pom.xml (see Installation on DSpace 1.8.x) to reference 'dspace-replicate' version 1.12. Then rebuild DSpace & re-run 'ant update'. Your existing RTS 1.x configuration files will still work with RTS 1.12.

Note

title	Usage Examples

For a quick overview of the various tasks offered in the Replication Task Suite, along with some real-life scenarios / examples of where each Replication task may come in handy, you may wish to skip directly to the Problem Statement and Usage Examples section at the bottom of this page.

...

Table of Contents

minLevel	2
outline	true
style	none

Installation

Supported

...

Replication Task Suite with DuraCloud backend: requires Java 7 be installed on your DSpace server, as the DuraCloud Java API requires Java 7.
Replication Task Suite (standalone): may be used with either Java 6 or Java 7 on your DSpace server.

...

DSpace and Java Versions

The Replication Task Suite currently supports the following versions of DSpace software:

Replication Task Suite Version	Supported DSpace Version(s)	Supported Java Version	Supported Interfaces	Notes
3.12	DSpace version 3.x	Java 7 or above	XMLUI and/or commandline	The 3.1 2 stable version of the Replication Task Suite is nearly identical to the 1.1 2 stable version. It just includes minor bug fixes to ensure the Replication Task Suite is compatible with the new DSpace 3.x API.
1.12	DSpace version 1.8.x	Java 6 or above	XMLUI and/or commandline	Highly recommended to use either DSpace 1.8.1 or 1.8.2. DSpace 1.8.0 has a known bug where running a Replication Task will always return a NullPointerException - see DS-1077

...

In your DSpace Source directory ([dspace-src]), you will need to modify the following POM file:
- [dspace-src]/dspace/modules/additions/pom.xml (This POM will ensure that the "dspace-replicate" dependency is made available to commandline and ALL DSpace interfaces)

For this pom.xml file, add the following <dependency> section at the end of the existing <dependencies> section (just before the closing </dependencies> tag).

Code Block

<dependencies>
    ...

	<!-- Adding this dependency will install the Replication Task Suite Addon -->
	<dependency>
   		<groupId>org.dspace</groupId>
   		<artifactId>dspace-replicate</artifactId>
   		<version>3.1<2</version>
	</dependency>
</dependencies>

Once you've finished modifying both pom.xml files, rebuild DSpace by running the following from your [dspace-src]/dspace/ folder:
Code Block
mvn clean package
Follow the instructions in the Configuration section below in order to enable & configure the Replication Task Suite Add-On.
1. You may wish to ensure these configurations exist in your [dspace-src]/dspace/config/ directory. That way they will be auto-installed/copied whenever you run "ant update" (see next step).

You will need to update your existing DSpace 3.x installation, by running the following from your [dspace-src]/dspace/target/dspace-[version]-build/ directory

Code Block
ant update

Note

Alternatively, if you don't want to do a full DSpace update, you can just update your existing binaries & webapps by running the following two commands:

ant update_code (Updates the existing [dspace]/lib/ directory)
ant update_webapps (Updates the existing [dspace]/webapp/ directory)

...

In your DSpace Source directory ([dspace-src]), you will modify two Maven pom.xml files:
- [dspace-src]/dspace/pom.xml (This POM controls dependencies of CommandLine scripts. Modifying it will let you run dspace-replicate from commandline)
- [dspace-src]/dspace/modules/xmlui/pom.xml (This POM controls dependencies of XMLUI. Modifying it will let you run dspace-replicate from XMLUI)

For each of these pom.xml files, add the following <dependency> section at the end of the existing <dependencies> section (just before the closing </dependencies> tag).

Code Block

<dependencies>
    ...

	<!-- Adding this dependency will install the Replication Task Suite Addon -->
	<dependency>
   		<groupId>org.dspace</groupId>
   		<artifactId>dspace-replicate</artifactId>
   		<version>1.1<2</version>
	</dependency>
</dependencies>

Once you've finished modifying both pom.xml files, rebuild DSpace by running the following from your [dspace-src]/dspace/ folder:
Code Block
mvn clean package
Follow the instructions in the Configuration section below in order to enable & configure the Replication Task Suite Add-On.
1. You may wish to ensure these configurations exist in your [dspace-src]/dspace/config/ directory. That way they will be auto-installed/copied whenever you run "ant update" (see next step).

You will need to update your existing DSpace 1.8.x installation, by running the following from your [dspace-src]/dspace/target/dspace-[version]-build/ directory

Code Block
ant update

Note

Alternatively, if you don't want to do a full DSpace update, you can just update your existing binaries & webapps by running the following two commands:

ant update_code (Updates the existing [dspace]/lib/ directory)
ant update_webapps (Updates the existing [dspace]/webapp/ directory)

...

Page tree

Versions Compared

Old Version 122

New Version 123

Key

Installation

Supported

DSpace and Java Versions