Skip to content

Commit bed2f95

Browse files
author
Donna-Marie Smith
committed
Updated Code Analyser sections
1 parent de5b78e commit bed2f95

File tree

14 files changed

+108
-110
lines changed

14 files changed

+108
-110
lines changed

content/en/docs/2025.5/Guides/upgrade-guides/upgrade-cortex/2025.3-to-2025.5/multiple-server-with-ha/upgrade/upgrade-application-and-loadbalancer-servers.md

Lines changed: 12 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -9,10 +9,6 @@ weight: 30
99

1010
This guide describes how to upgrade the Application Servers and Load Balancer Server from 2025.3 to 2025.5. Please ensure that the [Pre-Upgrade][PreUpgrade] steps have been completed before starting this upgrade.
1111

12-
{{% alert title="Warning" color="warning" %}}
13-
Due to breaking changes required for upgrading RabbitMQ from version 3 to version 4 the Application Servers need to be reinstalled rather than upgraded. As a result packages will need to be republished and Configuration Portal data will need to be backed up and restored. Other data stored in Reliable Collections (e.g., data storage collections and semaphores) will be lost.
14-
{{% /alert %}}
15-
1612
## Configure Upgrade Script
1713

1814
1. In the `Cortex Innovation 2025.5 - App Server Install Scripts\Upgrade Application Server` folder, locate the `Cortex.Innovation.Upgrade.ps1` script and open it with a text editor.
@@ -59,32 +55,23 @@ To check the previous configuration values open the `Cortex.Upgrade.ApplicationC
5955

6056
{{< section "/upgrade/2025.5/upgrade-application-server/multi-server/run-upgrade-script.md" >}}
6157

62-
## Check Application Services
58+
## Configure {{% ctx %}} Code Analyser
6359

64-
{{< section "/upgrade/upgrade-application-server/multi-server/check-application-services.md" >}}
60+
{{< section "/upgrade/upgrade-application-server/configure-code-analyser.md" >}}
6561

66-
## Disable Whitelist Analyser
62+
### Update Code Analyser Allowed List
6763

68-
{{< alert type="note" title="Note" >}} This release introduces a Whitelist Analyser to prevent unauthorised execution of namespaces. This step only needs to happen if the Whitelist Analyser should be disabled.{{< /alert >}}
64+
{{< section "/upgrade/upgrade-application-server/update-code-analyser.md" >}}
6965

70-
On each of the Application Servers:
66+
### Disable Code Analyser
7167

72-
1. Open a File Explorer.
73-
1. Navigate to `%ProgramData%\SF\<CustomerName>.<NodeName>\Fabric\work\Applications\Cortex.Innovation.Execution_App1\ExecutionPkg.Code.*` replacing `<CustomerName>` with the Customer Name and `<NodeName>` with the NETBIOS name of the Application Server configured during installation.
74-
{{% alert title="Note" %}}
75-
To check the values to be used open the `Cortex.Upgrade.ApplicationConfig.json` file located in `%ProgramData%\Cortex\Upgrade`.
76-
{{% /alert %}}
77-
1. Open the `appsettings.json` file in a text editor.
78-
1. Locate the `"FeatureFlags"` line located under `"ExecutionEngine"` and set the value to `["f4fd94c0-a921-4b34-b82c-378b05e91555"]`.
79-
1. Save and close the file.
80-
1. In the File Explorer, navigate to `%ProgramData%\SF\<CustomerName>.<NodeName>\Fabric\work\ImageCache\Store\Cortex.Innovation.Execution\ExecutionPkg.Code.*` replacing `<CustomerName>` with the Customer Name and `<NodeName>` with the NETBIOS name of the Application Server specified in step 2.
81-
1. Repeat steps 3 - 5.
82-
1. Open a web browser.
83-
1. Navigate to `https://server.domain.com:9080/Explorer`, where `server.domain.com` is the fully qualified domain name of one of the application servers. Replace `9080` with new `httpGatewayEndpointPort` value if it was changed during configuration of the original installation.
84-
1. Expand `Cluster` then `Nodes`.
85-
1. Restart the current node by clicking on the drop down menu next to the node name and select `Restart`. Confirm node restart by following the on-screen instructions.
86-
87-
Once all nodes have been updated and restarted, it will be necessary to [re-check the Application Services][Check Application Services] to ensure that the nodes have re-started correctly.
68+
On each of the the Application Servers:
69+
70+
{{< section "/upgrade/2025.5/upgrade-application-server/multi-server/disable-code-analyser.md" >}}
71+
72+
## Check Application Services
73+
74+
{{< section "/upgrade/upgrade-application-server/multi-server/check-application-services.md" >}}
8875

