# Replikation

# MySQL Master/Slave-Replikation einrichten (online) (veraltet)

<p class="callout danger">Achtung, dieses Feature wird von aktuellen MySQL Versionen nicht mehr unterstützt.</p>

Auf dem Master-Server die Datei /etc/my.cnf ändern und in der \[mysqld\]-Sektion folgendes einfügen:

```
server-id = 1
log-bin
```

Auf dem Slave-Server die Datei /etc/my.cnf ändern und in der \[mysqld\]-Sektion folgendes einfügen:

```
server-id = 2
#replicate-do-db = database1 # um nur bestimmte Datenbanken zu replizieren
```

Master- und Slave-Server neu starten

```
service mysqld restart
```

Auf dem Master-Server einen User für die Replikation einrichten:

```
mysql> GRANT SUPER,REPLICATION CLIENT,REPLICATION SLAVE,RELOAD ON *.* TO repl@"slave.host" IDENTIFIED BY 'password';
mysql> STOP SLAVE; # wenn bereits gestartet
mysql> START SLAVE;
```

Auf dem Slave-Server:

```
mysql> LOAD DATA FROM MASTER;
```

# MySQL Master/Slave-Replikation einrichten (offline)

Einfach und umkompliziert eine MySQL Master/Slave-Replikation einrichten (OFFLINE, empfohlen bei InnoDB-Datenbanken)

- <div>User für Replikation einrichten:</div>

```code
GRANT REPLICATION SLAVE ON *.* TO 'repl'@'%.domain.de' IDENTIFIED BY 'slavepass';
```

- <div>Auf dem Master-Server /etc/my.cnf bearbeiten, in der [mysqld]-Sektion ergänzen und danach den MySQL-Server neu starten:</div>

```code
# replikation
log-bin=mysql-bin
server-id=1
innodb_flush_log_at_trx_commit=1
sync_binlog=1
```

- <div>Auf dem Slave-Server /etc/my.cnf bearbeiten, in der [mysqld]-Sektion ergänzen und danach den MySQL-Server neu starten:</div>

```code
# replikation
server-id=2
```

- <div>Auf dem Master-Server die Tables speeren, die Datenbank anhalten und die binary-Dateien auf das Slave-System kopieren:</div>

```code
mysql -p
mysql> FLUSH TABLES WITH READ LOCK;
( eventuell bei InnoDB mit Transaktionen den Server ganz stoppen: service mysqld stop )
```

- <div>Achtung: Die Shell jetzt NICHT beenden, da der Schreibschutz sonst wieder aufgehoben wird!</div>

```code
cd /var/lib
rsync -avr -e ssh mysql sqlserver2.domain.de:/var/lib/
```

- <div>Nach dem Kopieren wird der Master wieder freigegeben:</div>

```code
( wurde der Server vorher gestoppt, so muss er jetzt wieder gestartet werden: service mysqld start )
mysql> SHOW MASTER STATUS;
mysql> UNLOCK TABLES;
```

Die Werte von File und Position merken, die werden gleich gebraucht.

- <div>Auf dem Slave-Server die Datenbank starten, die Replikation konfigurieren und starten:</div>

```code
service mysqld start
mysql -u root -p
mysql> CHANGE MASTER to MASTER_HOST='sqlserver1.domain.de’,MASTER_PORT=3306, MASTER_USER='repl',MASTER_PASSWORD='slavepass',MASTER_LOG_FILE='<logfilename>',MASTER_LOG_POS=<logfileposition>;
mysql> START SLAVE;
```

# Master-Master-Replikation

Dieser Artikel zeigt, wie man mit 2 (oder mehr) MySQL-Servern eine echte Master-Master-Replikation aufsetzt, um die Server HA-tauglich zu machen.

Es gibt 2 Server:

- **mysql1** 192.168.1.10
- **mysql2** 192.168.1.11

Als Heartbeat-IP kann man irgendeine IP verwenden, da MySQL automatisch auf allen konfigurierten IP-Adressen lauscht.

- <div>/etc/my.cnf auf **mysql1** anpassen</div>

```code
[mysqld]
...
server-id=1
log-bin
...
```

- <div>auf **mysql1** den Useraccount für die Replikation anlegen</div>

```code
mysql> grant replication slave on *.* to 'replication'@192.168.1.11 identified by 'slave';
```

- <div>MySQL-Server auf **mysql1** neu starten</div>
- <div>Nun auf **mysql2** die Datei /etc/my.cnf anpassen</div>

```code
[mysqld]
...
server-id=2
master-host = 192.168.128.1
master-user = replication
master-password = slave
master-port = 3306
...
```

- <div>auf **mysql2** den MysSQL-Server neu starten und in der MySQL-Konsole den Slave-Status ausgeben</div>

```code
mysql> show slave status\G;

*************************** 1. row ***************************
 
Slave_IO_State:	Waiting for master to send event
Master_Host:	192.168.1.10
Master_User:	replica
Master_Port:	3306
...
Slave_IO_Running:	Yes
Slave_SQL_Running:	Yes
...
1 row in set (0.00 sec)
```

- <div>Auf dem **mysql1** kontrolliert man den Master-Status</div>

