TECHNICAL SOLUTION GUIDERedis | Case 03 | September 2026

Redis Active-Passive High Availability with OSS Manager

Overview

Applications need a highly available Redis endpoint that can recover from primary failure without requiring operators to improvise promotion, client redirection, or evidence collection during an incident.

Active-passive availability depends on more than adding replicas. Sentinel quorum, network fault domains, replica freshness, persistence, client discovery, reconnect behavior, and fencing determine whether failover restores service or creates split authority and stale writes.

The recommended design uses primary-replica Redis with quorum-based failover under a governed OSS Manager workflow. The operating model keeps cache, session, token, queue, and application state with bounded persistence and recovery policy within the engine's native consistency and recovery semantics while standardizing planning, approvals, status, evidence, and day-two operations.

OSS Manager coordinates lifecycle operations and operational evidence. Engine-native consistency and application-level correctness remain explicit design responsibilities.

Use Case and Business Need

Why Current Operating Model is Insufficient

Current Challenge

Manual operations obscure what changed and whether the application remained correct. The solution connects the workload requirements above to explicit ownership, safe change and a tested recovery path.

Intended Outcomes

Solution Goals
  • ✓A repeatable, reviewable architecture rather than a collection of host-specific steps.
  • ✓Preflight checks that stop execution when capacity, access, topology, or safety assumptions are false.
  • ✓Explicit separation between planning, approval, execution, and verification.
  • ✓Engine-native health checks combined with application-level acceptance tests.
  • ✓Evidence that L1, L2, platform, security, and audit teams can interpret without privileged data access.

Target Architecture

Redis Active-Passive High Availability Reference Architecture and Operating Flow with OSS Manager
Figure 1 Reference architecture and operating flow

Architecture Responsibilities

One Redis primary serves writes, replicas maintain asynchronous copies, and an odd Sentinel quorum monitors authority and promotes an eligible replica. Applications use a failover-aware endpoint and reconnect policy.

↔ Swipe horizontally to view full table
LayerResponsibility
ApplicationOwn business transactions, idempotency, user-facing error handling, and business acceptance tests.
RedisOwn native consistency, storage, replication, query, and recovery behavior for cache, session, token, queue, and application state with bounded persistence and recovery policy.
OSS ManagerOwn declared topology, preflight, controlled lifecycle orchestration, status normalization, audit evidence, and guarded recovery workflow.
ObservabilityCollect and retain primary and replica health; replication offset; Sentinel quorum; failover state; memory; evictions; persistence; latency; rejected clients; reconnect time.
Enterprise controlsOwn identity, network, secrets, change approval, artifact trust, incident management, and retention policy.

Design Principles and Control Boundaries

  • •Declare before changing: Topology and policy are reviewed in configuration before any mutation.
  • •Observe before owning: Brownfield or recovery workflows start by discovering runtime state and differences.
  • •Plan is not execution: A plan may read and validate but cannot silently cross into an apply, restore, or removal action.
  • •Explicit write ownership: A data directory has one runtime owner. Multi-writer designs additionally require a defined key, row or topic ownership model and conflict policy.
  • •Protect the last healthy copy: No move, removal, or restore may destroy the only known usable copy of required data.
  • •Verify business behavior: Process health is necessary but not sufficient; representative application paths must pass.
  • •Retain rollback evidence: The pre-change state, artifacts, configuration, and decision record remain available through the rollback window.

Prerequisites and Discovery

Before implementation, customer and delivery teams must complete and approve the following discovery package.

