Skip to content

Commit 7d66fd8

Browse files
Cortex-DMSCortex-DMS
authored
Feature/upgrade guide for 2025.3 to 2025.5 (#219)
1 parent 0215f94 commit 7d66fd8

File tree

34 files changed

+804
-0
lines changed

34 files changed

+804
-0
lines changed

‎content/en/docs/2025.5/Guides/upgrade-guides/upgrade-cortex/2025.1-to-2025.3/_index.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,4 +3,5 @@ title: "2025.1 to 2025.3"
33
linkTitle: "2025.1 to 2025.3"
44
description: "Instructions to upgrade {{% ctx %}} 2025.1 to 2025.3"
55
weight: 930
6+
outOfSupport: true
67
---

‎content/en/docs/2025.5/Guides/upgrade-guides/upgrade-cortex/2025.3-to-2025.5/_index.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
---
2+
title: "2025.3 to 2025.5"
3+
linkTitle: "2025.3 to 2025.5"
4+
description: "Instructions to upgrade {{% ctx %}} 2025.3 to 2025.5"
5+
weight: 920
6+
---

‎content/en/docs/2025.5/Guides/upgrade-guides/upgrade-cortex/2025.3-to-2025.5/multiple-server-with-ha/_index.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
---
2+
title: "Multiple Server - With HA"
3+
linkTitle: "Multiple Server - With HA"
4+
description: "Upgrade instructions for multiple on-premise servers with high availability (HA)."
5+
weight: 10
6+
---

‎content/en/docs/2025.5/Guides/upgrade-guides/upgrade-cortex/2025.3-to-2025.5/multiple-server-with-ha/pre-upgrade.md

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
---
2+
title: "Pre-Upgrade"
3+
linkTitle: "Pre-Upgrade"
4+
description: "Information about the steps required to be completed prior to starting the upgrade."
5+
weight: 30
6+
---
7+
8+
# {{% param title %}}
9+
10+
This guide describes how to perform the steps required before starting the upgrade of {{% ctx %}}.
11+
12+
## Make Installation Artefacts Available on all Servers
13+
14+
{{< section "/upgrade/2025.5/pre-upgrade/multi-server/make-artefacts-available.md">}}
15+
16+
## Next Steps?
17+
18+
1. [Upgrade][]
19+
20+
[{{% ctx %}} Service Portal]: {{< url path="Cortex.ServicePortal.MainDoc" >}}
21+
[Upgrade]: {{< url path="Cortex.Guides.UpgradeGuides.UpgradeCortex.2025.3to2025.5.MultipleServerWithHA.Upgrade" >}}

‎content/en/docs/2025.5/Guides/upgrade-guides/upgrade-cortex/2025.3-to-2025.5/multiple-server-with-ha/try-it-out.md

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,25 @@
1+
---
2+
title: "Try it out"
3+
linkTitle: "Try it out"
4+
description: "Information about trying out {{% ctx %}} after upgrade."
5+
weight: 60
6+
---
7+
8+
# {{% param title %}}
9+
10+
This guide describes how to try out an upgraded {{% ctx %}} to make sure it is working. Please ensure that both the [Application Servers and Load Balancer Upgrade][] and [Web Application Server Upgrade][] has been completed before taking these steps.
11+
12+
## Test Debugging Flows
13+
14+
{{< section "/upgrade/try-it-out/test-debugging-flows.md" >}}
15+
16+
## Test Publishing Production Flows
17+
18+
{{< section "/upgrade/try-it-out/test-publishing-flows.md" >}}
19+
20+
## Test Executing Production Flows
21+
22+
{{< section "/upgrade/try-it-out/multi-server/test-executing-production-flows.md" >}}
23+
24+
[Application Servers and Load Balancer Upgrade]: {{< url path="Cortex.Guides.UpgradeGuides.UpgradeCortex.2025.3to2025.5.MultipleServerWithHA.UpgradeApplicationAndLoadBalancerServers" >}}
25+
[Web Application Server Upgrade]: {{< url path="Cortex.Guides.UpgradeGuides.UpgradeCortex.2025.3to2025.5.MultipleServerWithHA.UpgradeWebApplicationServer" >}}

‎content/en/docs/2025.5/Guides/upgrade-guides/upgrade-cortex/2025.3-to-2025.5/multiple-server-with-ha/upgrade/_index.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,10 @@
1+
---
2+
title: "Upgrade"
3+
linkTitle: "Upgrade"
4+
description: "Instructions to upgrade {{% ctx %}} across multiple on-premise servers with high availability (HA)."
5+
weight: 40
6+
---
7+
8+
This guide describes how to upgrade {{% ctx %}}. Please ensure that the [Pre-Upgrade][PreUpgrade] steps have been completed before starting the upgrade.
9+
10+
[PreUpgrade]: {{< url path="Cortex.Guides.UpgradeGuides.UpgradeCortex.2025.3to2025.5.MultipleServerWithHA.PreUpgrade" >}}

‎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: 85 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,85 @@
1+
---
2+
title: "Upgrade Application Servers and Load Balancer"
3+
linkTitle: "Upgrade Application Servers and Load Balancer"
4+
description: "Information about upgrading the Application Servers and Load Balancer Server."
5+
weight: 30
6+
---
7+
8+
# {{< param title >}}
9+
10+
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.
11+
12+
## Configure Upgrade Script
13+
14+
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.
15+
1. Choose the tab below that matches the configuration for this upgrade, then update the script to match, changing the parameters according to the details given below:
16+
17+
{{% alert title="Note" %}}
18+
To check the previous configuration values open the `Cortex.Upgrade.ApplicationConfig.json` file located in `%ProgramData%\Cortex\Upgrade`. If the file does not exist or the values should be changed then use the `Use New Configuration Values` tab.
19+
{{% /alert %}}
20+
21+
{{< tabpane lang="powershell" >}}
22+
{{< tab header="Use Previous Configuration Values" >}}
23+
.\Cortex.Upgrade.ps1 `
24+
-AppServicesPath "C:\Install\Cortex Innovation 2025.5 - App Services.zip" `
25+
-BlockPackagesPath "C:\Install\Cortex Innovation 2025.5 - Block Packages.zip" `
26+
-Credential $Credential `
27+
-AcceptEULA:$AcceptEULA `
28+
*>&1 | Tee-Object -FilePath "cortex-ha-upgrade-log.txt"
29+
{{< /tab >}}
30+
{{< tab header="Use New Configuration Values">}}
31+
.\Cortex.Upgrade.ps1 `
32+
-AppServicesPath "C:\Install\Cortex Innovation 2025.5 - App Services.zip" `
33+
-BlockPackagesPath "C:\Install\Cortex Innovation 2025.5 - Block Packages.zip" `
34+
-ApplicationServerIPv4Addresses @("192.168.1.1, 192.168.1.2, 192.168.1.3") `
35+
-LoadBalancerServerIPv4Address "192.168.1.4" `
36+
-Credential $Credential `
37+
-AcceptEULA:$AcceptEULA `
38+
*>&1 | Tee-Object -FilePath "cortex-ha-upgrade-log.txt"
39+
{{< /tab >}}
40+
{{< /tabpane >}}
41+
42+
| Name | Description |
43+
|----------------------------------------------|-------------|
44+
|`AppServicesPath` | Configure this value with the location of the Application Services zip file on the Application Server being used for the upgrade. |
45+
|`BlockPackagesPath` | Configure this value with the location of the Block Packages zip file on the Application Server being used for the upgrade. |
46+
|`ApplicationServerIPv4Addresses` | The IPv4 addresses of the Application Servers. The first of these must be the Application Server being used for the upgrade.|
47+
|`LoadBalancerServerIPv4Address` | The IPv4 address of the Load Balancer Server. If the built-in load balancer is not being used, this should be removed.|
48+
|`Credential` | The credentials of the user which will be used to perform remote operations on the Application Servers. It must be a domain user that is a member of the local Administrators group on all servers.<br><br>This does not need to be changed, a prompt will appear to enter this information when the script is run. |
49+
|`AcceptEULA` | This does not need to be changed, the EULA will be accepted at a later stage. |
50+
|`FilePath` | The filename that upgrade logs are written to. If this should be written to a different location than where the installation files are then a full path should be specified. |
51+
52+
1. Save and close `Cortex.Innovation.Upgrade.ps1`.
53+
54+
## Run Upgrade Script
55+
56+
{{< section "/upgrade/2025.5/upgrade-application-server/multi-server/run-upgrade-script.md" >}}
57+
58+
## Configure {{% ctx %}} Code Analyser
59+
60+
{{< section "/upgrade/upgrade-application-server/configure-code-analyser.md" >}}
61+
62+
### Update Code Analyser Allowed List
63+
64+
{{< section "/upgrade/upgrade-application-server/update-code-analyser.md" >}}
65+
66+
### Disable Code Analyser
67+
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" >}}
75+
76+
## Preserve installation files
77+
78+
{{< section "/preserve-installation-files.md" >}}
79+
80+
## Next Steps?
81+
82+
1. [Upgrade Web Application Server][]
83+
84+
[PreUpgrade]: {{< url path="Cortex.Guides.UpgradeGuides.UpgradeCortex.2025.3to2025.5.MultipleServerWithHA.PreUpgrade" >}}
85+
[Upgrade Web Application Server]: {{< url path="Cortex.Guides.UpgradeGuides.UpgradeCortex.2025.3to2025.5.MultipleServerWithHA.UpgradeWebApplicationServer" >}}

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

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,10 @@
1+
---
2+
title: "Upgrade the Web Application Server"
3+
linkTitle: "Upgrade Web Application Server"
4+
description: "Information about upgrading the Web Application Server."
5+
weight: 40
6+
---
7+
8+
This guide describes how to upgrade the Web Application Server. Please ensure that [Upgrade Application Servers and Load Balancer][] has been completed before starting this installation. These steps assume that the v2025.3 version of Gateway and its prerequisites have already been installed.
9+
10+
[Upgrade Application Servers and Load Balancer]: {{< url path="Cortex.Guides.UpgradeGuides.UpgradeCortex.2025.3to2025.5.MultipleServerWithHA.UpgradeApplicationAndLoadBalancerServers" >}}

‎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: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
---
2+
title: "Upgrade Interaction Portal"
3+
linkTitle: "Upgrade Interaction Portal"
4+
description: "Information about upgrading {{% ctx %}} Interaction Portal."
5+
weight: 60
6+
---
7+
8+
# {{% param title %}}
9+
10+
This guide describes how to upgrade {{% ctx %}} Interaction Portal. Please ensure that the [{{% ctx %}} Gateway Upgrade][Upgrade Gateway] has been completed before starting this upgrade.
11+
12+
## Perform Upgrade
13+
14+
{{< section "/upgrade/2025.5/upgrade-web-application-server/upgrade-cortex-interaction-portal.md" >}}
15+
16+
## Next Steps?
17+
18+
1. [Try It Out][]
19+
20+
[Upgrade Gateway]: {{< url path="Cortex.Guides.UpgradeGuides.UpgradeCortex.2025.3to2025.5.MultipleServerWithHA.UpgradeGateway" >}}
21+
[Try It Out]: {{< url path="Cortex.Guides.UpgradeGuides.UpgradeCortex.2025.3to2025.5.MultipleServerWithHA.TryItOut" >}}

‎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: 47 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,47 @@
1+
---
2+
title: "Upgrade Flow Debugger"
3+
linkTitle: "Upgrade Flow Debugger"
4+
description: "Information about upgrading the Flow Debugger."
5+
weight: 30
6+
---
7+
8+
# {{< param title >}}
9+
10+
This guide describes how to upgrade the Flow Debugger on the Web Application Server from 2025.3 to 2025.5. Please ensure that the [Upgrade Application and Load Balancer Servers][] has been completed before starting this upgrade.
11+
12+
## Configure Upgrade Script
13+
14+
{{< section "/upgrade/2025.5/upgrade-application-server/single-server/configure-upgrade-script.md" >}}
15+
16+
## Run Upgrade Script
17+
18+
{{< section "/upgrade/2025.5/upgrade-application-server/single-server/run-upgrade-script.md">}}
19+
20+
## Configure {{% ctx %}} Code Analyser
21+
22+
{{< section "/upgrade/upgrade-application-server/configure-code-analyser.md" >}}
23+
24+
### Update Code Analyser Allowed List
25+
26+
{{< section "/upgrade/upgrade-application-server/update-code-analyser.md" >}}
27+
28+
### Disable Code Analyser
29+
30+
On the Web Application Server:
31+
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">}}
37+
38+
## Preserve installation files
39+
40+
{{< section "/preserve-installation-files.md">}}
41+
42+
## Next Steps?
43+
44+
1. [Upgrade Gateway][]
45+
46+
[Upgrade Application and Load Balancer Servers]: {{< url path="Cortex.Guides.UpgradeGuides.UpgradeCortex.2025.3to2025.5.MultipleServerWithHA.UpgradeApplicationAndLoadBalancerServers" >}}
47+
[Upgrade Gateway]: {{< url path="Cortex.Guides.UpgradeGuides.UpgradeCortex.2025.3to2025.5.MultipleServerWithHA.UpgradeGateway" >}}

0 commit comments

Comments
 (0)