Upgrading Avalon 8.1.0 to Avalon 8.1.1

Upgrading Avalon 8.1.0 to Avalon 8.1.1

Requirements

Ruby 3.4.x and Node.js 20.x are recommended.

Description

Avalon 8.1.1 is a bugfix release only. No new features or configuration options are included.

Upgrade Steps

For Manual Installations

  1. Install ruby 3.4.x (if needed)

  2. Update gems, and migrate DB

    bundle install --with production --without development test RAILS_ENV=production bundle exec rake db:migrate
  3. Install node.js 20.x (if needed)

  4. Update JS dependencies

    yarn install # in Avalon root dir
  5. Update configuration, see Config changes above

  6. Restart passenger (if using)

    passenger-config restart-app

For Docker Installations

  1. Stop Avalon

    docker-compose down
  2. Update new code from avalon-docker

    git fetch git checkout v8.1.1 git pull
  3. Pull new images

    docker-compose pull avalon
  4. Check config changes then restart the Avalon containers

    docker-compose up

You can also build your own image, Docker Buildkit is recommended

docker-compose build avalon

 

For Terraform installations

These instructions are a work in progress.

  1. Set avalon_docker_code_branch and avalon_branch in terraform.tfvars if necessary. (Latest tags are v8.1.1 for Avalon and avalon-8.1-aws_min for avalon-docker.)

  2. Perform the upgrade:

    terraform apply

You may also see an error when attempting to create an iam user which already exists. If this happens rerunning the terraform apply should resolve the issue and successfully run to completion