Supported cluster types section broken to smaller sections

product_docs/docs/biganimal/release/overview/02_high_availability/distributed_highavailability.mdx

@@ -0,0 +1,61 @@
+---
+title: "Distributed high availability"
+---
+
+Distributed high-availability clusters are powered by [EDB Postgres Distributed](/pgd/latest/) using multi-master logical replication to deliver more advanced cluster management compared to a physical replication-based system. Distributed high-availability clusters offer the ability to deploy a cluster across multiple regions or a single region. For use cases where high availability across regions is a major concern, a cluster deployment with distributed high availability enabled can provide one region with three data nodes, another region with the same configuration, and one group with a witness node in a third region for a true active-active solution. 
+
+Distributed high-availability clusters support both EDB Postgres Advanced Server and EDB Postgres Extended Server database distributions. 
+
+Distributed high-availability clusters contain one or two data groups. Your data groups can contain either three data nodes or two data nodes and one witness node. One of these data nodes is the leader at any given time, while the rest are shadow nodes. We recommend that you don't use two data nodes and one witness node in production unless you use asynchronous [commit scopes](/pgd/latest/durability/commit-scopes/). 
+
+[PGD Proxy](/pgd/latest/routing/proxy) routes all application traffic to the leader node, which acts as the principal write target to reduce the potential for data conflicts. PGD Proxy leverages a distributed consensus model to determine availability of the data nodes in the cluster. On failure or unavailability of the leader, PGD Proxy elects a new leader and redirects application traffic. Together with the core capabilities of EDB Postgres Distributed, this mechanism of routing application traffic to the leader node enables fast failover and switchover.
+
+The witness node/witness group doesn't host data but exists for management purposes, supporting operations that require a consensus, for example, in case of an availability zone failure. 
+
+!!!Note
+   Operations against a distributed high-availability cluster leverage the [EDB Postgres Distributed switchover](/pgd/latest/cli/command_ref/pgd_switchover/) feature which provides sub-second interruptions during planned lifecycle operations.
+
+## Single data location 
+
+A single data location configuration has one data group and either:
+
+- two data nodes with one lead and one shadow, and a witness node each in separate availability zones
+
+    ![region(2 data + 1 witness) +  (1 witness)](images/1dg-2dn-1wn-1wg.png)
+
+- three data nodes with one lead and two shadow nodes each in separate availability zones
+
+    ![region(3 data) +  (1 witness)](images/1dg-3dn-1wg.png)
+
+## Multiple data locations
+
+A multiple data location configuration has two data groups that contain either:
+
+- Two data nodes
+
+  - A data node, shadow node, and a witness node in one region
+  - The same configuration in another region
+  - A witness node in a third region
+
+  ![region(2 data + 1 shadow) + region(2 data + 1 shadow) + region(1 witness)](images/2dn-1wn-2dn-1wn-1wg.png)
+
+- Three data nodes
+
+  - A data node and two shadow nodes in one region
+  - The same configuration in another region
+  - A witness node in a third region
+
+  ![region(2 data + 1 shadow) + region(2 data + 1 shadow) + region(1 witness)](images/eha.png)
+
+
+### Cross-Cloud Service Providers(CSP) witness groups
+
+Cross-CSP witness groups are available with AWS, Azure and GCP, on BYOA and BAH. It is enabled by default and applies to both multi-region configurations available with PGD. The database price is not charged for witness groups, it is charged for the infrastructure it uses. The cost of the cross-CSP witness group is reflected in the pricing estimate footer.
+
+By default, the CSP selected for the data groups is pre-selected for the witness group. Users can change the CSP of the witness group to be one of the other two CSPs.
+
+## For more information
+
+For instructions on creating a distributed high-availability cluster using the BigAnimal portal, see [Creating a distributed high-availability cluster](../getting_started/creating_a_cluster/creating_an_eha_cluster/).
+
+For instructions on creating, retrieving information from, and managing a distributed high-availability cluster using the BigAnimal CLI, see [Using the BigAnimal CLI](/biganimal/latest/reference/cli/managing_clusters/#managing-distributed-high-availability-clusters).

product_docs/docs/biganimal/release/overview/02_high_availability/index.mdx

@@ -0,0 +1,17 @@
+---
+title: "Supported cluster types"
+deepToC: true
+redirects:
+  - 02_high_availibility
+navigation:
+- single_node
+- primary_standby_highavailability
+- distributed_highavailability
+---
+
+BigAnimal supports three cluster types: 
+- [Single node](./single_node)
+- [Primary/standby high availability](./primary_standby_highavailability)
+- [Distributed high availability](./distributed_highavailability)
+
+You choose the type of cluster you want on the [Create Cluster](https://portal.biganimal.com/create-cluster) page in the [BigAnimal](https://portal.biganimal.com) portal.  

product_docs/docs/biganimal/release/overview/02_high_availability/primary_standby_highavailability.mdx

@@ -0,0 +1,27 @@
+---
+title: "Primary/standby high availability"
+---
+
+The Primary/Standby High Availability option is provided to minimize downtime in cases of failures. Primary/standby high-availability clusters—one *primary* and one or two *standby replicas*—are configured automatically, with standby replicas staying up to date through physical streaming replication. 
+
+If read-only workloads are enabled, then standby replicas serve the read-only workloads. In a two-node cluster, the single standby replica serves read-only workloads. In a three-node cluster, both standby replicas serve read-only workloads. The connections are made to the two standby replicas randomly and on a per-connection basis. 
+
+In cloud regions with availability zones, clusters are provisioned across zones to provide fault tolerance in the face of a datacenter failure.
+
+In case of temporary or permanent unavailability of the primary, a standby replica becomes the primary.
+
+![BigAnimal Cluster4](../images/high-availability.png)
+
+Incoming client connections are always routed to the current primary. In case of failure of the primary, a standby replica is promoted to primary, and new connections are routed to the new primary. When the old primary recovers, it rejoins the cluster as a standby replica.
+
+## Standby replicas
+
+By default, replication is synchronous to one standby replica and asynchronous to the other. That is, one standby replica must confirm that a transaction record was written to disk before the client receives acknowledgment of a successful commit. 
+
+In a cluster with one primary and one replica (a two-node primary/standby high-availability cluster), you run the risk of the cluster being unavailable for writes because it doesn't have the same level of reliability as a three-node cluster. BigAnimal automatically disables synchronous replication during maintenance operations of a two-node cluster to ensure write availability. You can also change from the default synchronous replication for a two-node cluster to asynchronous replication on a per-session/per-transaction basis.
+
+In PostgreSQL terms, `synchronous_commit` is set to `on`, and `synchronous_standby_names` is set to `ANY 1 (replica-1, replica-2)`. You can modify this behavior on a per-transaction, per-session, per-user, or per-database basis with appropriate `SET` or `ALTER` commands. 
+
+To ensure write availability, BigAnimal disables synchronous replication during maintenance operations of a two-node cluster.
+
+Since BigAnimal replicates to only one node synchronously, some standby replicas in three-node clusters might experience replication lag. Also, if you override the BigAnimal synchronous replication configuration, then the standby replicas are inconsistent. 

product_docs/docs/biganimal/release/overview/02_high_availability/single_node.mdx

@@ -0,0 +1,9 @@
+---
+title: "Single node"
+---
+
+For nonproduction use cases where high availability isn't a primary concern, a cluster deployment with high availability not enabled provides one primary with no standby replicas for failover or read-only workloads. 
+
+In case of unrecoverable failure of the primary, a restore from a backup is required. 
+
+![BigAnimal Cluster4](../images/single-node.png)