Installer à partir de l'arbre source de développement

Attention : Vous devez lire cette partie seulement si vous voulez nous aider à tester notre nouveau code. Si vous souhaitez seulement faire fonctionner MySQL sur votre système, vous devriez utiliser la distribution d'une version standard (que ce soit une distribution sous forme de sources ou de binaire).

Pour obtenir notre arbre source de développement le plus réent, suivez les instructions suivantes : Installer MySQL

1. TéléchargezBitKeeperà partir dehttp://www.bitmover.com/cgi-bin/download.cgi. Vous aurez besoin deBitkeeper2.0 ou supérieur pour accéder à notre dépôt.

2. Suivez les instructions pour l'installer.

3. Après avoir installéBitKeeper, commencez par vous déplacer dans le répertoire à partir duquel vous voulez travailler, et lancez l'une des commandes suivantes pour dupliquer la branche MySQL de votre choix :

Pour dupliquer la branche 3.23, utilisez cette commande :

shell> bk clone bk://work.mysql.com:7000 mysql-3.23

Pour dupliquer la branche 4.0, utilisez cette commande :

shell> bk clone bk://work.mysql.com:7001 mysql-4.0

Pour dupliquer la branche 4.1, utilisez cette commande :

shell> bk clone bk://work.mysql.com:7004 mysql-4.1

Pour dupliquer la branche 5.0, utilisez cette commande :

shell> bk clone bk://mysql.bkbits.net/mysql-5.0 mysql-5.0

Dans l'exemple précédent, les sources seront respectivement placées dans les dossiersmysql-3.23/,mysql-4.0/, mysql-4.1/oumysql-5.0/, de votre dossier courant.

Si vous êtes derrière un firewall et que vous ne pouvez utiliser que des connexions HTTP, vous pouvez aussi accéder à BitKeepervia HTTP.

Si vous devez utiliser un serveur proxy, assignez la variable d'environnementhttp_proxypour qu'elle pointe sur votre proxy :

shell> export http_proxy="http://your.proxy.server:8080/"

Puis, remplacez le protocolebk://parhttp://lors de votre export. Par exemple :

shell> bk clone http://mysql.bkbits.net/mysql-4.1 mysql-4.1

Le premier téléchargement de l'arbre source peut prendre un certain temps, selon la vitesse de votre connexion. Soyez patients.

4. Vous aurez besoin de GNUmake,autoconf2.53 (ou plus récent),automake1.5,libtool1.4 etm4pour lancer la prochaine série de commandes. Même si la plupart des systèmes d'exploitation sont livrés avec leur propre implémentation de make, les chances sont fortes pour que la compilation échoue avec des messages d'erreur étranges. Par conséquent, il est fortement recommandé d'utiliser GNUmake(parfois aussi appelégmake).

Heureusement, d'autres systèmes d'exploitation sont livrés avec les utilitaires GNU, ou propose des paquets facilement installables.

Dans tous les cas, vous pouvez les télécharger sur ces sites :

• http://www.gnu.org/software/autoconf/

• http://www.gnu.org/software/automake/

• http://www.gnu.org/software/libtool/

• http://www.gnu.org/software/m4/

• http://www.gnu.org/software/make/

Si vous essayez ded configurer MySQL 4.1 ou plus récent, vous aurez besoin de GNUbison1.75 ou plus récent. Les anciennes versions debisonpeuvent indiquer cette erreur :

sql_yacc.yy:#####: fatal error: maximum table size (32767) exceeded

Note : la taille maximale de la table n'est pas dépassée. L'erreur est causée par un bug dans les versions plus anciennes debison.

Les versions de MySQL avant la version 4.1 peuvent aussi se compiler avec d'autres versions deyacc(par exemple, BSDyacc 91.7.30). Pour les versions plus récentes, GNUbisonest une obligation.

Les commandes typiques nécessaires pour compiler MySQL sont présentées ci-dessous. La première commandecdchange le dossier de travail : remplacezmysql-4.0avec le bon nom de dossier.

shell> cd mysql-4.0 shell> bk -r get -Sq

