Skip to content

Commit 7ab596d

Browse files
Add Active-Passive replication warnings to data eviction policies
- Document that writing to destination (passive) replica causes data inconsistency - Explain eviction/expiration only operates on active replica - Detail memory management conflicts and replication failures - Provide proper steps for transitioning passive to active database - Include warning about syncer exit due to command failures Addresses DOC-824
1 parent d3d6b26 commit 7ab596d

File tree

1 file changed

+28
-1
lines changed

1 file changed

+28
-1
lines changed

content/operate/rc/databases/configuration/data-eviction-policies.md

Lines changed: 28 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,34 @@ For each database, you can choose from these data eviction policies:
3535

3636
## Prevent data eviction
3737

38-
Redis Cloud supports [Auto Tiering]({{< relref "/operate/rs/databases/auto-tiering/" >}})
38+
Redis Cloud supports [Auto Tiering]({{< relref "/operate/rs/databases/auto-tiering/" >}})
3939
to prevent data eviction but maintain high performance.
4040

4141
Auto Tiering can extend your database across RAM and Flash Memory and intelligently manage "hot" (active) data in RAM and "cold" (less active) data in Flash memory (SSD).
42+
43+
## Active-Passive replication considerations
44+
45+
When using Active-Passive replication with [Replica Of]({{< relref "/operate/rs/databases/import-export/replica-of/" >}}), data eviction and expiration policies have important implications for data consistency.
46+
47+
{{< warning >}}
48+
**Do not write to the destination (passive) replica database.** Writing to the destination replica can cause serious data consistency issues and replication failures.
49+
{{< /warning >}}
50+
51+
### Problems caused by writing to passive replicas
52+
53+
In Active-Passive setups, eviction and expiration only operate on the active (source) database. When you write to the passive replica:
54+
55+
- **Memory management conflicts**: The passive replica cannot rely on eviction or expiration to manage local writes, requiring sufficient memory to handle both replicated data and local writes.
56+
- **Data inconsistency**: Local writes create differences between the source and destination databases, causing replicated commands to behave differently on each database.
57+
- **Replication failures**: Inconsistent data can cause replicated commands to fail with errors, which will cause the synchronization process to exit and break replication.
58+
59+
### Transitioning from passive to active
60+
61+
To properly transition a passive replica to become an active, writable database:
62+
63+
1. **Stop replication** using the Redis Cloud console interface
64+
2. **Remove the replicaOf source** by running the `REPLICAOF NO ONE` command on the database
65+
66+
Both steps are required to ensure the database can safely accept writes and manage its own eviction and expiration policies.
67+
68+

0 commit comments

Comments
 (0)