Attachment 78031 Details for Bug 120222 – it/mysql-migrate-to-slot.xml

it/mysql-migrate-to-slot.xml

mysql-migrate-to-slot.xml (text/plain), 8.93 KB, created by Francesco R. (RETIRED) on 2006-01-24 14:27:29 UTC

(hide)

Description:

Filename:

MIME Type:

Creator: Francesco R. (RETIRED)

Created: 2006-01-24 14:27:29 UTC

Size: 8.93 KB

patch

obsolete

><?xml version='1.0' encoding="UTF-8"?>
><!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
>
>
><guide link="/doc/en/mysql-upgrading.xml">
>
><title>MySQL, aggiornamento a passaggio a versioni affiancate multiple</title>
>
><author title="Author">
>	<mail link="vivo@gentoo.org">Francesco Riosa</mail>
></author>
>
><abstract>
>Verra' qui descritto il percorso di aggiornamento alla versione "slotted" di MySQL.
></abstract>
>
>
>
><license/>
>
><version>1.6</version>
><date>2006-01-04</date>
>
><chapter>
><title>Aggiornamento da versioni precedenti di MySQL</title>
><section>
><body>
>
>
>Questo documento spiega come aggiornare MySQL alla piu' recente
>versione disponibile.
>Attualmente ci sono tre versioni di MySQL supportate in portage:
>
><ul>
>	<li>5.0 Segue la schedulazione del progetto madre (stabile, bachi 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 bachi riportati verranno corretti con una priorita' 
>molto bassa e possono mancare funzionalita'. 
>Il funzionamento del documento corrente non 'e garantito con queste ultime due.
>
><ul>
>	<li>3.23 antica</li>
>	<li>5.1 sviluppo attivo</li>
></ul>
>
>
><note>
>	Di seguito si fara' riferimento a un sistema che abbia inizialmente installato mysql-4.0.26
>	e si voglia aggiornarlo alla versione mysql-5.0.18-r30 
>	Sostituite 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 'e archiviare una copia del server corrente,
>	(tralasciamo i dati per ora). 
>	Fatto questo, 'e possibile rimuovere i file che creerebbero un conflitto con la versione 
>	"slotted" di MySQL, quindi verra' installata una versione che si affianchi a quella corrente.
>
>
><pre caption="Archiviare il veccho 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>
>
>
>Assicurati di aggiornare lo script di avvio /etc/init.d/mysql utilizzando
>etc-update o dispatch-conf.
>
>
></body>
></section>
></chapter>
>
><chapter>
><title>Copiare i dati nel server appena installato</title>
><section>
><body>
>
>
>Iniziamo con l'esportare i dati, questi verranno importati nella nuova
>versione di mysql. 
>Stiamo per utilizzare mysqldump dalla versione slotted di MySQL. 
>Notare il suffisso "-500" al nome del programma mysqldump, 'e 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>
>
>
>Ora esiste un file chiamato <path>BACKUP_MYSQL_4.0.SQL</path>, quest' ultimo puo'
>essere usato per ricreare i dati. I dati sono descritti nel dialetto SQL di MySQL,
>ossia lo "Structured Query Language".
>
>
>
>Avviare il server senza connettivita' 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
>	rimuovere l'opzione "--hex-blob" dal comando mysqldump,
>	quindi "filtrare" i dati tramite un convertitore quale "iconv". 
>	In molti casi questo si ottiene con un "piping" (accodamento dell' i/o dei programmi)
>	come di seguito: 
>	"iconv -f ISO_8859-1 -t UTF8 BACKUP_MYSQL_4.0.SQL
>	| mysql-500 --defaults-file=/etc/mysql-500/my.cnf" 
>	Tuttavia puo' essere necessario modificare manualmente lo script SQL, a
>	seconda della sua struttura e dei dati ivi contenuti.
></note>
>
><note>
>	Se esistono applicazione che continuano a <comment>scrivere</comment> sul 
>	database precedente, 'e possibile impostare una relazione di replicazione
>	(replication setup) dei dati tra i due database.
>	Tuttavia questo non verra' trattato in questa sede.
></note>
>
></body>
></section>
></chapter>
>
>
><chapter>
><title>Passare al nuovo server</title>
><section>
><body>
>Se 'e essere sicuri che le applicazioni interagiscano correttamente
>con il server appena installato, fate delle prove, praticamente qualsiasi
>applicazione legge delle impostazioni di configurazione nelle quali 'e
>possibile specificare quale "porta" di rete oppure quale "socket" utilizzare
>per connettersi al database server. 
>Semplicemente, eseguite il server su una porta alternativa (ad esempio 3307)
>e impostate la vostra applicazione o una copia di essa per connettersi con 
>i paramentri voluti. 
>Prestate attenzione al fatto che molte di esse cercheranno di leggere la sezione
>"[client]" del file /etc/mysql/my.cnf. 
>
>
>
>Quando siete soddisfatti dei risultati, rimuovete le impostazioni di test,
>fermate il vecchio server e fate ripartire il nuovo. 
>Fate 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-installa la vecchia versione e rendi quella nuova la predefinita.
>Il comando di "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 'e un comportamento voluto, e scongiura il malfunzionamento di applicazioni
>connesse al 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, puoi re-installare i pacchetti che lo
>utilizzano. Nota che per trovare e reinstallare i pacchetti 'e necessario 
>il programma <c>revdep-rebuild</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 libmysqlclient.so puo' essere diversa, le versioni conosciute sono
>ad oggi 10, 12, 14 or 15, utilizza quella del <comment>vecchio</comment> 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 avete incontrato problemi nella fase di aggiornamento, siete 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