Merge pull request #245620 from batamig/patch-364

d4iot backup and restore gaps

Author: v-regandowner

articles/defender-for-iot/organizations/back-up-restore-management.md

@@ -1,7 +1,7 @@
 ---
 title: Back up and restore the on-premises management console - Microsoft Defender for IoT
 description: Learn how to back up and restore the Microsoft Defender for IoT on-premises management console.
-ms.date: 03/09/2023
+ms.date: 07/31/2023
 ms.topic: how-to
 ---
 
@@ -14,7 +14,7 @@ Back up and restore your on-premises management console to help protect against
 - Use an SMB server to save your backup files to an external server
 - Restore the on-premises management console from the latest backup via CLI
 
-## Define backup and restore settings
+## Define automated backup and restore settings
 
 The on-premises management console is automatically backed up daily to the `/var/cyberx/backups` directory. Backup files do *not* include PCAP or log files, which must be manually backed up if needed.
 
@@ -23,6 +23,18 @@ We recommend that you configure your on-premises management console to automatic
 > [!NOTE]
 > Backup files can be used to restore an on-premises management console only if the on-premises management console's current software version is the same as the version in the backup file.
 
+## Manually extract a system backup file
+
+This procedure describes how to manually extract an on-premises management console backup file. Exported backup files can't be used by customers to restore an on-premises management console, and are only meant to be sent to customer support for analysis while troubleshooting.
+
+1. Sign into the on-premises management console as an admin user.
+1. Select **System settings** > **Export**.
+1. Under **Export Options**, select **System backup** and then select **Export**.
+
+    The exported file is created, and listed in the **Archived Files** grid at the bottom of the page.
+
+1. Click the filename to download your exported file. Make sure to view the OTP (One Time Password) to send it to support with your exported file.
+
 ## Start an immediate, unscheduled backup via CLI
 
 You may want to create a manual backup file, such as just after updating your OT sensor software.
@@ -94,7 +106,7 @@ To restore your OT sensor from the latest backup file via CLI:
 1. Run:
 
     ```bash
-    $ sudo cyberx-management-system-restore
+    $ sudo cyberx-management-system-restore -b <file path/file name>
     ```
 
 ## Next steps

articles/defender-for-iot/organizations/back-up-restore-sensor.md

@@ -1,7 +1,7 @@
 ---
 title: Back up and restore OT network sensors from the sensor console - Microsoft Defender for IoT
 description: Learn how to back up and restore Microsoft Defender for IoT OT network sensors from the sensor console.
-ms.date: 03/09/2023
+ms.date: 07/20/2023
 ms.topic: how-to
 ---
 
@@ -29,11 +29,15 @@ For more information, see [On-premises backup file capacity](references-data-ret
 
 If your OT sensor is configured *not* to run automatic backups, you can turn this back on manually in the `/var/cyberx/properties/backup.properties` file on the OT sensor machine.
 
-## Create a manual backup from the GUI
+## Create a manual backup file
 
-You may want to create a manual backup file, such as just after updating your OT sensor software.
+You may want to create a manual backup file, such as just after updating your OT sensor software, or when troubleshooting with customer support.
 
-**To create a manual backup file from the GUI**:
+To create a backup file that you can use to restore your sensor, use the CLI and run the `cyberx-xsense-system-backup` CLI command. For more information, see the [OT sensor CLI reference](cli-ot-sensor.md#start-an-immediate-unscheduled-backup).
+
+To create a protected backup file to send to the support team, use the sensor GUI. Backup files created from the sensor GUI can be opened only together with assistance from Microsoft support.
+
+**To create a manual backup file from the sensor GUI**:
 
 1. Sign into the OT sensor GUI and select **System settings** > **Sensor management** > **Health and troubleshooting** > **Backup & restore**.
 
@@ -43,18 +47,7 @@ You may want to create a manual backup file, such as just after updating your OT
     - Select the content you want to back up.
     - Select **Export**.
 
-Your new backup file is listed in the **Archived files** area of the backup pane.
-
-> [!NOTE]
-> Backup files can be used to restore data, but can't be opened without the one-time password (OTP) provided and assistance from Microsoft support. Open a support ticket if you need to open a backup file.
-
-## Start an immediate, unscheduled backup via CLI
-
-You may want to create a manual backup file, such as just after updating your OT sensor software.
-
-To run a manual backup from the CLI, use the `cyberx-xsense-system-backup` CLI command.
-
-For more information, see the [OT sensor CLI reference](cli-ot-sensor.md#start-an-immediate-unscheduled-backup).
+Your new, protected backup file is listed in the **Archived files** area of the backup pane.
 
 ## Save your backup to an external server (SMB)
 
@@ -105,26 +98,32 @@ We recommend saving your OT sensor backup files on your internal network. To do
 
     Set the `backup_directory_path` to the folder on your OT sensor where you want to save your backup files.
 
-## Restore an OT sensor from the GUI
+## Restore an OT sensor
 
-1. Sign into the OT sensor via SFTP and download the backup file you want to use to a location accessible from the OT sensor GUI.
+The following procedures describe how to restore your sensor using a backup file created via automatically or via CLI. Restoring your sensor using backup files created via the sensor GUI is supported only together with customer support.
+
+### Restore an OT sensor from the sensor GUI
+
+1. Sign into the OT sensor via SFTP and download the backup file you want to use to a location accessible from the OT sensor GUI. 
 
     Backup files are saved on your OT sensor machine, at `/var/cyberx/backups`, and are named using the following syntax: `<sensor name>-backup-version-<version>-<date>.tar`.
 
     For example: `Sensor_1-backup-version-2.6.0.102-2019-06-24_09:24:55.tar`
 
     > [!IMPORTANT]
-    > Make sure that the backup file you select uses the same OT sensor software version that's currently installed on your OT sensor.
+    > - Make sure that the backup file you select uses the same OT sensor software version that's currently installed on your OT sensor.
+    >
+    > - Your backup file must be one that had been generated automatically or manually via the CLI. If you're using a backup file generated manually by the GUI, you'll need to contact support to use it to restore your sensor.
  
-1. Sign into the OT sensor GUI and select **System settings** > **Sensor management** > **Health and troubleshooting** > **Backup & restore** > **Restore**. 
+1. Sign into the OT sensor GUI and select **System settings** > **Sensor management** > **Health and troubleshooting** > **Backup & restore** > **Restore**.
 
 1. Select **Browse** to select your downloaded backup file. The sensor will start to restore from the selected backup file.
 
 1. When the restore process is complete, select **Close**.
 
-## Restore an OT sensor from the latest backup via CLI
+### Restore an OT sensor from the latest backup via CLI
 
-To restore your OT sensor from the latest backup file via CLI:
+To restore your OT sensor from the latest, automatically generated backup file via CLI:
 
 1. Make sure that your backup file has the same OT sensor software version as the current software version on the OT sensor.
 
@@ -134,6 +133,5 @@ For more information, see the [OT sensor CLI reference](cli-ot-sensor.md#start-a
 
 ## Next steps
 
-[Maintain OT network sensors from the GUI](how-to-manage-individual-sensors.md)
-
-[Backup OT network sensors from the on-premises management console](back-up-sensors-from-management.md)
+- [Maintain OT network sensors from the GUI](how-to-manage-individual-sensors.md)
+- [Backup OT network sensors from the on-premises management console](back-up-sensors-from-management.md)