Skip to content

Commit 36cc5cd

Browse files
author
cortex-lp
committed
initial version of upgrade guides
1 parent 4435b7c commit 36cc5cd

50 files changed

Lines changed: 1069 additions & 2 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

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

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,10 @@
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+
---
7+
8+
{{% alert title="Warning" color="warning" %}}
9+
This upgrade guide is only applicable if upgrading from 2025.3.26111.
10+
{{% /alert %}}

‎content/en/docs/2026.3/Guides/upgrade-guides/upgrade-cortex/2025.3.26111-to-2026.3/multiple-server-with-ha/post-upgrade/_index.md‎

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,10 @@
1+
---
2+
title: "Post-Upgrade"
3+
linkTitle: "Post-Upgrade"
4+
description: "Information about the steps required to be completed after the upgrade of {{% ctx %}} has been completed."
5+
weight: 50
6+
---
7+
8+
This guide describes how to perform the steps to verify the upgrade of {{% ctx %}} and perform final configuration. Please ensure that the [Upgrade][] has been completed before starting this section.
9+
10+
[Upgrade]: {{< url path="Cortex.Guides.UpgradeGuides.UpgradeCortex.2025_3_26111to2025_9_26161.MultipleServerWithHA.Upgrade" >}}

‎content/en/docs/2026.3/Guides/upgrade-guides/upgrade-cortex/2025.3.26111-to-2026.3/multiple-server-with-ha/post-upgrade/move-flows-to-new-execution-service.md‎

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,28 @@
1+
---
2+
title: "Move flows to new Execution Service"
3+
linkTitle: "Move flows to new Execution Service"
4+
description: "Information about moving flows to use the new Execution Service after upgrade."
5+
weight: 20
6+
---
7+
8+
# {{% param title %}}
9+
10+
This guide describes how to move flow execution to the new Execution Service. Please ensure that the [Try it out][] steps have been completed before proceeding.
11+
12+
{{% alert title="Note" %}}
13+
These steps are optional however it is recommended so that the new Execution Service is used after upgrade.
14+
{{% /alert %}}
15+
16+
## Upgrade Flows
17+
18+
{{< section "/upgrade/2025.9.26161/upgrade-web-application-server/upgrade-flows.md" >}}
19+
20+
{{% alert title="Note" %}}
21+
Once the flows have been upgraded it is necessary to {{< ahref path="Cortex.Guides.UpgradeGuides.UpgradeCortex.2025_3_26111to2025_9_26161.MultipleServerWithHA.RepublishPackages" title="republish all packages" >}} that have previously been published.
22+
{{% /alert %}}
23+
24+
## Republish Packages
25+
26+
{{< section "/upgrade/2025.9.26161/upgrade-web-application-server/republish-packages.md" >}}
27+
28+
[Try it out]: {{< url path="Cortex.Guides.UpgradeGuides.UpgradeCortex.2025_3_26111to2025_9_26161.MultipleServerWithHA.TryItOut" >}}

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

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,29 @@
1+
---
2+
title: "Try it out"
3+
linkTitle: "Try it out"
4+
description: "Information about trying out {{% ctx %}} after upgrade."
5+
weight: 10
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 the [Upgrade Web Application Server][] has been completed before taking these steps.
11+
12+
## Test Debugging Flows
13+
14+
{{< section "/try-it-out/test-debugging-flows.md" >}}
15+
16+
## Test Publishing Production Flows
17+
18+
{{< section "/try-it-out/test-publishing-flows.md" >}}
19+
20+
## Test Executing Production Flows
21+
22+
{{< section "/try-it-out/multi-server/test-executing-production-flows.md" >}}
23+
24+
## Next Steps?
25+
26+
1. [Move flows to new Execution Service][]
27+
28+
[Move flows to new Execution Service]: {{< url path="Cortex.Guides.UpgradeGuides.UpgradeCortex.2025_3_26111to2025_9_26161.MultipleServerWithHA.UseNewExecutionService" >}}
29+
[Upgrade Web Application Server]: {{< url path="Cortex.Guides.UpgradeGuides.UpgradeCortex.2025_3_26111to2025_9_26161.MultipleServerWithHA.UpgradeWebApplicationServer" >}}

