Versions Compared

Old Version 1

changes.mady.by.user Jon Cameron

Saved on

compared with

New Version 2

changes.mady.by.user Chris Colvard

Saved on

Key

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

Avalon 7.7 requires a full reindex due to performance improvements introduced in this release. You may also want to upgrade your version of Solr to 9.x at this time.

Requirements

Ruby 3.2.x and Node.js 1420.x are recommended.

Config changes

...

For Manual Installations

  1. Install Ruby 3.2.x 

  2. Update gems, and migrate DB

    Code Block
    bundle install --with production --without development test 
RAILS_ENV=production bundle exec rake db:migrate

  3. Install node.js 1420.x (if needed)

  4. Update JS dependencies

    Code Block
    yarn install # in Avalon root dir

  5. Update configuration, see Config changes above

  6. Restart passenger (if using)

    Code Block
    passenger-config restart-app

For Docker Installations

Avalon 7.6 is not compatible with Postgres versions 9.4 and below.

The instructions below will guide you through dumping the data from Postgres prior to upgrading and then loading it again after upgrade.

Note: avalon-docker 7.6.0 switches to a bind mount volume for storing Postgres data for safer persistence across upgrades.

Before upgrading, dump the contents of Postgres and backup all data from the db volume

...

  1. Install Solr 9 (optional)

    1. Make backup of existing Solr using instructions on https://samvera.atlassian.net/wiki/spaces/AVALON/pages/2303328775/Backing+up+and+restoring+supporting+services#Solr

    2. Setup Solr 9 in the same location as previous Solr
      Or a new location and update config files (solr.yml and blacklight.yml)

  2. Run reindex

    Code Block
    RAILS_ENV=production nohup bundle exec rails r script/reindex.rb -v --parallel-indexing

  3. Run rake migrations

    Code Block
    RAILS_ENV=production bundle exec rake avalon:migrate:collection_managers
RAILS_ENV=production bundle exec rake avalon:migrate:caption_files

For Docker Installations

  1. Stop Avalon

    Code Block
    docker-compose down

  2. Backup solr data using instructions on https://samvera.atlassian.net/wiki/spaces/AVALON/pages/2303328775/Backing+up+and+restoring+supporting+services#Solr

  3. Update new code from avalon-docker

    Code Block
    git checkout main
git pull

  4. Pull new

...

  1. images

    Code Block
    docker-compose pull avalon

...

  1.  solr

  2. Check config changes then restart the Avalon containers

    Code Block
    docker-compose up

...

Check config changes then replace the Avalon containers

...

  1. avalon worker

  2. Run reindex (inside avalon container)

    Code Block
    RAILS_ENV=production nohup bundle exec rails r script/reindex.rb -v --parallel-indexing

  3. Run rake migrations (inside avalon container)

    Code Block
    RAILS_ENV=production bundle exec rake avalon:migrate:collection_managers
RAILS_ENV=production bundle exec rake avalon:migrate:caption_files

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

Code Block
docker-compose build avalon