Skip to content

Commit fef32e2

Browse files
committed
Move warnings and change wording
1 parent d7f3566 commit fef32e2

File tree

2 files changed

+11
-16
lines changed

2 files changed

+11
-16
lines changed

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

Lines changed: 5 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -42,19 +42,10 @@ Auto Tiering can extend your database across RAM and Flash Memory and intelligen
4242

4343
## Active-Passive replication considerations
4444

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 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-
45+
When using [Active-Passive replication]({{< relref "/operate/rc/databases/migrate-databases#sync-using-active-passive" >}}), eviction and expiration only operate on the source (active) database. The target database does not evict or expire data while Active-Passive is enabled.
5946

47+
Do not write to the target database while Active-Passive is enabled. Doing so can cause the following issues:
6048

49+
- The target database cannot rely on eviction or expiration to manage local writes, requiring sufficient memory to handle both replicated data and local writes.
50+
- Local writes create differences between the source and target databases, causing replicated commands to behave differently on each database.
51+
- Inconsistent data can cause replicated commands to fail with errors, which will cause the synchronization process to exit and break replication.

content/operate/rc/databases/migrate-databases.md

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -56,7 +56,7 @@ Before you use Active-Passive, be aware of the following limitations:
5656

5757
- An error will appear when syncing the two databases if the source and target databases are hosted on different Redis Cloud accounts. [Contact support](https://redis.io/support/) if you want to migrate a database between accounts using Active-Passive.
5858

59-
- As long as Active-Passive is enabled, data in the target database will not expire and will not be evicted regardless of the set [data eviction policy]({{< relref "/operate/rc/databases/configuration/data-eviction-policies.md" >}}). We recommend that you turn off Active-Passive after the databases are synced.
59+
- As long as Active-Passive is enabled, data in the target database will not expire and will not be evicted regardless of the set [data eviction policy]({{< relref "/operate/rc/databases/configuration/data-eviction-policies.md" >}}). **Do not write to the target database while Active-Passive is enabled.** We recommend that you turn off Active-Passive after the databases are synced.
6060

6161
- Turning on Active-Passive will flush the target database. Make sure that your target database has no important data before you turn on Active-Passive.
6262
{{< /note >}}
@@ -135,7 +135,11 @@ Follow these detailed steps to migrate data using Active-Passive syncing:
135135

136136
{{<image filename="images/rc/migrate-data-status-synced.png" alt="When the data is migrated, the target database status displays `Synced`." width=100px >}}
137137

138-
Active-Passive sync lets you migrate data while apps and other connections are using the source database. Once the data is migrated, you should migrate active connections to the target database.
138+
Active-Passive sync lets you migrate data while apps and other connections are using the source database. Once the data is migrated, you should migrate active connections to the target database.
139+
140+
{{< warning >}}
141+
Do not write to the target database until turning off Active-Passive. Writing to the target database of an Active-Passive setup can cause data consistency issues and replication failures. See [Active-Passive replication considerations]({{< relref "/operate/rc/databases/configuration/data-eviction-policies.md#active-passive-replication-considerations" >}}) for more information.
142+
{{< /warning >}}
139143

140144
## Active-Passive memory requirements
141145

0 commit comments

Comments
 (0)