Mise à jour vers Karaoke Mugen 2.5

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.

Karaoke Mugen version 2.5 (Konata Karaokiste).

Voici ce que l’on devrait avoir une fois l’installation terminée :

Karaoke Mugen version 2.5 (Konata Karaokiste) sous ArchLinux.

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
Installation de Postgresql. Installation de Postgresql terminée.

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
Connexion avec le compte 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
Initialisation du cluster.

Cette opération peut prendre quelques minutes.

Initialisation du cluster terminée.

Se déconnecter, soit via la commande exit, soit via le raccourci clavier Ctrl + D.

Déconnexion du compte postgres.

Activons le serveur de base de données au démarrage de la machine

> sudo systemctl enable postgresql
Activation du serveur de base de données au démarrage de la machine.

Démarrons le serveur de base de données

> sudo systemctl start postgresql
Démarrage du serveur de base de données.

On peut vérifier si le serveur de base de données est en cours d’exécution

> systemctl status postgresql
Le serveur de base de données est en cours d'exécution.

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
Connexion avec le compte postgres.

Lancer la commande psql pour accéder à l’invite de commande de Postgresql

> psql
Invite de commande de Postgresql.

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.
Création de la base de données et du compte utilisateur.

Courage, on a presque fini avec Postgresql.

Taper maintenant ces deux commandes :

\c karaokemugen_app
CREATE EXTENSION unaccent;
Ajout de l'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.

Déconnexion.

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
Affichage de la liste des tags.

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
Extraction de la version 2.5.0.

On vérifie si c’est correct

> git status
Vérification de la version.

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 .
Annulation des modifications.

Note

Une fois l’annulation effectuée, recommencer l’extraction de la version 2.5.0.

Installons les dépendances

> yarn setup
Installation des dépendances.

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.

Installation des dépendances terminée.

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
Copie du fichier database.sample.json.

Ouvrir le fichier database.json avec un éditeur de texte.

Édition du fichier database.json.

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.

Fin de l'édition du fichier database.json.

Lancement de Karaoke Mugen

Pour lancer Karaoke Mugen, il suffit de taper la commande

> yarn start
Démarrage de Karaoke Mugen.

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…).

Pleins de messages qui défilent.

Si tout va bien, les fenêtres mpv et firefox devraient apparaître.

Karaoke Mugen a démarré correctement.

Karaoké Mugen est alors prêt à être utilisé.

Karaoke Mugen en action.

Bon karaoké

Note

La documentation a été mise à jour le mercredi 1er mai 2019.