8976
## Preserve installation files
9077

content/en/docs/2025.5/Guides/upgrade-guides/upgrade-cortex/2025.3-to-2025.5/multiple-server-with-ha/upgrade/upgrade-web-application-server/upgrade-cip.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ This guide describes how to upgrade {{% ctx %}} Interaction Portal. Please ensur
1111

1212
## Perform Upgrade
1313

14-
No upgrade required
14+
{{< section "/upgrade/2025.5/upgrade-web-application-server/upgrade-cortex-interaction-portal.md" >}}
1515

1616
## Next Steps?
1717

content/en/docs/2025.5/Guides/upgrade-guides/upgrade-cortex/2025.3-to-2025.5/multiple-server-with-ha/upgrade/upgrade-web-application-server/upgrade-debugger.md

Lines changed: 11 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -17,32 +17,23 @@ This guide describes how to upgrade the Flow Debugger on the Web Application Ser
1717

1818
{{< section "/upgrade/2025.5/upgrade-application-server/single-server/run-upgrade-script.md">}}
1919

20-
## Check Application Services
20+
## Configure {{% ctx %}} Code Analyser
2121

22-
{{< section "/upgrade/upgrade-application-server/single-server/check-application-services.md">}}
22+
{{< section "/upgrade/upgrade-application-server/configure-code-analyser.md" >}}
2323

24-
## Disable Whitelist Analyser
24+
### Update Code Analyser Allowed List
2525

26-
{{< alert type="note" title="Note" >}} This release introduces a Whitelist Analyser to prevent unauthorised execution of namespaces. This step only needs to happen if the Whitelist Analyser should be disabled and has also been disabled on on the Application Servers.{{< /alert >}}
26+
{{< section "/upgrade/upgrade-application-server/update-code-analyser.md" >}}
27+
28+
### Disable Code Analyser
2729

2830
On the Web Application Server:
2931

30-
1. Open a File Explorer.
31-
1. Navigate to `%ProgramData%\SF\<CustomerName>.<NodeName>\Fabric\work\Applications\Cortex.Innovation.Execution_App1\ExecutionPkg.Code.*` replacing `<CustomerName>` with the Customer Name and `<NodeName>` with the NETBIOS name of the Web Application Server configured during installation.
32-
{{% alert title="Note" %}}
33-
To check the values to be used open the `Cortex.Upgrade.ApplicationConfig.json` file located in `%ProgramData%\Cortex\Upgrade`.
34-
{{% /alert %}}
35-
1. Open the `appsettings.json` file in a text editor.
36-
1. Locate the `"FeatureFlags"` line located under `"ExecutionEngine"` and set the value to `["f4fd94c0-a921-4b34-b82c-378b05e91555"]`.
37-
1. Save and close the file.
38-
1. In the File Explorer, navigate to `%ProgramData%\SF\<CustomerName>.<NodeName>\Fabric\work\ImageCache\Store\Cortex.Innovation.Execution\ExecutionPkg.Code.*` replacing `<CustomerName>` with the Customer Name and `<NodeName>` with the NETBIOS name of the Web Application Server specified in step 2.
39-
1. Repeat steps 3 - 5.
40-
1. Open a web browser.
41-
1. Navigate to `https://server.domain.com:9080/Explorer`, where `server.domain.com` is the fully qualified domain name of the Web Application Server. Replace `9080` with new `httpGatewayEndpointPort` value if it was changed during configuration of the original installation.
42-
1. Expand `Cluster` then `Nodes`.
43-
1. Restart the node by clicking on the drop down menu next to the node name and select `Restart`. Confirm node restart by following the on-screen instructions.
44-
45-
Once the node has been updated and restarted, it will be necessary to [re-check the Application Services][Check Application Services] to ensure that the node has re-started correctly.
32+
{{< section "/upgrade/2025.5/upgrade-application-server/single-server/disable-code-analyser-debugger.md" >}}
33+
34+
## Check Application Services
35+
36+
{{< section "/upgrade/upgrade-application-server/single-server/check-application-services.md">}}
4637