↔ Swipe horizontally to view full table
AreaExit condition
TopologyHosts, roles, zones or sites, ports, service endpoints, storage paths, and dependencies are inventoried.
AccessNamed SSH and engine identities are available through approved secret references; no plaintext credentials appear in YAML or logs.
NetworkRequired east-west, client, monitoring, backup, and management paths are tested in both directions.
PlatformSupported operating system, architecture, time synchronization, DNS, certificates, packages, and filesystem ownership are confirmed.
DataCurrent volume and growth are recorded for cache, session, token, queue, and application state with bounded persistence and recovery policy; retention and legal constraints are documented.
CapacityCommands per second, key count, value size, working set, ttls, persistence overhead, replica count, failover headroom, and recovery bandwidth are measured rather than assumed.
RecoveryRPO, RTO, rollback window, authoritative copy, and application validation owners are named.
ChangeMaintenance window, approvers, escalation contacts, stop conditions, and communications are agreed.

OSS Manager Solution

OSS Manager declares Redis and Sentinel topology, validates identity, network, persistence, and quorum, deploys guarded configuration, observes replication, exercises failover, and captures recovery evidence. Applications remain responsible for retry, idempotency, cache fallback, and data reconciliation.

Capability model

↔ Swipe horizontally to view full table
StageWhat it must do
DiscoverRead the existing engine, service, topology, policy, storage, and security posture without mutation.
PlanResolve desired versus observed state and list checks, changes, warnings, approvals, and rollback inputs.
ValidateProve access, artifacts, topology, capacity, policy, and safety invariants before execution.
Apply or recoverExecute only the reviewed scope, persist progress, stop on failed gates, and avoid unrelated changes.
StatusCombine engine-native and host-level evidence into operator-readable health and drift results.
VerifyRun post-change topology, data, security, observability, and application checks.
EvidenceRetain the plan, approval, command result, before-and-after state, and unresolved exceptions.

Configuration and Deployment Contract

The deployment specification captures primary-replica Redis with quorum-based failover. Configuration is reviewed against the schema supported by the chosen release; architecture intent is not a substitute for a validated runtime configuration.

  • •Topology and resources: One Redis primary serves writes, replicas maintain asynchronous copies, and an odd Sentinel quorum monitors authority and promotes an eligible replica. Applications use a failover-aware endpoint and reconnect policy.
  • •Operational controls: Sentinel quorum, replica eligibility, ACL and TLS, persistence, memory headroom, promotion safety, client reconnect, backup, failover test, and split-authority prevention.
  • •Workload and recovery sizing: commands per second, key count, value size, working set, TTLs, persistence overhead, replica count, failover headroom, and recovery bandwidth.
  • •Identity and security: named operators, protected credential references, network boundaries and an approved access model.

Configuration review checklist

  • •Record approved versions, paths, thresholds, sites, ports and service identities.
  • •Reference secrets through protected environment or vault integration; never store passwords or private keys in the document or YAML repository.
  • •Confirm that every declared host and service identity has the minimum required permissions.
  • •Review destructive, removal, ownership-transfer, and recovery fields with the named approver.
  • •Commit the reviewed configuration and record its immutable revision or checksum in the change ticket.

Implementation Workflow

Implementation follows the release-supported workflow for this engine. Each stage has a clear exit condition before the next action begins.

↔ Swipe horizontally to view full table
StageOperational actionRequired result
1 DiscoverRead current topology and ownershipInventory and differences; no mutation.
2 PlanReview configuration and change scopeOrdered changes, warnings, approvals, and rollback inputs.
3 ValidateRun engine-specific preflightAll mandatory preflight checks pass.
4 ExecuteApply the approved changeOnly reviewed scope runs; progress is retained.
5 RefreshInspect runtime and application behaviorObserved runtime matches the intended topology and policy.
6 EvidenceRetain sanitized operational resultsPost-change evidence and exceptions are accessible.

Staged rollout

  1. Laboratory rehearsal with representative topology, data shape, and failure injection.
  2. Non-production deployment with application owners and monitoring connected.
  3. Recovery or rollback rehearsal from retained artifacts and previous configuration.
  4. Production canary or lowest-risk segment, where the architecture permits segmentation.
  5. Production rollout with live stop conditions, named approvers, and post-change observation window.
  6. Closure only after evidence, exceptions, and operational handover are accepted.

