I. Prérequis▲
Éléments requis pour la réalisation de ce tutoriel :
- un système d'exploitation Linux ;
- un serveur HTTP ;
- un serveur MySQL 4.1.x.
II. Information sur mysqld_multi▲
mysqld_multi est un programme livré avec MySQL. Il sert à gérer plusieurs serveurs utilisant différents sockets Unix et ports TCP/IP sur la même machine.
Pour fonctionner, le programme lit un fichier de configuration dans lequel sont référencés les différents groupes (serveurs de base de données) ainsi que le moyen d'y accéder.
Ce programme se substitue au démon mysqld pour démarrer un, plusieurs, ou tous les serveurs. On peut, comme mysqld, configurer le système pour que le service se lance au démarrage de la machine. Cette manipulation est expliquée à la fin du tutoriel.
III. Préparation▲
Ce tutoriel n'étant ni destiné à vous faire découvrir le monde Unix, ni faire de vous un administrateur Web, nous partirons du fait que l'on a déjà installé Linux ainsi qu'un serveur HTTP.
Pour l'exemple, et vu que les tests ont été réalisés sur ce type de système, les commandes et les chemins des répertoires utilisés sont ceux d'une distribution Fedora Core 4 installée par défaut pour une station de travail. Je ne détaillerai ici ni la configuration de Fedora, ni celle d'Apache, ni celle de MySQL.
Toutefois, le service mysqld n'étant pas démarré par défaut, vous pouvez l'activer après vous être logué en tant que super-utilisateur (root) et en tapant :
# /etc/init.d/mysqld start
Ce qui aura pour effet, par l'intermédiaire du sous-programme mysql_install_db, d'instaurer une première base de données nommée « mysql » contenant les privilèges nécessaires à une première utilisation ainsi qu'à la suite de ce tutoriel.
Si, comme prévu, le service mysqld fonctionne, il est maintenant temps de l'arrêter. Pour vérifier s'il est actif :
# ps aux | grep mysqld
vous donnera ceci :
Pour arrêter le service mysqld :
# /etc/init.d/mysqld stop
Nous allons à présent créer les différents répertoires qui serviront aux serveurs à stocker leurs fichiers. Il est important d'en avoir un par serveur, cela afin d'éviter des erreurs irrécupérables.
Mettons-nous comme objectif de créer deux serveurs (vous pourrez en créer autant que vous voulez). Une fois reconnu comme utilisateur root, tapez :
# mkdir /var/lib/mysql1 /var/lib/mysql2
Sur Fedora Core 4, avec installation de MySQL natif, le système crée un utilisateur et un groupe nommés « mysql ». Il nous faut maintenant donner à cet utilisateur le droit de travailler avec ces répertoires :
# chown -R mysql:mysql /var/lib/mysql1 /var/lib/mysql2
Le programme mysqld_install_db est utilisé pour initialiser un serveur proprement avec un répertoire de stockage des fichiers de base. Mais comme nous en avons la possibilité, étant donné qu'il s'agit de la même version de moteur, dupliquons simplement le répertoire contenant les privilèges primaires de la base mysql installée par défaut (dans ma configuration, /var/lib/mysql/mysql) dans les répertoires respectifs des nouveaux serveurs.
Si vous n'êtes pas sûr de la localisation du répertoire, ouvrez le fichier my.cnf (/etc/my.cnf) et cherchez la variable datadir qui devrait contenir le chemin d'accès recherché.
2.
# cp -Rp /var/lib/mysql/mysql /var/lib/mysql1/
# cp -Rp /var/lib/mysql/mysql /var/lib/mysql2/
IV. Fichier de configuration▲
Le fichier de configuration de mysqld se trouve (suivant les distributions) dans /etc/ et se nomme my.cnf
On pourrait utiliser ce fichier pour la configuration de mysqld_multi, mais par sécurité (afin de laisser la possibilité d'un éventuel retour), nous allons en créer un autre.
Comme dit précédemment, nous avons comme objectif dans ce tutoriel d'installer deux serveurs distincts, mais rien ne vous empêche d'en créer autant que vous voulez, il suffira d'adapter les répertoires nécessaires et les paramètres de groupes ([mysqldX] dans le fichier de configuration, X représentant l'identifiant du serveur) pour chacun d'entre eux.
Avant de remplir le fichier de configuration, il convient de vérifier que les répertoires suivants existent. Si ce n'est pas le cas, veuillez adapter les chemins à votre configuration système.
- Répertoire de lancement du programme (par défaut : /usr/bin).
- Répertoire de stockage des données et des sockets (par défaut : /var/lib/mysql).
- Répertoire de stockage des logs (par défaut : /var/log).
- Répertoire de stockage des processus (par défaut : /var/run/mysqld).
- Répertoire d'installation du serveur (par défaut : /var/lib).
Entrons dans le vif du sujet, ouvrez votre éditeur de texte préféré et créez le fichier /etc/multi_my.cnf (ou le nom de votre choix) comme indiqué ci-dessous :
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.
35.
36.
37.
38.
39.
40.
# configuration principale de mysqld_multi
# l'utilisateur multi_user est necessaire pour que
# le programme puisse arreter les moteurs.
[mysqld_multi]
mysqld = /usr/bin/mysqld_safe
mysqladmin = /usr/bin/mysqladmin
user = multi_user
password = mypass
# configuration d'un premier serveur
[mysqld1]
# repertoire de stockage des fichiers de base
datadir=/var/lib/mysql1
# chemin du socket (imperativement different pour chaque serveur)
socket=/var/lib/mysql1/mysql.sock1
# port (imperativement different pour chaque serveur)
port=3306
# pour compatibilite avec anciens serveurs
old_passwords=1
# chemin des fichiers de log
err-log=/var/log/mysqld1.log
# chemin des processus
pid-file=/var/run/mysqld/mysqld.pid1
# utilisateur proprietaire du processus
user = mysql
# configuration d'un second serveur
[mysqld2]
datadir=/var/lib/mysql2
socket=/var/lib/mysql2/mysql.sock2
port=3307
old_passwords=1
err-log=/var/log/mysqld2.log
pid-file=/var/run/mysqld/mysqld.pid2
user = mysql
# configuration serveur maître
[mysql.server]
user=mysql
basedir=/var/lib
Enregistrez votre fichier, c'est fini pour la configuration mysqld_multi.
V. Première utilisation▲
Passons aux choses sérieuses, nous allons mettre en route mysqld_multi.
Par défaut, le programme utilise (comme mysqld) le fichier de configuration my.cnf. Nous devons donc lui dire qu'il faut utiliser notre fichier fraîchement créé. Pour ce faire, nous nous servirons du paramètre --config-file (pour plus d'information -> man mysqld_multi)
Syntaxe d'utilisation :
mysqld_multi [options] {start|stop|report} [GNR[,GNR]...]
mysqld_multi prend comme paramètre : start, stop ou report suivi des identifiants de serveurs à démarrer. Pour rappel, ils sont repérés par le numéro placé derrière chaque intitulé [mysqldX] dans la configuration. Mais on peut aussi mettre un panel de serveurs (exemple 2-6 démarrera les serveurs 2 à 6) ou ne rien mettre, auquel cas il démarrera tous les serveurs présents dans le fichier de configuration.
Nous démarrerons les serveurs 1 et 2 (pour l'exemple)
# /usr/bin/mysqld_multi --config-file=/etc/multi_my.cnf start 1,2
Une des nombreuses particularités du système Linux est de pouvoir vérifier en temps réel le contenu d'un fichier log. Ceci est réalisé à l'aide de la commande « tail ».
Ouvrons deux terminaux, et lançons dans chacun d'entre eux une commande tail :
2.
# tail -f /var/log/mysqld1.log
# tail -f /var/log/mysqld2.log
Si tout va bien, on doit voir ceci :
Il faut à présent créer les droits dans les bases MySQL pour que l'utilisateur du programme mysqld_multi (multi_user dans notre fichier de configuration) puisse fermer les instances à son gré.
2.
# mysql -u root -S /var/lib/mysql1/mysql.sock1 -p -e "GRANT SHUTDOWN ON *.* TO multi_user@localhost IDENTIFIED BY 'mypass'"
# mysql -u root -S /var/lib/mysql2/mysql.sock2 -p -e "GRANT SHUTDOWN ON *.* TO multi_user@localhost IDENTIFIED BY 'mypass'"
Vous pouvez maintenant fermer n'importe quelle instance de serveur en tapant la commande suivante (par exemple pour arrêter le serveur 1) :
# mysqld_multi --config-file=/etc/multi_my.cnf stop 1
Vérifiez dans le terminal surveillant le fichier log :
VI. phpMyAdmin▲
Afin d'offrir aux administrateurs la possibilité de gérer agréablement leur(s) serveur(s), nous installerons également phpMyAdmin, une interface réalisée en PHP qui permet de gérer toutes les actions courantes (privilèges, projections, insertions, paramétrages, etc.) sur MySQL à travers un visuel convivial.
Vous trouverez les sources de ce programme à cette adresse :
http://www.phpmyadmin.net/home_page/
La version disponible à l'heure ou j'écris cet article est : phpMyAdmin-2.6.4-pl1.tar.bz2
Téléchargez l'archive bzip2 dans le répertoire de votre choix (exemple : /home/toto/). Placez-vous dans le répertoire web d'Apache (par défaut : /var/www/html) et décompressez l'archive.
2.
3.
# cd /var/www/html
# bzip2 -d /home/toto/phpMyAdmin-2.6.4-pl1.tar.bz2
# tar -xvvf /home/toto/phpMyAdmin-2.6.4-pl1.tar
Nous allons créer deux répertoires phpMyAdmin nommés sqladmin1 et sqladmin2 :
2.
# mv phpMyAdmin-2.6.4-pl1 sqladmin1
# cp -Rp sqladmin1 sqladmin2
Modifions le fichier sqladmin1/config.inc.php ainsi :
2.
3.
4.
5.
$cfg['PmaAbsoluteUri'] = 'http://domaine_serveur_http/sqladmin1/';
$cfg['Servers'][$i]['port'] = '3306';
$cfg['Servers'][$i]['socket'] = '/var/lib/mysql1/mysql.sock1';
$cfg['Servers'][$i]['connect_type'] = 'socket';
$cfg['Servers'][$i]['auth_type'] = 'http';
Modifions le fichier sqladmin2/config.inc.php à présent :
2.
3.
4.
5.
$cfg['PmaAbsoluteUri'] = 'http://domaine_serveur_http/sqladmin2/';
$cfg['Servers'][$i]['port'] = '3307';
$cfg['Servers'][$i]['socket'] = '/var/lib/mysql2/mysql.sock2';
$cfg['Servers'][$i]['connect_type'] = 'socket';
$cfg['Servers'][$i]['auth_type'] = 'http';
Vous pouvez maintenant vous connecter à phpMyAdmin à l'adresse suivante :
serveur 1 = http://localhost/sqladmin1/ ( root sans mot de passe )
serveur 2 = http://localhost/sqladmin2/ ( root sans mot de passe )
Profitez de l'interface pour créer un nouvel utilisateur avec mot de passe et tous les privilèges (GRANT ALL PRIVILEGES). Puis (je dirais : surtout) supprimez l'utilisateur root.
Faites attention à ne pas supprimer l'utilisateur multi_user ! Cela n'a pas de graves conséquences, mais vous ne pourriez plus arrêter l'instance de ce serveur avec la commande mysqld_multi.
Une fois les modifications de privilèges réalisées, modifiez les deux fichiers config.inc.php afin qu'ils correspondent avec le nom d'utilisateur ayant tous les privilèges.
$cfg['Servers'][$i]['user'] = 'utilisateur_admin';
Modifiez les droits sur les répertoires sqladmin pour empêcher tout accès direct aux fichiers. Seul l'utilisateur d'Apache doit pouvoir y avoir accès (dans ma config : apache) :
2.
# chown -R apache:apache /var/www/html/sqladmin1/ /var/www/html/sqladmin2/
# chmod -R go-wrx /var/www/html/sqladmin1/ /var/www/html/sqladmin2/
Puis créez un fichier .htaccess dans chaque répertoire « sqladmin » :
2.
3.
<Files config.inc.php>
Deny from all
</Files>
C'est fini pour phpMyAdmin et sa sécurité, vous pouvez dormir tranquille…
VII. Démarrage automatique au boot▲
Il ne reste plus qu'à créer un script pour automatiser le lancement des serveurs voulus au démarrage de la machine. Ouvrez à nouveau votre éditeur de texte et copiez/collez le script ci-dessous. Enregistrez-le sous /etc/init.d/multi_mysqld.
N'oubliez pas d'ajouter les références de serveurs à démarrer derrière la commande mysqld_multi si vous ne voulez en démarrer qu'une partie.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.
35.
36.
37.
38.
39.
40.
41.
42.
43.
44.
45.
46.
47.
48.
49.
50.
51.
52.
53.
54.
55.
56.
57.
58.
59.
60.
61.
62.
63.
64.
65.
66.
67.
68.
69.
70.
71.
72.
73.
74.
75.
76.
77.
78.
79.
80.
81.
82.
83.
84.
85.
86.
87.
88.
89.
90.
91.
92.
93.
94.
95.
96.
97.
98.
99.
100.
101.
102.
103.
104.
105.
106.
107.
108.
109.
110.
111.
112.
113.
114.
115.
116.
117.
118.
119.
120.
121.
122.
123.
124.
125.
126.
127.
128.
129.
130.
131.
132.
133.
134.
135.
136.
137.
138.
139.
140.
141.
142.
143.
144.
145.
146.
147.
148.
149.
150.
151.
152.
153.
154.
155.
156.
157.
158.
159.
160.
161.
162.
163.
164.
165.
166.
167.
168.
169.
170.
171.
172.
173.
174.
175.
176.
177.
178.
179.
180.
181.
182.
183.
184.
185.
186.
187.
188.
189.
190.
191.
192.
193.
194.
195.
196.
197.
198.
199.
200.
201.
202.
203.
204.
205.
206.
207.
208.
209.
210.
211.
212.
213.
214.
215.
216.
217.
218.
219.
220.
221.
222.
223.
224.
225.
226.
227.
228.
229.
230.
231.
232.
233.
234.
235.
236.
237.
238.
239.
240.
241.
242.
243.
244.
245.
246.
247.
248.
249.
250.
251.
#!/bin/bash
#
# multi_mysqld Ce script permet de demarrer ou d'arreter
# le programme MySQL (mysqld_multi).
#
# chkconfig: - 64 36
# description: MySQL database servers.
# processname: mysqld_multi
# config: /etc/multi_my.cnf
# Source function library.
. /etc/rc.d/init.d/functions
# Source networking configuration.
. /etc/sysconfig/network
# Nom du programme
prog="MySQL multi-serveurs"
# Chemin du fichier de configuration
conf="/etc/multi_my.cnf"
# Chemin du fichier de log
err_m="/var/log/multi_mysqld.log"
# deco
sep="*--------------------------------*"
test_var()
{
variable="$1"
type_rech="$2"
msg=""
if [ $type_rech = "x" ];then
msg="exécutable"
else
msg="lisible"
fi
# extraction des donnees
awk 'BEGIN{FS="="}($1 ~ /^'$variable'/){print $2;}' "$conf" | sed 's/[ \t]*//' 2>/dev/null > /tmp/.tmpfic
# test d'existence des fichiers en lecture et repertoires
retour=`awk 'function TestDir(Rep)
{
Cmd = "test -'$type_rech' " Rep ";echo $?"
Cmd|getline Result
close(Cmd)
if (Result==1) return 0
if (Result==0) return 1
print Result
}
{
if (TestDir($1)) printf "%-40s %s\n","'$variable'="$1,"OK"
else printf "%-40s %s %s\n","'$variable'="$1,"non trouvé ou non","'$msg'"
}' /tmp/.tmpfic 2>/dev/null`
echo "$retour"
}
# fonction qui verifie l'existence d'une variable de configuration
get_mysql_option()
{
result=`sed -n "s/^[ \t]*$2[ \t]*=[ \t]*//p" "$1" 2>/dev/null | tail -n 1`
if [ -z "$result" ]; then
# non trouve retourne KO
result="KO"
else
# retire les quotes et commentaires
dequoted=`echo "$result" | sed "s/^'\([^']*\)'.*$/\1/"`
if [ x"$dequoted" != x"$result" ]; then
result="$dequoted"
else
dequoted=`echo "$result" | sed 's/^"\([^"]*\)".*$/\1/'`
if [ x"$dequoted" != x"$result" ]; then
result="$dequoted"
else
result=`echo "$result" | sed 's/^\([^ \t#]*\).*$/\1/'`
fi
fi
fi
}
# teste des variables de configuration
get_mysql_option $conf datadir
datadir="$result"
get_mysql_option $conf socket
socketfile="$result"
get_mysql_option $conf err-log
errlogfile="$result"
get_mysql_option $conf pid-file
mypidfile="$result"
# fonction qui etablit le message d'erreur
get_params_ok()
{
retour=""
if [ ! -r "$1" ]; then
retour="Fichier de configuration introuvable : $1"
return -1
fi
if [ "$2" = "KO" ]; then
retour="Aucun paramètre datadir trouvé !"
return -1
fi
if [ "$3" = "KO" ]; then
retour="Aucun paramètre socket trouvé !"
return -1
fi
if [ "$4" = "KO" ]; then
retour="Aucun paramètre err-log trouvé !"
return -1
fi
if [ "$5" = "KO" ]; then
retour="Aucun paramètre pid-file trouvé !"
return -1
fi
if [ ! -d "$2" ]; then
retour="Répertoire fichiers MySQL ( datadir ) introuvable !"
return -1
fi
}
# demarrage
start()
{
# teste si au moins un serveur peut demarrer
get_params_ok $conf $datadir $socketfile $errlogfile $mypidfile
# si test ko
if [ ! -z "$retour" ]; then
# log multi_mysqld.log
touch "$err_m"
echo `LC_ALL=fr_FR date '+%A %d %B %Y %H:%M:%S'` " : $retour">>"$err_m"
echo $"Démarrage $prog: "
action $"$retour" /bin/false
return -1
fi
# execution de mysqld_multi
/usr/bin/mysqld_multi --config-file="$conf" start >/dev/null 2>&1
ret=$?
if [ $ret -eq 0 ]; then
# si tout ok
sleep 2
action $"Démarrage $prog: " /bin/true
else
# si non
action $"Démarrage $prog: " /bin/false
fi
return $ret
}
# arret
stop()
{
# teste les parametres de configuration
get_params_ok $conf $datadir $socketfile $errlogfile $mypidfile
# si test ko
if [ ! -z "$retour" ]; then
# log multi_mysqld.log
touch "$err_m"
echo `LC_ALL=fr_FR date '+%A %d %B %Y %H:%M:%S'` " : $retour">>"$err_m"
echo $"Démarrage $prog: "
action $"$retour" /bin/false
return -1
fi
# execution de mysqld_multi
/usr/bin/mysqld_multi --config-file="$conf" stop >/dev/null 2>&1
ret=$?
if [ $ret -eq 0 ]; then
# si tout ok
sleep 1
action $"Arrêt $prog: " /bin/true
else
# si non
action $"Arrêt $prog: " /bin/false
fi
return $ret
}
restart()
{
stop
start
}
config()
{
# si fichier de configuration existe
if [ ! -r "$conf" ]; then
echo "fichier de configuration introuvable : $conf"
echo $sep
action $"Lecture fichier de configuration $prog" /bin/false
else
# affichage sans les commentaires et sans espaces ni tabulations
echo $sep
echo "| Lecture fichier configuration |"
echo $sep
awk '! (/^ *#/ || /^$/) { print $0 }' "$conf" 2>/dev/null | sed 's/[ \t]*=[ \t]*/=/'
echo $sep
action $"Lecture fichier de configuration $prog" /bin/true
fi
}
config_test()
{
# si fichier de configuration existe
if [ ! -r "$conf" ]; then
echo "fichier de configuration introuvable : $conf"
echo $sep
action $"Test fichier de configuration $prog" /bin/false
else
# verification de l'existence des valeurs de chaque variable
echo $sep
echo "| Test des variables nécessaires |"
echo $sep
test_var "err-log" "r"
test_var "datadir" "d"
test_var "mysqld" "x"
test_var "mysqladmin" "x"
test_var "basedir" "d"
rm -f /tmp/.tmpfic 2>/dev/null
echo $sep
action $"Test du fichier de configuration $prog" /bin/true
fi
}
case "$1" in
start)
start
;;
stop)
stop
;;
status)
status mysqld
;;
restart)
restart
;;
config)
config
;;
config_test)
config_test
;;
*)
echo $"Usage: $0 {start|stop|status|restart|config|config_test}"
exit 1
esac
exit $?
Enregistrons-le et rendons-le exécutable.
# chmod +x /etc/init.d/multi_mysqld
À ce stade, vous n'avez plus besoin de passer par la commande /usr/bin/mysqld_multi pour gérer l'ensemble de vos serveurs. Par exemple, je veux démarrer tous mes serveurs :
# /etc/init.d/multi_mysqld start
Le script permet aussi de réaliser deux autres tâches intéressantes, le paramètre « config » affichera le contenu du fichier de configuration épuré, le paramètre « config_test » affichera le résultat du test d'existence des valeurs de variables déclarées.
J'ai trouvé pratique de pouvoir vérifier l'intégrité du fichier de configuration avant de lancer le démon, notamment lors de la création d'une nouvelle instance.
# /etc/init.d/multi_mysqld config_test
Et voici le résultat du test d'intégrité de notre fichier de configuration :
Il ne nous reste plus qu'à configurer le system V :
2.
3.
# chkconfig --add multi_mysqld
# chkconfig --level 345 multi_mysqld on
# chkconfig --level 345 mysqld off
C'est terminé. Bravo ! Vous avez maintenant deux instances de MySQL sur votre machine dès son démarrage !
VIII. Conclusion et remerciements▲
Nous tenons à remercier Maximilian pour la relecture technique, ced pour sa relecture orthographique et Malick SECK pour la mise au gabarit.