We are currently supporting migration to Fedora 6 from Fedora 3, 4.7.5 and 5.1.1. This document describes the migration process for each of these pathways.
The Fedora 3→ Fedora 6 Migration Path
Overview
To walk this migration path you'll need to download and run the migration-utils tool directly against the on-disk representation of your Fedora 3 repository. In other words it is not necessary to export your Fedora 3 repository. The fcrepo-migration-utils will not make any changes to your Fedora 3 repository so it is not necessary to make a backup before starting. You'll need to make sure that you have sufficient storage space available in the target directory as the migration will effectively create a copy of your Fedora 3 repository in the Fedora 6 format which happens to conform to the Oxford Common File Layout (OCFL) specification. Once your Fedora 3 repository has been migrated to Fedora 6, you must fire up Fedora 6 on top of the newly minted OCFL. As Fedora 6 starts up it will automatically rebuild internal indices by scanning the OCFL. This index initialization can take a few seconds or several hours depending on the size of your repository.
Download the migration-utils utility: migration-utils-4.4.1-SNAPSHOT-25cdf-driver.jar
- Follow the instructions in the migration-utils README: https://github.com/fcrepo-exts/migration-utils
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:
- Export your Fedora 4.7.5 repository to disk using the Fedora Import Export Tool (v0.3.0)
- Upgrade your Fedora 4.7.5 export to a Fedora 5.1.1 export using the latest release of .
- 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.
- Start up your Fedora pointing to the newly created OCFL in the previous step.
For migrating from Fedora 5.1.1 you'll follow a similar process however note that you'll use a different version of the import export tool to export your F5 repository and you'll perform only one upgrade. In other words, here are the steps:
- Export your Fedora 5.1.1 repository to disk using theFedora Import Export Tool (v1.0.0)
- Upgrade the Fedora 5.1.1 export to Fedora 6 compliant OCFL using the latest release of the Fedora Upgrade Utility
- Start up your Fedora pointing to the newly created OCFL in the previous step.
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.
A Sample Migration From 3→6
Step 1: Run fcrepo-migration-utils
Step 2: Fire up Fedora 6
A Sample Migration From 4→6
Step 1: Export from 4.7.5
Make sure that your Fedora 4.7.5 instance is running. Also be sure that you are using v0.3.0 of the import export tool: ie fcrepo-import-export-0.3.0.jar! Then run the following command:
java -jar fcrepo-import-export-0.3.0.jar -b -d my-4.7.5-export -u fedoraAdmin -p fedoraAdmin -m export -r http://localhost:8080/rest
Step 2: Upgrade exported 4.7.5 to 5.1.1 export
# create your destination directory for the upgrade mkdir my-5.1.1-export # upgrade java -jar target/fcrepo-upgrade-utils-6.0.0-SNAPSHOT.jar -i my-4.7.5-export -o my-5.1.1-export -s 4.7.5 -t 5+
Step 3: Upgrade 5.1.1 export to Fedora 6 compliant OCFL
# create your destination directory for the upgrade mkdir -p my-fcrepo-6/data java -jar fcrepo-upgrade-utils-6.0.0-SNAPSHOT.jar -i my-5.1.1-export -o my-fcrepo-6/data -s 5+ -t 6+ -u http://localhost:8080/rest
Step 4: Fire up Fedora 6
java -jar fcrepo-webapp-6.0.0-SNAPSHOT-jetty-console.jar -Dfcrepo.home=my-fcrepo-6
