Feature/update disaster recovery documentation for clarity and consistency in recovery instructions

cortex-sa · cortex-sa · commit edce0bc615ac · 2025-04-29T15:53:18.000+01:00
diff --git a/content/en/docs/2025.3/Guides/disaster-recovery/multiple-server-with-ha/recovery/recover-encryption-key-from-backup.md b/content/en/docs/2025.3/Guides/disaster-recovery/multiple-server-with-ha/recovery/recover-encryption-key-from-backup.md
@@ -26,7 +26,7 @@ If recovering to new hardware, the Encryption Key must be recovered before {{% c
 
     | Name                                           | Description |
     |------------------------------------------------|-------------|
-    |`TargetMachines`                                | Configure the value with the names of the application servers, the web application server and load balancer server if using the built-in load balancer.|
+    |`TargetMachines`                                | Configure the values to contain the NETBIOS name or fully qualified domain name of the application servers, the web application server and load balancer server if using the built-in load balancer.|
     |`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.|
     |`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.|
 
diff --git a/content/en/docs/2025.3/Guides/disaster-recovery/single-server-without-ha/backup/pre-backup.md b/content/en/docs/2025.3/Guides/disaster-recovery/single-server-without-ha/backup/pre-backup.md
@@ -9,7 +9,7 @@ weight: 20
 
 This guide describes how to perform the steps required before starting the backup of {{% ctx %}}.
 
-## Make Installation Artefacts Available on all Servers
+## Make Installation Artefacts Available
 
 {{< section "/disaster-recovery/single-make-installation-artefacts-available.md">}}
 
diff --git a/content/en/docs/2025.3/Guides/disaster-recovery/single-server-without-ha/recovery/pre-recovery.md b/content/en/docs/2025.3/Guides/disaster-recovery/single-server-without-ha/recovery/pre-recovery.md
@@ -9,7 +9,7 @@ weight: 20
 
 This guide describes how to perform the steps required before starting the recovery of {{% ctx %}}.
 
-## Make Installation Artefacts Available on all Servers
+## Make Installation Artefacts Available
 
 {{< section "/disaster-recovery/single-make-installation-artefacts-available.md">}}
 
diff --git a/content/en/docs/2025.3/Guides/disaster-recovery/single-server-without-ha/recovery/recover-application-from-backup.md b/content/en/docs/2025.3/Guides/disaster-recovery/single-server-without-ha/recovery/recover-application-from-backup.md
@@ -16,7 +16,7 @@ This guide describes how to recover the Application Server from a backup. This w
 ### Run the Recovery Script
 
 {{% alert title="Warning" color="warning" %}}
-A backup policy must be configured on the Application Server before running a recovery, see {{< ahref path="Cortex.Guides.DisasterRecoveryGuides.SingleServerWithoutHA.Backup.AddBackupToApplicationServer" title="Add Backup To Application Server" >}}  for further information.
+A backup policy must be configured on the Application Server before running a recovery, see {{< ahref path="Cortex.Guides.DisasterRecoveryGuides.SingleServerWithoutHA.Backup.AddBackupToApplicationServer" title="Add Backup to Application Server" >}}  for further information.
 {{% /alert %}}
 
 {{< section "/disaster-recovery/application-server/recover/run-recover-script.md">}}
diff --git a/content/en/docs/2025.3/Guides/disaster-recovery/single-server-without-ha/recovery/recover-encryption-key-from-backup.md b/content/en/docs/2025.3/Guides/disaster-recovery/single-server-without-ha/recovery/recover-encryption-key-from-backup.md
@@ -10,7 +10,7 @@ weight: 30
 This guide describes how to recover the Encryption Key from a backup. This will recover the Encryption key to the web application server.
 
 {{% alert title="Warning" color="warning" %}}
-The Encryption Key must be recovered before any installation of {{% ctx %}}.
+If recovering to new hardware, the Encryption Key must be recovered before {{% ctx %}} is installed.
 {{% /alert %}}
 
 ### Configure the Recovery Script
@@ -26,7 +26,7 @@ The Encryption Key must be recovered before any installation of {{% ctx %}}.
 
     | Name                                           | Description |
     |------------------------------------------------|-------------|
-    |`TargetMachines`                                | Configure the value with the name of the web application server.|
+    |`TargetMachines`                                | Configure the value to contain the NETBIOS name or fully qualified domain name of the web application server.|
     |`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.|
     |`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.|
 
diff --git a/content/en/docs/2025.3/Guides/disaster-recovery/single-server-without-ha/recovery/recover-web-application-from-backup.md b/content/en/docs/2025.3/Guides/disaster-recovery/single-server-without-ha/recovery/recover-web-application-from-backup.md
@@ -16,7 +16,7 @@ This guide describes how to recover the Web Application Server from a backup. Th
 ### Run the Recovery Script
 
 {{% alert title="Note" %}}
-A backup policy should be configured on the web application server before running a recovery, see {{< ahref path="Cortex.Guides.DisasterRecoveryGuides.SingleServerWithoutHA.Backup.AddBackupToWebApplicationServer" title="Add Backup To Web Application Server" >}} for further information.
+A backup policy should be configured on the web application server before running a recovery, see {{< ahref path="Cortex.Guides.DisasterRecoveryGuides.SingleServerWithoutHA.Backup.AddBackupToWebApplicationServer" title="Add Backup to Web Application Server" >}} for further information.
 {{% /alert %}}
 
 {{< section "/disaster-recovery/web-application-server/recover/run-recover-script.md">}}
diff --git a/content/en/docs/2025.3/_shared/disaster-recovery/encryption-key/recover/run-recover-script.md b/content/en/docs/2025.3/_shared/disaster-recovery/encryption-key/recover/run-recover-script.md
@@ -11,7 +11,7 @@
     .\Cortex.Innovation.EncryptionKey.Recover.ps1
     ```
 
-1. Run the PowerShell command to recover the application services.
+1. Run the PowerShell command to recover the Encryption Key.
 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.
 1. Wait for the script to finish running. This should take approximately 1 minute.
 1. Check that there have been no errors in the script; these would appear in red in the console.
