Multi-master is an extension and set of patches to a Postegres database, that turns Postgres into a synchronous shared-nothing cluster to provide OLTP scalability and high availability with automatic disaster recovery.

• Cluster-wide transaction isolation
• Synchronous logical replication
• DDL Replication
• Distributed sequences
• Fault tolerance
• Automatic node recovery

Multi-master replicates same database to all nodes in cluster and allows writes to each node. Transaction isolation is enforced cluster-wide, so in case of concurrent updates on different nodes database will use the same conflict resolution rules (mvcc with repeatable read isolation level) as single node uses for concurrent backends and always stays in consistent state. Any writing transaction will write to all nodes, hence increasing commit latency for amount of time proportional to roundtrip between nodes nedded for synchronization. Read only transactions and queries executed locally without measurable overhead. Replication mechanism itself based on logical decoding and earlier version of pglogical extension provided for community by 2ndQuadrant team.

Cluster consisting of N nodes can continue to work while majority of initial nodes are alive and reachable by other nodes. This is done by using 3 phase commit protocol and heartbeats for failure discovery. Node that is brought back to cluster can be fast-forwaded to actual state automatically in case when transactions log still exists since the time when node was excluded from cluster (this depends on checkpoint configuration in postgres).

Read more about internals on architecture page.

Multi-master consist of patched version of postgres and extension mmts, that provides most of functionality, but doesn't requiere changes to postgres core. To run multimaster one need to install postgres and several extensions to all nodes in cluster.

Ensure that following prerequisites are installed:

for Debian based linux:

apt-get install -y git make gcc libreadline-dev bison flex zlib1g-dev

for RedHat based linux:

yum groupinstall 'Development Tools'
yum install git, automake, libtool, bison, flex readline-devel

After that everything is ready to install postgres along with extensions

git clone https://github.com/postgrespro/postgres_cluster.git
cd postgres_cluster
./configure && make && make -j 4 install
cd ./contrib/raftable && make install
cd ../../contrib/mmts && make install

Directort contrib/mmts also includes Dockerfile that is capable of building multi-master and starting 3 node cluster.

cd contrib/mmts
docker-compose build
docker-compose up

After things go more stable we will release prebuilt packages for major platforms.

1. Add these required options to the postgresql.conf of each instance in the cluster.

max_prepared_transactions = 200 # should be > 0, because all
                                # transactions are implicitly two-phase
max_connections = 200
max_worker_processes = 100 # at least (2 * n + p + 1)
                           # this figure is calculated as:
                           #   1 raftable worker
                           #   n-1 receiver
                           #   n-1 sender
                           #   1 mtm-sender
                           #   1 mtm-receiver
                           #   p workers in the pool
max_parallel_degree = 0
wal_level = logical # multimaster is build on top of
                    # logical replication and will not work otherwise
max_wal_senders = 10 # at least the number of nodes
wal_sender_timeout = 0
default_transaction_isolation = 'repeatable read'
max_replication_slots = 10 # at least the number of nodes
shared_preload_libraries = 'raftable,multimaster'
multimaster.workers = 10
multimaster.queue_size = 10485760 # 10mb
multimaster.node_id = 1 # the 1-based index of the node in the cluster
multimaster.conn_strings = 'dbname=... host=....0.0.1 port=... raftport=..., ...'
                           # comma-separated list of connection strings
multimaster.use_raftable = true
multimaster.heartbeat_recv_timeout = 1000
multimaster.heartbeat_send_timeout = 250
multimaster.ignore_tables_without_pk = true
multimaster.twopc_min_timeout = 2000

1. Allow replication in pg_hba.conf.

Read description of all configuration params at configuration

create extension mmts; to gain access to these functions:

• mtm.get_nodes_state() -- show status of nodes on cluster
• mtm.get_cluster_state() -- show whole cluster status
• mtm.get_cluster_info() -- print some debug info
• mtm.make_table_local(relation regclass) -- stop replication for a given table

Read description of all management functions at functions

(Show TPC-C here on 3 nodes)

(Link to test/failure matrix)

Regression: 141 of 164 Isolation: n/a

To run tests:

• make -C contrib/mmts check to run TAP-tests.
• make -C contrib/mmts xcheck to run blockade tests. The blockade tests require docker, blockade, and some other packages installed, see requirements.txt for the list. You might also want to gain superuser privileges to run these tests successfully.

• Commit latency. Current implementation of logical replication sends data to subscriber nodes only after local commit, so in case of heavy-write transaction user will wait for transaction processing two times: on local node and al other nodes (simultaneosly). We have plans to address this issue in future.

• DDL replication. While data is replicated on logical level, DDL replicated by statements performing distributed commit with the same statement. Some complex DDL scenarious including stored procedures and temp temp tables aren't working properly. We are working right now on proving full compatibility with ordinary postgres. Currently we are passing 141 of 164 postgres regression tests.

• Isolation level. Multimaster currently support only repeatable read isolation level. This is stricter than default read commited, but also increases probability of serialization failure during commit. Serializable level isn't supported yet.

• One database per cluster.

Multi-master developed by the PostgresPro team.