Upgrade and Migration Guide

Current Maintenance Version
Fedora Repository 2.2.4 — see the Fedora 2.2.4 Release Notes

Upgrading from Fedora 2.2.x to Fedora 2.2.4

Shut down your old repository
Install Fedora 2.2.4, but before starting it, modify the new fedora.fcfg so that:
1. It points to your previous database
2. The object and datastream paths point to the previous locations
3. Note: Due the the upgrade from Kowari to Mulgara, if you had previously enabled the Resource Index, it will need to be rebuilt. Therefore, it is unnecessary to point the Resource Index configuration to the old location.
Start the 2.2.4 repository for the first time.
Shut down the 2.2.4 repository.
If you had previously made changes to the repository-wide XACML policies, copy them into the new repository's XACML policy directory.
Run the Resource Index Rebuilder utility.
Restart the 2.2.4 repository.

Upgrading from Fedora 2.2.2 to Fedora 2.2.3

We have developed a utility to make this process as quick as possible.

Stop the webapp container in which Fedora is running.
Download fedora-2.2.3-upgrade.jar and run it with the command: java -jar fedora-2.2.3-upgrade.jar

Restart the webapp container.

Information

One of the changes with Fedora 2.2.3 was to update the bundled Tomcat instance to version 5.5.26, due to a shutdown bug with Tomcat. The simple process above will not automatically make this change to your existing installation. It is not required, but if you would like to upgrade to Tomcat 5.5.26, we recommend performing a full install of Fedora 2.2.3 instead.
This process does not update the FEDORA_HOME/client/fedora-client.jar file. The only change in this file with 2.2.3 was to update the compatibility information so that the Administrative GUI would work with 2.2.3. If you use this utility, you will need to download fedora-2.2.3-installer.jar and run it with the command: java -jar fedora-2.2.3-installer.jar. Then, choose a "client" install. Other programs that use this jar file do not need to be updated.

Upgrading from Fedora 2.2.1 to Fedora 2.2.3

Follow the instructions for upgrading from 2.2.2 above, but prior to step 2:

Download fedora-2.2.2-upgrade.jar and run it with the command: java -jar fedora-2.2.2-upgrade.jar

Upgrading from Fedora 2.2 to Fedora 2.2.3

Follow the instructions for upgrading from 2.2.2 above, but prior to step 2:

Download fedora-2.2.1-upgrade.jar and run it with the command: java -jar fedora-2.2.1-upgrade.jar

Download fedora-2.2.2-upgrade.jar and run it with the command: java -jar fedora-2.2.2-upgrade.jar

Warning
The following upgrade instructions are included for completeness. It is highly recommended that you use the instructions provided above to upgrade to Fedora 2.2.3 due to the security issues documented in the Fedora 2.2.3 Release Notes.

Upgrading from Fedora 2.2.1 to Fedora 2.2.2

We have developed a utility to make this process as quick as possible.

Download fedora-2.2.2-upgrade.jar from Sourceforge.
Stop the webapp container in which Fedora is running.
Run the upgrade utility: java -jar fedora-2.2.2-upgrade.jar and follow the prompts.
Restart the webapp container.

NOTE: Although the Fedora Administrator Java application will be upgraded as part of this process, existing tools and services that use fedora-client.jar version 2.2.1 do not need the updated version of this library in order to continue working properly with your upgraded server.

Upgrading from Fedora 2.2 to Fedora 2.2.2

For this upgrade, you will need to download and run two separate upgrade utilities, as follows:

Download fedora-2.2.1-upgrade.jar from Sourceforge.
Download fedora-2.2.2-upgrade.jar from Sourceforge.
Stop the webapp container in which Fedora is running.
Run the first upgrade utility: java -jar fedora-2.2.1-upgrade.jar and follow the prompts.
Run the second upgrade utility: java -jar fedora-2.2.2-upgrade.jar and follow the prompts.
Restart the webapp container.

NOTE: Although the Fedora Administrator Java application will be upgraded as part of this process, existing tools and services that use fedora-client.jar version 2.2 or 2.2.1 do not need the updated version of this library in order to continue working properly with your upgraded server.

Upgrading from Fedora 2.1.1 to Fedora 2.2.2

Upgrading from Fedora 2.1.1 to Fedora 2.2.2 does not require migration of objects or rebuilding of the Resource Index. However, there are important changes to the packaging and configuration between 2.1.1 and 2.2.2. Notably, neither the Fedora Configuration File (fedora.fcfg) nor Fedora Web Deployment Descriptor (web.xml) are compatible with Fedora 2.2.2.

Backup - It is highly recommended you backup your existing Fedora repository.
Use your database's administrative tool or SQL command line utility to rename the "do" table to "dobj". This is normally done via the SQL command: ALTER TABLE do RENAME TO dobj
Install Fedora 2.2.1 Review the Installation and Configuration Guide. Note the following critical steps of the installation process:
1. When prompted for the installation type, select "custom".
2. When prompted for the Fedora home directory, DO NOT select the Fedora home directory of your previous installation: select a new directory.
3. When prompted for the Servlet engine, if you select an existing Tomcat installation, DO NOT select the servlet container of your previous Fedora installation.If you select an existing servlet container, please make sure it is not running (or, ensure that it is not configured to automatically deploy web applications).
4. When prompted for the Database, select the database (i.e., mysql, oracle, etc.) you used with your previous installation of Fedora.Use the same database username, password, JDBC url, and Driver Class used in the previous Fedora installation (refer to your old fedora.fcfg if needed).
Post install, edit your new Fedora Configuration File ($FEDORA_HOME/server/config/fedora.fcfg). Copy the following parameter values from your old fedora.fcfg to your new fedora.fcfg:
1. module.fedora.server.storage.lowlevel.ILowlevelStorage.object_store_base
2. module.fedora.server.storage.lowlevel.ILowlevelStorage.datastream_store_base
3. module.fedora.server.resourceIndex.ResourceIndex.level
4. datastore.localKowariTriplestore.pathIf you made any customizations to your previous fedora.fcfg, you may apply them now.

Upgrading From Fedora 2.1 to Fedora 2.2.2

Follow the same steps as above for upgrading from 2.1.1.

Upgrading From Fedora 2.0 to Fedora 2.2.2

When moving from Fedora 2.0 to Fedora 2.2.1, you will be able to do a simple software upgrade without having to migrate digital objects via a mass export and ingest. After installing Fedora 2.2.2, you can configure it to point to your existing repository datastores (both the existing repository directory storage locations and the existing relational database). This involves changing parameters in the Fedora 2.2.2 server configuration file (fedora.fcfg) that define the storage directory paths and database location.

Note that the Resource Index model changed between 2.0 and 2.1, hence a rebuild of the Resource Index is necessary if upgrading from 2.0 to 2.2.2. See the instructions for rebuilding the Resource Index.

Upgrading from versions prior to 2.0

To upgrade from a Fedora version prior to 2.0, you must first migrate to version 2.0, then follow the appropriate upgrade steps above.