shell> aclocal; autoheader; autoconf; automake;

shell> ./configure # Ajoutez ici vos options favorites shell> make

Les lignes de commande qui passent dans les dossiersinnobaseetbdb/distsont utilisées pour configurerInnoDBet Berkeley DB (BDB). Vous pouvez omettre ces lignes si vous n'avez pas besoin du supportInnoDBouBDB.

Si vous obtenez des erreurs étranges pendant cette étape, vérifiez bien que vous avez vraiment installélibtool!

Une collection de nos scripts de configuration les plus courants de trouve dans le sous-répertoireBUILD/. Si vous êtes fainéants, vous pouvez utiliserBUILD/compile-pentium-debug. Pour compiler sur une architecture différente, modifiez ce script en enlevant les drapeaux spécifiques au Pentium.

5. Quand la compilation est achevée, lancezmake install. Prenez garde sur des machines de production. Cette commande pourrait écraser votre installation actuelle. Si vous avez une autre installation de MySQL, nous vous recommandons de lancer ./configureavec des valeurs des optionsprefix,with-tcp-port, etunix-socket-pathdifférentes de celles de votre serveur de production.

6. Torturez votre nouvelle installation et tentez de faire planter les nouvelles fonctionnalités. Commencez par lancermake test.

SeeSection 27.1.2, « Suite de test de MySQL ».

7. Si vous avez échoué avec l'étapemakeet que la distribution ne compile pas, envoyez un rapport sur le sitehttp://bugs.mysql.com/.

Si vous avez installé la dernière version des indispensables outils GNU, et qu'ils échouent dans l'analyse de vos fichiers de configuration, envoyez aussi un rapport. D'autre part, si vous exécutezaclocalet que vous obtenez l'erreurcommand not foundou un problème du même type, n'envoyez pas de rapport. A la place, assurez vous que les outils nécessaires sont bien installés et que votre variablePATHest configurée de telle fa¸on que votre interpréteur de commandes les trouvent.

8. Après la première opérationbk clonepour obtenir l'arbre source, vous devez lancer régulièrementbk pullpour obtenir les mises à jour.

9. Vous pouvez examiner l'historique des changements de l'arbre avec toutes les différences en utilisantbk sccstool. Si vous apercevez des différences anormales ou sur lesquelles vous avez des questions, n'hésitez pas à envoyer un e-mail aux listes internes. SeeSection 1.4.1.1, « Les listes de diffusion de MySQL ». De même, si vous pensez avoir une meilleure méthode pour traiter un problème, envoyez un e-mail accompagné d'un patch à la même adresse.bk diffsvous fournira un patch après que vous ayez fait vos changements aux sources. Si vous n'avez pas le temps de coder votre idée, envoyez en juste une description.

10. BitKeeperdispose d'une aide agréable à laquelle vous pouvez accéder viabk helptool.

11. Veuillez noter que chaque commit (bk cioubk citool) postera un message avec un aper¸u des changements à notre liste de diffusion interne, à la fa¸on habituelle des propositions openlogging.org avec seulement les commentaires des changements.

Généralement, vous n'aurez pas besoin d'utiliser commit (l'arbre public interdisant lesbk push), mais plutôt d'utiliser la méthode bk diffsdécrite plus haut.

Vous pouvez aussi naviguer dans les fichiers d'historiques, les commentaires et le code source en ligne. Par exemple, pour lire ses informations pour MySQL 4.1, allez àhttp://mysql.bkbits.net:8080/mysql-4.1.

Le manuel est dans un module séparé, qui peut être obtenu comme ceci :

shell> bk clone bk://mysql.bkbits.net/mysqldoc mysqldoc

Il y a aussi des arbres BitKeeper pourMySQL Control CenteretConnector/ODBC. Ils sont disponibles comme ceci : Pour obtenir leMySQL Control Center, utilisez cette commande :

Installer MySQL

shell> bk clone http://mysql.bkbits.net/mysqlcc mysqlcc

Pour obtenir leConnector/ODBC, utilisez cette commande :

shell> bk clone http://mysql.bkbits.net/myodbc3 myodbc3