Requirements

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

Config changes

Listed here.

Upgrade Steps

For Manual Installations

1. Install Ruby 3.2.x 

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

7. 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)

8. Run reindex

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

9. Run rake migrations

   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

   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

   git checkout main
   git pull

4. Pull new images

   docker-compose pull avalon solr

5. Check config changes then restart the Avalon containers

   docker-compose up avalon worker

6. Run reindex (inside avalon container)

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

7. Run rake migrations (inside avalon container)

   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

docker-compose build avalon