Update Service_Fabric_ReleaseNotes_91CU3.md

documentation

release_notes/Service_Fabric_ReleaseNotes_91CU3.md

@@ -23,10 +23,10 @@ The following packages and versions are part of this release:
 |-|-|-|-|
 | **Windows - 9.1.1653.9590<br>Ubuntu 18 - 9.1.1457.1<br>Ubuntu 20 - 9.1.1457.1** | **Feature** | Key Value Store (KVS) | **Brief Description**:  Auto-compaction of all KVS databases based on free page size % has been added by default and takes advantage of the new FreePageSizeThresholdInPercent setting. The default value of this setting is 30% so databases with greater than 30% free page size will be auto-compacted. At this time auto-compaction will also occur based on the legacy settings of CompactionThresholdInMB, FreePageSizeThresholdInMB, and CompactionProbabilityInPercent. Due to this databases will be compacted more frequently based on free page %<br>**Solution**: Customers should start using the new FreePageSizeThresholdInPercent property for customizing when offline auto-compaction occurs as the legacy settings will be removed in the next major Service Fabric runtime update. <br>**Workaround**: Auto-compaction based on FreePageSizeThresholdInPercent can be disabled by setting the value to 100
 | **Windows - 9.1.1653.9590<br>Ubuntu 18 - 9.1.1457.1<br>Ubuntu 20 - 9.1.1457.1** | **Feature** | Key Value Store (KVS) | **Brief Description**: All databases will now be regularly defragmented for accurate calculation of the free page size which is used to determine auto-compaction. Default value for DefragThresholdInMB is now changed from 500 to 0 so all databases are regularly defragmented. <br>**Solution**: Customers can adjust the frequency of defragmentation via MaxDefragFrequencyInMinutes.