4738
## Preserve installation files
4839

content/en/docs/2025.5/Guides/upgrade-guides/upgrade-cortex/2025.3-to-2025.5/single-server-without-ha/pre-upgrade.md

Lines changed: 0 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -13,12 +13,6 @@ This guide describes how to perform the steps required before starting the upgra
1313

1414
{{< section "/upgrade/2025.5/pre-upgrade/single-server/make-artefacts-available.md">}}
1515

16-
## Backup Configuration Portal Data
17-
18-
If using the {{% ctx %}} Configuration Portal, the data will need to be backed up.
19-
20-
For further assistance, please raise a case in the [{{% ctx %}} Service Portal][].
21-
2216
## Next Steps?
2317

2418
1. [Upgrade][]

content/en/docs/2025.5/Guides/upgrade-guides/upgrade-cortex/2025.3-to-2025.5/single-server-without-ha/upgrade/upgrade-application-server.md

Lines changed: 11 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -21,32 +21,23 @@ The Application Server will be reinstalled as part of the upgrade. As a result p
2121

2222
{{< section "/upgrade/2025.5/upgrade-application-server/single-server/run-upgrade-script.md" >}}
2323

24-
## Check Application Services
24+
## Configure {{% ctx %}} Code Analyser
2525

26-
{{< section "/upgrade/upgrade-application-server/single-server/check-application-services.md" >}}
26+
{{< section "/upgrade/upgrade-application-server/configure-code-analyser.md" >}}
2727

28-
## Disable Whitelist Analyser
28+
### Update Code Analyser Allowed List
2929

30-
{{< alert type="note" title="Note" >}} This release introduces a Whitelist Analyser to prevent unauthorised execution of namespaces. This step only needs to happen if the Whitelist Analyser should be disabled.{{< /alert >}}
30+
{{< section "/upgrade/upgrade-application-server/update-code-analyser.md" >}}
31+
32+
### Disable Code Analyser
3133

3234
On the Application Server:
3335

34-
1. Open a File Explorer.
35-
1. Navigate to `%ProgramData%\SF\<CustomerName>.<NodeName>\Fabric\work\Applications\Cortex.Innovation.Execution_App1\ExecutionPkg.Code.*` replacing `<CustomerName>` with the Customer Name and `<NodeName>` with the NETBIOS name of the Application Server configured during installation.
36-
{{% alert title="Note" %}}
37-
To check the values to be used open the `Cortex.Upgrade.ApplicationConfig.json` file located in `%ProgramData%\Cortex\Upgrade`.
38-
{{% /alert %}}
39-
1. Open the `appsettings.json` file in a text editor.
40-
1. Locate the `"FeatureFlags"` line located under `"ExecutionEngine"` and set the value to `["f4fd94c0-a921-4b34-b82c-378b05e91555"]`.
41-
1. Save and close the file.
42-
1. In the File Explorer, navigate to `%ProgramData%\SF\<CustomerName>.<NodeName>\Fabric\work\ImageCache\Store\Cortex.Innovation.Execution\ExecutionPkg.Code.*` replacing `<CustomerName>` with the Customer Name and `<NodeName>` with the NETBIOS name of the Application Server specified in step 2.
43-
1. Repeat steps 3 - 5.
44-
1. Open a web browser.
45-
1. Navigate to `https://server.domain.com:9080/Explorer`, where `server.domain.com` is the fully qualified domain name of the Application Server. Replace `9080` with new `httpGatewayEndpointPort` value if it was changed during configuration of the original installation.
46-
1. Expand `Cluster` then `Nodes`.
47-
1. Restart the node by clicking on the drop down menu next to the node name and select `Restart`. Confirm node restart by following the on-screen instructions.
48-
49-
Once the node has been updated and restarted, it will be necessary to [re-check the Application Services][Check Application Services] to ensure that the node has re-started correctly.
36+
{{< section "/upgrade/2025.5/upgrade-application-server/single-server/disable-code-analyser.md" >}}
37+
38+
## Check Application Services
39+
40+
{{< section "/upgrade/upgrade-application-server/single-server/check-application-services.md" >}}
5041

