Versions Compared

Key

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

This page is a work in progress and will be updated before 7.6 is released.

Requirements

Ruby 3.2.7.x and Node.js 14.x are recommended.

Anchor
configchanges
configchanges
Config changes

As part of a fix for caption support on iOS devices, two new configuration options were added which define default values in the HLS manifest for caption language and label.

Code Block
caption_default:
  # Language should be 2 or 3 letter ISO 639 codes
  language: 'en'
  name: 'English'


Upgrade Steps

For Manual Installations

  1. Install Ruby 3.x (question)
  2. Update gems, and migrate DB

...

Code Block
languagebash
passenger-config restart-app

For Docker Installations


Warning

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

Code Block
docker-compose exec db pg_dumpall -U postgres -f /data/backup.sql
docker compose cp db:/data db/backup

Stop Avalon

Code Block
docker-compose down

Update new code from avalon-docker

...

Code Block
languagebash
docker-compose pull avalon

Start only the db container and allow Postgres to initialize the new bind mount volume, load the dumped data, then stop the db container.

Code Block
docker-compose up db
cp db/backup/backup.sql db_data
docker-compose exec db /bin/bash -c "psql -U postgres < /data/backup.sql"
docker-compose down

Check config changes then replace the Avalon containers

...