Aller au contenu

Mettre à jour le serveur

Cette page met Musonic Server à jour vers une version plus récente, et explique ce qui arrive à vos données et comment revenir en arrière au besoin. Elle s’adresse à la personne qui fait tourner le serveur. Les applis se mettent à jour à part, voir la fin de cette page.

Le serveur cherche les nouvelles versions sur GitHub toutes les 6 heures (réglage update_check, variable d’environnement MUSONIC_UPDATE_CHECK, activé par défaut). Il n’installe jamais rien tout seul : il vous prévient.

  • La console affiche une alerte « Musonic Server X est disponible » au bout à droite de la barre du haut. Le Tableau de bord la répète dans un bandeau, « Vous avez la version … », avec un bouton Voir la version, et un compteur apparaît à côté de Tableau de bord dans le menu.
  • La carte Versions du Tableau de bord montre la version installée, la dernière, et Mise à jour disponible ou À jour. La même carte couvre le lecteur web installé sur le serveur.
Le tableau de bord de la console avec l'alerte Musonic Server X est disponible dans la barre du haut et dans un bandeau avec le bouton Voir la version, et la carte Versions qui indique la version installée, la dernière et Mise à jour disponible.

Lisez les changements avant de mettre à jour : les notes de version sur la page des versions (étiquettes server-v…), ou la liste des versions.

  1. Allez dans le dossier du serveur.

    Fenêtre de terminal
    cd ~/musonic-server
  2. Téléchargez la nouvelle image.

    Fenêtre de terminal
    docker compose pull
  3. Relancez le serveur avec elle.

    Fenêtre de terminal
    docker compose up -d

    Docker remplace le conteneur ; votre dossier data reste. La musique s’arrête quelques secondes, les applis se reconnectent toutes seules.

  4. Vérifiez la version dans les journaux.

    Fenêtre de terminal
    docker compose logs --tail 50 musonic-server

    La ligne musonic-server starting montre la nouvelle version.

  5. Supprimez l’ancienne image (facultatif).

    Fenêtre de terminal
    docker image prune

Avec l’étiquette :1 du fichier compose d’exemple, pull prend la version 1.x la plus récente : il ne passe jamais tout seul à une 2.0. Une 2.0 dirait dans ses notes ce qu’il faut changer avant.

Vous n’avez rien à faire : le serveur met sa base à jour lui-même au démarrage.

  • La base a une version de schéma. Chaque nouvelle version du serveur apporte les changements dont elle a besoin (migrations), appliqués dans l’ordre au démarrage, chacun entièrement ou pas du tout. Les journaux affichent database migrated to <n> (<name>) pour chacun.
  • Avant de modifier la base, le serveur la copie telle qu’elle était, à côté : musonic.db.before-schema-<n> dans le dossier de données (<n> est la première migration sur le point d’être appliquée). Cette copie est faite une fois, et sert à revenir en arrière à la main.
  • Beaucoup de mises à jour ne changent rien à la base : aucune copie n’est faite alors.
  • Un serveur plus ancien refuse d’ouvrir une base qu’un plus récent a modifiée : il s’arrête avec database schema … is newer than this server …: update the server. Vos données ne sont pas touchées.

En plus de cette copie, le serveur sauvegarde sa base chaque jour dans backups/, dans le dossier de données (musonic-AAAA-MM-JJ.db), la première fois juste après son démarrage. Il garde les 14 dernières (réglage backup_days, MUSONIC_BACKUP_DAYS ; 0 les coupe).

Dans la console, Réglages et maintenance → Sauvegardes les liste, en fait une tout de suite (Sauvegarder maintenant) et les télécharge. La console vous prévient quand aucune sauvegarde n’a été faite depuis plus de 2 jours.

Si une nouvelle version ne vous convient pas, vous pouvez revenir à celle que vous aviez.

Si la mise à jour n’a pas modifié la base (aucune ligne database migrated dans les journaux, aucun nouveau fichier musonic.db.before-schema-…) : remettez l’ancienne version, c’est tout.

Dans compose.yml, écrivez la version exacte que vous aviez à la place de 1, par exemple :

image: ghcr.io/doodzdev/musonic-server:1.2.0

puis docker compose up -d. Remettez 1 plus tard pour recevoir à nouveau les mises à jour.

Si la mise à jour a modifié la base, l’ancienne version la refuse. Revenez à la copie faite avant la migration. Ce qui a été fait entre-temps (likes, écoutes, playlists depuis la mise à jour) est perdu.

  1. Arrêtez le serveur.

    Docker : docker compose down. Sans Docker : sudo systemctl stop musonic-server.

  2. Mettez la base actuelle de côté, avec ses deux fichiers compagnons.

    Dans le dossier de données (~/musonic-server/data, ou /var/lib/musonic-server) :

    Fenêtre de terminal
    mkdir newer
    mv musonic.db musonic.db-wal musonic.db-shm newer/

    (musonic.db-wal et musonic.db-shm peuvent ne pas exister : ce n’est pas grave.)

  3. Remettez la copie faite avant la migration.

    Fenêtre de terminal
    cp musonic.db.before-schema-<n> musonic.db

    Prenez la plus récente, le fichier au <n> le plus grand : c’est celle qu’a faite cette mise à jour (les autres viennent de mises à jour précédentes). Sans Docker, lancez les commandes sous l’utilisateur du service, ou rendez-lui le fichier avec chown.

  4. Démarrez l’ancienne version (voir plus haut).

Les applis se mettent à jour à part du serveur : chacune a sa propre version et ses propres publications.

Appli Comment elle apprend qu’une version est sortie Comment mettre à jour
Android Quelques secondes après son lancement, l’appli cherche sur GitHub une version Android plus récente de Musonic. S’il y en a une, une fenêtre indique « Mise à jour disponible », « La version X est disponible sur GitHub », avec Voir la release (ouvre la page de la version) et Annuler. Vous pouvez aussi vérifier vous-même : le bouton rond avec votre initiale, en haut à gauche des écrans principaux → À propos → Vérifier les mises à jour. Téléchargez et installez le nouvel APK de la version, par-dessus l’ancien : vos comptes et vos téléchargements restent. Voir Installer l’appli Android.
Lecteur web sur votre serveur (/app/) Le Tableau de bord de la console (Versions) et Réglages et maintenance (Musonic Web sur ce serveur) montrent la dernière version. Réglages et maintenance → Musonic Web sur ce serveur → Mettre à jour. Puis rechargez la page dans les navigateurs.
Lecteur web de ce site Rien à faire. Il est mis à jour à chaque nouvelle version du lecteur web : rechargez la page.
iPhone, iPad Ils utilisent le lecteur web : voir les deux lignes au-dessus. Pareil.
L'appli Android avec la fenêtre Mise à jour disponible, le texte La version X est disponible sur GitHub, et les boutons Annuler et Voir la release.