Page tree
Skip to end of metadata
Go to start of metadata

The Fedora 3 to 6 migration-utils application can be used for migrating Fedora 3 objects into OCFL over which Fedora 6 can be layered. Migration tests will serve multiple purposes:

  1. Verify that Fedora 3 repositories can successfully be migrated into OCFL
  2. Verify that the OCFL produced by the migration is valid per the OCFL specification
  3. Collect data points for how long Fedora 3 to OCFL migrations should be expected to take
  4. Collect data points for how long Fedora 6 rebuilds over the produced OCFL should be expected to take


In order to run a migration, the primary requirement is that you have the objects and datastreams of a Fedora 3 repository. Migration-utils supports source Fedora 3 content in any of the standard formats: akubra, legacy, and exported.

  1. Download and run the migration-utils tooling
    1. Given the diversity of Fedora 3 repositories, the most complete documentation for running a migration can be found in the project's README.
    2. The result of the migration will be an OCFL storage root, populated with the data of the source Fedora 3 repository.
    3. For example

      migration-utils-4.4.1-SNAPSHOT-driver.jar -t akubra -d /tmp/fedora/2020/f6-pilots/datastreams/ -o /tmp/fedora/2020/f6-pilots/objects/ -l 10 -a /tmp/f6/ocfl
  2. Document the server machine specs
    1. Determining Hardware Properties
  3. Document the characteristics of the source repository and the time for migration
    1. Template needed
    2. How many source objects
    3. How many source GB/TB/PB
    4. How long did the migration take to complete
  4. Validate the OCFL produced by the migration
    1. See: Test Guide - Python OCFL Validator
  5. Download / Install Fedora 6
    1. Deploying Fedora - Complete Guide
    2. Ensure that the installation fcrepo.ocfl.root system property points to the OCFL storage root produced during the migration
  6. Document the time for Fedora 6 to rebuild
    1. Template needed
  • No labels