```code
mysql> show master status;

+------------------------+----------+--------------+------------------+
| File                   | Position | Binlog_Do_DB | Binlog_Ignore_DB |
+------------------------+----------+--------------+------------------+
|MysqlMYSQL01-bin.000016 |      132 |              | foobar           |
+------------------------+----------+--------------+------------------+
1 row in set (0.00 sec)
```

- <div>nun haben wir bereits ein funktionierenden Master-Slave-Setup, in den weiteren Schritten konfigurieren wir uns ein echtes Master-Master-Setup</div>
- <div>auf **mysql2** /etc/my.cnf anpassen</div>

```code
[mysqld]
...
server-id=2
log-bin
binlog-ignore-db=mysql
master-host = 192.168.1.10
master-user = replication
master-password = slave
master-port = 3306
```

- <div>den Replikationsaccount auf **mysql2** anlegen</div>

```code
mysql> grant replication slave on *.* to 'replication'@192.168.1.10 identified by 'slave';
```

- <div>MySQL-Server auf **mysql2** neu starten</div>
- <div>/etc/my.cnf auf **mysql1** anpassen</div>

```code
[mysqld]
...
master-host = 192.168.128.2
master-user = replication
master-password = slave
master-port = 3306
...
```

- <div>jetzt auch auf **mysql1** den MySQL-Server neu starten</div>
- <div>mit den altbekannten Kommandos „show slave status“ und „show master status“ den aktuellen Stand der Replikation kontrollieren. Auf beiden Systemen sollten folgende Zeilen erscheinen:</div>

```code
Slave_IO_Running:	Yes
Slave_SQL_Running:	Yes
```

- <div>im Falle eines Fehlers kann man in /var/log/mysqld.log nachlesen, was den Server grade stört</div>

# Master-Slave-Replikation einrichten mit innobackupex

Mit innobackupex läßt sich auf einfache Weise im Live-Betrieb eine Master-Slave-Replikation einrichten. Die Datenbank muss ggf. nur für Änderungen an der Konfiguration neu gestartet werden (sofern nicht schon vorher entsprechend konfiguriert).

Voraussetzungen:

- <div>ein Masterserver mit MySQL und vollen Benutzerrechten (root)</div>
- <div>auf dem Master müssen binlogs eingeschaltet und die server-id auf 1 gesetzt sein</div>
- <div>ein Slaveserver mit MySQL und vollen Benutzerrechten (root)</div>
- <div>auf dem Slaveserver müssen binlogs eingeschaltet (ist ggf. wichtig, wenn man einen Slave aus dem Slave erstellen will) und die server-id auf 2 gesetzt sein</div>
- <div>rsync auf beiden Servern</div>

