Skip to content

Commit a45014a

Browse files
committed
Feature/add disaster recovery scripts and update backup configurations for 2025.3
1 parent 36fc76f commit a45014a

31 files changed

+286
-625
lines changed

content/en/docs/2025.3/Guides/disaster-recovery/multiple-server-with-ha/application-server/add-backup-to-application.md

Lines changed: 3 additions & 50 deletions
Original file line numberDiff line numberDiff line change
@@ -11,59 +11,12 @@ This guide describes how to configure a scheduled backup of the Application Serv
1111

1212
## Configure the Backup Script
1313

14-
1. In the `Cortex Innovation 2025.3 - App Server Install Scripts\Recovery` folder, locate the `Cortex.Innovation.Backup.ps1` script and open it with a text editor.
15-
1. Configure the script according to the details given below:
16-
17-
```powershell
18-
.\Cortex.Backup.ps1 `
19-
-ConfigFileName "Cortex.Application.Backup.Config.json" `
20-
-AutoRestoreOnDataLoss $false `
21-
-BackupPolicyName "Customer1.BackupPolicy1" `
22-
-MaxIncrementalBackups 5 `
23-
-BackupSchedule "Weekly" `
24-
-BackupDays @("Monday") `
25-
-BackupTimes @("00:00:00") `
26-
-BackupPath "\\UncPath\BackupLocation" `
27-
-RetentionDuration "24:00:00" `
28-
-MinimumNumberOfBackups 1 `
29-
-Credential $Credential
30-
```
31-
32-
| Name | Description |
33-
|------------------------------------------------|-------------|
34-
|`BackupPolicyName` | Configure this value with the unique name of the backup policy that will be set for the application policy and scheduled Windows task. |
35-
|`AutoRestoreOnDataLoss` | Configure the value as `$true` if you want to trigger restore automatically using the latest available backup in case the partition experiences a data loss event on your current application server.|
36-
|`MaxIncrementalBackups` | Configure this value with the maximum number of incremental backups to be taken between two full backups.<br /><br />This is just the upper limit.<br /><br />A full backup may be taken before specified number of incremental backups are completed in one of the following conditions<br /><br />&nbsp;- The replica has never taken a full backup since it has become primary,<br /><br />&nbsp;- Some of the log records since the last backup has been truncated, or<br /><br />&nbsp;- Replica passed the MaxAccumulatedBackupLogSizeInMB limit.|
37-
|`BackupSchedule` | Configure the value with either `Daily` or `Weekly` depending on when the schedule will run.|
38-
|`BackupDays` | This is only needed if the `BackupSchedule` is set to `Weekly`. Configure this value with the days of the week when the backup should run.|
39-
|`BackupTimes` | Configure the value with the times that the back up will run. The format of the value should be in ISO8601 format, date specified along with time will be ignored. |
40-
|`BackupPath` | Replace `\\UncPath\BackupLocation` with the path of the location the backups will be stored in. if the path is a network path then the `Credentials` will be used to access that location.|
41-
|`RetentionDuration` | Configure this value with the minimum duration for which a backup created, will remain stored in the storage and might get deleted after that span of time. The format of the value should be in ISO8601 format, date specified along with time will be ignored.|
42-
|`MinimumNumberOfBackups` | Configure this value with the minimum number of backups to be retained at any point of time. If specified with a non zero value, backups will not be deleted even if the backups have gone past retention duration and have number of backups less than or equal to it.|
43-
|`Credential` | The credentials of the user which will be used to access the `BackupPath`. It must be a domain user that is a member of the local Administrators group on the server. <br /><br /> This does not need to be changed, a prompt will appear to enter this information when the script is run.|
44-
45-
1. Save and close `Cortex.Innovation.Backup.ps1`.
14+
{{< section "/disaster-recovery/application-server/backup/configure-backup-script.md">}}
4615

4716
## Run the Backup Script
4817

49-
1. Open a Windows PowerShell (x64) window as administrator.
50-
1. Navigate PowerShell to inside the `Cortex Innovation 2025.3 - App Server Install Scripts\Recovery` folder using the following command, modifying the path as necessary:
51-
52-
```powershell
53-
cd "C:\Install\Cortex Innovation 2025.3 - App Server Install Scripts\Recovery"
54-
```
55-
56-
1. Type the following command into PowerShell:
57-
58-
```powershell
59-
.\Cortex.Innovation.Backup.ps1
60-
```
61-
62-
1. Run the PowerShell command to backup the application services.
63-
1. A credentials prompt will appear. Enter credentials of a domain user that is a member of the local Administrators group on the server and press OK.
64-
1. Wait for the script to finish running. This should take between 2 to 10 minutes.
65-
1. Check that there have been no errors in the script; these would appear in red in the console.
18+
{{< section "/disaster-recovery/application-server/backup/run-backup-script.md">}}
6619

6720
## Preserve installation files
6821

69-
Ensure that the installation files are backed up or kept on the server, especially the scripts and config files that have been modified. This will make it easier to delete or configure further scheduled backups in the future.
22+
{{< section "/disaster-recovery/application-server/preserve-scripts.md">}}

content/en/docs/2025.3/Guides/disaster-recovery/multiple-server-with-ha/application-server/recover-application-from-backup.md

Lines changed: 3 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -11,47 +11,16 @@ This guide describes how to recover the Application Server from a backup. This w
1111

1212
### Configure the Recover Script
1313

14-
1. In the `Cortex Innovation 2025.3 - App Server Install Scripts\Recovery` folder, locate the `Cortex.Innovation.Recover.ps1` script and open it with a text editor.
15-
1. Configure the script according to the details given below:
16-
17-
```powershell
18-
.\Cortex.Recover.ps1 `
19-
-ConfigFileName "Cortex.Application.Backup.Config.json" `
20-
-BackupPath "\\UncPath\BackupLocation" `
21-
-Credential $Credential
22-
```
23-
24-
| Name | Description |
25-
|------------------------------------------------|-------------|
26-
|`BackupPath` | Replace `\\UncPath\BackupLocation` with the path of the location the backups are stored in. if the path is a network path then the `Credentials` will be used to access that location.|
27-
|`Credential` | The credentials of the user which will be used to access the `BackupPath`. It must be a domain user that is a member of the local Administrators group on the server. <br /><br /> This does not need to be changed, a prompt will appear to enter this information when the script is run.|
28-
29-
1. Save and close `Cortex.Innovation.Recover.ps1`.
14+
{{< section "/disaster-recovery/application-server/recover/configure-recover-script.md">}}
3015

