Update Service_Fabric_ReleaseNotes_91CU3.md

This commit is contained in:
DivyaC0403 2023-04-17 20:48:41 -07:00 коммит произвёл GitHub
Родитель f3578dc8c4
Коммит 3945950afe
Не найден ключ, соответствующий данной подписи
Идентификатор ключа GPG: 4AEE18F83AFDEB23
1 изменённых файлов: 2 добавлений и 2 удалений

Просмотреть файл

@ -21,13 +21,13 @@ The following packages and versions are part of this release:
## Service Fabric Feature and Bug Fixes ## Service Fabric Feature and Bug Fixes
| Versions | IssueType | Description | Resolution | | Versions | IssueType | Description | Resolution |
|-|-|-|-| |-|-|-|-|
| **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**: The KVS databases now have an automatic compaction feature based on the percentage of free page size. This feature utilizes the "FreePageSizeThresholdInPercent" setting, which has a default value of 30%. The system still supports legacy settings such as "CompactionThresholdInMB", "FreePageSizeThresholdInMB", and "CompactionProbabilityInPercent", if they are still in use.<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**: To ensure that the free page size is accurately calculated and used for auto-compaction purposes, all KVS databases will undergo regular defragmentation. <br>**Solution**: Customers can adjust the frequency of defragmentation using "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**: To ensure that the free page size is accurately calculated and used for auto-compaction purposes, all KVS databases will undergo regular defragmentation. <br>**Solution**: Customers can adjust the frequency of defragmentation using "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 controls the size of long values stored in a record. If a value exceeds this size, it is stored as an Long Value ID (LVID) within the record. Presently, the default value is 0 which sets the size to 1024 bytes. However, in the future, the value will be changed to 5120 bytes to enable storage of long values up to approximately 5KB within a record. This change is expected to minimize LVID creation and mitigate the risk of 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**: The "IntrinsicValueThresholdInBytes" setting controls the size of long values stored in a record. If a value exceeds this size, it is stored as an Long Value ID (LVID) within the record. Presently, the default value is 0 which sets the size to 1024 bytes. However, in the future, the value will be changed to 5120 bytes to enable storage of long values up to approximately 5KB within a record. This change is expected to minimize LVID creation and mitigate the risk of 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". 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 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 (June 2023) 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**: Legacy Defragmentation setting "DefragThresholdInMB" will be removed in the next major Service Fabric runtime version (June 2023) 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 (June 2023). 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** | **Feature** | Key Value Store (KVS) | **Brief Description**: "IntrinsicValueThresholdInBytes" and "DatabasePageSizeInKB" will be removed in the next major Service Fabric runtime version (June 2023). 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**: OpenSSL is a dependency for Service Fabric, but versions prior to 3.0.7 have known security vulnerabilities. To address this, we have updated the GRPC dependency to reference a more recent version, 3.1.0. For more information see [OpenSSL Vulnerabilities](https://www.openssl.org/news/vulnerabilities-3.1.html) | **Windows - 9.1.1653.9590<br>Ubuntu 18 - 9.1.1457.1<br>Ubuntu 20 - 9.1.1457.1** | **Bug** | OpenSSL | **Brief Description**: OpenSSL is a dependency for Service Fabric, but versions prior to 3.0.7 have known security vulnerabilities. To address this, we have updated the GRPC dependency to reference a more recent version, 3.1.0. <br>For more information see [OpenSSL Vulnerabilities](https://www.openssl.org/news/vulnerabilities-3.1.html)
## Retirement and Deprecation Path Callouts ## Retirement and Deprecation Path Callouts
* As aligned with [Microsoft .NET and .NET Core - Microsoft Lifecycle | Microsoft Learn](https://learn.microsoft.com/en-us/lifecycle/products/microsoft-net-and-net-core), SF Runtime has dropped support for Net Core 3.1 as of December 2022. For supported versions see [Service Fabric supported Linux versions](https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-versions#current-versions-1) and migrate applications as needed. * As aligned with [Microsoft .NET and .NET Core - Microsoft Lifecycle | Microsoft Learn](https://learn.microsoft.com/en-us/lifecycle/products/microsoft-net-and-net-core), SF Runtime has dropped support for Net Core 3.1 as of December 2022. For supported versions see [Service Fabric supported Linux versions](https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-versions#current-versions-1) and migrate applications as needed.