Attachment 78760 Details for Bug 120222 – mysql-upgrade-slotted.xml

mysql-upgrade-slotted.xml

mysql-upgrade-slotted.xml (text/plain), 9.88 KB, created by Stefano Pacella (RETIRED) on 2006-02-02 15:07:39 UTC

(hide)

Description:

Filename:

MIME Type:

Creator: Stefano Pacella (RETIRED)

Created: 2006-02-02 15:07:39 UTC

Size: 9.88 KB

patch

obsolete

><?xml version='1.0' encoding="UTF-8"?>
><!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
>
>
><guide link="/doc/it/mysql-upgrade-slotted.xml" lang="it">
><title>Guida per l'aggiornamento e il passaggio a versioni MySQL affiancate multiple</title>
>
><author title="Autore">
>	<mail link="vivo@gentoo.org">Francesco Riosa</mail>
></author>
><author title="Redazione">
> <mail link="chriswhite@gentoo.org">Chris White</mail>
></author>
><author title="Redazione">
> <mail link="jkt@gentoo.org">Jan KundrÃ¡t</mail>
></author>
><author title="Redazione">
> <mail link="jackdark@gmail.com">Joshua Saddler</mail>
></author>
><author title="Revisione">
> Team italiano
></author>
>
><abstract>
>Questo documento descrive il percorso di aggiornamento alla versione "slotted" di
>MySQL, e cerca di renderlo piÃ¹ semplice possibile.
></abstract>
>
>
>
><license/>
>
><version>3</version>
><date>2006-02-02</date>
>
><chapter>
><title>Aggiornamento delle versioni precedenti di MySQL</title>
><section>
><body>
>
>
>Questo documento spiega come aggiornare MySQL alla piÃ¹ recente versione
>disponibile. Attualmente ci sono tre versioni di MySQL supportate in
>Portage:
>
>
><ul>
>	<li>
>		5.0 segue i rilasci del progetto madre nel tree stabile e Ã¨ mantenuto
>		attivamente
>	</li>
>	<li>
>		4.1 segue i rilasci del progetto madre con in piÃ¹ la implementazione dei
>		maggiori bugfix e degli aggiornamenti di sicurezza, e non sono aggiunte
>		nuove caratteristiche
>	</li>
>	<li>
>	 4.0 contiene solamente aggiornamenti riguardanti la sicurezza
>	</li>
></ul>
>
>
>Ci sono due versioni addizionali attualmente ma non sono supportate. Con
>questo si intende che i bug riportati verranno corretti con una prioritÃ 
>molto bassa e possono mancare funzionalita'. Il funzionamento di questo
>documento non Ã¨ garantito con le seguenti versioni:
>
>
><ul>
>	<li>3.23 deprecata</li>
>	<li>5.1 attualmente in sviluppo</li>
></ul>
>
><note>
>Di seguito si farÃ  riferimento a un sistema che abbia inizialmente installato
><c>mysql-4.0.26</c> e si voglia aggiornarlo alla versione
><c>mysql-5.0.18-r30</c>. Sostituire le versioni menzionate con quelle
>volute.
></note>
>
></body>
></section>
></chapter>
>
>
><chapter id="install_the_new_version">
><title>Installare la nuova versione</title>
><section>
><body>
>
>
>Questo passo richiede di (ri)muovere alcuni file dall'ambiente di produzione,
>quindi la prima cosa da fare Ã¨ archiviare una copia del <e>server</e> corrente, (si
>tralasciano i dati per ora). Fatto questo, Ã¨ possibile rimuovere i file che
>creerebbero un conflitto con la versione "slotted" di MySQL, quindi verrÃ 
>installata una versione che si affianchi a quella corrente.
>
>
><pre caption="Archiviare il vecchio server e installare il nuovo">
># 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>
>
>
>Assicurarsi di aggiornare lo script di avvio <path>/etc/init.d/mysql</path>
>utilizzando <c>etc-update</c> o <c>dispatch-conf</c>.
>
>
></body>
></section>
></chapter>
>
><chapter>
><title>Copiare i dati nel server appena installato</title>
><section>
><body>
>
>
>Si inizia con l'esportare i dati, questi verranno importati nella nuova
>versione di MySQL. Si utilizza <c>mysqldump</c> dalla versione
>slotted di MySQL. Notare il suffisso -500 al nome del
>programma <c>mysqldump</c>, Ã¨ ricavato dalla versione 5.0.x .
>
>
><impo>
>Se si sta aggiornando tra versioni e revisioni, per esempio da
><c>dev-db/mysql-5.0.18</c> a <c>dev-db/mysql-5.0.18-r30</c>, si puÃ² stoppare
>il database, spostare la directory dati a quella della versione nuova, e far
>ripartire il server. CiÃ² permette di saltare questa sezione.
></impo>
>
><pre caption="Esportazione dei database">
># mysqldump-500 \
> --defaults-file=/etc/mysql/my.cnf \
> --user=root \
> <comment>(Sostituire 'your_password' con la propria password di root 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>
>
>
>E' stato creato un file chiamato <path>BACKUP_MYSQL_4.0.SQL</path>, che puÃ²
>essere usato per ricreare i dati. I dati sono descritti nel dialetto SQL di
>MySQL, ossia lo "Structured Query Language".
>
>
>
>Avviare il server senza connettivitÃ  di rete e senza utilizzare il controllo
>degli utenti, e quindi eseguire lo script SQL:
>
>
><pre caption="Caricare i dati">
># 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>
>Per convertire i dati alla codifica UTF-8 in questa fase Ã¨ <e>necessario</e>
>rimuovere l'opzione <c>--hex-blob</c> dal comando <c>mysqldump</c>, quindi
>"filtrare" i dati tramite un convertitore come <c>iconv</c>. In molti casi
>questo si ottiene con un "piping" (accodamento dell'i/o dei programmi) come:
><c>iconv -f ISO_8859-1 -t UTF8 BACKUP_MYSQL_4.0.SQL | mysql-500
>--defaults-file=/etc/mysql-500/my.cnf</c>. Tuttavia puÃ² essere necessario
>modificare manualmente lo script SQL, a seconda della sua struttura e dei
>dati ivi contenuti.
></note>
>
>
>Se esistono applicazioni che continuano a <e>scrivere</e> sul database
>precedente, Ã¨ possibile impostare una relazione di replicazione (replication
>setup) dei dati tra i due database. Tuttavia questo non verrÃ  trattato in
>questa sede.
>
>
></body>
></section>
></chapter>
>
>
><chapter>
><title>Passare al nuovo server</title>
><section>
><body>
>
>
>Per essere sicuri che le applicazioni interagiscano correttamente con il
>server appena installato, fare delle prove. Praticamente qualsiasi
>applicazione legge delle impostazioni di configurazione nelle quali Ã¨
>possibile specificare quale "porta" di rete oppure quale "socket" utilizzare
>per connettersi al database server. Semplicemente, eseguire il server su una
>porta alternativa (ad esempio 3307) e impostare la propria applicazione (o
>una copia di essa) per connettersi con i paramentri voluti. Prestare
>attenzione al fatto che molte applicazioni cercheranno di leggere la sezione
><c>[client]</c> del file <path>/etc/mysql/my.cnf</path>.
>
>
>
>Prima di passare al nuovo server MySQL, si deve impostare la seguente
>variabile in <path>/etc/conf.d/mysql</path>. Il suo valore potrebbe essere
>vuoto:
>
>
><pre caption="Ipostare la variabile mysql_slot_500">
># nano -w /etc/conf.d/mysql
><comment>(Add the following line:)</comment>
>mysql_slot_500=( )
></pre>
>
>
>Quando si Ã¨ soddisfatti dei risultati, si possono rimuovere le impostazioni
>di test, fermare il vecchio server e fare ripartire il nuovo:
>
>
><pre caption="Utilizzare il nuovo server">
># killall mysqld
># /etc/init.d/mysql stop zap start
></pre>
>
>
>Dis-installare la vecchia versione e rendere di default quella nuova. Il
>comando "unmerge" non sara' in grado di rimuovere alcuni file, come quelli
>spostati precedentemente in <uri link="#install_the_new_version">Installare
>la nuova versione</uri>. Questo Ã¨ un comportamento voluto, e scongiura il
>malfunzionamento di applicazioni connesse alla vecchia versione di MySQL.
>
>
><pre caption="Cancellare la vecchia versione">
># 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>(emergere app-admin/eselect-mysql se non lo si ha giÃ  fatto)</comment>
># eselect mysql list
># eselect mysql set 1
># eselect mysql show
></pre>
>
></body>
></section>
></chapter>
>
>
><chapter>
><title>Re-installare le applicazioni</title>
><section>
><body>
>
>
>Una volta rimosso il vecchio MySQL, si possono re-installare i pacchetti che
>lo utilizzano. Notare che per trovare e reinstallare i pacchetti Ã¨ necessario
>il programma <c>revdep-rebuild</c> fornito da
><c>app-portage/gentoolkit</c>.
>
>
><pre caption="Ricostruzione dipendenze inverse">
># revdep-rebuild --soname libmysqlclient.so.12 -- -p -v
># revdep-rebuild --soname libmysqlclient.so.12
></pre>
>
><note>
>A seconda di quale sia la precedente versione, anche quella di
><path>libmysqlclient.so</path> puÃ² essere diversa, le versioni conosciute
>sono ad oggi <c>10</c>, <c>12</c>, <c>14</c> o <c>15</c>. Scegliere la
>versione corretta del <e>vecchio</e> pacchetto.
></note>
>
></body>
></section>
></chapter>
>
>
><chapter>
><title>Ritocchi finali</title>
><section>
><body>
>
><pre caption="Aggiornare il database degli utenti">
><comment>(Sostituire 'your_password' con la propria password di root 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>
>
>
>Se si sono incontrati problemi nella fase di aggiornamento, si Ã¨ pregati di
>riportarli sul nostro <uri link="https://bugs.gentoo.org">Bugzilla</uri>.
>
>
></body>
></section>
></chapter>
>
></guide>

Actions: View

Attachments on bug 120222: 78031 | 78071 | 78102 | 78760