This page in other versions: 0.9 / 1.0 / 1.0.3

5.2. Parting (removing) a node

Because BDR can recover from extended node outages it is necessary to explicitly tell the system if you are removing a node permanently. If you permanently shut down a node and don't tell the other nodes then performance will suffer and eventually the whole system will stop working.

Each node saves up change information (using one replication slot for each peer node) so it can replay changes to a temporarily unreachable node. If a peer node remains offline indefinitely this accumulating change information will cause the node to run out of storage space for PostgreSQL transaction logs (WAL, in pg_xlog), likely causing the database server to shut down with an error like:

    PANIC: could not write to file "pg_xlog/xlogtemp.559": No space left on device
   

or report other out-of-disk related symptoms.

Note: Administrators should monitor for node outages (see: Monitoring and make sure nodes have sufficient free disk space.

A node is removed with the bdr.bdr_part_by_node_names function. You must specify the node name (as passed during node creation) to remove a node. You should call bdr.bdr_part_by_node_names from a node that will remain in the BDR group, not the node to be removed. Multiple nodes may be removed at once. No value is returned; the removal status may be seen by checking the status field in bdr.bdr_nodes for that node.

To remove node1:

    SELECT bdr.bdr_part_by_node_names(ARRAY['node-1']);
   

or to remove multiple nodes at once:

    SELECT bdr.bdr_part_by_node_names(ARRAY['node-1', 'node-2', 'node-3']);
   

If you only know the slot name from pg_replication_slots and not the node name from bdr.bdr_nodes you can either SELECT bdr.bdr_get_local_node_name() on the node you plan to remove, or look it up from the slot name using the bdr.bdr_node_slots view.