Sommaire 27 Historique des changements MySQL
2.3 Installation de MySQL avec une distribution source
2.3.6 La distribution source Windows
Ces instructions décrivent comment compiler MySQL version 4.1, depuis les sources, pour
Windows. Les instructions sont fournies pour compiler les versions standards à partir des sources standards, ou depuis la version de développement de BitKeeper.
Note : :es instructions de ce document sont strictement destinées aux utilisateurs qui veulent tester
MySQL sur Windows, à partir des toutes dernières sources de BitKeeper. Pour un serveur de production, MySQL vous recommande de ne pas compiler votre serveur vous−même.
Normalement, il est mieux d'utiliser une distribution binaire précompilée, et optimisée pour
l'utilisation sur Windows par MySQL AB. Les instructions d'installation pour les distributions binaires sont disponibles dans la section Installer MySQL sous Windows .
Pour compiler MySQL sur Windows depuis les sources, vous avez besoin des logiciels et ressources suivantes sur votre système :
Le compilateur VC++ 6.0
(mis à jour avec le service pack 4 ou 5
, et paquet pre−processeur) Le paquet pre−processeur est nécessaire pour l'assembleur macro. Plus de détails à : http://msdn.microsoft.com/vstudio/downloads/updates/sp/vs6/sp5/faq.aspx .
•
Environs 45 Mo d'espace disque.
•
64 Mo de RAM
•
Vous aurez besoin de la distribution source MySQL pour Windows. Il y a deux méthodes pour obtenir cette distribution pour MySQL 4.1 et supérieur :
Télécharger une distribution source préparée par MySQL AB pour la version de MySQL que vous voulez. Les distributions sources pre−compilées sont disponibles pour les versions de MySQL publiées, et sont accessibles sur le site de http://www.mysql.com/downloads/ .
•
Vous pouvez préparer votre propre distribution source vous−même, avec la dernière version disponible sur le serveur BitKeeper. Si vous voulez faire cela, vous devez créer la
distribution sur un serveur Unix, et transférer l'archive sur votre système Windows. La raison est que certaines étapes de configuration requièrent des outils qui ne fonctionnent que sous Unix. L'approche BitKeeper requiert :
Un système fonctionnant sous Unix, ou un système équivalent, comme Linux.
♦
BitKeeper 3.0 sur ce système. Vous pouvez obtenir BitKeeper sur http://www.bitkeeper.com/ .
♦ •
Si vous utilisez une distribution source Windows vous pouvez passer directement à Compiler MySQL avec VC++ . Pour compiler depuis les sources BitKeeper, commencez par Créer une distribution MySQL pour Windows avec les dernières sources .
Si vous découvrez quelque chose qui ne fonctionne pas comme prévu, ou si vous avez des
suggestions pour améliorer le processus actuel envoyez un message à la liste de diffusion dédiée à
win32
. Les listes de diffusion MySQL .
2.3.6.1 Compiler MySQL avec VC++ Note: Les fichiers du projet VC++
de MySQL 4.1 et plus récent sont compatibles avec Microsoft Visual Studio 6.0
et plus récent (7.0/.NET) et sont testés par l'équipe de MySQL AB avant chaque publication.
Pour compiler MySQL, suivez ces instructions ci−dessous. Notez que les noms de menus sont laissés en anglais, et devront éventuellement être adaptés à votre interface.
Créez un dossier de travail : par exemple, workdir
.
•
Décompressez la distribution source dans le dossier ci−dessus, en utilisant WinZip
ou un autre utilitaire Windows qui sache lire les fichiers .zip
.
•
Lancez le compilateur VC++ 6.0.
•
Dans le menu File
, sélectionnez Open Workspace
.
•
Ouvrez le fichier mysql.dsw
que vous trouverez dans le dossier de travail.
•
Dans le menu Build
, sélectionnez le menu Set Active Configuration
.
•
Cliquez dans le dialogue pour sélectionner mysqld − Win32 Debug
, puis cliquez sur OK.
•
Pressez F7
pour lancer la compilation du serveur de débogage, des bibliothèques et des applications clients.
•
Compilez la version que vous souhaitez, de la même façon.
•
Les versions de débogage et les bibliothèques sont placées dans les dossiers client_debug
et
lib_debug
. Les versions finales des programmes et bibliothèques sont placées dans les dossiers client_release
et lib_release
. Notez que si vous voulez compiler les versions de débogage et finales, vous pouvez utiliser l'option `` build all
'' dans le menu Build
.
•
Testez le serveur. Le serveur compilé avec les instructions suivantes suppose que le dossier de base MySQL et le dossier de données sont situés dans les dossiers C:\mysql
et
C:\mysql\data
, par défaut. Si vous voulez tester votre serveur, utilisez le chemin de votre dossier d'installation comme chemin racine. Vous pouvez faire cela en ligne de commande, avec les options −−basedir
et −−datadir
ou bien placez les bonnes options dans le fichier d'options ( C:\my.cnf
ou my.ini
de votre dossier Windows). Si vous avez un dossier de données sur votre disque, vous pouvez spécifier son chemin.
•
Lancez le serveur depuis le dossier client_release
ou client_debug
, suivant la version que vous voulez utiliser. Les instructions générales de lancement sont dans Installer MySQL sous Windows . Vous devrez adapter les instructions à votre configuration, si vous avez un dossier de base ou de données différents.
•
Lorsque le serveur fonctionne en mode indépendant ou comme un service, suivant votre configuration, essayez de vous connecter avec le client interactif mysql
, qui est placé dans le dossier client_release
ou client_debug
.
•
Lorsque vous êtes satisfait du fonctionnement de votre serveur, stoppez le. Puis installez MySQL comme ceci :
Créez un dossier sur votre disque pour installer MySQL. Par exemple, nous pourrions l'installer dans C:\mysql
. Voici les commandes :
C: mkdir \mysql mkdir \mysql\bin mkdir \mysql\data mkdir \mysql\share mkdir \mysql\scripts
Si vous voulez compiler d'autres clients et les lier à MySQL, il faudra créer d'autres dossiers :
mkdir \mysql\include mkdir \mysql\lib mkdir \mysql\lib\debug mkdir \mysql\lib\opt
Si vous voulez tester les performances de MySQL, créez ce dossier :
mkdir \mysql\sql−bench
Les tests de performances requièrent Perl.
•
Depuis le dossier workdir
, copiez dans le dossier C:\mysql
les fichiers suivants :
copy client_release\*.exe C:\mysql\bin
copy client_debug\mysqld.exe C:\mysql\bin\mysqld−debug.exe xcopy scripts\*.* C:\mysql\scripts /E
xcopy share\*.* C:\mysql\share /E
Si vous voulez compiler d'autres clients, et les lier avec MySQL, vous devrez aussi faire ceci :
copy lib_debug\mysqlclient.lib C:\mysql\lib\debug copy lib_debug\libmysql.* C:\mysql\lib\debug copy lib_debug\zlib.* C:\mysql\lib\debug copy lib_release\mysqlclient.lib C:\mysql\lib\opt copy lib_release\libmysql.* C:\mysql\lib\opt
•
copy lib_release\zlib.* C:\mysql\lib\opt copy include\*.h C:\mysql\include
copy libmysql\libmysql.def C:\mysql\include
Si vous voulez tester les performances de MySQL, faites aussi ceci :
xcopy sql−bench\*.* C:\mysql\bench /E
Puis lancez votre serveur de la même façon que vous lancez l'exécutable MySQL classique. Installer MySQL sous Windows .
2.3.6.2 Compiler MySQL sur Windows à partir des sources de développement
Pour compiler la dernière version Windows à partir de sources disponibles dans le serveur
BitKeeper, suivez les instructions suivantes. Notez que ces commandes doivent être exécutés sur un système fonctionnant sous Unix ou Linux. La procédure fonctionne très bien sous Linux, par exemple.
Clonez les source issues de BitKeeper (version 4.1 ou plus récent). Pour plus d'informations sur comment cloner les sources sont disponibles dans la section Installer à partir des
sources de l'arbre de développement .
•
Configurez et compilez la distribution pour obtenir un serveur fonctionnel. Pour cela, vous pouvez lancez la commande suivante à la racine de vos sources :
shell> ./BUILD/compile−pentium−max
•
Après vous être assurés que le processus est complet et réussi, lancez l'utilitaire suivant depuis la racine de vos sources :
shell> ./scripts/make_win_src_distribution
Ce script crée un paquet source Windows, qui peut être utilisé sur votre système. Vous pouvez passer d'autres options à ce script, suivant vos besoins. Il accepte les options suivantes : Par défaut, make_win_src_distribution
crée une archive zippée avec le nom
mysql−VERSION−win−src.zip
, où VERSION
représente la version de votre source MySQL.
•
Copiez ou téléchargez le paquet sur votre machine Windows. Pour le compiler, suivez les instructions de la section Compiler MySQL avec VC++ .
•