docs: improve airtime migration guide (#2564)

This commit is contained in:
Jonas L 2023-05-25 15:46:20 +02:00 committed by GitHub
parent 52361c1b9b
commit a67a8a880c
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 28 additions and 8 deletions

View File

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