You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: azure-stack/hci/manage/refs-deduplication-and-compression.md
+27-28Lines changed: 27 additions & 28 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -148,10 +148,9 @@ After you enable this feature, you can run a one-time job manually or schedule r
148
148
149
149
Before you run, you should also factor these other considerations:
150
150
151
-
- The first run after enabling this feature is always a full scan and optimization of the entire volume. If the `FullRun` parameter is specified, the optimization covers the entire volume rather than new or unoptimized data. Don't use the `FullRun` parameter when the `Type` is `DedupandCompress` or `Compress`.
152
151
- If you don't specify a compression format, the default algorithm is LZ4. You can change the algorithm from one run to another as needed.
153
152
- You can specify more parameters for more complex use cases. The cmdlet used in this section is for the simplest use case.
154
-
- The Full Run, Excluded folder, Excluded file extensions, and Minimum last modified time hours filters apply only when running deduplication, and don't apply when running compression.
153
+
- The Excluded folder, Excluded file extensions, and Minimum last modified time hours filters apply only when running deduplication, and don't apply when running compression.
155
154
156
155
**Manually run ReFS deduplication and compression jobs**
157
156
@@ -394,6 +393,32 @@ The duration limit is in place to prevent any performance impact on customer wor
394
393
395
394
The following section lists the known issues that currently exist with ReFS deduplication and compression.
396
395
396
+
### When Compression is enabled, using the `-FullRun` parameter on jobs after the first optimization run might result in a deadlock in the system.
397
+
398
+
**Status:** Open.
399
+
400
+
Avoid using `-FullRun` in manually started jobs unless the `Type` is `Dedup`.
401
+
402
+
Follow these steps as a temporary workaround to mitigate this issue:
403
+
404
+
1. Disable ReFS deduplication and compression on the volume:
405
+
406
+
```powershell
407
+
Disable-ReFSDedup -Volume <path>
408
+
```
409
+
410
+
1. Decompress the volume using `refsutil`:
411
+
412
+
```powershell
413
+
refsutil compression /c /f NONE <vol>
414
+
```
415
+
416
+
1. Re-enable ReFS deduplication and compression with the `Dedup` only mode, if needed:
417
+
418
+
```powershell
419
+
Enable-ReFSDedup -Volume <path> -Type Dedup
420
+
```
421
+
397
422
### Scheduling jobs to run simultaneously on multiple CSVs within a single cluster can potentially trigger CSV movements and negatively impact performance.
398
423
399
424
**Status:** Open.
@@ -422,32 +447,6 @@ Once ReFS deduplication and compression is disabled on a volume, the ETW channel
422
447
423
448
If the CSV is moved to another server of the cluster while compression is in progress, the job failed event isn't logged in the ReFS deduplication channel. However, we don't anticipate significant usage impact because of this issue.
424
449
425
-
### When Compression is enabled, using `-FullRun` on jobs after the first optimization run might result in a deadlock in the system.
426
-
427
-
**Status:** Open.
428
-
429
-
Avoid using `-FullRun` in manually started jobs unless the `Type` is `Dedup`.
430
-
431
-
Follow these steps as a temporary workaround to mitigate this issue:
432
-
433
-
1. Disable ReFS deduplication and compression on the volume:
434
-
435
-
```powershell
436
-
Disable-ReFSDedup -Volume <path>
437
-
```
438
-
439
-
1. Decompress the volume using `refsutil`:
440
-
441
-
```powershell
442
-
refsutil compression /c /f NONE <vol>
443
-
```
444
-
445
-
1. Re-enable ReFS deduplication and compression with the `Dedup` only mode, if needed:
0 commit comments