-| **Windows - 9.1.1653.9590<br>Ubuntu 18 - 9.1.1457.1<br>Ubuntu 20 - 9.1.1457.1** | **Feature** | Key Value Store (KVS) | **Brief Description**: The IntrinsicValueThresholdInBytes setting determines the length of the "Long Value" that is stored in a record. For values bigger than the IntrinsicValueThresholdInBytes, an LVID is created and is stored in the record. Currently, this setting is set to 0 which defaults the size of a long values to 1024 bytes. This PR sets it to 5120 bytes which allows values of a size upto approximately 5KB to be stored in the record. This helps in reducing LVID creation and alleviate LVID echaustion. The number of LVIDs created should reduce and help with LVID exhaustion. <br>**Solution**: The default value of the IntrinsicValueThresholdInBytes is set to 5120 bytes <br>**Workaround**: N/A
-| **Windows - 9.1.1653.9590<br>Ubuntu 18 - 9.1.1457.1<br>Ubuntu 20 - 9.1.1457.1** | **Feature** | Key Value Store (KVS) | **Brief Description**: Legacy Compaction Settings (CompactionThresholdInMB, FreePageSizeThresholdInMB, and CompactionProbabilityInPercent will be removed in the next major Service Fabric runtime version and functionality will be replaced with FreePageSizeThresholdInPercent. To prepare for this eventuality, these settings are deprecated in the public API documentation and direct customers to use the new FreePageSizeThresholdInPercent setting. <br>**Solution**: Customers should start using the new FreePageSizeThresholdInPercent property for customizing when offline auto-compaction occurs. <br>**Documentation Reference**:<ul><li>[CompactionProbabilityInPercent Property](https://learn.microsoft.com/en-us/dotnet/api/system.fabric.localesestoresettings.compactionprobabilityinpercent?view=azure-dotnet)</li><li>[FreePageSizeThresholdInMB Property](https://learn.microsoft.com/en-us/dotnet/api/system.fabric.localesestoresettings.freepagesizethresholdinmb?view=azure-dotnet)</li><li>[CompactionThresholdInMB Property](https://learn.microsoft.com/en-us/dotnet/api/system.fabric.localesestoresettings.compactionthresholdinmb?view=azure-dotnet)</li></ul>
-| **Windows - 9.1.1653.9590<br>Ubuntu 18 - 9.1.1457.1<br>Ubuntu 20 - 9.1.1457.1** | **Feature** | Key Value Store (KVS) | **Brief Description**: Legacy Defragmentation Setting DefragThresholdInMB will be removed in the next major Service Fabric runtime version as regular defragmentation will occur by default. To prepare for this eventuality, this setting is deprecated in the public API documentation and direct customers to use MaxDefragFrequencyInMinutes. <br>**Solution**: Customers can use MaxDefragFrequencyInMinutes to adjust frequency of defragmentation going forward. <br>**Documentation Reference**: [MaxDefragFrequency Property](https://learn.microsoft.com/en-us/dotnet/api/system.fabric.localesestoresettings.maxdefragfrequencyinminutes?view=azure-dotnet#system-fabric-localesestoresettings-maxdefragfrequencyinminutes)
-| **Windows - 9.1.1653.9590<br>Ubuntu 18 - 9.1.1457.1<br>Ubuntu 20 - 9.1.1457.1** | **Feature** | Key Value Store (KVS) | **Brief Description**: IntrinsicValueThresholdInBytes and DatabasePageSizeInKB will be removed in the next major Service Fabric runtime version. The optimal value for these settings will be decided internally and will not be allowed to be override. <br>**Solution**: Customers will not be able to override these settings <br>**Documentation Reference**:  <ul><li>[DatabasePageSizeInKB Property](https://learn.microsoft.com/en-us/dotnet/api/system.fabric.localesestoresettings.databasepagesizeinkb?view=azure-dotnet)</li><li>[IntrinsicValueThresholdInBytes Property](https://learn.microsoft.com/en-us/dotnet/api/system.fabric.localesestoresettings.intrinsicvaluethresholdinbytes?view=azure-dotnet)</li></ul>
+| **Windows - 9.1.1653.9590<br>Ubuntu 18 - 9.1.1457.1<br>Ubuntu 20 - 9.1.1457.1** | **Feature** | Key Value Store (KVS) | **Brief Description**: The "IntrinsicValueThresholdInBytes" setting determines the length of the long value that is stored in a record. For values bigger than the "IntrinsicValueThresholdInBytes", an LVID is created and is stored in the record. Currently, this setting is set to 0 which defaults the size of a long values to 1024 bytes. Going forward the value will set to 5120 bytes to allow long value size upto 5KB stored in the record. This will help in reducing LVID creation and alleviate LVID echaustion. <br>**Solution**: The default value of the IntrinsicValueThresholdInBytes is set to 5120 bytes <br>**Workaround**: N/A
+| **Windows - 9.1.1653.9590<br>Ubuntu 18 - 9.1.1457.1<br>Ubuntu 20 - 9.1.1457.1** | **Feature** | Key Value Store (KVS) | **Brief Description**: Legacy Compaction Settings (CompactionThresholdInMB, FreePageSizeThresholdInMB, and CompactionProbabilityInPercent) will be removed in the next major Service Fabric runtime version and functionality will be replaced with "FreePageSizeThresholdInPercent". These settings are deprecated and documented in the public API documentation to use the new "FreePageSizeThresholdInPercent" setting. <br>**Solution**: Customers should start using the new "FreePageSizeThresholdInPercent" property for customizing when offline auto-compaction occurs. <br>**Documentation Reference**:<ul><li>[CompactionProbabilityInPercent Property](https://learn.microsoft.com/en-us/dotnet/api/system.fabric.localesestoresettings.compactionprobabilityinpercent?view=azure-dotnet)</li><li>[FreePageSizeThresholdInMB Property](https://learn.microsoft.com/en-us/dotnet/api/system.fabric.localesestoresettings.freepagesizethresholdinmb?view=azure-dotnet)</li><li>[CompactionThresholdInMB Property](https://learn.microsoft.com/en-us/dotnet/api/system.fabric.localesestoresettings.compactionthresholdinmb?view=azure-dotnet)</li></ul>
+| **Windows - 9.1.1653.9590<br>Ubuntu 18 - 9.1.1457.1<br>Ubuntu 20 - 9.1.1457.1** | **Feature** | Key Value Store (KVS) | **Brief Description**: Legacy Defragmentation setting "DefragThresholdInMB" will be removed in the next major Service Fabric runtime version as regular defragmentation will occur by default. This setting is deprecated and documented in the public API documentation to use the new setting "MaxDefragFrequencyInMinutes". <br>**Solution**: Customers should start using "MaxDefragFrequencyInMinutes" to adjust frequency of defragmentation going forward. <br>**Documentation Reference**: [MaxDefragFrequency Property](https://learn.microsoft.com/en-us/dotnet/api/system.fabric.localesestoresettings.maxdefragfrequencyinminutes?view=azure-dotnet#system-fabric-localesestoresettings-maxdefragfrequencyinminutes)
+| **Windows - 9.1.1653.9590<br>Ubuntu 18 - 9.1.1457.1<br>Ubuntu 20 - 9.1.1457.1** | **Feature** | Key Value Store (KVS) | **Brief Description**: "IntrinsicValueThresholdInBytes" and "DatabasePageSizeInKB" will be removed in the next major Service Fabric runtime version. The optimal value for these settings will be decided internally and will not be allowed to be override. <br>**Solution**: Customers will not be able to override "IntrinsicValueThresholdInBytes" and "DatabasePageSizeInKB" these settings <br>**Documentation Reference**:  <ul><li>[DatabasePageSizeInKB Property](https://learn.microsoft.com/en-us/dotnet/api/system.fabric.localesestoresettings.databasepagesizeinkb?view=azure-dotnet)</li><li>[IntrinsicValueThresholdInBytes Property](https://learn.microsoft.com/en-us/dotnet/api/system.fabric.localesestoresettings.intrinsicvaluethresholdinbytes?view=azure-dotnet)</li></ul>
 | **Windows - 9.1.1653.9590<br>Ubuntu 18 - 9.1.1457.1<br>Ubuntu 20 - 9.1.1457.1** | **Bug** | OpenSSL | **Brief Description**: 
 
 ## Retirement and Deprecation Path Callouts