Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Anchor
configchanges
configchanges
Config changes

...

No changes to settings.yml

Solr 8 config files are now provided at solr/conf for experimentation with upgrading and is the default in the docker-compose development environment.  Upgrade tooling and documentation for production environments will be available in a future avalon release.  Solr 6 config files are still available at solr/config.

Rails/Blacklight/Bootstrap Upgrades and Styling

This release of Avalon includes upgrades of Rails (5.2 → 6.0), Blacklight (6 → 7), and Bootstrap (3 → 4) which require special attention if your avalon has been customized.

Rails

One of the major changes in Rails is the use of zeitwerk as the code loader.  Zeitwerk will warn if any unsafe loading happens in initializers.  The solution to this problem is usually to wrap any code which autoloads classes in a Rails.application.config.to_prepare block.  For examples see https://github.com/avalonmediasystem/avalon/pull/4657.

Blacklight

Blacklight 7 changes include the upgrade of bootstrap to 4, changes to search builders, and switching the /catalog json endpoints to return standard JSON-API.  If you have customized the CatalogController, any of the search builders, or any of the catalog views, you may need to make changes to ensure compatibility.  See the Blacklight 7 release notes for more details: https://github.com/projectblacklight/blacklight/releases/tag/v7.0.0

Bootstrap

If you have overridden or custom views you will probably need to adjust the CSS styling for bootstrap 4.  Blacklight has a bootstrap upgrade guide available.

Upgrade Steps

For Manual Installations

...

Code Block
languagebash
docker-compose build avalon

Rails/Bootstrap/Blacklight Upgrades and Styling

...