Skip to content

Commit bfd7ec2

Browse files
author
Donna-Marie Smith
committed
Added Upgrade guide for 2024.7 to 2024.9
1 parent a6e73f2 commit bfd7ec2

File tree

20 files changed

+573
-0
lines changed

20 files changed

+573
-0
lines changed

‎content/en/docs/2024.9/Guides/upgrade-cortex/2024.7-to-2024.9/_index.md‎

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

‎content/en/docs/2024.9/Guides/upgrade-cortex/2024.7-to-2024.9/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/2024.9/Guides/upgrade-cortex/2024.7-to-2024.9/multiple-server-with-ha/try-it-out.md‎

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
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+
{{< section "/upgrade/try-it-out/test-upgrade.md" >}}
13+
14+
## Test Executing Production Flows
15+
16+
{{< section "/upgrade/try-it-out/multi-server/test-executing-production-flows.md" >}}
17+
18+
[Application Servers and Load Balancer Upgrade]: {{< url path="Cortex.Guides.UpgradeCortex.2024.7to2024.9.MultipleServerWithHA.UpgradeApplicationAndLoadBalancerServers" >}}
19+
[Web Application Server Upgrade]: {{< url path="Cortex.Guides.UpgradeCortex.2024.7to2024.9.MultipleServerWithHA.UpgradeWebApplicationServer" >}}

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

Lines changed: 79 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,79 @@
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 2024.7 to 2024.9.
11+
12+
## Make Installation Artefacts Available
13+
14+
1. Choose one of the Application Servers to be used to perform the upgrade from, and copy the following artefacts to a folder on it:
15+
* Cortex Innovation 2024.9 - App Server Install Scripts.zip
16+
* Cortex Innovation 2024.9 - App Services.zip
17+
* Cortex Innovation 2024.9 - Block Packages.zip
18+
19+
1. Extract the `Cortex Innovation 2024.9 - App Server Install Scripts.zip` file to a folder with the same name.
20+
21+
## Configure Upgrade Script
22+
23+
1. In the `Cortex Innovation 2024.9 - App Server Install Scripts\Upgrade Application Server` folder, locate the `Cortex.Innovation.Upgrade.ps1` script and open it with a text editor.
24+
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:
25+
26+
{{% alert title="Note" %}}
27+
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.
28+
{{% /alert %}}
29+
30+
{{< tabpane lang="powershell" >}}
31+
{{< tab header="Use Previous Configuration Values" >}}
32+
.\Cortex.Upgrade.ps1 `
33+
-AppServicesPath "C:\Install\Cortex Innovation 2024.9 - App Services.zip" `
34+
-BlockPackagesPath "C:\Install\Cortex Innovation 2024.9 - Block Packages.zip" `
35+
-Credential $Credential `
36+
-AcceptEULA:$AcceptEULA `
37+
*>&1 | Tee-Object -FilePath "cortex-ha-upgrade-log.txt"
38+
{{< /tab >}}
39+
{{< tab header="Use New Configuration Values">}}
40+
.\Cortex.Upgrade.ps1 `
41+
-AppServicesPath "C:\Install\Cortex Innovation 2024.9 - App Services.zip" `
42+
-BlockPackagesPath "C:\Install\Cortex Innovation 2024.9 - Block Packages.zip" `
43+
-ApplicationServerIPv4Addresses @("192.168.1.1, 192.168.1.2, 192.168.1.3") `
44+
-LoadBalancerServerIPv4Address "192.168.1.4" `
45+
-Credential $Credential `
46+
-AcceptEULA:$AcceptEULA `
47+
*>&1 | Tee-Object -FilePath "cortex-ha-upgrade-log.txt"
48+
{{< /tab >}}
49+
{{< /tabpane >}}
50+
51+
| Name | Description |
52+
|----------------------------------------------|-------------|
53+
|`AppServicesPath` | Configure this value with the location of the Application Services zip file on the Application Server being used for the upgrade. |
54+
|`BlockPackagesPath` | Configure this value with the location of the Block Packages zip file on the Application Server being used for the upgrade. |
55+
|`ApplicationServerIPv4Addresses` | The IPv4 addresses of the Application Servers. The first of these must be the Application Server being used for the upgrade.|
56+
|`LoadBalancerServerIPv4Address` | The IPv4 address of the Load Balancer Server. If the built-in load balancer is not being used, this should be removed.|
57+
|`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. |
58+
|`AcceptEULA` | This does not need to be changed, the EULA will be accepted at a later stage. |
59+
|`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. |
60+
61+
1. Save and close `Cortex.Innovation.Upgrade.ps1`.
62+
63+
## Run Upgrade Script
64+
65+
{{< section "/upgrade/2024.9/upgrade-application-server/multi-server/run-upgrade-script.md" >}}
66+
67+
## Check Application Services
68+
69+
{{< section "/upgrade/upgrade-application-server/multi-server/check-application-services.md" >}}
70+
71+
## Preserve installation files
72+
73+
{{< section "/preserve-installation-files.md" >}}
74+
75+
## Next Steps?
76+
77+
1. [Upgrade Web Application Server][]
78+
79+
[Upgrade Web Application Server]: {{< url path="Cortex.Guides.UpgradeCortex.2024.7to2024.9.MultipleServerWithHA.UpgradeWebApplicationServer" >}}

