Mise à jour vers Karaoke Mugen 2.5¶
Avertissement
Attention : Cette documentation est obsolète !
Avertissement
Les informations contenues dans ce manuel étaient correctes au moment de son écriture, mais il se peut que de légères modifications aient été apportées ultérieurement dans le développement de l’application ou que certaines captures d’écran soient légèrement différentes des images de l’application finale.
Guide de mise à jour de Karaoke Mugen version 2.5 (Konata Karaokiste) depuis la version 2.4.2 sous ArchLinux.
Voici ce que l’on devrait avoir une fois l’installation terminée :
Avant propos¶
L’installation s’effectuera via git et non via des paquets pré-configurés.
Note
l’installation des paquets aur s’effectuera via aurman.
On assume le fait que la version 2.4.2 soit déjà installée, et que tous les paquets sont à jour.
Installation de Postgresql¶
À partir de la version 2.5 de Karaoké Mugen, les données ne sont plus stockées dans une base de données SQLite, mais sont stockées dans une base de données dans Postgresql.
Il faut donc installer Postgresql
> aurman -S postgresql
Note
On peut aussi installer postgresql avec pacman.
Configurons maintenant Postgresql.
On se connecte via le compte postgres (créé automatiquement à l’installation)
> sudo -iu postgres
Note
Si la connexion a réussi, le nom postgres doit s’afficher à gauche du @.
On commence d’abord par initialiser le cluster, qui contiendra les bases de données
> initdb -D /var/lib/postgres/data
Cette opération peut prendre quelques minutes.
Se déconnecter, soit via la commande exit, soit via le raccourci clavier Ctrl + D.
Activons le serveur de base de données au démarrage de la machine
> sudo systemctl enable postgresql
Démarrons le serveur de base de données
> sudo systemctl start postgresql
On peut vérifier si le serveur de base de données est en cours d’exécution
> systemctl status postgresql
Appuyez sur la touche q pour sortir.
Il faut maintenant créer un compte utilisateur, une base de données et attribuer les privilèges.
On se connecte de nouveau via le compte postgres
> sudo -iu postgres
Lancer la commande psql pour accéder à l’invite de commande de Postgresql
> psql
Taper maintenant les commandes suivantes :
CREATE DATABASE karaokemugen_app ENCODING 'UTF8';
CREATE USER karaokemugen_app WITH ENCRYPTED PASSWORD 'nanami';
GRANT ALL PRIVILEGES ON DATABASE karaokemugen_app TO karaokemugen_app;
Avertissement
Ne pas oublier de taper les points-virgule ; à la fin de chaque commande.
Ces commandes servent respectivement à :
Créer la base de données karaokemugen_app ;
Créer le compte utilisateur karaokemugen_app ;
Donner tous les privilèges pour la base karaokemugen_app au compte karaokemugen_app.
Courage, on a presque fini avec Postgresql.
Taper maintenant ces deux commandes :
\c karaokemugen_app
CREATE EXTENSION unaccent;
Note
L’extension unaccent permet d’effectuer des recherches dans la base en ignorant les lettres accentuées.
Se déconnecter de l’invite de commande de Postgresql, soit via la commande \q, soit via le raccourci clavier Ctrl + D.
Se déconnecter du compte postgres, soit via la commande exit, soit via le raccourci clavier Ctrl + D.
Note
Si un message d’avertissement concernant l’historique apparaît, ne pas en tenir compte. Ici, ce n’est pas important.
La partie paramétrage de Postgresql est maintenant terminée.
Mise à jour de Karaoke Mugen¶
Se déplacer dans le répertoire de Karaoké Mugen
> cd karaoke/karaokemugen-app
Mettre à jour le repo git
> git fetch
Vérifier les versions disponibles
> git tag
Note
Toutes les versions stables et intermédiaires sont numérotées (tags).
Récupérons la version 2.5.0
> git checkout tags/v2.5.0
On vérifie si c’est correct
> git status
Note
Si un message d’erreur apparaît, notamment « error: Vos modifications locales aux fichiers suivants seraient écrasées par l’extraction », taper la commande suivante :
git checkout .
Note
Une fois l’annulation effectuée, recommencer l’extraction de la version 2.5.0.
Installons les dépendances
> yarn setup
Note
quelques messages de type « warning » peuvent apparaître. Ce ne sont pas des messages gravissimes.
Note
Une fois les dépendances installées, les pages d’administration sont compilées automatiquement.
Si tout est bon et qu’aucune erreur (critique) n’est apparue, l’installation est alors terminée. Il reste cependant une dernière étape avant de démarrer Karaoke Mugen.
Configuration de la base de données pour KM¶
Copier le fichier database.sample.json et le nommer database.json.
> cp database.sample.json database.json
Ouvrir le fichier database.json avec un éditeur de texte.
Changer si nécessaire les valeurs user et password.
Note
Le mot de passe défini lors de la configuration de la base de données était nanami. Il faudra donc remplacer musubi par nanami.
Changer le port 6559 en 5432.
Changer bundledPostgresBinary »: true en bundledPostgresBinary »: false.
Enregistrer et fermer. On peut maintenant lancer Karaoke Mugen.
Lancement de Karaoke Mugen¶
Pour lancer Karaoke Mugen, il suffit de taper la commande
> yarn start
Note
Ne pas oublier de se placer dans le « bon » répertoire.
Ici, il s’agit de ~/karaoke/karaokemugen-app
Plein de messages apparaissent alors dans le terminal, indiquant les opérations effectuées (lecture du fichier de configuration, création puis génération de la base de données…).
Si tout va bien, les fenêtres mpv et firefox devraient apparaître.
Karaoké Mugen est alors prêt à être utilisé.
Bon karaoké
Note
La documentation a été mise à jour le mercredi 1er mai 2019.