Vue d’ensemble de l’installation rapide

Les commandes de base que vous devez ex´ecuter pour installer MySQL `a partir des sources sont :

shell> groupadd mysql

shell> useradd -g mysql mysql

shell> gunzip < mysql-VERSION.tar.gz | tar -xvf - shell> cd mysql-VERSION

shell> ./configure --prefix=/usr/local/mysql shell> make

shell> make install

shell> scripts/mysql_install_db

shell> chown -R root /usr/local/mysql shell> chown -R mysql /usr/local/mysql/var shell> chgrp -R mysql /usr/local/mysql

shell> cp support-files/my-medium.cnf /etc/my.cnf shell> /usr/local/mysql/bin/safe_mysqld --user=mysql & ou

shell> /usr/local/mysql/bin/mysqld_safe --user=mysql & si vous utilisez MySQL 4.x.

Si vous voulez avoir le support des tables InnoDB, vous devez ´editer le fichier /etc/my.cnf et enlever le caract`ere # avant le param`etre qui commence par innodb_.... Voir Section 4.1.2 [Option files], page 198, et Section 7.5.2 [InnoDB start], page 545.

Si vous utilisez un fichier RPM source, faites :

shell> rpm --rebuild MySQL-VERSION.src.rpm

Cela produira un fichier RPM binaire que vous pourrez installer.

Vous pouvez ajouter des utilisateurs en lan¸cant le script bin/mysql_setpermission si vous installez les modules Perl DBI et Msql-Mysql-modules.

Ci-dessous, une description plus d´etaill´ee.

Pour installer MySQL `a partir des sources, suivez ces ´etapes et proc´edez `a Section 2.4 [Post-installation], page 97, pour la configuration et les tests cons´ecutifs `a l’installation :

1. Notez le r´epertoire o`u vous voulez d´ecompacter les sources et d´eplacez vous y.

2. R´ecup´erez une distribution des sources `a partir d’un des sites list´es sur Section 2.2.2 [Getting MySQL], page 73.

3. Si vous souhaitez utiliser les tables Berkeley DB avec MySQL, vous devez obtenir une version modifi´ee du code source de Berkeley DB. Veuillez lire le chapitre relatif aux tables Berkeley DB avant de proc´eder. Voir Section 7.6 [BDB], page 585.

Les distributions des sources MySQL sont fournies sous forme d’archive tar com- press´ees et ont des noms comme ‘mysql-VERSION.tar.gz’, o`u VERSION est un nombre comme 5.0.0-alpha.

4. Ajoutez un utilisateur et un groupe avec les droits desquels mysqld fonctionnera : shell> groupadd mysql

shell> useradd -g mysql mysql

Ces commandes ajoutent le groupe mysql group et l’utilisateur mysql. La syntaxe de useradd et de groupadd peut varier de fa¸con significative suivant les versions d’Unix. Elles peuvent aussi s’appeler adduser et addgroup. Vous pouvez aussi souhaiter nom- mer le groupe et l’utilisateur autrement que mysql.

5. D´ecompressez la distribution dans le r´epertoire courant :

shell> gunzip < /path/to/mysql-VERSION.tar.gz | tar xvf - Cette commande cr´ee un r´epertoire nomm´e ‘mysql-VERSION’.

6. D´eplacez-vous dans le r´epertoire racine de la distrbution d´ecompress´ee : shell> cd mysql-VERSION

Notez bien que vous devez alors configurer et compiler MySQL depuis ce r´epertoire racine. Vous ne pouvez pas le compiler `a partir d’un autre r´epertoire.

7. Configurez votre version et compilez tout :

shell> ./configure --prefix=/usr/local/mysql shell> make

Quand vous lancez la commande configure, vous pouvez sp´ecifier quelques options. Lancez ./configure --help pour une liste des options disponibles. La partie Sec- tion 2.3.3 [les options de configure ], page 88, traite des options les plus utiles. Si configure ´echoue, et que vous ˆetes sur le point d’envoyer un mail `a mysql@lists.mysql.com pour demander de l’aide, ajoutez s’il vous plait les quelques

lignes de ‘config.log’ qui pourraient selon vous aider `a r´esoudre le probl`eme. Ajoutez aussi les deux derni`eres lignes de sortie de configure si configure s’arrˆete pr´ecipitemment. Envoyez le rapport de bogue en utilisant le script mysqlbug. Voir Section 1.6.2.3 [Bug reports], page 27.

Si la compilation ´echoue, r´ef´erez-vous `a Section 2.3.5 [Compilation problems], page 92 pour de l’aide sur les probl`emes les plus courants.

8. Installez tout :

shell> make install

Vous aurez certainement besoin de lancer cette commande en tant que root.

9. Cr´eez les tablees de gestion des droits MySQL (ceci est n´ecessaire uniquement si vous n’avez pas install´e MySQL auparavant):

shell> scripts/mysql_install_db

Veuillez noter que les versions de MySQL ant´erieures `a la version 3.22.10 d´emarraient le serveur MySQL quand vous ex´ecutiez mysql_install_db. Ce n’est plus le cas! 10. Nommez root en tant que propri´etaire des binaires et l’utilisateur avec les droits duquel

vous ferez fontionner mysqld comme propri´etaire du r´epertoire de donn´ees : shell> chown -R root /usr/local/mysql

shell> chown -R mysql /usr/local/mysql/var shell> chgrp -R mysql /usr/local/mysql

La premi`ere commande change les attributs owner en faveur de l’utilisateur root, la seconde change les attributs owner du r´epertoire de donn´ees en faveur de l’utilisateur mysql, et la troisi`eme change les attributs group en faveur du groupe mysql.

11. Si vous voulez installer le support de l’interface Perl DBI/DBD, r´ef´erez-vous `a Section 2.7 [Perl support], page 148.

12. Si vous souhaitez que MySQL se lance automatiquement au d´emarrage de votre ma- chine, vous pouvez copier support-files/mysql.server `a l’endroit o`u votre syst`eme stocke ses fichiers de d´emarrage. Davantage d’informations sont disponibles dans le script support-files/mysql.server lui-mˆeme et dans Section 2.4.3 [Automatic start], page 104.

Apr`es que tout soit install´e, vous devez initialiser et tester votre distribution : shell> /usr/local/mysql/bin/safe_mysqld --user=mysql &

Si cette commande ´echoue imm´ediatement sur un mysqld daemon ended, vous pouvez trou- vez des informations dans le fichier ‘mysql-data-directory/’hostname’.err’. La raison la plus courante est que vous avez d´ej`a un autre serveur mysqld qui fonctionne. Voir Sec- tion 4.1.4 [Multiple servers], page 202.

Proc´edez maintenant `a la Section 2.4 [Post-installation], page 97.