Capacity and Infrastructure Planning

Sizing must be based on commands per second, key count, value size, working set, TTLs, persistence overhead, replica count, failover headroom, and recovery bandwidth. Benchmark with representative data and concurrency before production commitment.

↔ Swipe horizontally to view full table
ComponentBaseline planning considerationProduction decision
Managed engine nodesCPU, memory, local persistence, network, fault-domain separation, and maintenance headroom.Derived from measured workload and engine vendor guidance.
OSS Manager bastionDedicated management host, 4 vCPU, 8 GB RAM, protected state, and restricted SSH reachability as a starting point.Increase for large fleets, concurrent operations, or local artifact hosting.
ObservabilityDedicated Prometheus and Grafana capacity, metric retention, cardinality limits, and alert routing.Size from target count, scrape interval, retention, and dashboard concurrency.
Backup or snapshot storageAt least the protected data size plus retention, change rate, temporary restore space, and integrity copies.Use tested throughput that meets backup and recovery windows.
NetworkClient, replication, recovery, monitoring, and management traffic must be modelled separately.Capacity test peak and recovery catch-up, not only steady state.

Security and Compliance

  • •Use named human and service identities. Shared administrator accounts are not an acceptable operating model.
  • •Apply least privilege to SSH, engine, monitoring, backup, and application identities independently.
  • •Keep secrets out of YAML, command history, support bundles, screenshots, and document examples.
  • •Encrypt management, client, replication, and monitoring traffic where the target security standard requires it.
  • •Record configuration revisions, approvals, operator identity, execution timestamps, and before-and-after status.
  • •Sanitize customer data, credentials, internal addresses, and private keys from evidence before external sharing.
  • •Review licensing, third-party notices, package provenance, signatures, and SBOM evidence for the exact shipped artifacts.
↔ Swipe horizontally to view full table
RolePermitted actionsRestricted actions
L1 monitoringRead health, alerts, dashboards, and sanitized support evidence.Apply, restore, destroy, secret access, or policy change.
L2 operationsDiagnose, prepare plans, and execute approved non-destructive runbooks.Unapproved destructive recovery or access-policy change.
Platform administratorManage declared topology and approved lifecycle operations.Bypass of approval, audit, or credential controls.
Security or approverReview access, secrets, artifacts, and high-risk execution gates.Routine engine mutation without operational owner.

Observability and Day Two Operations

The operational dashboard and alert policy should cover primary and replica health; replication offset; Sentinel quorum; failover state; memory; evictions; persistence; latency; rejected clients; reconnect time. Thresholds must be tuned during non-production load and recovery tests.

↔ Swipe horizontally to view full table
CadenceRequired activity
ContinuousService, topology, replication, capacity, security, and exporter alerts.
DailyReview failed jobs, backup or snapshot age, storage growth, authentication failures, and unresolved drift.
WeeklyCapacity trend, slow or failed operations, certificate horizon, support evidence quality, and alert noise.
MonthlyRestore or recovery sample, access review, artifact and version posture, and runbook currency.
QuarterlyFull failure exercise with application owners, RPO and RTO measurement, and corrective-action closure.

Failure Modes and Edge Cases

The design and test plan must explicitly cover primary loss, Sentinel quorum loss, stale replica promotion, network partition, split authority, client reconnect storm, memory exhaustion, and persistence failure.

↔ Swipe horizontally to view full table
ScenarioExpected controlAcceptance evidence
Preflight assumption is falseExecution is blocked before mutation and the finding names the failed requirement.Failed validation result and unchanged runtime state.
Operation is interruptedPersisted progress allows safe resume or a documented rollback; completed steps are not repeated blindly.Resume plan, idempotent result, and reconciled state.
Partial engine healthNo destructive cleanup occurs while authority or the last healthy copy is uncertain.Authoritative copy decision and approved recovery plan.
Capacity exhaustedThe workflow stops before moving or restoring data into an unsafe disk or memory condition.Capacity check, alert, and remediated target.
Credential or permission mismatchNo permission broadening is attempted automatically; the exact missing right is reported.Named identity, corrected grant, and successful revalidation.
Post-change application failureTraffic remains stopped or is rolled back even if engine health is green.Application test failure, decision record, and rollback evidence.

