Page History

...

1. Download the migration-utils utility: migration-utils-4.4.1-SNAPSHOT-25cdf-driver.jar

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.   

A Sample Migration From 3→6

Step 1: Run  fcrepo-migration-utils

java -jar migration-utils-4.4.1-SNAPSHOT-25cdf-driver.jar

Step 2: Fire up Fedora 6

java -jar fcrepo-webapp-6.0.0-SNAPSHOT-jetty-console.jar -Dfcrepo.home=my-fcrepo-6 

The Fedora 4 → 5 →  6 Migration Path

...

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 the latest release of . 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 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:

1. Export your Fedora 5.1.1 repository to disk using theFedora Import Export Tool (v1.0.0)
2. Upgrade the Fedora 5.1.1 export to Fedora 6 compliant OCFL  using the latest release of the  Fedora Upgrade Utility
3. Start up your Fedora pointing to the newly created OCFL in the previous step.

There are key differences.  First of all Below 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.find sample recipes for both migration paths.

A Sample Migration From

...

Step 1: Run  fcrepo-migration-utils

Step 2: Fire up Fedora 6

...

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<latest version>.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-<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: Fire up Fedora 6

java -jar fcrepo-webapp-6.0.0-SNAPSHOT-jetty-console.jar -Dfcrepo.home=my-fcrepo-6 

A Sample Migration From 5→6

Step 1: Export from 51.1

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

Step 2: 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-<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

java -jar fcrepo-webapp-6.0.0-SNAPSHOT-jetty-console.jar -Dfcrepo.home=my-fcrepo-6 

...