3116
### Run the Recover Script
3217

3318
{{% alert title="Note" %}}
3419
A backup policy must be configured on the application server before running a recovery, see {{< ahref path="Cortex.Guides.DisasterRecoveryGuides.MultipleServerWithHA.AddBackupToApplicationServer" title="Add Backup To Application Server" >}} for further information.
3520
{{% /alert %}}
3621

37-
1. Open a Windows PowerShell (x64) window as administrator.
38-
1. Navigate PowerShell to inside the `Cortex Innovation 2025.3 - App Server Install Scripts\Recovery` folder using the following command, modifying the path as necessary:
39-
40-
```powershell
41-
cd "C:\Install\Cortex Innovation 2025.3 - App Server Install Scripts\Recovery"
42-
```
43-
44-
1. Type the following command into PowerShell:
45-
46-
```powershell
47-
.\Cortex.Innovation.Recover.ps1
48-
```
49-
50-
1. Run the PowerShell command to recover the application services.
51-
1. A credentials prompt will appear. Enter credentials of a domain user that is a member of the local Administrators group on the server and press OK.
52-
1. Wait for the script to finish running. This should take 2 minutes.
53-
1. Check that there have been no errors in the script; these would appear in red in the console.
22+
{{< section "/disaster-recovery/application-server/recover/run-recover-script.md">}}
5423

5524
## Preserve installation files
5625

57-
Ensure that the installation files are backed up or kept on the server, especially the scripts and config files that have been modified. This will make it easier to recover the application in the future.
26+
{{< section "/disaster-recovery/application-server/preserve-scripts.md">}}

content/en/docs/2025.3/Guides/disaster-recovery/multiple-server-with-ha/application-server/remove-backup-from-application.md

Lines changed: 3 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -11,42 +11,12 @@ This guide describes how to delete a scheduled backup of the Application Server.
1111

1212
## Configure the Backup Script
1313

