Rcaap Artefact Extractor

Rcaap is a web portal that gathers information from several Dspace active instances. By periodically indexing each Dspace's documents, the Portal provides a search engine that integrates thousands of Scientific papers, doctoral thesis and other document types from the institutions' own repositories.

How to get the code

git clone https://opensourceprojects.eu/git/p/timbus/context-population/extractors/rcaap-artefact-extractor

Install Requirements

1. Oracle Java JDK 1.7
2. Apache Maven installed

Requirements for the extraction target

1. Linux installed
2. An instance of RCAAP installed
3. SSH server running with authenticated user

How to install

This project, like most others in Timbus, is built through Maven. All that is required to build the entire project is to run the following command on the root project folder:

1

$> mvn clean package

This will create a target folder in which it saves two different .jar files - The cli module, which is used to run locally on the machine and the bundle module. which is to be deployed into Virgo Container.
A tutorial on how to properly install Virgo and deploy Timbus artefacts into it can be found here

Collected Information

This extractor accesses the target machine through SSH and crawls the RCAAP Portal's directories for possibly customized files. These files can contain extra configuration information, new html pages and jsp, or even new scripts.
It then creates a JSON object with all the found files and corresponding system path for future preservation.

Example output:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27

{
 "extractor": "rcaap-artefact-extractor",
 "format": {
  "id": "ea6f170e-5d74-40ae-bb02-53b07d84b9ac",
  "multiple": false
 },
 "uuid": "1a92b90b-814f-11e4-a03e-db083d9c644c",
 "result": {
  "machineId": "xri://+machine?+hostid=007f0100/+hostname=timbus.rcaap.pt",
  "fqdn": "134.191.240.69",
  "port": 10022,
  "data": {
   "dependencies": {
        "harvest.jar": "/metarepository/bin/harvest.jar",
        "log4j.xml": "/metarepository/config/log4j.xml",
        "metarepository.config": "/metarepository/config/metarepository.config",
        "BibTeX": "/metarepository/config/templates/BibTeX",
        "COinS": "/metarepository/config/templates/COinS",
        "RIS": "/metarepository/config/templates/RIS",
        "validation-report-template.html": "/metarepository/config/templates/validation-report-template.html",
        "validation-report-template.txt": "/metarepository/config/templates/validation-report-template.txt",
        "CqlToSolr.properties": "/metarepository/config/CqlToSolr.properties",
        "CqlToSQL.properties": "/metarepository/config/CqlToSQL.properties",
        "degois.map": "/metarepository/config/degois.map",
        "doctypes.list": "/metarepository/config/doctypes.list",

    ... ... ...

TIMBUS Use Cases

RCAAP digital preservation UC

This use case consists on an open digital repository platform that combines most of Portugal's most relevant scientific digital repositories.
It is a centralized platform that allows searching among all the repositories in a seamlessly way.
As each repository is a single Dspace instance, the Dspace AIP extractor is used to perform individual backups of all instances and search for possibly customized files to, later on, be preserved.

Author

Miguel Gama Nunes miguel.nunes@caixamagica.pt

License

Copyright (c) 2014, Caixa Magica Software Lda (CMS).
The work has been developed in the TIMBUS Project and the above-mentioned are Members of the TIMBUS Consortium.
TIMBUS is supported by the European Union under the 7th Framework Programme for research and technological development and demonstration activities (FP7/2007-2013) under grant agreement no. 269940.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at: http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTIBITLY, or FITNESS FOR A PARTICULAR PURPOSE. In no event and under no legal theory, whether in tort (including negligence), contract, or otherwise, unless required by applicable law or agreed to in writing, shall any Contributor be liable for damages, including any direct, indirect, special, incidental, or consequential damages of any character arising as a result of this License or out of the use or inability to use the Work.
See the License for the specific language governing permissions and limitation under the License.