‎content/en/docs/2026.3/Guides/upgrade-guides/upgrade-cortex/2025.3.26111-to-2026.3/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.9.26161/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_3_26111to2025_9_26161.MultipleServerWithHA.Upgrade" >}}

‎content/en/docs/2026.3/Guides/upgrade-guides/upgrade-cortex/2025.3.26111-to-2026.3/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_3_26111to2025_9_26161.MultipleServerWithHA.PreUpgrade" >}}

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

Lines changed: 71 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,71 @@
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.26111 to 2026.3. 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 2026.3 - 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 2026.3 - App Services.zip" `
25+
-BlockPackagesPath "C:\Install\Cortex Innovation 2026.3 - 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 2026.3 - App Services.zip" `
33+
-BlockPackagesPath "C:\Install\Cortex Innovation 2026.3 - 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/2026.3/upgrade-application-server/multi-server/run-upgrade-script.md" >}}
57+
58+
## Check Application Services
59+
60+
{{< section "/upgrade/upgrade-application-server/multi-server/check-application-services.md" >}}
61+
62+
## Preserve installation files
63+
64+
{{< section "/preserve-installation-files.md" >}}
65+
66+
## Next Steps?
67+
68+
1. [Upgrade Web Application Server][]
69+
70+
[PreUpgrade]: {{< url path="Cortex.Guides.UpgradeGuides.UpgradeCortex.2025_3_26111to2026_3.MultipleServerWithHA.PreUpgrade" >}}
71+
[Upgrade Web Application Server]: {{< url path="Cortex.Guides.UpgradeGuides.UpgradeCortex.2025_3_26111to2026_3.MultipleServerWithHA.UpgradeWebApplicationServer" >}}

‎content/en/docs/2026.3/Guides/upgrade-guides/upgrade-cortex/2025.3.26111-to-2026.3/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.9 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_3_26111to2025_9_26161.MultipleServerWithHA.UpgradeApplicationAndLoadBalancerServers" >}}

‎content/en/docs/2026.3/Guides/upgrade-guides/upgrade-cortex/2025.3.26111-to-2026.3/multiple-server-with-ha/upgrade/upgrade-web-application-server/upgrade-ccp.md‎

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
---
2+
title: "Upgrade Configuration Portal"
3+
linkTitle: "Upgrade Configuration Portal"
4+
description: "Information about upgrading {{% ctx %}} Configuration Portal."
5+
weight: 60
6+
---
7+
8+
# {{% param title %}}
9+
10+
This guide describes how to upgrade {{% ctx %}} Configuration 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.9.26161/upgrade-web-application-server/upgrade-cortex-configuration-portal.md" >}}
15+
16+
## Next Steps?
17+
18+
1. [Upgrade {{% ctx %}} Interaction Portal][Upgrade CIP]
19+
20+
[Upgrade Gateway]: {{< url path="Cortex.Guides.UpgradeGuides.UpgradeCortex.2025_3_26111to2025_9_26161.MultipleServerWithHA.UpgradeGateway" >}}
21+
[Upgrade CIP]: {{< url path="Cortex.Guides.UpgradeGuides.UpgradeCortex.2025_3_26111to2025_9_26161.MultipleServerWithHA.UpgradeCIP" >}}

‎content/en/docs/2026.3/Guides/upgrade-guides/upgrade-cortex/2025.3.26111-to-2026.3/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.9.26161/upgrade-web-application-server/upgrade-cortex-interaction-portal.md" >}}
15+
16+
## Next Steps?
17+
18+
1. [Post-Upgrade][]
19+
20+
[Upgrade Gateway]: {{< url path="Cortex.Guides.UpgradeGuides.UpgradeCortex.2025_3_26111to2025_9_26161.MultipleServerWithHA.UpgradeGateway" >}}
21+
[Post-Upgrade]: {{< url path="Cortex.Guides.UpgradeGuides.UpgradeCortex.2025_3_26111to2025_9_26161.MultipleServerWithHA.PostUpgrade" >}}

0 commit comments

Comments
 (0)