5142
## Preserve installation files
5243

@@ -56,6 +47,5 @@ Once the node has been updated and restarted, it will be necessary to [re-check
5647

5748
1. [Upgrade Web Application Server][]
5849

59-
[Check Application Services]: {{< ref "#check-application-services">}}
6050
[PreUpgrade]: {{< url path="Cortex.Guides.UpgradeGuides.UpgradeCortex.2025.3to2025.5.SingleServerWithoutHA.PreUpgrade" >}}
6151
[Upgrade Web Application Server]: {{< url path="Cortex.Guides.UpgradeGuides.UpgradeCortex.2025.3to2025.5.SingleServerWithoutHA.UpgradeWebApplicationServer" >}}

content/en/docs/2025.5/Guides/upgrade-guides/upgrade-cortex/2025.3-to-2025.5/single-server-without-ha/upgrade/upgrade-web-application-server/upgrade-cip.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ This guide describes how to upgrade {{% ctx %}} Interaction Portal. Please ensur
1111

1212
## Perform Upgrade
1313

14-
No upgrade required
14+
{{< section "/upgrade/2025.5/upgrade-web-application-server/upgrade-cortex-interaction-portal.md" >}}
1515

1616
## Next Steps?
1717

content/en/docs/2025.5/Guides/upgrade-guides/upgrade-cortex/2025.3-to-2025.5/single-server-without-ha/upgrade/upgrade-web-application-server/upgrade-gateway.md

Lines changed: 0 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -17,41 +17,6 @@ This guide describes how to upgrade {{% ctx %}} Gateway from 2025.3 to 2025.5. P
1717

1818
{{< section "/upgrade/2025.5/upgrade-web-application-server/run-gateway-script.md" >}}
1919

20-
## Delete Old Execution Services
21-
22-
1. Open a web browser.
23-
1. Navigate to `https://server.domain.com:9080/Explorer`, where `server.domain.com` is the fully qualified domain name of one of the application servers. Replace `9080` with new `httpGatewayEndpointPort` value if it was changed during configuration of the original installation.
24-
1. Expand `Cluster` then `Applications` then `Cortex.Innovation.Execution`.
25-
1. For all old execution applications:
26-
* Click on the drop down menu and select `Delete Application`. Confirm application deletion by following the on-screen instructions.
27-
* Give this a few minutes. If the application does not delete:
28-
* Expand `Nodes`
29-
* For each node:
30-
* Expand the node and select the application that matches the engine version number of the application that is being attempted to be deleted.
31-
* Expand each level up to and including `Code Packages`.
32-
* Click on the drop down menu for `Code` and select `Restart`. Confirm application restart by following the on-screen instructions.
33-
* Give this a few minutes. Once all nodes have been restarted the application should be deleted and disappear from the list of applications.
34-
35-
Repeat the above instructions for the `Flow Debugger`. In step 2 `server.domain.com` is the fully qualified domain name of the web application server.
36-
37-
## Republish Packages
38-
39-
1. Log in to Gateway with a user that has the `Admin` role.
40-
1. Click on the `Admin` charm, then `Packages`.
41-
1. In the `Package Definitions` grid, select `Is Published` filter option on the `Is Published` column to show all published packages.
42-
1. For each published package version:
43-
* Select the package.
44-
* Click `Unpublish` at the bottom of the `Definition` tab and click `Unpublish` on the confirmation pop-up dialog. A success message should appear. If it doesn't it means that there is a problem with the configuration in the `web.config` file for {{% ctx %}} Gateway, or the Application Services aren't healthy
45-
* Click `Create New Version` then click `Save` and wait for the new version to be created.
46-
* Click `Publish`. A success message should appear. If it doesn't it means that there is a problem with the configuration in the `web.config` file for {{% ctx %}} Gateway, or the Application Services aren't healthy.
47-
* Sometimes the list of published packages in the `Package Definitions` grid disappears. To fix, set the `Is Published` filter in the `Package Definitions` grid to blank option and then set the filter to `Is Published` option again to show all published packages.
48-
49-
## Restore Configuration Portal Data
50-
51-
If using the {{% ctx %}} Configuration Portal, the data will need to be restored.
52-
53-
For further assistance, please raise a case in the [{{% ctx %}} Service Portal][].
54-
5520
## Preserve installation files
5621

5722
{{< section "/preserve-installation-files.md" >}}
Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
1. Open a File Explorer.
2+
1. Navigate to the Execution service directory, e.g. `%ProgramData%\SF\<CustomerName>.<NodeName>\Fabric\work\Applications\Cortex.Innovation.Execution_App<n>\ExecutionPkg.Code.27.3.0.25260` replacing `<CustomerName>` with the Customer Name configured during installation, `<NodeName>` with the NETBIOS name of the server and `<n>` with the highest number in the directory.
3+
{{% alert title="Note" %}}
4+
To check the value to be used for Customer Name open the `Cortex.Upgrade.ApplicationConfig.json` file located in `%ProgramData%\Cortex\Upgrade`.
5+
{{% /alert %}}
6+
1. Open the `appsettings.json` file in a text editor.
7+
1. Locate the `"FeatureFlags"` line located under `"ExecutionEngine"` and set the value to `["f4fd94c0-a921-4b34-b82c-378b05e91555"]`.
8+
1. Save and close the file.
9+
1. In the File Explorer, navigate to `%ProgramData%\SF\<CustomerName>.<NodeName>\Fabric\work\ImageCache\Store\Cortex.Innovation.Execution\ExecutionPkg.Code.27.3.0.25260` replacing `<CustomerName>` with the Customer Name and `<NodeName>` with the NETBIOS name of the server specified in step 2.
10+
1. Repeat steps 3 - 5.
11+
1. Open a web browser.
12+
1. Navigate to `https://server.domain.com:9080/Explorer`, where `server.domain.com` is the fully qualified domain name of the server. Replace `9080` with new `httpGatewayEndpointPort` value if it was changed during configuration of the original installation.
13+
14+
{{% alert title="Note" %}}
15+
If a certificate error occurs, it will be necessary to import the client certificate used in the original installation. Follow instructions provided in Step 2 of {{< ahref path="Cortex.Guides.UpgradeGuides.UpgradeCortex.2025.3to2025.5.MultipleServerWithHA.CheckApplicationServices" title="Check Application Services" >}}.
16+
{{% /alert %}}
17+
18+
1. Expand `Cluster` then `Nodes`.
19+
1. Restart the node by clicking on the drop down menu next to the node name and select `Restart`. Confirm node restart by following the on-screen instructions.
Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
1. Open a File Explorer.
2+
1. Navigate to the Execution service directory, e.g. `%ProgramData%\SF\<CustomerName>.<NodeName>\Fabric\work\Applications\Cortex.Innovation.Execution_App<n>\ExecutionPkg.Code.27.3.0.25260` replacing `<CustomerName>` with the Customer Name configured during installation, `<NodeName>` with the NETBIOS name of the server and `<n>` with the highest number in the directory.
3+
{{% alert title="Note" %}}
4+
To check the value to be used for Customer Name open the `Cortex.Upgrade.ApplicationConfig.json` file located in `%ProgramData%\Cortex\Upgrade`.
5+
{{% /alert %}}
6+
1. Open the `appsettings.json` file in a text editor.
7+
1. Locate the `"FeatureFlags"` line located under `"ExecutionEngine"` and set the value to `["f4fd94c0-a921-4b34-b82c-378b05e91555"]`.
8+
1. Save and close the file.
9+
1. In the File Explorer, navigate to `%ProgramData%\SF\<CustomerName>.<NodeName>\Fabric\work\ImageCache\Store\Cortex.Innovation.Execution\ExecutionPkg.Code.27.3.0.25260` replacing `<CustomerName>` with the Customer Name and `<NodeName>` with the NETBIOS name of the server specified in step 2.
10+
1. Repeat steps 3 - 5.
11+
1. Open a web browser.
12+
1. Navigate to `https://server.domain.com:9080/Explorer`, where `server.domain.com` is the fully qualified domain name of the server. Replace `9080` with new `httpGatewayEndpointPort` value if it was changed during configuration of the original installation.
13+
14+
{{% alert title="Note" %}}
15+
If a certificate error occurs, it will be necessary to import the client certificate used in the original installation. Follow instructions provided in Step 2 of {{< ahref path="Cortex.Guides.UpgradeGuides.UpgradeCortex.2025.3to2025.5.MultipleServerWithHA.CheckDebuggerApplicationServices" title="Check Application Services" >}}.
16+
{{% /alert %}}
17+
18+
1. Expand `Cluster` then `Nodes`.
19+
1. Restart the node by clicking on the drop down menu next to the node name and select `Restart`. Confirm node restart by following the on-screen instructions.
Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
1. Open a File Explorer.
2+
1. Navigate to the Execution service directory, e.g. `%ProgramData%\SF\<CustomerName>.<NodeName>\Fabric\work\Applications\Cortex.Innovation.Execution_App<n>\ExecutionPkg.Code.27.3.0.25260` replacing `<CustomerName>` with the Customer Name configured during installation, `<NodeName>` with the NETBIOS name of the server and `<n>` with the highest number in the directory.
3+
{{% alert title="Note" %}}
4+
To check the value to be used for Customer Name open the `Cortex.Upgrade.ApplicationConfig.json` file located in `%ProgramData%\Cortex\Upgrade`.
5+
{{% /alert %}}
6+
1. Open the `appsettings.json` file in a text editor.
7+
1. Locate the `"FeatureFlags"` line located under `"ExecutionEngine"` and set the value to `["f4fd94c0-a921-4b34-b82c-378b05e91555"]`.
8+
1. Save and close the file.
9+
1. In the File Explorer, navigate to `%ProgramData%\SF\<CustomerName>.<NodeName>\Fabric\work\ImageCache\Store\Cortex.Innovation.Execution\ExecutionPkg.Code.27.3.0.25260` replacing `<CustomerName>` with the Customer Name and `<NodeName>` with the NETBIOS name of the server specified in step 2.
10+
1. Repeat steps 3 - 5.
11+
1. Open a web browser.
12+
1. Navigate to `https://server.domain.com:9080/Explorer`, where `server.domain.com` is the fully qualified domain name of the server. Replace `9080` with new `httpGatewayEndpointPort` value if it was changed during configuration of the original installation.
13+
14+
{{% alert title="Note" %}}
15+
If a certificate error occurs, it will be necessary to import the client certificate used in the original installation. Follow instructions provided in Step 2 of {{< ahref path="Cortex.Guides.UpgradeGuides.UpgradeCortex.2025.3to2025.5.SingleServerWithoutHA.CheckApplicationServices" title="Check Application Services" >}}.
16+
{{% /alert %}}
17+
18+
1. Expand `Cluster` then `Nodes`.
19+
1. Restart the node by clicking on the drop down menu next to the node name and select `Restart`. Confirm node restart by following the on-screen instructions.

0 commit comments

Comments
 (0)