Fedora Repository 3 Documentation
Page not found

Upgrading from 3.4.x to 3.5

Work-in-progress

3.4.x to 3.5 Upgrade Instructions are a work-in-progress.

Version 3.4.2 is a bugfix release and does not require a database or resource index rebuild, nor does it require an upgrade to your configuration. In order to "swap in" the new version of the software, you may:

  1. Shut down your old 3.4.x repository
  2. Install the newer version of Fedora in a different location, but before starting it:
    1. Copy your old server/config/fedora.fcfg file into the new installation's server/config/ directory.
    2. If you were using Akubra in 3.4, copy your old server/config/akubra-llstore.xml file into the new installation's server/config/spring/ directory.
    3. If you are using the legacy llstore implementation instead of Akubra, modify the fedora.fcfg file, ensuring that the object_store_base and datastream_store_base values point to the absolute path of these existing directories. If you'd rather keep the paths relative in the config file, move or copy the content to the matching location in the new installation instead.
    4. If you have previously made changes to the repository-wide XACML policies, copy them into the new repository installation's data/fedora-xacml-policies directory (you will need to create this directory)
  3. Start the new instance of Fedora for the first time.
  4. If you are using FeSL and are using a different policy index configuration to your existing installation (ie you are no longer using DB XML, the only option available for 3.4.x)
    1. Shut down your repository
    2. Run the Policy Index Rebuilder.
    3. Restart your repository

Upgrading from 3.x to 3.5

Akubra low-level storage

As of Fedora 3.4, Akubra is the default low-level storage implementation. Akubra is not backwards-compatible with the datastream and object storage from previous releases, so when upgrading ensure you use the same low-level storage implementation as your existing installation. Your existing install.properties file will specify llstore.type as either legacy-fs or akubra, the same option should be used for your new installation. A migration utility to migrate from legacy low-level storage to Akubra will be provided in a future release.

  1. Shut down your old 3.x repository
  2. Install the newer version of Fedora, but before starting it, modify the new fedora.fcfg so that:
    1. It points to your previous 3.x database
    2. The object and datastream paths point to your previous 3.x locations
    3. Note: Due to the Mulgara version upgrade, if you have enabled the Resource Index previously, it will need to be rebuilt.  Therefore, it is unnecessary to point the resource index configuration to the old location.
  3. If you are using FeSL AuthZ, configure the Policy Index
  4. Start the new repository for the first time.
  5. Shut down the new repository.
  6. If you have previously made changes to the repository-wide XACML policies, copy them into the new repository's XACML directory.
  7. If you previously enabled messaging, and there were messages from your old repository that have not yet been delivered, copy its activemq-data directory over the new activemq-data directory in your new install.
  8. Run the Resource Index Rebuilder.
  9. If you are using FeSL and are using a different policy index configuration to your existing installation, run the Policy Index Rebuilder.
  10. Restart the new repository
#trackbackRdf ($trackbackUtils.getContentIdentifier($page) $page.title $trackbackUtils.getPingUrl($page))
  • No labels