14-
1. In the `Cortex Innovation 2025.3 - App Server Install Scripts\Recovery` folder, locate the `Cortex.Innovation.Backup.ps1` script and open it with a text editor.
15-
1. Configure the script according to the details given below:
16-
17-
```powershell
18-
.\Cortex.Backup.ps1 `
19-
-ConfigFileName "Cortex.Application.Backup.Config.json" `
20-
-BackupPolicyName "Customer1.BackupPolicy1" `
21-
-Remove
22-
```
23-
24-
| Name | Description |
25-
|------------------------------------------------|-------------|
26-
|`BackupPolicyName` | Configure this value with the unique name of the backup policy that has been set for the application policy and scheduled windows task. |
27-
|`Remove` | Parameter used to indicate that the backup policy should be removed.|
14+
{{< section "/disaster-recovery/application-server/backup/configure-remove-backup-script.md">}}
2815

2916
## Run the Backup Script
3017

31-
1. Save and close `Cortex.Innovation.Backup.ps1`.
32-
1. Open a Windows PowerShell (x64) window as administrator.
33-
1. Navigate PowerShell to inside the `Cortex Innovation 2025.3 - App Server Install Scripts\Recovery` folder using the following command, modifying the path as necessary:
34-
35-
```powershell
36-
cd "C:\Install\Cortex Innovation 2025.3 - App Server Install Scripts\Recovery"
37-
```
38-
39-
1. Type the following command into PowerShell:
40-
41-
```powershell
42-
.\Cortex.Innovation.Backup.ps1
43-
```
44-
45-
1. Run the PowerShell command to backup the application services.
46-
1. A credentials prompt will appear. Enter credentials of a domain user that is a member of the local Administrators group on the server and press OK.
47-
1. Wait for the script to finish running. This should take 1 minute.
48-
1. Check that there have been no errors in the script; these would appear in red in the console.
18+
{{< section "/disaster-recovery/application-server/backup/run-backup-script.md">}}
4919

5020
## Preserve installation files
5121

52-
Ensure that the installation files are backed up or kept on the server, especially the scripts and config files that have been modified. This will make it easier to delete or configure further scheduled backups in the future.
22+
{{< section "/disaster-recovery/application-server/preserve-scripts.md">}}
Lines changed: 7 additions & 54 deletions
Original file line numberDiff line numberDiff line change
@@ -1,69 +1,22 @@
11
---
2-
title: "Add Scheduled Backup To Application Server"
3-
linkTitle: "Add Scheduled Backup To Application Server"
4-
description: "Information about backing up the application server."
2+
title: "Add Scheduled Backup To Flow Debugger"
3+
linkTitle: "Add Scheduled Backup To Flow Debugger"
4+
description: "Information about backing up the Flow Debugger."
55
weight: 40
66
---
77

88
# {{% param title %}}
99

10-
This guide describes how to configure a scheduled backup of the Application Server. This will backup the application's reliable collections, the cluster's configuration and the service's appsettings.
10+
This guide describes how to configure a scheduled backup of the Flow Debugger. This will backup the application's reliable collections, the cluster's configuration and the service's appsettings.
1111

1212
## Configure the Backup Script
1313

14-
1. In the `Cortex Innovation 2025.3 - App Server Install Scripts\Recovery` folder, locate the `Cortex.Innovation.Backup.ps1` script and open it with a text editor.
15-
1. Configure the script according to the details given below:
16-
17-
```powershell
18-
.\Cortex.Backup.ps1 `
19-
-ConfigFileName "Cortex.Application.Backup.Config.json" `
20-
-AutoRestoreOnDataLoss $false `
21-
-BackupPolicyName "Customer1.BackupPolicy1" `
22-
-MaxIncrementalBackups 5 `
23-
-BackupSchedule "Weekly" `
24-
-BackupDays @("Monday") `
25-
-BackupTimes @("00:00:00") `
26-
-BackupPath "\\UncPath\BackupLocation" `
27-
-RetentionDuration "24:00:00" `
28-
-MinimumNumberOfBackups 1 `
29-
-Credential $Credential
30-
```
31-
32-
| Name | Description |
33-
|------------------------------------------------|-------------|
34-
|`BackupPolicyName` | Configure this value with the unique name of the backup policy that will be set for the application policy and scheduled Windows task. |
35-
|`AutoRestoreOnDataLoss` | Configure the value as `$true` if you want to trigger restore automatically using the latest available backup in case the partition experiences a data loss event on your current application server.|
36-
|`MaxIncrementalBackups` | Configure this value with the maximum number of incremental backups to be taken between two full backups.<br /><br />This is just the upper limit.<br /><br />A full backup may be taken before specified number of incremental backups are completed in one of the following conditions<br /><br />&nbsp;- The replica has never taken a full backup since it has become primary,<br /><br />&nbsp;- Some of the log records since the last backup has been truncated, or<br /><br />&nbsp;- Replica passed the MaxAccumulatedBackupLogSizeInMB limit.|
37-
|`BackupSchedule` | Configure the value with either `Daily` or `Weekly` depending on when the schedule will run.|
38-
|`BackupDays` | This is only needed if the `BackupSchedule` is set to `Weekly`. Configure this value with the days of the week when the backup should run.|
39-
|`BackupTimes` | Configure the value with the times that the back up will run. The format of the value should be in ISO8601 format, date specified along with time will be ignored. |
40-
|`BackupPath` | Replace `\\UncPath\BackupLocation` with the path of the location the backups will be stored in. if the path is a network path then the `Credentials` will be used to access that location.|
41-
|`RetentionDuration` | Configure this value with the minimum duration for which a backup created, will remain stored in the storage and might get deleted after that span of time. The format of the value should be in ISO8601 format, date specified along with time will be ignored.|
42-
|`MinimumNumberOfBackups` | Configure this value with the minimum number of backups to be retained at any point of time. If specified with a non zero value, backups will not be deleted even if the backups have gone past retention duration and have number of backups less than or equal to it.|
43-
|`Credential` | The credentials of the user which will be used to access the `BackupPath`. It must be a domain user that is a member of the local Administrators group on the server. <br /><br /> This does not need to be changed, a prompt will appear to enter this information when the script is run.|
44-
45-
1. Save and close `Cortex.Innovation.Backup.ps1`.
14+
{{< section "/disaster-recovery/application-server/backup/configure-backup-script.md">}}
4615

