github/repmgr
1
0
Fork 0
mirror of https://github.com/EnterpriseDB/repmgr.git synced 2026-03-25 16:16:29 +00:00
Code Issues Packages Projects Releases 1 Wiki Activity

Fix a few paragraphs from the README.md.

Browse Source
This commit is contained in:
Martin
2016-02-22 09:16:11 -03:00
parent c6e1bc205a
commit 2fe3b3c2a3
1 changed files with 21 additions and 15 deletions
Download Patch File Download Diff File Expand all files Collapse all files

36
README.md
View File

@@ -33,10 +33,14 @@ provides a single read/write master server and one or more read-only standbys
containing near-real time copies of the master server's database. containing near-real time copies of the master server's database.
For a multi-master replication solution, please see 2ndQuadrant's BDR For a multi-master replication solution, please see 2ndQuadrant's BDR
(bi-directional replication) extension. For selective replication, e.g. (bi-directional replication) extension.
of individual tables or databases from one server to another, please
see 2ndQuadrant's pglogical extension.
http://2ndquadrant.com/en-us/resources/bdr/
For selective replication, e.g. of individual tables or databases from one server
to another, please see 2ndQuadrant's pglogical extension.
http://2ndquadrant.com/en-us/resources/pglogical/
### Concepts ### Concepts
@@ -117,8 +121,8 @@ views:
The `repmgr` metadata schema can be stored in an existing database or in its own The `repmgr` metadata schema can be stored in an existing database or in its own
dedicated database. dedicated database.
A dedicated superuser is required to own the meta-database as well as carry out A dedicated database superuser is required to own the meta-database as well as carry
administrative actions. out administrative actions.
Installation Installation
------------ ------------
@@ -128,7 +132,9 @@ Installation
`repmgr` is developed and tested on Linux and OS X, but should work on any `repmgr` is developed and tested on Linux and OS X, but should work on any
UNIX-like system supported by PostgreSQL itself. UNIX-like system supported by PostgreSQL itself.
`repmgr` supports PostgreSQL from version 9.3. Current versions of `repmgr` support PostgreSQL from version 9.3. If you are
interested in using `repmgr` on earlier versions of PostgreSQL you can download
version 2.1 which supports PostgreSQL from version 9.1.
All servers in the replication cluster must be running the same major version of All servers in the replication cluster must be running the same major version of
PostgreSQL, and we recommend that they also run the same minor version. PostgreSQL, and we recommend that they also run the same minor version.
@@ -137,7 +143,7 @@ The `repmgr` tools must be installed on each server in the replication cluster.
A dedicated system user for `repmgr` is *not* required; as many `repmgr` and A dedicated system user for `repmgr` is *not* required; as many `repmgr` and
`repmgrd` actions require direct access to the PostgreSQL data directory, `repmgrd` actions require direct access to the PostgreSQL data directory,
it should executed by the `postgres` user. it should be executed by the `postgres` user.
Additionally, we recommend installing `rsync` and enabling passwordless Additionally, we recommend installing `rsync` and enabling passwordless
`ssh` connectivity between all servers in the replication cluster. `ssh` connectivity between all servers in the replication cluster.
@@ -364,11 +370,11 @@ Clone the standby with:
[2016-01-07 17:21:28] [NOTICE] you can now start your PostgreSQL server [2016-01-07 17:21:28] [NOTICE] you can now start your PostgreSQL server
[2016-01-07 17:21:28] [HINT] for example : pg_ctl -D /path/to/node2/data/ start [2016-01-07 17:21:28] [HINT] for example : pg_ctl -D /path/to/node2/data/ start
This will clone the PostgreSQL data directory files from the master using This will clone the PostgreSQL data directory files from the master at repmgr_node1
PostgreSQL's pg_basebackup utility. A `recovery.conf` file containing the using PostgreSQL's pg_basebackup utility. A `recovery.conf` file containing the
correct parameters to start streaming from the master server will be created correct parameters to start streaming from this master server will be created
automatically, and unless otherwise the `postgresql.conf` and `pg_hba.conf` automatically, and unless otherwise the `postgresql.conf` and `pg_hba.conf`
files will be copied. files will be copied from the master.
Make any adjustments to the PostgreSQL configuration files now, then start the Make any adjustments to the PostgreSQL configuration files now, then start the
standby server. standby server.
@@ -702,16 +708,16 @@ Performing a switchover with repmgr
A typical use-case for replication is a combination of master and standby A typical use-case for replication is a combination of master and standby
server, with the standby serving as a backup which can easily be activated server, with the standby serving as a backup which can easily be activated
in case of a problem with the master. Such an unplanned failover would in case of a problem with the master. Such an unplanned failover would
normally be handled by promoting the standby, after which appropriate action normally be handled by promoting the standby, after which an appropriate
taken to restore the old master. action must be taken to restore the old master.
In some cases however it's desirable to promote the standby in a planned In some cases however it's desirable to promote the standby in a planned
way, e.g. so maintenance can be performed on the master; this kind of switchover way, e.g. so maintenance can be performed on the master; this kind of switchover
is supported by the `repmgr standby switchover` command. is supported by the `repmgr standby switchover` command.
`repmgr standby switchover` differs from other `repmgr` actions in that it `repmgr standby switchover` differs from other `repmgr` actions in that it
also performs actions on another server, for which reason both passwordless also performs actions on another server, for which reason you must provide
SSH access and the path of `repmgr.conf` on that server. both passwordless SSH access and the path of `repmgr.conf` on that server.
* * * * * *