Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: added note about updating XAXCML algorithm jars

...

Upgrading from 3.x to 3.8

Warning
titleDeprecated Sun XACML libraries

As of Fedora 3.8.0, the private Sun XACML libraries have been removed, and replaced by the public JBOSS Sun XACML libraries.  If you are migrating from an older version of Fedora, you'll need to change the XACML-COMBINING-ALGORITHM parameter in your fedora.fcfg file:

Change

Code Block
languagexml
titleOld XACML-COMBINING-ALGORITHM
<param name="XACML-COMBINING-ALGORITHM" value="com.sun.xacml.combine.OrderedDenyOverridesPolicyAlg"/>

to

Code Block
languagexml
titleNew XACML-COMBINING-ALGORITHM
<param name="XACML-COMBINING-ALGORITHM" value="org.jboss.security.xacml.sunxacml.combine.OrderedDenyOverridesPolicyAlg"/>
Warning
titleAkubra 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 limited migration utility to migrate from legacy low-level storage to Akubra can be built from source available at https://github.com/fcrepo/fcrepo-store .

  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.
    4. If you were using Akubra in 3.5, copy your old server/config/akubra-llstore.xml file into the new installation's server/config/spring/ directory.
    5. Update the XACML-COMBINING-ALGORITHM parameter, if migrating from a pre-3.8.x version of Fedora
  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