Attachment 79506 Details for Bug 122470 – XML file containing the guide

XML file containing the guide

mysql-upgrade-slotted.xml (text/plain), 9.94 KB, created by Bertrand on 2006-02-11 09:13:49 UTC

(hide)

Description:

Filename:

MIME Type:

Creator: Bertrand

Created: 2006-02-11 09:13:49 UTC

Size: 9.94 KB

patch

obsolete

><?xml version='1.0' encoding="UTF-8"?>
><!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
>
>
><guide link="/doc/fr/mysql-upgrade-slotted.xml" lang="fr">
><title>Guide de migration et de mise Ã  jour vers MySQL en Slot</title>
>
><author title="Auteur">
> <mail link="vivo@gentoo.org">Francesco Riosa</mail>
></author>
><author title="Correcteur">
> <mail link="chriswhite@gentoo.org">Chris White</mail>
></author>
><author title="Correcteur">
> <mail link="jkt@gentoo.org">Jan KundrÃ¡t</mail>
></author>
><author title="Correcteur">
> <mail link="jackdark@gmail.com">Joshua Saddler</mail>
></author>
><author title="Traducteur">
> <mail link="koppatroopa@yahoo.fr">Bertrand Coppa</mail>
></author>
><abstract>
>Ce document dÃ©crit la procÃ©dure Ã  suivre pour mettre Ã  jour vers les versions
>slottÃ©es de MySQL. Son objectif est de rendre la mise Ã  jour le plus agrÃ©able
>possible.
></abstract>
>
>
>
><license/>
>
><version>3</version>
><date>2006-02-02</date>
>
><chapter>
><title>Mettre Ã  jour une ancienne installation de MySQL</title>
><section>
><body>
>
>
>Ce document couvre la derniÃ¨re version de MySQL disponible. Il y a actuellement
>trois versions supportÃ©es de MySQL dans Portage&nbsp;:
>
>
><ul>
> <li>
> 5.0, qui suit les sorties officielles dans l'arbre stable et qui est
>activement maintenue.
> </li>
> <li>
> 4.1, qui suit les sorties officielles en implÃ©mentant les correctifs
>majeurs de bogues et de sÃ©curitÃ©, mais rien de nouveau n'est ajoutÃ©.
> </li>
> <li>4.0, qui contient seulement des corrections de sÃ©curitÃ©.</li>
></ul>
>
>
>Il y en a deux autres, mais qui ne sont pas supportÃ©es. Cela signifie qu'il
>peut leur manquer des fonctionnalitÃ©s et que les rapports de bogues ont une
>prioritÃ© trÃ¨s faible. Ce document n'a aucune garantie de fonctionnement avec
>les versions suivantes&nbsp;:
>
>
><ul>
> <li>3.23, qui a Ã©tÃ© dÃ©prÃ©ciÃ©e.</li>
> <li>5.1, qui est actuellement en dÃ©veloppement trÃ¨s actif.</li>
></ul>
>
><note>
><c>mysql-4.0.26</c> sera utilisÃ© comme point de dÃ©part et
><c>mysql-5.0.18-r30</c> comme version cible. Remplacez-les par vos versions.
></note>
>
></body>
></section>
></chapter>
>
>
><chapter id="install_the_new_version">
><title>Installer la nouvelle version</title>
><section>
><body>
>
>
>Cette Ã©tape demandera de dÃ©placer ou d'effacer certains fichiers de
>de l'environnement en cours, donc la premiÃ¨re chose Ã  faire est de sauvegarder
>les serveurs de base de donnÃ©es, pas les donnÃ©es. Une fois fait, il est
>possible d'effacer les fichiers en conflit avec le MySQL slottÃ© et d'installer
>la nouvelle version en parallÃ¨le de celle dÃ©jÃ  prÃ©sente.
>
>
><pre caption="Sauvegarder l'ancienne version et prÃ©parer l'installation">
># quickpkg dev-db/mysql
># rm -rf /usr/include/mysql /usr/bin/mysql_config
># for tmpfile in /usr/lib/*mysql* 
> do
> mv "${tmpfile}" "${tmpfile}.TMP"
> ln -s "${tmpfile}.TMP" "${tmpfile}"
> done
># emerge -av =dev-db/mysql-5.0.18-r30
></pre>
>
>
>Assurez-vous de bien lancer <c>etc-update</c> ou <c>dispatch-conf</c> afin de
>mettre Ã  jour le script de dÃ©marrage <path>/etc/init.d/mysql</path>.
>
>
></body>
></section>
></chapter>
>
><chapter>
><title>Copier les donnÃ©es vers le nouveau serveur</title>
><section>
><body>
>
>
>Maintenant, nous allons transfÃ©rer les donnÃ©es. Elles seront importÃ©es dans la
>nouvelle version de MySQL. <c>mysqldump</c> sera utilisÃ© depuis la version
>slottÃ©e de MySQL. Remarquez le suffixe <c>-500</c> au nom du programme
>de <c>mysqldump</c>. Cela signifie qu'il vient de la version 5.0.x.
>
>
><impo>
>Si vous effectuez une mise Ã  jour de rÃ©vision (par exemple, de
><c>dev-db/mysql-5.0.18</c> Ã  <c>dev-db/mysql-5.0.18-r30</c>), vous pouvez
>simplement arrÃªter la base de donnÃ©es, changer de rÃ©pertoire de donnÃ©es et
>relancer le serveur. Vous pouvez donc sauter toute cette partie.
></impo>
>
><pre caption="Transfert de toutes les bases de donnÃ©es">
># mysqldump-500 \
> --defaults-file=/etc/mysql/my.cnf \
> --user=root \
> <comment>(Remplacez 'your_password' avec votre mot de passe administrateur de
>MySQL)</comment>
> --password='your_password' \
> --host=localhost \
> --all-databases \
> --opt \
> --allow-keywords \
> --flush-logs \
> --hex-blob \
> --master-data \
> --max_allowed_packet=16M \
> --quote-names \
> --result-file=BACKUP_MYSQL_4.0.SQL
></pre>
>
>
>Un fichier nommÃ© <path>BACKUP_MYSQL_4.0.SQL</path> sera crÃ©Ã©, qui pourra servir
>Ã  recrÃ©er les donnÃ©es. Les donnÃ©es sont stockÃ©es dans le langage SQL de MySQL,
>le Structured Query Language.
>
>
>
>Lancez le serveur sans rÃ©seau ni gestion des utilisateurs et lancez le script
>SQL&nbsp;:
>
>
><pre caption="Recharger les donnÃ©es">
># mv /etc/conf.d/mysql /etc/conf.d/mysql.orig
># cat &lt;&lt;- EOF &gt; /etc/conf.d/mysql
> NOCHECK=1
> DEBUG=3
> mysql_slot_500=(
> "skip-networking"
> "skip-grant-tables"
> "socket=/tmp/mysqld.sock"
> )
> EOF
># /etc/init.d/mysql start
># mysql-500 --defaults-file=/etc/mysql-500/my.cnf --socket=/tmp/mysqld.sock &lt; BACKUP_MYSQL_4.0.SQL
># /etc/init.d/mysql stop
># mv /etc/conf.d/mysql.orig /etc/conf.d/mysql
></pre>
>
><note>
>Pour convertir les donnÃ©es en UTF-8 au passage, il <e>faut</e> enlever l'option
><c>--hex-blob</c> de la commande <c>mysqldump</c> puis filtrer les donnÃ©es Ã 
>l'aide d'un convertisseur comme <c>iconv</c>. Dans la plupart des cas, cela se
>fait simplement en faisant un Â«&nbsp;pipe&nbsp;Â»&nbsp;: <c>iconv -f ISO_8859-1
>-t UTF8 BACKUP_MYSQL_4.0.SQL | mysql-500
>--defaults-file=/etc/mysql-500/my.cnf</c>. Des ajustements manuels au fichier SQL
>peuvent Ãªtre nÃ©cessaires selon la structure et les donnÃ©es contenues.
></note>
>
>
>S'il y des applications qui travaillent toujours avec l'ancienne base de
>donnÃ©es, il est possible de crÃ©er une relation de Â«&nbsp;rÃ©plication&nbsp;Â»
>entre les deux bases. Cependant, ce document ne couvre pas cette procÃ©dure.
>
>
></body>
></section>
></chapter>
>
><chapter>
><title>Migrer vers le nouveau serveur</title>
><section>
><body>
>
>
>Veuillez tester vos applications avec le serveur fraÃ®chement installÃ© pour vous
>assurer qu'elles fonctionnent bien avec. Souvent, ces applications ont une
>option de configuration pour choisir quel port ou socket utiliser lors de la
>connexion au serveur de base de donnÃ©es. Lancez le serveur sur un autre port
>(3307 par exemple) et dites Ã  vos applications (ou une copie d'essai) de se
>connecter avec ces paramÃ¨tres. Veuillez remarquer que la plupart des
>applications essaieront d'utiliser les paramÃ¨tres spÃ©cifiÃ©s dans la section
><c>[client]</c> du fichier de configuration <path>/etc/mysql/my.cnf</path>.
>
>
>
>Avant que vous changiez pour le nouveau serveur MySQL, il vous faudra ajuster
>la variable suivante dans <path>/etc/conf.d/mysql</path>. Sa valeur peut Ãªtre
>vide&nbsp;:
>
>
><pre caption="Ajuster la variable mysql_slot_500">
># nano -w /etc/conf.d/mysql
><comment>(Ajoutez la ligne suivante&nbsp;:)</comment>
>mysql_slot_500=( )
></pre>
>
>
>Une fois que vous Ãªtes satisfait des rÃ©sultats, effacez tous les paramÃ¨tres
>d'essai, arrÃªtez l'ancien serveur et lancez le nouveau&nbsp;:
>
>
><pre caption="Utiliser le nouveau serveur">
># killall mysqld
># /etc/init.d/mysql stop zap start
></pre>
>
>
>Ensuite, dÃ©sinstallez l'ancienne version et faites de la nouvelle celle par
>dÃ©faut. La commande de dÃ©sinstallation ne pourra pas effacer certains fichiers
>tels que ceux que nous avons dÃ©placÃ©s dans la <uri
>link="#install_the_new_version">liste de commandes 2.1</uri>. 
>Ceci est voulu et a pour but de protÃ©ger les applications directement liÃ©es Ã 
>l'ancienne version de MySQL.
>
>
><pre caption="Nettoyer l'ancienne version">
># emerge --unmerge --pretend mysql
># emerge --unmerge =dev-db/mysql-4.0.26
># cd /etc
># mv mysql mysql.$(date +%F_%H-%M)
># rm -rf /usr/lib/*.TMP
># for i in /usr/lib/*mysql* 
> do
> [[ -z "$( readlink -f $i )" ]] &amp;&amp; [[ -L $i ]] &amp;&amp; rm $i
> done
>
><comment>(Installez app-admin/eselect-mysql si ce n'est pas dÃ©jÃ  fait)</comment>
># eselect mysql list
># eselect mysql set 1
># eselect mysql show
></pre>
>
></body>
></section>
></chapter>
>
><chapter>
><title>Recompiler les applications</title>
><section>
><body>
>
>
>Une fois l'ancienne version de MySQL retirÃ©e, vous pouvez installer la
>nouvelle. Notez que l'outil <c>revdep-rebuild</c> du paquet
><c>app-portage/gentoolkit</c> est nÃ©cessaire pour recompiler les paquets qui
>sont liÃ©s avec MySQL.
>
>
><pre caption="Recompiler les dÃ©pendances inverses">
># revdep-rebuild --soname libmysqlclient.so.12 -- -p -v
># revdep-rebuild --soname libmysqlclient.so.12
></pre>
>
><note>
>Selon l'ancienne version de MySQL, la version de <path>libmysqlclient.so</path>
>peut Ãªtre <c>10</c>, <c>12</c>, <c>14</c> ou <c>15</c>. Choisissez celle qui
>correspond Ã  votre version du <e>vieux</e> paquet.
></note>
>
></body>
></section>
></chapter>
>
><chapter>
><title>Touches finales</title>
><section>
><body>
>
><pre caption="Mettre Ã  jour la base de donnÃ©es des utilisateurs">
><comment>(Remplacez toutes les occurrences de 'your_password' avec votre mot
>de passe administrateur de MySQL)</comment>
># mysql_fix_privilege_tables-500 \
> --defaults-file=/etc/mysql-500/my.cnf \
> --user=root \
> --password='your_password'
># mysql -uroot -p'your_password' mysql -e "FLUSH PRIVILEGES;"
># for tbl in $( mysql --silent -uroot -p'your_password' -e 'USE mysql ; SHOW TABLES LIKE "help%";' )
> do
> mysql -uroot -p'your_password' -e "use mysql ; TRUNCATE TABLE ${tbl};"
> done
># mysql -uroot -p'your_password' mysql &lt; /usr/share/mysql/fill_help_tables.sql
></pre>
>
>
>Si vous rencontrez des problÃ¨mes lors du processus de mise Ã  jour, veuillez
>remplir <uri link="https://bugs.gentoo.org">rapport de bogue</uri>. Merci.
>
>
></body>
></section>
></chapter>
>
></guide>

Actions: View

Attachments on bug 122470: 79506 | 79507