diff --git a/.htmltest.yml b/.htmltest.yml index acfd6fec3..8500da2c8 100644 --- a/.htmltest.yml +++ b/.htmltest.yml @@ -30,6 +30,7 @@ IgnoreURLs: - "https://www.connectionstrings.com/.*" - "https://dotnet.microsoft.com/.*" - "https://scribehow.com/.*" +- "https://www.rabbitmq.com/.*" IgnoreDirs: - "docs/?.*/_print/" - "docs/?.*/_shared/" diff --git a/content/en/blog/releases/2025.X/2025.3.md b/content/en/blog/releases/2025.X/2025.3.md new file mode 100644 index 000000000..a6775328e --- /dev/null +++ b/content/en/blog/releases/2025.X/2025.3.md @@ -0,0 +1,530 @@ +--- +title: "2025.3" +linkTitle: "2025.3" +date: 2025-04-07 +author: Paul Arnold ([@paulmarnold](https://twitter.com/paulmarnold)) +--- + +## Summary + +The 2025.3 [Release][] is now available. + +## Download Artefacts + +Installation artefacts can be requested by raising a case in the [{{% ctx %}} Service Portal][]. + +## Release Notes + +### Overview + +2025.3 is the third [Release][] of the next generation of {{% ctx %}} and improves on the [2025.1][] release in the following areas: + +* Capability +* Scalability +* Security +* Usability +* Third-Party Support +* Documentation + +{{% cr %}} +This release introduces the following new feature to the {{% ctx %}} platform: + +* Support for [creating a new process from Natural Language][]. + +[Scalability][] has been enhanced by: + +* [enabling automated backups for disaster recovery][]. +* [removing old executions on Execution Service startup][]. +* [migrating RabbitMQ queues to Quorum Queues][]. + +We tightened the [Security][] of the platform with [general security enhancements][] and by adding support for a [configurable Global RunAs User for flows][]. + +Improvement to the [Usability][] of the Product Portal has been made by [improving the page load speed][] by [hiding unsupported versions of the documentation][]. + +The [Third-party components][] [RabbitMQ and Erlang have been upgraded][]. + +Finally, the [Documentation][] includes updates related to: + +* [Package Management][] +* [removal of "7.2" and "Innovation" from documentation][] + +### Components + +| Release Component | Version | Updated | Update Type | Breaking Change | Notes | +|--------------------------------------------------------------------------------|---------------|---------|---------------|-----------------|--------| +| [{{% ctx %}} Innovation Core Application][] | 57.2.1.25210 | Yes | Major | Potential | Major changes occurred between releases and are related to the upgrade of RabbitMQ and Erlang. This is a [potential breaking change][Potential Breaking - Upgrade of RabbitMQ and Erlang] because the upgrade requires a reinstallation, resulting in loss of high availability (HA) during the upgrade and existing reliable collection data | +|     > [{{% ctx %}} API Gateway Service][] | 41.1.1.25210 | Yes | Major | Potential | Major changes occurred between releases and are related to the upgrade of RabbitMQ and Erlang. This is a [potential breaking change][Potential Breaking - Upgrade of RabbitMQ and Erlang] because the upgrade requires a reinstallation, resulting in loss of high availability (HA) during the upgrade and existing reliable collection data | +|     > [{{% ctx %}} Authorisation Service][] | 8.0.1.25160 | Yes | Major | Potential | Major changes occurred between releases and are related to the upgrade of RabbitMQ and Erlang. This is a [potential breaking change][Potential Breaking - Upgrade of RabbitMQ and Erlang] because the upgrade requires a reinstallation, resulting in loss of high availability (HA) during the upgrade and existing reliable collection data | +|     > [{{% ctx %}} Concurrency Management Service][] | 8.0.1.25160 | Yes | Major | Potential | Major changes occurred between releases and are related to the upgrade of RabbitMQ and Erlang. This is a [potential breaking change][Potential Breaking - Upgrade of RabbitMQ and Erlang] because the upgrade requires a reinstallation, resulting in loss of high availability (HA) during the upgrade and existing reliable collection data | +|     > [{{% ctx %}} Configuration Management Service][] | 8.0.1.25160 | Yes | Major | Potential | Major changes occurred between releases and are related to the upgrade of RabbitMQ and Erlang. This is a [potential breaking change][Potential Breaking - Upgrade of RabbitMQ and Erlang] because the upgrade requires a reinstallation, resulting in loss of high availability (HA) during the upgrade and existing reliable collection data | +|     > [{{% ctx %}} Data Storage Service][] | 10.1.0.25210 | Yes | Major | Potential | Major changes occurred between releases and are related to the upgrade of RabbitMQ and Erlang. This is a [potential breaking change][Potential Breaking - Upgrade of RabbitMQ and Erlang] because the upgrade requires a reinstallation, resulting in loss of high availability (HA) during the upgrade and existing reliable collection data | +|     > [{{% ctx %}} Execution Management Service][] | 8.1.2.25210 | Yes | Major | Potential | Major changes occurred between releases and are related to the upgrade of RabbitMQ and Erlang. This is a [potential breaking change][Potential Breaking - Upgrade of RabbitMQ and Erlang] because the upgrade requires a reinstallation, resulting in loss of high availability (HA) during the upgrade and existing reliable collection data | +|     > [{{% ctx %}} Licence Management Service][] | 8.0.1.25160 | Yes | Major | Potential | Major changes occurred between releases and are related to the upgrade of RabbitMQ and Erlang. This is a [potential breaking change][Potential Breaking - Upgrade of RabbitMQ and Erlang] because the upgrade requires a reinstallation, resulting in loss of high availability (HA) during the upgrade and existing reliable collection data | +|     > [{{% ctx %}} Listeners Service][] | 4.0.1.25160 | Yes | Major | Potential | Major changes occurred between releases and are related to the upgrade of RabbitMQ and Erlang. This is a [potential breaking change][Potential Breaking - Upgrade of RabbitMQ and Erlang] because the upgrade requires a reinstallation, resulting in loss of high availability (HA) during the upgrade and existing reliable collection data | +|     > [{{% ctx %}} Monitoring Service][] | 3.0.2.25160 | Yes | Major | Potential | Major changes occurred between releases and are related to the upgrade of RabbitMQ and Erlang. This is a [potential breaking change][Potential Breaking - Upgrade of RabbitMQ and Erlang] because the upgrade requires a reinstallation, resulting in loss of high availability (HA) during the upgrade and existing reliable collection data | +|     > [{{% ctx %}} Package Management Service][] | 12.0.3.25210 | Yes | Major | Potential | Major changes occurred between releases and are related to the upgrade of RabbitMQ and Erlang. This is a [potential breaking change][Potential Breaking - Upgrade of RabbitMQ and Erlang] because the upgrade requires a reinstallation, resulting in loss of high availability (HA) during the upgrade and existing reliable collection data | +|     > [{{% ctx %}} Provisioning Service][] | 15.0.2.25160 | Yes | Major | Potential | Major changes occurred between releases and are related to the upgrade of RabbitMQ and Erlang. This is a [potential breaking change][Potential Breaking - Upgrade of RabbitMQ and Erlang] because the upgrade requires a reinstallation, resulting in loss of high availability (HA) during the upgrade and existing reliable collection data | +|     > [{{% ctx %}} Scheduling Service][] | 8.0.2.25160 | Yes | Major | Potential | Major changes occurred between releases and are related to the upgrade of RabbitMQ and Erlang. This is a [potential breaking change][Potential Breaking - Upgrade of RabbitMQ and Erlang] because the upgrade requires a reinstallation, resulting in loss of high availability (HA) during the upgrade and existing reliable collection data | +|     > [{{% ctx %}} Triggers Service][] | 12.0.2.25160 | Yes | Major | Potential | Major changes occurred between releases and are related to the upgrade of RabbitMQ and Erlang. This is a [potential breaking change][Potential Breaking - Upgrade of RabbitMQ and Erlang] because the upgrade requires a reinstallation, resulting in loss of high availability (HA) during the upgrade and existing reliable collection data | +| [{{% ctx %}} Innovation Execution Application][] | 26.4.0.25210 | Yes | Major | Potential | Major changes occurred between releases and are related to the upgrade of RabbitMQ and Erlang. This is a [potential breaking change][Potential Breaking - Upgrade of RabbitMQ and Erlang] because the upgrade requires a reinstallation, resulting in loss of high availability (HA) during the upgrade and existing reliable collection data | +|     > [{{% ctx %}} Execution Service][] | 26.4.0.25210 | Yes | Major | Potential | Major changes occurred between releases and are related to the upgrade of RabbitMQ and Erlang. This is a [potential breaking change][Potential Breaking - Upgrade of RabbitMQ and Erlang] because the upgrade requires a reinstallation, resulting in loss of high availability (HA) during the upgrade and existing reliable collection data | +| [{{% ctx %}} Gateway][Gateway], including [{{% ctx %}} Studio][] | 12.24.1.25210 | Yes | Minor | N/A | | +| [{{% ctx %}} Blocks Package][Blocks] | 48.4.1.25160 | Yes | Minor | N/A | | +| [{{% ctx %}} Interaction Portal][Interaction Portal] | 3.1.0.24470 | No | N/A | N/A | | +| {{% ctx %}} App Server Install Scripts | 5.2.10.25150 | Yes | Patch | N/A | | +|     > {{% ctx %}} App Server Backup | 1.0.0.25210 | No | N/A | N/A | | +|     > {{% ctx %}} App Server Recovery | 1.0.0.25210 | No | N/A | N/A | | +|     > {{% ctx %}} App Server Encryption Key Backup | 1.0.0.25210 | No | N/A | N/A | | +|     > {{% ctx %}} App Server Encryption Key Recovery | 1.0.0.25210 | No | N/A | N/A | | +| {{% ctx %}} Web App Server Install Scripts | 8.1.4.25220 | Yes | Patch | N/A | | +|     > {{% ctx %}} Web App Server Backup | 1.0.0.25160 | No | N/A | N/A | | +|     > {{% ctx %}} Web App Server Recovery | 1.0.0.25160 | No | N/A | N/A | | +| {{% ctx %}} Upgrade Scripts | 1.2.19.25150 | Yes | Patch | N/A | | +| {{% ctx %}} Licence Fingerprint Generator | 4.1.1.25130 | Yes | Patch | N/A | | +| {{% ctx %}} Encryption Key Generator | 2.0.0.24350 | No | N/A | N/A | | +| {{% ctx %}} Encryptor | 3.2.0.25160 | Yes | Minor | N/A | | +| {{% ctx %}} Flows Upgrader | 2.0.2.25220 | Yes | Patch | N/A | | +| {{% ctx %}} Observability | 3.0.0 | No | N/A | N/A | | + +### Features + +#### Capability + +##### Support for creating a new process from Natural Language + +Within [{{% ctx %}} Gateway][Gateway], the user can now create a new process by entering a description of what the process should do. +The system will then generate a new process using `OpenAi` based on the description provided. + +{{% alert title="Note" %}} +The generation of processes from `Natural Language` require subscription to the OpenAI API. +The `OpenAiKey` and `OpenAiModel` must be configured within {{< ahref path="Cortex.Guides.Gateway.MainDoc" version="2025.3" title="{{% ctx %}} Gateway" >}} `web.config`, and are encryptable, however there is currently no documentation available on how to do this. For further assistance, please raise a case in the {{< ahref path="Cortex.ServicePortal.MainDoc" version="2025.3" title="{{% ctx %}} Service Portal" >}}. +{{% /alert %}} + +Affected Components: + +* [{{% ctx %}} Gateway][Gateway] + +#### Scalability + +##### Enabled Automated Backups for Disaster Recovery + +Automated backups and on-demand recovery has been enabled for [Service Fabric][] and [{{% ctx%}} Gateway][Gateway]. + +| Component | Artefact | Backup Type | Recovery Type | +|--------------------------------|---------------------------------------------------------------------------------|-------------|---------------| +| [Service Fabric][] | Reliable collections of stateful services | Scheduled | On-Demand | +| [Service Fabric][] | AppSettings.json, Settings.xml, <service>Pkg.Manifest.<version>.xml | Scheduled | N/A | +| [Service Fabric][] | ClusterConfig.json | Scheduled | N/A | +| [{{% ctx %}} Gateway][Gateway] | Repository | Scheduled | On-Demand | +| [{{% ctx %}} Gateway][Gateway] | OpenAPI Specifications | Scheduled | On-Demand | +| [{{% ctx %}} Gateway][Gateway] | web.config | Scheduled | N/A | +| General | Encryption Key | On-Demand | On-Demand | + +{{% alert title="Note" %}} +Restores must be completed on a cluster with the same number of nodes and partitions, running the same version of {{% ctx %}}. +It can restored to the same or a different cluster to the cluster it was backed up on. +For further assistance, please raise a case in the {{< ahref path="Cortex.ServicePortal.MainDoc" version="2025.3" title="{{% ctx %}} Service Portal" >}}. +{{% /alert %}} + +Affected Components: + +* {{% ctx %}} App Server Install Scripts + * {{% ctx %}} App Server Backup + * {{% ctx %}} App Server Recovery + * {{% ctx %}} App Server Encryption Key Backup + * {{% ctx %}} App Server Encryption Key Recovery +* {{% ctx %}} Web App Server Install Scripts + * {{% ctx %}} Web App Server Backup + * {{% ctx %}} Web App Server Recovery + +##### Remove old executions on Execution Service startup + +The [{{% ctx %}} Execution Service][{{% ctx %}} Execution Service] will now remove old executions when it starts up as these executions cannot be resumed. + +Affected Components: + +* [{{% ctx %}} Innovation Core Application][] + * [{{% ctx %}} API Gateway Service][] + * [{{% ctx %}} Execution Management Service][] + * [{{% ctx %}} Monitoring Service][] + * [{{% ctx %}} Provisioning Service][] + * [{{% ctx %}} Scheduling Service][] + * [{{% ctx %}} Triggers Service][] +* [{{% ctx %}} Innovation Execution Application][] + * [{{% ctx %}} Execution Service][] + +##### Migrated RabbitMQ queues to Quorum Queues + +The RabbitMQ queues have been migrated to [Quorum Queues][] to improve reliability and performance. + +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 %}} Listeners Service][] + * [{{% ctx %}} Monitoring Service][] + * [{{% ctx %}} Package Management Service][] + * [{{% ctx %}} Provisioning Service][] + * [{{% ctx %}} Scheduling Service][] + * [{{% ctx %}} Triggers Service][] +* [{{% ctx %}} Innovation Execution Application][] + * [{{% ctx %}} Execution Service][] + +#### Security + +##### Configurable Global RunAs User for flows + +The [{{% ctx %}} Execution Service][{{% ctx %}} Execution Service] now supports a configurable Global RunAs User for flows. This allows the user to configure a RunAs user that all flows will run as, rather than using the Network Service. +RunAs user can be overwritten on a per block basis using the `Run As` [advanced block property][]. + +{{% alert title="Note" %}} +The `RunAsCredentials` must be configured within {{< ahref path="Cortex.Guides.CortexInnovation.ExecutionApplication.Services.ExecutionService.MainDoc" version="2025.3" title="{{% ctx %}} Execution Service" >}} `appsettings.json`, where the `UserName` must be encrypted, and `Password` and `Domain` are encryptable, however there is currently no documentation available on how to do this. +For further assistance, please raise a case in the {{< ahref path="Cortex.ServicePortal.MainDoc" version="2025.3" title="{{% ctx %}} Service Portal" >}}. +{{% /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 %}} Listeners Service][] + * [{{% ctx %}} Monitoring Service][] + * [{{% ctx %}} Package Management Service][] + * [{{% ctx %}} Provisioning Service][] + * [{{% ctx %}} Scheduling Service][] + * [{{% ctx %}} Triggers Service][] +* [{{% ctx %}} Innovation Execution Application][] + * [{{% ctx %}} Execution Service][] +* {{% ctx %}} Encryption Key Generator + +##### General Security enhancements + +Some general security enhancements has been made to [{{% ctx %}} Gateway][Gateway]. +For further information, please raise a case in the [{{% ctx %}} Service Portal][]. + +Affected Components: + +* [{{% ctx %}} Gateway][Gateway] + +#### Usability + +##### Improved page load speed of the Product Portal + +The {{% ctx %}} Product Portal has been updated to improve the page load speed, preventing page freeze. + +##### Unsupported versions of the documentation are now hidden + +The {{% ctx %}} Product Portal has been updated to hide unsupported versions of the documentation. + +#### Third-Party Support + +##### Upgrade of RabbitMQ and Erlang + +RabbitMQ and Erlang have been updated to the following versions. + +| Component | Version | +|-----------|---------| +| RabbitMQ | 4.0.3 | +| Erlang | 26.2.5 | + +Affected Components: + +* {{% ctx %}} App Server Install Scripts +* {{% ctx %}} Web App Server Install Scripts + +#### Documentation + +##### Added Package Management documentation + +The Package Management documentation has been added to the {{% ctx %}} Product Portal to include information about: + +* [Package Fundamentals][Fundamentals - Packages] +* [Package Management Overview][Guides - Packages Overview] +* [Package Definitions Grid][Guides - Package Definitions Grid] +* [Package Version Editor][Guides - Package Version Editor] + +This also includes [tutorials][Administration - Package Management] on how to use Package Management. + +##### Removed "7.2" and "Innovation" from documentation + +The {{% ctx %}} Product Portal has been updated to remove "7.2" and "Innovation" from the documentation. + +### Bug Fixes + +#### Capability + +##### Collections cache could fail to load if DataStorage service is unhealthy + +A bug has been fixed where the collections cache could fail to load if the [{{% ctx %}} Data Storage Service][] was unhealthy. + +Affected Components: + +* [{{% ctx %}} Innovation Core Application][] + * [{{% ctx %}} API Gateway Service][] + * [{{% ctx %}} Data Storage Service][] +* [{{% ctx %}} Innovation Execution Application][] + * [{{% ctx %}} Execution Service][] + +##### Control characters in SSH and Telnet response not completely cleaned + +A bug has been fixed where not all control characters were being cleaned from the input of the [SSH][] and [Telnet blocks][]. + +{{% alert title="Note" %}} +The `ControlCharactersToClean` option has now been exposed in the advanced block properties `Configuration Settings`, allowing it to be overwritten on a per block basis using the advanced `Configuration Settings` block property of the {{< ahref path="Cortex.Reference.Blocks.Ssh.ExecuteSshCommand.ExecuteSshCommandBlock.ConfigurationSettings" version="2025.3" title="SSH" >}} and {{< ahref path="Cortex.Reference.Blocks.Telnet.ExecuteTelnetCommand.ExecuteTelnetCommand.ConfigurationSettings" version="2025.3" title="Telnet blocks" >}}. +{{% /alert %}} + +Affected Components: + +* [{{% ctx %}} Gateway][Gateway] +* [{{% ctx %}} Block Packages][Blocks] + +#### Usability + +##### Running executions out of sync + +A bug has been fixed where executions that already finished were not removed from the list of running executions in the [{{% ctx %}} Execution Service][]. + +Affected Components: + +* [{{% ctx %}} Innovation Core Application][] + * [{{% ctx %}} Execution Management Service][] +* [{{% ctx %}} Innovation Execution Application][] + * [{{% ctx %}} Execution Service][] + +##### Unable to use List<Structure> type in expression + +A bug has been fixed where, under certain circumstances, the user was unable to use a variable of type `List` in an expression. + +Affected Components: + +* [{{% ctx %}} Gateway][Gateway] +* [{{% ctx %}} Innovation Execution Application][] + * [{{% ctx %}} Execution Service][] + +##### Runtime error when passing a dictionary as an input variable of a Run Flow block + +A bug has been fixed where, under certain circumstances, a runtime error was thrown when passing a dictionary as an input variable of a Run Flow block. + +Affected Components: + +* [{{% ctx %}} Gateway][Gateway] +* [{{% ctx %}} Innovation Execution Application][] + * [{{% ctx %}} Execution Service][] + +##### Flow not found due to a change in non concurrent collections + +A bug has been fixed where, under certain circumstances, a flow was not found due to a change in non concurrent collections. + +Affected Components: + +* [{{% ctx %}} Gateway][Gateway] +* [{{% ctx %}} Innovation Execution Application][] + * [{{% ctx %}} Execution Service][] + +#### Installation + +##### Gateway Installation Script failing to set permissions + +A bug has been fixed where the Gateway Install Script was failing to set permissions on the repository folder. + +Affected Components: + +* {{% ctx %}} Web App Server Install Scripts + +### Deprecated Features + +There are no features deprecated as part of the 2025.3 release of the {{% ctx %}} Platform. + +### Removed Features + +There are no features removed in the 2025.3 release of the {{% ctx %}} Platform. + +### Potential Breaking Changes + +The following may potentially break existing installations of the {{% ctx %}} Platform on upgrade: + +#### Upgrade of RabbitMQ and Erlang + +The upgrade of RabbitMQ and Erlang libraries may require uninstalling an re-installing the platform depending on the version of {{% ctx %}}. + +| Version | Breaking Change | +|--------------|-----------------| +| 2024.9 | Yes | +| 2024.9.25142 | Yes | +| 2024.9.25161 | No | +| 2025.1 | Yes | + +Re-installing will cause loss of existing reliable collection data. + +### Breaking Changes + +There are no known breaking changes as part of the 2025.3 release of the {{% ctx %}} Platform. + +### Known Limitations + +There are no known limitations added as part of the 2025.3 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.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 | + +### Flow Compatibility + +| Release | Compatibility Version | +|---------|-----------------------| +| 2025.3 | 31.24311 | +| 2025.1 | 31.24311 | +| 2024.11 | 31.24311 | +| 2024.9 | 31.24311 | +| 2024.7 | 31.24311 | +| 2024.5 | 31.24311 | +| 2024.3 | 30 | + +### Observability Compatibility + +| Release | Grafana Version | Grafana Loki Version | {{% ctx %}} Observability Version | +|---------|--------------------------|----------------------|-----------------------------------| +| 2025.3 | [10.4.1][Grafana 10.4.1] | [3.0.0][Loki 3.0.0] | [3.0.0][Observability 3.0.0] | +| 2025.1 | [10.4.1][Grafana 10.4.1] | [3.0.0][Loki 3.0.0] | [3.0.0][Observability 3.0.0] | +| 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 2025.3 platform or adding it to an existing 7.2 or 7.3 Installation see the guidance below; otherwise, if you are upgrading from an existing 2025.1 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 or 7.3 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 2025.1 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 | +|---------|----------------|-------------------------------------| +| 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="2025.3" >}} +[{{% ctx %}} API Gateway Service]: {{< url path="Cortex.Guides.CortexInnovation.CoreApplication.Services.ApiGatewayService.MainDoc" version="2025.3" >}} +[{{% ctx %}} Authorisation Service]: {{< url path="Cortex.Guides.CortexInnovation.CoreApplication.Services.AuthorisationService.MainDoc" version="2025.3" >}} +[{{% ctx %}} Concurrency Management Service]: {{< url path="Cortex.Guides.CortexInnovation.CoreApplication.Services.ConcurrencyManagementService.MainDoc" version="2025.3" >}} +[{{% ctx %}} Configuration Management Service]: {{< url path="Cortex.Guides.CortexInnovation.CoreApplication.Services.ConfigurationManagementService.MainDoc" version="2025.3" >}} +[{{% ctx %}} Data Storage Service]: {{< url path="Cortex.Guides.CortexInnovation.CoreApplication.Services.DataStorageService.MainDoc" version="2025.3" >}} +[{{% ctx %}} Execution Management Service]: {{< url path="Cortex.Guides.CortexInnovation.CoreApplication.Services.ExecutionManagementService.MainDoc" version="2025.3" >}} +[{{% ctx %}} Licence Management Service]: {{< url path="Cortex.Guides.CortexInnovation.CoreApplication.Services.LicenceManagementService.MainDoc" version="2025.3" >}} +[{{% ctx %}} Listeners Service]: {{< url path="Cortex.Guides.CortexInnovation.CoreApplication.Services.ListenersService.MainDoc" version="2025.3" >}} +[{{% ctx %}} Monitoring Service]: {{< url path="Cortex.Guides.CortexInnovation.CoreApplication.Services.MonitoringService.MainDoc" version="2025.3" >}} +[{{% ctx %}} Package Management Service]: {{< url path="Cortex.Guides.CortexInnovation.CoreApplication.Services.PackageManagementService.MainDoc" version="2025.3" >}} +[{{% ctx %}} Provisioning Service]: {{< url path="Cortex.Guides.CortexInnovation.CoreApplication.Services.ProvisioningService.MainDoc" version="2025.3" >}} +[{{% ctx %}} Scheduling Service]: {{< url path="Cortex.Guides.CortexInnovation.CoreApplication.Services.SchedulingService.MainDoc" version="2025.3" >}} +[{{% ctx %}} Triggers Service]: {{< url path="Cortex.Guides.CortexInnovation.CoreApplication.Services.TriggersService.MainDoc" version="2025.3" >}} +[{{% ctx %}} Innovation Execution Application]: {{< url path="Cortex.Guides.CortexInnovation.ExecutionApplication.MainDoc" version="2025.3" >}} +[{{% ctx %}} Execution Service]: {{< url path="Cortex.Guides.CortexInnovation.ExecutionApplication.Services.ExecutionService.MainDoc" version="2025.3" >}} +[Interaction Portal]: {{< url path="Cortex.Guides.CortexInteractionPortal.MainDoc" version="2025.3" >}} + +[creating a new process from Natural Language]: {{< ref "#support-for-creating-a-new-process-from-natural-language" >}} +[Scalability]: {{< ref "#scalability" >}} +[enabling automated backups for disaster recovery]: {{< ref "#enabled-automated-backups-for-disaster-recovery" >}} +[removing old executions on Execution Service startup]: {{< ref "#remove-old-executions-on-execution-service-startup" >}} +[migrating RabbitMQ queues to Quorum Queues]: {{< ref "#migrated-rabbitmq-queues-to-quorum-queues" >}} +[Security]: {{< ref "#security" >}} +[general security enhancements]: {{< ref "#general-security-enhancements" >}} +[configurable Global RunAs User for flows]: {{< ref "#configurable-global-runas-user-for-flows" >}} +[Usability]: {{< ref "#usability" >}} +[improving the page load speed]: {{< ref "#improved-page-load-speed-of-the-product-portal" >}} +[hiding unsupported versions of the documentation]: {{< ref "#unsupported-versions-of-the-documentation-are-now-hidden" >}} +[Third-party components]: {{< ref "#third-party-support" >}} +[RabbitMQ and Erlang have been upgraded]: {{< ref "#upgrade-of-rabbitmq-and-erlang" >}} +[Documentation]: {{< ref "#documentation" >}} +[Package Management]: {{< ref "#added-package-management-documentation" >}} +[removal of "7.2" and "Innovation" from documentation]: {{< ref "#removed-72-and-innovation-from-documentation" >}} + +[Potential Breaking - Upgrade of RabbitMQ and Erlang]: {{< ref "#upgrade-of-rabbitmq-and-erlang-1" >}} + +[Upgrade Instructions]: {{< ref "#upgrade-instructions" >}} + +[Blocks]: {{< url path="Cortex.Reference.Blocks.MainDoc" version="2025.3" >}} +[SSH]: {{< url path="Cortex.Reference.Blocks.Ssh.ExecuteSshCommand.ExecuteSshCommandBlock.ConfigurationSettings" version="2025.3" >}} +[Telnet blocks]: {{< url path="Cortex.Reference.Blocks.Telnet.ExecuteTelnetCommand.ExecuteTelnetCommand.ConfigurationSettings" version="2025.3" >}} + +[Service Fabric]: {{< url path="Cortex.Reference.Glossary.P-T.ServiceFabric" version="2025.3" >}} + +[Gateway]: {{< url path="Cortex.Guides.Gateway.MainDoc" version="2025.3" >}} +[advanced block property]: {{< url path="Cortex.Reference.Concepts.Fundamentals.Blocks.BlockProperties.AdvancedProperties.MainDoc" version="2025.3" >}} +[Fundamentals - Packages]: {{< url path="Cortex.Reference.Concepts.Fundamentals.Packages.WhatIsAPackage.MainDoc" version="2025.3" >}} +[Guides - Packages Overview]: {{< url path="Cortex.Guides.UserGuides.UserInterfaces.Gateway.Admin.Packages.Overview.MainDoc" version="2025.3" >}} +[Guides - Package Definitions Grid]: {{< url path="Cortex.Guides.UserGuides.UserInterfaces.Gateway.Admin.Packages.PackageDefinitionsGrid.MainDoc" version="2025.3" >}} +[Guides - Package Version Editor]: {{< url path="Cortex.Guides.UserGuides.UserInterfaces.Gateway.Admin.Packages.PackageVersionEditor.MainDoc" version="2025.3" >}} +[Administration - Package Management]: {{< url path="Cortex.Tutorials.Administration.PackageManagement.MainDoc" version="2025.3" >}} + +[Innovation Only - Single Server - Without HA]: {{< url path="Cortex.GettingStarted.OnPremise.InstallInnovationOnly.SingleServerWithoutHA.MainDoc" version="2025.3" >}} +[Innovation Only - Multiple Server - With HA]: {{< url path="Cortex.GettingStarted.OnPremise.InstallInnovationOnly.MultipleServerWithHA.MainDoc" version="2025.3" >}} + +[Adding Innovation to a 7.2 Installation - Single Server - Without HA]: {{< url path="Cortex.GettingStarted.OnPremise.AddInnovationTo72.SingleServerWithoutHA.MainDoc" version="2025.3" >}} +[Adding Innovation to a 7.2 Installation - Multiple Server - With HA]: {{< url path="Cortex.GettingStarted.OnPremise.AddInnovationTo72.MultipleServerWithHA.MainDoc" version="2025.3" >}} + +[Upgrade - Single Server - Without HA]: {{< url path="Cortex.Guides.UpgradeGuides.UpgradeCortex.2025.1to2025.3.SingleServerWithoutHA.MainDoc" version="2025.3" >}} +[Upgrade - Multiple Server - With HA]: {{< url path="Cortex.Guides.UpgradeGuides.UpgradeCortex.2025.1to2025.3.MultipleServerWithHA.MainDoc" version="2025.3" >}} + +[{{% ctx %}} Studio]: {{< url path="Cortex.Guides.Studio.MainDoc" version="2025.3" >}} + +[{{% ctx %}} Service Portal]: {{< url path="Cortex.ServicePortal.MainDoc" version="2025.3" >}} + +[Fast Track]: {{< url path="Cortex.Reference.Glossary.F-J.FastTrack" version="2025.3" >}} +[Release]: {{< url path="Cortex.Reference.Glossary.P-T.Release" version="2025.3" >}} + +[2025.1]: {{< url path="Cortex.Blogs.Releases.2025.1.MainDoc" >}} + +[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.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" >}} +[Quorum Queues]: {{< url path="RabbitMQ.QuorumQueues.MainDoc" >}} diff --git a/content/en/docs/2025.3/Reference/Blocks/ssh/execute-ssh-command/execute-ssh-command-block.md b/content/en/docs/2025.3/Reference/Blocks/ssh/execute-ssh-command/execute-ssh-command-block.md index de8e7b439..721ccefbe 100644 --- a/content/en/docs/2025.3/Reference/Blocks/ssh/execute-ssh-command/execute-ssh-command-block.md +++ b/content/en/docs/2025.3/Reference/Blocks/ssh/execute-ssh-command/execute-ssh-command-block.md @@ -182,6 +182,7 @@ new Dictionary { { "Timeout", "60" }, { "EndOfLineCharacters", "\r" }, { "CancelCommand", "CtrlC" }, + { "ControlCharactersToClean", @"\e([^\[\]]|\[.*?[a-zA-Z]|\].*?\a)(g?)|[\x00-\x09\x0B\x0C\x0E-\x1F\x7F]" }, } ``` diff --git a/content/en/docs/2025.3/Reference/Blocks/telnet/execute-telnet-command/execute-telnet-command-block.md b/content/en/docs/2025.3/Reference/Blocks/telnet/execute-telnet-command/execute-telnet-command-block.md index 49633fc0f..865511403 100644 --- a/content/en/docs/2025.3/Reference/Blocks/telnet/execute-telnet-command/execute-telnet-command-block.md +++ b/content/en/docs/2025.3/Reference/Blocks/telnet/execute-telnet-command/execute-telnet-command-block.md @@ -129,6 +129,7 @@ new Dictionary { { "Timeout", "60" }, { "EndOfLineCharacters", "\r\n" }, { "CancelCommand", "CtrlC" }, + { "ControlCharactersToClean", @"\e([^\[\]]|\[.*?[a-zA-Z]|\].*?\a)(g?)|[\x00-\x09\x0B\x0C\x0E-\x1F\x7F]" }, } ``` diff --git a/content/en/docs/2025.3/Whats New/_index.md b/content/en/docs/2025.3/Whats New/_index.md index e9b6d6a89..f4ea8317d 100644 --- a/content/en/docs/2025.3/Whats New/_index.md +++ b/content/en/docs/2025.3/Whats New/_index.md @@ -7,88 +7,75 @@ weight: 1 ## Summary -2025.1 is the next [Fast Track][] release of {{% ctx %}} and improves on the [2024.11][] release in the following areas: +2025.3 is the third [Release][] of the next generation of {{% ctx %}} and improves on the [2025.1][] release in the following areas: * [Capability][] -* [Observability][] -* [Performance][] * [Scalability][] * [Security][] * [Usability][] * [Third-Party Support][] -* [Installation][] +* [Documentation][] ## Improved Capability -This release introduces the following new features to the {{% ctx %}} platform: +This release introduces the following new feature to the {{% ctx %}} platform: -* The user can now [create a new process from BPMN XML][] within [{{% ctx %}} Gateway][Gateway] -* An [Average Duration graph has been added][] to the Operations Overview page on [{{% ctx %}} Gateway][Gateway] - -## Improved Observability - -All services have had the [default size of logs][] used for Observability reduced to optimise disk usage. - -## Improved Performance - -Work has been undertaken to [improve the performance][] of the [{{% ctx %}} Execution][{{% ctx %}} Execution Service] and [{{% ctx %}} Monitoring][{{% ctx %}} Monitoring Service] services. +* Support for [creating a new process from Natural Language][]. ## Improved Scalability -The [Service Fabric BackUpRestore service has been enabled][] to allow future Scalability improvements such as disaster recovery features. +Scalability has been enhanced by: -## Improved Security +* [enabling automated backups for disaster recovery][]. +* [removing old executions on Execution Service startup][]. +* [migrating RabbitMQ queues to Quorum Queues][]. -Security has been tightened on the [{{% ctx %}} Interaction Portal][Interaction Portal] by: +## Improved Security -* [Introducing security headers][] -* [Removing sensitive information from HTTP responses][] +We tightened the security of the platform with [general security enhancements][] and by adding support for a [configurable Global RunAs User for flows][]. ## Improved Usability -Usability has been enhanced by: - -* [Improving the user experience on the Operations Overview page][] -* [Adding the {{% ctx %}} Version to the Gateway logo tooltip][] -* [Redesigning the Semaphore API][Redesigning the Semaphore API] allowing easier management of Semaphores +Improvement to the usability of the Product Portal has been made by [improving the page load speed][] by [hiding unsupported versions of the documentation][]. ## Improved Third-Party Support -[Third-party libraries has been updated][] on the {{% ctx %}} platform. +The third-party components [RabbitMQ and Erlang have been upgraded][]. + +## Improved Documentation -## Improved Installation +The documentation includes updates related to: -The Installation has been improved by [adding an unblock script][] to the installation process. +* [Package Management][] +* [removal of "7.2" and "Innovation" from documentation][] -For a full list of what has been introduced in this release, please see the [2025.1 Release Notes][] +For a full list of what has been introduced in this release, please see the [2025.3 Release Notes][] -[Fast Track]: {{< url path="Cortex.Reference.Glossary.F-J.FastTrack" version="2025.1" >}} -[2024.11]: {{< url path="Cortex.Blogs.Releases.2024.11.MainDoc" version="2025.1" >}} -[Gateway]: {{< url path="Cortex.Guides.Gateway.MainDoc" version="2025.1" >}} -[{{% ctx %}} Execution Service]: {{< url path="Cortex.Guides.CortexInnovation.ExecutionApplication.Services.ExecutionService.MainDoc" version="2025.1" >}} -[{{% ctx %}} Monitoring Service]: {{< url path="Cortex.Guides.CortexInnovation.CoreApplication.Services.MonitoringService.MainDoc" version="2025.1" >}} -[Interaction Portal]: {{< url path="Cortex.Guides.CortexInteractionPortal.MainDoc" version="2025.1" >}} +[Release]: {{< url path="Cortex.Reference.Glossary.P-T.Release" version="2025.3" >}} +[2025.1]: {{< url path="Cortex.Blogs.Releases.2025.1.MainDoc" version="2025.3" >}} [Capability]: {{< ref "#improved-capability" >}} -[Observability]: {{< ref "#improved-observability" >}} -[Performance]: {{< ref "#improved-performance" >}} [Scalability]: {{< ref "#improved-scalability" >}} [Security]: {{< ref "#improved-security" >}} [Usability]: {{< ref "#improved-usability" >}} [Third-Party Support]: {{< ref "#improved-third-party-support" >}} -[Installation]: {{< ref "#improved-installation" >}} - -[2025.1 Release Notes]: {{< url path="Cortex.Blogs.Releases.2025.1.MainDoc" version="2025.1" >}} - -[create a new process from BPMN XML]: {{< url path="Cortex.Blogs.Releases.2025.1.CreateANewProcessFromBpmnXml" version="2025.1" >}} -[Average Duration graph has been added]: {{< url path="Cortex.Blogs.Releases.2025.1.AverageDurationGraphHasBeenAdded" version="2025.1" >}} -[default size of logs]: {{< url path="Cortex.Blogs.Releases.2025.1.DefaultSizeOfLogs" version="2025.1" >}} -[improve the performance]: {{< url path="Cortex.Blogs.Releases.2025.1.ImproveThePerformance" version="2025.1" >}} -[Service Fabric BackUpRestore service has been enabled]: {{< url path="Cortex.Blogs.Releases.2025.1.ServiceFabricBackUpRestoreServiceHasBeenEnabled" version="2025.1" >}} -[Introducing security headers]: {{< url path="Cortex.Blogs.Releases.2025.1.IntroducingSecurityHeaders" version="2025.1" >}} -[Removing sensitive information from HTTP responses]: {{< url path="Cortex.Blogs.Releases.2025.1.RemovingSensitiveInformationFromHttpResponses" version="2025.1" >}} -[Improving the user experience on the Operations Overview page]: {{< url path="Cortex.Blogs.Releases.2025.1.ImprovingTheUserExperienceOnTheOperationsOverviewPage" version="2025.1" >}} -[Adding the {{% ctx %}} Version to the Gateway logo tooltip]: {{< url path="Cortex.Blogs.Releases.2025.1.AddingTheCortexVersionToTheGatewayLogoTooltip" version="2025.1" >}} -[Redesigning the Semaphore API]: {{< url path="Cortex.Blogs.Releases.2025.1.RedesigningTheSemaphoreApi" version="2025.1" >}} -[Third-party libraries has been updated]: {{< url path="Cortex.Blogs.Releases.2025.1.ThirdPartyLibrariesHasBeenUpdated" version="2025.1" >}} -[adding an unblock script]: {{< url path="Cortex.Blogs.Releases.2025.1.AddingAnUnblockScript" version="2025.1" >}} +[Documentation]: {{< ref "#improved-documentation" >}} + +[2025.3 Release Notes]: {{< url path="Cortex.Blogs.Releases.2025.3.MainDoc" version="2025.3" >}} + +[creating a new process from Natural Language]: {{< url path="Cortex.Blogs.Releases.2025.3.CreatingANewProcessFromNaturalLanguage" version="2025.3" >}} + +[enabling automated backups for disaster recovery]: {{< url path="Cortex.Blogs.Releases.2025.3.EnablingAutomatedBackupsForDisasterRecovery" version="2025.3" >}} +[removing old executions on Execution Service startup]: {{< url path="Cortex.Blogs.Releases.2025.3.RemovingOldExecutionsOnExecutionServiceStartup" version="2025.3" >}} +[migrating RabbitMQ queues to Quorum Queues]: {{< url path="Cortex.Blogs.Releases.2025.3.MigratingRabbitMqQueuesToQuorumQueues" version="2025.3" >}} + +[general security enhancements]: {{< url path="Cortex.Blogs.Releases.2025.3.GeneralSecurityEnhancements" version="2025.3" >}} +[configurable Global RunAs User for flows]: {{< url path="Cortex.Blogs.Releases.2025.3.ConfigurableGlobalRunAsUserForFlows" version="2025.3" >}} + +[improving the page load speed]: {{< url path="Cortex.Blogs.Releases.2025.3.ImprovingThePageLoadSpeed" version="2025.3" >}} +[hiding unsupported versions of the documentation]: {{< url path="Cortex.Blogs.Releases.2025.3.HidingUnsupportedVersionsOfTheDocumentation" version="2025.3" >}} + +[RabbitMQ and Erlang have been upgraded]: {{< url path="Cortex.Blogs.Releases.2025.3.RabbitMqAndErlangHaveBeenUpgraded" version="2025.3" >}} + +[Package Management]: {{< url path="Cortex.Blogs.Releases.2025.3.PackageManagement" version="2025.3" >}} +[removal of "7.2" and "Innovation" from documentation]: {{< url path="Cortex.Blogs.Releases.2025.3.RemovalOf7.2AndInnovationFromDocumentation" version="2025.3" >}} \ No newline at end of file diff --git a/data/urls.toml b/data/urls.toml index 7f033d06c..5f61f847a 100644 --- a/data/urls.toml +++ b/data/urls.toml @@ -22,6 +22,19 @@ RedesigningTheSemaphoreApi = "/blog/2025/02/10/2025.1/#redesigned-semaphore-api" ThirdPartyLibrariesHasBeenUpdated = "/blog/2025/02/10/2025.1/#updated-third-party-libraries" AddingAnUnblockScript = "/blog/2025/02/10/2025.1/#added-unblock-script-to-the-installation" + [Cortex.Blogs.Releases.2025.3] + MainDoc = "/blog/2025/04/07/2025.3/" + CreatingANewProcessFromNaturalLanguage = "/blog/2025/04/07/2025.3/#support-for-creating-a-new-process-from-natural-language" + EnablingAutomatedBackupsForDisasterRecovery = "/blog/2025/04/07/2025.3/#enabled-automated-backups-for-disaster-recovery" + RemovingOldExecutionsOnExecutionServiceStartup = "/blog/2025/04/07/2025.3/#remove-old-executions-on-execution-service-startup" + MigratingRabbitMqQueuesToQuorumQueues = "/blog/2025/04/07/2025.3/#migrated-rabbitmq-queues-to-quorum-queues" + GeneralSecurityEnhancements = "/blog/2025/04/07/2025.3/#general-security-enhancements" + ConfigurableGlobalRunAsUserForFlows = "/blog/2025/04/07/2025.3/#configurable-global-runas-user-for-flows" + ImprovingThePageLoadSpeed = "/blog/2025/04/07/2025.3/#improved-page-load-speed-of-the-product-portal" + HidingUnsupportedVersionsOfTheDocumentation = "/blog/2025/04/07/2025.3/#unsupported-versions-of-the-documentation-are-now-hidden" + RabbitMqAndErlangHaveBeenUpgraded = "/blog/2025/04/07/2025.3/#upgrade-of-rabbitmq-and-erlang" + PackageManagement = "/blog/2025/04/07/2025.3/#added-package-management-documentation" + RemovalOf7.2AndInnovationFromDocumentation = "/blog/2025/04/07/2025.3/#removed-72-and-innovation-from-documentation" [Cortex.Blogs.Releases.2024.X] MainDoc = "/blog/releases/2024.x" [Cortex.Blogs.Releases.2024.11] @@ -3157,6 +3170,8 @@ MainDoc = "https://www.postman.com/downloads/" [RabbitMQ] MainDoc = "https://www.rabbitmq.com/" + [RabbitMQ.QuorumQueues] + MainDoc = "https://www.rabbitmq.com/docs/quorum-queues" [RFC] UriInvalidCharacters = "https://www.rfc-editor.org/rfc/rfc3986#section-2" ProblemDetails = "https://www.rfc-editor.org/rfc/rfc7807"