Requirements

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

Config changes

and configured in settings.yml

app_controller:
  solr_and_fedora:
    raise_on_connection_error: false
app_job:
  solr_and_fedora:
    raise_on_connection_error: true

Derivative download

derivative:
  # Choose whether collection managers and admins can download high quality derivatives
  allow_download: true

Maximum upload size

# Maximum size for uploaded files in bytes (default is disabled)
#max_upload_size: 2147483648 # Use :none or comment out to disable limit

Troubleshooting

Before starting the upgrade there are some steps to keep a close eye on when running.

SupplementalFile Migration

MediaObject Section List Migration

Upgrade Steps

For Manual Installations

1. Install ruby 3.2.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

7. Run rake migrations

   RAILS_ENV=production bundle exec rake avalon:migrate:backfill_parent_id
   RAILS_ENV=production bundle exec rake avalon:migrate:media_object_section_list

For Docker Installations

1. Stop Avalon

   docker-compose down

2. Update new code from avalon-docker

   git checkout main
   git pull

3. Pull new images

   docker-compose pull avalon solr

4. Check config changes then restart the Avalon containers

   docker-compose up

5. Run rake migrations (inside avalon container)

   RAILS_ENV=production bundle exec rake avalon:migrate:backfill_parent_id
   RAILS_ENV=production bundle exec rake avalon:migrate:media_object_section_list

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

docker-compose build avalon