Validation and Acceptance Gates

↔ Swipe horizontally to view full table
GatePass condition
ConfigurationThe approved YAML revision matches the executed plan and contains no plaintext secret.
InfrastructureHosts, ports, storage, time, DNS, certificates, and required packages pass preflight.
TopologyAll declared roles and members are healthy; no undeclared or duplicate authority remains.
DataCounts, placement, replication, recovery, or integrity checks appropriate to cache, session, token, queue, and application state with bounded persistence and recovery policy pass.
SecurityAuthentication, authorization, encryption, audit, and credential boundaries behave as designed.
ObservabilityDashboards are current, alerts are routed, and a deliberate fault is detected and cleared.
ApplicationRepresentative reads, writes, failure behavior, and reconciliation pass with business owners.
RecoveryRollback or restore is rehearsed and measured against approved RPO and RTO.
OperationsL1 and L2 runbooks, escalation, support evidence, and ownership are accepted.

Rollback and Recovery Strategy

Rollback is prepared before execution. The team retains the approved configuration, observed pre-change state, packages or runtime references, manifests, service metadata, and data protection artifacts required to return safely. Rollback must not overwrite the only healthy copy or start competing authorities.

  • •Stop new application traffic or writes when continued activity would make rollback ambiguous.
  • •Capture current failure evidence before changing state again.
  • •Confirm the authoritative data copy and the exact rollback target.
  • •Execute the reviewed rollback in reverse dependency order.
  • •Verify engine topology, data, security, observability, and application behavior.
  • •Record the decision, elapsed time, data exposure, unresolved exceptions, and corrective actions.

Limitations and Required Design Decisions

  • •This reference does not replace workload benchmarking, engine vendor guidance, or environment-specific architecture review.
  • •Supported operations and topology options depend on the selected OSS Manager release and engine version.
  • •OSS Manager can standardize orchestration and evidence but cannot decide business conflict, reconciliation, residency, or failure policy on behalf of the application owner.
  • •High availability does not replace backup; backup completion does not replace tested recovery; process health does not replace business validation.
  • •Performance, cost, RPO and RTO targets are established through workload measurements and recovery rehearsals.

Reference Use Cases

BFSI: payments, fraud, customer 360, regulatory reporting, digital lending, risk, and resilient transaction platforms; Media and OTT: content metadata, playback events, entitlements, recommendations, sessions, and audience analytics; Retail: catalog, pricing, inventory, orders, loyalty, personalization, and real-time fulfillment events; Telco: subscriber data, charging, network events, assurance, policy, customer care, and digital channels; Gaming: profiles, matchmaking, leaderboards, inventory, telemetry, events, and live-operations services.

The same operating model can be adapted where the engine capability and data semantics are equivalent, subject to an environment-specific design and release validation.

Customer Success Criteria

For Redis, success is demonstrated through an agreed operational baseline, a rehearsed recovery path and application acceptance evidence, rather than service status alone.

  • •Business owners can see whether continuity and data-correctness objectives were met.
  • •Operations teams can identify the current owner, configuration and next recovery action.
  • •Security teams can trace access and changes without exposing credentials or customer data.

Delivery Checklist

  • ✓Architecture and scope approved
  • ✓Prerequisites and capacity evidence complete
  • ✓Security and credential model approved
  • ✓Configuration revision and plan retained
  • ✓Non-production and negative-path tests passed
  • ✓Rollback or recovery rehearsal passed
  • ✓Production window and stop conditions approved
  • ✓Post-change engine and application validation passed
  • ✓L1 and L2 operational handover complete
  • ✓Service objectives and customer acceptance recorded