This page is a work in progress.
Requirements
Ruby 3.2.x and Node.js 20.x are recommended.
Config changes
and configured in settings.yml
app_controller: solr_and_fedora: raise_on_connection_error: false app_job: solr_and_fedora: raise_on_connection_error: true
Derivative download
derivative: # Choose whether collection managers and admins can download high quality derivatives allow_download: true
Maximum upload size
# Maximum size for uploaded files in bytes (default is disabled) #max_upload_size: 2147483648 # Use :none or comment out to disable limit
Troubleshooting
Before starting the upgrade there are some steps to keep a close eye on when running.
SupplementalFile Migration
MediaObject Section List Migration
Upgrade Steps
For Manual Installations
Install ruby 3.2.x (if needed)
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
Update configuration, see Config changes above
Restart passenger (if using)
passenger-config restart-app
Run rake migrations
RAILS_ENV=production bundle exec rake avalon:migrate:backfill_parent_id RAILS_ENV=production bundle exec rake avalon:migrate:media_object_section_list
For Docker Installations
Stop Avalon
docker-compose down
Update new code from avalon-docker
git checkout main git pull
Pull new images
docker-compose pull avalon solr
Check config changes then restart the Avalon containers
docker-compose up
Run rake migrations (inside avalon container)
RAILS_ENV=production bundle exec rake avalon:migrate:backfill_parent_id RAILS_ENV=production bundle exec rake avalon:migrate:media_object_section_list
You can also build your own image, Docker Buildkit is recommended
docker-compose build avalon