RODA is a complete digital repository that delivers functionality for all the main units of the OAIS reference model. RODA is capable of ingesting, managing and providing access to the various types of digital objects produced by large corporations or public bodies. RODA is based on open-source technologies and is supported by existing standards…
Switch branches/tags
Nothing to show
Clone or download
Pull request Compare This branch is 1453 commits behind keeps:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.tx
code-style
doc/images
repository/org
roda-cas
roda-common
roda-core
roda-ui
.gitignore
.travis.yml
CHANGELOG.txt
DEV_NOTES.txt
INSTALL.md
LICENSE.txt
LICENSE_HEADER.txt
README.md
pom.xml

README.md

RODA 2.0 - Repository of Authentic Digital Objects

What is RODA?

RODA is a complete digital repository that delivers functionality for all the main units of the OAIS reference model. RODA is capable of ingesting, managing and providing access to the various types of digital objects produced by large corporations or public bodies. RODA is based on open-source technologies and is supported by existing standards such as the OAIS, METS, EAD and PREMIS.

Some technical information about RODA

  • Uses native file system or Fedora 4 for digital object storage
  • Uses any XML format as descriptive metadata
  • Uses PREMIS for preservation metadata
  • Has a configurable multi-step ingestion workflow
  • Supports LDAP and CAS for authentication & authorization
  • Supports pluggable preservation actions
  • Has a user friendly graphical user interface based on GWT

For more information, please fell free to visit RODA website: http://www.roda-community.org

Install and run

Demo mode (based on docker containers)

Windows and MacOS X

The RODA docker container cannot currently be used in Windows due to filename incompatibilities.

Linux

On Linux, use the following instructions:

  1. Install docker for your system: https://docs.docker.com/engine/installation/
  2. Pull or update to the latest roda container, on the command line run: sudo docker pull keeps/roda
  3. Run the container: sudo docker run -p 8080:8080 -v ~/.roda:/root/.roda keeps/roda
  4. Access RODA on your browser: http://localhost:8080

NOTE: the docker commands only need sudo if your user does not belong to the docker group.

To start as a service you can install supervisord and create the file /etc/supervisor/conf.d/roda.conf with:

[program:roda]
command=docker run -p 8080:8080 -v /home/roda/:/root/.roda keeps/roda
directory=/tmp/
autostart=true
autorestart=true
startretries=3
stderr_logfile=/var/log/supervisor/roda.err.log
stdout_logfile=/var/log/supervisor/roda.out.log
user=roda
  1. Create user 'roda': sudo adduser roda
  2. Add user 'roda' to 'docker' group: sudo usermod -aG docker roda
  3. Then restart supervisord (sudo service supervisord restart)

Production mode

To install RODA from base, i.e. without containers, see the base install instructions.

Quick start

Please log in with the following credentials:

  • Username: admin
  • Password: roda

With this you will have access to all features.

Then you can start using RODA:

  1. Go to Catalogue and click the button NEW, select Dublin Core and fill the title of your new collection.
  2. Go to Ingest > Transfer and upload files (e.g. PDF) or SIPs made by RODA-in. SIPs will have metadata while PDFs wont. To know how to use RODA-in watch the tutorials.
  3. After upload, select the SIPs or files to ingest on the checkbox and click the button PROCESS on the sidebar under the section Ingest.
  4. Now configure the ingest workflow, select the SIP format, if you upload a file select Uploaded file/folder, if you uploaded a SIP select the SIP format (E-ARK or Bagit).
  5. Under the Parent Object you can select the new collection you created above.
  6. After configuring ingest click the CREATE button.
  7. Now ingest will start and you can see the status of it at Ingest > Process, you can also inspect the status by clicking the table row.
  8. When finished you can go to Catalogue or Search to find your new ingested content.

Developers

To start developing for RODA check the Developer guide which has information on:

  1. How to get the source code
  2. How the code is laid out
  3. How to set up the development environment
  4. How to contribute

Translations are not maintained by Transifex and updated using the Transifex Client. After installing the client and setting up your ~/.transifexrc use tx push -s to when you have new source translations to push to server, and tx pull -a to update the translation on your local installation.

Build Status