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.
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
Start up Fedora on top of your newly minted Fedora 6 OCFL-compliant repository using the -Dfcrepo.home.
java -jar migration-utils-4.4.1-SNAPSHOT-25cdf-driver.jar |
java -jar fcrepo-webapp-6.0.0-SNAPSHOT-jetty-console.jar -Dfcrepo.home=my-fcrepo-6 |
Migrating from Fedora 4 → 6 is slightly more complicated than the 3→ 6 path. In a nutshell , you'll need to do the following:
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:
Below you'll find sample recipes for both migration paths.
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 |
# create your destination directory for the upgrade mkdir my-5.1.1-export # upgrade java -jar target/fcrepo-upgrade-utils-<latest version>.jar -i my-4.7.5-export -o my-5.1.1-export -s 4.7.5 -t 5+ |
# create your destination directory for the upgrade mkdir -p my-fcrepo-6/data java -jar fcrepo-upgrade-utils-<latest-version>.jar -i my-5.1.1-export -o my-fcrepo-6/data -s 5+ -t 6+ -u http://localhost:8080/rest |
java -jar fcrepo-webapp-6.0.0-SNAPSHOT-jetty-console.jar -Dfcrepo.home=my-fcrepo-6 |
Make sure that your Fedora 5 instance is running. Also be sure that you are using v1.0.0 of the import export tool: Then run the following command:
java -jar fcrepo-import-export-1.0.0.jar -b -d my-5.1.1-export -u fedoraAdmin -p fedoraAdmin -m export -r http://localhost:8080/rest |
# create your destination directory for the upgrade mkdir -p my-fcrepo-6/data java -jar fcrepo-upgrade-utils-<latest-version>.jar -i my-5.1.1-export -o my-fcrepo-6/data -s 5+ -t 6+ -u http://localhost:8080/rest |
java -jar fcrepo-webapp-6.0.0-SNAPSHOT-jetty-console.jar -Dfcrepo.home=my-fcrepo-6 |