bdr: Add sample config and basic docs

diff --git a/contrib/bdr/README.bdr b/contrib/bdr/README.bdr
new file mode 100644 (file)
index 0000000..908ea2d
--- /dev/null
+++ b/contrib/bdr/README.bdr
@@ -0,0 +1,2 @@
+See https://wiki.postgresql.org/wiki/BDR_User_Guide for documentation on the
+installation and use of BDR.

diff --git a/contrib/bdr/bdr.conf b/contrib/bdr/bdr.conf
index e1e4c61b7f62dad451e57963664a3086673f8375..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391 100644 (file)
--- a/contrib/bdr/bdr.conf
+++ b/contrib/bdr/bdr.conf
@@ -1,4 +0,0 @@
-shared_preload_libraries = 'bdr'
-wal_level = logical
-max_replication_slots = 4
-track_commit_timestamp = on

diff --git a/contrib/bdr/bdr.conf.sample b/contrib/bdr/bdr.conf.sample
new file mode 100644 (file)
index 0000000..7df52dd
--- /dev/null
+++ b/contrib/bdr/bdr.conf.sample
@@ -0,0 +1,57 @@
+#
+# This configuration file was installed by the postgresql94-bdr package
+#
+# It enables BDR in PostgreSQL, though it doesn't set up any peers to replicate
+# to/from.
+#
+# To learn how to configure BDR, see:
+# https://wiki.postgresql.org/wiki/BDR_User_Guide
+
+# Load BDR its self
+shared_preload_libraries = 'bdr'
+
+# Force WAL logging at logical replication level
+wal_level = 'logical'
+
+# Enable commit timestamps, which BDR requires
+track_commit_timestamp = on
+
+# Maximum number of replication slots that may exist. You should set this to
+# the number of nodes you expect to have, plus a reasonable margin for growth.
+#
+# This is a suitable setting for a small installation.
+max_replication_slots = 8
+
+# Generally you want to set max_wal_senders to the same value plus a few for
+# pg_basebackup runs, streaming replicas, etc.
+# 
+# This is a suitable setting for a small installation.
+max_wal_senders = 10
+
+# Do you want to record conflicts to the bdr.bdr_conflict_history table, not
+# just the log file?
+#bdr.log_conflicts_to_table = off
+
+# Configure connections to other BDR nodes. See below for a couple of examples.
+bdr.connections = ''
+
+
+#-------------------------------------------------------------------------
+# Remember that you must also add a replication entry to pg_hba.conf; see
+# https://wiki.postgresql.org/wiki/BDR_User_Guide#Configuration
+#-------------------------------------------------------------------------
+
+#-------------------------------------------------------------------------
+# Example connection configuration:
+#-------------------------------------------------------------------------
+#
+# bdr.connections = 'node2,node3'
+#
+# bdr.node2_dsn = "host=node2 dbname=mydb"
+# # Take our initial copy of the data from node2
+# bdr.node2_init_replica=on
+# # and apply it to the local db using this dsn
+# bdr.node2_replica_local_dsn="dbname=mydb user=postgres"
+# 
+# bdr.node3_dsn = "host=node3 dbname=mydb"
+#

diff --git a/contrib/bdr/worker.mk b/contrib/bdr/worker.mk
index 19a299dcd5ddcca74fcada0976a342e650843f81..31ecb9aa78679c74eb6f71059f0ac85322f5371b 100644 (file)
--- a/contrib/bdr/worker.mk
+++ b/contrib/bdr/worker.mk
@@ -18,6 +18,7 @@ OBJS = \
 
 EXTENSION = bdr
 DATA = bdr--0.5.sql
+DOCS = bdr.conf.sample README.bdr
 
 SCRIPTS = scripts/bdr_initial_load