Skip to content

Commit 6d49384

Browse files
committed
opensearch btar
1 parent 290af35 commit 6d49384

File tree

1 file changed

+56
-9
lines changed

1 file changed

+56
-9
lines changed

docs/platform/concepts/backup-to-another-region.md

Lines changed: 56 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,8 @@ sidebar_label: Backup to another region
55
---
66

77
import RelatedPages from "@site/src/components/RelatedPages";
8+
import Tabs from '@theme/Tabs';
9+
import TabItem from '@theme/TabItem';
810

911
In addition to the primary service backup, you can have a secondary backup in an alternative location.
1012

@@ -27,18 +29,60 @@ BTAR is supported for the following services:
2729

2830
## How BTAR works
2931

30-
When you enable the backup to another region (BTAR) feature, an additional service backup
31-
is created in the cloud region of your choice that is alternative to the primary backup
32+
When you enable the backup to another region (BTAR) feature, additional service backups
33+
are created in the cloud region of your choice that is alternative to the primary backup
3234
location.
3335

36+
Restoring from a secondary backup, for example in case of an outage of the primary region,
37+
can be done by creating a fork of the service in the region where the secondary backup is
38+
located.
39+
40+
<Tabs groupId="group1">
41+
<TabItem value="sql-relational" label="PostgreSQL & MySQL" default>
42+
3443
Secondary backups are generated from primary backups, not from the service itself. For
3544
this reason, your secondary backup becomes available only after the primary backup is
3645
taken. There might be a data replication lag between the primary region and the secondary
3746
region.
3847

39-
Restoring from a secondary backup, for example in case of an outage of the primary region,
40-
can be done by creating a fork of the service in the region where the secondary backup is
41-
located.
48+
```mermaid
49+
flowchart LR
50+
subgraph Primary_region
51+
direction TB
52+
subgraph Service_X
53+
end
54+
subgraph Primary_backups
55+
direction LR
56+
PB1
57+
PB2
58+
PB3
59+
PBn
60+
end
61+
end
62+
subgraph Secondary_region
63+
direction TB
64+
subgraph Forked_service_X
65+
end
66+
subgraph Secondary_backups
67+
direction LR
68+
SB1
69+
SB2
70+
SB3
71+
SBn
72+
end
73+
end
74+
Service_X -- Default backups --> Primary_backups
75+
Primary_backups -- Cross-region backups<br/>if BTAR enabled --> Secondary_backups
76+
Secondary_backups -- Secondary backups<br/>to restore service X --> Forked_service_X
77+
Service_X -- Forking service X<br/>if primary region down --> Forked_service_X
78+
```
79+
80+
</TabItem>
81+
<TabItem value="non-sql-search-analytics" label="OpenSearch">
82+
83+
An additional snapshot repository is created in the secondary region. In this repository,
84+
BTAR snapshots are generated directly from the service. They are managed in sync with
85+
changes to snapshots in the primary region.
4286

4387
```mermaid
4488
flowchart LR
@@ -66,12 +110,15 @@ flowchart LR
66110
SBn
67111
end
68112
end
69-
Service_X -- Default \n backups --> Primary_backups
70-
Primary_backups -- Cross-region backups \n if BTAR enabled --> Secondary_backups
71-
Secondary_backups -- Secondary backups \n to restore service X --> Forked_service_X
72-
Service_X -- Forking service X \n if primary region down --> Forked_service_X
113+
Service_X -- Default backups --> Primary_backups
114+
Primary_backups -- Cross-region backups<br/>if BTAR enabled --> Secondary_backups
115+
Secondary_backups -- Secondary backups<br/>to restore service X --> Forked_service_X
116+
Service_X -- Forking service X<br/>if primary region down --> Forked_service_X
73117
```
74118

119+
</TabItem>
120+
</Tabs>
121+
75122
## Limitations
76123

77124
- BTAR is supported for Aiven for MySQL®, Aiven for PostgreSQL®, and Aiven for OpenSearch®.

0 commit comments

Comments
 (0)