Upgrading Avalon 7.0 to Avalon 7.1

See the Avalon 7.1 release notes for more information.


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 settingNew settingNote


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

  mailer: :smtp  # or aws_sdk if using Amazon SES
    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. Update gems, and migrate DB
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

For Docker Installations

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 containers

docker-compose up avalon worker