Page Comparison

...

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

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 a new location and update config files (solr.yml and blacklight.yml) (safest approach)
      Or the same location as previous Solr and clear it out

8. Run reindex
   First download the latest version of the reindex script to script/reindex.rb then run:

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

9. 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 sudo chmod a+w solr_data

4. Pull new images

   Code Block
   docker-compose pull avalon solr

5. Check config changes then restart the Avalon containers

   Code Block
   docker-compose up avalon worker

6. Run reindex (inside avalon container)
   First download the latest version of the reindex script to script/reindex.rb then run:

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

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

...