Skip to content

Commit 49b9717

Browse files
authored
Merge pull request #16283 from ManikaDhiman/md-refs-changes-from-main
Pulled in ReFS changes from main
2 parents 43e8ea8 + 68c4892 commit 49b9717

File tree

3 files changed

+15
-13
lines changed

3 files changed

+15
-13
lines changed
172 KB
Loading

azure-stack/hci/manage/refs-deduplication-and-compression.md

Lines changed: 15 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Learn how to use ReFS deduplication and compression in Azure Local
44
author: alkohli
55
ms.author: alkohli
66
ms.topic: how-to
7-
ms.date: 10/29/2024
7+
ms.date: 11/08/2024
88
---
99

1010
# Optimize storage with ReFS deduplication and compression in Azure Local
@@ -45,23 +45,23 @@ You can use ReFS deduplication and compression via Windows Admin Center or Power
4545

4646
# [Windows Admin Center](#tab/windowsadmincenter)
4747

48-
In Windows Admin Center, you can create a schedule for ReFS deduplication and compression to run on an existing volume or a new volume during volume creation.
48+
In Windows Admin Center, you can create a schedule for ReFS deduplication to run on an existing volume or a new volume during volume creation. However, enabling compression is supported only via PowerShell.
4949

50-
Follow these steps to enable ReFS deduplication and compression via Windows Admin Center and set a schedule when it should run:
50+
Follow these steps to enable ReFS deduplication via Windows Admin Center and set a schedule when it should run:
5151

5252
1. Connect to a system, and then on the **Tools** pane on the left, select **Volumes**.
5353

54-
1. On the **Volumes** page, select the **Inventory** tab, select the appropriate volume, and then select **Settings**. To turn on ReFS deduplication and compression for a new volume, select **+ Create**.
54+
1. On the **Volumes** page, select the **Inventory** tab, select the appropriate volume, and then select **Settings**. To turn on ReFS deduplication for a new volume, select **+ Create**.
5555

56-
1. On the **Volume settings** pane on the right, under **More options** dropdown, select the **Use ReFS deduplication and compression** checkbox.
56+
1. On the **Volume settings** pane on the right, under **More options** dropdown, select the **Use ReFS deduplication** checkbox.
5757

58-
1. Select the days of the week when ReFS deduplication and compression should run, the time for a job to start running, and maximum duration (default is unlimited), and then select **Save**.
58+
1. Select the days of the week when ReFS deduplication should run, the time for a job to start running, and maximum duration (default is unlimited), and then select **Save**.
5959

60-
The following screenshot shows that ReFS deduplication and compression runs on Friday and Saturday at 10:40 AM with a maximum duration of 2 hours, starting from 9/22/2023. If the **Start** date was changed to 9/21/2023, the first run will still be 9/22/2023 10:40AM as that's the first Friday after 9/21/2023.
60+
The following screenshot shows that ReFS deduplication will run on Friday and Saturday at 10:00 PM with a maximum duration of 2 hours, starting from Friday 9/27/2024. If the **Start** date was changed to Monday 9/30/2024, the first run will be 10/4/2024 10:00 PM as that's the first Friday after 9/30/2024.
6161

62-
:::image type="content" source="media/refs-deduplication-and-compression/select-refs-deduplication-compression-settings.png" alt-text="Screenshot of the Volume settings pane displaying the ReFS deduplication and compression settings." lightbox="media/refs-deduplication-and-compression/select-refs-deduplication-compression-settings.png":::
62+
:::image type="content" source="media/refs-deduplication-and-compression/select-refs-deduplication-settings.png" alt-text="Screenshot of the Volume settings pane displaying the ReFS deduplication settings." lightbox="media/refs-deduplication-and-compression/select-refs-deduplication-settings.png":::
6363

64-
1. Verify the changes in the **Properties** section of the volume. The schedule appears under the **Properties** section and displays the savings breakdown and next scheduled run time. These savings are updated after each run, and you can observe the performance impact in the charts under the **Performance** section.
64+
1. Verify the changes in the **Properties** section of the volume. The schedule appears under the **Properties** section and displays the savings breakdown and next scheduled run time. These savings are updated after each run, and you can observe the performance impact in the charts under the **Performance** section. If compression is enabled via PowerShell, its savings will also show up on the **Properties** section.
6565

6666
:::image type="content" source="media/refs-deduplication-and-compression/volume-properties.png" alt-text="Screenshot of the properties section of a volume showing the savings breakdown and next scheduled run time." lightbox="media/refs-deduplication-and-compression/volume-properties.png":::
6767

@@ -309,10 +309,12 @@ Suspended : True
309309

310310
Disabling ReFS deduplication and compression on a volume stops any runs that are in progress and cancels future scheduled jobs. In addition, related volume metadata isn't retained, and file change tracking is stopped.
311311

312-
When you disable this feature, it doesn't undo deduplication or compression, as all the operations occur at the metadata layer. Over time, the data returns to its original state as the volume incurs reads and writes.
313-
314312
> [!NOTE]
315-
> You can perform decompression operations using [`ReFSUtil`](/windows-server/administration/windows-commands/refsutil).
313+
> When you disable this feature, it doesn't undo deduplication or compression, as all the operations occur at the metadata layer. Over time, deduplicated data returns to its original state as the volume incurs reads and writes. To decompress the data, ensure there is enough capacity available and use [ReFSUtil](/windows-server/administration/windows-commands/refsutil) to perform the following operation.
314+
>
315+
> ```powershell
316+
> refsutil compression /c /f NONE <vol>
317+
> ```
316318
317319
# [Windows Admin Center](#tab/windowsadmincenter)
318320
@@ -322,7 +324,7 @@ Follow these steps to disable the feature using Windows Admin Center:
322324
323325
1. On the **Volumes** page, select the **Inventory** tab, select the appropriate volume, and then select **Settings**.
324326
325-
1. On the **Volume settings** pane on the right, under **More options** dropdown, deselect the **Use ReFS deduplication and compression** checkbox, and then select **Save**.
327+
1. On the **Volume settings** pane on the right, under **More options** dropdown, deselect the **Use ReFS deduplication** checkbox, and then select **Save**.
326328
327329
# [PowerShell](#tab/powershell)
328330

0 commit comments

Comments
 (0)