pcp_detach_node(1)

pcp_detach_node1

Detaches the given node from pgpool-ii. existing connections to pgpool-ii are forced to be disconnected.

Usage

pcp_detach_node [options ...] [node_id] [gracefully]

Overview

pcp_detach_node detaches the given node from Pgpool-II. If failover_command and/or follow_primary_command are specified, they are executed too. Existing connections to Pgpool-II are forced to be disconnected.

pcp_detach_node just detaches the node, and does not touch running backend behind the node. This command is useful when admin needs to maintain the PostgreSQL node. He/she can shutdown or stop the backend as many times as he/she wants.

The safest way to re-attach the detached node is, stopping the backend and apply pcp_recovery_node(1). However if you are sure that there's no replication delay (or the delay will be recovered later on) and the role of the node (primary/standby) will not be changed, you can use pcp_attach_node(1).

Options

-n node_id
--node_id=node_id

The index of backend node to detach.

-g
--gracefully

wait until all clients are disconnected (unless client_idle_limit_in_recovery is -1 or recovery_timeout is expired).

Other options

Releases

3 releases since Debian 11 (Bullseye); the text changed 2 times.

  1. 11
  2. 12
  3. 13

From pgpool2 4.6.1-2 in Debian 13 (Trixie). Parsed by carta from the page's man source.