Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Installation on DSpace 7.x

Installation in the DSpace 7.x server (backend)
  1. 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)

  2. For this pom.xml file, add the following <dependency> section at the end of the existing <dependencies> section (just before the closing </dependencies> tag). NOTE: the exclusions are required to work around differences in DSpace and DuraCloud dependency versions.

    Code Block
    <dependencies>
        ...
        <!-- Adding this dependency will install the Replication Task Suite Addon -->
        <dependency>
           <groupId>org.dspace</groupId>
           <artifactId>dspace-replicate</artifactId>
           <version>7.0</version>
           <exclusions>
              <exclusion>
                 <groupId>com.amazonaws</groupId>
                 <artifactId>aws-java-sdk-core</artifactId>
              </exclusion>
              <exclusion>
                 <groupId>org.apache.httpcomponents</groupId>
                 <artifactId>httpmime</artifactId>
              </exclusion>
              <exclusion>
                 <groupId>org.springframework.security</groupId>
                 <artifactId>spring-security-core</artifactId>
              </exclusion>
           </exclusions>
        </dependency>
     
    </dependencies> 


  3. Once you've finished modifying the pom.xml file, rebuild DSpace by running the following from your [dspace-src]/dspace/ folder:

    Code Block
    mvn clean package
    


  4. Update the default dspace.cfg to include the Replication Task Suite config files. This ensures these configs are loaded as part of your DSpace configuration. This also allows you to override the configurations in your own local.cfg file. Including the duracloud.cfg file is only required if you are planning to replicate/backup your content to DuraCloud.

    Code Block
    include = ${module_dir}/replicate.cfg
    include = ${module_dir}/replicate-mets.cfg
    include = ${module_dir}/replicate-bagit.cfg
    include = ${module_dir}/duracloud.cfg


  5. Follow the instructions in the Configuration section below in order to enable & configure the Replication Task Suite Add-On.
  6. You will need to update Update your existing DSpace 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)


Installation in the DSpace 7.x UI
  1. In the DSpace 7.x UI, you will need to specify labels for the RTS tasks (so that descriptive names are displayed in the Curation Task list in the UI.) You can either add these directly to [dspace-angular]/src/assets/i18n/en.json5 or include them in the en.json5 file in your theme directory and execute the merge-i18n script. If your DSpace site supports languages other than English, you'll need to add these (and appropriate translations) to each language file available to users. 

    Code Block
      "curation-task.task.estaipsize.label": "Estimate Storage Space for AIP(s)",
      "curation-task.task.readodometer.label": "Read Odometer",
      "curation-task.task.transmitaip.label": "Transmit AIP(s) to Storage",
      "curation-task.task.transmitsingleaip.label": "Transmit Single Object AIP to Storage",
      "curation-task.task.verifyaip.label": "Verify AIP(s) exist in Storage",
      "curation-task.task.fetchaip.label": "Fetch AIP(s) from Storage",
      "curation-task.task.auditaip.label": "Audit against AIP(s)",
      "curation-task.task.removeaip.label": "Remove AIP(s) from Storage",
      "curation-task.task.restorefromaip.label": "Restore Missing Object(s) from AIP(s)",
      "curation-task.task.replacewithaip.label": "Replace Existing Object(s) with AIP(s)",
      "curation-task.task.restorekeepexisting.label": "Restore Missing Object(s) but Keep Existing Objects",
      "curation-task.task.restoresinglefromaip.label": "Restore Single Object from AIP",
      "curation-task.task.replacesinglewithaip.label": "Replace Single Object with AIP",


Installation on DSpace 6.x

...