‎content/en/docs/2024.9/Guides/upgrade-cortex/2024.7-to-2024.9/multiple-server-with-ha/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 v2024.7 version of Gateway and its prerequisites have already been installed.
9+
10+
[Upgrade Application Servers and Load Balancer]: {{< url path="Cortex.Guides.UpgradeCortex.2024.7to2024.9.MultipleServerWithHA.UpgradeApplicationAndLoadBalancerServers" >}}

‎content/en/docs/2024.9/Guides/upgrade-cortex/2024.7-to-2024.9/multiple-server-with-ha/upgrade-web-application-server/prerequisites.md‎

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,32 @@
1+
---
2+
title: "Prerequisites"
3+
linkTitle: "Prerequisites"
4+
description: "Information about performing the prerequisities for the Upgrade of the Web Application Server."
5+
weight: 10
6+
---
7+
8+
# {{% param title %}}
9+
10+
Please ensure that [Upgrade Application Servers and Load Balancer][] has been completed before starting this installation. These steps assume that the v2024.7 version of Gateway and its prerequisites have already been installed.
11+
12+
## Make Installation Artefacts Available
13+
14+
1. Copy the following artefacts to a folder on the machine:
15+
16+
* Cortex Innovation 2024.9 - App Services.zip
17+
* Cortex Innovation 2024.9 - App Server Install Scripts.zip
18+
* Cortex Innovation 2024.9 - Block Packages.zip
19+
* Cortex Innovation 2024.9 - Gateway.zip
20+
* Cortex Innovation 2024.9 - Flows Upgrader.zip
21+
* Cortex Innovation 2024.9 - Web App Server Install Scripts.zip
22+
23+
1. Extract the `Cortex Innovation 2024.9 - App Server Install Scripts.zip` file to a folder with the same name.
24+
1. Extract the `Cortex Innovation 2024.9 - Flows Upgrader.zip` zip file to a folder with the same name.
25+
1. Extract the `Cortex Innovation 2024.9 - Web App Server Install Scripts.zip` zip file to a folder with the same name.
26+
27+
## Next Steps?
28+
29+
1. [Upgrade Flow Debugger][]
30+
31+
[Upgrade Application Servers and Load Balancer]: {{< url path="Cortex.Guides.UpgradeCortex.2024.7to2024.9.MultipleServerWithHA.UpgradeApplicationAndLoadBalancerServers" >}}
32+
[Upgrade Flow Debugger]: {{< url path="Cortex.Guides.UpgradeCortex.2024.7to2024.9.MultipleServerWithHA.UpgradeDebugger" >}}