Zuerst installieren wir das Tool innobackupex, bzw. das Paket percona-xtrabackup. Das Toolkit läßt sich entweder direkt als [.deb Paket](http://www.percona.com/downloads/percona-toolkit/LATEST/ "http://www.percona.com/downloads/percona-toolkit/LATEST/") herunterladen oder über das Percona-Repository installieren. Ich verwende das [Repository](https://www.percona.com/doc/percona-server/5.7/installation/apt_repo.html "https://www.percona.com/doc/percona-server/5.7/installation/apt_repo.html").

Am einfachsten läßt sich das Percona Repo über das zur Verfügung gestellt .deb installieren. Dies fügt den Percona-GPG Key hinzu und legt ein entsprechendes sources.list-File an:

<dl class="code" id="bkmrk-percona-repository-a"><dt>[Percona Repository anlegen](https://test.ovtec.it/_export/code/datenbanken/mysql/master-slave-replikation_einrichten_mit_innobackupex?codeblock=0 "Schnipsel herunterladen")</dt><dd>```
wget https://repo.percona.com/apt/percona-release_0.1-4.$(lsb_release -sc)_all.deb
dpkg -i percona-release_0.1-4.$(lsb_release -sc)_all.deb
apt-get update
apt-get -y install percona-xtrabackup qpress
# oder für die neuere Version 2.4
apt-get -y install percona-xtrabackup-24 qpress
```

</dd></dl>`qpress` wird für die komprimierten Backups benötigt. Dazu unten mehr.

Um in den nächsten Schritten mit weniger Passwortabfragen auszukommen, lege ich eine Datei mit den MySQL-Zugangsdaten an, die von allen Tools ausgelesen wird.

<dl class="code" id="bkmrk-%2Froot%2F.my.cnf-%5Bclien"><dt>[/root/.my.cnf](https://test.ovtec.it/_export/code/datenbanken/mysql/master-slave-replikation_einrichten_mit_innobackupex?codeblock=1 "Schnipsel herunterladen")</dt><dd>```
[client]
user=root
pass=secret
```

</dd></dl>Jetzt ziehen wir eine Binärkopie/Snapshot des aktuellen MySQL-Datadirs (/var/lib/mysql) in unser Sicherungsverzeichnis. Darauf wird dann das aktuelle Binlog angewendet, um einen definitiven Zustand zu erhalten. Der erste Befehl legt das Backup in ein Unterverzeichnis von /backup mit dem aktuellen &lt;TIMESTAMP&gt;, das muss im zweiten Befehl berücksichtigt werden:

```code
mkdir /backup
innobackupex --compress --compress-threads=6 --rsync --slave-info /backup
```

Da das Backup komprimiert wird (kann auch weggelassen werden), werden wir das apply-log erst auf dem Ziel durchführen. Siehe unten. Wenn man nicht komprimiert, kann man –apply-log direkt ausführen.

Jetzt muss noch der Slaveserver vorbereitet werden. Dazu wird der evtl. schon laufende MySQL-Server gestoppt und das Datendir gelöscht:

```code
systemctl stop mysql.service
rm -rf /var/lib/mysql
```

Nun wird das Backup vom Master auf den Slave kopiert:

```code
rsync -av -e ssh /backup/<TIMESTAMP> slave:/var/lib/mysql
```

Auf dem Slave muss das Backup jetzt entpackt und vorbereitet werden:

```code
innobackupex --decompress /var/lib/mysql/
innobackupex --apply-log /var/lib/mysql/
```

Auf dem Slave setzen wir nun noch passende Berechtigungen:

```code
chown -R mysql.mysql /var/lib/mysql
```

Der „debian-sys-maint“-User auf dem Slave hat nun das Kennwort vom Master. Das müssen wir in der Konfigurationsdatei anpassen (/etc/mysql/debian.cnf), damit u.a. das Init-Script mit dem MySQL-Server kommunizieren kann.

Danach kann der MySQL auf dem Slave mit den Daten vom Master gestartet werden:

```code
systemctl start mysql.service
```

Für die Replikation brauchen wir noch einen User mit entsprechenden Rechten, root sollte dafür natürlich nicht verwendet werden. Auf dem Master legen wir den User wie folgt an (IP ist dabei die IP-Adresse des Slave-Servers, ein sicheres Passwort sollte gewählt werden):

```code
mysql> GRANT REPLICATION SLAVE ON *.*  TO 'repl'@'IP' IDENTIFIED BY '$PASS';
```

Vom Slave aus testen, ob der Zugang funktioniert:

```code
mysql -h master-server -u repl -p$PASS
```

Im letzten Schritt sagen wir dem Slave wer sein Herr ist und an welcher Position im Binlog die Replikation beginnen soll. Diese Infos stehen auf dem durch innobackupex angelegten File (xtrabackup\_binlog\_info, in diesem Beispiel lief der Master schon länger, daher die hohen Werte).

<dl class="code" id="bkmrk-%2Fvar%2Flib%2Fmysql%2Fxtrab"><dt>[/var/lib/mysql/xtrabackup\_binlog\_info](https://test.ovtec.it/_export/code/datenbanken/mysql/master-slave-replikation_einrichten_mit_innobackupex?codeblock=10 "Schnipsel herunterladen")</dt><dd>```
mysql-bin.002284	40083139
```

</dd></dl>In der MySQL-Shell konfigurieren wir den Slave:

```code
mysql> change master to master_host='$MASTER-IP', master_user='repl', master_password='$PASS', master_log_file='mysql-bin.002284', master_log_pos=40083139;

mysql> start slave;
```

Den Status der Replikation kann man mit diesem Befehl überprüfen:

```code
mysql> show slave status\G
*************************** 1. row ***************************
               Slave_IO_State: Waiting for master to send event
                  Master_Host: $MASTER-IP
                  Master_User: repl
                  Master_Port: 3306
                Connect_Retry: 60
              Master_Log_File: mysql-bin.002289
          Read_Master_Log_Pos: 16815558
               Relay_Log_File: mysql-relay-bin.000016
                Relay_Log_Pos: 15880380
        Relay_Master_Log_File: mysql-bin.002289
             Slave_IO_Running: Yes
            Slave_SQL_Running: Yes
              Replicate_Do_DB: 
          Replicate_Ignore_DB: 
           Replicate_Do_Table: 
       Replicate_Ignore_Table: 
      Replicate_Wild_Do_Table: 
  Replicate_Wild_Ignore_Table: 
                   Last_Errno: 0
                   Last_Error: 
                 Skip_Counter: 0
          Exec_Master_Log_Pos: 15880234
              Relay_Log_Space: 16815903
              Until_Condition: None
               Until_Log_File: 
                Until_Log_Pos: 0
           Master_SSL_Allowed: No
           Master_SSL_CA_File: 
           Master_SSL_CA_Path: 
              Master_SSL_Cert: 
            Master_SSL_Cipher: 
               Master_SSL_Key: 
        Seconds_Behind_Master: 49
Master_SSL_Verify_Server_Cert: No
                Last_IO_Errno: 0
                Last_IO_Error: 
               Last_SQL_Errno: 0
               Last_SQL_Error: 
  Replicate_Ignore_Server_Ids: 
             Master_Server_Id: 1
1 row in set (0.00 sec)
```

Dabei sollte Slave\_IO\_Running und Slave\_SQL\_Running auf YES stehen. Seconds\_Behind\_Master zeigt ungefähr wieviele Sekunden der Slave dem Master-Server hinterherhängt.