Skip to main content

Master-slave clustering for high availability

SafeSquid supports clustered deployments for high availability, failover, and horizontal scaling. A master node holds policy and reporting; slave nodes enforce policy and forward data. Use a load balancer in front of slaves for distribution and failover.

Problem statement

Single-node deployments create both scale risk and availability risk. Clustering is the documented way to reduce that risk while keeping policy consistent across enforcement nodes.

When to use clustering

Prerequisites

  • Same SafeSquid version on all nodes
  • Same activation key on master and slaves
  • Network connectivity: slaves can reach master Configuration Portal (port 8888 by default)
  • Load balancer configured to distribute traffic to slave nodes (not to master)
  • Time synchronization (NTP) across all nodes
  • A reporting plan so evidence from all active nodes remains visible

Architecture overview

Master node:
  • Hosts Configuration Portal for policy management
  • Aggregates reporting data from slaves
  • Does NOT process client traffic directly
Slave nodes:
  • Enforce policies synced from master
  • Process client traffic
  • Forward reporting data to master
Load balancer:
  • Distributes client requests across slave nodes
  • Provides failover if a slave goes down
  • Does NOT route to master (master is for management only)
Internal product knowledge confirms automatic policy replication across cluster nodes and no documented hard ceiling on total cluster node count. Treat single-instance capacity and cluster capacity as separate planning questions.

Verification and validation

After clustering is configured, validate:
  • policy changes replicate to every node
  • the load balancer does not send client traffic to the master
  • a failed slave is removed from active service
  • reporting still captures traffic from each surviving node
  • authentication and SSL inspection behavior remain consistent across nodes
The documents below cover master-slave setup and configuration sync.

Clustering configuration guides

Master-Slave

Single-node deployments lack failover and scale limits. Master-Slave describes how to configure a master node for policy and reporting and slave nodes for traffic enforcement. Centralized policy and unified reporting reduce administrative overhead. Follow this document to set up master-slave relationships.

Configuration Sync

Configuration drift across nodes causes inconsistent enforcement and troubleshooting difficulty. Configuration Sync enables automatic propagation of policy and configuration from master to slaves. All nodes stay aligned without manual copy. Configure sync using this document.

Next steps

Place a load balancer in front of slave nodes; see Disaster Recovery for backup and restore, and Verify your setup for post-cluster validation.