From b0b3adde8432e0d10c3c6748caf3dea47e360b7e Mon Sep 17 00:00:00 2001 From: cortex-lp Date: Thu, 28 Nov 2024 10:09:25 +0000 Subject: [PATCH 01/14] initial version --- content/en/blog/releases/2024.X/2024.11.md | 634 +++++++++++++++++++++ 1 file changed, 634 insertions(+) create mode 100644 content/en/blog/releases/2024.X/2024.11.md diff --git a/content/en/blog/releases/2024.X/2024.11.md b/content/en/blog/releases/2024.X/2024.11.md new file mode 100644 index 000000000..0163c6ddb --- /dev/null +++ b/content/en/blog/releases/2024.X/2024.11.md @@ -0,0 +1,634 @@ +--- +title: "2024.11" +linkTitle: "2024.11" +date: 2024-12-02 +author: Paul Arnold ([@paulmarnold](https://twitter.com/paulmarnold)) +--- + +## Summary + +The 2024.11 [Fast Track][] is now available. + +## Download Artefacts + +Installation artefacts can be requested by raising a case in the [{{% ctx %}} Service Portal][]. + +## Release Notes + +### Overview + +2024.11 is the next [Fast Track][] release of {{% ctx %}} and improves on the [2024.9][] release in the following areas: + +* Capability +* Observability +* Scalability +* Security +* Usability +* Third-Party Support +* Installation +* Upgrade +* Documentation + +This release introduces multiple new features to the {{% ctx %}} platform: + +* The concept of [Process and Activity][], which are types of [Flow][], has now been introduced to {{% ctx %}} Gateway. +* [Saving Output Properties to multiple variables][] is now supported. +* A new built-in [execution context variable][] has been added to the Flow Engine which contains the initiator. +* A new [Proxy for the {{% ctx %}} 7 Flow API][] has been added to the platform. + +[Observability][] has been improved by [adding logging to blocks that communicate with external systems][Logging added to blocks that communicate with external systems]. +\ +Optimisation to [Scalability][] has also been made by [reducing the total number of NServiceBus endpoints and RabbitMQ queues][Reduction of total number of NServiceBus endpoints and RabbitMQ queues]. +\ +We increased the [Security][] of the platform by: + +* [Upgrading the OpenSSL version][Upgrade OpenSSL] shipped with the platform. +* Added [Multi-domain certificates support][]. +* A [CortexManagementUser for RabbitMQ is now created during upgrade][New CortexManagementUser added to manage RabbitMQ queues]. +* [Server-side validation added to {{% ctx %}} Gateway API][] to prevent [Path Traversal][] attacks. +* Removal of the [refresh token cookie on sign out][remove refresh token cookie on sign out]. + +The [Usability][] of the platform has been improved by: + +* Renaming the [Flows Charm to Dev and changing the icon][Rename Flows Charm to Dev and change icon]. +* Renaming the [Settings Charm to Admin and changing the icon][Rename Settings Charm to Admin and change icon]. + +[Third-party Support][] has been improved by [upgrading the platform to .NET 8][Upgrade to .NET 8]. +\ +[Installation][] when [files are blocked by the operating system][Support installation when files are blocked by the operating system] due to the `Zone.Identifier` is now supported. +\ +The [Upgrade][] process has been improved by: + +* [Supporting upgrade when files are blocked by the operating system][Support upgrade when files are blocked by the operating system]. +* Upgrading the [Execution Service when the engine version is unchanged][Execution Service is upgraded when the engine version is unchanged]. +* [Handling of the Execution Services lifecycle events][]. + +Finally, the [Documentation][] includes updates related to: + +* New concepts such as [Process and Activity][Process and Activity Documentation] as well as [Decomposition of Output properties][]. +* [Preventing deadlocks when using semaphores][Prevent deadlocks when using semaphores]. +* [Updating screenshots][screenshots updated] to reflect the new branding. +* [Flow compatibility version][Flow compatibility version introduced] being added to the release notes. +* [General improvements to the documentation][]. + +### Components + +| Release Component | Version | Updated | Update Type | Breaking Change | Notes | +|--------------------------------------------------------------------------------|---------------|---------|---------------|-----------------|--------| +| [{{% ctx %}} Innovation Core Application][] | 53.0.0.24430 | Yes | Major | Yes | Major changes occurred between releases, these changes are related to the reduction of the total number of NServiceBus endpoints and RabbitMQ queues are [breaking][Breaking - Reduction of total number of NServiceBus endpoints and RabbitMQ queues] between 2024.7 and 2024.9 if upgraded on its own | +|     > [{{% ctx %}} API Gateway Service][] | 38.3.0.24430 | Yes | Major | Yes | Major changes occurred between releases, these changes are related to the reduction of the total number of NServiceBus endpoints and RabbitMQ queues are [breaking][Breaking - Reduction of total number of NServiceBus endpoints and RabbitMQ queues] between 2024.7 and 2024.9 if upgraded on its own | +|     > [{{% ctx %}} Authorisation Service][] | 7.0.2.24430 | Yes | Major | Yes | Major changes occurred between releases, these changes are related to the reduction of the total number of NServiceBus endpoints and RabbitMQ queues are [breaking][Breaking - Reduction of total number of NServiceBus endpoints and RabbitMQ queues] between 2024.7 and 2024.9 if upgraded on its own | +|     > [{{% ctx %}} Concurrency Management Service][] | 7.0.2.24430 | Yes | Major | Yes | Major changes occurred between releases, these changes are related to the reduction of the total number of NServiceBus endpoints and RabbitMQ queues are [breaking][Breaking - Reduction of total number of NServiceBus endpoints and RabbitMQ queues] between 2024.7 and 2024.9 if upgraded on its own | +|     > [{{% ctx %}} Configuration Management Service][] | 7.0.2.24430 | Yes | Major | Yes | Major changes occurred between releases, these changes are related to the reduction of the total number of NServiceBus endpoints and RabbitMQ queues are [breaking][Breaking - Reduction of total number of NServiceBus endpoints and RabbitMQ queues] between 2024.7 and 2024.9 if upgraded on its own | +|     > [{{% ctx %}} Data Storage Service][] | 9.0.13.24430 | Yes | Major | Yes | Major changes occurred between releases, these changes are related to the reduction of the total number of NServiceBus endpoints and RabbitMQ queues are [breaking][Breaking - Reduction of total number of NServiceBus endpoints and RabbitMQ queues] between 2024.7 and 2024.9 if upgraded on its own | +|     > [{{% ctx %}} Execution Management Service][] | 7.0.2.24430 | Yes | Major | Yes | Major changes occurred between releases, these changes are related to the reduction of the total number of NServiceBus endpoints and RabbitMQ queues are [breaking][Breaking - Reduction of total number of NServiceBus endpoints and RabbitMQ queues] between 2024.7 and 2024.9 if upgraded on its own | +|     > [{{% ctx %}} Licence Management Service][] | 7.0.2.24430 | Yes | Major | Yes | Major changes occurred between releases, these changes are related to the reduction of the total number of NServiceBus endpoints and RabbitMQ queues are [breaking][Breaking - Reduction of total number of NServiceBus endpoints and RabbitMQ queues] between 2024.7 and 2024.9 if upgraded on its own | +|     > [{{% ctx %}} Listeners Service][] | 2.0.0.24430 | Yes | First Release | N/A | | +|     > [{{% ctx %}} Package Management Service][] | 11.0.2.24430 | Yes | Major | Yes | Major changes occurred between releases, these changes are related to the reduction of the total number of NServiceBus endpoints and RabbitMQ queues are [breaking][Breaking - Reduction of total number of NServiceBus endpoints and RabbitMQ queues] between 2024.7 and 2024.9 if upgraded on its own | +|     > [{{% ctx %}} Provisioning Service][] | 13.1.2.24430 | Yes | Major | Yes | Major changes occurred between releases, these changes are related to the reduction of the total number of NServiceBus endpoints and RabbitMQ queues are [breaking][Breaking - Reduction of total number of NServiceBus endpoints and RabbitMQ queues] between 2024.7 and 2024.9 if upgraded on its own | +|     > [{{% ctx %}} Scheduling Service][] | 7.0.8.24430 | Yes | Major | Yes | Major changes occurred between releases, these changes are related to the reduction of the total number of NServiceBus endpoints and RabbitMQ queues are [breaking][Breaking - Reduction of total number of NServiceBus endpoints and RabbitMQ queues] between 2024.7 and 2024.9 if upgraded on its own | +|     > [{{% ctx %}} Triggers Service][] | 11.0.0.24430 | Yes | Major | Yes | Major changes occurred between releases, these changes are related to the reduction of the total number of NServiceBus endpoints and RabbitMQ queues are [breaking][Breaking - Reduction of total number of NServiceBus endpoints and RabbitMQ queues] between 2024.7 and 2024.9 if upgraded on its own | +| [{{% ctx %}} Innovation Execution Application][] | 24.1.1.24430 | Yes | Major | Yes | Major changes occurred between releases, these changes are related to the reduction of the total number of NServiceBus endpoints and RabbitMQ queues are [breaking][Breaking - Reduction of total number of NServiceBus endpoints and RabbitMQ queues] between 2024.7 and 2024.9 if upgraded on its own | +|     > [{{% ctx %}} Execution Service][] | 24.1.1.24430 | Yes | Major | Yes | Major changes occurred between releases, these changes are related to the reduction of the total number of NServiceBus endpoints and RabbitMQ queues are [breaking][Breaking - Reduction of total number of NServiceBus endpoints and RabbitMQ queues] between 2024.7 and 2024.9 if upgraded on its own | +| [{{% ctx %}} Gateway][Gateway], including [{{% ctx %}} Studio][] | 12.3.2.24430 | Yes | Major | Yes | Major changes occurred between releases, these changes are related to the server-side validation of the APIs are [breaking][Breaking - Server-side validation added to {{% ctx %}} Gateway API] between 2024.7 and 2024.9 | +| [{{% ctx %}} Blocks Package][Blocks] | 48.2.0.24420 | Yes | Major | Yes | Major changes occurred between releases, these changes are related to the upgrade to .NET 8 and are [breaking][Breaking - Upgrade to .NET 8] between 2024.7 and 2024.9 | +| [{{% ctx %}} Interaction Portal][Interaction Portal] | 2.0.0.24340 | No | N/A | N/A | | +| {{% ctx %}} App Server Install Scripts | 5.2.3.24430 | Yes | Minor | N/A | | +| {{% ctx %}} Web App Server Install Scripts | 8.1.1.24420 | Yes | Patch | N/A | | +| {{% ctx %}} Upgrade Scripts | 1.2.8.24430 | Yes | Patch | N/A | | +| {{% ctx %}} Licence Fingerprint Generator | 4.1.0.24360 | Yes | Major | Yes | Major changes occurred between releases, these changes are related to the upgrade to .NET 8 and are [breaking][Breaking - Upgrade to .NET 8] between 2024.7 and 2024.9 | +| {{% ctx %}} Encryption Key Generator | 2.0.0.24350 | Yes | Major | Yes | Major changes occurred between releases, these changes are related to the upgrade to .NET 8 and are [breaking][Breaking - Upgrade to .NET 8] between 2024.7 and 2024.9 | +| {{% ctx %}} Encryptor | 3.1.0.24330 | No | N/A | N/A | | +| {{% ctx %}} Flows Upgrader | 2.0.0.24350 | Yes | Major | Yes | Major changes occurred between releases, these changes are related to the upgrade to .NET 8 and are [breaking][Breaking - Upgrade to .NET 8] between 2024.7 and 2024.9 | + +### Features + +#### Capability + +##### Process and Activity + +The [concept of Process and Activity][Process and Activity] has been introduced to the {{% ctx %}} Gateway. This allows for the creation of [Process][] and [Activity][] flows. +[Processes][Process] are a type of [Flow][] that can contain multiple [Activities][Activity] and are used to model high-level business processes. +[Activities][Activity] are a type of [Flow][] that can be used to model tasks or actions. + +Affected Components: + +* [{{% ctx %}} Gateway][Gateway] +* [{{% ctx %}} Innovation Execution Application][] + * [{{% ctx %}} Execution Service][] +* [{{% ctx %}} Block Packages][Blocks] + +##### Saving Output Properties to multiple variables + +It is now possible to use the [Expression editor][] for output properties. +This supports a new [decomposition syntax][] allowing saving selected values from an output property to multiple variables. + +Affected Components: + +* [{{% ctx %}} Gateway][Gateway] +* [{{% ctx %}} Innovation Execution Application][] + * [{{% ctx %}} Execution Service][] + +##### Execution context variable + +A new [built-in _executionContext variable][] is now exposed in [processes][process] and [activities][activity]. +The `_executionContext` variable contains the initiator of the flow execution, as well as an `Extensions` property that can be used to store additional information. + +Affected Components: + +* [{{% ctx %}} Gateway][Gateway] +* [{{% ctx %}} Innovation Execution Application][] + * [{{% ctx %}} Execution Service][] + +##### Proxy for the {{% ctx %}} 7 Flow API + +A new proxy for the {{% ctx %}} 7 Flow [API][] has been added to simplify migrating to the platform. This allows for the execution of flows using the same [API][] as the one used in {{% ctx %}} 7. + +The [API][] includes the following endpoints: + +* Encrypt +* Run Flow +* Run Flow Asynchronously + +By default, the `Run Flow` and `Run Flow Asynchronously` endpoints will run the specified flow within the default package and version. +To run the flow in a different package and version, the following [APIs][API] have been added to configure mappings between FlowNames and specific package versions: + +* Get all mappings +* Add single mapping +* Remove single mapping +* Remove all mappings + +Affected Components: + +* [{{% ctx %}} Innovation Core Application][] + * [{{% ctx %}} API Gateway Service][] + * [{{% ctx %}} Listeners Service][] + * [{{% ctx %}} Triggers Service][] + +#### Observability + +##### Logging added to blocks that communicate with external systems + +Block logging has been added to blocks that communicate with external systems. +The following blocks and properties are logged: + +* [Execute Data Command][] + * [Command][DataCommand] +* [Execute HTTP Request][] + * [HTTPRequest][] + * [HTTPResponse][] +* [Execute SOAP Request][] + * [SOAPRequest][] + * [SOAPResponse][] +* [Execute Powershell Script][] + * [Script][] + * [Parameters][] + * [Outputs][] + * [Records][] +* [Execute SSH Command][] + * [Command][] + * [Response][] + * [SSH Logs][] + +Affected Components: + +* [{{% ctx %}} Innovation Execution Application][] + * [{{% ctx %}} Execution Service][] +* [{{% ctx %}} Block Packages][Blocks] + +#### Scalability + +##### Reduction of total number of NServiceBus endpoints and RabbitMQ queues + +An exercise has been undertaken to reduce the total number of NServiceBus endpoints and RabbitMQ queues in the platform. +This has been achieved by consolidating the endpoints and queues where possible. + +Affected Components: + +* [{{% ctx %}} Innovation Core Application][] + * [{{% ctx %}} API Gateway Service][] + * [{{% ctx %}} Authorisation Service][] + * [{{% ctx %}} Concurrency Management Service][] + * [{{% ctx %}} Configuration Management Service][] + * [{{% ctx %}} Data Storage Service][] + * [{{% ctx %}} Execution Management Service][] + * [{{% ctx %}} Licence Management Service][] + * [{{% ctx %}} Package Management Service][] + * [{{% ctx %}} Provisioning Service][] + * [{{% ctx %}} Scheduling Service][] + * [{{% ctx %}} Triggers Service][] +* [{{% ctx %}} Innovation Execution Application][] + * [{{% ctx %}} Execution Service][] + +#### Security + +##### Upgrade OpenSSL + +The OpenSSL version shipped with the platform has been upgraded to the latest version. + +Affected Components: + +* {{% ctx %}} App Server Install Scripts +* {{% ctx %}} Web App Server Install Scripts + +##### Multi-domain certificates support + +Support for Multi Domain Certificates in HA deployment is now supported. + +Affected Components: + +* {{% ctx %}} App Server Install Scripts +* {{% ctx %}} Web App Server Install Scripts + +##### New CortexManagementUser added to manage RabbitMQ queues + +A new management user for RabbitMQ queues is now created when providing `RabbitMqManagementUser` and `RabbitMqManagementPassword` during installation or upgrade. + +Affected Components: + +* {{% ctx %}} App Server Install Scripts + +##### Server-side validation added to {{% ctx %}} Gateway API + +The {{% ctx %}} Gateway [API][] now includes server-side validation to prevent [Path Traversal][] attacks when creating new flows and groups. + +Affected Components: + +* [{{% ctx %}} Gateway][Gateway] + +##### Remove refresh token cookie on sign out + +The refresh token cookie is now removed when a user signs out of {{% ctx %}} Gateway, preventing any further use of the token after the user has logged out. + +Affected Components: + +* [{{% ctx %}} Gateway][Gateway] + +#### Usability + +##### Rename Flows Charm to Dev and change icon + +The Flows Charm has been renamed to Dev and the icon has been changed to reflect this. + +Affected Components: + +* [{{% ctx %}} Gateway][Gateway] + +##### Rename Settings Charm to Admin and change icon + +The Settings Charm has been renamed to Admin and the icon has been changed to reflect this. + +Affected Components: + +* [{{% ctx %}} Gateway][Gateway] + +#### Third-party Support + +##### Upgrade to .NET 8 + +The platform has been upgraded to [.NET 8][], allowing us to go to the latest version of [Service Fabric][]. +This was required as .NET 6 will be out of support in November. + +{{% alert title="Note" %}} +Upgrade excludes {{% ctx %}} Gateway as currently on .NET Framework 4.7.2 which is not compatible with .NET 8, and still under long term support. +{{% /alert %}} + +Affected Components: + +* [{{% ctx %}} Innovation Core Application][] + * [{{% ctx %}} API Gateway Service][] + * [{{% ctx %}} Authorisation Service][] + * [{{% ctx %}} Concurrency Management Service][] + * [{{% ctx %}} Configuration Management Service][] + * [{{% ctx %}} Data Storage Service][] + * [{{% ctx %}} Execution Management Service][] + * [{{% ctx %}} Licence Management Service][] + * [{{% ctx %}} Package Management Service][] + * [{{% ctx %}} Provisioning Service][] + * [{{% ctx %}} Scheduling Service][] + * [{{% ctx %}} Triggers Service][] +* [{{% ctx %}} Innovation Execution Application][] + * [{{% ctx %}} Execution Service][] +* [{{% ctx %}} Block Packages][Blocks] +* {{% ctx %}} App Server Install Scripts +* {{% ctx %}} Web App Server Install Scripts +* {{% ctx %}} Upgrade Scripts +* {{% ctx %}} Licence Fingerprint Generator +* {{% ctx %}} Encryption Key Generator +* {{% ctx %}} Flows Upgrader + +##### Upgrade to the latest version of Service Fabric + +The latest version of Service Fabric has been included in the artefacts. +During upgrade, the Service Fabric cluster version will be upgrade to the packaged version in the artefacts. + +Affected Components: + +* {{% ctx %}} Upgrade Scripts + +#### Installation + +##### Support installation when files are blocked by the operating system + +The installation scripts have been amended to unblock files before running if the operating system has files being blocked by `Zone.Identifier`. + +{{% alert title="Note" %}} +`Zone.Identifier` is a file property that indicates a file was downloaded from the internet and is potentially unsafe. Windows uses this property as a protection feature. +{{% /alert %}} + +Affected Components: + +* {{% ctx %}} App Server Install Scripts +* {{% ctx %}} Web App Server Install Scripts + +#### Upgrade + +##### Support upgrade when files are blocked by the operating system + +The upgrade scripts have been amended to unblock files before running if the operating system has files being blocked by `Zone.Identifier`. + +{{% alert title="Note" %}} +`Zone.Identifier` is a file property that indicates a file was downloaded from the internet and is potentially unsafe. Windows uses this property as a protection feature. +{{% /alert %}} + +Affected Components: + +* {{% ctx %}} Upgrade Scripts + +##### Execution Service is upgraded when the engine version is unchanged + +The Execution Service will now be upgraded when the engine version is unchanged. This is to ensure the upgrade works, including edge cases such as patches. + +Affected Components: + +* {{% ctx %}} Upgrade Scripts + +##### Handling of the Execution Services lifecycle events + +The Execution Services handle Service Fabric lifecycle events allowing flows to end gracefully within a defined period. +This includes a `Graceful Period timeout` and a `Cancel Period Timeout`, both which default to 5 minutes, and are configurable. + +Currently, there is no documentation available on how to do this. For further assistance, please raise a case in the [{{% ctx %}} Service Portal][]. + +Affected Components: + +* [{{% ctx %}} Innovation Core Application][] + * [{{% ctx %}} API Gateway Service][] + * [{{% ctx %}} Configuration Management Service][] +* [{{% ctx %}} Innovation Execution Application][] + * [{{% ctx %}} Execution Service][] +* [{{% ctx %}} Block Packages][Blocks] + +#### Documentation + +##### Process and Activity + +The [What is a Flow][] documentation has been updated to include information on the new concepts of [Processes][Process] and [Activities][Activity]. + +##### Decomposition of Output properties + +The [What is a Block Property][] documentation has been updated to include information on the new [Decomposition of Output properties][decomposition syntax] feature. + +##### Prevent deadlocks when using semaphores + +A new section has been added to the documentation explaining how to [prevent deadlocks][] when using semaphores. + +##### Screenshots updated + +Screenshots within the documentation has been updated to reflect the new branding, including [Blocks][] icons and various [{{% ctx %}} Gateway][] screenshots. + +##### Flow compatibility version introduced + +The [Flow compatibility version][] has been added to the release notes. + +##### General improvements to the documentation + +Various improvements have been made to the documentation to improve the overall quality and readability. + +### Bug Fixes + +#### Capability + +##### {{% ctx %}} Gateway encryptor not aligned with Service Fabric + +The Encryptor has been aligned between the {{% ctx %}} Gateway and Service Fabric. +This ensures that encrypted values created with the default key can still be decrypted if a custom private key has been set. + +Affected Components: + +* [{{% ctx %}} Gateway][Gateway] + +#### Upgrade + +##### Certificate update does not work after upgrade + +A bug has been fixed which prevented the update of certificates after an upgrade. + +Affected Components: + +* {{% ctx %}} Upgrade Scripts + +#### Documentation + +##### Missing Platform property in Log Event documentation + +The Platform property the the Log Event documentation was missing. This has been added to the documentation. + +### Breaking Changes + +The following features have introduced breaking changes in the 2024.9 release of the {{% ctx %}} Platform: + +#### Upgrade to .NET 8 + +The platform has been upgraded to [.NET 8][]. + +#### Reduction of total number of NServiceBus endpoints and RabbitMQ queues + +The following feature has changed internal endpoints and queues in the platform, which may cause issues if upgrading from 2024.7 to 2024.9 without upgrading all components at the same time. +The platform will need to be upgraded using the [Upgrade Instructions][]. + +#### Server-side validation added to {{% ctx %}} Gateway API + +The following feature has added validation to the [{{% ctx %}} Gateway][] API to prevent [Path Traversal][] attacks, which now returns an error if the path is invalid. + +### Known Limitations + +There are no known limitations added as part of the 2024.9 release of the {{% ctx %}} Platform. + +## Version Support + +### Operating Systems + +| OS Type | Supported Versions | +|---------|---------------------------------------------------| +| Windows | | +| Linux | Linux is not currently supported | + +### 7.X Compatibility + +| 7.X Version | Is compatible? | Notes | +|-------------|----------------|----------------------------------------------| +| 7.2 | Yes | | +| 7.1 | No | Need to upgrade 7.1 to 7.2 for compatibility | +| 7.0 | No | Need to upgrade 7.0 to 7.2 for compatibility | + +### Flow Compatibility + +| Release | Compatibility Version | +|---------|-----------------------| +| 2024.9 | 31.24311 | +| 2024.7 | 31.24311 | +| 2024.5 | 31.24311 | +| 2024.3 | 30 | + +## Install Instructions + +If you are installing a new 2024.9 platform or adding it to an existing 7.2 Installation see the guidance below; otherwise, if you are upgrading from an existing 2024.7 platform refer to the [Upgrade Instructions][]. + +Installing {{% ctx %}} Only: + +* [Multiple Server - With HA][Innovation Only - Multiple Server - With HA] +* [Single Server - Without HA][Innovation Only - Single Server - Without HA] + +Adding {{% ctx %}} to a 7.2 Installation: + +* [Multiple Server - With HA][Adding Innovation to a 7.2 Installation - Multiple Server - With HA] +* [Single Server - Without HA][Adding Innovation to a 7.2 Installation - Single Server - Without HA] + +## Upgrade Instructions + +If you are upgrading from an existing 2024.7 platform see the guidance below: + +Upgrading {{% ctx %}}: + +* [Multiple Server - With HA][Upgrade - Multiple Server - With HA] +* [Single Server - Without HA][Upgrade - Single Server - Without HA] + +## Upcoming Releases + +Releases are currently forecast to be made available on: + +| Release | Release Type | Forecast Release Date | +|---------|----------------|------------------------------------| +| 2024.9 | [Release][] | Week commencing 7th October 2024 | +| 2024.11 | [Fast Track][] | Week commencing 2nd December 2024 | +| 2025.1 | [Fast Track][] | Week commencing 10th February 2024 | + +[{{% ctx %}} Innovation Core Application]: {{< url path="Cortex.Guides.CortexInnovation.CoreApplication.MainDoc" version="2024.9" >}} +[{{% ctx %}} API Gateway Service]: {{< url path="Cortex.Guides.CortexInnovation.CoreApplication.Services.ApiGatewayService.MainDoc" version="2024.9" >}} +[{{% ctx %}} Authorisation Service]: {{< url path="Cortex.Guides.CortexInnovation.CoreApplication.Services.AuthorisationService.MainDoc" version="2024.9" >}} +[{{% ctx %}} Concurrency Management Service]: {{< url path="Cortex.Guides.CortexInnovation.CoreApplication.Services.ConcurrencyManagementService.MainDoc" version="2024.9" >}} +[{{% ctx %}} Configuration Management Service]: {{< url path="Cortex.Guides.CortexInnovation.CoreApplication.Services.ConfigurationManagementService.MainDoc" version="2024.9" >}} +[{{% ctx %}} Data Storage Service]: {{< url path="Cortex.Guides.CortexInnovation.CoreApplication.Services.DataStorageService.MainDoc" version="2024.9" >}} +[{{% ctx %}} Execution Management Service]: {{< url path="Cortex.Guides.CortexInnovation.CoreApplication.Services.ExecutionManagementService.MainDoc" version="2024.9" >}} +[{{% ctx %}} Licence Management Service]: {{< url path="Cortex.Guides.CortexInnovation.CoreApplication.Services.LicenceManagementService.MainDoc" version="2024.9" >}} +[{{% ctx %}} Listeners Service]: {{< url path="Cortex.Guides.CortexInnovation.CoreApplication.Services.ListenersService.MainDoc" version="2024.9" >}} +[{{% ctx %}} Package Management Service]: {{< url path="Cortex.Guides.CortexInnovation.CoreApplication.Services.PackageManagementService.MainDoc" version="2024.9" >}} +[{{% ctx %}} Provisioning Service]: {{< url path="Cortex.Guides.CortexInnovation.CoreApplication.Services.ProvisioningService.MainDoc" version="2024.9" >}} +[{{% ctx %}} Scheduling Service]: {{< url path="Cortex.Guides.CortexInnovation.CoreApplication.Services.SchedulingService.MainDoc" version="2024.9" >}} +[{{% ctx %}} Triggers Service]: {{< url path="Cortex.Guides.CortexInnovation.CoreApplication.Services.TriggersService.MainDoc" version="2024.9" >}} +[{{% ctx %}} Innovation Execution Application]: {{< url path="Cortex.Guides.CortexInnovation.ExecutionApplication.MainDoc" version="2024.9" >}} +[{{% ctx %}} Execution Service]: {{< url path="Cortex.Guides.CortexInnovation.ExecutionApplication.Services.ExecutionService.MainDoc" version="2024.9" >}} +[Interaction Portal]: {{< url path="Cortex.Guides.CortexInteractionPortal.MainDoc" version="2024.9" >}} + +[Process and Activity]: {{< ref "#process-and-activity" >}} +[Saving Output Properties to multiple variables]: {{< ref "#saving-output-properties-to-multiple-variables" >}} +[execution context variable]: {{< ref "#execution-context-variable" >}} +[Proxy for the {{% ctx %}} 7 Flow API]: {{< ref "#proxy-for-the-cortex-7-flow-api" >}} +[Observability]: {{< ref "#observability" >}} +[Logging added to blocks that communicate with external systems]: {{< ref "#logging-added-to-blocks-that-communicate-with-external-systems" >}} +[Scalability]: {{< ref "#scalability" >}} +[Reduction of total number of NServiceBus endpoints and RabbitMQ queues]: {{< ref "#reduction-of-total-number-of-nservicebus-endpoints-and-rabbitmq-queues" >}} +[Security]: {{< ref "#security" >}} +[Upgrade OpenSSL]: {{< ref "#upgrade-openssl" >}} +[Multi-domain certificates support]: {{< ref "#multi-domain-certificates-support" >}} +[New CortexManagementUser added to manage RabbitMQ queues]: {{< ref "#new-cortexmanagementuser-added-to-manage-rabbitmq-queues" >}} +[Server-side validation added to {{% ctx %}} Gateway API]: {{< ref "#server-side-validation-added-to-cortex-gateway-api" >}} +[Remove refresh token cookie on sign out]: {{< ref "#remove-refresh-token-cookie-on-sign-out" >}} +[Usability]: {{< ref "#usability" >}} +[Rename Flows Charm to Dev and change icon]: {{< ref "#rename-flows-charm-to-dev-and-change-icon" >}} +[Rename Settings Charm to Admin and change icon]: {{< ref "#rename-settings-charm-to-admin-and-change-icon" >}} +[Third-party Support]: {{< ref "#third-party-support" >}} +[Upgrade to .NET 8]: {{< ref "#upgrade-to-net-8" >}} +[Installation]: {{< ref "#installation" >}} +[Support installation when files are blocked by the operating system]: {{< ref "#support-installation-when-files-are-blocked-by-the-operating-system" >}} +[Upgrade]: {{< ref "#upgrade" >}} +[Support upgrade when files are blocked by the operating system]: {{< ref "#support-upgrade-when-files-are-blocked-by-the-operating-system" >}} +[Execution Service is upgraded when the engine version is unchanged]: {{< ref "#execution-service-is-upgraded-when-the-engine-version-is-unchanged" >}} +[Handling of the Execution Services lifecycle events]: {{< ref "#handling-of-the-execution-services-lifecycle-events" >}} +[Documentation]: {{< ref "#documentation" >}} +[Process and Activity Documentation]: {{< ref "#process-and-activity-1" >}} +[Decomposition of Output properties]: {{< ref "#decomposition-of-output-properties" >}} +[Prevent deadlocks when using semaphores]: {{< ref "#prevent-deadlocks-when-using-semaphores" >}} +[Screenshots updated]: {{< ref "#screenshots-updated" >}} +[Flow compatibility version introduced]: {{< ref "#flow-compatibility-version-introduced" >}} +[General improvements to the documentation]: {{< ref "#general-improvements-to-the-documentation" >}} + +[Flow compatibility version]: {{< ref "#flow-compatibility" >}} + +[Upgrade Instructions]: {{< ref "#upgrade-instructions" >}} + +[{{% ctx %}} Gateway]: {{< url path="Cortex.Guides.Gateway.MainDoc" version="2024.9" >}} +[Blocks]: {{< url path="Cortex.Reference.Blocks.MainDoc" version="2024.9" >}} +[What is a Flow]: {{< url path="Cortex.Reference.Concepts.Fundamentals.Flows.WhatIsAFlow.MainDoc" version="2024.9" >}} +[Process]: {{< url path="Cortex.Reference.Concepts.Fundamentals.Flows.WhatIsAFlow.Process" version="2024.9" >}} +[Activity]: {{< url path="Cortex.Reference.Concepts.Fundamentals.Flows.WhatIsAFlow.Activity" version="2024.9" >}} +[What is a Block Property]: {{< url path="Cortex.Reference.Concepts.Fundamentals.Blocks.BlockProperties.WhatIsABlockProperty.MainDoc" version="2024.9" >}} + +[prevent deadlocks]: {{< url path="Cortex.Reference.Concepts.WorkingWith.Concurrency.Semaphores.WhatIsASemaphore.PreventingDeadlocks" version="2024.9" >}} + +[Execute Data Command]: {{< url path="Cortex.Reference.Blocks.Data.ExecuteDataCommand.ExecuteDataCommand.MainDoc" version="2024.9" >}} +[DataCommand]: {{< url path="Cortex.Reference.Blocks.Data.ExecuteDataCommand.ExecuteDataCommand.CommandProperty" version="2024.9" >}} + +[Execute HTTP Request]: {{< url path="Cortex.Reference.Blocks.Http.ExecuteHttpRequest.ExecuteHttpRequest.MainDoc" version="2024.9" >}} +[HttpRequest]: {{< url path="Cortex.Reference.Blocks.Http.ExecuteHttpRequest.ExecuteHttpRequest.HttpRequestProperty" version="2024.9" >}} +[HttpResponse]: {{< url path="Cortex.Reference.Blocks.Http.ExecuteHttpRequest.ExecuteHttpRequest.HttpResponseProperty" version="2024.9" >}} + +[Execute Soap Request]: {{< url path="Cortex.Reference.Blocks.Http.ExecuteSoapRequest.ExecuteSoapRequest.MainDoc" version="2024.9" >}} +[SoapRequest]: {{< url path="Cortex.Reference.Blocks.Http.ExecuteSoapRequest.ExecuteSoapRequest.SoapRequestProperty" version="2024.9" >}} +[SoapResponse]: {{< url path="Cortex.Reference.Blocks.Http.ExecuteSoapRequest.ExecuteSoapRequest.SoapResponseProperty" version="2024.9" >}} + +[Execute Powershell Script]: {{< url path="Cortex.Reference.Blocks.PowerShell.ExecutePowerShellScript.ExecutePowerShellScript.MainDoc" version="2024.9" >}} +[Script]: {{< url path="Cortex.Reference.Blocks.PowerShell.ExecutePowerShellScript.ExecutePowerShellScript.ScriptProperty" version="2024.9" >}} +[Parameters]: {{< url path="Cortex.Reference.Blocks.PowerShell.ExecutePowerShellScript.ExecutePowerShellScript.ParametersProperty" version="2024.9" >}} +[Outputs]: {{< url path="Cortex.Reference.Blocks.PowerShell.ExecutePowerShellScript.ExecutePowerShellScript.OutputsProperty" version="2024.9" >}} +[Records]: {{< url path="Cortex.Reference.Blocks.PowerShell.ExecutePowerShellScript.ExecutePowerShellScript.RecordsProperty" version="2024.9" >}} + +[Execute SSH Command]: {{< url path="Cortex.Reference.Blocks.Ssh.ExecuteSshCommand.ExecuteSshCommandBlock.MainDoc" version="2024.9" >}} +[Command]: {{< url path="Cortex.Reference.Blocks.Ssh.ExecuteSshCommand.ExecuteSshCommandBlock.CommandProperty" version="2024.9" >}} +[Response]: {{< url path="Cortex.Reference.Blocks.Ssh.ExecuteSshCommand.ExecuteSshCommandBlock.Response" version="2024.9" >}} +[SSH Logs]: {{< url path="Cortex.Reference.Blocks.Ssh.ExecuteSshCommand.ExecuteSshCommandBlock.SshLogsProperty" version="2024.9" >}} + +[Gateway]: {{< url path="Cortex.Guides.Gateway.MainDoc" version="2024.9" >}} +[Expression Editor]: {{< url path="Cortex.Reference.Concepts.Fundamentals.Blocks.BlockProperties.PropertyEditors.ExpressionEditor.MainDoc" version="2024.9" >}} +[decomposition syntax]: {{< url path="Cortex.Reference.Concepts.Fundamentals.Blocks.BlockProperties.WhatIsABlockProperty.DecomposingOutputProperties" version="2024.9" >}} + +[.NET 8]: {{< url path="Cortex.Reference.Glossary.A-E.DotNet" >}} +[API]: {{< url path="Cortex.Reference.Glossary.A-E.API" >}} +[Service Fabric]: {{< url path="Cortex.Reference.Glossary.P-T.ServiceFabric" >}} +[built-in _executionContext variable]: {{< url path="Cortex.Reference.Concepts.Fundamentals.Executions.WhatIsAnExecution.ExecutionContext" version="2024.9" >}} + +[Innovation Only - Single Server - Without HA]: {{< url path="Cortex.GettingStarted.OnPremise.InstallInnovationOnly.SingleServerWithoutHA.MainDoc" version="2024.9" >}} +[Innovation Only - Multiple Server - With HA]: {{< url path="Cortex.GettingStarted.OnPremise.InstallInnovationOnly.MultipleServerWithHA.MainDoc" version="2024.9" >}} + +[Adding Innovation to a 7.2 Installation - Single Server - Without HA]: {{< url path="Cortex.GettingStarted.OnPremise.AddInnovationTo72.SingleServerWithoutHA.MainDoc" version="2024.9" >}} +[Adding Innovation to a 7.2 Installation - Multiple Server - With HA]: {{< url path="Cortex.GettingStarted.OnPremise.AddInnovationTo72.MultipleServerWithHA.MainDoc" version="2024.9" >}} + +[Upgrade - Single Server - Without HA]: {{< url path="Cortex.Guides.UpgradeCortex.2024.7to2024.9.SingleServerWithoutHA.MainDoc" version="2024.9" >}} +[Upgrade - Multiple Server - With HA]: {{< url path="Cortex.Guides.UpgradeCortex.2024.7to2024.9.MultipleServerWithHA.MainDoc" version="2024.9" >}} +[Breaking - Reduction of total number of NServiceBus endpoints and RabbitMQ queues]: {{< ref "#reduction-of-total-number-of-nservicebus-endpoints-and-rabbitmq-queues-1" >}} +[Breaking - Upgrade to .NET 8]: {{< ref "#upgrade-to-net-8-1" >}} +[Breaking - Server-side validation added to {{% ctx %}} Gateway API]: {{< ref "#server-side-validation-added-to-cortex-gateway-api-1" >}} + +[{{% ctx %}} Studio]: {{< url path="Cortex.Guides.Studio.MainDoc" version="2024.9" >}} + +[{{% ctx %}} Service Portal]: {{< url path="Cortex.ServicePortal.MainDoc" version="2024.9" >}} + +[Flow]: {{< url path="Cortex.Reference.Concepts.Fundamentals.Flows.WhatIsAFlow.MainDoc" version="2024.9" >}} + +[Fast Track]: {{< url path="Cortex.Reference.Glossary.F-J.FastTrack" version="2024.9" >}} +[Release]: {{< url path="Cortex.Reference.Glossary.P-T.Release" version="2024.9" >}} + +[2024.7]: {{< url path="Cortex.Blogs.Releases.2024.7.MainDoc" version="2024.9" >}} + +[Path Traversal]: {{< url path="Owasp.PathTraversal.MainDoc" version="2024.9" >}} From f93283e588b7f49fae4e2145c9a79900bf46a676 Mon Sep 17 00:00:00 2001 From: cortex-lp Date: Thu, 28 Nov 2024 17:01:41 +0000 Subject: [PATCH 02/14] part through bugs --- content/en/blog/releases/2024.X/2024.11.md | 582 ++++++++------------- 1 file changed, 211 insertions(+), 371 deletions(-) diff --git a/content/en/blog/releases/2024.X/2024.11.md b/content/en/blog/releases/2024.X/2024.11.md index 0163c6ddb..663930c0b 100644 --- a/content/en/blog/releases/2024.X/2024.11.md +++ b/content/en/blog/releases/2024.X/2024.11.md @@ -29,50 +29,12 @@ Installation artefacts can be requested by raising a case in the [{{% ctx %}} Se * Upgrade * Documentation -This release introduces multiple new features to the {{% ctx %}} platform: - -* The concept of [Process and Activity][], which are types of [Flow][], has now been introduced to {{% ctx %}} Gateway. -* [Saving Output Properties to multiple variables][] is now supported. -* A new built-in [execution context variable][] has been added to the Flow Engine which contains the initiator. -* A new [Proxy for the {{% ctx %}} 7 Flow API][] has been added to the platform. - -[Observability][] has been improved by [adding logging to blocks that communicate with external systems][Logging added to blocks that communicate with external systems]. -\ -Optimisation to [Scalability][] has also been made by [reducing the total number of NServiceBus endpoints and RabbitMQ queues][Reduction of total number of NServiceBus endpoints and RabbitMQ queues]. -\ -We increased the [Security][] of the platform by: - -* [Upgrading the OpenSSL version][Upgrade OpenSSL] shipped with the platform. -* Added [Multi-domain certificates support][]. -* A [CortexManagementUser for RabbitMQ is now created during upgrade][New CortexManagementUser added to manage RabbitMQ queues]. -* [Server-side validation added to {{% ctx %}} Gateway API][] to prevent [Path Traversal][] attacks. -* Removal of the [refresh token cookie on sign out][remove refresh token cookie on sign out]. - -The [Usability][] of the platform has been improved by: - -* Renaming the [Flows Charm to Dev and changing the icon][Rename Flows Charm to Dev and change icon]. -* Renaming the [Settings Charm to Admin and changing the icon][Rename Settings Charm to Admin and change icon]. - -[Third-party Support][] has been improved by [upgrading the platform to .NET 8][Upgrade to .NET 8]. -\ -[Installation][] when [files are blocked by the operating system][Support installation when files are blocked by the operating system] due to the `Zone.Identifier` is now supported. -\ -The [Upgrade][] process has been improved by: - -* [Supporting upgrade when files are blocked by the operating system][Support upgrade when files are blocked by the operating system]. -* Upgrading the [Execution Service when the engine version is unchanged][Execution Service is upgraded when the engine version is unchanged]. -* [Handling of the Execution Services lifecycle events][]. - -Finally, the [Documentation][] includes updates related to: - -* New concepts such as [Process and Activity][Process and Activity Documentation] as well as [Decomposition of Output properties][]. -* [Preventing deadlocks when using semaphores][Prevent deadlocks when using semaphores]. -* [Updating screenshots][screenshots updated] to reflect the new branding. -* [Flow compatibility version][Flow compatibility version introduced] being added to the release notes. -* [General improvements to the documentation][]. + ### Components + + | Release Component | Version | Updated | Update Type | Breaking Change | Notes | |--------------------------------------------------------------------------------|---------------|---------|---------------|-----------------|--------| | [{{% ctx %}} Innovation Core Application][] | 53.0.0.24430 | Yes | Major | Yes | Major changes occurred between releases, these changes are related to the reduction of the total number of NServiceBus endpoints and RabbitMQ queues are [breaking][Breaking - Reduction of total number of NServiceBus endpoints and RabbitMQ queues] between 2024.7 and 2024.9 if upgraded on its own | @@ -105,351 +67,307 @@ Finally, the [Documentation][] includes updates related to: #### Capability -##### Process and Activity +##### Improved session update reliability on slow systems -The [concept of Process and Activity][Process and Activity] has been introduced to the {{% ctx %}} Gateway. This allows for the creation of [Process][] and [Activity][] flows. -[Processes][Process] are a type of [Flow][] that can contain multiple [Activities][Activity] and are used to model high-level business processes. -[Activities][Activity] are a type of [Flow][] that can be used to model tasks or actions. +The Cortex Interaction Portal now handles session updates more reliably on slower systems. -Affected Components: + -* [{{% ctx %}} Gateway][Gateway] -* [{{% ctx %}} Innovation Execution Application][] - * [{{% ctx %}} Execution Service][] -* [{{% ctx %}} Block Packages][Blocks] +##### Introduced the Monitoring Service -##### Saving Output Properties to multiple variables +{{% ctx %}} Gateway now includes a Monitoring Service that provides a high-level view of the system's operations. +The Monitoring Service is provisioned by default and is available on the Operations Overview page. -It is now possible to use the [Expression editor][] for output properties. -This supports a new [decomposition syntax][] allowing saving selected values from an output property to multiple variables. + + + -Affected Components: +##### Added Operations Overview API to API Gateway -* [{{% ctx %}} Gateway][Gateway] -* [{{% ctx %}} Innovation Execution Application][] - * [{{% ctx %}} Execution Service][] +The API Gateway Service now includes the following APIs: -##### Execution context variable +* Get Operations Overview Data: + * Description: Returns the operations overview graph data which consist of: + * Flows execution Success Rate + * Total number of Completed Executions + * Total number of Errored Executions + * Url path: `api/dashboards/operationsOverview/data` + * Query parameters: + * `packageNames` + * `packageVersions` + * `flowNames` + * `startDate` + * `endDate` -A new [built-in _executionContext variable][] is now exposed in [processes][process] and [activities][activity]. -The `_executionContext` variable contains the initiator of the flow execution, as well as an `Extensions` property that can be used to store additional information. +* Get Operations Overview Filters Paths: + * Description: Returns the list of filters paths is used by the filters of the {{% ctx %}} Gateway Operations Overview page. + * Url path: `api/dashboards/operationsOverview/filters/paths` + * Query parameters: + * `startDate` + * `endDate` -Affected Components: + + + + + + + -* [{{% ctx %}} Gateway][Gateway] -* [{{% ctx %}} Innovation Execution Application][] - * [{{% ctx %}} Execution Service][] +##### Introduced the Operations Overview page -##### Proxy for the {{% ctx %}} 7 Flow API +{{% ctx %}} Gateway now includes an Operations Overview page that provides a high-level view of the system's operations. -A new proxy for the {{% ctx %}} 7 Flow [API][] has been added to simplify migrating to the platform. This allows for the execution of flows using the same [API][] as the one used in {{% ctx %}} 7. + -The [API][] includes the following endpoints: +##### Added Current Status tiles to the Operations Overview page -* Encrypt -* Run Flow -* Run Flow Asynchronously +The Operations Overview page now includes tiles that display the current status of the system, which includes: -By default, the `Run Flow` and `Run Flow Asynchronously` endpoints will run the specified flow within the default package and version. -To run the flow in a different package and version, the following [APIs][API] have been added to configure mappings between FlowNames and specific package versions: +* License consumption +* Cluster health +* Running Executions -* Get all mappings -* Add single mapping -* Remove single mapping -* Remove all mappings + -Affected Components: +##### Added Filters to the Operations Overview page -* [{{% ctx %}} Innovation Core Application][] - * [{{% ctx %}} API Gateway Service][] - * [{{% ctx %}} Listeners Service][] - * [{{% ctx %}} Triggers Service][] +The Operations Overview page now includes filters that allow users to filter data based on the selected timespan, packages, package versions and flows. -#### Observability - -##### Logging added to blocks that communicate with external systems - -Block logging has been added to blocks that communicate with external systems. -The following blocks and properties are logged: - -* [Execute Data Command][] - * [Command][DataCommand] -* [Execute HTTP Request][] - * [HTTPRequest][] - * [HTTPResponse][] -* [Execute SOAP Request][] - * [SOAPRequest][] - * [SOAPResponse][] -* [Execute Powershell Script][] - * [Script][] - * [Parameters][] - * [Outputs][] - * [Records][] -* [Execute SSH Command][] - * [Command][] - * [Response][] - * [SSH Logs][] - -Affected Components: - -* [{{% ctx %}} Innovation Execution Application][] - * [{{% ctx %}} Execution Service][] -* [{{% ctx %}} Block Packages][Blocks] + + -#### Scalability +##### Added Graphs to the Operations Overview page -##### Reduction of total number of NServiceBus endpoints and RabbitMQ queues +The Operations Overview page now includes graphs that display the following data: -An exercise has been undertaken to reduce the total number of NServiceBus endpoints and RabbitMQ queues in the platform. -This has been achieved by consolidating the endpoints and queues where possible. +* Success rate +* Completed flows +* Errored flows -Affected Components: + + + + -* [{{% ctx %}} Innovation Core Application][] - * [{{% ctx %}} API Gateway Service][] - * [{{% ctx %}} Authorisation Service][] - * [{{% ctx %}} Concurrency Management Service][] - * [{{% ctx %}} Configuration Management Service][] - * [{{% ctx %}} Data Storage Service][] - * [{{% ctx %}} Execution Management Service][] - * [{{% ctx %}} Licence Management Service][] - * [{{% ctx %}} Package Management Service][] - * [{{% ctx %}} Provisioning Service][] - * [{{% ctx %}} Scheduling Service][] - * [{{% ctx %}} Triggers Service][] -* [{{% ctx %}} Innovation Execution Application][] - * [{{% ctx %}} Execution Service][] +##### Added configuration for query parameter length -#### Security +{{% ctx %}} Gateway `web.config` now includes configuration settings allowing to configure the maximum query parameter length. +Currently, there is no documentation available on how to do this. For further assistance, please raise a case in the [{{% ctx %}} Service Portal][]. -##### Upgrade OpenSSL + -The OpenSSL version shipped with the platform has been upgraded to the latest version. +##### Added support for multiple Cortex Interaction Portal running on the same machine -Affected Components: +The Cortex Interaction Portal can now be installed multiple times on the same machine. +This allows for multiple instances of the Interaction Portal to be run on the same machine, each with its own configuration and data. -* {{% ctx %}} App Server Install Scripts -* {{% ctx %}} Web App Server Install Scripts + -##### Multi-domain certificates support +#### Observability -Support for Multi Domain Certificates in HA deployment is now supported. +##### Reduced the maximum size of Service Fabric Trace Logs -Affected Components: +The maximum size of Service Fabric Trace Logs has been reduced to reduce the amount of disk space used. -* {{% ctx %}} App Server Install Scripts -* {{% ctx %}} Web App Server Install Scripts + -##### New CortexManagementUser added to manage RabbitMQ queues +#### Scalability -A new management user for RabbitMQ queues is now created when providing `RabbitMqManagementUser` and `RabbitMqManagementPassword` during installation or upgrade. +##### Improved the performance of the Execution Management Service -Affected Components: +The performance of the Execution Management Service has been improved to handle high volumes of executions more efficiently. -* {{% ctx %}} App Server Install Scripts + -##### Server-side validation added to {{% ctx %}} Gateway API +##### Increased the header size limit for Service Fabric API Gateway -The {{% ctx %}} Gateway [API][] now includes server-side validation to prevent [Path Traversal][] attacks when creating new flows and groups. +The header size limit for the Service Fabric API Gateway has been increased to allow for larger headers to be processed. -Affected Components: + -* [{{% ctx %}} Gateway][Gateway] +#### Security -##### Remove refresh token cookie on sign out +##### Reviewed the Content-security-policy directives -The refresh token cookie is now removed when a user signs out of {{% ctx %}} Gateway, preventing any further use of the token after the user has logged out. +The Content-security-policy directives have been reviewed and updated to ensure that they are secure. -Affected Components: + -* [{{% ctx %}} Gateway][Gateway] +##### Introduced the Permissions-Policy header -#### Usability +The Permissions-Policy header has been introduced to improve security. -##### Rename Flows Charm to Dev and change icon + -The Flows Charm has been renamed to Dev and the icon has been changed to reflect this. +##### Deleted the guest user from RabbitMQ on installation and upgrade -Affected Components: +The guest user is now deleted from RabbitMQ on installation and upgrade to improve security. -* [{{% ctx %}} Gateway][Gateway] + + -##### Rename Settings Charm to Admin and change icon +##### Removed the X-XSS-PROTECTION header -The Settings Charm has been renamed to Admin and the icon has been changed to reflect this. +The X-XSS-PROTECTION header has been removed as it is deprecated. -Affected Components: + -* [{{% ctx %}} Gateway][Gateway] +#### Usability #### Third-party Support -##### Upgrade to .NET 8 +##### Added Health Check API to Service Fabric API Gateway -The platform has been upgraded to [.NET 8][], allowing us to go to the latest version of [Service Fabric][]. -This was required as .NET 6 will be out of support in November. +A Health Check API has been added to the Service Fabric API Gateway to allow third-party load balancers to check the health of the system. -{{% alert title="Note" %}} -Upgrade excludes {{% ctx %}} Gateway as currently on .NET Framework 4.7.2 which is not compatible with .NET 8, and still under long term support. -{{% /alert %}} + -Affected Components: +##### Updated 3rd Party Libraries -* [{{% ctx %}} Innovation Core Application][] - * [{{% ctx %}} API Gateway Service][] - * [{{% ctx %}} Authorisation Service][] - * [{{% ctx %}} Concurrency Management Service][] - * [{{% ctx %}} Configuration Management Service][] - * [{{% ctx %}} Data Storage Service][] - * [{{% ctx %}} Execution Management Service][] - * [{{% ctx %}} Licence Management Service][] - * [{{% ctx %}} Package Management Service][] - * [{{% ctx %}} Provisioning Service][] - * [{{% ctx %}} Scheduling Service][] - * [{{% ctx %}} Triggers Service][] -* [{{% ctx %}} Innovation Execution Application][] - * [{{% ctx %}} Execution Service][] -* [{{% ctx %}} Block Packages][Blocks] -* {{% ctx %}} App Server Install Scripts -* {{% ctx %}} Web App Server Install Scripts -* {{% ctx %}} Upgrade Scripts -* {{% ctx %}} Licence Fingerprint Generator -* {{% ctx %}} Encryption Key Generator -* {{% ctx %}} Flows Upgrader +The following 3rd party libraries have been updated on {{% ctx %}} Gateway: -##### Upgrade to the latest version of Service Fabric +* Fuse +* jQuery +* jQuery UI +* Moment.js +* Stacktrace.js -The latest version of Service Fabric has been included in the artefacts. -During upgrade, the Service Fabric cluster version will be upgrade to the packaged version in the artefacts. + + + + + -Affected Components: +#### Installation -* {{% ctx %}} Upgrade Scripts +##### Added check for certificate friendly name -#### Installation +The installation script now checks for the presence of a certificate friendly name and throws an error if it is not present. -##### Support installation when files are blocked by the operating system + -The installation scripts have been amended to unblock files before running if the operating system has files being blocked by `Zone.Identifier`. +##### Changed the installation script to use PSDrive to improve compatibility -{{% alert title="Note" %}} -`Zone.Identifier` is a file property that indicates a file was downloaded from the internet and is potentially unsafe. Windows uses this property as a protection feature. -{{% /alert %}} +The installation script now uses PSDrive to improve compatibility with different environments. -Affected Components: + -* {{% ctx %}} App Server Install Scripts -* {{% ctx %}} Web App Server Install Scripts +##### Added support for RabbitMQ log file rotation -#### Upgrade +The installation script now sets up log file rotation RabbitMQ. -##### Support upgrade when files are blocked by the operating system + -The upgrade scripts have been amended to unblock files before running if the operating system has files being blocked by `Zone.Identifier`. +#### Upgrade -{{% alert title="Note" %}} -`Zone.Identifier` is a file property that indicates a file was downloaded from the internet and is potentially unsafe. Windows uses this property as a protection feature. -{{% /alert %}} +##### Added support for RabbitMQ log file rotation -Affected Components: +The installation script now sets up log file rotation RabbitMQ. -* {{% ctx %}} Upgrade Scripts + -##### Execution Service is upgraded when the engine version is unchanged +##### Improved of the load balancer upgrade process -The Execution Service will now be upgraded when the engine version is unchanged. This is to ensure the upgrade works, including edge cases such as patches. +The upgrade process now restores the files to pre-upgrade if the load balancer upgrade fails. -Affected Components: + -* {{% ctx %}} Upgrade Scripts +##### Streamlined the timeout of the Register-ServiceFabricApplicationType command with other commands -##### Handling of the Execution Services lifecycle events +The timeout of the Register-ServiceFabricApplicationType command has been set to 1800s, like other commands. -The Execution Services handle Service Fabric lifecycle events allowing flows to end gracefully within a defined period. -This includes a `Graceful Period timeout` and a `Cancel Period Timeout`, both which default to 5 minutes, and are configurable. + -Currently, there is no documentation available on how to do this. For further assistance, please raise a case in the [{{% ctx %}} Service Portal][]. +##### Changed the extension of the studio package created by the upgrade script -Affected Components: +The studio package created by the upgrade script now has the file extension `.studiopkg` to be consistent with the documentation. -* [{{% ctx %}} Innovation Core Application][] - * [{{% ctx %}} API Gateway Service][] - * [{{% ctx %}} Configuration Management Service][] -* [{{% ctx %}} Innovation Execution Application][] - * [{{% ctx %}} Execution Service][] -* [{{% ctx %}} Block Packages][Blocks] + #### Documentation -##### Process and Activity +##### Added how to add the encryption key to the Load Balancer server -The [What is a Flow][] documentation has been updated to include information on the new concepts of [Processes][Process] and [Activities][Activity]. +The documentation now includes instructions on how to add the encryption key to the Load Balancer server during both installation and upgrade. -##### Decomposition of Output properties + -The [What is a Block Property][] documentation has been updated to include information on the new [Decomposition of Output properties][decomposition syntax] feature. -##### Prevent deadlocks when using semaphores + -A new section has been added to the documentation explaining how to [prevent deadlocks][] when using semaphores. +##### Updated ports used by {{% ctx %}} -##### Screenshots updated +The documentation has been updated to include the new ports used by {{% ctx %}}. -Screenshots within the documentation has been updated to reflect the new branding, including [Blocks][] icons and various [{{% ctx %}} Gateway][] screenshots. + -##### Flow compatibility version introduced +### Bug Fixes -The [Flow compatibility version][] has been added to the release notes. +#### Capability -##### General improvements to the documentation +##### Send Email Using Microsoft365 block crashes the Execution Service -Various improvements have been made to the documentation to improve the overall quality and readability. +A bug has been fixed where the Send Email Using Microsoft365 block would crash the Execution Service. -### Bug Fixes + -#### Capability +##### Published packages with nested flows fail to execute -##### {{% ctx %}} Gateway encryptor not aligned with Service Fabric +A bug has been fixed where published flows containing nested flows up to three layers deep would throw a KeyNotFoundException when attempting to execute the third layer. -The Encryptor has been aligned between the {{% ctx %}} Gateway and Service Fabric. -This ensures that encrypted values created with the default key can still be decrypted if a custom private key has been set. + -Affected Components: +##### LINQ expression does not work -* [{{% ctx %}} Gateway][Gateway] +A bug has been fixed where LINQ expressions would not work at all. -#### Upgrade + + +##### Expression containing a string.Split() causes an exception -##### Certificate update does not work after upgrade +A bug has been fixed where an expression containing a string.Split() would sometimes throw a runtime exception. -A bug has been fixed which prevented the update of certificates after an upgrade. + -Affected Components: + -* {{% ctx %}} Upgrade Scripts + + +#### Usability + + +#### Upgrade #### Documentation -##### Missing Platform property in Log Event documentation +#### Installation -The Platform property the the Log Event documentation was missing. This has been added to the documentation. +##### Fixed error the installation what-if command -### Breaking Changes +The installation script no longer import the ServiceFabric PowerShell module when running the what-if command. -The following features have introduced breaking changes in the 2024.9 release of the {{% ctx %}} Platform: + -#### Upgrade to .NET 8 + + -The platform has been upgraded to [.NET 8][]. -#### Reduction of total number of NServiceBus endpoints and RabbitMQ queues + -The following feature has changed internal endpoints and queues in the platform, which may cause issues if upgrading from 2024.7 to 2024.9 without upgrading all components at the same time. -The platform will need to be upgraded using the [Upgrade Instructions][]. -#### Server-side validation added to {{% ctx %}} Gateway API + + + + + + + + -The following feature has added validation to the [{{% ctx %}} Gateway][] API to prevent [Path Traversal][] attacks, which now returns an error if the path is invalid. +### Breaking Changes + +The following features have introduced breaking changes in the 2024.11 release of the {{% ctx %}} Platform: ### Known Limitations @@ -476,6 +394,7 @@ There are no known limitations added as part of the 2024.9 release of the {{% ct | Release | Compatibility Version | |---------|-----------------------| +| 2024.11 | 31.24311 | | 2024.9 | 31.24311 | | 2024.7 | 31.24311 | | 2024.5 | 31.24311 | @@ -483,7 +402,7 @@ There are no known limitations added as part of the 2024.9 release of the {{% ct ## Install Instructions -If you are installing a new 2024.9 platform or adding it to an existing 7.2 Installation see the guidance below; otherwise, if you are upgrading from an existing 2024.7 platform refer to the [Upgrade Instructions][]. +If you are installing a new 2024.11 platform or adding it to an existing 7.2 Installation see the guidance below; otherwise, if you are upgrading from an existing 2024.9 platform refer to the [Upgrade Instructions][]. Installing {{% ctx %}} Only: @@ -497,7 +416,7 @@ Adding {{% ctx %}} to a 7.2 Installation: ## Upgrade Instructions -If you are upgrading from an existing 2024.7 platform see the guidance below: +If you are upgrading from an existing 2024.9 platform see the guidance below: Upgrading {{% ctx %}}: @@ -510,125 +429,46 @@ Releases are currently forecast to be made available on: | Release | Release Type | Forecast Release Date | |---------|----------------|------------------------------------| -| 2024.9 | [Release][] | Week commencing 7th October 2024 | -| 2024.11 | [Fast Track][] | Week commencing 2nd December 2024 | | 2025.1 | [Fast Track][] | Week commencing 10th February 2024 | -[{{% ctx %}} Innovation Core Application]: {{< url path="Cortex.Guides.CortexInnovation.CoreApplication.MainDoc" version="2024.9" >}} -[{{% ctx %}} API Gateway Service]: {{< url path="Cortex.Guides.CortexInnovation.CoreApplication.Services.ApiGatewayService.MainDoc" version="2024.9" >}} -[{{% ctx %}} Authorisation Service]: {{< url path="Cortex.Guides.CortexInnovation.CoreApplication.Services.AuthorisationService.MainDoc" version="2024.9" >}} -[{{% ctx %}} Concurrency Management Service]: {{< url path="Cortex.Guides.CortexInnovation.CoreApplication.Services.ConcurrencyManagementService.MainDoc" version="2024.9" >}} -[{{% ctx %}} Configuration Management Service]: {{< url path="Cortex.Guides.CortexInnovation.CoreApplication.Services.ConfigurationManagementService.MainDoc" version="2024.9" >}} -[{{% ctx %}} Data Storage Service]: {{< url path="Cortex.Guides.CortexInnovation.CoreApplication.Services.DataStorageService.MainDoc" version="2024.9" >}} -[{{% ctx %}} Execution Management Service]: {{< url path="Cortex.Guides.CortexInnovation.CoreApplication.Services.ExecutionManagementService.MainDoc" version="2024.9" >}} -[{{% ctx %}} Licence Management Service]: {{< url path="Cortex.Guides.CortexInnovation.CoreApplication.Services.LicenceManagementService.MainDoc" version="2024.9" >}} -[{{% ctx %}} Listeners Service]: {{< url path="Cortex.Guides.CortexInnovation.CoreApplication.Services.ListenersService.MainDoc" version="2024.9" >}} -[{{% ctx %}} Package Management Service]: {{< url path="Cortex.Guides.CortexInnovation.CoreApplication.Services.PackageManagementService.MainDoc" version="2024.9" >}} -[{{% ctx %}} Provisioning Service]: {{< url path="Cortex.Guides.CortexInnovation.CoreApplication.Services.ProvisioningService.MainDoc" version="2024.9" >}} -[{{% ctx %}} Scheduling Service]: {{< url path="Cortex.Guides.CortexInnovation.CoreApplication.Services.SchedulingService.MainDoc" version="2024.9" >}} -[{{% ctx %}} Triggers Service]: {{< url path="Cortex.Guides.CortexInnovation.CoreApplication.Services.TriggersService.MainDoc" version="2024.9" >}} -[{{% ctx %}} Innovation Execution Application]: {{< url path="Cortex.Guides.CortexInnovation.ExecutionApplication.MainDoc" version="2024.9" >}} -[{{% ctx %}} Execution Service]: {{< url path="Cortex.Guides.CortexInnovation.ExecutionApplication.Services.ExecutionService.MainDoc" version="2024.9" >}} -[Interaction Portal]: {{< url path="Cortex.Guides.CortexInteractionPortal.MainDoc" version="2024.9" >}} - -[Process and Activity]: {{< ref "#process-and-activity" >}} -[Saving Output Properties to multiple variables]: {{< ref "#saving-output-properties-to-multiple-variables" >}} -[execution context variable]: {{< ref "#execution-context-variable" >}} -[Proxy for the {{% ctx %}} 7 Flow API]: {{< ref "#proxy-for-the-cortex-7-flow-api" >}} -[Observability]: {{< ref "#observability" >}} -[Logging added to blocks that communicate with external systems]: {{< ref "#logging-added-to-blocks-that-communicate-with-external-systems" >}} -[Scalability]: {{< ref "#scalability" >}} -[Reduction of total number of NServiceBus endpoints and RabbitMQ queues]: {{< ref "#reduction-of-total-number-of-nservicebus-endpoints-and-rabbitmq-queues" >}} -[Security]: {{< ref "#security" >}} -[Upgrade OpenSSL]: {{< ref "#upgrade-openssl" >}} -[Multi-domain certificates support]: {{< ref "#multi-domain-certificates-support" >}} -[New CortexManagementUser added to manage RabbitMQ queues]: {{< ref "#new-cortexmanagementuser-added-to-manage-rabbitmq-queues" >}} -[Server-side validation added to {{% ctx %}} Gateway API]: {{< ref "#server-side-validation-added-to-cortex-gateway-api" >}} -[Remove refresh token cookie on sign out]: {{< ref "#remove-refresh-token-cookie-on-sign-out" >}} -[Usability]: {{< ref "#usability" >}} -[Rename Flows Charm to Dev and change icon]: {{< ref "#rename-flows-charm-to-dev-and-change-icon" >}} -[Rename Settings Charm to Admin and change icon]: {{< ref "#rename-settings-charm-to-admin-and-change-icon" >}} -[Third-party Support]: {{< ref "#third-party-support" >}} -[Upgrade to .NET 8]: {{< ref "#upgrade-to-net-8" >}} -[Installation]: {{< ref "#installation" >}} -[Support installation when files are blocked by the operating system]: {{< ref "#support-installation-when-files-are-blocked-by-the-operating-system" >}} -[Upgrade]: {{< ref "#upgrade" >}} -[Support upgrade when files are blocked by the operating system]: {{< ref "#support-upgrade-when-files-are-blocked-by-the-operating-system" >}} -[Execution Service is upgraded when the engine version is unchanged]: {{< ref "#execution-service-is-upgraded-when-the-engine-version-is-unchanged" >}} -[Handling of the Execution Services lifecycle events]: {{< ref "#handling-of-the-execution-services-lifecycle-events" >}} -[Documentation]: {{< ref "#documentation" >}} -[Process and Activity Documentation]: {{< ref "#process-and-activity-1" >}} -[Decomposition of Output properties]: {{< ref "#decomposition-of-output-properties" >}} -[Prevent deadlocks when using semaphores]: {{< ref "#prevent-deadlocks-when-using-semaphores" >}} -[Screenshots updated]: {{< ref "#screenshots-updated" >}} -[Flow compatibility version introduced]: {{< ref "#flow-compatibility-version-introduced" >}} -[General improvements to the documentation]: {{< ref "#general-improvements-to-the-documentation" >}} - -[Flow compatibility version]: {{< ref "#flow-compatibility" >}} +[{{% ctx %}} Innovation Core Application]: {{< url path="Cortex.Guides.CortexInnovation.CoreApplication.MainDoc" version="2024.11" >}} +[{{% ctx %}} API Gateway Service]: {{< url path="Cortex.Guides.CortexInnovation.CoreApplication.Services.ApiGatewayService.MainDoc" version="2024.11" >}} +[{{% ctx %}} Authorisation Service]: {{< url path="Cortex.Guides.CortexInnovation.CoreApplication.Services.AuthorisationService.MainDoc" version="2024.11" >}} +[{{% ctx %}} Concurrency Management Service]: {{< url path="Cortex.Guides.CortexInnovation.CoreApplication.Services.ConcurrencyManagementService.MainDoc" version="2024.11" >}} +[{{% ctx %}} Configuration Management Service]: {{< url path="Cortex.Guides.CortexInnovation.CoreApplication.Services.ConfigurationManagementService.MainDoc" version="2024.11" >}} +[{{% ctx %}} Data Storage Service]: {{< url path="Cortex.Guides.CortexInnovation.CoreApplication.Services.DataStorageService.MainDoc" version="2024.11" >}} +[{{% ctx %}} Execution Management Service]: {{< url path="Cortex.Guides.CortexInnovation.CoreApplication.Services.ExecutionManagementService.MainDoc" version="2024.11" >}} +[{{% ctx %}} Licence Management Service]: {{< url path="Cortex.Guides.CortexInnovation.CoreApplication.Services.LicenceManagementService.MainDoc" version="2024.11" >}} +[{{% ctx %}} Listeners Service]: {{< url path="Cortex.Guides.CortexInnovation.CoreApplication.Services.ListenersService.MainDoc" version="2024.11" >}} +[{{% ctx %}} Package Management Service]: {{< url path="Cortex.Guides.CortexInnovation.CoreApplication.Services.PackageManagementService.MainDoc" version="2024.11" >}} +[{{% ctx %}} Provisioning Service]: {{< url path="Cortex.Guides.CortexInnovation.CoreApplication.Services.ProvisioningService.MainDoc" version="2024.11" >}} +[{{% ctx %}} Scheduling Service]: {{< url path="Cortex.Guides.CortexInnovation.CoreApplication.Services.SchedulingService.MainDoc" version="2024.11" >}} +[{{% ctx %}} Triggers Service]: {{< url path="Cortex.Guides.CortexInnovation.CoreApplication.Services.TriggersService.MainDoc" version="2024.11" >}} +[{{% ctx %}} Innovation Execution Application]: {{< url path="Cortex.Guides.CortexInnovation.ExecutionApplication.MainDoc" version="2024.11" >}} +[{{% ctx %}} Execution Service]: {{< url path="Cortex.Guides.CortexInnovation.ExecutionApplication.Services.ExecutionService.MainDoc" version="2024.11" >}} +[Interaction Portal]: {{< url path="Cortex.Guides.CortexInteractionPortal.MainDoc" version="2024.11" >}} [Upgrade Instructions]: {{< ref "#upgrade-instructions" >}} +[Blocks]: {{< url path="Cortex.Reference.Blocks.MainDoc" version="2024.11" >}} -[{{% ctx %}} Gateway]: {{< url path="Cortex.Guides.Gateway.MainDoc" version="2024.9" >}} -[Blocks]: {{< url path="Cortex.Reference.Blocks.MainDoc" version="2024.9" >}} -[What is a Flow]: {{< url path="Cortex.Reference.Concepts.Fundamentals.Flows.WhatIsAFlow.MainDoc" version="2024.9" >}} -[Process]: {{< url path="Cortex.Reference.Concepts.Fundamentals.Flows.WhatIsAFlow.Process" version="2024.9" >}} -[Activity]: {{< url path="Cortex.Reference.Concepts.Fundamentals.Flows.WhatIsAFlow.Activity" version="2024.9" >}} -[What is a Block Property]: {{< url path="Cortex.Reference.Concepts.Fundamentals.Blocks.BlockProperties.WhatIsABlockProperty.MainDoc" version="2024.9" >}} - -[prevent deadlocks]: {{< url path="Cortex.Reference.Concepts.WorkingWith.Concurrency.Semaphores.WhatIsASemaphore.PreventingDeadlocks" version="2024.9" >}} - -[Execute Data Command]: {{< url path="Cortex.Reference.Blocks.Data.ExecuteDataCommand.ExecuteDataCommand.MainDoc" version="2024.9" >}} -[DataCommand]: {{< url path="Cortex.Reference.Blocks.Data.ExecuteDataCommand.ExecuteDataCommand.CommandProperty" version="2024.9" >}} - -[Execute HTTP Request]: {{< url path="Cortex.Reference.Blocks.Http.ExecuteHttpRequest.ExecuteHttpRequest.MainDoc" version="2024.9" >}} -[HttpRequest]: {{< url path="Cortex.Reference.Blocks.Http.ExecuteHttpRequest.ExecuteHttpRequest.HttpRequestProperty" version="2024.9" >}} -[HttpResponse]: {{< url path="Cortex.Reference.Blocks.Http.ExecuteHttpRequest.ExecuteHttpRequest.HttpResponseProperty" version="2024.9" >}} - -[Execute Soap Request]: {{< url path="Cortex.Reference.Blocks.Http.ExecuteSoapRequest.ExecuteSoapRequest.MainDoc" version="2024.9" >}} -[SoapRequest]: {{< url path="Cortex.Reference.Blocks.Http.ExecuteSoapRequest.ExecuteSoapRequest.SoapRequestProperty" version="2024.9" >}} -[SoapResponse]: {{< url path="Cortex.Reference.Blocks.Http.ExecuteSoapRequest.ExecuteSoapRequest.SoapResponseProperty" version="2024.9" >}} +[Gateway]: {{< url path="Cortex.Guides.Gateway.MainDoc" version="2024.11" >}} -[Execute Powershell Script]: {{< url path="Cortex.Reference.Blocks.PowerShell.ExecutePowerShellScript.ExecutePowerShellScript.MainDoc" version="2024.9" >}} -[Script]: {{< url path="Cortex.Reference.Blocks.PowerShell.ExecutePowerShellScript.ExecutePowerShellScript.ScriptProperty" version="2024.9" >}} -[Parameters]: {{< url path="Cortex.Reference.Blocks.PowerShell.ExecutePowerShellScript.ExecutePowerShellScript.ParametersProperty" version="2024.9" >}} -[Outputs]: {{< url path="Cortex.Reference.Blocks.PowerShell.ExecutePowerShellScript.ExecutePowerShellScript.OutputsProperty" version="2024.9" >}} -[Records]: {{< url path="Cortex.Reference.Blocks.PowerShell.ExecutePowerShellScript.ExecutePowerShellScript.RecordsProperty" version="2024.9" >}} +[Innovation Only - Single Server - Without HA]: {{< url path="Cortex.GettingStarted.OnPremise.InstallInnovationOnly.SingleServerWithoutHA.MainDoc" version="2024.11" >}} +[Innovation Only - Multiple Server - With HA]: {{< url path="Cortex.GettingStarted.OnPremise.InstallInnovationOnly.MultipleServerWithHA.MainDoc" version="2024.11" >}} -[Execute SSH Command]: {{< url path="Cortex.Reference.Blocks.Ssh.ExecuteSshCommand.ExecuteSshCommandBlock.MainDoc" version="2024.9" >}} -[Command]: {{< url path="Cortex.Reference.Blocks.Ssh.ExecuteSshCommand.ExecuteSshCommandBlock.CommandProperty" version="2024.9" >}} -[Response]: {{< url path="Cortex.Reference.Blocks.Ssh.ExecuteSshCommand.ExecuteSshCommandBlock.Response" version="2024.9" >}} -[SSH Logs]: {{< url path="Cortex.Reference.Blocks.Ssh.ExecuteSshCommand.ExecuteSshCommandBlock.SshLogsProperty" version="2024.9" >}} +[Adding Innovation to a 7.2 Installation - Single Server - Without HA]: {{< url path="Cortex.GettingStarted.OnPremise.AddInnovationTo72.SingleServerWithoutHA.MainDoc" version="2024.11" >}} +[Adding Innovation to a 7.2 Installation - Multiple Server - With HA]: {{< url path="Cortex.GettingStarted.OnPremise.AddInnovationTo72.MultipleServerWithHA.MainDoc" version="2024.11" >}} -[Gateway]: {{< url path="Cortex.Guides.Gateway.MainDoc" version="2024.9" >}} -[Expression Editor]: {{< url path="Cortex.Reference.Concepts.Fundamentals.Blocks.BlockProperties.PropertyEditors.ExpressionEditor.MainDoc" version="2024.9" >}} -[decomposition syntax]: {{< url path="Cortex.Reference.Concepts.Fundamentals.Blocks.BlockProperties.WhatIsABlockProperty.DecomposingOutputProperties" version="2024.9" >}} - -[.NET 8]: {{< url path="Cortex.Reference.Glossary.A-E.DotNet" >}} -[API]: {{< url path="Cortex.Reference.Glossary.A-E.API" >}} -[Service Fabric]: {{< url path="Cortex.Reference.Glossary.P-T.ServiceFabric" >}} -[built-in _executionContext variable]: {{< url path="Cortex.Reference.Concepts.Fundamentals.Executions.WhatIsAnExecution.ExecutionContext" version="2024.9" >}} - -[Innovation Only - Single Server - Without HA]: {{< url path="Cortex.GettingStarted.OnPremise.InstallInnovationOnly.SingleServerWithoutHA.MainDoc" version="2024.9" >}} -[Innovation Only - Multiple Server - With HA]: {{< url path="Cortex.GettingStarted.OnPremise.InstallInnovationOnly.MultipleServerWithHA.MainDoc" version="2024.9" >}} - -[Adding Innovation to a 7.2 Installation - Single Server - Without HA]: {{< url path="Cortex.GettingStarted.OnPremise.AddInnovationTo72.SingleServerWithoutHA.MainDoc" version="2024.9" >}} -[Adding Innovation to a 7.2 Installation - Multiple Server - With HA]: {{< url path="Cortex.GettingStarted.OnPremise.AddInnovationTo72.MultipleServerWithHA.MainDoc" version="2024.9" >}} - -[Upgrade - Single Server - Without HA]: {{< url path="Cortex.Guides.UpgradeCortex.2024.7to2024.9.SingleServerWithoutHA.MainDoc" version="2024.9" >}} -[Upgrade - Multiple Server - With HA]: {{< url path="Cortex.Guides.UpgradeCortex.2024.7to2024.9.MultipleServerWithHA.MainDoc" version="2024.9" >}} +[Upgrade - Single Server - Without HA]: {{< url path="Cortex.Guides.UpgradeCortex.2024.9to2024.11.SingleServerWithoutHA.MainDoc" version="2024.11" >}} +[Upgrade - Multiple Server - With HA]: {{< url path="Cortex.Guides.UpgradeCortex.2024.9to2024.11.MultipleServerWithHA.MainDoc" version="2024.11" >}} [Breaking - Reduction of total number of NServiceBus endpoints and RabbitMQ queues]: {{< ref "#reduction-of-total-number-of-nservicebus-endpoints-and-rabbitmq-queues-1" >}} [Breaking - Upgrade to .NET 8]: {{< ref "#upgrade-to-net-8-1" >}} [Breaking - Server-side validation added to {{% ctx %}} Gateway API]: {{< ref "#server-side-validation-added-to-cortex-gateway-api-1" >}} -[{{% ctx %}} Studio]: {{< url path="Cortex.Guides.Studio.MainDoc" version="2024.9" >}} - -[{{% ctx %}} Service Portal]: {{< url path="Cortex.ServicePortal.MainDoc" version="2024.9" >}} - -[Flow]: {{< url path="Cortex.Reference.Concepts.Fundamentals.Flows.WhatIsAFlow.MainDoc" version="2024.9" >}} +[{{% ctx %}} Studio]: {{< url path="Cortex.Guides.Studio.MainDoc" version="2024.11" >}} -[Fast Track]: {{< url path="Cortex.Reference.Glossary.F-J.FastTrack" version="2024.9" >}} -[Release]: {{< url path="Cortex.Reference.Glossary.P-T.Release" version="2024.9" >}} +[{{% ctx %}} Service Portal]: {{< url path="Cortex.ServicePortal.MainDoc" version="2024.11" >}} -[2024.7]: {{< url path="Cortex.Blogs.Releases.2024.7.MainDoc" version="2024.9" >}} +[Fast Track]: {{< url path="Cortex.Reference.Glossary.F-J.FastTrack" version="2024.11" >}} -[Path Traversal]: {{< url path="Owasp.PathTraversal.MainDoc" version="2024.9" >}} +[2024.9]: {{< url path="Cortex.Blogs.Releases.2024.9.MainDoc" version="2024.11" >}} From a3dd1d467773bf140774961d925e3deddc1d1fdb Mon Sep 17 00:00:00 2001 From: cortex-lp Date: Mon, 2 Dec 2024 11:37:08 +0000 Subject: [PATCH 03/14] Added Grafana Components Compatibility section --- content/en/blog/releases/2024.X/2024.11.md | 33 +++++++++++++- content/en/blog/releases/2024.X/2024.3.md | 11 +++++ content/en/blog/releases/2024.X/2024.5.md | 51 ++++++++++++++-------- content/en/blog/releases/2024.X/2024.7.md | 16 +++++++ content/en/blog/releases/2024.X/2024.9.md | 17 ++++++++ data/urls.toml | 2 + 6 files changed, 110 insertions(+), 20 deletions(-) diff --git a/content/en/blog/releases/2024.X/2024.11.md b/content/en/blog/releases/2024.X/2024.11.md index 663930c0b..aa8442057 100644 --- a/content/en/blog/releases/2024.X/2024.11.md +++ b/content/en/blog/releases/2024.X/2024.11.md @@ -62,6 +62,7 @@ Installation artefacts can be requested by raising a case in the [{{% ctx %}} Se | {{% ctx %}} Encryption Key Generator | 2.0.0.24350 | Yes | Major | Yes | Major changes occurred between releases, these changes are related to the upgrade to .NET 8 and are [breaking][Breaking - Upgrade to .NET 8] between 2024.7 and 2024.9 | | {{% ctx %}} Encryptor | 3.1.0.24330 | No | N/A | N/A | | | {{% ctx %}} Flows Upgrader | 2.0.0.24350 | Yes | Major | Yes | Major changes occurred between releases, these changes are related to the upgrade to .NET 8 and are [breaking][Breaking - Upgrade to .NET 8] between 2024.7 and 2024.9 | +| {{% ctx %}} Observability | 3.0.0 | No | N/A | N/A | | ### Features @@ -330,11 +331,18 @@ A bug has been fixed where an expression containing a string.Split() would somet - +##### Opened ports for RabbitMQ Stream + +A bug has been fixed logs were being generated due to RabbitMQ Stream ports not being open. #### Usability + +##### LiveView datetime picker styling issues + +A bug has been fixed where the LiveView datetime picker would not display correctly. + #### Upgrade @@ -349,7 +357,10 @@ The installation script no longer import the ServiceFabric PowerShell module whe - +##### Update certificate doesn't update load balancer health check subject name + +A bug has been fixed where updating the certificate would not update the load balancer health check subject name. + @@ -362,6 +373,7 @@ The installation script no longer import the ServiceFabric PowerShell module whe + @@ -400,6 +412,16 @@ There are no known limitations added as part of the 2024.9 release of the {{% ct | 2024.5 | 31.24311 | | 2024.3 | 30 | +### Grafana Components Compatibility + +| Release | Grafana WebApp Version | Grafana Loki Version | Observability Version | +|---------|--------------------------|----------------------|------------------------------| +| 2024.11 | [10.4.1][Grafana 10.4.1] | [3.0.0][Loki 3.0.0] | [3.0.0][Observability 3.0.0] | +| 2024.9 | [10.4.1][Grafana 10.4.1] | [3.0.0][Loki 3.0.0] | [3.0.0][Observability 3.0.0] | +| 2024.7 | [10.4.1][Grafana 10.4.1] | [3.0.0][Loki 3.0.0] | [3.0.0][Observability 3.0.0] | +| 2024.5 | [10.4.1][Grafana 10.4.1] | [3.0.0][Loki 3.0.0] | [3.0.0][Observability 3.0.0] | +| 2024.3 | [8.5.4][Grafana 8.5.4] | [2.5.0][Loki 2.5.0] | [2.2.0][Observability 2.2.0] | + ## Install Instructions If you are installing a new 2024.11 platform or adding it to an existing 7.2 Installation see the guidance below; otherwise, if you are upgrading from an existing 2024.9 platform refer to the [Upgrade Instructions][]. @@ -472,3 +494,10 @@ Releases are currently forecast to be made available on: [Fast Track]: {{< url path="Cortex.Reference.Glossary.F-J.FastTrack" version="2024.11" >}} [2024.9]: {{< url path="Cortex.Blogs.Releases.2024.9.MainDoc" version="2024.11" >}} + +[Grafana 8.5.4]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaWebApp.Windows" >}} +[Grafana 10.4.1]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaWebApp.10.4.1.Windows" >}} +[Loki 3.0.0]: {{< url path="GitHub.Cortex.Observability.2.2.0.Grafana.SelfManaged.Downloads.GrafanaLoki.3.0.0.GrafanaLokiInstallZip" >}} +[Loki 2.5.0]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaLoki.GrafanaLokiInstallZip" >}} +[Observability 3.0.0]: {{< url path="GitHub.Cortex.Observability.3.0.0.MainDoc" >}} +[Observability 2.2.0]: {{< url path="GitHub.Cortex.Observability.2.2.0.MainDoc" >}} diff --git a/content/en/blog/releases/2024.X/2024.3.md b/content/en/blog/releases/2024.X/2024.3.md index 93c76a61c..e638e069d 100644 --- a/content/en/blog/releases/2024.X/2024.3.md +++ b/content/en/blog/releases/2024.X/2024.3.md @@ -86,6 +86,7 @@ Also, new documentation has been added to reflect the new [platform upgrade proc | {{% ctx %}} Encryption Key Generator | 1.2.0.23470 | No | N/A | N/A | | | {{% ctx %}} Encryptor | 3.0.0.23460 | Yes | Major | No | Major changes occurred between internal development releases, however, these changes are not breaking between 2024.1 and 2024.3 | | {{% ctx %}} Flows Upgrader | 1.1.0.24210 | First Release | First Release | N/A | | +| {{% ctx %}} Observability | 2.5.0 | No | N/A | N/A | | ### Features @@ -625,6 +626,12 @@ There are no known limitations added as part of the 2024.3 release of the {{% ct |---------|-----------------------| | 2024.3 | 30 | +### Grafana Components Compatibility + +| Release | Grafana WebApp Version | Grafana Loki Version | Observability Version | +|---------|--------------------------|----------------------|------------------------------| +| 2024.3 | [8.5.4][Grafana 8.5.4] | [2.5.0][Loki 2.5.0] | [2.2.0][Observability 2.2.0] | + ## Install Instructions If you are installing a new 2024.3 platform or adding it to an existing 7.2 Installation see the guidance below; otherwise, if you are upgrading from an existing 2024.1 platform refer to the [Upgrade Instructions][]. @@ -734,3 +741,7 @@ Releases are currently forecast to be made available on: [2024.1]: {{< url path="Cortex.Blogs.Releases.2024.1.MainDoc" version="2024.3" >}} [OracleParameters]: {{< url path="Cortex.Reference.DataTypes.Data.OracleParameters.MainDoc" >}} [OracleParameter]: {{< url path="Cortex.Reference.DataTypes.Data.OracleParameter.MainDoc" >}} + +[Grafana 8.5.4]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaWebApp.Windows" >}} +[Loki 2.5.0]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaLoki.GrafanaLokiInstallZip" >}} +[Observability 2.2.0]: {{< url path="GitHub.Cortex.Observability.2.2.0.MainDoc" >}} diff --git a/content/en/blog/releases/2024.X/2024.5.md b/content/en/blog/releases/2024.X/2024.5.md index 8327e4d02..5b8bb7911 100644 --- a/content/en/blog/releases/2024.X/2024.5.md +++ b/content/en/blog/releases/2024.X/2024.5.md @@ -61,29 +61,30 @@ Finally, this [Product Portal][] includes updates related to: | Release Component | Version | Updated | Update Type | Breaking Change | Notes | |--------------------------------------------------------------------------------|--------------------|---------|-------------|-----------------|-------| -| [{{% ctx %}} Innovation Core Application][] | 45.0.5.24260 | Yes | Major | Potential | Major changes occurred between releases, these changes are related to the extended scope and are [potentially breaking][Potentially Breaking - Scope] between 2024.3 and 2024.5 | -|     > [{{% ctx %}} API Gateway Service][] | 35.0.4.24260 | Yes | Major | Potential | Major changes occurred between releases, these changes are related to the extended scope and are [potentially breaking][Potentially Breaking - Scope] between 2024.3 and 2024.5 | -|     > [{{% ctx %}} Authorisation Service][] | 4.0.18.24260 | Yes | Patch | No | | -|     > [{{% ctx %}} Concurrency Management Service][] | 4.0.4.24260 | Yes | Major | Potential | Major changes occurred between releases, these changes are related to the extended scope and are [potentially breaking][Potentially Breaking - Scope] between 2024.3 and 2024.5 | -|     > [{{% ctx %}} Configuration Management Service][] | 3.2.14.24260 | Yes | Patch | No | | -|     > [{{% ctx %}} Data Storage Service][] | 5.0.4.24260 | Yes | Major | Potential | Major changes occurred between releases, these changes are related to the extended scope and are [potentially breaking][Potentially Breaking - Scope] between 2024.3 and 2024.5 | -|     > [{{% ctx %}} Execution Management Service][] | 4.0.21.24260 | Yes | Patch | No | | -|     > [{{% ctx %}} Licence Management Service][] | 4.0.18.24260 | Yes | Patch | No | | -|     > [{{% ctx %}} Package Management Service][] | 8.1.6.24260 | Yes | Minor | No | | -|     > [{{% ctx %}} Provisioning Service][] | 9.0.19.24260 | Yes | Patch | No | | -|     > [{{% ctx %}} Scheduling Service][] | 4.1.13.24260 | Yes | Patch | No | | -|     > [{{% ctx %}} Triggers Service][] | 6.1.13.24260 | Yes | Patch | No | | -| [{{% ctx %}} Innovation Execution Application][] | 17.0.4.24260 | Yes | Major | Potential | Major changes occurred between releases, these changes are related to the extended scope and are [potentially breaking][Potentially Breaking - Scope] between 2024.3 and 2024.5 | -|     > [{{% ctx %}} Execution Service][] | 17.0.4.24260 | Yes | Major | Potential | Major changes occurred between releases, these changes are related to the extended scope and are [potentially breaking][Potentially Breaking - Scope] between 2024.3 and 2024.5 | -| [{{% ctx %}} Gateway][Gateway], including [{{% ctx %}} Studio][] | 10.23.2.24260 | Yes | Minor | No | | -| [{{% ctx %}} Blocks Package][Blocks] | 44.3.1.24260 | Yes | Major | Potential | Major changes occurred between releases, these changes are related to the extended scope and are [potentially breaking][Potentially Breaking - Scope] between 2024.3 and 2024.5

Compatibility Version: 31.24250 | +| [{{% ctx %}} Innovation Core Application][] | 45.0.5.24260 | Yes | Major | Potential | Major changes occurred between releases, these changes are related to the extended scope and are [potentially breaking][Potentially Breaking - Scope] between 2024.3 and 2024.5 | +|     > [{{% ctx %}} API Gateway Service][] | 35.0.4.24260 | Yes | Major | Potential | Major changes occurred between releases, these changes are related to the extended scope and are [potentially breaking][Potentially Breaking - Scope] between 2024.3 and 2024.5 | +|     > [{{% ctx %}} Authorisation Service][] | 4.0.18.24260 | Yes | Patch | No | | +|     > [{{% ctx %}} Concurrency Management Service][] | 4.0.4.24260 | Yes | Major | Potential | Major changes occurred between releases, these changes are related to the extended scope and are [potentially breaking][Potentially Breaking - Scope] between 2024.3 and 2024.5 | +|     > [{{% ctx %}} Configuration Management Service][] | 3.2.14.24260 | Yes | Patch | No | | +|     > [{{% ctx %}} Data Storage Service][] | 5.0.4.24260 | Yes | Major | Potential | Major changes occurred between releases, these changes are related to the extended scope and are [potentially breaking][Potentially Breaking - Scope] between 2024.3 and 2024.5 | +|     > [{{% ctx %}} Execution Management Service][] | 4.0.21.24260 | Yes | Patch | No | | +|     > [{{% ctx %}} Licence Management Service][] | 4.0.18.24260 | Yes | Patch | No | | +|     > [{{% ctx %}} Package Management Service][] | 8.1.6.24260 | Yes | Minor | No | | +|     > [{{% ctx %}} Provisioning Service][] | 9.0.19.24260 | Yes | Patch | No | | +|     > [{{% ctx %}} Scheduling Service][] | 4.1.13.24260 | Yes | Patch | No | | +|     > [{{% ctx %}} Triggers Service][] | 6.1.13.24260 | Yes | Patch | No | | +| [{{% ctx %}} Innovation Execution Application][] | 17.0.4.24260 | Yes | Major | Potential | Major changes occurred between releases, these changes are related to the extended scope and are [potentially breaking][Potentially Breaking - Scope] between 2024.3 and 2024.5 | +|     > [{{% ctx %}} Execution Service][] | 17.0.4.24260 | Yes | Major | Potential | Major changes occurred between releases, these changes are related to the extended scope and are [potentially breaking][Potentially Breaking - Scope] between 2024.3 and 2024.5 | +| [{{% ctx %}} Gateway][Gateway], including [{{% ctx %}} Studio][] | 10.23.2.24260 | Yes | Minor | No | | +| [{{% ctx %}} Blocks Package][Blocks] | 44.3.1.24260 | Yes | Major | Potential | Major changes occurred between releases, these changes are related to the extended scope and are [potentially breaking][Potentially Breaking - Scope] between 2024.3 and 2024.5

Compatibility Version: 31.24250 | | [{{% ctx %}} Interaction Portal][Interaction Portal] | 1.0.2.24260 | Yes | Patch | No | | | {{% ctx %}} App Server Install Scripts | 5.1.0.24140 | No | N/A | No | | -| {{% ctx %}} Web App Server Install Scripts | 9.0.0.24240 | Yes | Major | No | Major changes occurred between internal development releases, however, these changes are not breaking between 2024.3 and 2024.5 | +| {{% ctx %}} Web App Server Install Scripts | 9.0.0.24240 | Yes | Major | No | Major changes occurred between internal development releases, however, these changes are not breaking between 2024.3 and 2024.5 | | {{% ctx %}} Licence Fingerprint Generator | 3.1.1.24250 | Yes | Minor | N/A | | | {{% ctx %}} Encryption Key Generator | 1.2.0.23470 | No | N/A | N/A | | | {{% ctx %}} Encryptor | 3.0.0.23460 | No | N/A | N/A | | | {{% ctx %}} Flows Upgrader | 1.1.0.24210 | No | N/A | N/A | | +| {{% ctx %}} Observability | 3.0.0 | Yes | Major | N/A | | ### Features @@ -348,6 +349,13 @@ There are no known limitations added as part of the 2024.5 release of the {{% ct | 2024.5 | 31.24311 | | 2024.3 | 30 | +### Grafana Components Compatibility + +| Release | Grafana WebApp Version | Grafana Loki Version | Observability Version | +|---------|--------------------------|----------------------|------------------------------| +| 2024.5 | [10.4.1][Grafana 10.4.1] | [3.0.0][Loki 3.0.0] | [3.0.0][Observability 3.0.0] | +| 2024.3 | [8.5.4][Grafana 8.5.4] | [2.5.0][Loki 2.5.0] | [2.2.0][Observability 2.2.0] | + ## Install Instructions If you are installing a new 2024.5 platform or adding it to an existing 7.2 Installation see the guidance below; otherwise, if you are upgrading from an existing 2024.3 platform refer to the [Upgrade Instructions][]. @@ -464,4 +472,11 @@ Releases are currently forecast to be made available on: [Fast Track]: {{< url path="Cortex.Reference.Glossary.F-J.FastTrack" version="2024.5" >}} [Release]: {{< url path="Cortex.Reference.Glossary.P-T.Release" version="2024.5" >}} -[2024.3]: {{< url path="Cortex.Blogs.Releases.2024.3.MainDoc" version="2024.5" >}} \ No newline at end of file +[2024.3]: {{< url path="Cortex.Blogs.Releases.2024.3.MainDoc" version="2024.5" >}} + +[Grafana 8.5.4]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaWebApp.Windows" >}} +[Grafana 10.4.1]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaWebApp.10.4.1.Windows" >}} +[Loki 3.0.0]: {{< url path="GitHub.Cortex.Observability.2.2.0.Grafana.SelfManaged.Downloads.GrafanaLoki.3.0.0.GrafanaLokiInstallZip" >}} +[Loki 2.5.0]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaLoki.GrafanaLokiInstallZip" >}} +[Observability 3.0.0]: {{< url path="GitHub.Cortex.Observability.3.0.0.MainDoc" >}} +[Observability 2.2.0]: {{< url path="GitHub.Cortex.Observability.2.2.0.MainDoc" >}} diff --git a/content/en/blog/releases/2024.X/2024.7.md b/content/en/blog/releases/2024.X/2024.7.md index 08ee71d65..4ef0955b0 100644 --- a/content/en/blog/releases/2024.X/2024.7.md +++ b/content/en/blog/releases/2024.X/2024.7.md @@ -85,6 +85,7 @@ Finally, the [Product Portal][] includes updates related to: | {{% ctx %}} Encryption Key Generator | 1.2.0.23470 | No | N/A | N/A | | | {{% ctx %}} Encryptor | 3.1.0.24330 | Yes | Minor | N/A | | | {{% ctx %}} Flows Upgrader | 1.2.1.24330 | Yes | Minor | N/A | | +| {{% ctx %}} Observability | 3.0.0 | No | N/A | N/A | | ### Features @@ -354,6 +355,14 @@ There are no known limitations added as part of the 2024.7 release of the {{% ct | 2024.5 | 31.24311 | | 2024.3 | 30 | +### Grafana Components Compatibility + +| Release | Grafana WebApp Version | Grafana Loki Version | Observability Version | +|---------|--------------------------|----------------------|------------------------------| +| 2024.7 | [10.4.1][Grafana 10.4.1] | [3.0.0][Loki 3.0.0] | [3.0.0][Observability 3.0.0] | +| 2024.5 | [10.4.1][Grafana 10.4.1] | [3.0.0][Loki 3.0.0] | [3.0.0][Observability 3.0.0] | +| 2024.3 | [8.5.4][Grafana 8.5.4] | [2.5.0][Loki 2.5.0] | [2.2.0][Observability 2.2.0] | + ## Install Instructions If you are installing a new 2024.7 platform or adding it to an existing 7.2 Installation see the guidance below; otherwise, if you are upgrading from an existing 2024.5 platform refer to the [Upgrade Instructions][]. @@ -471,3 +480,10 @@ Releases are currently forecast to be made available on: [Release]: {{< url path="Cortex.Reference.Glossary.P-T.Release" version="2024.7" >}} [2024.5]: {{< url path="Cortex.Blogs.Releases.2024.5.MainDoc" version="2024.7" >}} + +[Grafana 8.5.4]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaWebApp.Windows" >}} +[Grafana 10.4.1]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaWebApp.10.4.1.Windows" >}} +[Loki 3.0.0]: {{< url path="GitHub.Cortex.Observability.2.2.0.Grafana.SelfManaged.Downloads.GrafanaLoki.3.0.0.GrafanaLokiInstallZip" >}} +[Loki 2.5.0]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaLoki.GrafanaLokiInstallZip" >}} +[Observability 3.0.0]: {{< url path="GitHub.Cortex.Observability.3.0.0.MainDoc" >}} +[Observability 2.2.0]: {{< url path="GitHub.Cortex.Observability.2.2.0.MainDoc" >}} diff --git a/content/en/blog/releases/2024.X/2024.9.md b/content/en/blog/releases/2024.X/2024.9.md index 87de9aae1..96e7e4673 100644 --- a/content/en/blog/releases/2024.X/2024.9.md +++ b/content/en/blog/releases/2024.X/2024.9.md @@ -100,6 +100,7 @@ Finally, the [Documentation][] includes updates related to: | {{% ctx %}} Encryption Key Generator | 2.0.0.24350 | Yes | Major | Yes | Major changes occurred between releases, these changes are related to the upgrade to .NET 8 and are [breaking][Breaking - Upgrade to .NET 8] between 2024.7 and 2024.9 | | {{% ctx %}} Encryptor | 3.1.0.24330 | No | N/A | N/A | | | {{% ctx %}} Flows Upgrader | 2.0.0.24350 | Yes | Major | Yes | Major changes occurred between releases, these changes are related to the upgrade to .NET 8 and are [breaking][Breaking - Upgrade to .NET 8] between 2024.7 and 2024.9 | +| {{% ctx %}} Observability | 3.0.0 | No | N/A | N/A | | ### Features @@ -481,6 +482,15 @@ There are no known limitations added as part of the 2024.9 release of the {{% ct | 2024.5 | 31.24311 | | 2024.3 | 30 | +### Grafana Components Compatibility + +| Release | Grafana WebApp Version | Grafana Loki Version | Observability Version | +|---------|--------------------------|----------------------|------------------------------| +| 2024.9 | [10.4.1][Grafana 10.4.1] | [3.0.0][Loki 3.0.0] | [3.0.0][Observability 3.0.0] | +| 2024.7 | [10.4.1][Grafana 10.4.1] | [3.0.0][Loki 3.0.0] | [3.0.0][Observability 3.0.0] | +| 2024.5 | [10.4.1][Grafana 10.4.1] | [3.0.0][Loki 3.0.0] | [3.0.0][Observability 3.0.0] | +| 2024.3 | [8.5.4][Grafana 8.5.4] | [2.5.0][Loki 2.5.0] | [2.2.0][Observability 2.2.0] | + ## Install Instructions If you are installing a new 2024.9 platform or adding it to an existing 7.2 Installation see the guidance below; otherwise, if you are upgrading from an existing 2024.7 platform refer to the [Upgrade Instructions][]. @@ -632,3 +642,10 @@ Releases are currently forecast to be made available on: [2024.7]: {{< url path="Cortex.Blogs.Releases.2024.7.MainDoc" version="2024.9" >}} [Path Traversal]: {{< url path="Owasp.PathTraversal.MainDoc" version="2024.9" >}} + +[Grafana 8.5.4]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaWebApp.Windows" >}} +[Grafana 10.4.1]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaWebApp.10.4.1.Windows" >}} +[Loki 3.0.0]: {{< url path="GitHub.Cortex.Observability.2.2.0.Grafana.SelfManaged.Downloads.GrafanaLoki.3.0.0.GrafanaLokiInstallZip" >}} +[Loki 2.5.0]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaLoki.GrafanaLokiInstallZip" >}} +[Observability 3.0.0]: {{< url path="GitHub.Cortex.Observability.3.0.0.MainDoc" >}} +[Observability 2.2.0]: {{< url path="GitHub.Cortex.Observability.2.2.0.MainDoc" >}} diff --git a/data/urls.toml b/data/urls.toml index c8784c391..2ac16ba71 100644 --- a/data/urls.toml +++ b/data/urls.toml @@ -2482,10 +2482,12 @@ PromtailInstallZip = "https://github.com/CortexIntelligentAutomation/observability/releases/download/v2.1.0/Promtail.Install.zip" GrafanaDashboardsZip = "https://github.com/CortexIntelligentAutomation/observability/releases/download/v2.1.0/Grafana.Dashboards.zip" [GitHub.Cortex.Observability.2.2.0] + MainDoc = "https://github.com/CortexIntelligentAutomation/observability/releases/tag/v2.2.0" GrafanaLokiInstallZip = "https://github.com/CortexIntelligentAutomation/observability/releases/download/v2.2.0/Grafana.Loki.Install.zip" PromtailInstallZip = "https://github.com/CortexIntelligentAutomation/observability/releases/download/v2.2.0/Promtail.Install.zip" GrafanaDashboardsZip = "https://github.com/CortexIntelligentAutomation/observability/releases/download/v2.2.0/Grafana.Dashboards.zip" [GitHub.Cortex.Observability.3.0.0] + MainDoc = "https://github.com/CortexIntelligentAutomation/observability/releases/tag/v3.0.0" GrafanaLokiInstallZip = "https://github.com/CortexIntelligentAutomation/observability/releases/download/v3.0.0/Grafana.Loki.Install.zip" PromtailInstallZip = "https://github.com/CortexIntelligentAutomation/observability/releases/download/v3.0.0/Promtail.Install.zip" GrafanaDashboardsZip = "https://github.com/CortexIntelligentAutomation/observability/releases/download/v3.0.0/Grafana.Dashboards.zip" From 1d5bc36250ff631e1730e9dc7e364cbc16a37963 Mon Sep 17 00:00:00 2001 From: cortex-lp Date: Mon, 2 Dec 2024 11:42:52 +0000 Subject: [PATCH 04/14] Added monitoring service to table --- content/en/blog/releases/2024.X/2024.11.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/content/en/blog/releases/2024.X/2024.11.md b/content/en/blog/releases/2024.X/2024.11.md index aa8442057..364ef193c 100644 --- a/content/en/blog/releases/2024.X/2024.11.md +++ b/content/en/blog/releases/2024.X/2024.11.md @@ -45,7 +45,8 @@ Installation artefacts can be requested by raising a case in the [{{% ctx %}} Se |     > [{{% ctx %}} Data Storage Service][] | 9.0.13.24430 | Yes | Major | Yes | Major changes occurred between releases, these changes are related to the reduction of the total number of NServiceBus endpoints and RabbitMQ queues are [breaking][Breaking - Reduction of total number of NServiceBus endpoints and RabbitMQ queues] between 2024.7 and 2024.9 if upgraded on its own | |     > [{{% ctx %}} Execution Management Service][] | 7.0.2.24430 | Yes | Major | Yes | Major changes occurred between releases, these changes are related to the reduction of the total number of NServiceBus endpoints and RabbitMQ queues are [breaking][Breaking - Reduction of total number of NServiceBus endpoints and RabbitMQ queues] between 2024.7 and 2024.9 if upgraded on its own | |     > [{{% ctx %}} Licence Management Service][] | 7.0.2.24430 | Yes | Major | Yes | Major changes occurred between releases, these changes are related to the reduction of the total number of NServiceBus endpoints and RabbitMQ queues are [breaking][Breaking - Reduction of total number of NServiceBus endpoints and RabbitMQ queues] between 2024.7 and 2024.9 if upgraded on its own | -|     > [{{% ctx %}} Listeners Service][] | 2.0.0.24430 | Yes | First Release | N/A | | +|     > [{{% ctx %}} Listeners Service][] | 2.0.0.24430 | Yes | | N/A | | +|     > [{{% ctx %}} Monitoring Service][] | 11.0.2.24430 | Yes | First Release | Yes | Major changes occurred between releases, these changes are related to the reduction of the total number of NServiceBus endpoints and RabbitMQ queues are [breaking][Breaking - Reduction of total number of NServiceBus endpoints and RabbitMQ queues] between 2024.7 and 2024.9 if upgraded on its own | |     > [{{% ctx %}} Package Management Service][] | 11.0.2.24430 | Yes | Major | Yes | Major changes occurred between releases, these changes are related to the reduction of the total number of NServiceBus endpoints and RabbitMQ queues are [breaking][Breaking - Reduction of total number of NServiceBus endpoints and RabbitMQ queues] between 2024.7 and 2024.9 if upgraded on its own | |     > [{{% ctx %}} Provisioning Service][] | 13.1.2.24430 | Yes | Major | Yes | Major changes occurred between releases, these changes are related to the reduction of the total number of NServiceBus endpoints and RabbitMQ queues are [breaking][Breaking - Reduction of total number of NServiceBus endpoints and RabbitMQ queues] between 2024.7 and 2024.9 if upgraded on its own | |     > [{{% ctx %}} Scheduling Service][] | 7.0.8.24430 | Yes | Major | Yes | Major changes occurred between releases, these changes are related to the reduction of the total number of NServiceBus endpoints and RabbitMQ queues are [breaking][Breaking - Reduction of total number of NServiceBus endpoints and RabbitMQ queues] between 2024.7 and 2024.9 if upgraded on its own | @@ -462,6 +463,7 @@ Releases are currently forecast to be made available on: [{{% ctx %}} Execution Management Service]: {{< url path="Cortex.Guides.CortexInnovation.CoreApplication.Services.ExecutionManagementService.MainDoc" version="2024.11" >}} [{{% ctx %}} Licence Management Service]: {{< url path="Cortex.Guides.CortexInnovation.CoreApplication.Services.LicenceManagementService.MainDoc" version="2024.11" >}} [{{% ctx %}} Listeners Service]: {{< url path="Cortex.Guides.CortexInnovation.CoreApplication.Services.ListenersService.MainDoc" version="2024.11" >}} +[{{% ctx %}} Monitoring Service]: {{< url path="Cortex.Guides.CortexInnovation.CoreApplication.Services.MonitoringService.MainDoc" version="2024.11" >}} [{{% ctx %}} Package Management Service]: {{< url path="Cortex.Guides.CortexInnovation.CoreApplication.Services.PackageManagementService.MainDoc" version="2024.11" >}} [{{% ctx %}} Provisioning Service]: {{< url path="Cortex.Guides.CortexInnovation.CoreApplication.Services.ProvisioningService.MainDoc" version="2024.11" >}} [{{% ctx %}} Scheduling Service]: {{< url path="Cortex.Guides.CortexInnovation.CoreApplication.Services.SchedulingService.MainDoc" version="2024.11" >}} From 92467fa4a45cb2b1fb841b22777f7391afeb9778 Mon Sep 17 00:00:00 2001 From: cortex-lp Date: Mon, 2 Dec 2024 14:28:58 +0000 Subject: [PATCH 05/14] fix links and updated table of components --- content/en/blog/releases/2024.X/2024.11.md | 82 +++++++++++----------- content/en/blog/releases/2024.X/2024.5.md | 4 +- content/en/blog/releases/2024.X/2024.7.md | 2 +- content/en/blog/releases/2024.X/2024.9.md | 2 +- 4 files changed, 44 insertions(+), 46 deletions(-) diff --git a/content/en/blog/releases/2024.X/2024.11.md b/content/en/blog/releases/2024.X/2024.11.md index 364ef193c..2d98c5159 100644 --- a/content/en/blog/releases/2024.X/2024.11.md +++ b/content/en/blog/releases/2024.X/2024.11.md @@ -37,44 +37,38 @@ Installation artefacts can be requested by raising a case in the [{{% ctx %}} Se | Release Component | Version | Updated | Update Type | Breaking Change | Notes | |--------------------------------------------------------------------------------|---------------|---------|---------------|-----------------|--------| -| [{{% ctx %}} Innovation Core Application][] | 53.0.0.24430 | Yes | Major | Yes | Major changes occurred between releases, these changes are related to the reduction of the total number of NServiceBus endpoints and RabbitMQ queues are [breaking][Breaking - Reduction of total number of NServiceBus endpoints and RabbitMQ queues] between 2024.7 and 2024.9 if upgraded on its own | -|     > [{{% ctx %}} API Gateway Service][] | 38.3.0.24430 | Yes | Major | Yes | Major changes occurred between releases, these changes are related to the reduction of the total number of NServiceBus endpoints and RabbitMQ queues are [breaking][Breaking - Reduction of total number of NServiceBus endpoints and RabbitMQ queues] between 2024.7 and 2024.9 if upgraded on its own | -|     > [{{% ctx %}} Authorisation Service][] | 7.0.2.24430 | Yes | Major | Yes | Major changes occurred between releases, these changes are related to the reduction of the total number of NServiceBus endpoints and RabbitMQ queues are [breaking][Breaking - Reduction of total number of NServiceBus endpoints and RabbitMQ queues] between 2024.7 and 2024.9 if upgraded on its own | -|     > [{{% ctx %}} Concurrency Management Service][] | 7.0.2.24430 | Yes | Major | Yes | Major changes occurred between releases, these changes are related to the reduction of the total number of NServiceBus endpoints and RabbitMQ queues are [breaking][Breaking - Reduction of total number of NServiceBus endpoints and RabbitMQ queues] between 2024.7 and 2024.9 if upgraded on its own | -|     > [{{% ctx %}} Configuration Management Service][] | 7.0.2.24430 | Yes | Major | Yes | Major changes occurred between releases, these changes are related to the reduction of the total number of NServiceBus endpoints and RabbitMQ queues are [breaking][Breaking - Reduction of total number of NServiceBus endpoints and RabbitMQ queues] between 2024.7 and 2024.9 if upgraded on its own | -|     > [{{% ctx %}} Data Storage Service][] | 9.0.13.24430 | Yes | Major | Yes | Major changes occurred between releases, these changes are related to the reduction of the total number of NServiceBus endpoints and RabbitMQ queues are [breaking][Breaking - Reduction of total number of NServiceBus endpoints and RabbitMQ queues] between 2024.7 and 2024.9 if upgraded on its own | -|     > [{{% ctx %}} Execution Management Service][] | 7.0.2.24430 | Yes | Major | Yes | Major changes occurred between releases, these changes are related to the reduction of the total number of NServiceBus endpoints and RabbitMQ queues are [breaking][Breaking - Reduction of total number of NServiceBus endpoints and RabbitMQ queues] between 2024.7 and 2024.9 if upgraded on its own | -|     > [{{% ctx %}} Licence Management Service][] | 7.0.2.24430 | Yes | Major | Yes | Major changes occurred between releases, these changes are related to the reduction of the total number of NServiceBus endpoints and RabbitMQ queues are [breaking][Breaking - Reduction of total number of NServiceBus endpoints and RabbitMQ queues] between 2024.7 and 2024.9 if upgraded on its own | -|     > [{{% ctx %}} Listeners Service][] | 2.0.0.24430 | Yes | | N/A | | -|     > [{{% ctx %}} Monitoring Service][] | 11.0.2.24430 | Yes | First Release | Yes | Major changes occurred between releases, these changes are related to the reduction of the total number of NServiceBus endpoints and RabbitMQ queues are [breaking][Breaking - Reduction of total number of NServiceBus endpoints and RabbitMQ queues] between 2024.7 and 2024.9 if upgraded on its own | -|     > [{{% ctx %}} Package Management Service][] | 11.0.2.24430 | Yes | Major | Yes | Major changes occurred between releases, these changes are related to the reduction of the total number of NServiceBus endpoints and RabbitMQ queues are [breaking][Breaking - Reduction of total number of NServiceBus endpoints and RabbitMQ queues] between 2024.7 and 2024.9 if upgraded on its own | -|     > [{{% ctx %}} Provisioning Service][] | 13.1.2.24430 | Yes | Major | Yes | Major changes occurred between releases, these changes are related to the reduction of the total number of NServiceBus endpoints and RabbitMQ queues are [breaking][Breaking - Reduction of total number of NServiceBus endpoints and RabbitMQ queues] between 2024.7 and 2024.9 if upgraded on its own | -|     > [{{% ctx %}} Scheduling Service][] | 7.0.8.24430 | Yes | Major | Yes | Major changes occurred between releases, these changes are related to the reduction of the total number of NServiceBus endpoints and RabbitMQ queues are [breaking][Breaking - Reduction of total number of NServiceBus endpoints and RabbitMQ queues] between 2024.7 and 2024.9 if upgraded on its own | -|     > [{{% ctx %}} Triggers Service][] | 11.0.0.24430 | Yes | Major | Yes | Major changes occurred between releases, these changes are related to the reduction of the total number of NServiceBus endpoints and RabbitMQ queues are [breaking][Breaking - Reduction of total number of NServiceBus endpoints and RabbitMQ queues] between 2024.7 and 2024.9 if upgraded on its own | -| [{{% ctx %}} Innovation Execution Application][] | 24.1.1.24430 | Yes | Major | Yes | Major changes occurred between releases, these changes are related to the reduction of the total number of NServiceBus endpoints and RabbitMQ queues are [breaking][Breaking - Reduction of total number of NServiceBus endpoints and RabbitMQ queues] between 2024.7 and 2024.9 if upgraded on its own | -|     > [{{% ctx %}} Execution Service][] | 24.1.1.24430 | Yes | Major | Yes | Major changes occurred between releases, these changes are related to the reduction of the total number of NServiceBus endpoints and RabbitMQ queues are [breaking][Breaking - Reduction of total number of NServiceBus endpoints and RabbitMQ queues] between 2024.7 and 2024.9 if upgraded on its own | -| [{{% ctx %}} Gateway][Gateway], including [{{% ctx %}} Studio][] | 12.3.2.24430 | Yes | Major | Yes | Major changes occurred between releases, these changes are related to the server-side validation of the APIs are [breaking][Breaking - Server-side validation added to {{% ctx %}} Gateway API] between 2024.7 and 2024.9 | -| [{{% ctx %}} Blocks Package][Blocks] | 48.2.0.24420 | Yes | Major | Yes | Major changes occurred between releases, these changes are related to the upgrade to .NET 8 and are [breaking][Breaking - Upgrade to .NET 8] between 2024.7 and 2024.9 | -| [{{% ctx %}} Interaction Portal][Interaction Portal] | 2.0.0.24340 | No | N/A | N/A | | -| {{% ctx %}} App Server Install Scripts | 5.2.3.24430 | Yes | Minor | N/A | | -| {{% ctx %}} Web App Server Install Scripts | 8.1.1.24420 | Yes | Patch | N/A | | -| {{% ctx %}} Upgrade Scripts | 1.2.8.24430 | Yes | Patch | N/A | | -| {{% ctx %}} Licence Fingerprint Generator | 4.1.0.24360 | Yes | Major | Yes | Major changes occurred between releases, these changes are related to the upgrade to .NET 8 and are [breaking][Breaking - Upgrade to .NET 8] between 2024.7 and 2024.9 | -| {{% ctx %}} Encryption Key Generator | 2.0.0.24350 | Yes | Major | Yes | Major changes occurred between releases, these changes are related to the upgrade to .NET 8 and are [breaking][Breaking - Upgrade to .NET 8] between 2024.7 and 2024.9 | +| [{{% ctx %}} Innovation Core Application][] | 53.4.0.24460 | Yes | Minor | N/A | | +|     > [{{% ctx %}} API Gateway Service][] | 38.10.3.24460 | Yes | Minor | N/A | | +|     > [{{% ctx %}} Authorisation Service][] | 7.0.15.24460 | Yes | Patch | N/A | | +|     > [{{% ctx %}} Concurrency Management Service][] | 7.0.15.24460 | Yes | Patch | N/A | | +|     > [{{% ctx %}} Configuration Management Service][] | 7.0.15.24460 | Yes | Patch | N/A | | +|     > [{{% ctx %}} Data Storage Service][] | 9.0.26.24460 | Yes | Patch | N/A | | +|     > [{{% ctx %}} Execution Management Service][] | 7.0.17.24460 | Yes | Patch | N/A | | +|     > [{{% ctx %}} Licence Management Service][] | 7.0.15.24460 | Yes | Patch | N/A | | +|     > [{{% ctx %}} Listeners Service][] | 2.0.11.24460 | Yes | Patch | N/A | | +|     > [{{% ctx %}} Monitoring Service][] | 2.4.8.24460 | Yes | First Release | N/A | | +|     > [{{% ctx %}} Package Management Service][] | 11.0.15.24460 | Yes | Patch | N/A | | +|     > [{{% ctx %}} Provisioning Service][] | 13.1.15.24460 | Yes | Patch | N/A | | +|     > [{{% ctx %}} Scheduling Service][] | 7.0.21.24460 | Yes | Patch | N/A | | +|     > [{{% ctx %}} Triggers Service][] | 11.0.14.24460 | Yes | Patch | N/A | | +| [{{% ctx %}} Innovation Execution Application][] | 25.0.4.24460 | Yes | Major | No | Major changes occurred between internal development releases, however, these changes are not breaking between 2024.9 and 2024.11 | +|     > [{{% ctx %}} Execution Service][] | 25.0.4.24460 | Yes | Major | No | Major changes occurred between internal development releases, however, these changes are not breaking between 2024.9 and 2024.11 | +| [{{% ctx %}} Gateway][Gateway], including [{{% ctx %}} Studio][] | 12.11.0.24460 | Yes | Minor | N/A | | +| [{{% ctx %}} Blocks Package][Blocks] | 48.2.4.24460 | Yes | Patch | N/A | | +| [{{% ctx %}} Interaction Portal][Interaction Portal] | 3.0.1.24460 | Yes | Major | Yes | Major changes occurred between releases, these changes are related to support of multiple Cortex Interaction Portal running on the same machine are [breaking][Breaking - Added support for multiple Cortex Interaction Portal running on the same machine] | +| {{% ctx %}} App Server Install Scripts | 5.2.7.24470 | Yes | Patch | N/A | | +| {{% ctx %}} Web App Server Install Scripts | 8.1.2.24460 | Yes | Patch | N/A | | +| {{% ctx %}} Upgrade Scripts | 1.2.16.24460 | Yes | Patch | N/A | | +| {{% ctx %}} Licence Fingerprint Generator | 4.1.0.24360 | No | N/A | N/A | | +| {{% ctx %}} Encryption Key Generator | 2.0.0.24350 | No | N/A | N/A | | | {{% ctx %}} Encryptor | 3.1.0.24330 | No | N/A | N/A | | -| {{% ctx %}} Flows Upgrader | 2.0.0.24350 | Yes | Major | Yes | Major changes occurred between releases, these changes are related to the upgrade to .NET 8 and are [breaking][Breaking - Upgrade to .NET 8] between 2024.7 and 2024.9 | +| {{% ctx %}} Flows Upgrader | 2.0.1.24450 | Yes | Patch | N/A | | | {{% ctx %}} Observability | 3.0.0 | No | N/A | N/A | | ### Features #### Capability -##### Improved session update reliability on slow systems - -The Cortex Interaction Portal now handles session updates more reliably on slower systems. - - - ##### Introduced the Monitoring Service {{% ctx %}} Gateway now includes a Monitoring Service that provides a high-level view of the system's operations. @@ -166,6 +160,12 @@ This allows for multiple instances of the Interaction Portal to be run on the sa +##### Improved session update reliability on slow systems + +The Cortex Interaction Portal now handles session updates more reliably on slower systems. + + + #### Observability ##### Reduced the maximum size of Service Fabric Trace Logs @@ -215,8 +215,6 @@ The X-XSS-PROTECTION header has been removed as it is deprecated. -#### Usability - #### Third-party Support ##### Added Health Check API to Service Fabric API Gateway @@ -346,10 +344,6 @@ A bug has been fixed where the LiveView datetime picker would not display correc -#### Upgrade - -#### Documentation - #### Installation ##### Fixed error the installation what-if command @@ -375,6 +369,7 @@ A bug has been fixed where updating the certificate would not update the load ba + @@ -382,9 +377,14 @@ A bug has been fixed where updating the certificate would not update the load ba The following features have introduced breaking changes in the 2024.11 release of the {{% ctx %}} Platform: +#### Added support for multiple Cortex Interaction Portal running on the same machine + +The following feature has changed both the flows and the AppGyver Solution package. +The platform will need to be re-installed, resulting in the loss of all data, customisation and configurations. + ### Known Limitations -There are no known limitations added as part of the 2024.9 release of the {{% ctx %}} Platform. +There are no known limitations added as part of the 2024.11 release of the {{% ctx %}} Platform. ## Version Support @@ -485,9 +485,7 @@ Releases are currently forecast to be made available on: [Upgrade - Single Server - Without HA]: {{< url path="Cortex.Guides.UpgradeCortex.2024.9to2024.11.SingleServerWithoutHA.MainDoc" version="2024.11" >}} [Upgrade - Multiple Server - With HA]: {{< url path="Cortex.Guides.UpgradeCortex.2024.9to2024.11.MultipleServerWithHA.MainDoc" version="2024.11" >}} -[Breaking - Reduction of total number of NServiceBus endpoints and RabbitMQ queues]: {{< ref "#reduction-of-total-number-of-nservicebus-endpoints-and-rabbitmq-queues-1" >}} -[Breaking - Upgrade to .NET 8]: {{< ref "#upgrade-to-net-8-1" >}} -[Breaking - Server-side validation added to {{% ctx %}} Gateway API]: {{< ref "#server-side-validation-added-to-cortex-gateway-api-1" >}} +[Breaking - Added support for multiple Cortex Interaction Portal running on the same machine]: {{< ref "#added-support-for-multiple-cortex-interaction-portal-running-on-the-same-machine-1" >}} [{{% ctx %}} Studio]: {{< url path="Cortex.Guides.Studio.MainDoc" version="2024.11" >}} @@ -499,7 +497,7 @@ Releases are currently forecast to be made available on: [Grafana 8.5.4]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaWebApp.Windows" >}} [Grafana 10.4.1]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaWebApp.10.4.1.Windows" >}} -[Loki 3.0.0]: {{< url path="GitHub.Cortex.Observability.2.2.0.Grafana.SelfManaged.Downloads.GrafanaLoki.3.0.0.GrafanaLokiInstallZip" >}} +[Loki 3.0.0]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaLoki.3.0.0.GrafanaLokiInstallZip" >}} [Loki 2.5.0]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaLoki.GrafanaLokiInstallZip" >}} [Observability 3.0.0]: {{< url path="GitHub.Cortex.Observability.3.0.0.MainDoc" >}} [Observability 2.2.0]: {{< url path="GitHub.Cortex.Observability.2.2.0.MainDoc" >}} diff --git a/content/en/blog/releases/2024.X/2024.5.md b/content/en/blog/releases/2024.X/2024.5.md index 5b8bb7911..d6f2dd8c4 100644 --- a/content/en/blog/releases/2024.X/2024.5.md +++ b/content/en/blog/releases/2024.X/2024.5.md @@ -84,7 +84,7 @@ Finally, this [Product Portal][] includes updates related to: | {{% ctx %}} Encryption Key Generator | 1.2.0.23470 | No | N/A | N/A | | | {{% ctx %}} Encryptor | 3.0.0.23460 | No | N/A | N/A | | | {{% ctx %}} Flows Upgrader | 1.1.0.24210 | No | N/A | N/A | | -| {{% ctx %}} Observability | 3.0.0 | Yes | Major | N/A | | +| {{% ctx %}} Observability | 3.0.0 | Yes | Major | Yes | Major changes occurred between releases, these changes are related to Grafana's Promtail and Loki components updating, requiring a new configuration file format. | ### Features @@ -476,7 +476,7 @@ Releases are currently forecast to be made available on: [Grafana 8.5.4]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaWebApp.Windows" >}} [Grafana 10.4.1]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaWebApp.10.4.1.Windows" >}} -[Loki 3.0.0]: {{< url path="GitHub.Cortex.Observability.2.2.0.Grafana.SelfManaged.Downloads.GrafanaLoki.3.0.0.GrafanaLokiInstallZip" >}} +[Loki 3.0.0]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaLoki.3.0.0.GrafanaLokiInstallZip" >}} [Loki 2.5.0]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaLoki.GrafanaLokiInstallZip" >}} [Observability 3.0.0]: {{< url path="GitHub.Cortex.Observability.3.0.0.MainDoc" >}} [Observability 2.2.0]: {{< url path="GitHub.Cortex.Observability.2.2.0.MainDoc" >}} diff --git a/content/en/blog/releases/2024.X/2024.7.md b/content/en/blog/releases/2024.X/2024.7.md index 4ef0955b0..14017d48e 100644 --- a/content/en/blog/releases/2024.X/2024.7.md +++ b/content/en/blog/releases/2024.X/2024.7.md @@ -483,7 +483,7 @@ Releases are currently forecast to be made available on: [Grafana 8.5.4]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaWebApp.Windows" >}} [Grafana 10.4.1]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaWebApp.10.4.1.Windows" >}} -[Loki 3.0.0]: {{< url path="GitHub.Cortex.Observability.2.2.0.Grafana.SelfManaged.Downloads.GrafanaLoki.3.0.0.GrafanaLokiInstallZip" >}} +[Loki 3.0.0]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaLoki.3.0.0.GrafanaLokiInstallZip" >}} [Loki 2.5.0]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaLoki.GrafanaLokiInstallZip" >}} [Observability 3.0.0]: {{< url path="GitHub.Cortex.Observability.3.0.0.MainDoc" >}} [Observability 2.2.0]: {{< url path="GitHub.Cortex.Observability.2.2.0.MainDoc" >}} diff --git a/content/en/blog/releases/2024.X/2024.9.md b/content/en/blog/releases/2024.X/2024.9.md index 96e7e4673..b98fb352b 100644 --- a/content/en/blog/releases/2024.X/2024.9.md +++ b/content/en/blog/releases/2024.X/2024.9.md @@ -645,7 +645,7 @@ Releases are currently forecast to be made available on: [Grafana 8.5.4]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaWebApp.Windows" >}} [Grafana 10.4.1]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaWebApp.10.4.1.Windows" >}} -[Loki 3.0.0]: {{< url path="GitHub.Cortex.Observability.2.2.0.Grafana.SelfManaged.Downloads.GrafanaLoki.3.0.0.GrafanaLokiInstallZip" >}} +[Loki 3.0.0]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaLoki.3.0.0.GrafanaLokiInstallZip" >}} [Loki 2.5.0]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaLoki.GrafanaLokiInstallZip" >}} [Observability 3.0.0]: {{< url path="GitHub.Cortex.Observability.3.0.0.MainDoc" >}} [Observability 2.2.0]: {{< url path="GitHub.Cortex.Observability.2.2.0.MainDoc" >}} From ca87a35275fd8d49f1fd8b2d3be53e2e64186fc4 Mon Sep 17 00:00:00 2001 From: cortex-lp Date: Mon, 2 Dec 2024 17:13:09 +0000 Subject: [PATCH 06/14] Added Affected Components and Summaries --- content/en/blog/releases/2024.X/2024.11.md | 303 ++++++++++++++++++++- 1 file changed, 288 insertions(+), 15 deletions(-) diff --git a/content/en/blog/releases/2024.X/2024.11.md b/content/en/blog/releases/2024.X/2024.11.md index 2d98c5159..8b154097f 100644 --- a/content/en/blog/releases/2024.X/2024.11.md +++ b/content/en/blog/releases/2024.X/2024.11.md @@ -21,6 +21,7 @@ Installation artefacts can be requested by raising a case in the [{{% ctx %}} Se * Capability * Observability +* Performance * Scalability * Security * Usability @@ -29,11 +30,63 @@ Installation artefacts can be requested by raising a case in the [{{% ctx %}} Se * Upgrade * Documentation - +This release introduces multiple new features to the {{% ctx %}} platform: -### Components +* The [Monitoring Service has been introduced][] to provide a high-level view of the system's operations. +* The API Gateway Service now includes the [Operations Overview API][]. +* The [Operations Overview page][] has been added to provide a high-level view of the system's operations, which includes: + * [Current Status tiles][] + * [Filters][] + * [Graphs][] +* The [configuration for query parameter length][] has been added to the {{% ctx %}} Gateway `web.config`. +* The [Cortex Interaction Portal can now be installed multiple times on the same machine][]. +* The Cortex Interaction Portal now handles [session updates more reliably on slower systems][]. + +[Observability][] has been improved by [reducing the maximum size of Service Fabric Trace Logs][]. + +The [Performance][] of the {{% ctx %}} has been improved by optimising [handling high volumes of executions more efficiently][]. + +[Scalability][] has been enhance by [increasing the header size limit for Service Fabric API Gateway][]. + +[Security][] has been tighten by: + +* updating the [Content-security-policy directives][] +* introducing the [Permissions-Policy header][] +* removing the [X-XSS-PROTECTION header][] +* [deleting the guest user from RabbitMQ on installation and upgrade][] + +[Third-party Support][] has been improved by: + +* adding a [Health Check API to Service Fabric API Gateway][] +* updating the following 3rd party libraries on {{% ctx %}} Gateway: + * Fuse + * jQuery + * jQuery UI + * Moment.js + * Stacktrace.js - +[Installation][] has been modified to: + +* [check for certificate friendly name][] +* [use PSDrive to improve compatibility][] +* [allow log file rotation for RabbitMQ logs][] +* [open ports for RabbitMQ Stream][] + +[Upgrade][] has been improved by: + +* [restoring files to pre-upgrade if the load balancer upgrade fails][] +* [streamlining the timeout of the Register-ServiceFabricApplicationType command with other commands][] +* [changing the extension of the studio package created by the upgrade script][] +* [allow log file rotation for RabbitMQ logs][Upgrade - allow log file rotation for RabbitMQ logs] +* [opening ports for RabbitMQ Stream][Upgrade - opening ports for RabbitMQ Stream] + +Finally, the [Documentation][] includes updates related to: + +* [adding the encryption key to the Load Balancer server][] +* [adding the Grafana Components Compatibility table to release notes][] +* [updating the ports used by the platform][] + +### Components | Release Component | Version | Updated | Update Type | Breaking Change | Notes | |--------------------------------------------------------------------------------|---------------|---------|---------------|-----------------|--------| @@ -78,6 +131,15 @@ The Monitoring Service is provisioned by default and is available on the Operati +Affected Components: + +* [{{% ctx %}} Innovation Core Application][] + * [{{% ctx %}} API Gateway Service][] + * [{{% ctx %}} Execution Management Service][] + * [{{% ctx %}} Monitoring Service][] +* [{{% ctx %}} Innovation Execution Application][] + * [{{% ctx %}} Execution Service][] + ##### Added Operations Overview API to API Gateway The API Gateway Service now includes the following APIs: @@ -110,12 +172,21 @@ The API Gateway Service now includes the following APIs: +Affected Components: + +* [{{% ctx %}} Innovation Core Application][] + * [{{% ctx %}} API Gateway Service][] + ##### Introduced the Operations Overview page {{% ctx %}} Gateway now includes an Operations Overview page that provides a high-level view of the system's operations. +Affected Components: + +* [{{% ctx %}} Gateway][Gateway] + ##### Added Current Status tiles to the Operations Overview page The Operations Overview page now includes tiles that display the current status of the system, which includes: @@ -126,6 +197,10 @@ The Operations Overview page now includes tiles that display the current status +Affected Components: + +* [{{% ctx %}} Gateway][Gateway] + ##### Added Filters to the Operations Overview page The Operations Overview page now includes filters that allow users to filter data based on the selected timespan, packages, package versions and flows. @@ -133,6 +208,10 @@ The Operations Overview page now includes filters that allow users to filter dat +Affected Components: + +* [{{% ctx %}} Gateway][Gateway] + ##### Added Graphs to the Operations Overview page The Operations Overview page now includes graphs that display the following data: @@ -146,6 +225,10 @@ The Operations Overview page now includes graphs that display the following data +Affected Components: + +* [{{% ctx %}} Gateway][Gateway] + ##### Added configuration for query parameter length {{% ctx %}} Gateway `web.config` now includes configuration settings allowing to configure the maximum query parameter length. @@ -153,6 +236,10 @@ Currently, there is no documentation available on how to do this. For further as +Affected Components: + +* [{{% ctx %}} Gateway][Gateway] + ##### Added support for multiple Cortex Interaction Portal running on the same machine The Cortex Interaction Portal can now be installed multiple times on the same machine. @@ -160,12 +247,20 @@ This allows for multiple instances of the Interaction Portal to be run on the sa +Affected Components: + +* {{% ctx %}} Interaction Portal + ##### Improved session update reliability on slow systems The Cortex Interaction Portal now handles session updates more reliably on slower systems. +Affected Components: + +* {{% ctx %}} Interaction Portal + #### Observability ##### Reduced the maximum size of Service Fabric Trace Logs @@ -174,7 +269,11 @@ The maximum size of Service Fabric Trace Logs has been reduced to reduce the amo -#### Scalability +Affected Components: + +* {{% ctx %}} App Server Install Scripts + +#### Performance ##### Improved the performance of the Execution Management Service @@ -182,12 +281,24 @@ The performance of the Execution Management Service has been improved to handle +Affected Components: + +* [{{% ctx %}} Innovation Core Application][] + * [{{% ctx %}} Execution Management Service][] + +#### Scalability + ##### Increased the header size limit for Service Fabric API Gateway The header size limit for the Service Fabric API Gateway has been increased to allow for larger headers to be processed. +Affected Components: + +* [{{% ctx %}} Innovation Core Application][] + * [{{% ctx %}} API Gateway Service][] + #### Security ##### Reviewed the Content-security-policy directives @@ -196,12 +307,30 @@ The Content-security-policy directives have been reviewed and updated to ensure +Affected Components: + +* [{{% ctx %}} Gateway][Gateway] + ##### Introduced the Permissions-Policy header The Permissions-Policy header has been introduced to improve security. +Affected Components: + +* [{{% ctx %}} Gateway][Gateway] + +##### Removed the X-XSS-PROTECTION header + +The X-XSS-PROTECTION header has been removed as it is deprecated. + + + +Affected Components: + +* [{{% ctx %}} Gateway][Gateway] + ##### Deleted the guest user from RabbitMQ on installation and upgrade The guest user is now deleted from RabbitMQ on installation and upgrade to improve security. @@ -209,11 +338,10 @@ The guest user is now deleted from RabbitMQ on installation and upgrade to impro -##### Removed the X-XSS-PROTECTION header - -The X-XSS-PROTECTION header has been removed as it is deprecated. +Affected Components: - +* {{% ctx %}} App Server Install Scripts +* {{% ctx %}} Upgrade Scripts #### Third-party Support @@ -223,6 +351,13 @@ A Health Check API has been added to the Service Fabric API Gateway to allow thi +Affected Components: + +* [{{% ctx %}} Innovation Core Application][] + * [{{% ctx %}} API Gateway Service][] +* {{% ctx %}} App Server Install Scripts +* {{% ctx %}} Upgrade scripts + ##### Updated 3rd Party Libraries The following 3rd party libraries have been updated on {{% ctx %}} Gateway: @@ -239,6 +374,10 @@ The following 3rd party libraries have been updated on {{% ctx %}} Gateway: +Affected Components: + +* [{{% ctx %}} Gateway][Gateway] + #### Installation ##### Added check for certificate friendly name @@ -247,25 +386,44 @@ The installation script now checks for the presence of a certificate friendly na +Affected Components: + +* {{% ctx %}} Web App Server Install Scripts + ##### Changed the installation script to use PSDrive to improve compatibility The installation script now uses PSDrive to improve compatibility with different environments. +Affected Components: + +* {{% ctx %}} App Server Install Scripts +* {{% ctx %}} Upgrade Scripts + ##### Added support for RabbitMQ log file rotation The installation script now sets up log file rotation RabbitMQ. -#### Upgrade +Affected Components: -##### Added support for RabbitMQ log file rotation +* {{% ctx %}} App Server Install Scripts +* {{% ctx %}} Upgrade Scripts -The installation script now sets up log file rotation RabbitMQ. +##### Opened ports for RabbitMQ Stream - +A bug has been fixed logs were being generated due to RabbitMQ Stream ports not being open. + + + +Affected Components: + +* {{% ctx %}} App Server Install Scripts +* {{% ctx %}} Upgrade Scripts + +#### Upgrade ##### Improved of the load balancer upgrade process @@ -273,18 +431,52 @@ The upgrade process now restores the files to pre-upgrade if the load balancer u +Affected Components: + +* {{% ctx %}} Upgrade Scripts + ##### Streamlined the timeout of the Register-ServiceFabricApplicationType command with other commands The timeout of the Register-ServiceFabricApplicationType command has been set to 1800s, like other commands. +Affected Components: + +* {{% ctx %}} Upgrade Scripts + ##### Changed the extension of the studio package created by the upgrade script The studio package created by the upgrade script now has the file extension `.studiopkg` to be consistent with the documentation. +Affected Components: + +* {{% ctx %}} Flows Upgrader + +##### Added support for RabbitMQ log file rotation + +The installation script now sets up log file rotation RabbitMQ. + + + +Affected Components: + +* {{% ctx %}} App Server Install Scripts +* {{% ctx %}} Upgrade Scripts + +##### Opened ports for RabbitMQ Stream + +A bug has been fixed logs were being generated due to RabbitMQ Stream ports not being open. + + + +Affected Components: + +* {{% ctx %}} App Server Install Scripts +* {{% ctx %}} Upgrade Scripts + #### Documentation ##### Added how to add the encryption key to the Load Balancer server @@ -293,12 +485,15 @@ The documentation now includes instructions on how to add the encryption key to +##### Added Grafana Components Compatibility table to release notes + +The [Grafana Components Compatibility][] table has been added to the release notes. - + -##### Updated ports used by {{% ctx %}} +##### Updated ports used by the platform -The documentation has been updated to include the new ports used by {{% ctx %}}. +The documentation has been updated to include the new ports used by the {{% ctx %}} platform. @@ -312,30 +507,56 @@ A bug has been fixed where the Send Email Using Microsoft365 block would crash t +Affected Components: + +* [{{% ctx %}} Innovation Execution Application][] + * [{{% ctx %}} Execution Service][] +* [{{% ctx %}} Block Packages][Blocks] + ##### Published packages with nested flows fail to execute A bug has been fixed where published flows containing nested flows up to three layers deep would throw a KeyNotFoundException when attempting to execute the third layer. +Affected Components: + +* [{{% ctx %}} Innovation Execution Application][] + * [{{% ctx %}} Execution Service][] + ##### LINQ expression does not work A bug has been fixed where LINQ expressions would not work at all. +Affected Components: + +* [{{% ctx %}} Innovation Execution Application][] + * [{{% ctx %}} Execution Service][] + ##### Expression containing a string.Split() causes an exception A bug has been fixed where an expression containing a string.Split() would sometimes throw a runtime exception. +Affected Components: + +* [{{% ctx %}} Innovation Execution Application][] + * [{{% ctx %}} Execution Service][] + ##### Opened ports for RabbitMQ Stream A bug has been fixed logs were being generated due to RabbitMQ Stream ports not being open. +Affected Components: + +* {{% ctx %}} App Server Install Scripts +* {{% ctx %}} Upgrade Scripts + #### Usability ##### LiveView datetime picker styling issues @@ -344,6 +565,10 @@ A bug has been fixed where the LiveView datetime picker would not display correc +Affected Components: + +* [{{% ctx %}} Gateway][Gateway] + #### Installation ##### Fixed error the installation what-if command @@ -352,6 +577,10 @@ The installation script no longer import the ServiceFabric PowerShell module whe +Affected Components: + +* {{% ctx %}} App Server Install Scripts + ##### Update certificate doesn't update load balancer health check subject name A bug has been fixed where updating the certificate would not update the load balancer health check subject name. @@ -359,6 +588,10 @@ A bug has been fixed where updating the certificate would not update the load ba + + + + @@ -472,7 +705,47 @@ Releases are currently forecast to be made available on: [{{% ctx %}} Execution Service]: {{< url path="Cortex.Guides.CortexInnovation.ExecutionApplication.Services.ExecutionService.MainDoc" version="2024.11" >}} [Interaction Portal]: {{< url path="Cortex.Guides.CortexInteractionPortal.MainDoc" version="2024.11" >}} +[Monitoring Service has been introduced]: {{< ref "#introduced-the-monitoring-service" >}} +[Operations Overview API]: {{< ref "#added-operations-overview-api-to-api-gateway" >}} +[Operations Overview page]: {{< ref "#introduced-the-operations-overview-page" >}} +[Current Status tiles]: {{< ref "#added-current-status-tiles-to-the-operations-overview-page" >}} +[Filters]: {{< ref "#added-filters-to-the-operations-overview-page" >}} +[Graphs]: {{< ref "#added-graphs-to-the-operations-overview-page" >}} +[configuration for query parameter length]: {{< ref "#added-configuration-for-query-parameter-length" >}} +[Cortex Interaction Portal can now be installed multiple times on the same machine]: {{< ref "#added-support-for-multiple-cortex-interaction-portal-running-on-the-same-machine" >}} +[session updates more reliably on slower systems]: {{< ref "#improved-session-update-reliability-on-slow-systems" >}} +[Observability]: {{< ref "#observability" >}} +[reducing the maximum size of Service Fabric Trace Logs]: {{< ref "#reduced-the-maximum-size-of-service-fabric-trace-logs" >}} +[Performance]: {{< ref "#performance" >}} +[handling high volumes of executions more efficiently]: {{< ref "#improved-the-performance-of-the-execution-management-service" >}} +[Scalability]: {{< ref "#scalability" >}} +[increasing the header size limit for Service Fabric API Gateway]: {{< ref "#increased-the-header-size-limit-for-service-fabric-api-gateway" >}} +[Security]: {{< ref "#security" >}} +[Content-security-policy directives]: {{< ref "#reviewed-the-content-security-policy-directives" >}} +[Permissions-Policy header]: {{< ref "#introduced-the-permissions-policy-header" >}} +[X-XSS-PROTECTION header]: {{< ref "#removed-the-x-xss-protection-header" >}} +[deleting the guest user from RabbitMQ on installation and upgrade]: {{< ref "#deleted-the-guest-user-from-rabbitmq-on-installation-and-upgrade" >}} +[Third-party Support]: {{< ref "#third-party-support" >}} +[Health Check API to Service Fabric API Gateway]: {{< ref "#added-health-check-api-to-service-fabric-api-gateway" >}} +[Installation]: {{< ref "#installation" >}} +[check for certificate friendly name]: {{< ref "#added-check-for-certificate-friendly-name" >}} +[use PSDrive to improve compatibility]: {{< ref "#changed-the-installation-script-to-use-psdrive-to-improve-compatibility" >}} +[allow log file rotation for RabbitMQ logs]: {{< ref "#added-support-for-rabbitmq-log-file-rotation" >}} +[open ports for RabbitMQ Stream]: {{< ref "#opened-ports-for-rabbitmq-stream" >}} +[Upgrade]: {{< ref "#upgrade" >}} +[restoring files to pre-upgrade if the load balancer upgrade fails]: {{< ref "#improved-of-the-load-balancer-upgrade-process" >}} +[streamlining the timeout of the Register-ServiceFabricApplicationType command with other commands]: {{< ref "#streamlined-the-timeout-of-the-register-servicefabricapplicationtype-command-with-other-commands" >}} +[changing the extension of the studio package created by the upgrade script]: {{< ref "#changed-the-extension-of-the-studio-package-created-by-the-upgrade-script" >}} +[Upgrade - allow log file rotation for RabbitMQ logs]: {{< ref "#added-support-for-rabbitmq-log-file-rotation-1" >}} +[Upgrade - opening ports for RabbitMQ Stream]: {{< ref "#opened-ports-for-rabbitmq-stream-1" >}} +[Documentation]: {{< ref "#documentation" >}} +[adding the encryption key to the Load Balancer server]: {{< ref "#added-how-to-add-the-encryption-key-to-the-load-balancer-server" >}} +[adding the Grafana Components Compatibility table to release notes]: {{< ref "#added-grafana-components-compatibility-table-to-release-notes" >}} +[updating the ports used by the platform]: {{< ref "#updated-ports-used-by-the-platform" >}} + [Upgrade Instructions]: {{< ref "#upgrade-instructions" >}} +[Grafana Components Compatibility]: {{< ref "#grafana-components-compatibility" >}} + [Blocks]: {{< url path="Cortex.Reference.Blocks.MainDoc" version="2024.11" >}} [Gateway]: {{< url path="Cortex.Guides.Gateway.MainDoc" version="2024.11" >}} From 040360f007fad5d76f173cd702b640e5cc6408b1 Mon Sep 17 00:00:00 2001 From: cortex-lp Date: Tue, 3 Dec 2024 10:45:25 +0000 Subject: [PATCH 07/14] added fix for last header overlapping text and cannot click link. and improved table --- assets/scss/_content.scss | 1 + assets/scss/main.scss | 1 + content/en/blog/releases/2024.X/2024.11.md | 16 ++++++++-------- 3 files changed, 10 insertions(+), 8 deletions(-) diff --git a/assets/scss/_content.scss b/assets/scss/_content.scss index ae05029a6..189c90f9f 100644 --- a/assets/scss/_content.scss +++ b/assets/scss/_content.scss @@ -26,6 +26,7 @@ } p { + z-index: 10; margin-top: 0px; margin-bottom: 0px; } diff --git a/assets/scss/main.scss b/assets/scss/main.scss index 7103f8837..b467bc5c3 100644 --- a/assets/scss/main.scss +++ b/assets/scss/main.scss @@ -42,6 +42,7 @@ content: " "; margin-top: -90px; padding-top: 90px; + z-index: 5; } } diff --git a/content/en/blog/releases/2024.X/2024.11.md b/content/en/blog/releases/2024.X/2024.11.md index 8b154097f..abb44b79b 100644 --- a/content/en/blog/releases/2024.X/2024.11.md +++ b/content/en/blog/releases/2024.X/2024.11.md @@ -487,7 +487,7 @@ The documentation now includes instructions on how to add the encryption key to ##### Added Grafana Components Compatibility table to release notes -The [Grafana Components Compatibility][] table has been added to the release notes. +The [Grafana Components Compatibility][] table has been added to the release notes. @@ -648,13 +648,13 @@ There are no known limitations added as part of the 2024.11 release of the {{% c ### Grafana Components Compatibility -| Release | Grafana WebApp Version | Grafana Loki Version | Observability Version | -|---------|--------------------------|----------------------|------------------------------| -| 2024.11 | [10.4.1][Grafana 10.4.1] | [3.0.0][Loki 3.0.0] | [3.0.0][Observability 3.0.0] | -| 2024.9 | [10.4.1][Grafana 10.4.1] | [3.0.0][Loki 3.0.0] | [3.0.0][Observability 3.0.0] | -| 2024.7 | [10.4.1][Grafana 10.4.1] | [3.0.0][Loki 3.0.0] | [3.0.0][Observability 3.0.0] | -| 2024.5 | [10.4.1][Grafana 10.4.1] | [3.0.0][Loki 3.0.0] | [3.0.0][Observability 3.0.0] | -| 2024.3 | [8.5.4][Grafana 8.5.4] | [2.5.0][Loki 2.5.0] | [2.2.0][Observability 2.2.0] | +| Release | Grafana WebApp Version | Grafana Loki Version | {{% ctx %}}Observability Version | +|---------|--------------------------|----------------------|----------------------------------| +| 2024.11 | [10.4.1][Grafana 10.4.1] | [3.0.0][Loki 3.0.0] | [3.0.0][Observability 3.0.0] | +| 2024.9 | [10.4.1][Grafana 10.4.1] | [3.0.0][Loki 3.0.0] | [3.0.0][Observability 3.0.0] | +| 2024.7 | [10.4.1][Grafana 10.4.1] | [3.0.0][Loki 3.0.0] | [3.0.0][Observability 3.0.0] | +| 2024.5 | [10.4.1][Grafana 10.4.1] | [3.0.0][Loki 3.0.0] | [3.0.0][Observability 3.0.0] | +| 2024.3 | [8.5.4][Grafana 8.5.4] | [2.5.0][Loki 2.5.0] | [2.2.0][Observability 2.2.0] | ## Install Instructions From b261e9690819e5c4e94ea64787c76fb646158098 Mon Sep 17 00:00:00 2001 From: cortex-lp Date: Tue, 3 Dec 2024 10:59:38 +0000 Subject: [PATCH 08/14] updated links and fix ul before title as well --- assets/scss/_content.scss | 1 + content/en/blog/releases/2024.X/2024.11.md | 4 ++-- data/urls.toml | 2 ++ 3 files changed, 5 insertions(+), 2 deletions(-) diff --git a/assets/scss/_content.scss b/assets/scss/_content.scss index 189c90f9f..0c79537ea 100644 --- a/assets/scss/_content.scss +++ b/assets/scss/_content.scss @@ -101,6 +101,7 @@ } >ul { + z-index: 10; margin-bottom: 0px; } diff --git a/content/en/blog/releases/2024.X/2024.11.md b/content/en/blog/releases/2024.X/2024.11.md index abb44b79b..77c22fbab 100644 --- a/content/en/blog/releases/2024.X/2024.11.md +++ b/content/en/blog/releases/2024.X/2024.11.md @@ -770,7 +770,7 @@ Releases are currently forecast to be made available on: [Grafana 8.5.4]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaWebApp.Windows" >}} [Grafana 10.4.1]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaWebApp.10.4.1.Windows" >}} -[Loki 3.0.0]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaLoki.3.0.0.GrafanaLokiInstallZip" >}} -[Loki 2.5.0]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaLoki.GrafanaLokiInstallZip" >}} +[Loki 3.0.0]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaLoki.3.0.0.MainDoc" >}} +[Loki 2.5.0]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaLoki.MainDoc" >}} [Observability 3.0.0]: {{< url path="GitHub.Cortex.Observability.3.0.0.MainDoc" >}} [Observability 2.2.0]: {{< url path="GitHub.Cortex.Observability.2.2.0.MainDoc" >}} diff --git a/data/urls.toml b/data/urls.toml index 3844c94e6..062cf5dca 100644 --- a/data/urls.toml +++ b/data/urls.toml @@ -2507,8 +2507,10 @@ [Grafana.SelfManaged.Downloads.GrafanaWebApp.10.4.1] Windows = "https://grafana.com/grafana/download/10.4.1?pg=get&plcmt=selfmanaged-box1-cta1&platform=windows" [Grafana.SelfManaged.Downloads.GrafanaLoki] + MainDoc = "https://github.com/grafana/loki/releases/tag/v2.5.0" GrafanaLokiInstallZip = "https://github.com/grafana/loki/releases/download/v2.5.0/loki-windows-amd64.exe.zip" [Grafana.SelfManaged.Downloads.GrafanaLoki.3.0.0] + MainDoc = "https://github.com/grafana/loki/releases/tag/v3.0.0" GrafanaLokiInstallZip = "https://github.com/grafana/loki/releases/download/v3.0.0/loki-windows-amd64.exe.zip" [Grafana.SelfManaged.Downloads.Promtail] PromtailInstallZip = "https://github.com/grafana/loki/releases/download/v2.5.0/promtail-windows-amd64.exe.zip" From 34035e195d91032fe92e663356b4500ec93b748c Mon Sep 17 00:00:00 2001 From: cortex-lp Date: Tue, 3 Dec 2024 11:42:40 +0000 Subject: [PATCH 09/14] modify link --- content/en/blog/releases/2024.X/2024.11.md | 5 ----- content/en/blog/releases/2024.X/2024.3.md | 2 +- content/en/blog/releases/2024.X/2024.5.md | 4 ++-- content/en/blog/releases/2024.X/2024.7.md | 4 ++-- content/en/blog/releases/2024.X/2024.9.md | 4 ++-- 5 files changed, 7 insertions(+), 12 deletions(-) diff --git a/content/en/blog/releases/2024.X/2024.11.md b/content/en/blog/releases/2024.X/2024.11.md index 77c22fbab..e712d2d51 100644 --- a/content/en/blog/releases/2024.X/2024.11.md +++ b/content/en/blog/releases/2024.X/2024.11.md @@ -587,11 +587,6 @@ A bug has been fixed where updating the certificate would not update the load ba - - - - - diff --git a/content/en/blog/releases/2024.X/2024.3.md b/content/en/blog/releases/2024.X/2024.3.md index e638e069d..ef083594b 100644 --- a/content/en/blog/releases/2024.X/2024.3.md +++ b/content/en/blog/releases/2024.X/2024.3.md @@ -743,5 +743,5 @@ Releases are currently forecast to be made available on: [OracleParameter]: {{< url path="Cortex.Reference.DataTypes.Data.OracleParameter.MainDoc" >}} [Grafana 8.5.4]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaWebApp.Windows" >}} -[Loki 2.5.0]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaLoki.GrafanaLokiInstallZip" >}} +[Loki 2.5.0]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaLoki.MainDoc" >}} [Observability 2.2.0]: {{< url path="GitHub.Cortex.Observability.2.2.0.MainDoc" >}} diff --git a/content/en/blog/releases/2024.X/2024.5.md b/content/en/blog/releases/2024.X/2024.5.md index d6f2dd8c4..d9f854785 100644 --- a/content/en/blog/releases/2024.X/2024.5.md +++ b/content/en/blog/releases/2024.X/2024.5.md @@ -476,7 +476,7 @@ Releases are currently forecast to be made available on: [Grafana 8.5.4]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaWebApp.Windows" >}} [Grafana 10.4.1]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaWebApp.10.4.1.Windows" >}} -[Loki 3.0.0]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaLoki.3.0.0.GrafanaLokiInstallZip" >}} -[Loki 2.5.0]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaLoki.GrafanaLokiInstallZip" >}} +[Loki 3.0.0]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaLoki.3.0.0.MainDoc" >}} +[Loki 2.5.0]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaLoki.MainDoc" >}} [Observability 3.0.0]: {{< url path="GitHub.Cortex.Observability.3.0.0.MainDoc" >}} [Observability 2.2.0]: {{< url path="GitHub.Cortex.Observability.2.2.0.MainDoc" >}} diff --git a/content/en/blog/releases/2024.X/2024.7.md b/content/en/blog/releases/2024.X/2024.7.md index 14017d48e..274379efa 100644 --- a/content/en/blog/releases/2024.X/2024.7.md +++ b/content/en/blog/releases/2024.X/2024.7.md @@ -483,7 +483,7 @@ Releases are currently forecast to be made available on: [Grafana 8.5.4]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaWebApp.Windows" >}} [Grafana 10.4.1]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaWebApp.10.4.1.Windows" >}} -[Loki 3.0.0]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaLoki.3.0.0.GrafanaLokiInstallZip" >}} -[Loki 2.5.0]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaLoki.GrafanaLokiInstallZip" >}} +[Loki 3.0.0]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaLoki.3.0.0.MainDoc" >}} +[Loki 2.5.0]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaLoki.MainDoc" >}} [Observability 3.0.0]: {{< url path="GitHub.Cortex.Observability.3.0.0.MainDoc" >}} [Observability 2.2.0]: {{< url path="GitHub.Cortex.Observability.2.2.0.MainDoc" >}} diff --git a/content/en/blog/releases/2024.X/2024.9.md b/content/en/blog/releases/2024.X/2024.9.md index b98fb352b..0d0bc8c13 100644 --- a/content/en/blog/releases/2024.X/2024.9.md +++ b/content/en/blog/releases/2024.X/2024.9.md @@ -645,7 +645,7 @@ Releases are currently forecast to be made available on: [Grafana 8.5.4]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaWebApp.Windows" >}} [Grafana 10.4.1]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaWebApp.10.4.1.Windows" >}} -[Loki 3.0.0]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaLoki.3.0.0.GrafanaLokiInstallZip" >}} -[Loki 2.5.0]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaLoki.GrafanaLokiInstallZip" >}} +[Loki 3.0.0]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaLoki.3.0.0.MainDoc" >}} +[Loki 2.5.0]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaLoki.MainDoc" >}} [Observability 3.0.0]: {{< url path="GitHub.Cortex.Observability.3.0.0.MainDoc" >}} [Observability 2.2.0]: {{< url path="GitHub.Cortex.Observability.2.2.0.MainDoc" >}} From 5d19ac86d27988d92325f6e517d331a9e0d042ed Mon Sep 17 00:00:00 2001 From: cortex-lp Date: Tue, 3 Dec 2024 11:48:02 +0000 Subject: [PATCH 10/14] fix headers --- content/en/blog/releases/2024.X/2024.11.md | 14 +++++++------- content/en/blog/releases/2024.X/2024.3.md | 8 ++++---- content/en/blog/releases/2024.X/2024.5.md | 8 ++++---- content/en/blog/releases/2024.X/2024.7.md | 10 +++++----- content/en/blog/releases/2024.X/2024.9.md | 12 ++++++------ 5 files changed, 26 insertions(+), 26 deletions(-) diff --git a/content/en/blog/releases/2024.X/2024.11.md b/content/en/blog/releases/2024.X/2024.11.md index e712d2d51..77c39b77b 100644 --- a/content/en/blog/releases/2024.X/2024.11.md +++ b/content/en/blog/releases/2024.X/2024.11.md @@ -643,13 +643,13 @@ There are no known limitations added as part of the 2024.11 release of the {{% c ### Grafana Components Compatibility -| Release | Grafana WebApp Version | Grafana Loki Version | {{% ctx %}}Observability Version | -|---------|--------------------------|----------------------|----------------------------------| -| 2024.11 | [10.4.1][Grafana 10.4.1] | [3.0.0][Loki 3.0.0] | [3.0.0][Observability 3.0.0] | -| 2024.9 | [10.4.1][Grafana 10.4.1] | [3.0.0][Loki 3.0.0] | [3.0.0][Observability 3.0.0] | -| 2024.7 | [10.4.1][Grafana 10.4.1] | [3.0.0][Loki 3.0.0] | [3.0.0][Observability 3.0.0] | -| 2024.5 | [10.4.1][Grafana 10.4.1] | [3.0.0][Loki 3.0.0] | [3.0.0][Observability 3.0.0] | -| 2024.3 | [8.5.4][Grafana 8.5.4] | [2.5.0][Loki 2.5.0] | [2.2.0][Observability 2.2.0] | +| Release | Grafana WebApp Version | Grafana Loki Version | {{% ctx %}} Observability Version | +|---------|--------------------------|----------------------|-----------------------------------| +| 2024.11 | [10.4.1][Grafana 10.4.1] | [3.0.0][Loki 3.0.0] | [3.0.0][Observability 3.0.0] | +| 2024.9 | [10.4.1][Grafana 10.4.1] | [3.0.0][Loki 3.0.0] | [3.0.0][Observability 3.0.0] | +| 2024.7 | [10.4.1][Grafana 10.4.1] | [3.0.0][Loki 3.0.0] | [3.0.0][Observability 3.0.0] | +| 2024.5 | [10.4.1][Grafana 10.4.1] | [3.0.0][Loki 3.0.0] | [3.0.0][Observability 3.0.0] | +| 2024.3 | [8.5.4][Grafana 8.5.4] | [2.5.0][Loki 2.5.0] | [2.2.0][Observability 2.2.0] | ## Install Instructions diff --git a/content/en/blog/releases/2024.X/2024.3.md b/content/en/blog/releases/2024.X/2024.3.md index ef083594b..3d420aa31 100644 --- a/content/en/blog/releases/2024.X/2024.3.md +++ b/content/en/blog/releases/2024.X/2024.3.md @@ -86,7 +86,7 @@ Also, new documentation has been added to reflect the new [platform upgrade proc | {{% ctx %}} Encryption Key Generator | 1.2.0.23470 | No | N/A | N/A | | | {{% ctx %}} Encryptor | 3.0.0.23460 | Yes | Major | No | Major changes occurred between internal development releases, however, these changes are not breaking between 2024.1 and 2024.3 | | {{% ctx %}} Flows Upgrader | 1.1.0.24210 | First Release | First Release | N/A | | -| {{% ctx %}} Observability | 2.5.0 | No | N/A | N/A | | +| {{% ctx %}} Observability | 2.2.0 | No | N/A | N/A | | ### Features @@ -628,9 +628,9 @@ There are no known limitations added as part of the 2024.3 release of the {{% ct ### Grafana Components Compatibility -| Release | Grafana WebApp Version | Grafana Loki Version | Observability Version | -|---------|--------------------------|----------------------|------------------------------| -| 2024.3 | [8.5.4][Grafana 8.5.4] | [2.5.0][Loki 2.5.0] | [2.2.0][Observability 2.2.0] | +| Release | Grafana WebApp Version | Grafana Loki Version | {{% ctx %}} Observability Version | +|---------|--------------------------|----------------------|-----------------------------------| +| 2024.3 | [8.5.4][Grafana 8.5.4] | [2.5.0][Loki 2.5.0] | [2.2.0][Observability 2.2.0] | ## Install Instructions diff --git a/content/en/blog/releases/2024.X/2024.5.md b/content/en/blog/releases/2024.X/2024.5.md index d9f854785..55eab627c 100644 --- a/content/en/blog/releases/2024.X/2024.5.md +++ b/content/en/blog/releases/2024.X/2024.5.md @@ -351,10 +351,10 @@ There are no known limitations added as part of the 2024.5 release of the {{% ct ### Grafana Components Compatibility -| Release | Grafana WebApp Version | Grafana Loki Version | Observability Version | -|---------|--------------------------|----------------------|------------------------------| -| 2024.5 | [10.4.1][Grafana 10.4.1] | [3.0.0][Loki 3.0.0] | [3.0.0][Observability 3.0.0] | -| 2024.3 | [8.5.4][Grafana 8.5.4] | [2.5.0][Loki 2.5.0] | [2.2.0][Observability 2.2.0] | +| Release | Grafana WebApp Version | Grafana Loki Version | {{% ctx %}} Observability Version | +|---------|--------------------------|----------------------|-----------------------------------| +| 2024.5 | [10.4.1][Grafana 10.4.1] | [3.0.0][Loki 3.0.0] | [3.0.0][Observability 3.0.0] | +| 2024.3 | [8.5.4][Grafana 8.5.4] | [2.5.0][Loki 2.5.0] | [2.2.0][Observability 2.2.0] | ## Install Instructions diff --git a/content/en/blog/releases/2024.X/2024.7.md b/content/en/blog/releases/2024.X/2024.7.md index 274379efa..18321d8fa 100644 --- a/content/en/blog/releases/2024.X/2024.7.md +++ b/content/en/blog/releases/2024.X/2024.7.md @@ -357,11 +357,11 @@ There are no known limitations added as part of the 2024.7 release of the {{% ct ### Grafana Components Compatibility -| Release | Grafana WebApp Version | Grafana Loki Version | Observability Version | -|---------|--------------------------|----------------------|------------------------------| -| 2024.7 | [10.4.1][Grafana 10.4.1] | [3.0.0][Loki 3.0.0] | [3.0.0][Observability 3.0.0] | -| 2024.5 | [10.4.1][Grafana 10.4.1] | [3.0.0][Loki 3.0.0] | [3.0.0][Observability 3.0.0] | -| 2024.3 | [8.5.4][Grafana 8.5.4] | [2.5.0][Loki 2.5.0] | [2.2.0][Observability 2.2.0] | +| Release | Grafana WebApp Version | Grafana Loki Version | {{% ctx %}} Observability Version | +|---------|--------------------------|----------------------|-----------------------------------| +| 2024.7 | [10.4.1][Grafana 10.4.1] | [3.0.0][Loki 3.0.0] | [3.0.0][Observability 3.0.0] | +| 2024.5 | [10.4.1][Grafana 10.4.1] | [3.0.0][Loki 3.0.0] | [3.0.0][Observability 3.0.0] | +| 2024.3 | [8.5.4][Grafana 8.5.4] | [2.5.0][Loki 2.5.0] | [2.2.0][Observability 2.2.0] | ## Install Instructions diff --git a/content/en/blog/releases/2024.X/2024.9.md b/content/en/blog/releases/2024.X/2024.9.md index 0d0bc8c13..451631bd1 100644 --- a/content/en/blog/releases/2024.X/2024.9.md +++ b/content/en/blog/releases/2024.X/2024.9.md @@ -484,12 +484,12 @@ There are no known limitations added as part of the 2024.9 release of the {{% ct ### Grafana Components Compatibility -| Release | Grafana WebApp Version | Grafana Loki Version | Observability Version | -|---------|--------------------------|----------------------|------------------------------| -| 2024.9 | [10.4.1][Grafana 10.4.1] | [3.0.0][Loki 3.0.0] | [3.0.0][Observability 3.0.0] | -| 2024.7 | [10.4.1][Grafana 10.4.1] | [3.0.0][Loki 3.0.0] | [3.0.0][Observability 3.0.0] | -| 2024.5 | [10.4.1][Grafana 10.4.1] | [3.0.0][Loki 3.0.0] | [3.0.0][Observability 3.0.0] | -| 2024.3 | [8.5.4][Grafana 8.5.4] | [2.5.0][Loki 2.5.0] | [2.2.0][Observability 2.2.0] | +| Release | Grafana WebApp Version | Grafana Loki Version | {{% ctx %}} Observability Version | +|---------|--------------------------|----------------------|-----------------------------------| +| 2024.9 | [10.4.1][Grafana 10.4.1] | [3.0.0][Loki 3.0.0] | [3.0.0][Observability 3.0.0] | +| 2024.7 | [10.4.1][Grafana 10.4.1] | [3.0.0][Loki 3.0.0] | [3.0.0][Observability 3.0.0] | +| 2024.5 | [10.4.1][Grafana 10.4.1] | [3.0.0][Loki 3.0.0] | [3.0.0][Observability 3.0.0] | +| 2024.3 | [8.5.4][Grafana 8.5.4] | [2.5.0][Loki 2.5.0] | [2.2.0][Observability 2.2.0] | ## Install Instructions From 25a0a668d7cfe31b31da7dc0a4ad4f7aee8ac4ef Mon Sep 17 00:00:00 2001 From: cortex-lp Date: Tue, 3 Dec 2024 13:29:22 +0000 Subject: [PATCH 11/14] review links and started reviewing 2024.11 --- content/en/blog/releases/2024.X/2024.11.md | 12 ++++++------ content/en/blog/releases/2024.X/2024.3.md | 4 ++-- content/en/blog/releases/2024.X/2024.5.md | 8 ++++---- content/en/blog/releases/2024.X/2024.7.md | 8 ++++---- content/en/blog/releases/2024.X/2024.9.md | 8 ++++---- data/urls.toml | 8 ++++---- 6 files changed, 24 insertions(+), 24 deletions(-) diff --git a/content/en/blog/releases/2024.X/2024.11.md b/content/en/blog/releases/2024.X/2024.11.md index 77c39b77b..375c03bbd 100644 --- a/content/en/blog/releases/2024.X/2024.11.md +++ b/content/en/blog/releases/2024.X/2024.11.md @@ -34,7 +34,7 @@ This release introduces multiple new features to the {{% ctx %}} platform: * The [Monitoring Service has been introduced][] to provide a high-level view of the system's operations. * The API Gateway Service now includes the [Operations Overview API][]. -* The [Operations Overview page][] has been added to provide a high-level view of the system's operations, which includes: +* The [Operations Overview page][] has been added to {{% ctx %}} Gateway to provide a high-level view of the system's operations, which includes: * [Current Status tiles][] * [Filters][] * [Graphs][] @@ -108,7 +108,7 @@ Finally, the [Documentation][] includes updates related to: |     > [{{% ctx %}} Execution Service][] | 25.0.4.24460 | Yes | Major | No | Major changes occurred between internal development releases, however, these changes are not breaking between 2024.9 and 2024.11 | | [{{% ctx %}} Gateway][Gateway], including [{{% ctx %}} Studio][] | 12.11.0.24460 | Yes | Minor | N/A | | | [{{% ctx %}} Blocks Package][Blocks] | 48.2.4.24460 | Yes | Patch | N/A | | -| [{{% ctx %}} Interaction Portal][Interaction Portal] | 3.0.1.24460 | Yes | Major | Yes | Major changes occurred between releases, these changes are related to support of multiple Cortex Interaction Portal running on the same machine are [breaking][Breaking - Added support for multiple Cortex Interaction Portal running on the same machine] | +| [{{% ctx %}} Interaction Portal][Interaction Portal] | 3.0.1.24460 | Yes | Major | Yes | Major changes occurred between releases, these changes are related to support of multiple Cortex Interaction Portal running on the same machine and are [breaking][Breaking - Added support for multiple Cortex Interaction Portal running on the same machine] | | {{% ctx %}} App Server Install Scripts | 5.2.7.24470 | Yes | Patch | N/A | | | {{% ctx %}} Web App Server Install Scripts | 8.1.2.24460 | Yes | Patch | N/A | | | {{% ctx %}} Upgrade Scripts | 1.2.16.24460 | Yes | Patch | N/A | | @@ -765,7 +765,7 @@ Releases are currently forecast to be made available on: [Grafana 8.5.4]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaWebApp.Windows" >}} [Grafana 10.4.1]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaWebApp.10.4.1.Windows" >}} -[Loki 3.0.0]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaLoki.3.0.0.MainDoc" >}} -[Loki 2.5.0]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaLoki.MainDoc" >}} -[Observability 3.0.0]: {{< url path="GitHub.Cortex.Observability.3.0.0.MainDoc" >}} -[Observability 2.2.0]: {{< url path="GitHub.Cortex.Observability.2.2.0.MainDoc" >}} +[Loki 3.0.0]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaLoki.3.0.0.Release" >}} +[Loki 2.5.0]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaLoki.Release" >}} +[Observability 3.0.0]: {{< url path="GitHub.Cortex.Observability.3.0.0.Release" >}} +[Observability 2.2.0]: {{< url path="GitHub.Cortex.Observability.2.2.0.Release" >}} diff --git a/content/en/blog/releases/2024.X/2024.3.md b/content/en/blog/releases/2024.X/2024.3.md index 3d420aa31..28ffeafb5 100644 --- a/content/en/blog/releases/2024.X/2024.3.md +++ b/content/en/blog/releases/2024.X/2024.3.md @@ -743,5 +743,5 @@ Releases are currently forecast to be made available on: [OracleParameter]: {{< url path="Cortex.Reference.DataTypes.Data.OracleParameter.MainDoc" >}} [Grafana 8.5.4]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaWebApp.Windows" >}} -[Loki 2.5.0]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaLoki.MainDoc" >}} -[Observability 2.2.0]: {{< url path="GitHub.Cortex.Observability.2.2.0.MainDoc" >}} +[Loki 2.5.0]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaLoki.Release" >}} +[Observability 2.2.0]: {{< url path="GitHub.Cortex.Observability.2.2.0.Release" >}} diff --git a/content/en/blog/releases/2024.X/2024.5.md b/content/en/blog/releases/2024.X/2024.5.md index 55eab627c..e0b46a6dd 100644 --- a/content/en/blog/releases/2024.X/2024.5.md +++ b/content/en/blog/releases/2024.X/2024.5.md @@ -476,7 +476,7 @@ Releases are currently forecast to be made available on: [Grafana 8.5.4]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaWebApp.Windows" >}} [Grafana 10.4.1]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaWebApp.10.4.1.Windows" >}} -[Loki 3.0.0]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaLoki.3.0.0.MainDoc" >}} -[Loki 2.5.0]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaLoki.MainDoc" >}} -[Observability 3.0.0]: {{< url path="GitHub.Cortex.Observability.3.0.0.MainDoc" >}} -[Observability 2.2.0]: {{< url path="GitHub.Cortex.Observability.2.2.0.MainDoc" >}} +[Loki 3.0.0]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaLoki.3.0.0.Release" >}} +[Loki 2.5.0]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaLoki.Release" >}} +[Observability 3.0.0]: {{< url path="GitHub.Cortex.Observability.3.0.0.Release" >}} +[Observability 2.2.0]: {{< url path="GitHub.Cortex.Observability.2.2.0.Release" >}} diff --git a/content/en/blog/releases/2024.X/2024.7.md b/content/en/blog/releases/2024.X/2024.7.md index 18321d8fa..aac4bae5e 100644 --- a/content/en/blog/releases/2024.X/2024.7.md +++ b/content/en/blog/releases/2024.X/2024.7.md @@ -483,7 +483,7 @@ Releases are currently forecast to be made available on: [Grafana 8.5.4]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaWebApp.Windows" >}} [Grafana 10.4.1]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaWebApp.10.4.1.Windows" >}} -[Loki 3.0.0]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaLoki.3.0.0.MainDoc" >}} -[Loki 2.5.0]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaLoki.MainDoc" >}} -[Observability 3.0.0]: {{< url path="GitHub.Cortex.Observability.3.0.0.MainDoc" >}} -[Observability 2.2.0]: {{< url path="GitHub.Cortex.Observability.2.2.0.MainDoc" >}} +[Loki 3.0.0]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaLoki.3.0.0.Release" >}} +[Loki 2.5.0]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaLoki.Release" >}} +[Observability 3.0.0]: {{< url path="GitHub.Cortex.Observability.3.0.0.Release" >}} +[Observability 2.2.0]: {{< url path="GitHub.Cortex.Observability.2.2.0.Release" >}} diff --git a/content/en/blog/releases/2024.X/2024.9.md b/content/en/blog/releases/2024.X/2024.9.md index 451631bd1..a1c18b788 100644 --- a/content/en/blog/releases/2024.X/2024.9.md +++ b/content/en/blog/releases/2024.X/2024.9.md @@ -645,7 +645,7 @@ Releases are currently forecast to be made available on: [Grafana 8.5.4]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaWebApp.Windows" >}} [Grafana 10.4.1]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaWebApp.10.4.1.Windows" >}} -[Loki 3.0.0]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaLoki.3.0.0.MainDoc" >}} -[Loki 2.5.0]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaLoki.MainDoc" >}} -[Observability 3.0.0]: {{< url path="GitHub.Cortex.Observability.3.0.0.MainDoc" >}} -[Observability 2.2.0]: {{< url path="GitHub.Cortex.Observability.2.2.0.MainDoc" >}} +[Loki 3.0.0]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaLoki.3.0.0.Release" >}} +[Loki 2.5.0]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaLoki.Release" >}} +[Observability 3.0.0]: {{< url path="GitHub.Cortex.Observability.3.0.0.Release" >}} +[Observability 2.2.0]: {{< url path="GitHub.Cortex.Observability.2.2.0.Release" >}} diff --git a/data/urls.toml b/data/urls.toml index 062cf5dca..c444c0506 100644 --- a/data/urls.toml +++ b/data/urls.toml @@ -2484,12 +2484,12 @@ PromtailInstallZip = "https://github.com/CortexIntelligentAutomation/observability/releases/download/v2.1.0/Promtail.Install.zip" GrafanaDashboardsZip = "https://github.com/CortexIntelligentAutomation/observability/releases/download/v2.1.0/Grafana.Dashboards.zip" [GitHub.Cortex.Observability.2.2.0] - MainDoc = "https://github.com/CortexIntelligentAutomation/observability/releases/tag/v2.2.0" + Release = "https://github.com/CortexIntelligentAutomation/observability/releases/tag/v2.2.0" GrafanaLokiInstallZip = "https://github.com/CortexIntelligentAutomation/observability/releases/download/v2.2.0/Grafana.Loki.Install.zip" PromtailInstallZip = "https://github.com/CortexIntelligentAutomation/observability/releases/download/v2.2.0/Promtail.Install.zip" GrafanaDashboardsZip = "https://github.com/CortexIntelligentAutomation/observability/releases/download/v2.2.0/Grafana.Dashboards.zip" [GitHub.Cortex.Observability.3.0.0] - MainDoc = "https://github.com/CortexIntelligentAutomation/observability/releases/tag/v3.0.0" + Release = "https://github.com/CortexIntelligentAutomation/observability/releases/tag/v3.0.0" GrafanaLokiInstallZip = "https://github.com/CortexIntelligentAutomation/observability/releases/download/v3.0.0/Grafana.Loki.Install.zip" PromtailInstallZip = "https://github.com/CortexIntelligentAutomation/observability/releases/download/v3.0.0/Promtail.Install.zip" GrafanaDashboardsZip = "https://github.com/CortexIntelligentAutomation/observability/releases/download/v3.0.0/Grafana.Dashboards.zip" @@ -2507,10 +2507,10 @@ [Grafana.SelfManaged.Downloads.GrafanaWebApp.10.4.1] Windows = "https://grafana.com/grafana/download/10.4.1?pg=get&plcmt=selfmanaged-box1-cta1&platform=windows" [Grafana.SelfManaged.Downloads.GrafanaLoki] - MainDoc = "https://github.com/grafana/loki/releases/tag/v2.5.0" + Release = "https://github.com/grafana/loki/releases/tag/v2.5.0" GrafanaLokiInstallZip = "https://github.com/grafana/loki/releases/download/v2.5.0/loki-windows-amd64.exe.zip" [Grafana.SelfManaged.Downloads.GrafanaLoki.3.0.0] - MainDoc = "https://github.com/grafana/loki/releases/tag/v3.0.0" + Release = "https://github.com/grafana/loki/releases/tag/v3.0.0" GrafanaLokiInstallZip = "https://github.com/grafana/loki/releases/download/v3.0.0/loki-windows-amd64.exe.zip" [Grafana.SelfManaged.Downloads.Promtail] PromtailInstallZip = "https://github.com/grafana/loki/releases/download/v2.5.0/promtail-windows-amd64.exe.zip" From 80bd7d5200e86261ed5e97ac6629f1b31ca8588a Mon Sep 17 00:00:00 2001 From: cortex-lp Date: Tue, 3 Dec 2024 16:07:11 +0000 Subject: [PATCH 12/14] PO review part 1 --- content/en/blog/releases/2024.X/2024.11.md | 296 ++++++------------ content/en/blog/releases/2024.X/2024.3.md | 4 +- content/en/blog/releases/2024.X/2024.5.md | 6 +- content/en/blog/releases/2024.X/2024.7.md | 6 +- content/en/blog/releases/2024.X/2024.9.md | 6 +- .../advanced/port-requirements.md | 11 +- 6 files changed, 121 insertions(+), 208 deletions(-) diff --git a/content/en/blog/releases/2024.X/2024.11.md b/content/en/blog/releases/2024.X/2024.11.md index 375c03bbd..4647729a0 100644 --- a/content/en/blog/releases/2024.X/2024.11.md +++ b/content/en/blog/releases/2024.X/2024.11.md @@ -32,28 +32,28 @@ Installation artefacts can be requested by raising a case in the [{{% ctx %}} Se This release introduces multiple new features to the {{% ctx %}} platform: -* The [Monitoring Service has been introduced][] to provide a high-level view of the system's operations. -* The API Gateway Service now includes the [Operations Overview API][]. +* The [Monitoring Service has been introduced][] that provides aggregated historical data about the platform. * The [Operations Overview page][] has been added to {{% ctx %}} Gateway to provide a high-level view of the system's operations, which includes: - * [Current Status tiles][] - * [Filters][] - * [Graphs][] -* The [configuration for query parameter length][] has been added to the {{% ctx %}} Gateway `web.config`. + * Current Status + * Filters + * Flows graphs +* The [configuration for maximum query string length][] has been added to the {{% ctx %}} Gateway `web.config`. * The [Cortex Interaction Portal can now be installed multiple times on the same machine][]. -* The Cortex Interaction Portal now handles [session updates more reliably on slower systems][]. [Observability][] has been improved by [reducing the maximum size of Service Fabric Trace Logs][]. -The [Performance][] of the {{% ctx %}} has been improved by optimising [handling high volumes of executions more efficiently][]. +The [Performance][] of the {{% ctx %}} has been improved by: + +* optimising [handling high volumes of executions more efficiently][] +* handling [session updates more reliably on slower systems][] [Scalability][] has been enhance by [increasing the header size limit for Service Fabric API Gateway][]. [Security][] has been tighten by: -* updating the [Content-security-policy directives][] -* introducing the [Permissions-Policy header][] -* removing the [X-XSS-PROTECTION header][] -* [deleting the guest user from RabbitMQ on installation and upgrade][] +* updating the [Content-security-policy directives][] on {{% ctx %}} Gateway +* introducing the [Permissions-Policy header][] on {{% ctx %}} Gateway +* removing the [X-XSS-PROTECTION header][] on {{% ctx %}} Gateway [Third-party Support][] has been improved by: @@ -75,15 +75,15 @@ The [Performance][] of the {{% ctx %}} has been improved by optimising [handling [Upgrade][] has been improved by: * [restoring files to pre-upgrade if the load balancer upgrade fails][] -* [streamlining the timeout of the Register-ServiceFabricApplicationType command with other commands][] +* [aligning the timeout of the Register-ServiceFabricApplicationType command with other commands][] * [changing the extension of the studio package created by the upgrade script][] * [allow log file rotation for RabbitMQ logs][Upgrade - allow log file rotation for RabbitMQ logs] * [opening ports for RabbitMQ Stream][Upgrade - opening ports for RabbitMQ Stream] Finally, the [Documentation][] includes updates related to: -* [adding the encryption key to the Load Balancer server][] -* [adding the Grafana Components Compatibility table to release notes][] +* [adding the encryption key to the built-in Load Balancer server][] +* [adding the Observability Compatibility table to release notes][] * [updating the ports used by the platform][] ### Components @@ -108,7 +108,7 @@ Finally, the [Documentation][] includes updates related to: |     > [{{% ctx %}} Execution Service][] | 25.0.4.24460 | Yes | Major | No | Major changes occurred between internal development releases, however, these changes are not breaking between 2024.9 and 2024.11 | | [{{% ctx %}} Gateway][Gateway], including [{{% ctx %}} Studio][] | 12.11.0.24460 | Yes | Minor | N/A | | | [{{% ctx %}} Blocks Package][Blocks] | 48.2.4.24460 | Yes | Patch | N/A | | -| [{{% ctx %}} Interaction Portal][Interaction Portal] | 3.0.1.24460 | Yes | Major | Yes | Major changes occurred between releases, these changes are related to support of multiple Cortex Interaction Portal running on the same machine and are [breaking][Breaking - Added support for multiple Cortex Interaction Portal running on the same machine] | +| [{{% ctx %}} Interaction Portal][Interaction Portal] | 3.0.1.24460 | Yes | Major | Yes | Major changes occurred between releases, these changes are related to support of multiple Cortex Interaction Portal running on the same machine and are [breaking][Breaking - Added support for multiple instances of CORTEX Interaction Portal running on the same machine] | | {{% ctx %}} App Server Install Scripts | 5.2.7.24470 | Yes | Patch | N/A | | | {{% ctx %}} Web App Server Install Scripts | 8.1.2.24460 | Yes | Patch | N/A | | | {{% ctx %}} Upgrade Scripts | 1.2.16.24460 | Yes | Patch | N/A | | @@ -124,8 +124,8 @@ Finally, the [Documentation][] includes updates related to: ##### Introduced the Monitoring Service -{{% ctx %}} Gateway now includes a Monitoring Service that provides a high-level view of the system's operations. -The Monitoring Service is provisioned by default and is available on the Operations Overview page. +{{% ctx %}} now includes a Monitoring Service that provides aggregated historical data about the platform. +Currently, this includes data about executions of flows, which is surfaced within {{% ctx %}} Gateway on the Operations Overview page. @@ -140,98 +140,39 @@ Affected Components: * [{{% ctx %}} Innovation Execution Application][] * [{{% ctx %}} Execution Service][] -##### Added Operations Overview API to API Gateway - -The API Gateway Service now includes the following APIs: - -* Get Operations Overview Data: - * Description: Returns the operations overview graph data which consist of: - * Flows execution Success Rate - * Total number of Completed Executions - * Total number of Errored Executions - * Url path: `api/dashboards/operationsOverview/data` - * Query parameters: - * `packageNames` - * `packageVersions` - * `flowNames` - * `startDate` - * `endDate` - -* Get Operations Overview Filters Paths: - * Description: Returns the list of filters paths is used by the filters of the {{% ctx %}} Gateway Operations Overview page. - * Url path: `api/dashboards/operationsOverview/filters/paths` - * Query parameters: - * `startDate` - * `endDate` - - - - - - - - - -Affected Components: - -* [{{% ctx %}} Innovation Core Application][] - * [{{% ctx %}} API Gateway Service][] - ##### Introduced the Operations Overview page -{{% ctx %}} Gateway now includes an Operations Overview page that provides a high-level view of the system's operations. +{{% ctx %}} Gateway now includes an Operations Overview page that displays important metrics about the platform's current status, as well as graphs rendering the aggregated historical data provided by the [Monitoring Service][{{% ctx %}} Monitoring Service]. - +The page has the following sections: -Affected Components: - -* [{{% ctx %}} Gateway][Gateway] - -##### Added Current Status tiles to the Operations Overview page - -The Operations Overview page now includes tiles that display the current status of the system, which includes: - -* License consumption -* Cluster health -* Running Executions - - +* `Current Status`, which includes: + * License Consumption + * Cluster Health + * Running Executions +* `Filters`, that allow users to filter data based on the selected `Time Period`, `Package Names`, `Package Versions` and `Flows`. +* `Flows`, which contains graphs displaying the following data: + * Success rate + * Completed flows + * Errored flows Affected Components: * [{{% ctx %}} Gateway][Gateway] -##### Added Filters to the Operations Overview page - -The Operations Overview page now includes filters that allow users to filter data based on the selected timespan, packages, package versions and flows. - - - - -Affected Components: - -* [{{% ctx %}} Gateway][Gateway] - -##### Added Graphs to the Operations Overview page - -The Operations Overview page now includes graphs that display the following data: - -* Success rate -* Completed flows -* Errored flows - + + + + -Affected Components: - -* [{{% ctx %}} Gateway][Gateway] - -##### Added configuration for query parameter length +##### Added configuration for maximum query string length -{{% ctx %}} Gateway `web.config` now includes configuration settings allowing to configure the maximum query parameter length. +With the introduction of the Operations Overview page, it is possible for the API used to return the aggregated data from the [Monitoring Service][{{% ctx %}} Monitoring Service], to exceed the default maximum number of characters allowed in the `query string` part of the URL. +{{% ctx %}} Gateway `web.config` now includes settings allowing the maximum number of characters to be increased from the default value of `8192`. Currently, there is no documentation available on how to do this. For further assistance, please raise a case in the [{{% ctx %}} Service Portal][]. @@ -240,32 +181,21 @@ Affected Components: * [{{% ctx %}} Gateway][Gateway] -##### Added support for multiple Cortex Interaction Portal running on the same machine +##### Added support for multiple instances of the {{% ctx %}} Interaction Portal running on the same machine -The Cortex Interaction Portal can now be installed multiple times on the same machine. -This allows for multiple instances of the Interaction Portal to be run on the same machine, each with its own configuration and data. +The [{{% ctx %}} Interaction Portal][Interaction Portal] can now be installed multiple times on the same machine, each with its own configuration and data. Affected Components: -* {{% ctx %}} Interaction Portal - -##### Improved session update reliability on slow systems - -The Cortex Interaction Portal now handles session updates more reliably on slower systems. - - - -Affected Components: - -* {{% ctx %}} Interaction Portal +* [{{% ctx %}} Interaction Portal][Interaction Portal] #### Observability -##### Reduced the maximum size of Service Fabric Trace Logs +##### Reduced the maximum size of Service Fabric Logs -The maximum size of Service Fabric Trace Logs has been reduced to reduce the amount of disk space used. +The maximum size of Service Fabric Logs has been reduced from `65GB` to `10GB`. @@ -286,11 +216,21 @@ Affected Components: * [{{% ctx %}} Innovation Core Application][] * [{{% ctx %}} Execution Management Service][] +##### Improved session update reliability on slow systems + +The [{{% ctx %}} Interaction Portal][Interaction Portal] now handles session updates more reliably on slower systems. + + + +Affected Components: + +* [{{% ctx %}} Interaction Portal][Interaction Portal] + #### Scalability ##### Increased the header size limit for Service Fabric API Gateway -The header size limit for the Service Fabric API Gateway has been increased to allow for larger headers to be processed. +The header size limit for the Service Fabric API Gateway has been increased from `32765 bytes` to `65536 bytes` to allow for larger headers to be processed. @@ -301,9 +241,9 @@ Affected Components: #### Security -##### Reviewed the Content-security-policy directives +##### Reviewed the Content-Security-Policy directives on {{% ctx %}} Gateway -The Content-security-policy directives have been reviewed and updated to ensure that they are secure. +The Content-Security-Policy directives on {{% ctx %}} Gateway have been reviewed and updated to ensure that they are secure. @@ -311,9 +251,9 @@ Affected Components: * [{{% ctx %}} Gateway][Gateway] -##### Introduced the Permissions-Policy header +##### Introduced the Permissions-Policy header on {{% ctx %}} Gateway -The Permissions-Policy header has been introduced to improve security. +The Permissions-Policy header on {{% ctx %}} Gateway has been introduced to improve security. @@ -321,9 +261,9 @@ Affected Components: * [{{% ctx %}} Gateway][Gateway] -##### Removed the X-XSS-PROTECTION header +##### Removed the X-XSS-PROTECTION header on {{% ctx %}} Gateway -The X-XSS-PROTECTION header has been removed as it is deprecated. +The X-XSS-PROTECTION header on {{% ctx %}} Gateway has been removed as it is deprecated. @@ -331,23 +271,11 @@ Affected Components: * [{{% ctx %}} Gateway][Gateway] -##### Deleted the guest user from RabbitMQ on installation and upgrade - -The guest user is now deleted from RabbitMQ on installation and upgrade to improve security. - - - - -Affected Components: - -* {{% ctx %}} App Server Install Scripts -* {{% ctx %}} Upgrade Scripts - #### Third-party Support ##### Added Health Check API to Service Fabric API Gateway -A Health Check API has been added to the Service Fabric API Gateway to allow third-party load balancers to check the health of the system. +A Health Check API has been added to the Service Fabric API Gateway to allow third-party load balancers to check the health of the platform. @@ -403,7 +331,8 @@ Affected Components: ##### Added support for RabbitMQ log file rotation -The installation script now sets up log file rotation RabbitMQ. +The installation script now sets up log file rotation for RabbitMQ. +The default is now a maximum of 20 files, each with a maximum size of 20MB. @@ -414,7 +343,7 @@ Affected Components: ##### Opened ports for RabbitMQ Stream -A bug has been fixed logs were being generated due to RabbitMQ Stream ports not being open. +RabbitMQ Stream ports (6000 to 6500) are now open to reduce noise in RabbitMQ logs. @@ -425,9 +354,9 @@ Affected Components: #### Upgrade -##### Improved of the load balancer upgrade process +##### Improved the load balancer upgrade process -The upgrade process now restores the files to pre-upgrade if the load balancer upgrade fails. +The upgrade process now restores the files to their pre-upgrade state if the load balancer upgrade fails. @@ -435,9 +364,9 @@ Affected Components: * {{% ctx %}} Upgrade Scripts -##### Streamlined the timeout of the Register-ServiceFabricApplicationType command with other commands +##### Aligned the timeout of the Register-ServiceFabricApplicationType command with other commands -The timeout of the Register-ServiceFabricApplicationType command has been set to 1800s, like other commands. +The timeout of the Register-ServiceFabricApplicationType command has been set to `1800 seconds`, like other commands. @@ -447,7 +376,7 @@ Affected Components: ##### Changed the extension of the studio package created by the upgrade script -The studio package created by the upgrade script now has the file extension `.studiopkg` to be consistent with the documentation. +The studio package created by the upgrade script now has the file extension `.studiopkg` in lower-case to be consistent with the documentation. @@ -457,7 +386,8 @@ Affected Components: ##### Added support for RabbitMQ log file rotation -The installation script now sets up log file rotation RabbitMQ. +The upgrade script now sets up log file rotation for RabbitMQ. +The default is now a maximum of 20 files, each with a maximum size of 20MB. @@ -468,7 +398,7 @@ Affected Components: ##### Opened ports for RabbitMQ Stream -A bug has been fixed logs were being generated due to RabbitMQ Stream ports not being open. +RabbitMQ Stream ports (6000 to 6500) are now open to reduce noise in RabbitMQ logs. @@ -479,21 +409,21 @@ Affected Components: #### Documentation -##### Added how to add the encryption key to the Load Balancer server +##### Added how to add the encryption key to the built-in Load Balancer server -The documentation now includes instructions on how to add the encryption key to the Load Balancer server during both installation and upgrade. +The documentation now includes instructions on how to add the encryption key to the built-in Load Balancer server during both installation and upgrade. -##### Added Grafana Components Compatibility table to release notes +##### Added Observability Compatibility table to release notes -The [Grafana Components Compatibility][] table has been added to the release notes. +The [Observability Compatibility][] table has been added to the release notes. ##### Updated ports used by the platform -The documentation has been updated to include the new ports used by the {{% ctx %}} platform. +The documentation has been updated to include the new ports used by the {{% ctx %}} platform for the [{{% ctx %}} Listeners Service][] including the Flow API Proxy. @@ -515,7 +445,7 @@ Affected Components: ##### Published packages with nested flows fail to execute -A bug has been fixed where published flows containing nested flows up to three layers deep would throw a KeyNotFoundException when attempting to execute the third layer. +A bug has been fixed where published packages containing nested flows at least three layers deep would throw a KeyNotFoundException when attempting to execute the third layer. @@ -524,9 +454,9 @@ Affected Components: * [{{% ctx %}} Innovation Execution Application][] * [{{% ctx %}} Execution Service][] -##### LINQ expression does not work +##### C# LINQ expression does not work -A bug has been fixed where LINQ expressions would not work at all. +A bug has been fixed where C# LINQ expressions defined in the Expression editor did not work. @@ -535,9 +465,9 @@ Affected Components: * [{{% ctx %}} Innovation Execution Application][] * [{{% ctx %}} Execution Service][] -##### Expression containing a string.Split() causes an exception +##### Expression containing using the Split() method of a String data type causes an exception -A bug has been fixed where an expression containing a string.Split() would sometimes throw a runtime exception. +A bug has been fixed where an expression using the `Split()` method of a String data type would sometimes throw a runtime exception. @@ -546,17 +476,6 @@ Affected Components: * [{{% ctx %}} Innovation Execution Application][] * [{{% ctx %}} Execution Service][] -##### Opened ports for RabbitMQ Stream - -A bug has been fixed logs were being generated due to RabbitMQ Stream ports not being open. - - - -Affected Components: - -* {{% ctx %}} App Server Install Scripts -* {{% ctx %}} Upgrade Scripts - #### Usability ##### LiveView datetime picker styling issues @@ -571,9 +490,9 @@ Affected Components: #### Installation -##### Fixed error the installation what-if command +##### Fixed error on the installation what-if command -The installation script no longer import the ServiceFabric PowerShell module when running the what-if command. +The installation script no longer imports the ServiceFabric PowerShell module when running the what-if command. @@ -587,28 +506,17 @@ A bug has been fixed where updating the certificate would not update the load ba - - - - - - - - - - - - - - ### Breaking Changes The following features have introduced breaking changes in the 2024.11 release of the {{% ctx %}} Platform: -#### Added support for multiple Cortex Interaction Portal running on the same machine +#### Added support for multiple instances of the {{% ctx %}} Interaction Portal running on the same machine + +The following feature has changed both the {{% ctx %}} Interaction Portal flows and the AppGyver Solution package. +If using the {{% ctx %}} Interaction Portal, it will need to be re-installed. +For further assistance, please raise a case in the [{{% ctx %}} Service Portal][]. -The following feature has changed both the flows and the AppGyver Solution package. -The platform will need to be re-installed, resulting in the loss of all data, customisation and configurations. + ### Known Limitations @@ -627,6 +535,7 @@ There are no known limitations added as part of the 2024.11 release of the {{% c | 7.X Version | Is compatible? | Notes | |-------------|----------------|----------------------------------------------| +| 7.3 | Yes | | | 7.2 | Yes | | | 7.1 | No | Need to upgrade 7.1 to 7.2 for compatibility | | 7.0 | No | Need to upgrade 7.0 to 7.2 for compatibility | @@ -641,9 +550,9 @@ There are no known limitations added as part of the 2024.11 release of the {{% c | 2024.5 | 31.24311 | | 2024.3 | 30 | -### Grafana Components Compatibility +### Observability Compatibility -| Release | Grafana WebApp Version | Grafana Loki Version | {{% ctx %}} Observability Version | +| Release | Grafana Version | Grafana Loki Version | {{% ctx %}} Observability Version | |---------|--------------------------|----------------------|-----------------------------------| | 2024.11 | [10.4.1][Grafana 10.4.1] | [3.0.0][Loki 3.0.0] | [3.0.0][Observability 3.0.0] | | 2024.9 | [10.4.1][Grafana 10.4.1] | [3.0.0][Loki 3.0.0] | [3.0.0][Observability 3.0.0] | @@ -678,9 +587,13 @@ Upgrading {{% ctx %}}: Releases are currently forecast to be made available on: -| Release | Release Type | Forecast Release Date | -|---------|----------------|------------------------------------| -| 2025.1 | [Fast Track][] | Week commencing 10th February 2024 | +| Release | Release Type | Forecast Release Date | +|---------|----------------|-------------------------------------| +| 2025.1 | [Fast Track][] | Week commencing 10th February 2025 | +| 2025.3 | [Release][] | Week commencing 7th April 2025 | +| 2025.5 | [Fast Track][] | Week commencing 2nd June 2025 | +| 2025.7 | [Fast Track][] | Week commencing 11th August 2025 | +| 2025.9 | [Release][] | Week commencing 6th October 2025 | [{{% ctx %}} Innovation Core Application]: {{< url path="Cortex.Guides.CortexInnovation.CoreApplication.MainDoc" version="2024.11" >}} [{{% ctx %}} API Gateway Service]: {{< url path="Cortex.Guides.CortexInnovation.CoreApplication.Services.ApiGatewayService.MainDoc" version="2024.11" >}} @@ -706,7 +619,7 @@ Releases are currently forecast to be made available on: [Current Status tiles]: {{< ref "#added-current-status-tiles-to-the-operations-overview-page" >}} [Filters]: {{< ref "#added-filters-to-the-operations-overview-page" >}} [Graphs]: {{< ref "#added-graphs-to-the-operations-overview-page" >}} -[configuration for query parameter length]: {{< ref "#added-configuration-for-query-parameter-length" >}} +[configuration for maximum query string length]: {{< ref "#added-configuration-for-maximum-query-string-length" >}} [Cortex Interaction Portal can now be installed multiple times on the same machine]: {{< ref "#added-support-for-multiple-cortex-interaction-portal-running-on-the-same-machine" >}} [session updates more reliably on slower systems]: {{< ref "#improved-session-update-reliability-on-slow-systems" >}} [Observability]: {{< ref "#observability" >}} @@ -719,7 +632,6 @@ Releases are currently forecast to be made available on: [Content-security-policy directives]: {{< ref "#reviewed-the-content-security-policy-directives" >}} [Permissions-Policy header]: {{< ref "#introduced-the-permissions-policy-header" >}} [X-XSS-PROTECTION header]: {{< ref "#removed-the-x-xss-protection-header" >}} -[deleting the guest user from RabbitMQ on installation and upgrade]: {{< ref "#deleted-the-guest-user-from-rabbitmq-on-installation-and-upgrade" >}} [Third-party Support]: {{< ref "#third-party-support" >}} [Health Check API to Service Fabric API Gateway]: {{< ref "#added-health-check-api-to-service-fabric-api-gateway" >}} [Installation]: {{< ref "#installation" >}} @@ -729,17 +641,17 @@ Releases are currently forecast to be made available on: [open ports for RabbitMQ Stream]: {{< ref "#opened-ports-for-rabbitmq-stream" >}} [Upgrade]: {{< ref "#upgrade" >}} [restoring files to pre-upgrade if the load balancer upgrade fails]: {{< ref "#improved-of-the-load-balancer-upgrade-process" >}} -[streamlining the timeout of the Register-ServiceFabricApplicationType command with other commands]: {{< ref "#streamlined-the-timeout-of-the-register-servicefabricapplicationtype-command-with-other-commands" >}} +[aligning the timeout of the Register-ServiceFabricApplicationType command with other commands]: {{< ref "#aligned-the-timeout-of-the-register-servicefabricapplicationtype-command-with-other-commands" >}} [changing the extension of the studio package created by the upgrade script]: {{< ref "#changed-the-extension-of-the-studio-package-created-by-the-upgrade-script" >}} [Upgrade - allow log file rotation for RabbitMQ logs]: {{< ref "#added-support-for-rabbitmq-log-file-rotation-1" >}} [Upgrade - opening ports for RabbitMQ Stream]: {{< ref "#opened-ports-for-rabbitmq-stream-1" >}} [Documentation]: {{< ref "#documentation" >}} -[adding the encryption key to the Load Balancer server]: {{< ref "#added-how-to-add-the-encryption-key-to-the-load-balancer-server" >}} -[adding the Grafana Components Compatibility table to release notes]: {{< ref "#added-grafana-components-compatibility-table-to-release-notes" >}} +[adding the encryption key to the built-in Load Balancer server]: {{< ref "#added-how-to-add-the-encryption-key-to-the-built-in-load-balancer-server" >}} +[adding the Observability Compatibility table to release notes]: {{< ref "#added-observability-compatibility-table-to-release-notes" >}} [updating the ports used by the platform]: {{< ref "#updated-ports-used-by-the-platform" >}} [Upgrade Instructions]: {{< ref "#upgrade-instructions" >}} -[Grafana Components Compatibility]: {{< ref "#grafana-components-compatibility" >}} +[Observability Compatibility]: {{< ref "#observability-compatibility" >}} [Blocks]: {{< url path="Cortex.Reference.Blocks.MainDoc" version="2024.11" >}} @@ -753,7 +665,7 @@ Releases are currently forecast to be made available on: [Upgrade - Single Server - Without HA]: {{< url path="Cortex.Guides.UpgradeCortex.2024.9to2024.11.SingleServerWithoutHA.MainDoc" version="2024.11" >}} [Upgrade - Multiple Server - With HA]: {{< url path="Cortex.Guides.UpgradeCortex.2024.9to2024.11.MultipleServerWithHA.MainDoc" version="2024.11" >}} -[Breaking - Added support for multiple Cortex Interaction Portal running on the same machine]: {{< ref "#added-support-for-multiple-cortex-interaction-portal-running-on-the-same-machine-1" >}} +[Breaking - Added support for multiple instances of CORTEX Interaction Portal running on the same machine]: {{< ref "#added-support-for-multiple-instances-of-the-cortex-interaction-portal-running-on-the-same-machine-1" >}} [{{% ctx %}} Studio]: {{< url path="Cortex.Guides.Studio.MainDoc" version="2024.11" >}} diff --git a/content/en/blog/releases/2024.X/2024.3.md b/content/en/blog/releases/2024.X/2024.3.md index 28ffeafb5..679335604 100644 --- a/content/en/blog/releases/2024.X/2024.3.md +++ b/content/en/blog/releases/2024.X/2024.3.md @@ -626,9 +626,9 @@ There are no known limitations added as part of the 2024.3 release of the {{% ct |---------|-----------------------| | 2024.3 | 30 | -### Grafana Components Compatibility +### Observability Compatibility -| Release | Grafana WebApp Version | Grafana Loki Version | {{% ctx %}} Observability Version | +| Release | Grafana Version | Grafana Loki Version | {{% ctx %}} Observability Version | |---------|--------------------------|----------------------|-----------------------------------| | 2024.3 | [8.5.4][Grafana 8.5.4] | [2.5.0][Loki 2.5.0] | [2.2.0][Observability 2.2.0] | diff --git a/content/en/blog/releases/2024.X/2024.5.md b/content/en/blog/releases/2024.X/2024.5.md index e0b46a6dd..052940e19 100644 --- a/content/en/blog/releases/2024.X/2024.5.md +++ b/content/en/blog/releases/2024.X/2024.5.md @@ -349,9 +349,9 @@ There are no known limitations added as part of the 2024.5 release of the {{% ct | 2024.5 | 31.24311 | | 2024.3 | 30 | -### Grafana Components Compatibility +### Observability Compatibility -| Release | Grafana WebApp Version | Grafana Loki Version | {{% ctx %}} Observability Version | +| Release | Grafana Version | Grafana Loki Version | {{% ctx %}} Observability Version | |---------|--------------------------|----------------------|-----------------------------------| | 2024.5 | [10.4.1][Grafana 10.4.1] | [3.0.0][Loki 3.0.0] | [3.0.0][Observability 3.0.0] | | 2024.3 | [8.5.4][Grafana 8.5.4] | [2.5.0][Loki 2.5.0] | [2.2.0][Observability 2.2.0] | @@ -388,7 +388,7 @@ Releases are currently forecast to be made available on: | 2024.7 | [Fast Track][] | Week commencing 12th August 2024 | | 2024.9 | [Release][] | Week commencing 7th October 2024 | | 2024.11 | [Fast Track][] | Week commencing 2nd December 2024 | -| 2025.1 | [Release][] | Week commencing 10th February 2024 | +| 2025.1 | [Release][] | Week commencing 10th February 2025 | [{{% ctx %}} Innovation Core Application]: {{< url path="Cortex.Guides.CortexInnovation.CoreApplication.MainDoc" version="2024.5" >}} [{{% ctx %}} API Gateway Service]: {{< url path="Cortex.Guides.CortexInnovation.CoreApplication.Services.ApiGatewayService.MainDoc" version="2024.5" >}} diff --git a/content/en/blog/releases/2024.X/2024.7.md b/content/en/blog/releases/2024.X/2024.7.md index aac4bae5e..fbc410360 100644 --- a/content/en/blog/releases/2024.X/2024.7.md +++ b/content/en/blog/releases/2024.X/2024.7.md @@ -355,9 +355,9 @@ There are no known limitations added as part of the 2024.7 release of the {{% ct | 2024.5 | 31.24311 | | 2024.3 | 30 | -### Grafana Components Compatibility +### Observability Compatibility -| Release | Grafana WebApp Version | Grafana Loki Version | {{% ctx %}} Observability Version | +| Release | Grafana Version | Grafana Loki Version | {{% ctx %}} Observability Version | |---------|--------------------------|----------------------|-----------------------------------| | 2024.7 | [10.4.1][Grafana 10.4.1] | [3.0.0][Loki 3.0.0] | [3.0.0][Observability 3.0.0] | | 2024.5 | [10.4.1][Grafana 10.4.1] | [3.0.0][Loki 3.0.0] | [3.0.0][Observability 3.0.0] | @@ -395,7 +395,7 @@ Releases are currently forecast to be made available on: | 2024.7 | [Fast Track][] | Week commencing 12th August 2024 | | 2024.9 | [Release][] | Week commencing 7th October 2024 | | 2024.11 | [Fast Track][] | Week commencing 2nd December 2024 | -| 2025.1 | [Fast Track][] | Week commencing 10th February 2024 | +| 2025.1 | [Fast Track][] | Week commencing 10th February 2025 | [{{% ctx %}} Innovation Core Application]: {{< url path="Cortex.Guides.CortexInnovation.CoreApplication.MainDoc" version="2024.7" >}} [{{% ctx %}} API Gateway Service]: {{< url path="Cortex.Guides.CortexInnovation.CoreApplication.Services.ApiGatewayService.MainDoc" version="2024.7" >}} diff --git a/content/en/blog/releases/2024.X/2024.9.md b/content/en/blog/releases/2024.X/2024.9.md index a1c18b788..7c210e1ef 100644 --- a/content/en/blog/releases/2024.X/2024.9.md +++ b/content/en/blog/releases/2024.X/2024.9.md @@ -482,9 +482,9 @@ There are no known limitations added as part of the 2024.9 release of the {{% ct | 2024.5 | 31.24311 | | 2024.3 | 30 | -### Grafana Components Compatibility +### Observability Compatibility -| Release | Grafana WebApp Version | Grafana Loki Version | {{% ctx %}} Observability Version | +| Release | Grafana Version | Grafana Loki Version | {{% ctx %}} Observability Version | |---------|--------------------------|----------------------|-----------------------------------| | 2024.9 | [10.4.1][Grafana 10.4.1] | [3.0.0][Loki 3.0.0] | [3.0.0][Observability 3.0.0] | | 2024.7 | [10.4.1][Grafana 10.4.1] | [3.0.0][Loki 3.0.0] | [3.0.0][Observability 3.0.0] | @@ -522,7 +522,7 @@ Releases are currently forecast to be made available on: |---------|----------------|------------------------------------| | 2024.9 | [Release][] | Week commencing 7th October 2024 | | 2024.11 | [Fast Track][] | Week commencing 2nd December 2024 | -| 2025.1 | [Fast Track][] | Week commencing 10th February 2024 | +| 2025.1 | [Fast Track][] | Week commencing 10th February 2025 | [{{% ctx %}} Innovation Core Application]: {{< url path="Cortex.Guides.CortexInnovation.CoreApplication.MainDoc" version="2024.9" >}} [{{% ctx %}} API Gateway Service]: {{< url path="Cortex.Guides.CortexInnovation.CoreApplication.Services.ApiGatewayService.MainDoc" version="2024.9" >}} diff --git a/content/en/docs/2024.11/getting-started/on-premise/install-innovation-only/advanced/port-requirements.md b/content/en/docs/2024.11/getting-started/on-premise/install-innovation-only/advanced/port-requirements.md index a8af1d71c..d9c2084ab 100644 --- a/content/en/docs/2024.11/getting-started/on-premise/install-innovation-only/advanced/port-requirements.md +++ b/content/en/docs/2024.11/getting-started/on-premise/install-innovation-only/advanced/port-requirements.md @@ -73,12 +73,13 @@ Each service has an endpoint which is used to communicate with Service Fabric an {{% alert title="Note" %}}Only applicable for installations with HA.{{% /alert %}} -The load balancer server must be able to retrieve traffic via HTTPS. The following firewall ports are opened by the installer (these rules will all appear in Windows Firewall with names starting with `{CustomerName}`): +The load balancer server must be able to retrieve traffic via HTTPS. The following firewall ports are opened by the installer (these rules will all appear in Windows Firewall with names starting with `Cortex.{CustomerName}`): -|Name in Rule | Name in Config | Default Port(s) | Protocol(s) | Direction | Program | -|--------------------|----------------------|-----------------|-------------|-----------|---------| -| GoBetweenTlsPort | loadBalancerSnmpPort | 162 | UDP | Inbound | Any | -| GoBetweenTlsPort | loadBalancerTlsPort | 443 | TCP | Inbound | Any | +| Name in Rule | Name in Config | Default Port(s) | Protocol(s) | Direction | Program | +|---------------------------|------------------------------|-----------------|-------------|-----------|---------| +| GoBetweenSnmpPort | loadBalancerSnmpPort | 162 | UDP | Inbound | Any | +| GoBetweenTlsPort | loadBalancerTlsPort | 443 | TCP | Inbound | Any | +| GoBetweenFlowApiProxyPort | loadBalancerFlowApiProxyPort | 10000 | TCP | Inbound | Any | [Dynamic Ports]: {{< url path="MSSupport.Troubleshooting.DynamicPorts" >}} [Service Fabric reverse proxy]: {{< url path="MSDocs.ServiceFabric.ReverseProxy" >}} From 9a79c620435c0c9f6f1eec17456beb61a6c986b0 Mon Sep 17 00:00:00 2001 From: cortex-lp Date: Tue, 3 Dec 2024 16:37:27 +0000 Subject: [PATCH 13/14] PO review part 2 --- content/en/blog/releases/2024.X/2024.11.md | 31 ++++++++++------------ 1 file changed, 14 insertions(+), 17 deletions(-) diff --git a/content/en/blog/releases/2024.X/2024.11.md b/content/en/blog/releases/2024.X/2024.11.md index 4647729a0..c81409e57 100644 --- a/content/en/blog/releases/2024.X/2024.11.md +++ b/content/en/blog/releases/2024.X/2024.11.md @@ -36,7 +36,7 @@ This release introduces multiple new features to the {{% ctx %}} platform: * The [Operations Overview page][] has been added to {{% ctx %}} Gateway to provide a high-level view of the system's operations, which includes: * Current Status * Filters - * Flows graphs + * Flow graphs * The [configuration for maximum query string length][] has been added to the {{% ctx %}} Gateway `web.config`. * The [Cortex Interaction Portal can now be installed multiple times on the same machine][]. @@ -47,13 +47,13 @@ The [Performance][] of the {{% ctx %}} has been improved by: * optimising [handling high volumes of executions more efficiently][] * handling [session updates more reliably on slower systems][] -[Scalability][] has been enhance by [increasing the header size limit for Service Fabric API Gateway][]. +[Scalability][] has been enhanced by [increasing the header size limit for Service Fabric API Gateway][]. -[Security][] has been tighten by: +[Security][] has been tightened on {{% ctx %}} Gateway by: -* updating the [Content-security-policy directives][] on {{% ctx %}} Gateway -* introducing the [Permissions-Policy header][] on {{% ctx %}} Gateway -* removing the [X-XSS-PROTECTION header][] on {{% ctx %}} Gateway +* updating the [Content-security-policy directives][] +* introducing the [Permissions-Policy header][] +* removing the [X-XSS-PROTECTION header][] [Third-party Support][] has been improved by: @@ -108,7 +108,7 @@ Finally, the [Documentation][] includes updates related to: |     > [{{% ctx %}} Execution Service][] | 25.0.4.24460 | Yes | Major | No | Major changes occurred between internal development releases, however, these changes are not breaking between 2024.9 and 2024.11 | | [{{% ctx %}} Gateway][Gateway], including [{{% ctx %}} Studio][] | 12.11.0.24460 | Yes | Minor | N/A | | | [{{% ctx %}} Blocks Package][Blocks] | 48.2.4.24460 | Yes | Patch | N/A | | -| [{{% ctx %}} Interaction Portal][Interaction Portal] | 3.0.1.24460 | Yes | Major | Yes | Major changes occurred between releases, these changes are related to support of multiple Cortex Interaction Portal running on the same machine and are [breaking][Breaking - Added support for multiple instances of CORTEX Interaction Portal running on the same machine] | +| [{{% ctx %}} Interaction Portal][Interaction Portal] | 3.0.1.24460 | Yes | Major | Yes | Major changes occurred between releases, these changes are related to support of multiple {{% ctx %}} Interaction Portal instances running on the same machine and are [breaking][Breaking - Added support for multiple instances of CORTEX Interaction Portal running on the same machine] | | {{% ctx %}} App Server Install Scripts | 5.2.7.24470 | Yes | Patch | N/A | | | {{% ctx %}} Web App Server Install Scripts | 8.1.2.24460 | Yes | Patch | N/A | | | {{% ctx %}} Upgrade Scripts | 1.2.16.24460 | Yes | Patch | N/A | | @@ -614,24 +614,20 @@ Releases are currently forecast to be made available on: [Interaction Portal]: {{< url path="Cortex.Guides.CortexInteractionPortal.MainDoc" version="2024.11" >}} [Monitoring Service has been introduced]: {{< ref "#introduced-the-monitoring-service" >}} -[Operations Overview API]: {{< ref "#added-operations-overview-api-to-api-gateway" >}} [Operations Overview page]: {{< ref "#introduced-the-operations-overview-page" >}} -[Current Status tiles]: {{< ref "#added-current-status-tiles-to-the-operations-overview-page" >}} -[Filters]: {{< ref "#added-filters-to-the-operations-overview-page" >}} -[Graphs]: {{< ref "#added-graphs-to-the-operations-overview-page" >}} [configuration for maximum query string length]: {{< ref "#added-configuration-for-maximum-query-string-length" >}} -[Cortex Interaction Portal can now be installed multiple times on the same machine]: {{< ref "#added-support-for-multiple-cortex-interaction-portal-running-on-the-same-machine" >}} +[Cortex Interaction Portal can now be installed multiple times on the same machine]: {{< ref "#added-support-for-multiple-instances-of-the-cortex-interaction-portal-running-on-the-same-machine" >}} [session updates more reliably on slower systems]: {{< ref "#improved-session-update-reliability-on-slow-systems" >}} [Observability]: {{< ref "#observability" >}} -[reducing the maximum size of Service Fabric Trace Logs]: {{< ref "#reduced-the-maximum-size-of-service-fabric-trace-logs" >}} +[reducing the maximum size of Service Fabric Trace Logs]: {{< ref "#reduced-the-maximum-size-of-service-fabric-logs" >}} [Performance]: {{< ref "#performance" >}} [handling high volumes of executions more efficiently]: {{< ref "#improved-the-performance-of-the-execution-management-service" >}} [Scalability]: {{< ref "#scalability" >}} [increasing the header size limit for Service Fabric API Gateway]: {{< ref "#increased-the-header-size-limit-for-service-fabric-api-gateway" >}} [Security]: {{< ref "#security" >}} -[Content-security-policy directives]: {{< ref "#reviewed-the-content-security-policy-directives" >}} -[Permissions-Policy header]: {{< ref "#introduced-the-permissions-policy-header" >}} -[X-XSS-PROTECTION header]: {{< ref "#removed-the-x-xss-protection-header" >}} +[Content-security-policy directives]: {{< ref "#reviewed-the-content-security-policy-directives-on-cortex-gateway" >}} +[Permissions-Policy header]: {{< ref "#introduced-the-permissions-policy-header-on-cortex-gateway" >}} +[X-XSS-PROTECTION header]: {{< ref "#removed-the-x-xss-protection-header-on-cortex-gateway" >}} [Third-party Support]: {{< ref "#third-party-support" >}} [Health Check API to Service Fabric API Gateway]: {{< ref "#added-health-check-api-to-service-fabric-api-gateway" >}} [Installation]: {{< ref "#installation" >}} @@ -640,7 +636,7 @@ Releases are currently forecast to be made available on: [allow log file rotation for RabbitMQ logs]: {{< ref "#added-support-for-rabbitmq-log-file-rotation" >}} [open ports for RabbitMQ Stream]: {{< ref "#opened-ports-for-rabbitmq-stream" >}} [Upgrade]: {{< ref "#upgrade" >}} -[restoring files to pre-upgrade if the load balancer upgrade fails]: {{< ref "#improved-of-the-load-balancer-upgrade-process" >}} +[restoring files to pre-upgrade if the load balancer upgrade fails]: {{< ref "#improved-the-load-balancer-upgrade-process" >}} [aligning the timeout of the Register-ServiceFabricApplicationType command with other commands]: {{< ref "#aligned-the-timeout-of-the-register-servicefabricapplicationtype-command-with-other-commands" >}} [changing the extension of the studio package created by the upgrade script]: {{< ref "#changed-the-extension-of-the-studio-package-created-by-the-upgrade-script" >}} [Upgrade - allow log file rotation for RabbitMQ logs]: {{< ref "#added-support-for-rabbitmq-log-file-rotation-1" >}} @@ -672,6 +668,7 @@ Releases are currently forecast to be made available on: [{{% ctx %}} Service Portal]: {{< url path="Cortex.ServicePortal.MainDoc" version="2024.11" >}} [Fast Track]: {{< url path="Cortex.Reference.Glossary.F-J.FastTrack" version="2024.11" >}} +[Release]: {{< url path="Cortex.Reference.Glossary.P-T.Release" version="2024.11" >}} [2024.9]: {{< url path="Cortex.Blogs.Releases.2024.9.MainDoc" version="2024.11" >}} From 66177b8285d694f6badfe681e81750d2a850c449 Mon Sep 17 00:00:00 2001 From: cortex-lp Date: Wed, 4 Dec 2024 09:21:06 +0000 Subject: [PATCH 14/14] added what's new --- content/en/blog/releases/2024.X/2024.11.md | 83 +----------- content/en/docs/2024.11/Whats New/_index.md | 138 +++++++++++--------- data/urls.toml | 27 ++++ 3 files changed, 109 insertions(+), 139 deletions(-) diff --git a/content/en/blog/releases/2024.X/2024.11.md b/content/en/blog/releases/2024.X/2024.11.md index c81409e57..4eb510a0d 100644 --- a/content/en/blog/releases/2024.X/2024.11.md +++ b/content/en/blog/releases/2024.X/2024.11.md @@ -55,6 +55,8 @@ The [Performance][] of the {{% ctx %}} has been improved by: * introducing the [Permissions-Policy header][] * removing the [X-XSS-PROTECTION header][] +[Usability][] has been improved by [fixing the LiveView datetime picker styling issues][]. + [Third-party Support][] has been improved by: * adding a [Health Check API to Service Fabric API Gateway][] @@ -127,10 +129,6 @@ Finally, the [Documentation][] includes updates related to: {{% ctx %}} now includes a Monitoring Service that provides aggregated historical data about the platform. Currently, this includes data about executions of flows, which is surfaced within {{% ctx %}} Gateway on the Operations Overview page. - - - - Affected Components: * [{{% ctx %}} Innovation Core Application][] @@ -160,23 +158,12 @@ Affected Components: * [{{% ctx %}} Gateway][Gateway] - - - - - - - - - ##### Added configuration for maximum query string length With the introduction of the Operations Overview page, it is possible for the API used to return the aggregated data from the [Monitoring Service][{{% ctx %}} Monitoring Service], to exceed the default maximum number of characters allowed in the `query string` part of the URL. {{% ctx %}} Gateway `web.config` now includes settings allowing the maximum number of characters to be increased from the default value of `8192`. Currently, there is no documentation available on how to do this. For further assistance, please raise a case in the [{{% ctx %}} Service Portal][]. - - Affected Components: * [{{% ctx %}} Gateway][Gateway] @@ -185,8 +172,6 @@ Affected Components: The [{{% ctx %}} Interaction Portal][Interaction Portal] can now be installed multiple times on the same machine, each with its own configuration and data. - - Affected Components: * [{{% ctx %}} Interaction Portal][Interaction Portal] @@ -197,8 +182,6 @@ Affected Components: The maximum size of Service Fabric Logs has been reduced from `65GB` to `10GB`. - - Affected Components: * {{% ctx %}} App Server Install Scripts @@ -209,8 +192,6 @@ Affected Components: The performance of the Execution Management Service has been improved to handle high volumes of executions more efficiently. - - Affected Components: * [{{% ctx %}} Innovation Core Application][] @@ -220,8 +201,6 @@ Affected Components: The [{{% ctx %}} Interaction Portal][Interaction Portal] now handles session updates more reliably on slower systems. - - Affected Components: * [{{% ctx %}} Interaction Portal][Interaction Portal] @@ -232,8 +211,6 @@ Affected Components: The header size limit for the Service Fabric API Gateway has been increased from `32765 bytes` to `65536 bytes` to allow for larger headers to be processed. - - Affected Components: * [{{% ctx %}} Innovation Core Application][] @@ -245,8 +222,6 @@ Affected Components: The Content-Security-Policy directives on {{% ctx %}} Gateway have been reviewed and updated to ensure that they are secure. - - Affected Components: * [{{% ctx %}} Gateway][Gateway] @@ -255,8 +230,6 @@ Affected Components: The Permissions-Policy header on {{% ctx %}} Gateway has been introduced to improve security. - - Affected Components: * [{{% ctx %}} Gateway][Gateway] @@ -265,8 +238,6 @@ Affected Components: The X-XSS-PROTECTION header on {{% ctx %}} Gateway has been removed as it is deprecated. - - Affected Components: * [{{% ctx %}} Gateway][Gateway] @@ -277,8 +248,6 @@ Affected Components: A Health Check API has been added to the Service Fabric API Gateway to allow third-party load balancers to check the health of the platform. - - Affected Components: * [{{% ctx %}} Innovation Core Application][] @@ -296,12 +265,6 @@ The following 3rd party libraries have been updated on {{% ctx %}} Gateway: * Moment.js * Stacktrace.js - - - - - - Affected Components: * [{{% ctx %}} Gateway][Gateway] @@ -312,8 +275,6 @@ Affected Components: The installation script now checks for the presence of a certificate friendly name and throws an error if it is not present. - - Affected Components: * {{% ctx %}} Web App Server Install Scripts @@ -322,8 +283,6 @@ Affected Components: The installation script now uses PSDrive to improve compatibility with different environments. - - Affected Components: * {{% ctx %}} App Server Install Scripts @@ -334,8 +293,6 @@ Affected Components: The installation script now sets up log file rotation for RabbitMQ. The default is now a maximum of 20 files, each with a maximum size of 20MB. - - Affected Components: * {{% ctx %}} App Server Install Scripts @@ -345,8 +302,6 @@ Affected Components: RabbitMQ Stream ports (6000 to 6500) are now open to reduce noise in RabbitMQ logs. - - Affected Components: * {{% ctx %}} App Server Install Scripts @@ -358,8 +313,6 @@ Affected Components: The upgrade process now restores the files to their pre-upgrade state if the load balancer upgrade fails. - - Affected Components: * {{% ctx %}} Upgrade Scripts @@ -368,8 +321,6 @@ Affected Components: The timeout of the Register-ServiceFabricApplicationType command has been set to `1800 seconds`, like other commands. - - Affected Components: * {{% ctx %}} Upgrade Scripts @@ -378,8 +329,6 @@ Affected Components: The studio package created by the upgrade script now has the file extension `.studiopkg` in lower-case to be consistent with the documentation. - - Affected Components: * {{% ctx %}} Flows Upgrader @@ -389,8 +338,6 @@ Affected Components: The upgrade script now sets up log file rotation for RabbitMQ. The default is now a maximum of 20 files, each with a maximum size of 20MB. - - Affected Components: * {{% ctx %}} App Server Install Scripts @@ -400,8 +347,6 @@ Affected Components: RabbitMQ Stream ports (6000 to 6500) are now open to reduce noise in RabbitMQ logs. - - Affected Components: * {{% ctx %}} App Server Install Scripts @@ -413,20 +358,14 @@ Affected Components: The documentation now includes instructions on how to add the encryption key to the built-in Load Balancer server during both installation and upgrade. - - ##### Added Observability Compatibility table to release notes The [Observability Compatibility][] table has been added to the release notes. - - ##### Updated ports used by the platform The documentation has been updated to include the new ports used by the {{% ctx %}} platform for the [{{% ctx %}} Listeners Service][] including the Flow API Proxy. - - ### Bug Fixes #### Capability @@ -435,8 +374,6 @@ The documentation has been updated to include the new ports used by the {{% ctx A bug has been fixed where the Send Email Using Microsoft365 block would crash the Execution Service. - - Affected Components: * [{{% ctx %}} Innovation Execution Application][] @@ -447,8 +384,6 @@ Affected Components: A bug has been fixed where published packages containing nested flows at least three layers deep would throw a KeyNotFoundException when attempting to execute the third layer. - - Affected Components: * [{{% ctx %}} Innovation Execution Application][] @@ -458,8 +393,6 @@ Affected Components: A bug has been fixed where C# LINQ expressions defined in the Expression editor did not work. - - Affected Components: * [{{% ctx %}} Innovation Execution Application][] @@ -469,8 +402,6 @@ Affected Components: A bug has been fixed where an expression using the `Split()` method of a String data type would sometimes throw a runtime exception. - - Affected Components: * [{{% ctx %}} Innovation Execution Application][] @@ -482,8 +413,6 @@ Affected Components: A bug has been fixed where the LiveView datetime picker would not display correctly. - - Affected Components: * [{{% ctx %}} Gateway][Gateway] @@ -494,8 +423,6 @@ Affected Components: The installation script no longer imports the ServiceFabric PowerShell module when running the what-if command. - - Affected Components: * {{% ctx %}} App Server Install Scripts @@ -504,8 +431,6 @@ Affected Components: A bug has been fixed where updating the certificate would not update the load balancer health check subject name. - - ### Breaking Changes The following features have introduced breaking changes in the 2024.11 release of the {{% ctx %}} Platform: @@ -516,8 +441,6 @@ The following feature has changed both the {{% ctx %}} Interaction Portal flows If using the {{% ctx %}} Interaction Portal, it will need to be re-installed. For further assistance, please raise a case in the [{{% ctx %}} Service Portal][]. - - ### Known Limitations There are no known limitations added as part of the 2024.11 release of the {{% ctx %}} Platform. @@ -625,9 +548,11 @@ Releases are currently forecast to be made available on: [Scalability]: {{< ref "#scalability" >}} [increasing the header size limit for Service Fabric API Gateway]: {{< ref "#increased-the-header-size-limit-for-service-fabric-api-gateway" >}} [Security]: {{< ref "#security" >}} +[Usability]: {{< ref "#usability" >}} [Content-security-policy directives]: {{< ref "#reviewed-the-content-security-policy-directives-on-cortex-gateway" >}} [Permissions-Policy header]: {{< ref "#introduced-the-permissions-policy-header-on-cortex-gateway" >}} [X-XSS-PROTECTION header]: {{< ref "#removed-the-x-xss-protection-header-on-cortex-gateway" >}} +[fixing the LiveView datetime picker styling issues]: {{< ref "#liveview-datetime-picker-styling-issues" >}} [Third-party Support]: {{< ref "#third-party-support" >}} [Health Check API to Service Fabric API Gateway]: {{< ref "#added-health-check-api-to-service-fabric-api-gateway" >}} [Installation]: {{< ref "#installation" >}} diff --git a/content/en/docs/2024.11/Whats New/_index.md b/content/en/docs/2024.11/Whats New/_index.md index b9c72c75c..905a560e7 100644 --- a/content/en/docs/2024.11/Whats New/_index.md +++ b/content/en/docs/2024.11/Whats New/_index.md @@ -7,10 +7,11 @@ weight: 1 ## Summary -2024.9 is the second [Release][] of the next generation of {{% ctx %}} and improves on the [2024.7][] release in the following areas: +2024.11 is the next [Fast Track][] release of {{% ctx %}} and improves on the [2024.9][] release in the following areas: * [Capability][] * [Observability][] +* [Performance][] * [Scalability][] * [Security][] * [Usability][] @@ -23,69 +24,88 @@ weight: 1 This release introduces multiple new features to the {{% ctx %}} platform: -* The concept of [Process and Activity][], which are types of [Flow][], has now been introduced to {{% ctx %}} Gateway. -* [Saving Output Properties to multiple variables][] is now supported. -* A new built-in [execution context variable][] has been added to the Flow Engine which contains the initiator. -* A new [Proxy for the {{% ctx %}} 7 Flow API][] has been added to the platform. +* The [Monitoring Service has been introduced][] that provides aggregated historical data about the platform. +* The [Operations Overview page][] has been added to {{% ctx %}} Gateway to provide a high-level view of the system's operations, which includes: + * Current Status + * Filters + * Flow graphs +* The [configuration for maximum query string length][] has been added to the {{% ctx %}} Gateway `web.config`. +* The [Cortex Interaction Portal can now be installed multiple times on the same machine][]. ## Improved Observability -Observability has been improved by [adding logging to blocks that communicate with external systems][Logging added to blocks that communicate with external systems]. +Observability has been improved by [reducing the maximum size of Service Fabric Trace Logs][]. + +## Improved Performance + +The Performance of the {{% ctx %}} has been improved by: + +* optimising [handling high volumes of executions more efficiently][] +* handling [session updates more reliably on slower systems][] ## Improved Scalability -Optimisation to scalability has been made by [reducing the total number of NServiceBus endpoints and RabbitMQ queues][Reduction of total number of NServiceBus endpoints and RabbitMQ queues]. +Scalability has been enhanced by [increasing the header size limit for Service Fabric API Gateway][]. ## Improved Security -We increased the security of the platform by: +Security has been tightened on {{% ctx %}} Gateway by: -* [Upgrading the OpenSSL version][Upgrade OpenSSL] shipped with the platform. -* Added [Multi-domain certificates support][]. -* A [CortexManagementUser for RabbitMQ is now created during upgrade][New CortexManagementUser added to manage RabbitMQ queues]. -* [Server-side validation added to {{% ctx %}} Gateway API][] to prevent [Path Traversal][] attacks. -* Removal of the [refresh token cookie on sign out][remove refresh token cookie on sign out]. +* updating the [Content-security-policy directives][] +* introducing the [Permissions-Policy header][] +* removing the [X-XSS-PROTECTION header][] ## Improved Usability -The usability of the platform has been improved by: - -* Renaming the [Flows Charm to Dev and changing the icon][Rename Flows Charm to Dev and change icon]. -* Renaming the [Settings Charm to Admin and changing the icon][Rename Settings Charm to Admin and change icon]. +Usability has been improved by [fixing the LiveView datetime picker styling issues][]. ## Improved Third-Party Support -Third-party Support has been improved by [upgrading the platform to .NET 8][Upgrade to .NET 8]. +Third-party Support has been improved by: + +* adding a [Health Check API to Service Fabric API Gateway][] +* updating the following 3rd party libraries on {{% ctx %}} Gateway: + * Fuse + * jQuery + * jQuery UI + * Moment.js + * Stacktrace.js ## Improved Installation -Installation when [files are blocked by the operating system][Support installation when files are blocked by the operating system] due to the `Zone.Identifier` is now supported. +Installation has been modified to: + +* [check for certificate friendly name][] +* [use PSDrive to improve compatibility][] +* [allow log file rotation for RabbitMQ logs][] +* [open ports for RabbitMQ Stream][] ## Improved Upgrade -The upgrade process has been improved by: +Upgrade has been improved by: -* [Supporting upgrade when files are blocked by the operating system][Support upgrade when files are blocked by the operating system]. -* Upgrading the [Execution Service when the engine version is unchanged][Execution Service is upgraded when the engine version is unchanged]. -* [Handling of the Execution Services lifecycle events][]. +* [restoring files to pre-upgrade if the load balancer upgrade fails][] +* [aligning the timeout of the Register-ServiceFabricApplicationType command with other commands][] +* [changing the extension of the studio package created by the upgrade script][] +* [allow log file rotation for RabbitMQ logs][Upgrade - allow log file rotation for RabbitMQ logs] +* [opening ports for RabbitMQ Stream][Upgrade - opening ports for RabbitMQ Stream] ## Improved Documentation The documentation includes updates related to: -* New concepts such as [Process and Activity][Process and Activity Documentation] as well as [Decomposition of Output properties][]. -* [Preventing deadlocks when using semaphores][Prevent deadlocks when using semaphores]. -* [Updating screenshots][screenshots updated] to reflect the new branding. -* [Flow compatibility version][Flow compatibility version introduced] being added to the release notes. -* [General improvements to the documentation][]. +* [adding the encryption key to the built-in Load Balancer server][] +* [adding the Observability Compatibility table to release notes][] +* [updating the ports used by the platform][] -For a full list of what has been introduced in this release, please see the [2024.9 Release Notes][] +For a full list of what has been introduced in this release, please see the [2024.11 Release Notes][] -[Release]: {{< url path="Cortex.Reference.Glossary.P-T.Release" version="2024.9" >}} -[2024.7]: {{< url path="Cortex.Blogs.Releases.2024.7.MainDoc" version="2024.9" >}} +[Fast Track]: {{< url path="Cortex.Reference.Glossary.F-J.FastTrack" version="2024.11" >}} +[2024.9]: {{< url path="Cortex.Blogs.Releases.2024.9.MainDoc" version="2024.11" >}} [Capability]: {{< ref "#improved-capability" >}} [Observability]: {{< ref "#improved-observability" >}} +[Performance]: {{< ref "#improved-performance" >}} [Scalability]: {{< ref "#improved-scalability" >}} [Security]: {{< ref "#improved-security" >}} [Usability]: {{< ref "#improved-usability" >}} @@ -94,32 +114,30 @@ For a full list of what has been introduced in this release, please see the [202 [Upgrade]: {{< ref "#improved-upgrade" >}} [Documentation]: {{< ref "#improved-documentation" >}} -[Process and Activity]: {{< url path="Cortex.Blogs.Releases.2024.9.ProcessAndActivity" version="2024.9" >}} -[Saving Output Properties to multiple variables]: {{< url path="Cortex.Blogs.Releases.2024.9.SaveOutputPropertiesToMultipleVariables" version="2024.9" >}} -[execution context variable]: {{< url path="Cortex.Blogs.Releases.2024.9.ExecutionContextVariable" version="2024.9" >}} -[Proxy for the {{% ctx %}} 7 Flow API]: {{< url path="Cortex.Blogs.Releases.2024.9.ProxyForTheCortex7FlowApi" version="2024.9" >}} -[Logging added to blocks that communicate with external systems]: {{< url path="Cortex.Blogs.Releases.2024.9.LoggingAddedToBlocksThatCommunicateWithExternalSystems" version="2024.9" >}} -[Reduction of total number of NServiceBus endpoints and RabbitMQ queues]: {{< url path="Cortex.Blogs.Releases.2024.9.ReductionOfTotalNumberOfNServiceBusEndpointsAndRabbitMQQueues" version="2024.9" >}} -[Upgrade OpenSSL]: {{< url path="Cortex.Blogs.Releases.2024.9.UpgradeOpenSSL" version="2024.9" >}} -[Multi-domain certificates support]: {{< url path="Cortex.Blogs.Releases.2024.9.MultiDomainCertificatesSupport" version="2024.9" >}} -[New CortexManagementUser added to manage RabbitMQ queues]: {{< url path="Cortex.Blogs.Releases.2024.9.NewCortexManagementUserAddedToManageRabbitMQQueues" version="2024.9" >}} -[Server-side validation added to {{% ctx %}} Gateway API]: {{< url path="Cortex.Blogs.Releases.2024.9.ServerSideValidationAddedToCortexGatewayAPI" version="2024.9" >}} -[Remove refresh token cookie on sign out]: {{< url path="Cortex.Blogs.Releases.2024.9.RemoveRefreshTokenCookieOnSign" version="2024.9" >}} -[Rename Flows Charm to Dev and change icon]: {{< url path="Cortex.Blogs.Releases.2024.9.RenameFlowsCharmToDevAndChangeIcon" version="2024.9" >}} -[Rename Settings Charm to Admin and change icon]: {{< url path="Cortex.Blogs.Releases.2024.9.RenameSettingsCharmToAdminAndChangeIcon" version="2024.9" >}} -[Upgrade to .NET 8]: {{< url path="Cortex.Blogs.Releases.2024.9.UpgradeToNet8" version="2024.9" >}} -[Support installation when files are blocked by the operating system]: {{< url path="Cortex.Blogs.Releases.2024.9.SupportInstallationWhenFilesAreBlockedByTheOperatingSystem" version="2024.9" >}} -[Support upgrade when files are blocked by the operating system]: {{< url path="Cortex.Blogs.Releases.2024.9.SupportUpgradeWhenFilesAreBlockedByTheOperatingSystem" version="2024.9" >}} -[Execution Service is upgraded when the engine version is unchanged]: {{< url path="Cortex.Blogs.Releases.2024.9.ExecutionServiceIsUpgradedWhenTheEngineVersionIsUnchanged" version="2024.9" >}} -[Handling of the Execution Services lifecycle events]: {{< url path="Cortex.Blogs.Releases.2024.9.HandlingOfTheExecutionServicesLifecycleEvents" version="2024.9" >}} -[Process and Activity Documentation]: {{< url path="Cortex.Blogs.Releases.2024.9.ProcessAndActivityDocumentation" version="2024.9" >}} -[Decomposition of Output properties]: {{< url path="Cortex.Blogs.Releases.2024.9.DecompositionOfOutputProperties" version="2024.9" >}} -[Prevent deadlocks when using semaphores]: {{< url path="Cortex.Blogs.Releases.2024.9.PreventDeadlocksWhenUsingSemaphores" version="2024.9" >}} -[Screenshots updated]: {{< url path="Cortex.Blogs.Releases.2024.9.ScreenshotsUpdated" >}} -[Flow compatibility version introduced]: {{< url path="Cortex.Blogs.Releases.2024.9.FlowCompatibilityVersionIntroduced" version="2024.9" >}} -[General improvements to the documentation]: {{< url path="Cortex.Blogs.Releases.2024.9.GeneralImprovementsToTheDocumentation" version="2024.9" >}} - -[2024.9 Release Notes]: {{< url path="Cortex.Blogs.Releases.2024.9.MainDoc" version="2024.9" >}} - -[Flow]: {{< url path="Cortex.Reference.Concepts.Fundamentals.Flows.WhatIsAFlow.MainDoc" version="2024.9" >}} -[Path Traversal]: {{< url path="Owasp.PathTraversal.MainDoc" version="2024.9" >}} +[Monitoring Service has been introduced]: {{< url path="Cortex.Blogs.Releases.2024.11.MonitoringServiceHasBeenIntroduced" version="2024.11" >}} +[Operations Overview page]: {{< url path="Cortex.Blogs.Releases.2024.11.OperationsOverviewPage" version="2024.11" >}} +[configuration for maximum query string length]: {{< url path="Cortex.Blogs.Releases.2024.11.ConfigurationForMaximumQueryStringLength" version="2024.11" >}} +[Cortex Interaction Portal can now be installed multiple times on the same machine]: {{< url path="Cortex.Blogs.Releases.2024.11.CortexInteractionPortalCanNowBeInstalledMultipleTimesOnTheSameMachine" version="2024.11" >}} +[session updates more reliably on slower systems]: {{< url path="Cortex.Blogs.Releases.2024.11.SessionUpdatesMoreReliablyOnSlowerSystems" version="2024.11" >}} +[reducing the maximum size of Service Fabric Trace Logs]: {{< url path="Cortex.Blogs.Releases.2024.11.ReducingTheMaximumSizeOfServiceFabricTraceLogs" version="2024.11" >}} +[handling high volumes of executions more efficiently]: {{< url path="Cortex.Blogs.Releases.2024.11.HandlingHighVolumesOfExecutionsMoreEfficiently" version="2024.11" >}} +[increasing the header size limit for Service Fabric API Gateway]: {{< url path="Cortex.Blogs.Releases.2024.11.IncreasingTheHeaderSizeLimitForServiceFabricAPIGateway" version="2024.11" >}} +[Content-security-policy directives]: {{< url path="Cortex.Blogs.Releases.2024.11.ContentSecurityPolicyDirectives" version="2024.11" >}} +[Permissions-Policy header]: {{< url path="Cortex.Blogs.Releases.2024.11.PermissionsPolicyHeader" version="2024.11" >}} +[X-XSS-PROTECTION header]: {{< url path="Cortex.Blogs.Releases.2024.11.XXSSPROTECTIONHeader" version="2024.11" >}} +[fixing the LiveView datetime picker styling issues]: {{< url path="Cortex.Blogs.Releases.2024.11.FixingTheLiveViewDatetimePickerStylingIssues" version="2024.11" >}} +[Health Check API to Service Fabric API Gateway]: {{< url path="Cortex.Blogs.Releases.2024.11.HealthCheckAPIToServiceFabricAPIGateway" version="2024.11" >}} +[check for certificate friendly name]: {{< url path="Cortex.Blogs.Releases.2024.11.CheckForCertificateFriendlyName" version="2024.11" >}} +[use PSDrive to improve compatibility]: {{< url path="Cortex.Blogs.Releases.2024.11.UsePSDriveToImproveCompatibility" version="2024.11" >}} +[allow log file rotation for RabbitMQ logs]: {{< url path="Cortex.Blogs.Releases.2024.11.AllowLogFileRotationForRabbitMQLogs" version="2024.11" >}} +[open ports for RabbitMQ Stream]: {{< url path="Cortex.Blogs.Releases.2024.11.OpenPortsForRabbitMQStream" version="2024.11" >}} +[restoring files to pre-upgrade if the load balancer upgrade fails]: {{< url path="Cortex.Blogs.Releases.2024.11.RestoringFilesToPreUpgradeIfTheLoadBalancerUpgradeFails" version="2024.11" >}} +[aligning the timeout of the Register-ServiceFabricApplicationType command with other commands]: {{< url path="Cortex.Blogs.Releases.2024.11.AligningTheTimeoutOfTheRegisterServiceFabricApplicationTypeCommandWithOtherCommands" version="2024.11" >}} +[changing the extension of the studio package created by the upgrade script]: {{< url path="Cortex.Blogs.Releases.2024.11.ChangingTheExtensionOfTheStudioPackageCreatedByTheUpgradeScript" version="2024.11" >}} +[Upgrade - allow log file rotation for RabbitMQ logs]: {{< url path="Cortex.Blogs.Releases.2024.11.UpgradeAllowLogFileRotationForRabbitMQLogs" version="2024.11" >}} +[Upgrade - opening ports for RabbitMQ Stream]: {{< url path="Cortex.Blogs.Releases.2024.11.UpgradeOpeningPortsForRabbitMQStream" version="2024.11" >}} +[adding the encryption key to the built-in Load Balancer server]: {{< url path="Cortex.Blogs.Releases.2024.11.AddingTheEncryptionKeyToTheBuiltInLoadBalancerServer" version="2024.11" >}} +[adding the Observability Compatibility table to release notes]: {{< url path="Cortex.Blogs.Releases.2024.11.AddingTheObservabilityCompatibilityTableToReleaseNotes" version="2024.11" >}} +[updating the ports used by the platform]: {{< url path="Cortex.Blogs.Releases.2024.11.UpdatingThePortsUsedByThePlatform" version="2024.11" >}} + +[2024.11 Release Notes]: {{< url path="Cortex.Blogs.Releases.2024.11.MainDoc" version="2024.11" >}} diff --git a/data/urls.toml b/data/urls.toml index c444c0506..a93931ba2 100644 --- a/data/urls.toml +++ b/data/urls.toml @@ -8,6 +8,33 @@ MainDoc = "/blog/releases" [Cortex.Blogs.Releases.2024.X] MainDoc = "/blog/releases/2024.x" + [Cortex.Blogs.Releases.2024.11] + MainDoc = "/blog/2024/12/02/2024.11/" + MonitoringServiceHasBeenIntroduced = "/blog/2024/12/02/2024.11/#introduced-the-monitoring-service" + OperationsOverviewPage = "/blog/2024/12/02/2024.11/#introduced-the-operations-overview-page" + ConfigurationForMaximumQueryStringLength = "/blog/2024/12/02/2024.11/#added-configuration-for-maximum-query-string-length" + CortexInteractionPortalCanNowBeInstalledMultipleTimesOnTheSameMachine = "/blog/2024/12/02/2024.11/#added-support-for-multiple-instances-of-the-cortex-interaction-portal-running-on-the-same-machine" + SessionUpdatesMoreReliablyOnSlowerSystems = "/blog/2024/12/02/2024.11/#improved-session-update-reliability-on-slow-systems" + ReducingTheMaximumSizeOfServiceFabricTraceLogs = "/blog/2024/12/02/2024.11/#reduced-the-maximum-size-of-service-fabric-logs" + HandlingHighVolumesOfExecutionsMoreEfficiently = "/blog/2024/12/02/2024.11/#improved-the-performance-of-the-execution-management-service" + IncreasingTheHeaderSizeLimitForServiceFabricAPIGateway = "/blog/2024/12/02/2024.11/#increased-the-header-size-limit-for-service-fabric-api-gateway" + ContentSecurityPolicyDirectives = "/blog/2024/12/02/2024.11/#reviewed-the-content-security-policy-directives-on-cortex-gateway" + PermissionsPolicyHeader = "/blog/2024/12/02/2024.11/#introduced-the-permissions-policy-header-on-cortex-gateway" + XXSSPROTECTIONHeader = "/blog/2024/12/02/2024.11/#removed-the-x-xss-protection-header-on-cortex-gateway" + FixingTheLiveViewDatetimePickerStylingIssues = "/blog/2024/12/02/2024.11/#liveview-datetime-picker-styling-issues" + HealthCheckAPIToServiceFabricAPIGateway = "/blog/2024/12/02/2024.11/#added-health-check-api-to-service-fabric-api-gateway" + CheckForCertificateFriendlyName = "/blog/2024/12/02/2024.11/#added-check-for-certificate-friendly-name" + UsePSDriveToImproveCompatibility = "/blog/2024/12/02/2024.11/#changed-the-installation-script-to-use-psdrive-to-improve-compatibility" + AllowLogFileRotationForRabbitMQLogs = "/blog/2024/12/02/2024.11/#added-support-for-rabbitmq-log-file-rotation" + OpenPortsForRabbitMQStream = "/blog/2024/12/02/2024.11/#opened-ports-for-rabbitmq-stream" + RestoringFilesToPreUpgradeIfTheLoadBalancerUpgradeFails = "/blog/2024/12/02/2024.11/#improved-the-load-balancer-upgrade-process" + AligningTheTimeoutOfTheRegisterServiceFabricApplicationTypeCommandWithOtherCommands = "/blog/2024/12/02/2024.11/#aligned-the-timeout-of-the-register-servicefabricapplicationtype-command-with-other-commands" + ChangingTheExtensionOfTheStudioPackageCreatedByTheUpgradeScript = "/blog/2024/12/02/2024.11/#changed-the-extension-of-the-studio-package-created-by-the-upgrade-script" + UpgradeAllowLogFileRotationForRabbitMQLogs = "/blog/2024/12/02/2024.11/#added-support-for-rabbitmq-log-file-rotation-1" + UpgradeOpeningPortsForRabbitMQStream = "/blog/2024/12/02/2024.11/#opened-ports-for-rabbitmq-stream-1" + AddingTheEncryptionKeyToTheBuiltInLoadBalancerServer = "/blog/2024/12/02/2024.11/#added-how-to-add-the-encryption-key-to-the-built-in-load-balancer-server" + AddingTheObservabilityCompatibilityTableToReleaseNotes = "/blog/2024/12/02/2024.11/#added-observability-compatibility-table-to-release-notes" + UpdatingThePortsUsedByThePlatform = "/blog/2024/12/02/2024.11/#updated-ports-used-by-the-platform" [Cortex.Blogs.Releases.2024.9] MainDoc = "/blog/2024/10/07/2024.9/" ProcessAndActivity = "/blog/2024/10/07/2024.9/#process-and-activity"