Amarok/Manuel/Organisation/Collection/BaseDeDonnéesExterne
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 . 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