Skip to content

Commit 36b52bb

Browse files
Merge pull request #4420 from ovh/public_cloud_db_point_in_time_recovery
Rework the backup guide. Reflect changes on the PITR and fork page.
2 parents bb794bf + 98231ec commit 36b52bb

29 files changed

+917
-317
lines changed

pages/platform/databases/databases_06_restore_backup/guide.de-de.md

Lines changed: 61 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -6,10 +6,10 @@ section: General guides
66
order: 060
77
routes:
88
canonical: 'https://docs.ovh.com/gb/en/publiccloud/databases/restore-backup'
9-
updated: 2022-05-04
9+
updated: 2023-03-27
1010
---
1111

12-
**Last updated May 4th, 2022**
12+
**Last updated March 27th, 2023**
1313

1414
## Objective
1515

@@ -25,72 +25,112 @@ We continuously improve our offers. You can follow and submit ideas to add to ou
2525
- A [Public Cloud database service](https://www.ovhcloud.com/de/public-cloud/databases/) up and running
2626

2727
## Before we begin
28-
In this guide we will use a Postgresql database engine as an example, but the procedure is exactly the same for all other engines.
28+
29+
In this guide we will use a PostgreSQL database engine as an example, but the procedure is exactly the same for all other engines.
2930

3031
You can learn more about how backups works on the [Automated backups guide](https://docs.ovh.com/de/publiccloud/databases/backups/).
3132

3233
Restoration of a backup is done by creating a new service and pushing the backup data to this new service. This full process is called forking and is fully automated. Once this process is done, you will have two independent service running, the one from which the backup comes from, and a new one on which the backup data has been imported.
3334

34-
3535
## Instructions
36+
3637
### Step 1: Select the database service you want to restore data from
38+
3739
First you need to go on the overview page of the service you want to restore the backup from.
3840

3941
![Select service](images/service-selection.png){.thumbnail}
4042

4143
### Step 2: Go to the backup tab
44+
4245
In the tab list click on `Backups`{.action}.
4346

44-
![service overview](images/service-overview.png){.thumbnail}
47+
![Service overview](images/service-overview.png){.thumbnail}
4548

4649
### Step 3: Select the backup to restore from
50+
4751
Select the backup from which you want to restore from. To help you choose, observe the dates at which the backups have been performed in the "Creation date" column.
4852
Click on the `...`{.action} button corresponding to the chosen backup. Then click on `Duplicate (Fork)`{.action} to go on the configuration page of the new service.
4953

5054
> [!warning]
5155
> The MongoDB service has the option to restore a backup in place, meaning restoring the backup on the same service. This option will rollback ALL data to the state it was in when the backup was done. This can induce data loss.
5256
53-
54-
![backup tab](images/backup-tab.png){.thumbnail}
57+
![Backup tab](images/backup-tab.png){.thumbnail}
5558

5659
### Step 4: Configure the target service
60+
5761
As seen before, when restoring a backup you create a new separate database service on which the backup data will be imported. You are able to configure this new service as you wish.
58-
#### Engine
59-
For obvious reasons, you can not change the engine, this option is greyed. Same goes for the engine version, you will be able to update engine version once the new service is running.
6062

61-
![engine selection](images/engine-selection.png){.thumbnail}
63+
#### Immutable options
64+
65+
For obvious reasons, you cannot change the engine, this option is not offered. The same goes for the engine version, you will be able to update it once the new service is running.
66+
67+
The region is not modifiable as well, your new service will be on the same region as the old one.
68+
69+
You will find a reminder of all these options in the order summary.
70+
71+
![Immutable options](images/immutable-options.png){.thumbnail}
72+
73+
#### Restore point
74+
75+
You have to choose a restore point from which the service will be duplicated.
76+
77+
##### **Backup**
78+
79+
The most common option is to restore from a backup.
80+
81+
![Restore point from backup](images/restore-point-selection-backup.png){.thumbnail}
82+
83+
##### **Specific date and latest**
84+
85+
If your service supports point in time recovery (see the [Automated Backup guide](https://docs.ovh.com/de/publiccloud/databases/backups/) for more details), you will also be offered the option to restore from a specific date and time.
86+
87+
![Restore point from a specific date](images/restore-point-selection-date.png){.thumbnail}
88+
89+
You will also be offered the ease to choose the most recent date directly.
90+
91+
![Restore point from latest](images/restore-point-selection-latest.png){.thumbnail}
6292

6393
#### Plan
94+
6495
When restoring a backup you can select another service plan.
6596

66-
![plan selection](images/plan-selection.png){.thumbnail}
97+
![Plan selection](images/plan-selection.png){.thumbnail}
6798

68-
#### Region
69-
We currently don't allow changing the region. Your new service must be on the same region as the old one.
99+
#### Nodes
70100

71-
![region selection](images/region-selection.png){.thumbnail}
101+
You can choose to upgrade the node to a bigger flavor.
72102

73-
#### Nodes
74-
You are able to change the node flavor of the service. Please note that the selection is restricted, depending on backup size. You can't restore a 400 GB data set on a node with only 320 GB of disk space.
103+
![Node selection](images/node-selection.png){.thumbnail}
104+
105+
> [!primary]
106+
> The flavor downgrade will soon be offered. The limitation being that the targeted flavor must have enough storage to restore the backup.
107+
108+
#### Sizing
75109

76-
![node selection](images/node-selection.png){.thumbnail}
110+
Additional storage can be ordered while forking the service.
111+
112+
![Sizing selection](images/sizing-selection.png){.thumbnail}
113+
114+
> [!primary]
115+
> The storage reduction will soon be offered. The limitation being that the targeted total storage must be large enough to restore the backup.
77116
78117
#### Options
79-
You can update the database name.
80118

81-
![engine selection](images/option-selection.png){.thumbnail}
119+
You can update the network options.
82120

121+
![Options selection](images/option-selection.png){.thumbnail}
83122

84-
Now click on `Create a database service`{.action} and the new service will be created. Please note that depending on the backup size it can take some time before the service is available.
123+
Now click on `Create a fork`{.action} and the new service will be created. Please note that depending on the backup size it can take some time before the service is available.
85124

86125
### Step 5: Wait for service creation
126+
87127
You now just have to wait for your service to be ready.
88128
This new service is now completly independent from the one you forked the backup from. You can safely delete the old service without impacting the new one.
89129

90130
> [!warning]
91131
> The newly created service does not duplicate IP restrictions nor users which were created on the old service. You will have to recreate those before using your new service.
92132
93-
![forked service](images/forked-service.png){.thumbnail}
133+
![Forked service](images/forked-service.png){.thumbnail}
94134

95135
## We want your feedback!
96136

pages/platform/databases/databases_06_restore_backup/guide.en-asia.md

Lines changed: 61 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -4,10 +4,10 @@ slug: restore-backup
44
excerpt: Find out how to restore a backup
55
section: General guides
66
order: 060
7-
updated: 2022-05-04
7+
updated: 2023-03-27
88
---
99

10-
**Last updated May 4th, 2022**
10+
**Last updated March 27th, 2023**
1111

1212
## Objective
1313

@@ -23,72 +23,112 @@ We continuously improve our offers. You can follow and submit ideas to add to ou
2323
- A [Public Cloud database service](https://www.ovhcloud.com/asia/public-cloud/databases/) up and running
2424

2525
## Before we begin
26-
In this guide we will use a Postgresql database engine as an example, but the procedure is exactly the same for all other engines.
26+
27+
In this guide we will use a PostgreSQL database engine as an example, but the procedure is exactly the same for all other engines.
2728

2829
You can learn more about how backups works on the [Automated backups guide](https://docs.ovh.com/asia/en/publiccloud/databases/backups/).
2930

3031
Restoration of a backup is done by creating a new service and pushing the backup data to this new service. This full process is called forking and is fully automated. Once this process is done, you will have two independent service running, the one from which the backup comes from, and a new one on which the backup data has been imported.
3132

32-
3333
## Instructions
34+
3435
### Step 1: Select the database service you want to restore data from
36+
3537
First you need to go on the overview page of the service you want to restore the backup from.
3638

3739
![Select service](images/service-selection.png){.thumbnail}
3840

3941
### Step 2: Go to the backup tab
42+
4043
In the tab list click on `Backups`{.action}.
4144

42-
![service overview](images/service-overview.png){.thumbnail}
45+
![Service overview](images/service-overview.png){.thumbnail}
4346

4447
### Step 3: Select the backup to restore from
48+
4549
Select the backup from which you want to restore from. To help you choose, observe the dates at which the backups have been performed in the "Creation date" column.
4650
Click on the `...`{.action} button corresponding to the chosen backup. Then click on `Duplicate (Fork)`{.action} to go on the configuration page of the new service.
4751

4852
> [!warning]
4953
> The MongoDB service has the option to restore a backup in place, meaning restoring the backup on the same service. This option will rollback ALL data to the state it was in when the backup was done. This can induce data loss.
5054
51-
52-
![backup tab](images/backup-tab.png){.thumbnail}
55+
![Backup tab](images/backup-tab.png){.thumbnail}
5356

5457
### Step 4: Configure the target service
58+
5559
As seen before, when restoring a backup you create a new separate database service on which the backup data will be imported. You are able to configure this new service as you wish.
56-
#### Engine
57-
For obvious reasons, you can not change the engine, this option is greyed. Same goes for the engine version, you will be able to update engine version once the new service is running.
5860

59-
![engine selection](images/engine-selection.png){.thumbnail}
61+
#### Immutable options
62+
63+
For obvious reasons, you cannot change the engine, this option is not offered. The same goes for the engine version, you will be able to update it once the new service is running.
64+
65+
The region is not modifiable as well, your new service will be on the same region as the old one.
66+
67+
You will find a reminder of all these options in the order summary.
68+
69+
![Immutable options](images/immutable-options.png){.thumbnail}
70+
71+
#### Restore point
72+
73+
You have to choose a restore point from which the service will be duplicated.
74+
75+
##### **Backup**
76+
77+
The most common option is to restore from a backup.
78+
79+
![Restore point from backup](images/restore-point-selection-backup.png){.thumbnail}
80+
81+
##### Specific date and latest
82+
83+
If your service supports point in time recovery (see [Automated Backup guide](https://docs.ovh.com/asia/en/publiccloud/databases/backups/) for more details), you will also be offered the option to restore from a specific date and time.
84+
85+
![Restore point from a specific date](images/restore-point-selection-date.png){.thumbnail}
86+
87+
You will also be offered the ease to choose the most recent date directly.
88+
89+
![Restore point from latest](images/restore-point-selection-latest.png){.thumbnail}
6090

6191
#### Plan
92+
6293
When restoring a backup you can select another service plan.
6394

64-
![plan selection](images/plan-selection.png){.thumbnail}
95+
![Plan selection](images/plan-selection.png){.thumbnail}
6596

66-
#### Region
67-
We currently don't allow changing the region. Your new service must be on the same region as the old one.
97+
#### Nodes
6898

69-
![region selection](images/region-selection.png){.thumbnail}
99+
You can choose to upgrade the node to a bigger flavor.
70100

71-
#### Nodes
72-
You are able to change the node flavor of the service. Please note that the selection is restricted, depending on backup size. You can't restore a 400 GB data set on a node with only 320 GB of disk space.
101+
![Node selection](images/node-selection.png){.thumbnail}
102+
103+
> [!primary]
104+
> The flavor downgrade will soon be offered. The limitation being that the targeted flavor must have enough storage to restore the backup.
105+
106+
#### Sizing
73107

74-
![node selection](images/node-selection.png){.thumbnail}
108+
Additional storage can be ordered while forking the service.
109+
110+
![Sizing selection](images/sizing-selection.png){.thumbnail}
111+
112+
> [!primary]
113+
> The storage reduction will soon be offered. The limitation being that the targeted total storage must be large enough to restore the backup.
75114
76115
#### Options
77-
You can update the database name.
78116

79-
![engine selection](images/option-selection.png){.thumbnail}
117+
You can update the network options.
80118

119+
![Options selection](images/option-selection.png){.thumbnail}
81120

82-
Now click on `Create a database service`{.action} and the new service will be created. Please note that depending on the backup size it can take some time before the service is available.
121+
Now click on `Create a fork`{.action} and the new service will be created. Please note that depending on the backup size it can take some time before the service is available.
83122

84123
### Step 5: Wait for service creation
124+
85125
You now just have to wait for your service to be ready.
86126
This new service is now completly independent from the one you forked the backup from. You can safely delete the old service without impacting the new one.
87127

88128
> [!warning]
89129
> The newly created service does not duplicate IP restrictions nor users which were created on the old service. You will have to recreate those before using your new service.
90130
91-
![forked service](images/forked-service.png){.thumbnail}
131+
![Forked service](images/forked-service.png){.thumbnail}
92132

93133
## We want your feedback!
94134

0 commit comments

Comments
 (0)