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. 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 ## Make a backup
### Backup the configuration ### 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: Here is an example to dump your PostgreSQL database:
```bash ```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. 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
Install LibreTime on a new system by [running the installer](./README.md#run-the-installer), and **don't run the setup tasks**. 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**.
## 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**.
## Update the configuration files ## 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. 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 ## Finish
Restart the LibreTime services and navigate to the LibreTime web-page. Restart the LibreTime services and navigate to the LibreTime web-page.