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 fcrepo-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.
Clone the fcrepo-exts/migration-utils and build the latest version of the software.
git clone https://github.com/fcrepo-exts/migration-utils.git cd migration-utils mvn clean install
- 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 Fedora Upgrade Utility.
- 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 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:
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:
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.
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
