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 externes 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
Open the configuration dialog by clicking
. Enable the checkbox and enter the user data.
You need to restart Amarok so that the changes take effect.
Migrating from MySQL Embedded to MySQL Server
If you want to maintain the statistics, etc. that you have in the embedded MySQL database from before Amarok 2.2, you can do the following: First, start Amarok 2.2+ at least once to give the database a chance to update to the latest schema version.
Next, kill the running MySQL service
sudo /etc/init.d/mysql stop
and start a MySQL daemon from your ~/.kde4/share/apps/amarok directory (--defaults-file MUST be the first option!):
/usr/sbin/mysqld --defaults-file=`pwd`/my.cnf --default-storage-engine=MyISAM --datadir=`pwd`/mysqle --socket=`pwd`/sock --skip-grant-tables
The skip-grant-tables means you can use any password or username to connect to it. 'localhost' will not work, the MySQL client will try to use a Unix socket. Using 127.0.0.1 as the host makes it work. Some systems may restrict this access through apparmor or SELinux. They can be temporarily disabled with
sudo /etc/init.d/apparmor stop
Now, run mysqldump, passing in the -S option to specify the local socket. This will dump your old embedded DB out to a SQL file.
mysqldump -S sock amarok > amarok.mysql
You can then restart your MySQL service and load this SQL file into your MySQL server. You'll have needed to already run the GRANT statement above and create an Amarok database ("CREATE DATABASE amarok;"):
sudo /etc/init.d/mysql stop mysql -u amarokuser -p amarok < amarok.mysql