4716
## Run the Backup Script
4817

49-
1. Open a Windows PowerShell (x64) window as administrator.
50-
1. Navigate PowerShell to inside the `Cortex Innovation 2025.3 - App Server Install Scripts\Recovery` folder using the following command, modifying the path as necessary:
51-
52-
```powershell
53-
cd "C:\Install\Cortex Innovation 2025.3 - App Server Install Scripts\Recovery"
54-
```
55-
56-
1. Type the following command into PowerShell:
57-
58-
```powershell
59-
.\Cortex.Innovation.Backup.ps1
60-
```
61-
62-
1. Run the PowerShell command to backup the application services.
63-
1. A credentials prompt will appear. Enter credentials of a domain user that is a member of the local Administrators group on the server and press OK.
64-
1. Wait for the script to finish running. This should take between 2 to 10 minutes.
65-
1. Check that there have been no errors in the script; these would appear in red in the console.
18+
{{< section "/disaster-recovery/application-server/backup/run-backup-script.md">}}
6619

6720
## Preserve installation files
6821

69-
Ensure that the installation files are backed up or kept on the server, especially the scripts and config files that have been modified. This will make it easier to delete or configure further scheduled backups in the future.
22+
{{< section "/disaster-recovery/application-server/preserve-scripts.md">}}

content/en/docs/2025.3/Guides/disaster-recovery/multiple-server-with-ha/web-application-server/flow-debugger/recover-flow-debugger-from-backup.md

Lines changed: 3 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -11,47 +11,16 @@ This guide describes how to recover the Application Server from a backup. This w
1111

1212
### Configure the Recover Script
1313

14-
1. In the `Cortex Innovation 2025.3 - App Server Install Scripts\Recovery` folder, locate the `Cortex.Innovation.Recover.ps1` script and open it with a text editor.
15-
1. Configure the script according to the details given below:
16-
17-
```powershell
18-
.\Cortex.Recover.ps1 `
19-
-ConfigFileName "Cortex.Application.Backup.Config.json" `
20-
-BackupPath "\\UncPath\BackupLocation" `
21-
-Credential $Credential
22-
```
23-
24-
| Name | Description |
25-
|------------------------------------------------|-------------|
26-
|`BackupPath` | Replace `\\UncPath\BackupLocation` with the path of the location the backups are stored in. if the path is a network path then the `Credentials` will be used to access that location.|
27-
|`Credential` | The credentials of the user which will be used to access the `BackupPath`. It must be a domain user that is a member of the local Administrators group on the server. <br /><br /> This does not need to be changed, a prompt will appear to enter this information when the script is run.|
28-
29-
1. Save and close `Cortex.Innovation.Recover.ps1`.
14+
{{< section "/disaster-recovery/application-server/recover/configure-recover-script.md">}}
3015

3116
### Run the Recover Script
3217

3318
{{% alert title="Note" %}}
3419
A backup policy must be configured on the application server before running a recovery, see {{< ahref path="Cortex.Guides.DisasterRecoveryGuides.MultipleServerWithHA.AddBackupToFlowDebugger" title="Backup Flow Debugger" >}} for further information.
3520
{{% /alert %}}
3621

37-
1. Open a Windows PowerShell (x64) window as administrator.
38-
1. Navigate PowerShell to inside the `Cortex Innovation 2025.3 - App Server Install Scripts\Recovery` folder using the following command, modifying the path as necessary:
39-
40-
```powershell
41-
cd "C:\Install\Cortex Innovation 2025.3 - App Server Install Scripts\Recovery"
42-
```
43-
44-
1. Type the following command into PowerShell:
45-
46-
```powershell
47-
.\Cortex.Innovation.Recover.ps1
48-
```
49-
50-
1. Run the PowerShell command to recover the application services.
51-
1. A credentials prompt will appear. Enter credentials of a domain user that is a member of the local Administrators group on the server and press OK.
52-
1. Wait for the script to finish running. This should take 2 minutes.
53-
1. Check that there have been no errors in the script; these would appear in red in the console.
22+
{{< section "/disaster-recovery/application-server/recover/run-recover-script.md">}}
5423

5524
## Preserve installation files
5625

57-
Ensure that the installation files are backed up or kept on the server, especially the scripts and config files that have been modified. This will make it easier to recover the application in the future.
26+
{{< section "/disaster-recovery/application-server/preserve-scripts.md">}}

0 commit comments

Comments
 (0)