Update Service_Fabric_ReleaseNotes_91CU3.md

Fix issuetype
This commit is contained in:
DivyaC0403 2023-04-15 15:56:29 -07:00 коммит произвёл GitHub
Родитель 35dcee36d7
Коммит dec1127d48
Не найден ключ, соответствующий данной подписи
Идентификатор ключа GPG: 4AEE18F83AFDEB23
1 изменённых файлов: 7 добавлений и 7 удалений

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

@ -21,17 +21,17 @@ The following packages and versions are part of this release:
## Service Fabric Feature and Bug Fixes
| Versions | IssueType | Description | Resolution |
|-|-|-|-|
| **Windows - 9.1.1653.9590<br>Ubuntu 18 - 9.1.1457.1<br>Ubuntu 20 - 9.1.1457.1** | **Bug** | 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** | **Bug** | 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** | **Bug** | 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** | **Bug** | 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** | **Bug** | 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** | **Bug** | 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**: 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** | **Bug** | OpenSSL | **Brief Description**:
## 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.
* Ubuntu 18.04 LTS will reach its 5-year end-of-life window on April 30, 2023. Service Fabric runtime will drop support for 18.04 LTS after the published date, and we recommend moving your clusters and applications to supported versions listed here: [Service Fabric supported Linux versions](https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-versions#supported-linux-versions-and-support-end-date)
* Ubuntu 18.04 LTS will reach its 5-year end-of-life window on June, 2023. Service Fabric runtime will drop support for 18.04 LTS after the published date, and we recommend moving your clusters and applications to supported versions listed here: [Service Fabric supported Linux versions](https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-versions#supported-linux-versions-and-support-end-date)
* Service Fabric runtime will soon stop supporting BinaryFormatter based remoting exception serialization by default and move to using Data Contract Serialization (DCS) based remoting exception serialization by default. Current applications using it will continue to work as-is, but Service Fabric strongly recommends moving to using Data Contract Serialization (DCS) based remoting exception instead.
* Service Fabric runtime will soon be archiving and removing Service Fabric runtime version 6.4 packages and older, as well as SDK version 3.3 packages and older from the package Download Center. Archiving/Removing will affect application scaling and re-imaging of virtual machines in a Service Fabric Cluster running on unsupported versions. After older versions are removed/archived, this may cause failure while rolling back when the current in-progress upgrade has errors.
* Migrate Azure Active Directory Authentication Library (ADAL) library to Microsoft Authentication Library (MSAL) library, since ADAL will be out of support after December 2022. This will impact customers using AAD for authentication in Service Fabric for below features:<ul><li>Powershell, StandAlone Service Fabric Explorer(SFX), TokenValicationService</li><li>FabricBRS using AAD for keyvault authentication</li><li>KeyVaultWrapper</li><li>ms.test.winfabric.current test framework</li><li>KXM tool</li><li>AzureClusterDeployer tool</li></ul>For more information see: [MSAL Migration] (https://learn.microsoft.com/en-us/azure/active-directory/develop/msal-migration)