Skip to content

Commit 9b8d575

Browse files
author
Manika Dhiman
committed
added review feedback
1 parent fae0d87 commit 9b8d575

File tree

1 file changed

+27
-28
lines changed

1 file changed

+27
-28
lines changed

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

Lines changed: 27 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -148,10 +148,9 @@ After you enable this feature, you can run a one-time job manually or schedule r
148148
149149
Before you run, you should also factor these other considerations:
150150
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`.
152151
- 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.
153152
- 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.
155154
156155
**Manually run ReFS deduplication and compression jobs**
157156
@@ -394,6 +393,32 @@ The duration limit is in place to prevent any performance impact on customer wor
394393

395394
The following section lists the known issues that currently exist with ReFS deduplication and compression.
396395

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+
397422
### Scheduling jobs to run simultaneously on multiple CSVs within a single cluster can potentially trigger CSV movements and negatively impact performance.
398423
399424
**Status:** Open.
@@ -422,32 +447,6 @@ Once ReFS deduplication and compression is disabled on a volume, the ETW channel
422447

423448
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.
424449

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:
446-
447-
```powershell
448-
Enable-ReFSDedup -Volume <path> -Type Dedup
449-
```
450-
451450
## Next steps
452451

453452
- [Manage volume](./manage-volumes.md).

0 commit comments

Comments
 (0)