Versions Compared

Key

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

...

  1. Clone the fcrepo-exts/migration-utils and build the latest version of the software.

    Code Block
    git clone https://github.com/fcrepo-exts/migration-utils.git
    cd migration-utils
    mvn clean install 


  2.  Follow the instructions in the migration-utils README: https://github.com/fcrepo-exts/migration-utils
  3. Start up Fedora on top of your newly minted Fedora 6 OCFL-compliant repository using the -Dfcrepo.home.   


The Fedora 4 → 5 →  6 Migration Path

Overview

Migrating from Fedora 4 → 6 is slightly more complicated than the 3→ 6  path.   In a nutshell , you'll need to do the following:

  1. Export your Fedora 4.7.5 repository to disk using the Fedora Import Export Tool (v0.3.0)
  2. Upgrade your Fedora 4.7.5 export to a Fedora 5.1.1 export using Fedora Upgrade Utility.
  3. Upgrade the Fedora 5.1.1 export to Fedora 6 compliant OCFL using the same utility except this time using the output of the previous step as the input for this task and adjusting the source and target parameters accordingly.
  4. Start up your Fedora pointing to the newly created OCFL in the previous step.

For migrating from Fedora 5.1.1 you'll perform similar steps.  There are key differences.  First of all you'll want to use the 0.4.0-SNAPSHOT version of the Fedora Import Export Tool. Until v0.4.0 is officially released you'll need to build the main branch of fcrepo-import-export.  Once you've built that tool, you'll want to use it to export your Fedora 5.1.1 repository to disk.  Then you may proceed to perform steps 3-4.

Getting the tools

First download Fedora Import Export Tool (v0.3.0).

Next build the 0.4.0-SNAPSHOT version of the same tool:

Code Block
git clone https://github.com/fcrepo-exts/fcrepo-import-export.git
cd fcrepo-import-export
mvn clean install 

This operation will produce fcrepo-import-export-0.4.0-SNAPSHOT.jar in the target directory.

Finally build the fcrepo-upgrade-utils too:

Code Block
git clone https://github.com/fcrepo-exts/fcrepo-upgrade-utils.git
cd fcrepo-upgrade-utils
git checkout 4.7-5.x
mvn clean install 

Note:  at the time of this writing, the 4.7-5.x branch contains all code required to upgrade from 4.7.5→5.1.1 as well as 5.1.1→ 6.0.0. Shortly this branch will be merged into the main branch and a release will be cut.  If you find that the 4.7-5.x branch doesn't exist, go ahead and build from main.