Versions Compared

Old Version 1

changes.mady.by.user Jon Cameron

Saved on

compared with

New Version 2

changes.mady.by.user Phuong Dinh

Saved on

Key

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

...

Note

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  for more information.

Requirements

...

Anchor
configchanges
configchanges
Config changes

Old settingNew settingNote
matterhorn

email:
  mailer:
    smtp:
     

media_path: /path/to/dir

encoding:
  working_file_path: /path/to/dir

More information

home_page:
  featured_collections: ['col1_id', 'col2_id']
  carousel_collections: ['col3_id', 'col4_id', 'col5_id']

Choose which collections to display in the featured and carousel portions of the new homepage. 

More information on customizing the UI

address: 'mail-relay.iu.edu'
      port: 587
      enable_starttls_auto: false

email:
  mailer: :smtp  # or aws_sdk if using Amazon SES
  config:
    address: mail-relay.university.edu
    port: 25
    enable_starttls_auto: false


Upgrade Steps

For Manual Installations

  1. Download and deploy new code from the avalon repository.
  2. Install bundler 2, update Update gems, and migrate DB
Code Block
languagebash
gem install bundler -v 2.0.2
bundle install --with production --without development test
RAILS_ENV=production bundle exec rake db:migrate

...

4. Update configuration, see Config changes above

5. Restart passenger (if using)

Code Block
languagebash
passenger-config restart-app

6. Replace Resque with Sidekiq (background jobs processor). Look at our Manual Instructions for more details.

Code Block
languagebash
pkill -f resque
RAILS_ENV=production bundle exec sidekiq -d -C config/sidekiq.yml

7. Upgrade mediainfo

Code Block
languagebash
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 

Code Block
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.

Code Block
languagebash
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

...

Check config changes then replace the Avalon containercontainers

Code Block
languagebash
docker-compose up avalon worker

...