Node management
===============

All data nodes in a PGD cluster are members of one or more groups. By
default, all data nodes are members of the top-level group, which spans
all data nodes in the PGD cluster. Nodes can also belong to subgroups
that can be configured to reflect logical or geographical organization
of the PGD cluster.

You can manage nodes and groups using the various options available with
nodes and subgroups.

-  :ref:`Creating PGD nodes <Creating PGD nodes>`  covers the steps needed to create a new node in a PGD
   cluster.

-  :ref:`Groups and subgroups <Groups and subgroups>`  goes into more detail on how groups and subgroups work
   in PGD.

-  :ref:`Creating and joining PGD groups <Creating and joining PGD groups>`  looks at how new PGD groups can be created and how to
   join PGD nodes to them.

-  :ref:`Viewing PGD topology <Viewing PGD topology>`  details commands and SQL queries that can show the
   structure of a PGD cluster’s nodes and groups.

-  :ref:`Removing nodes and groups <Removing nodes and groups>`  shows the process to follow to safely remove a node
   from a group or a group from a cluster.

-  :ref:`Joining a heterogeneous cluster <Joining a heterogeneous cluster>`  looks at how your PGD cluster can interoperate with PGD
   nodes from earlier editions of PGD.

-  :ref:`Connection DSNs and SSL (TLS) <Connection DSNs and SSL (TLS)>`  introduces the DSNs or connection strings needed to
   connect directly to a node in a PGD cluster. It also covers how to
   use SSL/TLS certificates to provide authentication and encryption
   between servers and between clients.

-  :ref:`Replication slots created by PGD <Replication slots created by PGD>`  examines how the Postgres replication slots are
   consumed when PGD is operating.

-  :ref:`Node restart and down node recovery <Node restart and down node recovery>`  details the steps needed to bring a node back into
   service after a failure or scheduled downtime and the impact it has
   on the cluster as it returns.

-  :ref:`Maintenance commands through proxies <Maintenance commands through proxies>`  shows how to send maintenance commands to nodes that
   you can’t directly access, such as those behind a proxy.

.. toctree::
  :maxdepth: 3

  Administration--node_management--groups_and_subgroups
  Administration--node_management--creating_and_joining
  Administration--node_management--viewing_topology
  Administration--node_management--removing_nodes_and_groups
  Administration--node_management--heterogeneous_clusters
  Administration--node_management--connections_dsns_and_ssl
  Administration--node_management--replication_slots
  Administration--node_management--node_recovery
  Administration--node_management--maintainance_with_proxies
  Administration--node_management--creating_nodes