Attachment 78102 Details for Bug 120222 – mysql-upgrade-slotted

mysql-upgrade-slotted

mysql-upgrade-slotted.xml (text/plain), 8.91 KB, created by Stefano Pacella (RETIRED) on 2006-01-25 13:36:19 UTC

(hide)

Description:

Filename:

MIME Type:

Creator: Stefano Pacella (RETIRED)

Created: 2006-01-25 13:36:19 UTC

Size: 8.91 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>MySQL, aggiornamento e passaggio a versioni affiancate multiple</title>
>
><author title="Autore">
>	<mail link="vivo@gentoo.org">Francesco Riosa</mail>
></author>
>
><abstract>
>VerrÃ  qui descritto il percorso di aggiornamento alla versione "slotted" di
>MySQL.
></abstract>
>
>
>
><license/>
>
><version>1</version>
><date>2006-01-25</date>
>
><chapter>
><title>Aggiornamento da 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 la schedulazione del progetto madre (stabile, bug corretti
>		attivamente)
>	</li>
>	<li>
>		4.1 Segue la schedulazione del progetto madre (solo cambiamenti che
>		riguardano un ampio numero di utenti)
>	</li>
>	<li>
>	 4.0 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 del documento
>corrente non Ã¨ garantito con queste ultime due.
>
>
><ul>
>	<li>3.23 antica</li>
>	<li>5.1 sviluppo attivo</li>
></ul>
>
><note>
>Di seguito si farÃ  riferimento a un sistema che abbia inizialmente
>installato mysql-4.0.26 e si voglia aggiornarlo alla versione
>mysql-5.0.18-r30. 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 server 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 mysqldump dalla versione
>slotted di MySQL. Notare il suffisso -500 al nome del
>programma mysqldump, Ã¨ ricavato dalla versione 5.0.x .
>
>
><pre caption="Esportazione dei database">
># mysqldump-500 \
> --defaults-file=/etc/mysql/my.cnf
> -uroot \
> --password=<comment>'your_password'</comment> \
> -hlocalhost \
> --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>
>
>
>Esiste un file chiamato <path>BACKUP_MYSQL_4.0.SQL</path>, questo
>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
># echo '
> NOCHECK=1
> DEBUG=3
> mysql_slot_500=(
> "skip-networking"
> "skip-grant-tables"
> )
> ' > /etc/conf.d/mysql
># /etc/init.d/mysql-500 start
># mysql-500 --defaults-file=/etc/mysql-500/my.cnf &lt; BACKUP_MYSQL_4.0.SQL
># mv /etc/conf.d/mysql.orig /etc/conf.d/mysql
># /etc/init.d/mysql-500 stop
></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>
>
><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.
></note>
>
></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 di esse cercheranno di leggere la sezione <c>[client]</c> del
>file <path>/etc/mysql/my.cnf</path>.
>
>
>
>Quando si Ã¨ soddisfatti dei risultati, si possono rimuovere le impostazioni
>di test, fermare il vecchio server e fare ripartire il nuovo. Fare anche in
>modo che sia quest'ultimo a partire all'avvio della macchina.
>
>
><pre caption="Utilizzare il nuovo server">
># rc-update del mysql default
># rc-update add mysql-500 default
># /etc/init.d/mysql stop
># /etc/init.d/mysql-500 start
></pre>
>
>
>Dis-installare la vecchia versione e rendere di default quella nuova. Il
>comando "unmerge" non sara' in grado di rimuovere alcuni file, 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="Pulizia, passo uno">
># 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
># rm -rf /usr/lib/*.TMP
># for i in /usr/lib/*mysql* ; do
> readlink -f $i || [[ -L $i ]] &amp;&amp; rm $i
> done
># 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="Dipendenze inverse, ricostruzione">
># revdep-rebuild --soname libmysqlclient.so.12 -- -p -v
># revdep-rebuild --soname libmysqlclient.so.12
></pre>
>
><note>
>A seconda di quale sia la precedente installazione, anche la versione di
><path>libmysqlclient.so</path> puÃ² essere diversa, le versioni conosciute
>sono ad oggi 10, 12, 14 o 15, utilizzare quella del <e>vecchio</e>
>pacchetto.
></note>
>
></body>
></section>
></chapter>
>
>
><chapter>
><title>Ritocchi finali</title>
><section>
><body>
>
><pre caption="Aggiornare il database degli utenti">
># mysql_fix_privilege_tables-500 \
> --defaults-file=/etc/mysql-500/my.cnf \
> --user=root \
> --password=<comment>'your_password'</comment>
># mysql -uroot -p<comment>'your_password'</comment> mysql -e "FLUSH PRIVILEGES;"
># for tbl in $( mysql --silent -uroot -p<comment>'your_password'</comment> -e 'USE mysql ; SHOW TABLES LIKE "help%";' )
> do
> mysql -uroot -p<comment>'your_password'</comment> -e "use mysql ; TRUNCATE TABLE ${tbl};"
> done
># mysql -uroot -p<comment>'your_password'</comment> 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