Amarok/Manuel/Organisation/Collection/BaseDeDonnéesExterne

From KDE Wiki Sandbox
This page is a translated version of the page Amarok/Manual/Organization/Collection/ExternalDatabase and the translation is 100% complete.

Base de données externe

À partir de la version 2.2, Amarok prend en charge la base de données externe MySQL en tant que dorsale (backend).

Configurer le serveur
Installer le serveur MySQL

Premièrement, vous devez installer un serveur MySQL. Sur les distributions fondées sur Debian tel qu'Ubuntu, vous pouvez utiliser

sudo apt-get install mysql-server mysql-client

pour l'installer. On vous demandera de spécifier un mot de passe pour le compte administrateur (root) de la base de données. Le paquetage mysql-client est nécessaire afin d'exécuter quelques commandes dans ce document, mais il n'est pas fondamental pour l'utilisation d'Amarok.

Configurer la base de données

Connectez vous à la base de données locale en tapant

mysql -u root -p

On vous demandera le mot de passe de l'utilisateur administrateur de MySQL. Vous obtiendrez l'invite de commande

mysql>

.

Créez un nouvel utilisateur amarokuser avec le mot de passe amarokpass en utilisant la commande

CREATE USER 'amarokuser'@'localhost' IDENTIFIED BY 'amarokpass';

Donnez l'accès à la base de données au nouvel utilisateur en saisissant la commande

GRANT ALL ON amarokdb.* TO 'amarokuser'@'%' IDENTIFIED BY 'amarokpass';

où "%" est un métacaractère autorisant tous les hôtes à se connecter à la base de données. À présent, utilisez

FLUSH PRIVILEGES;

pour recharger les divers caches internes utilisés par MySQL. Finalement

exit

ferme l'invite de commande de MySQL.

Par défaut, on ne peut accéder au serveur que via l'hôte local. Pour changer cela, vous devez modifier le fichier /etc/mysql/my.cnf et ajuster l'adresse proche de bind-address par celle que votre serveur écoute sur le réseau. 0.0.0.0 écoute toutes les interfaces. Après cela, vous devez redémarrer le serveur en utilisant

sudo service mysql restart
Configurer le client

Ouvrez la boite de dialogue de configuration en cliquant sur Configuration -> Configurer Amarok -> Base de données. Cocher la case et renseignez les données utilisateur.



Vous devez redémarrer Amarok afin que les changements soient pris en compte.

Migration d'un MySQL embarqué vers un serveur MySQL

Si vous souhaitez conserver les statistiques, etc. que vous aviez dans la base de données MySQL embarquée pour les versions antérieures à Amarok 2.2, vous pouvez faire ce qui suit : Premièrement, démarrer Amarok 2.2+ au moins une fois pour donner une chance à la base de données de se mettre à jour vers la dernière version du schéma.

Ensuite, tuez le service MySQL en cours d'exécution

sudo /etc/init.d/mysql stop

et démarrez un démon MySQL à partir de votre répertoire ~/.kde4/share/apps/amarok (--defaults-file DOIT être la première option !) :

/usr/sbin/mysqld --defaults-file=`pwd`/my.cnf --default-storage-engine=MyISAM --datadir=`pwd`/mysqle --socket=`pwd`/sock --skip-grant-tables

Le skip-grant-tables signifie que vous pouvez utiliser n'importe quel mot de passe ou nom d'utilisateur pour vous connecter. 'localhost' ne fonctionnera pas, le client MySQL' essaiera d'utiliser le socket Unix. L'utilisation de 127.0.0.1 en tant qu'hôte fonctionne. Certains systèmes restreignent l'accès à travers apparmor ou SELinux. Ils peuvent être désactivés temporairement avec

sudo /etc/init.d/apparmor stop

À présent, lancez mysqldump, en lui passant l'option -S pour lui spécifier le socket local. Cela copiera la base de données embarquée vers le fichier SQL.

mysqldump -S sock amarok > amarok.mysql

Vous pouvez alors redémarrer votre service MySQL et charger ce fichier SQL dans votre serveur MySQL. Vous aurez besoin de que la commande GRANT ci-dessus soit en cours d'exécution et il faudra créer une base de données Amarok ("CREATE DATABASE amarok;") :

sudo /etc/init.d/mysql stop
mysql -u amarokuser -p amarok < amarok.mysql
Remarque
Vous aurez peut-être besoin de rescanner votre collection dans Amarok après avoir fini ceci.