doc: added note about monitor ips update during failover

IP addresses in csi-config-map needs to be changed after failover to secondary site. Without this change, applications can't use mirrored rbd images. Signed-off-by: Kamil Madac <[email protected]>
ceph · Mar 15, 2024 · 34eac41 · 34eac41
1 parent c32dfc0
commit 34eac41
Showing 1 changed file with 7 additions and 0 deletions.
diff --git a/docs/design/proposals/clusterid-mapping.md b/docs/design/proposals/clusterid-mapping.md
@@ -178,3 +178,10 @@ operation from the primary cluster to a remote cluster. The existing volumes
 that are created on the remote cluster does not require any mapping as the
 volumeHandle already contains the required information about the local cluster (
 clusterID, poolID etc).
+
+**Note:-** To use a mirrored and promoted RBD image on a secondary site during a
+failover, you need to replace the primary monitor addresses with the IP
+addresses of the secondary cluster in the ceph-csi-config. Otherwise, Ceph-CSI
+won't be able to use the volumes, and application pods will become stuck in the
+`ContainerCreating` state. Thus, during failover, both clusters will have the
+same monitor IP addresses.