Congegni
/
libretime
mirror of https://github.com/libretime/libretime.git
7
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
libretime/docs/upgrading.md

2.6 KiB
Raw Blame History

title
Upgrading Libretime

:::caution

While upgrading your installation may not cause any station downtime or data loss, always plan for the worst. Only upgrade your installation when Libretime isn't playing out shows, notify your DJs and essential personnel, and back up your database, configuration files, and media library before you make any changes.

:::

  1. Back up the server and make a copy of all the configuration files under /etc/airtime/.
  2. Run ./install -fiap as described in the installation guide. This will detect an existing LibreTime deployment and backup any configuration files that if finds. The install script also tries to restart the needed services during an upgrade. In any case you should monitor if this happened and also take a quick look at the logs files to be sure everything is still fine. Now might be the time to reboot the system or virtual machine LibreTime is running on since regular reboots are part of a healthy system anyway.
  3. Log into the new version of the LibreTime administration interface. If the playout engine starts up and detects that a show should be playing at the current time, it will skip to the correct point in the current time and start playing. If you encounter issues trying to connect to the new administration interface, you may need to clear your web browser's cache.

Migrating from Airtime

:::note

Airtime's linked files and watched folders features currently do not work in Libretime.

:::

LibreTime has dropped support for Ubuntu 16.04, which is the last supported version of Ubuntu that Airtime supports. The following instructions describe how to migrate from Airtime to LibreTime. If there are issues encountered while upgrading, please file a bug

  1. Take a backup of the server
  2. Create a new system for LibreTime and run the install script, as described in the install guide.
  3. Before running the web-configuration, restore the Airtime database to the new PostgreSQL server, media database and configuration file
  4. Update the configuration file to match the new configuration schema and update any changed values. See the host configuration documentation for more details.
  5. Edit the Icecast password in /etc/icecast2/icecast.xml to reflect the password used in Airtime
  6. Restart the LibreTime services
  7. Open LibreTime's dashboard and verify all services are running