Deploying PGD manually
======================

EDB offers automated PGD deployment using Trusted Postgres Architect
(TPA) because it’s generally more reliable than manual processes. See
:ref:`Deploying with TPA <Installing PGD CLI with TPA>`  for full details about how to install TPA and use its
automated best-practice-driven PGD deployment options. Or refer to any
of the :ref:`Quick start walkthroughs <../../../quickstart/>`  , which use TPA to get you up and running quickly.

To complement automated deployment, and to enable alternative
installation and deployment processes, this section looks at the basic
operations needed to manually configure a three-node PGD cluster (with a
local subgroup), PGD Proxy, and PGD CLI.

Each step is outlined and followed by a worked example with further
detail. This isn’t a quick start guide but an exploration of PGD
installation. It configures a basic deployment that will be used for
further examples of PGD administration tasks.

The examples deploy a 3-node cluster of EDB Postgres Advanced Server 16
on Red Hat Enterprise Linux 9. These instructions also apply to RHEL
derivatives like Alma Linux, Rocky Linux, or Oracle Linux.

At the highest level, manually deploying PGD involves the following
steps. (For completeness, the steps also include instructions for
installing PostgreSQL. If you’re familiar with that, then skip to step
3.)

   1: :ref:`Provisioning and configuring hosts <Step 1 - Provisioning hosts>`  to run the cluster on

   2: :ref:`Installing your selected Postgres version <Step 2 - Installing Postgres>`  on each of the hosts

   3: :ref:`Configuring repositories to install PGD <Step 3 - Configuring PGD repositories>`  to add PGD capabilities to each host

   4: :ref:`Initializing Postgres and installing PGD software <Step 4 - Installing the PGD software>`  on each host

   5: :ref:`Connecting the cluster <Step 5 - Creating the PGD cluster>`  by connecting to each node and telling it to join
the cluster

   6: :ref:`Step 6 - Checking the cluster <Step 6 - Checking the cluster>`  by running SQL commands and confirming replication
has happened

   7: :ref:`Configuring proxies <Step 7 - Configure proxies>`  by creating a proxy config file

   8: :ref:`Using PGD CLI <Using PGD CLI>`  , including how to install PGD CLI and how to use
it to inspect and manage your cluster

.. toctree::
  :maxdepth: 3

  Get_Started--deploy-config--deploy-manual--deploying--01-provisioning-hosts
  Get_Started--deploy-config--deploy-manual--deploying--02-install-postgres
  Get_Started--deploy-config--deploy-manual--deploying--03-configuring-repositories
  Get_Started--deploy-config--deploy-manual--deploying--05-creating-cluster
  Get_Started--deploy-config--deploy-manual--deploying--04-installing-software
  Get_Started--deploy-config--deploy-manual--deploying--06-check-cluster
  Get_Started--deploy-config--deploy-manual--deploying--07-configure-proxies
  Get_Started--deploy-config--deploy-manual--deploying--08-using-pgd-cli