~drizzle-trunk/drizzle/7.0

« back to all changes in this revision

Viewing changes to plugin/slave/docs/index.rst

  • Committer: Monty Taylor
  • Date: 2011-03-10 19:13:42 UTC
  • mfrom: (2227.1.5 build)
  • Revision ID: mordred@inaugust.com-20110310191342-zgf5yjtm2e1l2tqq
Merge Olaf: Refactoring Work
Merge Brian: Replication bug fixes
Merge Marisa and Mark: Documentation fixes

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
1
Replication Slave
2
 
=================
 
2
==================
 
3
 
 
4
This page contains the configuration and implementation details for Drizzle replication.
 
5
 
 
6
See this page for a user-level example: 
 
7
 
 
8
.. toctree::
 
9
   :maxdepth: 2
 
10
 
 
11
   user_example
3
12
 
4
13
Description
5
14
-----------
6
15
 
7
 
The replication slave plugin provides a native implementation of replication
8
 
between two Drizzle processes.
9
 
 
10
 
This plugin requires a master that is running with the InnoDB replication log
11
 
enabled.
 
16
Replication enables data from one Drizzle database server (the master) to be replicated to one or more Drizzle database servers (the slaves). It provides a native implementation of replication between two Drizzle processes. Depending on your configuration, you can replicate all databases, selected databases, or selected tables within a database.
 
17
 
 
18
Drizzle’s replication system is entirely new and different from MySQL. Replication events are stored using Google Protocol Buffer messages in an InnoDB table. These events are read by the slave, stored locally, and applied. The advantage of the Google Protocol Buffer messages is a script or program can be put together in pretty much any language in minutes, and read the replication log. In other words, replication plugins are easy to implement, which enable developers to entirely customize their replication system.
 
19
 
 
20
This plugin requires a master that is running with the InnoDB replication log enabled. The slave plugin allows a server to replicate from another server that is using the innodb-trx log. It is a very simple setup:

 
21
master options:  –innodb.replication-log=true
slave options: –plugin-add=slave –slave.config-file=XYZ
 
22
 
 
23
The config file may contain the following options in option=value format:

 
24
master-host – hostname/ip of the master host
master-port – port used by the master server
master-user – username
master-pass – password
max-reconnects – max # of reconnect attempts if the master disappears
seconds-between-reconnects – how long to wait between reconnect attempts
 
25
 
12
26
 
13
27
Configuration
14
28
-------------