CortexIntelligentAutomation · Cortex-DMS · Jan 29, 2025 · Jan 27, 2025 · Jan 28, 2025 · Jan 28, 2025
diff --git a/content/en/docs/2025.1/Guides/upgrade-cortex/2024.11-to-2025.1/_index.md b/content/en/docs/2025.1/Guides/upgrade-cortex/2024.11-to-2025.1/_index.md
@@ -0,0 +1,6 @@
+---
+title: "2024.11 to 2025.1"
+linkTitle: "2024.11 to 2025.1"
+description: "Instructions to upgrade {{% ctx %}} 2024.11 to 2025.1"
+weight: 980
+---
diff --git a/...025.1/Guides/upgrade-cortex/2024.11-to-2025.1/multiple-server-with-ha/_index.md b/...025.1/Guides/upgrade-cortex/2024.11-to-2025.1/multiple-server-with-ha/_index.md
@@ -0,0 +1,6 @@
+---
+title: "Multiple Server - With HA"
+linkTitle: "Multiple Server - With HA"
+description: "Upgrade instructions for multiple on-premise servers with high availability (HA)."
+weight: 10
+---
diff --git a/.../Guides/upgrade-cortex/2024.11-to-2025.1/multiple-server-with-ha/pre-upgrade.md b/.../Guides/upgrade-cortex/2024.11-to-2025.1/multiple-server-with-ha/pre-upgrade.md
@@ -0,0 +1,20 @@
+---
+title: "Pre-Upgrade"
+linkTitle: "Pre-Upgrade"
+description: "Information about the steps required to be completed prior to starting the upgrade."
+weight: 30
+---
+
+# {{% param title %}}
+
+This guide describes how to perform the steps required before starting the upgrade of {{% ctx %}} Innovation.
+
+## Make Installation Artefacts Available on all Servers
+
+{{< section "/upgrade/2025.1/pre-upgrade/multi-server/make-artefacts-available.md">}}
+
+## Next Steps?
+
+1. [Upgrade][]
+
+[Upgrade]: {{< url path="Cortex.Guides.UpgradeCortex.2024.11to2025.1.MultipleServerWithHA.Upgrade" >}}
diff --git a/...1/Guides/upgrade-cortex/2024.11-to-2025.1/multiple-server-with-ha/try-it-out.md b/...1/Guides/upgrade-cortex/2024.11-to-2025.1/multiple-server-with-ha/try-it-out.md
@@ -0,0 +1,19 @@
+---
+title: "Try it out"
+linkTitle: "Try it out"
+description: "Information about trying out {{% ctx %}} after upgrade."
+weight: 60
+---
+
+# {{% param title %}}
+
+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.
+
+{{< section "/upgrade/2025.1/upgrade-web-application-server/test-upgrade.md" >}}
+
+## Test Executing Production Flows
+
+{{< section "/upgrade/try-it-out/multi-server/test-executing-production-flows.md" >}}
+
+[Application Servers and Load Balancer Upgrade]: {{< url path="Cortex.Guides.UpgradeCortex.2024.11to2025.1.MultipleServerWithHA.UpgradeApplicationAndLoadBalancerServers" >}}
+[Web Application Server Upgrade]: {{< url path="Cortex.Guides.UpgradeCortex.2024.11to2025.1.MultipleServerWithHA.UpgradeWebApplicationServer" >}}
diff --git a/...ides/upgrade-cortex/2024.11-to-2025.1/multiple-server-with-ha/upgrade/_index.md b/...ides/upgrade-cortex/2024.11-to-2025.1/multiple-server-with-ha/upgrade/_index.md
@@ -0,0 +1,10 @@
+---
+title: "Upgrade"
+linkTitle: "Upgrade"
+description: "Instructions to upgrade {{% ctx %}} Innovation across multiple on-premise servers with high availability (HA)."
+weight: 40
+---
+
+This guide describes how to upgrade {{% ctx %}} Innovation. Please ensure that the [Pre-Upgrade][PreUpgrade] steps have been completed before starting the upgrade.
+
+[PreUpgrade]: {{< url path="Cortex.Guides.UpgradeCortex.2024.11to2025.1.MultipleServerWithHA.PreUpgrade" >}}
diff --git a/...multiple-server-with-ha/upgrade/upgrade-application-and-loadbalancer-servers.md b/...multiple-server-with-ha/upgrade/upgrade-application-and-loadbalancer-servers.md
@@ -0,0 +1,71 @@
+---
+title: "Upgrade Application Servers and Load Balancer"
+linkTitle: "Upgrade Application Servers and Load Balancer"
+description: "Information about upgrading the Application Servers and Load Balancer Server."
+weight: 30
+---
+
+# {{< param title >}}
+
+This guide describes how to upgrade the Application Servers and Load Balancer Server from 2024.11 to 2025.1. Please ensure that the [Pre-Upgrade][PreUpgrade] steps have been completed before starting this upgrade.
+
+## Configure Upgrade Script
+
+1. In the `Cortex Innovation 2025.1 - App Server Install Scripts\Upgrade Application Server` folder, locate the `Cortex.Innovation.Upgrade.ps1` script and open it with a text editor.
+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:
+
+    {{% alert title="Note" %}}
+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.
+    {{% /alert %}}
+
+    {{< tabpane lang="powershell" >}}
+        {{< tab header="Use Previous Configuration Values" >}}
+.\Cortex.Upgrade.ps1 `
+    -AppServicesPath "C:\Install\Cortex Innovation 2025.1 - App Services.zip" `
+    -BlockPackagesPath "C:\Install\Cortex Innovation 2025.1 - Block Packages.zip" `
+    -Credential $Credential `
+    -AcceptEULA:$AcceptEULA `
+    *>&1 | Tee-Object -FilePath "cortex-ha-upgrade-log.txt"
+        {{< /tab >}}
+        {{< tab header="Use New Configuration Values">}}
+.\Cortex.Upgrade.ps1 `
+    -AppServicesPath "C:\Install\Cortex Innovation 2025.1 - App Services.zip" `
+    -BlockPackagesPath "C:\Install\Cortex Innovation 2025.1 - Block Packages.zip" `
+    -ApplicationServerIPv4Addresses @("192.168.1.1, 192.168.1.2, 192.168.1.3") `
+    -LoadBalancerServerIPv4Address "192.168.1.4" `
+    -Credential $Credential `
+    -AcceptEULA:$AcceptEULA `
+    *>&1 | Tee-Object -FilePath "cortex-ha-upgrade-log.txt"
+        {{< /tab >}}
+    {{< /tabpane >}}
+
+    | Name                                         | Description |
+    |----------------------------------------------|-------------|
+    |`AppServicesPath`                             | Configure this value with the location of the Application Services zip file on the Application Server being used for the upgrade. |
+    |`BlockPackagesPath`                           | Configure this value with the location of the Block Packages zip file on the Application Server being used for the upgrade. |
+    |`ApplicationServerIPv4Addresses`              | The IPv4 addresses of the Application Servers. The first of these must be the Application Server being used for the upgrade.|
+    |`LoadBalancerServerIPv4Address`               | The IPv4 address of the Load Balancer Server. If the built-in load balancer is not being used, this should be removed.|
+    |`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. |
+    |`AcceptEULA`                                  | This does not need to be changed, the EULA will be accepted at a later stage. |
+    |`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. |
+
+1. Save and close `Cortex.Innovation.Upgrade.ps1`.
+
+## Run Upgrade Script
+
+{{< section "/upgrade/2025.1/upgrade-application-server/multi-server/run-upgrade-script.md" >}}
+
+## Check Application Services
+
+{{< section "/upgrade/upgrade-application-server/multi-server/check-application-services.md" >}}
+
+## Preserve installation files
+
+{{< section "/preserve-installation-files.md" >}}
+
+## Next Steps?
+
+1. [Upgrade Web Application Server][]
+
+[PreUpgrade]: {{< url path="Cortex.Guides.UpgradeCortex.2024.11to2025.1.MultipleServerWithHA.PreUpgrade" >}}
+[Upgrade Web Application Server]: {{< url path="Cortex.Guides.UpgradeCortex.2024.11to2025.1.MultipleServerWithHA.UpgradeWebApplicationServer" >}}
diff --git a/...2025.1/multiple-server-with-ha/upgrade/upgrade-web-application-server/_index.md b/...2025.1/multiple-server-with-ha/upgrade/upgrade-web-application-server/_index.md
@@ -0,0 +1,10 @@
+---
+title: "Upgrade the Web Application Server"
+linkTitle: "Upgrade Web Application Server"
+description: "Information about upgrading the Web Application Server."
+weight: 40
+---
+
+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.11 version of Gateway and its prerequisites have already been installed.
+
+[Upgrade Application Servers and Load Balancer]: {{< url path="Cortex.Guides.UpgradeCortex.2024.11to2025.1.MultipleServerWithHA.UpgradeApplicationAndLoadBalancerServers" >}}
diff --git a/...tiple-server-with-ha/upgrade/upgrade-web-application-server/upgrade-debugger.md b/...tiple-server-with-ha/upgrade/upgrade-web-application-server/upgrade-debugger.md
@@ -0,0 +1,33 @@
+---
+title: "Upgrade Flow Debugger"
+linkTitle: "Upgrade Flow Debugger"
+description: "Information about upgrading the Flow Debugger."
+weight: 30
+---
+
+# {{< param title >}}
+
+This guide describes how to upgrade the Flow Debugger on the Web Application Server from 2024.11 to 2025.1. Please ensure that the [Upgrade Application and Load Balancer Servers][] has been completed before starting this upgrade.
+
+## Configure Upgrade Script
+
+{{< section "/upgrade/2025.1/upgrade-application-server/single-server/configure-upgrade-script.md" >}}
+
+## Run Upgrade Script
+
+{{< section "/upgrade/2025.1/upgrade-application-server/single-server/run-upgrade-script.md">}}
+
+## Check Application Services
+
+{{< section "/upgrade/upgrade-application-server/single-server/check-application-services.md">}}
+
+## Preserve installation files
+
+{{< section "/preserve-installation-files.md">}}
+
+## Next Steps?
+
+1. [Upgrade Gateway][]
+
+[Upgrade Application and Load Balancer Servers]: {{< url path="Cortex.Guides.UpgradeCortex.2024.11to2025.1.MultipleServerWithHA.UpgradeApplicationAndLoadBalancerServers" >}}
+[Upgrade Gateway]: {{< url path="Cortex.Guides.UpgradeCortex.2024.11to2025.1.MultipleServerWithHA.UpgradeGateway" >}}
diff --git a/...ltiple-server-with-ha/upgrade/upgrade-web-application-server/upgrade-gateway.md b/...ltiple-server-with-ha/upgrade/upgrade-web-application-server/upgrade-gateway.md
@@ -0,0 +1,33 @@
+---
+title: "Upgrade Gateway"
+linkTitle: "Upgrade Gateway"
+description: "Information about upgrading {{% ctx %}} Gateway from 2024.11 to 2025.1."
+weight: 30
+---
+
+# {{% param title %}}
+
+This guide describes how to upgrade {{% ctx %}} Gateway from 2024.11 to 2025.1. Please ensure that the [Flow Debugger upgrade][] has been completed before starting this upgrade.
+
+## Configure Upgrade Script
+
+{{< section "/upgrade/2025.1/upgrade-web-application-server/configure-gateway-script.md" >}}
+
+## Run Upgrade Script
+
+{{< section "/upgrade/2025.1/upgrade-web-application-server/run-gateway-script.md" >}}
+
+## Preserve installation files
+
+{{< section "/preserve-installation-files.md" >}}
+
+## Upgrade {{% ctx %}} Interaction Portal
+
+{{< section "/upgrade/2025.1/upgrade-web-application-server/upgrade-cortex-interaction-portal.md" >}}
+
+## Next Steps?
+
+1. [Try It Out][]
+
+[Flow Debugger upgrade]: {{< url path="Cortex.Guides.UpgradeCortex.2024.11to2025.1.MultipleServerWithHA.UpgradeDebugger" >}}
+[Try It Out]: {{< url path="Cortex.Guides.UpgradeCortex.2024.11to2025.1.MultipleServerWithHA.TryItOut" >}}
diff --git a/...25.1/Guides/upgrade-cortex/2024.11-to-2025.1/single-server-without-ha/_index.md b/...25.1/Guides/upgrade-cortex/2024.11-to-2025.1/single-server-without-ha/_index.md
@@ -0,0 +1,6 @@
+---
+title: "Single Server - Without HA"
+linkTitle: "Single Server - Without HA"
+description: "Upgrade instructions for a single on-premise server without high availability (HA)."
+weight: 500
+---
diff --git a/...Guides/upgrade-cortex/2024.11-to-2025.1/single-server-without-ha/pre-upgrade.md b/...Guides/upgrade-cortex/2024.11-to-2025.1/single-server-without-ha/pre-upgrade.md
@@ -0,0 +1,20 @@
+---
+title: "Pre-Upgrade"
+linkTitle: "Pre-Upgrade"
+description: "Information about the steps required to be completed prior to starting the upgrade."
+weight: 30
+---
+
+# {{% param title %}}
+
+This guide describes how to perform the steps required before starting the upgrade of {{% ctx %}} Innovation.
+
+## Make Installation Artefacts Available
+
+{{< section "/upgrade/2025.1/pre-upgrade/single-server/make-artefacts-available.md">}}
+
+## Next Steps?
+
+1. [Upgrade][]
+
+[Upgrade]: {{< url path="Cortex.Guides.UpgradeCortex.2024.11to2025.1.SingleServerWithoutHA.Upgrade" >}}
diff --git a/.../Guides/upgrade-cortex/2024.11-to-2025.1/single-server-without-ha/try-it-out.md b/.../Guides/upgrade-cortex/2024.11-to-2025.1/single-server-without-ha/try-it-out.md
@@ -0,0 +1,19 @@
+---
+title: "Try it out"
+linkTitle: "Try it out"
+description: "Information about trying out {{% ctx %}} after upgrade."
+weight: 60
+---
+
+# {{% param title %}}
+
+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.
+
+{{< section "/upgrade/2025.1/upgrade-web-application-server/test-upgrade.md" >}}
+
+## Test Executing Production Flows
+
+{{< section "/upgrade/try-it-out/single-server/test-executing-production-flows.md" >}}
+
+[Application Server Upgrade]: {{< url path="Cortex.Guides.UpgradeCortex.2024.11to2025.1.SingleServerWithoutHA.UpgradeApplicationServer" >}}
+[Web Application Server Upgrade]: {{< url path="Cortex.Guides.UpgradeCortex.2024.11to2025.1.SingleServerWithoutHA.UpgradeWebApplicationServer" >}}
diff --git a/...des/upgrade-cortex/2024.11-to-2025.1/single-server-without-ha/upgrade/_index.md b/...des/upgrade-cortex/2024.11-to-2025.1/single-server-without-ha/upgrade/_index.md
@@ -0,0 +1,10 @@
+---
+title: "Upgrade"
+linkTitle: "Upgrade"
+description: "Instructions to upgrade {{% ctx %}} Innovation on a single on-premise server without high availability (HA)."
+weight: 40
+---
+
+This guide describes how to upgrade {{% ctx %}} Innovation. Please ensure that the [Pre-Upgrade][PreUpgrade] steps have been completed before starting the upgrade.
+
+[PreUpgrade]: {{< url path="Cortex.Guides.UpgradeCortex.2024.11to2025.1.SingleServerWithoutHA.PreUpgrade" >}}
diff --git a/...024.11-to-2025.1/single-server-without-ha/upgrade/upgrade-application-server.md b/...024.11-to-2025.1/single-server-without-ha/upgrade/upgrade-application-server.md
@@ -0,0 +1,33 @@
+---
+title: "Upgrade Application Server"
+linkTitle: "Upgrade Application Server"
+description: "Information about upgrading the Application Server."
+weight: 30
+---
+
+# {{< param title >}}
+
+This guide describes how to upgrade the Application Server components on the server from 2024.11 to 2025.1. Please ensure that the [Pre-Upgrade][PreUpgrade] steps have been completed before starting this upgrade.
+
+## Configure Upgrade Script
+
+{{< section "/upgrade/2025.1/upgrade-application-server/single-server/configure-upgrade-script.md" >}}
+
+## Run Upgrade Script
+
+{{< section "/upgrade/2025.1/upgrade-application-server/single-server/run-upgrade-script.md" >}}
+
+## Check Application Services
+
+{{< section "/upgrade/upgrade-application-server/single-server/check-application-services.md" >}}
+
+## Preserve installation files
+
+{{< section "/preserve-installation-files.md" >}}
+
+## Next Steps?
+
+1. [Upgrade Web Application Server][]
+
+[PreUpgrade]: {{< url path="Cortex.Guides.UpgradeCortex.2024.11to2025.1.SingleServerWithoutHA.PreUpgrade" >}}
+[Upgrade Web Application Server]: {{< url path="Cortex.Guides.UpgradeCortex.2024.11to2025.1.SingleServerWithoutHA.UpgradeWebApplicationServer" >}}
diff --git a/...11-to-2025.1/single-server-without-ha/upgrade/upgrade-web-application-server.md b/...11-to-2025.1/single-server-without-ha/upgrade/upgrade-web-application-server.md
@@ -0,0 +1,33 @@
+---
+title: "Upgrade Web Application Server"
+linkTitle: "Upgrade Web Application Server"
+description: "Information about upgrading the Web Application Server from 2024.11 to 2025.1."
+weight: 30
+---
+
+# {{% param title %}}
+
+This guide describes how to upgrade {{% ctx %}} Gateway from 2024.11 to 2025.1. Please ensure that the [Upgrade Application Server][] has been completed before starting this upgrade.
+
+## Configure Upgrade Script
+
+{{< section "/upgrade/2025.1/upgrade-web-application-server/configure-gateway-script.md" >}}
+
+## Run Upgrade Script
+
+{{< section "/upgrade/2025.1/upgrade-web-application-server/run-gateway-script.md" >}}
+
+## Preserve installation files
+
+{{< section "/preserve-installation-files.md" >}}
+
+## Upgrade {{% ctx %}} Interaction Portal
+
+{{< section "/upgrade/2025.1/upgrade-web-application-server/upgrade-cortex-interaction-portal.md" >}}
+
+## Next Steps?
+
+1. [Try It Out][]
+
+[Try It Out]: {{< url path="Cortex.Guides.UpgradeCortex.2024.11to2025.1.SingleServerWithoutHA.TryItOut" >}}
+[Upgrade Application Server]: {{< url path="Cortex.Guides.UpgradeCortex.2024.11to2025.1.SingleServerWithoutHA.UpgradeApplicationServer" >}}
diff --git a/content/en/docs/2025.1/Guides/upgrade-cortex/2024.9-to-2024.11/_index.md b/content/en/docs/2025.1/Guides/upgrade-cortex/2024.9-to-2024.11/_index.md
@@ -2,5 +2,5 @@
 title: "2024.9 to 2024.11"
 linkTitle: "2024.9 to 2024.11"
 description: "Instructions to upgrade {{% ctx %}} 2024.9 to 2024.11"
