Skip to content

Commit 67fb21c

Browse files
Merge pull request #10021 from mendix/olu-backup-aug25
feat: update backup docs
2 parents ef60ae2 + f49198c commit 67fb21c

File tree

8 files changed

+21
-24
lines changed

8 files changed

+21
-24
lines changed

content/en/docs/deployment/mendix-cloud-deploy/backups/restore-backup-locally.md

Lines changed: 21 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ description: "This page describes how to restore a backup."
88

99
## Introduction
1010

11-
Restoring a backup locally can be useful if you want to test your cloud environment's data without interrupting your live cloud environment. This lets you see locally how your app behaves when using data in your cloud environment. By using Mendix Studio Pro and a PostgreSQL database, you can debug your app using backups of your cloud test/acceptance/production data.
11+
Restoring a backup locally can be useful if you want to test your cloud environment's data without interrupting your live cloud environment. This lets you see locally how your app behaves when using data in your cloud environment. By using Mendix Studio Pro and a PostgreSQL database, you can debug your app using backups of data from your cloud environments such as test/acceptance/production.
1212

1313
This how-to explains how to do the following:
1414

@@ -26,7 +26,7 @@ Before starting this how-to, make sure you have completed the following prerequi
2626

2727
{{% alert color="info" %}}You will need this password later to allow your Mendix app to access the restored data.{{% /alert %}}
2828

29-
{{% alert color="info" %}}This how-to was made with PostgreSQL version 9.6.5.{{% /alert %}}
29+
{{% alert color="info" %}}This how-to was made with PostgreSQL version 15.14{{% /alert %}}
3030

3131
* When you are restoring a database hosted in Mendix Cloud, or when downloading a full backup, your local machine must have [7-Zip](https://www.7-zip.org/) or another utility that can extract files from *.gz* and *.tar* archives.
3232

@@ -40,26 +40,26 @@ If your backup came from Mendix Cloud, it will have been compressed as a *.gz* f
4040
If you have downloaded a full backup, this will also have been archived as a *.tar* file, which you need to extract to get your *.backup* file containing the database backup. The *.backup* file is in the **db** folder of the archive.
4141
{{% /alert %}}
4242

43-
1. Start **pgAdmin 4** from the Windows start menu.
44-
2. Click the **+** in the **Browser** pane to open the **Servers > PostgreSQL 9.6** menu.
45-
3. Right-click **Databases** and **Create** a new database.
43+
1. Open the **pgAdmin 4** application on your computer.
44+
2. In the navigation pane, select **Default Workspace**.
45+
3. Click the **Object Explorer** to open the **Servers**
46+
4. Expand your specific PostgreSQL server instance. For example, PostgreSQL 15.
47+
5. Right-click the **Databases** and **Create** a new database.
4648

47-
{{< figure src="/attachments/deployment/mendix-cloud-deploy/backups/restore-backup-locally/add-database.png" class="no-border" >}}
49+
{{< figure src="/attachments/deployment/mendix-cloud-deploy/backups/restore-backup-locally/create-database.png" >}}
50+
6. Fill in the **Database** name.
51+
7. Select the correct **Owner** (the default is **postgres**)
52+
8. Click **Save**.
53+
9. Right-click the newly created database and click **Restore...**.
4854

49-
4. Fill in the **Database** name.
50-
5. Select the correct owner (the default is **postgres**) and click **Save**.
51-
6. Right-click the newly created database and click **Restore**.
55+
{{< figure src="/attachments/deployment/mendix-cloud-deploy/backups/restore-backup-locally/restore-db.png" >}}
56+
10. Select the **.backup** file you downloaded.
57+
11. Click the **Data Options** tab.
58+
12. Under **Do not save**, enable **Owner**.
5259

53-
{{< figure src="/attachments/deployment/mendix-cloud-deploy/backups/restore-backup-locally/restore-database.png" class="no-border" >}}
54-
55-
7. Select the **.backup** file you downloaded from the Team Server.
56-
8. Click the **Restore options** tab.
57-
9. Under **Do not save**, set **Owner** to **Yes**.
58-
59-
{{< figure src="/attachments/deployment/mendix-cloud-deploy/backups/restore-backup-locally/restore-options.png" class="no-border" >}}
60-
61-
10. Click **Restore**.
62-
11. Wait until you see a message that the backup is "Successfully completed." This message appears in the right corner of the screen.
60+
{{< figure src="/attachments/deployment/mendix-cloud-deploy/backups/restore-backup-locally/data-options.png" >}}
61+
13. Click **Restore**.
62+
14. Wait until you see a "Process Completed" message about the backup on your screen.
6363

6464
## Linking the Database to the App in Mendix Studio Pro
6565

@@ -72,7 +72,7 @@ After the backup has been restored as a local Postgres database, you have to lin
7272

7373
3. Under the tab **Configurations**, click **New**.
7474

75-
{{< figure src="/attachments/deployment/mendix-cloud-deploy/backups/restore-backup-locally/add-configuration.png" class="no-border" >}}
75+
{{< figure src="/attachments/deployment/mendix-cloud-deploy/backups/restore-backup-locally/studio-pro-config.png" >}}
7676

7777
4. Fill in the database information:
7878
* **Name**: *{a unique name}*
@@ -99,10 +99,7 @@ If you also want to restore the **FileDocuments**, follow these steps:
9999

100100
{{< figure src="/attachments/deployment/mendix-cloud-deploy/backups/restore-backup-locally/backup-choice.png" width=75% alt="" class="no-border" >}}
101101

102-
2. Select **App** > **Show App Directory in Explorer** from the Studio Pro menu:
103-
104-
{{< figure src="/attachments/deployment/mendix-cloud-deploy/backups/restore-backup-locally/project-directory.png" class="no-border" >}}
105-
102+
2. From the Studio Pro menu, select **App** > **Show App Directory in Explorer** (Windows) or **App** > **Show App Directory in Finder** (macOS)
106103
3. Navigate to the **deployment/data/files** folder within your app.
107104
4. Extract the *{backup name}.tar* file from the *.gz* archive using a program like 7-Zip.
108105
5. Extract the contents of your **tree** folder from the backup archive to the **deployment/data/files** folder within your app.
Binary file not shown.
62.4 KB
Loading
141 KB
Loading
125 KB
Loading
463 KB
Loading

0 commit comments

Comments
 (0)