Truedoc

h1. Configurare la replicazione di MySQL

Occorrono almeno due installazioni indipendenti di MySQL, una macchina deve fare da master, le altre da slave. Prenderemo in considerazione solo il caso elementare di due macchine. Le due istanze devono essere configurate per essere raggiungibili via rete. In pratica si dice al master di creare un log binario con le operazioni che vengono eseguite in scrittura. Lo slave leggendo i file di log ripete le stesse operazioni su se stesso per “allinearsi”.

h3. --Master

Si cominici con configurare il primo server MySQL esistente come master, anzitutto si fermi il servizio con:

<pre>

service mysql stop

</pre>

A questo punto modifichiamo il file  @/etc/mysql/my.cnf@ del master per abilitare networking e scrittura del file di log binario, inserendo le seguenti configurazioni al posto di quelle correnti:

<pre>

[...]

bind-address	= 0.0.0.0

[...]

server-id = 1

log_bin = /var/log/mysql/mysql-bin.log

expire_logs_days = 10

max_binlog_size = 100M

binlog_do_db = nome_database

[...]

</pre>

Se si dovesse ripartire da zero, cancelliamo eventuali vecchi file di log binario in modo tale che il server crei un log pulito 

a prova di errore.

<pre>

rm /var/log/mysql/mysql-bin.*

</pre>

si provveda poi a riavviare il server, in modo che prenda le nuove configurazioni:

<pre>

service mysql start

</pre>

Adesso andiamo a lavorare su MySQL per abilitare e settare la replica su uno slave definendo anche l'utente a cui dare l'accesso:

<pre>

GRANT REPLICATION SLAVE ON *.* TO '[nome_utente]'@'[indirizzo_ip_dello_slave]' IDENTIFIED BY '[password]';

FLUSH PRIVILEGES;

</pre>

Una volta attive le nuove configurazioni occorre trasferire i dati dal master allo slave per l'importazione iniziale, per questo una volta entrati sulla CLI di MySQL si seleziona il database da replicare e si bloccano le tabelle in scrittura per avere uno stato coerente dei dati:

<pre>

USE nome_database

FLUSH TABLES WITH READ LOCK;

</pre>

Si potrà controllare lo stato del master con qualcosa del tipo:

<pre>

mysql> SHOW MASTER STATUS;

+------------------+----------+--------------+------------------+

| File             | Position | Binlog_Do_DB | Binlog_Ignore_DB |

+------------------+----------+--------------+------------------+

| mysql-bin.000013 |      106 |              | nome_database    |

+------------------+----------+--------------+------------------+

1 row in set (0.00 sec)

</pre>

A questo punto senza chiudere la shell di MySQL (per evitare di perdere il lock sulle tabelle), si apre una nuova shell ed esportiamo il database in un file @.sql@ da trasferire sul server slave:

<pre>

mysqldump -u root -p --opt nome_database > nome_database.sql

</pre>

una volta finita l'esportazione possiamo tornare sulla shell di MySQL per sbloccare il lock in lettura:

<pre>

UNLOCK TABLES;

</pre>

h3. --Slave

Occorre agire come precedentemente fatto sul file @/etc/mysql/my.cnf@ dello slave al fine di configurarlo con un diverso @server-id@ e spostare @tmpdir@ su una directory diversa da quella di default in modo che il contenuto non corra il rischio di venire cancellato; bisogna infine metterlo in ascolto sull'indirizzo generico @0.0.0.0@:

<pre>

[...]

tmpdir          = /var/tmp

[...]

bind-address	= 0.0.0.0

[...]

server-id = 2

log_bin = /var/log/mysql/mysql-bin.log

expire_logs_days = 10

max_binlog_size = 100M

[...]

</pre>

Adesso possiamo riavviare il demone di MySQL anche sullo slave:

<pre>

service mysql restart

</pre>

Adesso occorre creare un DB sullo slave con lo stesso nome di quello che vogliamo replicare: 

<pre>

mysqladmin -u root -p create nome_database

</pre>

a questo punto si può caricare il file di dump .sql direttamente sul database:

<pre>

mysql nome_database < nome_database.sql

</pre>

infine occorre impostare il server come slave passando anche i paramatri del master con cui interfacciarsi:

<pre>

CHANGE MASTER TO master_host='nome_Master.Domain', master_user='nome_utente_Master', 

master_port=3306, master_password='pw_utente_Master', master_log_file='mysql-bin.00000x', 

master_log_pos=xxx;

START SLAVE;

</pre>

eventualmente si può controllare lo status dello slave da MySQL con:

<pre>

SHOW SLAVE STATUS;

</pre>

h2. Switching Slave to Master

Volendo cambiare il nostro server slave nel nuovo master su cui indirizzare i servizi che appoggiano sul database mysql replicato si deve prima di tutto andare a cambiare il file @/etc/mysql/my.cnf@ controllando che siano abilitate le opzioni di @log-bin@ e disabilitato tutto quello che riguarda i log del tipo @slave-updates@.

Si deve anche verificare che il @bind-address@ sia effettivamente impostato su @0.0.0.0@ permettendo così il raggiungimento della macchina dalla rete:

<pre>

[...]

bind-address	= 0.0.0.0

[...]

log_bin = /var/log/mysql/mysql-bin.log

expire_logs_days = 10

max_binlog_size = 100M

binlog_do_db = nome_database

[...]

</pre>

Si deve poi commentare tutto quello che riguarda il collegamento per la replicazione ad un (ormai defunto) server master:

<pre>

[...]

#master-host = nome_Master.Domain

#master-user = nome_utente_Master

#master-password =  nome_utente_Master

#master-connect-retry = 60 

#replicate-do-db = nome_database 

[...]

</pre>

A questo punto, entrando in MySQL, si può fermate il server slave e reimpostarlo come nuovo master:

<pre>

STOP SLAVE;

RESET MASTER;

</pre>

In caso esistano altri slave, questi dovranno essere reindirizzati al nuovo master con:

<pre>

CHANGE MASTER TO

MASTER_HOST='master_ip',

MASTER_USER='Id',

MASTER_PASSWORD='pswrd',

MASTER_LOG_FILE='mysql-bin.00000x',

MASTER_LOG_POS=xxx;

</pre>

Dobbiamo poi garantire tutti i permessi sul database con:

<pre>

GRANT ALL ON *.* TO '[nome_utente]'@'[indirizzo_ip_slave]' IDENTIFIED BY '[password]';

FLUSH PRIVILEGES;

</pre>