WIP document pending 8.0 release.

Requirements

Ruby 3.x and Node.js x.x are recommended.

Config changes

Troubleshooting

Upgrade Steps

For Manual Installations

Install ruby 3.2.x (if needed)

Update gems, and migrate DB

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

Install node.js 20.x (if needed)
Update JS dependencies
```
yarn install # in Avalon root dir
```
Update configuration, see Config changes above
Restart passenger (if using)
```
passenger-config restart-app
```

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

Before upgrading an AWS docker install based on avalon-terraform or the aws_min branch of avalon-docker make a backup of your supplemental files prior to destroying the avalon container!

docker cp avalon-docker-aws_min_avalon_1:/home/app/avalon/storage ./active_storage_backup

Then load them into an S3 bucket:

aws s3 cp active_storage_backup/* s3://${SETTINGS__ACTIVE_STORAGE__BUCKET}/ --recursive

See https://github.com/avalonmediasystem/avalon-docker/issues/77 for more discussion on this. If you run into any problems, please reach out on slack or the email list.

Stop Avalon
```
docker-compose down
```
Update new code from avalon-docker
```
git checkout main
git pull
```
Pull new images
```
docker-compose pull avalon solr
```
Check config changes then restart the Avalon containers
```
docker-compose up
```

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

Upgrading Avalon 7.8 to Avalon 8.0