Upgrading Avalon 7.0 to Avalon 7.1

Owned by Jon Cameron
Last updated: Jun 15, 2020 by Phuong Dinh
1 min read

See the Avalon 7.1 release notes 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 settingNew settingNote

email:
  mailer:
    smtp:
      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. 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