This documentation is a work in progress and will be completed before the public 7.1 release.
See the Avalon 7.1 release notes[link] for more information.
Requirements
Avalon 7.1 and above requires Ruby 2.5 or newer. If you're using RVM, simply run
rvm list # Get current ruby version, eg 2.2.1 rvm upgrade 2.2.1 2.5.5 # Installs Ruby 2.5.5 and migrate gemsets, wrappers, aliases and environment files
Config changes
Old setting | New setting | Note |
---|---|---|
|
| More information |
| Choose which collections to display in the featured and carousel portions of the new homepage. |
Upgrade Steps
For Manual Installations
- Download and deploy new code from the avalon repository.
- Install bundler 2, update gems, and migrate DB
gem install bundler -v 2.0.2 bundle install --with production --without development test RAILS_ENV=production bundle exec rake db:migrate
3. Update JS dependencies
yarn install # in Avalon root dir
4. Update configuration, see Config changes above
5. Restart passenger (if using)
passenger-config restart-app
6. Replace Resque with Sidekiq (background jobs processor). Look at our Manual Instructions for more details.
pkill -f resque RAILS_ENV=production bundle exec sidekiq -d -C config/sidekiq.yml
7. Upgrade mediainfo
sudo yum remove libmediainfo0-0.7.61-1.x86_64 libzen0-0.4.28-1.x86_64 sudo yum remove mediainfo sudo yum install mediainfo libmediainfo libzen # Choose 19+ version
8. Retire Matterhorn
sudo service matterhorn stop
9. Setup nginx streaming if you had been previously depending on the rails server to serve the HLS content.
10. Run waveform backfill script
This script will kick off many background jobs to generate waveform data for existing content for use with the new structural metadata editor. (New content will have waveforms generated as part of the ingest process.) If you have a lot of files ingested into Avalon the background jobs may take a very long time to run. See Waveform Backfill Script for more information.
RAILS_ENV=production bundle exec rails r script/waveform_backfill.rb
For Docker Installations
Stop Matterhorn
docker-compose stop matterhorn
Update new code from avalon-docker
git checkout master git pull
Pull or Rebuild Avalon container.
docker-compose pull avalon # or docker-compose build --no-cache avalon
Check config changes then replace the Avalon container
docker-compose up avalon worker