Fedora Migration Utility Guide

Users migrating from Fedora Release 1.2.1 need to follow the steps outlined in the section entitled, Migrating From Fedora 1.2.1 to Fedora 2.0, and apply patch number 2 to their existing Fedora 1.2.1 repository BEFORE attempting migration to Fedora 2.0. Failure to do so can severely limit future migration options.

If you are running a version of the Fedora software prior to version 1.2.1, you will need to migrate your server software up to version 1.2.1 first, and then proceed with the migration from Fedora 1.2.1 to Fedora 2.0. Steps for migrating to Fedora 1.2.1 can be found in the release notes section for Fedora 1.2.1. This document only address migration from a Fedora 1.2.1 repository to a Fedora 2.0 repository.

2. Migrating From Fedora 1.2.1 to Fedora 2.0

If you are upgrading from Fedora 1.2.1 to Fedora 2.0 follow these steps:

1. Download patch number 2 from http://www.fedora.info/download/1.2.1/patch2.
2. Make sure you are running v1.2.1 of the Fedora server software.

   DO NOT APPLY THIS PATCH TO ANY OTHER VERSION OF FEDORA!

   To check your repository's version, check the "describe" page. For instance, if you're running Fedora on localhost:8080, visit http://localhost:8080/fedora/describe

3. Shut down your Fedora 1.2.1 server (using fedora-stop)
4. Make a backup of the METSLikeExportDOSerializer.class file.

   Under Windows, make a backup of the following file:

   %FEDORA_HOME%\server\tomcat41\webapps\fedora\WEB-INF\classes\fedora\server\storage\translation\METSLikeExportDOSerializer.class
   

   Under Unix, make a backup of the following file:

   $FEDORA_HOME/server/tomcat41/webapps/fedora/WEB-INF/classes/fedora/server/storage/translation/METSLikeExportDOSerializer.class
   

5. Copy the METSLikeExportDOSerializer.class from this patch into the above directory replacing the one there.

   Under Windows, copy the METSLikeExportDOSerializer.class from patch into the following directory

   %FEDORA_HOME%\server\tomcat41\webapps\fedora\WEB-INF\classes\fedora\server\storage\translation 
   

   OVER THE EXISTING FILE.

   Under Unix, copy the METSLikeExportDOSerializer.class from patch into the following directory

   $FEDORA_HOME/server/tomcat41/webapps/fedora/WEB-INF/classes/fedora/server/storage/translation 
   

   OVER THE EXISTING FILE.

6. (OPTIONAL) If you installed the source code distribution of Fedora, you should also copy the included METSLikeExportDOSerializer.java file into your source directory.

   Under Windows, copy the METSLikeExportDOSerializer.java file from the patch into the following directory

   %FEDORA_HOME%\src\java\fedora\server\storage\translation
   

   OVER THE EXISTING FILE.

   Under Unix, copy the METSLikeExportDOSerializer.java file from the patch into the following directory

   $FEDORA_HOME/src/java/fedora/server/storage/translation
   

   OVER THE EXISTING FILE.

7. Re-start your Fedora 1.2.1 server (using fedora-start). Your Fedora 1.2.1 repository is now ready for exporting its objects to the new server.
8. Download the Fedora 2.0 software from http://www.fedora.info/download
9. Install and configure the new Fedora 2.0 repository with a different host and port than the Fedora 1.2.1 server.
10. Start the Fedora 2.0 server (using fedora-start).
11. There are two ways to ingest objects from the 1.2.1 server: 1) use the admin GUI client to ingest the objects from the 1.2.1 repository or 2) use the fedora-ingest command-line utility to ingest the objects from the 1.2.1 repository
    1. Using the admin GUI client to ingest objects from the 1.2.1 repository
       1. Start the fedora admin GUI client (using fedora-admin).
       2. Under the File menu item, select File, Ingest, Object By Type, From Repository.
       3. Specify the hostname and port of the Fedora 1.2.1 server from which you want to ingest objects. Specify the administrator username and password for the 1.2.1 repository.
       4. Select all three object types including Behavior Definition, Behavior Mechanism, and Data object and click OK.
       5. The Fedora 2.0 server will now ingest all objects from the 1.2.1 repository.
       OR
    2. Using the fedora-ingest command-line utility to ingest objects from the 1.2.1 repository.
       1. Run the fedora-ingest command-line utility which is found in the client/bin directory.

          Under Windows, this file is found in:

          %FEDORA_HOME%\client\bin\fedora-ingest.bat
          

          Under Unix, this file is found in:

          $FEDORA_HOME/client/bin/fedora-ingest.sh
          

       2. Arguments for the fedora-ingest utility should include the following:
          • Type of ingest: specify R for repository
          • Hostname and port of the 1.2.1 repository from which you wish to ingest objects: source-host:source-port
          • Administrator username of the 1.2.1 repository: fedoraAdmin
          • Password for the administrator username of the 1.2.1 repository: fedoraAdmin is the default
          • Type of objects to ingest: specify DMO for all three object types.
          • Hostname and port of the 2.0 repository into which you are ingesting the objects: destination-host:destination-port
          • Administrator username of the 2.0 repository: fedoraAdmin
          • Password for the administrator username of the 2.0 repository: fedoraAdmin is the default
          • Log message: use "" for no message.

            For example:

            fedora-ingest r src-host:src-port fedoraAdmin fedoraAdmin DMO dest-host:dest-port fedoraAdmin fedoraAdmin ""
            

12. After successfully ingesting all objects from the 1.2.1 repository, shutdown the 1.2.1 repository (using fedora-stop).
13. If you desire to run the Fedora 2.0 repository under the same hostname and port as the 1.2.1 repository, you can now shutdown the 2.0 repository using fedora-stop, reconfigure the host and port in the fedora.fcfg file for the 2.0 repository to match those of the previous 1.2.1 repository, and restart the Fedora 2.0 repository.