Skip to content

Commit f289ae5

Browse files
micheleRPFeediver1
andauthored
fix DR links (#1481)
Co-authored-by: Joyce Fee <102751339+Feediver1@users.noreply.github.com>
1 parent 85b906f commit f289ae5

File tree

6 files changed

+16
-17
lines changed

6 files changed

+16
-17
lines changed

modules/deploy/partials/high-availability.adoc

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -48,7 +48,7 @@ Consider the following Redpanda deployment strategies for the most common types
4848
| Offline backups
4949
|===
5050

51-
ifndef::env-kubernetes[See also: xref:./production/production-deployment.adoc[Deploy for Production]]
51+
ifndef::env-kubernetes[See also: xref:deploy:redpanda/manual/production/production-deployment.adoc[Deploy for Production]]
5252

5353
== HA deployment options
5454

@@ -253,7 +253,7 @@ rpk redpanda config set redpanda.rack <rackid>
253253

254254
The modified Ansible playbooks take a per-instance rack variable from the Terraform output and use that to set the relevant cluster and broker configuration. Redpanda deployment automation can provision public cloud infrastructure with discrete failure domains (`-var=ha=true`) and use the resulting inventory to provision rack-aware clusters using Ansible.
255255

256-
See also: xref:./production/production-deployment-automation.adoc[Automated Deployment]
256+
See also: xref:deploy:redpanda/manual/production/production-deployment-automation.adoc[Automated Deployment]
257257

258258
=== Single-AZ example
259259

modules/manage/pages/disaster-recovery/shadowing/failover-runbook.adoc

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -129,14 +129,15 @@ Name: <topic-name>, State: ACTIVE
129129
----
130130

131131
The partition information shows:
132+
132133
* **SRC_LSO**: Source partition Last Stable Offset
133134
* **SRC_HWM**: Source partition High Watermark
134135
* **DST_HWM**: Shadow (destination) partition High Watermark
135136
* **Lag**: Message count difference between source and shadow partitions
136137

137138
[IMPORTANT]
138139
====
139-
Note the replication lag to estimate potential data loss during failover. The `Tasks` section shows the health of shadow link replication tasks. For details about what each task does, see xref:setup.adoc#shadow-link-tasks[].
140+
Note the replication lag to estimate potential data loss during failover. The `Tasks` section shows the health of shadow link replication tasks. For details about what each task does, see xref:manage:disaster-recovery/shadowing/setup.adoc#shadow-link-tasks[Shadow link tasks].
140141
====
141142

142143
[[initiate-failover]]

modules/manage/pages/disaster-recovery/shadowing/failover.adoc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -97,7 +97,7 @@ The output shows individual topic states and any issues encountered during the f
9797
* **`NOT_RUNNING`**: Task is not currently executing
9898
* **`LINK_UNAVAILABLE`**: Task cannot communicate with the source cluster
9999

100-
For detailed information about shadow link tasks and their roles, see xref:setup.adoc#shadow-link-tasks[].
100+
For detailed information about shadow link tasks and their roles, see xref:manage:disaster-recovery/shadowing/setup.adoc#shadow-link-tasks[Shadow link tasks].
101101

102102

103103
== Post-failover cluster behavior

modules/manage/pages/disaster-recovery/shadowing/monitor.adoc

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -52,7 +52,7 @@ The status output includes:
5252

5353
* **Shadow link state**: Overall operational state (`ACTIVE`)
5454
* **Individual topic states**: Current state of each replicated topic (`ACTIVE`, `FAULTED`, `FAILING_OVER`, `FAILED_OVER`)
55-
* **Task status**: Health of replication tasks across brokers (`ACTIVE`, `FAULTED`, `NOT_RUNNING`, `LINK_UNAVAILABLE`). For details about shadow link tasks, see xref:setup.adoc#shadow-link-tasks[].
55+
* **Task status**: Health of replication tasks across brokers (`ACTIVE`, `FAULTED`, `NOT_RUNNING`, `LINK_UNAVAILABLE`). For details about shadow link tasks, see xref:manage:disaster-recovery/shadowing/setup.adoc#shadow-link-tasks[Shadow link tasks].
5656
* **Lag information**: Replication lag per partition showing source vs shadow high watermarks (HWM)
5757

5858
[[shadow-link-metrics]]
@@ -118,7 +118,7 @@ Configure monitoring alerts for:
118118
* **Connection errors**: When `redpanda_shadow_link_client_errors` increases rapidly
119119
* **Topic state changes**: When topics move to `FAULTED` state
120120
* **Task failures**: When replication tasks enter `FAULTED` or `NOT_RUNNING` states
121+
* **Throughput drops**: When bytes/records fetched drops significantly
121122
* **Link unavailability**: When tasks show `LINK_UNAVAILABLE` indicating source cluster connectivity issues
122-
123-
For more information about shadow link tasks and their states, see xref:setup.adoc#shadow-link-tasks[].
124-
* **Throughput drops**: When bytes/records fetched drops significantly
123+
+
124+
For more information about shadow link tasks and their states, see xref:manage:disaster-recovery/shadowing/setup.adoc#shadow-link-tasks[Shadow link tasks].

modules/manage/pages/disaster-recovery/shadowing/overview.adoc

Lines changed: 6 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -35,15 +35,13 @@ Shadowing complements Redpanda's existing availability and recovery capabilities
3535

3636
== Limitations
3737

38-
Shadowing is designed for active-passive disaster recovery scenarios. Each shadow cluster can maintain only one shadow link.
38+
Shadowing for disaster recovery currently has the following limitations:
3939

40-
Shadowing operates exclusively in asynchronous mode and doesn't support active-active configurations. This means there will always be some replication lag. You cannot write to both clusters simultaneously.
41-
42-
xref:develop:data-transforms/index.adoc[Data transforms] are not supported on shadow clusters while Shadowing is active. Writing to shadow topics is blocked.
43-
44-
During a disaster, xref:manage:audit-logging.adoc[audit log] history from the source cluster is lost, though the shadow cluster begins generating new audit logs immediately after the failover.
45-
46-
After you failover shadow topics, automatic fallback to the original source cluster is not supported.
40+
* Shadowing is designed for active-passive disaster recovery scenarios. Each shadow cluster can maintain only one shadow link.
41+
* Shadowing operates exclusively in asynchronous mode and doesn't support active-active configurations. This means there will always be some replication lag. You cannot write to both clusters simultaneously.
42+
* xref:develop:data-transforms/index.adoc[Data transforms] are not supported on shadow clusters while Shadowing is active. Writing to shadow topics is blocked.
43+
* During a disaster, xref:manage:audit-logging.adoc[audit log] history from the source cluster is lost, though the shadow cluster begins generating new audit logs immediately after the failover.
44+
* After you failover shadow topics, automatic fallback to the original source cluster is not supported.
4745

4846
== Best Practices
4947

modules/manage/pages/disaster-recovery/shadowing/setup.adoc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -127,7 +127,7 @@ Each task reports its status through the shadow link status API. Task states inc
127127

128128
You can pause individual tasks by setting the `paused` field to `true` in the corresponding configuration section. This allows you to selectively disable parts of the replication process without affecting the entire shadow link.
129129

130-
For monitoring task health and troubleshooting task issues, see xref:disaster-recovery:shadowing:monitor.adoc[Monitor Shadow Links].
130+
For monitoring task health and troubleshooting task issues, see xref:manage:disaster-recovery/shadowing/monitor.adoc[Monitor Shadow Links].
131131

132132
== What gets replicated
133133

0 commit comments

Comments
 (0)