From a67a8a880c2cd78be9faca01fa59bc48679d4009 Mon Sep 17 00:00:00 2001 From: Jonas L Date: Thu, 25 May 2023 15:46:20 +0200 Subject: [PATCH] docs: improve airtime migration guide (#2564) --- .../install/migrate-from-airtime.md | 36 ++++++++++++++----- 1 file changed, 28 insertions(+), 8 deletions(-) diff --git a/docs/admin-manual/install/migrate-from-airtime.md b/docs/admin-manual/install/migrate-from-airtime.md index 11149ea92..03760d5a8 100644 --- a/docs/admin-manual/install/migrate-from-airtime.md +++ b/docs/admin-manual/install/migrate-from-airtime.md @@ -13,6 +13,12 @@ Airtime **linked files** and **watched folders** features are either deprecated LibreTime dropped support for Ubuntu 16.04, which is the last supported version of Ubuntu that Airtime supports. +To have a better understanding of the next steps, please read the following documentation before you continue: + +- [Upgrade documentation](./upgrade.md) +- [Backup documentation](../backup.md) +- [Install documentation](./install-using-the-installer.md) + ## Make a backup ### Backup the configuration @@ -26,7 +32,7 @@ You need to backup the PostgreSQL database, which holds the entire data of your Here is an example to dump your PostgreSQL database: ```bash -sudo -u postgres pg_dump --file=airtime.sql airtime +sudo -u postgres pg_dump --no-owner --no-privileges airtime > airtime.sql ``` Please read the `pg_dump` usage for additional details. @@ -39,13 +45,7 @@ The path to your storage was defined during the installation process, the defaul ## Install -Install LibreTime on a new system by [running the installer](./README.md#run-the-installer), and **don't run the setup tasks**. - -## Restore the backup - -Restore [the Airtime backup](../backup.md#restore) on the newly installed LibreTime server. - -You have to restore the **database**, the **files storage** and the **configuration files**. +Install LibreTime on a new system by [running the installer](./install-using-the-installer.md#run-the-installer), and **don't run the setup tasks**. ## Update the configuration files @@ -53,6 +53,26 @@ Update the configuration file to match the new configuration schema and update a Edit the Icecast password in `/etc/icecast2/icecast.xml` to reflect the password used in Airtime. +## Restore the backup + +Restore [the Airtime backup](../backup.md#restore) on the newly installed LibreTime server. + +You have to restore the **database**, and the **files storage**. + +Here is an example to restore your PostgreSQL database: + +```bash +sudo -u libretime libretime-api dbshell < airtime.sql +``` + +## Apply migrations + +Run the following command to apply the database migrations: + +```bash +sudo -u libretime libretime-api migrate +``` + ## Finish Restart the LibreTime services and navigate to the LibreTime web-page.