Custom Fedora 3.x - Install Migration Tool

For current Fedora 3.x installations, follow these instructions to install the appropriate migration tools.

Objectives

• Based on current state of metadata, determine the necessity and extensiveness of metadata remediation
• If remediation is needed, document the goal, the scope of work, decision making process, and timeline in the Metadata Remediation Project Plan
• Reach the stated goal for metadata before migration

Suggested Collaborators

• Project Lead
• Technical Lead
• Developers
• Functional Specialists, i.e. metadata librarians, digital preservation teams etc.
• SME on data and data migration

• IT Department for security and access requirements

Instructions

Fedora 6.x

1. Fedora 6.x can be installed in a number of ways, including local and cloud-based deployments. For step-by-step instructions, please see the Deployment Guide.
   
   
2. Before you begin your migration, test the performance and scale of your Fedora 6.x instance to ensure it meets your needs.
   
   Review the Fedora 6 testing page for a variety of tools, documentation, and instructions. The JMeter tests will likely be the most relevant in terms of scale testing, and a metrics dashboard can also be configured to capture a variety of performance metrics.

Tool 1: migration-utils

Migration-utils is a Java command-line tool for migrating from Fedora 3.x to Fedora 6.0, either plain OCFL or Fedora OCFL.

1. Review the latest updates on this tool on this Github page, where you can learn more on how to use it, available Command Line Interface (CLI) options, and property mappings.

   Note

   This tool does not currently support remapping metadata; it will simply copy the XML metadata files into the new Fedora 6.0 Oxford Common File Layout (OCFL) structure. 

2. Watch this demo on how to run the utility tool:
   
   
   
3. Download the migration-utils JAR file on GitHub.
   
   

4. To verify that the JAR file you downloaded is correct, run a checksum on the file to compare against the published md5 or sha1 checksums provided on the Fedora Github repo.
   Example command lines:
   
   

   md5sum fcrepo-migration-utils-VERSION-driver.jar
   sha1sum fcrepo-migration-utils-VERSION-driver.jar
   	Where VERSION = the current version release

5. To verify that the utility works, ensure you are using the latest release version and run the following command in a Command Line Interface (CLI): 
   
   

   java -jar fcrepo-migration-utils-[INSERT CURRENT RELEASE VERSION HERE]-driver.jar

   If the utility works, it should print the CLI options to your screen.

Tool 2: fcrepo-migration-validator

fcrepo-migration-validator is a Java command-line tool for comparing and validating migrations of Fedora 3.x content with source material.

1. Read about the validations that the tool is capable of performing on this wiki page.
   
   

2. Review the latest updates on this tool on this GitHub page, where you can also find requirements and CLI options.
   
   

3. Watch this demo on how to run the validator tool:
   
   
   
4. Download the fcrepo-migration-validator JAR file on this GitHub page.
   
   
5. To verify the utility works and ensuring you are using the most current release, run the following command in a Command Line Interface:
   

   java -jar fcrepo-migration-utils-[INSERT CURRENT RELEASE VERSION HERE]-driver.jar

   If the utility works, it should print the CLI options to your screen.

Next Steps:

Before the actual migration, it is highly recommended to conduct a practice run with a sample of your data to help identify and resolve potential issues with the data or with configurations. 

Related articles