Requirements
Ruby 3.2.x and Node.js 20.x are recommended.
Upgrade Steps
For Manual Installations
Install Ruby 3.2.x
Update gems, and migrate DB
bundle install --with production --without development test RAILS_ENV=production bundle exec rake db:migrate
Install node.js 20.x (if needed)
Update JS dependencies
yarn install # in Avalon root dir
Restart passenger (if using)
passenger-config restart-app
For Docker Installations
Note: avalon-docker 7.7.0 switches to a bind mount volume for storing Solr data for safer persistence across upgrades.
Stop Avalon
docker-compose down
Backup solr data using instructions on https://samvera.atlassian.net/wiki/spaces/AVALON/pages/2303328775/Backing+up+and+restoring+supporting+services#Solr
Update new code from avalon-docker
git checkout main git pull sudo chmod a+w solr_data
Pull new images
docker-compose pull avalon solr
Check config changes then restart the Avalon containers
docker-compose up
You can also build your own image, Docker Buildkit is recommended
docker-compose build avalon