-weight: 996
+weight: 990
 ---
diff --git a/content/en/docs/2025.1/_index.md b/content/en/docs/2025.1/_index.md
@@ -2,5 +2,5 @@
 title: "2025.1"
 linkTitle: "2025.1"
 description: "Product documentation for the {{% ctx %}} automation platform, including guides, tutorials and reference documentation."
-weight: 989
+weight: 988
 ---
diff --git a/...5.1/_shared/upgrade/2025.1/pre-upgrade/multi-server/make-artefacts-available.md b/...5.1/_shared/upgrade/2025.1/pre-upgrade/multi-server/make-artefacts-available.md
@@ -0,0 +1,31 @@
+1. Choose one of the Application Servers to be used for installation, and copy the following artefacts to a folder on it:
+   * Cortex Innovation 2025.1 - App Server Install Scripts.zip
+   * Cortex Innovation 2025.1 - App Services.zip
+   * Cortex Innovation 2025.1 - Block Packages.zip
+   * Cortex Innovation 2025.1 - Encryptor.zip
+   * Cortex Innovation 2025.1 - Gateway.zip
+   * Cortex Innovation 2025.1 - Web App Server Install Scripts.zip
+
+    {{< alert title="Important" color="warning" >}}Only the files for the version to be installed should be in the containing folder. There should not be any other versions of the files in this folder or a subfolder.{{% /alert %}}
+
+1. Extract the `Cortex Innovation 2025.1 - App Server Install Scripts.zip` file to a folder with the same name.
+1. Open a Windows PowerShell (x64) window as administrator.
+1. Navigate PowerShell to inside the `Cortex Innovation 2025.1 - App Server Install Scripts` folder using the following command, modifying the path as necessary:
+
+    ```powershell
+    cd "C:\Install\Cortex Innovation 2025.1 - App Server Install Scripts"
+    ```
+
+1. Ensure that the `Cortex.Innovation.Install.PreInstallation.ps1` script has not been blocked by the operating system by running the following command:
+
+    ```powershell
+    Unblock-File -Path .\Cortex.Innovation.Install.Preinstallation.ps1
+    ```
+
+1. Run the `Cortex.Innovation.Install.PreInstallation.ps1` script using the following command, modifying the `ApplicationServers` value to contain the NETBIOS names or fully qualified domain names of the Application Servers, the `WebApplicationServer` value to contain the NETBIOS names or fully qualified domain name of the Web Application Server and the  `LoadBalancerServer` value to contain the NETBIOS names or fully qualified domain name of the Load Balancer Server (remove the `LoadBalancerServer` parameter if using an [alternative load balancer][]):
+
+    ```powershell
+    .\Cortex.Innovation.Install.Preinstallation.ps1 -ApplicationServers @("app-server1", "app-server2", "app-server3") -WebApplicationServer "webapp-server" -LoadBalancerServer "lb-server"
+    ```
+
+[alternative load balancer]: {{< url path="Cortex.GettingStarted.OnPremise.InstallInnovationOnly.MultipleServerWithHA.AltLoadBalancerNew" >}}