> [!CAUTION] > **Caution:** This documentation covers Edge for Private Cloud 4.18.05, which is no longer supported. Google does not provide security patches, bug fixes, or technical support for this version. The current supported version is 4.54.00. See the [Edge for Private Cloud documentation](https://docs.apigee.com/private-cloud/latest/overview) for the current version, or [All versions](https://docs.apigee.com/private-cloud/versions) to compare releases. *Edge for Private Cloud v4.18.05* This section describes the Edge installation topologies (i.e., the node configurations supported by Edge). ### Introductory video The following video will give you a quick introduction to the Apigee components in an installation: [Video](https://www.youtube.com/watch?v=mWxCz09o_1g) The following table gives you an overview of the configurations^\*^: | Topology | Nodes | Installation Instructions | |---|---|---| | **Non-production Topologies** ||| | [All‑in‑One (1‑node)](https://docs.apigee.com/private-cloud/v4.18.05/installation-topologies#allinoneinstallation) | - **Node 1:** Cassandra, Edge UI, Management Server, Message Processor, OpenLDAP, Postgres Server, Qpid Server, Router, Zookeeper | [All-in-one installation](https://docs.apigee.com/private-cloud/v4.18.05/install-edge-components-node#installedgecomponents-allinoneinstallation) | | [2‑node (standalone)](https://docs.apigee.com/private-cloud/v4.18.05/installation-topologies#standaloneinstallation2host) | - **Node 1:** Cassandra, Edge UI, Management Server, Message Processor, Router, OpenLDAP, Zookeeper - **Node 2:** Postgres Server, Qpid Server | [2-node standalone installation](https://docs.apigee.com/private-cloud/v4.18.05/install-edge-components-node#installedgecomponents-2hoststandaloneinstallation) | | [5-node](https://docs.apigee.com/private-cloud/v4.18.05/installation-topologies#5hostclusteredinstallation) | - **Node 1:** Cassandra, Edge UI, Management Server, OpenLDAP, Zookeeper - **Nodes 2 \& 3:** Cassandra, Message Processor, Router, Zookeeper - **Nodes 4 \& 5:** Postgres Server, Qpid Server | [5-node installation](https://docs.apigee.com/private-cloud/v4.18.05/install-edge-components-node#installedgecomponents-5hostclusteredinstallation) | | **Production topologies** ||| | Single Data Center (9 or 13 nodes per DC) ||| | [9-node](https://docs.apigee.com/private-cloud/v4.18.05/installation-topologies#9hostclusteredinstallation) | - **Node 1:** Cassandra, Edge UI, Management Server, OpenLDAP, Zookeeper - **Nodes 2 \& 3:** Cassandra, Zookeeper - **Nodes 4 \& 5:** Message Processor, Router - **Nodes 6 \& 7:** Qpid Server - **Nodes 8 \& 9:** Postgres Server | [9-node clustered installation](https://docs.apigee.com/private-cloud/v4.18.05/install-edge-components-node#installedgecomponents-9hostclusteredinstallation) | | [13-node](https://docs.apigee.com/private-cloud/v4.18.05/installation-topologies#13hostclusteredinstallation) | - **Nodes 1, 2 \& 3:** Cassandra, Zookeeper - **Nodes 4 \& 5:** OpenLDAP - **Nodes 6 \& 7:** Edge UI, Management Server - **Nodes 8 \& 9:** Postgres Server - **Nodes 10 \& 11:** Message Processor, Router - **Nodes 12 \& 13:** Qpid Server | [13-node clustered installation](https://docs.apigee.com/private-cloud/v4.18.05/install-edge-components-node#installedgecomponents-13hostclusteredinstallation) | | Multiple Data Centers (6 nodes per DC) ||| | [12-node](https://docs.apigee.com/private-cloud/v4.18.05/installation-topologies#12hostclusteredinstallation) | Two data centers, each with 6 nodes, each consisting of the following: - **Nodes 1 \& 7:** Cassandra, Edge UI, Management Server OpenLDAP, Zookeeper - **Nodes 2 \& 3, 8 \& 9:** Cassandra, Message Processor, Router, Zookeeper - **Nodes 4 \& 5, 10 \& 11:** Qpid Server - **Node 6 \& 12:** Postgres master (Data Center 1) and Postgres slave (Data Center 2) | [12-node clustered installation](https://docs.apigee.com/private-cloud/v4.18.05/install-edge-components-node#installedgecomponents-12hostclusteredinstallation) | | ^\* These configurations do not include the Apigee Developer Services portal (or simply, *the portal* ). For more information, see [Portal overview](https://docs.apigee.com/private-cloud/v4.18.05/portal-overview).^ ||| For Apigee Edge for Private Cloud, please work with your Sales Rep or Account Executive to engage with Apigee Edge Professional Services and Customer Success to plan out any custom topology requirements. Performance varies by use case, so we recommend setting up a performance environment to analyze and tune your performance before rolling changes out to your production environment. ## All-in-one Installation (1-node) A single node runs all Edge components. ![](https://docs.apigee.com/static/private-cloud/images/1-host.png) The following videos introduce you to the requirements and process for installing a single-node Edge installation: ### S26E07: Installation Requirements [Video](https://www.youtube.com/watch?v=om2tYHRYY50) ### S26E08: Install on a Single Node [Video](https://www.youtube.com/watch?v=k8T0emV30TU) **Additional notes:** - Apigee recommends this topology be used only for non-production or development installations, as this configuration is not optimal for performance. - This topology should not be used for performance testing. - This topology does not support high availability. For installation information, see [All-in-one installation](https://docs.apigee.com/private-cloud/v4.18.05/install-edge-components-node#installedgecomponents-allinoneinstallation). ## Standalone installation (2-node) In this scenario, a single node runs Gateway standalone servers and associated components: Apigee Management Server, Apache ZooKeeper, Apache Cassandra, OpenLDAP, Edge UI, Apigee Router, and Apigee Message Processor. The other node runs Analytics standalone components: Qpid Server and Postgres Server. ![](https://docs.apigee.com/static/private-cloud/images/2-host.png) **Additional notes:** - Apigee recommends this topology be used only for non-production or development installations, as this configuration is not optimal for performance. - This topology should not be used for performance testing. - This topology does not support high availability. For installation information, see [2-node standalone installation](https://docs.apigee.com/private-cloud/v4.18.05/install-edge-components-node#installedgecomponents-2hoststandaloneinstallation). ## 5-node clustered installation In a 5-node topology, three nodes run ZooKeeper and Cassandra clusters. One of those three nodes also runs the Apigee Management Server, OpenLDAP, and Edge UI. Two of those three nodes also run Apigee Router and Message Processor. Two nodes run Apigee Analytics. > [!NOTE] > **NOTE:** This scenario combines cluster and Gateway components to reduce the number of servers used. > > To achieve optimal performance, the cluster can also be deployed on > three different servers. This scenario also introduces a master-standby replication between two > Postgres nodes if analytics statistics are mission critical. ![](https://docs.apigee.com/static/private-cloud/images/5-host.png) **Additional notes:** - Apigee recommends this topology be used only for non-production or development installations, as this configuration is not optimal for performance. - This topology limits the ability to scale the deployment for future expansion needs. Only Routers and Message Processors can be expanded easily in this topology, as described in [Adding a Router or Message Processor node](https://docs.apigee.com/private-cloud/v4.18.05/adding-router-or-message-processor-node). - This topology should not be used for performance testing. - This topology does not support high availability. For installation information, see [5-node installation](https://docs.apigee.com/private-cloud/v4.18.05/install-edge-components-node#installedgecomponents-5hostclusteredinstallation). ## 9-node clustered installation This scenario is similar to 5-node clustered installation but has different Analytics components setup to achieve performance high availability. > [!NOTE] > **NOTE:** This scenario introduces a master-standby replication between two Postgres nodes if Analytics statistics are mission critical. ![](https://docs.apigee.com/static/private-cloud/images/9-host.png) **Additional notes:** - While this topology represents the *minimum* number of nodes for a production installation, it is not optimal for performance. - You can expand this topology to support high availability across multiple data centers, as described in [Adding a data center](https://docs.apigee.com/private-cloud/v4.18.05/adding-data-center). - In this topology, Routers and Message Processors are hosted on the same nodes and may result in "noisy neighbor" problems. - This topology is limited to a 3-node Cassandra setup with a quorum of two. As a result, your ability to take a node out for maintenance is limited. For installation information, see [9-node clustered installation](https://docs.apigee.com/private-cloud/v4.18.05/install-edge-components-node#installedgecomponents-9hostclusteredinstallation). ## 13-node clustered installation This scenario is an enhancement of 9-node clustered installation covering separate data zones for data and Apigee servers in one datacenter setup. Here LDAP is installed as an independent separate node. > [!NOTE] > **NOTE:** This scenario uses master-master OpenLDAP replication and master-standby Postgres replication in one datacenter setup. ![](https://docs.apigee.com/static/private-cloud/images/13-host.png) **Additional notes:** - Apigee recommends this configuration as a minimum topology for production setups with the documented hardware specifications. For more information, see [Hardware requirements](https://docs.apigee.com/private-cloud/v4.18.05/installation-requirements#hardwarerequirements). - You can expand this topology to support high availability, as described in [Adding a data center](https://docs.apigee.com/private-cloud/v4.18.05/adding-data-center). - In this topology, Routers and Message Processors are hosted on the same nodes and may result in "noisy neighbor" problems. - This topology is limited to a 3-node Cassandra setup with a quorum of two. As a result, your ability to take a node out for maintenance is limited. For installation information, see [13-node clustered installation](https://docs.apigee.com/private-cloud/v4.18.05/install-edge-components-node#installedgecomponents-13hostclusteredinstallation). ## 12-node clustered installation This scenario covers disaster recovery and analytics high availability across two data centers. > [!NOTE] > **NOTE:** This scenario uses master-master OpenLDAP replication and master-standby Postgres replication (across two data centers). ![](https://docs.apigee.com/static/private-cloud/images/12-host.png) **Additional notes:** - Apigee considers this topology adequate for production purposes. However, since every installation has its own unique requirements and challenges, please contact your Sales Rep or Account Executive to engage with Apigee Edge Professional Services and Customer Success. - In this topology, Routers and Message Processors are hosted on the same nodes and may result in "noisy neighbor" problems. For installation information, see [12-node clustered installation](https://docs.apigee.com/private-cloud/v4.18.05/install-edge-components-node#installedgecomponents-12hostclusteredinstallation). ## Installing Monetization Services Monetization Services runs within any existing Apigee Edge setup. In this scenario, you install Monetization Services the Apigee Management Server and Message Processor. To install Monetization on Edge where the Edge installation has multiple Postgres nodes, the Postgres nodes must be configured in Master/Standby mode. You cannot install Monetization on Edge if you have multiple Postgres master nodes. For more information, see [Installing Monetization Services](https://docs.apigee.com/private-cloud/v4.18.05/installing-monetization-services).