‎content/en/docs/2024.9/Guides/upgrade-cortex/2024.7-to-2024.9/multiple-server-with-ha/upgrade-web-application-server/upgrade-debugger.md‎

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
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 2024.7 to 2024.9. Please ensure that the [prerequisites][] have been completed before starting this upgrade.
11+
12+
## Configure Upgrade Script
13+
14+
{{< section "/upgrade/2024.9/upgrade-application-server/single-server/configure-upgrade-script.md" >}}
15+
16+
## Run Upgrade Script
17+
18+
{{< section "/upgrade/2024.9/upgrade-application-server/single-server/run-upgrade-script.md">}}
19+
20+
## Check Application Services
21+
22+
{{< section "/upgrade/upgrade-application-server/single-server/check-application-services.md">}}
23+
24+
## Preserve installation files
25+
26+
{{< section "/preserve-installation-files.md">}}
27+
28+
## Next Steps?
29+
30+
1. [Upgrade Gateway][]
31+
32+
[prerequisites]: {{< url path="Cortex.Guides.UpgradeCortex.2024.7to2024.9.MultipleServerWithHA.WebApplicationServerPreqrequisites" >}}
33+
[Upgrade Gateway]: {{< url path="Cortex.Guides.UpgradeCortex.2024.7to2024.9.MultipleServerWithHA.UpgradeGateway" >}}

‎content/en/docs/2024.9/Guides/upgrade-cortex/2024.7-to-2024.9/multiple-server-with-ha/upgrade-web-application-server/upgrade-gateway.md‎

Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,37 @@
1+
---
2+
title: "Upgrade Gateway"
3+
linkTitle: "Upgrade Gateway"
4+
description: "Information about upgrading {{% ctx %}} Gateway from 2024.7 to 2024.9."
5+
weight: 30
6+
---
7+
8+
# {{% param title %}}
9+
10+
This guide describes how to upgrade {{% ctx %}} Gateway from 2024.7 to 2024.9. Please ensure that the [Flow Debugger upgrade][] has been completed before starting this upgrade.
11+
12+
## Configure Upgrade Script
13+
14+
{{< section "/upgrade/2024.9/upgrade-web-application-server/configure-gateway-script.md" >}}
15+
16+
## Run Upgrade Script
17+
18+
{{< section "/upgrade/2024.9/upgrade-web-application-server/run-gateway-script.md" >}}
19+
20+
## Upgrade Flows
21+
22+
{{< section "/upgrade/2024.9/upgrade-web-application-server/upgrade-flows.md" >}}
23+
24+
{{% alert title="Note" %}}
25+
If the {{% ctx %}} Interaction Portal is used in your environment, you must also upgrade those flows.
26+
{{% /alert %}}
27+
28+
## Preserve installation files
29+
30+
{{< section "/preserve-installation-files.md" >}}
31+
32+
## Next Steps?
33+
34+
1. [Try It Out][]
35+
36+
[Flow Debugger upgrade]: {{< url path="Cortex.Guides.UpgradeCortex.2024.7to2024.9.MultipleServerWithHA.UpgradeDebugger" >}}
37+
[Try It Out]: {{< url path="Cortex.Guides.UpgradeCortex.2024.7to2024.9.MultipleServerWithHA.TryItOut" >}}

‎content/en/docs/2024.9/Guides/upgrade-cortex/2024.7-to-2024.9/single-server-without-ha/_index.md‎

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
---
2+
title: "Single Server - Without HA"
3+
linkTitle: "Single Server - Without HA"
4+
description: "Upgrade instructions for a single on-premise server without high availability (HA)."
5+
weight: 500
6+
---

‎content/en/docs/2024.9/Guides/upgrade-cortex/2024.7-to-2024.9/single-server-without-ha/try-it-out.md‎

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
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 Server Upgrade][] and [Web Application Server Upgrade][] has been completed before taking these steps.
11+
12+
{{< section "/upgrade/try-it-out/test-upgrade.md" >}}
13+
14+
## Test Executing Production Flows
15+
16+
{{< section "/upgrade/try-it-out/single-server/test-executing-production-flows.md" >}}
17+
18+
[Application Server Upgrade]: {{< url path="Cortex.Guides.UpgradeCortex.2024.7to2024.9.SingleServerWithoutHA.UpgradeApplicationServer" >}}
19+
[Web Application Server Upgrade]: {{< url path="Cortex.Guides.UpgradeCortex.2024.7to2024.9.SingleServerWithoutHA.UpgradeWebApplicationServer" >}}

0 commit comments

Comments
 (0)