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.
Table of Contents |
---|
The Fedora 3→
...
6 Migration Path
Overview
To walk this migration path you 'll will 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 will 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 conforms to the Oxford Common File Layout (OCFL) specification. Once your Fedora 3 repository has been migrated to Fedora 6, you must fire start up an instance of Fedora 6 on top of the newly minted created 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 created Fedora 6 OCFL-compliant repository using the -Dfcrepo.home configuration property.
Below you 'll will find an example migration. Please refer to the migration-utils README for a full discussion of the available options.
...
Code Block |
---|
java -jar migration-utils-4.4.1-SNAPSHOT-25cdf-driver.jar --source-type=legacy --limit=100 --target-dir=my-fcrepo-6 --objects-dir=<path to objects dir> --datastreams-dir=<path to datastreams dir> |
Step 2:
...
Start up Fedora 6
Code Block |
---|
java -Dfcrepo.home=my-fcrepo-6 -jar fcrepo-webapp-6.0.0-SNAPSHOT-jetty-console.jar --headless |
The Fedora 4 → 6 Migration Path
...
Migrating from Fedora 4 → 6 is slightly more complicated than the 3→ 6 path. In a nutshell , you 'll will need to do the following:
- Export your Fedora 4.7.5 repository to disk using the Fedora Import ExportTool (v0.3.0)
- Upgrade your Fedora 4.7.5 export to a Fedora 5.1.1 export using the latest release of 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 6 pointing to the newly created OCFL in the previous step.
...
Make sure that your Fedora 4.7.5 instance is running. Also be sure that you are using using v0.3.0 0 of the import export tool: ie ie fcrepo-import-export-0.3.0.jar! Then run the following command (swapping in appropriate local values):
Code Block |
---|
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 using latest version of fcrepo-upgrade-utils:
Code Block |
---|
java -jar fcrepo-upgrade-utils-<latest version>.jar -i my-4.7.5-export -o my-5.1.1-export -s 4.7.5 -t 5+ |
...
Code Block |
---|
# 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 |
Step 4:
...
Start up Fedora 6
Code Block |
---|
java -Dfcrepo.home=my-fcrepo-6 -jar fcrepo-webapp-6.0.0-SNAPSHOT-jetty-console.jar --headless |
The Fedora 5 → 6 Migration Path
Overview
For migrating from Fedora 5.1.1 you 'll will follow a similar process to the previous section, however note that you 'll will use a different version of the import export tool to export your F5 repository and you 'll will perform only one upgrade. In other words, here are the steps:
- Export your Fedora 5.1.1 repository to disk using the Fedora Import Export Tool v1.0.0.
- Upgrade the Fedora 5.1.1 export to Fedora 6 compliant OCFL OCFL using the latest release of the Fedora Upgrade Utility
- Start up your Fedora pointing to the newly created OCFL in the previous step.
Below you 'll will find a sample recipes for both this migration pathspath.
A Sample Migration From 5→6
Step 1: Export from
...
5.1.1
Make sure that your Fedora 5 instance is running. Also be sure that you are using using v1.0.0 0 of the import export tool: . Then run the following command:
...
Step 2: Upgrade 5.1.1 export to Fedora 6 compliant OCFL using latest version of fcrepo-upgrade-utils:
Code Block |
---|
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 |
Step 3: Fire up Fedora 6
Code Block |
---|
java -Dfcrepo.home=my-fcrepo-6 -jar fcrepo-webapp-6.0.0-SNAPSHOT-jetty-console.jar --headless |