Current Release

This documentation covers the current version of Fedora. Looking for another version? See all documentation.

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 25 Next »

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→ 6 Migration Path

Overview

To walk this migration path you 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 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 conforms to the Oxford Common File Layout (OCFL) specification.  Once your Fedora 3 repository has been migrated to Fedora 6, you must start up an instance of Fedora 6 on top of the newly 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.

  1. Download the latest version of the  migration-utils utility: https://github.com/fcrepo-exts/migration-utils/releases

  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 created Fedora 6 OCFL-compliant repository using the -Dfcrepo.home configuration property.

Below you will find an example migration.  Please refer to the migration-utils README for a full discussion of the available options.

A Sample Migration From 3→6

Step 1: Run  fcrepo-migration-utils

java -jar migration-utils-6.0.0-alpha-1-driver.jar --source-type=legacy --limit=100 --target-dir=my-fcrepo-6/data --objects-dir=<path to objects dir> --datastreams-dir=<path to datastreams dir>

Step 2: Start up Fedora 6

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

The Fedora 4 →  6 Migration Path

Overview

Migrating from Fedora 4 → 6 is slightly more complicated than the 3→ 6  path.   In a nutshell , you will need to do the following:

  1. Export your Fedora 4.7.5 repository to disk using the Fedora Import ExportTool (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 6 pointing to the newly created OCFL in the previous step.

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 (swapping in appropriate local values):

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:

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+

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: Start up Fedora 6

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 will follow a similar process to the previous section, however note that you will use a different version of the import export tool to export your F5 repository and you will perform only one upgrade. In other words, here are the steps:

  1. Export your Fedora 5.1.1 repository to disk using the Fedora 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.

Below you will find a sample recipes for this migration path.

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 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 using latest version of fcrepo-upgrade-utils:

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 -Dfcrepo.home=my-fcrepo-6 -jar fcrepo-webapp-<latest fedora 6 version>-jetty-console.jar --headless



  • No labels

All content on the LYRASIS Wiki is licensed under the CC BY (Attribution) license, unless otherwise noted.