Skip to main content
This page is prepared for those who want to install Apinizer in critical production environments with high availability requirements. This topology provides %99.9+ uptime, automatic failover, and data replication.

Overview

Topology 3 is a topology designed for high availability, where all critical components run in a cluster structure. All components are distributed across 12 servers.

Architectural Structure

High Availability Installation Architecture

1. System Requirements

For detailed system requirements, you can refer to the Overview page.

Operating System

  • Ubuntu Server 24.04 LTS or RHEL 9.x
  • Minimum kernel version: 5.4+
  • SELinux: Disabled (for RHEL) or Permissive mode

Software Components

ComponentVersion/Requirement
Kubernetes1.31.0+ (HA Cluster)
Docker/ContainerdVersion compatible with Kubernetes
MongoDBAny version (Replica Set - 3 node minimum)
Elasticsearch7.9.2+ (Cluster - 3 node minimum)
Network PluginFlannel 0.27.4 (or compatible)
Load BalancerHAProxy 2.0+ or Nginx 1.18+ (HA configuration)
For detailed information about software components: Overview - Components Required by Apinizer

Network Requirements

  • Internet Access: Required during installation
  • DNS: Working DNS resolution
  • Firewall: Required ports must be open
  • Load Balancer: HA configuration (VIP)
  • Network Latency: < 1ms between nodes (same datacenter)
For detailed information about network topology and port requirements: Network Topology and Port Requirements

2. Hardware Requirements

The requirements below are specified for the recommended minimum configuration. They should be increased according to your service loads.
NoOperating SystemCPURAMDiskInstallations
Server 1Ubuntu Server 24.04 LTS / RHEL 9.x48GB100GBKubernetes Control-Plane Node 1
Server 2Ubuntu Server 24.04 LTS / RHEL 9.x48GB100GBKubernetes Control-Plane Node 2
Server 3Ubuntu Server 24.04 LTS / RHEL 9.x48GB100GBKubernetes Control-Plane Node 3
Server 4Ubuntu Server 24.04 LTS / RHEL 9.x88GB100GBKubernetes Worker Node 1
Server 5Ubuntu Server 24.04 LTS / RHEL 9.x88GB100GBKubernetes Worker Node 2
Server 6Ubuntu Server 24.04 LTS / RHEL 9.x88GB100GBKubernetes Worker Node 3
Server 7Ubuntu Server 24.04 LTS / RHEL 9.x48GB200GBMongoDB Replica Set Node 1
Server 8Ubuntu Server 24.04 LTS / RHEL 9.x48GB200GBMongoDB Replica Set Node 2
Server 9Ubuntu Server 24.04 LTS / RHEL 9.x48GB200GBMongoDB Replica Set Node 3
Server 10Ubuntu Server 24.04 LTS / RHEL 9.x832GB2TBElasticsearch Cluster Node 1 (Master+Data)
Server 11Ubuntu Server 24.04 LTS / RHEL 9.x832GB2TBElasticsearch Cluster Node 2 (Master+Data)
Server 12Ubuntu Server 24.04 LTS / RHEL 9.x832GB2TBElasticsearch Cluster Node 3 (Master+Data)
Important: The CPU, disk, and RAM values above are given as examples. These values may vary according to traffic volume, number of APIs, policy complexity, and other factors. To determine your actual hardware requirements, it is recommended to calculate according to the rules on the Capacity Planning page.

3. Network Topology

DMZ and LAN Separation (Mandatory)

For high availability topology, DMZ (Demilitarized Zone) and LAN (Local Area Network) separation is mandatory. This structure provides security and high availability. Network Structure:
  • Internet: Traffic from the outside world is directed to the DMZ zone through a Load Balancer with high availability configuration (Port 443/80).
  • DMZ Zone: Worker nodes (3 units) are located in this zone. The Load Balancer distributes traffic among these three worker nodes, providing load balancing and high availability.
  • LAN Zone: Manager, MongoDB Replica Set (3 nodes), and Elasticsearch Cluster (3 nodes) are located in this zone.
For detailed information about DMZ and LAN zones: Overview - Core Concepts and Network Topology and Port Requirements

Port and Firewall Permissions

In this topology, servers are separated into DMZ and LAN zones. Worker nodes are in DMZ, Control-Plane, MongoDB, and Elasticsearch nodes are in LAN. Firewall rules control communication between zones and ensure only necessary ports are opened.
For detailed information about port requirements and firewall rules: You can refer to the Network Topology and Port Requirements page. This page explains in detail all port requirements and firewall rules for Kubernetes, MongoDB, Elasticsearch, and Apinizer components.

4. Capacity Planning

This topology is designed for Tier 3 (Enterprise production) level high-traffic systems:
MetricValue
Daily Requests> 3,000,000 requests/day
Requests per Second> 100 requests/second
Peak Traffic> 1,000 requests/second
Concurrent Users> 1,000 users
Uptime%99.9+
For detailed information about capacity planning: You can refer to the Capacity Planning page. This page explains in detail traffic estimation, hardware requirements, MongoDB and Elasticsearch data size calculations, and benchmark performance results.

Pre-Installation Checklist

Before starting installation, you should make the following preparations:
CategoryCheck Item
Infrastructure[ ] 12 servers prepared (3 Control-Plane + 3 Worker + 3 MongoDB + 3 Elasticsearch)
[ ] Load Balancer prepared (HA configuration)
[ ] Operating system installed (Ubuntu 24.04 LTS or RHEL 9.x)
[ ] Network connectivity between servers tested (< 1ms latency)
[ ] DNS resolution working
[ ] Internet access available
[ ] VIP (Virtual IP) configured
Network[ ] DMZ and LAN zones configured
[ ] Firewall rules configured
[ ] Load balancer HA configured
[ ] SSL/TLS certificates prepared
[ ] Required ports opened
[ ] Network segmentation applied
Software[ ] Kubernetes HA cluster installation packages ready
[ ] MongoDB replica set installation packages ready
[ ] Elasticsearch cluster installation packages ready
[ ] Apinizer images accessible (DockerHub or private registry)
[ ] Load balancer software installed (HA)
Security[ ] SSH keys configured
[ ] Sudo access configured
[ ] Security updates performed
[ ] Firewall rules tested
[ ] SSL/TLS certificates prepared
[ ] Network segmentation tested
For detailed pre-installation recommendations: You can refer to the Pre-Installation Recommendations page.

Usage Scenarios

This topology is ideal for critical production environments, high-traffic systems (> 3M requests/day), high availability requirements (%99.9+ uptime), critical business processes, and systems with data security requirements.
For detailed information about topology selection guide and usage scenarios: You can refer to the Deployment Models page.

Limitations and Points to Consider

Points to consider for this topology:
  • High cost requirements (12 servers + Load Balancer)
  • Complex installation and management processes
  • High network bandwidth requirements
  • Requirement for expert system administrator
  • Regular maintenance and monitoring requirements
  • High disk space requirements (especially for Elasticsearch)