diff --git a/content/en/docs/2024.9/Guides/upgrade-cortex/2024.7-to-2024.9/multiple-server-with-ha/upgrade-web-application-server/upgrade-gateway.md b/content/en/docs/2024.9/Guides/upgrade-cortex/2024.7-to-2024.9/multiple-server-with-ha/upgrade-web-application-server/upgrade-gateway.md index 44a037294..c10bf9752 100644 --- a/content/en/docs/2024.9/Guides/upgrade-cortex/2024.7-to-2024.9/multiple-server-with-ha/upgrade-web-application-server/upgrade-gateway.md +++ b/content/en/docs/2024.9/Guides/upgrade-cortex/2024.7-to-2024.9/multiple-server-with-ha/upgrade-web-application-server/upgrade-gateway.md @@ -17,14 +17,35 @@ This guide describes how to upgrade {{% ctx %}} Gateway from 2024.7 to 2024.9. P {{< section "/upgrade/2024.9/upgrade-web-application-server/run-gateway-script.md" >}} -## Republish packages - {{< alert type="note" title="Note" >}} This only needs to happen for upgrading to this release version as breaking changes were introduced as part of the cleanup of the NServiceBus endpoint and RabbitMQ queues. This step should not be required in future upgrades.{{< /alert >}} -{{< section "/upgrade/2024.9/upgrade-web-application-server/republish-packages.md" >}} - -## Delete old execution service - {{< alert type="note" title="Note" >}} This only needs to happen for upgrading to this release version as breaking changes were introduced as part of the cleanup of the NServiceBus endpoint and RabbitMQ queues. This step should not be required in future upgrades.{{< /alert >}} -{{< section "/upgrade/2024.9/upgrade-web-application-server/delete-old-execution-services.md" >}} -Repeat these instructions for the `Flow Debugger`. +## Republish Packages + {{< alert type="note" title="Note" >}} This only needs to happen for upgrading to this release version as breaking changes were introduced as part of the cleanup of the NServiceBus endpoint and RabbitMQ queues.{{< /alert >}} +1. Log in to Gateway with a user that has the `Admin` role. +1. Click on the `Admin` charm, then `Packages`. +1. In the `Package Definitions` grid, select `Is Published` filter option on the `Is Published` column to show all published packages. +1. For each published package version: + * Select the package. + * 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 + * Click `Create New Version` then click `Save` and wait for the new version to be created. + * 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. + * 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. + +## Delete Old Execution Services + {{< alert type="note" title="Note" >}} This only needs to happen for upgrading to this release version as breaking changes were introduced as part of the cleanup of the NServiceBus endpoint and RabbitMQ queues.{{< /alert >}} + +1. Open a web browser. +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. +1. Expand `Cluster` then `Applications` then `Cortex.Innovation.Execution`. +1. For all old execution applications: + * Click on the drop down menu and select `Delete Application`. Confirm application deletion by following the on-screen instructions. + * Give this a few minutes. If the application does not delete: + * Expand `Nodes` + * For each node: + * Expand the node and select the application that matches the engine version number of the application that is being attempted to be deleted. + * Expand each level up to and including `Code Packages`. + * Click on the drop down menu for `Code` and select `Restart`. Confirm application restart by following the on-screen instructions. + * Give this a few minutes. Once all nodes have been restarted the application should be deleted and disappear from the list of applications. + +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. ## Preserve installation files diff --git a/content/en/docs/2024.9/Guides/upgrade-cortex/2024.7-to-2024.9/single-server-without-ha/upgrade-web-application-server.md b/content/en/docs/2024.9/Guides/upgrade-cortex/2024.7-to-2024.9/single-server-without-ha/upgrade-web-application-server.md index bd510b2b2..2d32c13df 100644 --- a/content/en/docs/2024.9/Guides/upgrade-cortex/2024.7-to-2024.9/single-server-without-ha/upgrade-web-application-server.md +++ b/content/en/docs/2024.9/Guides/upgrade-cortex/2024.7-to-2024.9/single-server-without-ha/upgrade-web-application-server.md @@ -26,9 +26,22 @@ This guide describes how to upgrade {{% ctx %}} Gateway from 2024.7 to 2024.9. P {{< section "/upgrade/2024.9/upgrade-web-application-server/run-gateway-script.md" >}} -## Delete old execution service - {{< alert type="note" title="Note" >}} This only needs to happen for upgrading to this release version as breaking changes were introduced as part of the cleanup of the NServiceBus endpoint and RabbitMQ queues. This step should not be required in future upgrades.{{< /alert >}} -{{< section "/upgrade/2024.9/upgrade-web-application-server/delete-old-execution-services.md" >}} +## Delete Old Execution Service + {{< alert type="note" title="Note" >}} This only needs to happen for upgrading to this release version as breaking changes were introduced as part of the cleanup of the NServiceBus endpoint and RabbitMQ queues.{{< /alert >}} + +1. Open a web browser. +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. +1. Expand `Cluster` then `Applications` then `Cortex.Innovation.Execution`. +1. For all old execution applications: + * Click on the drop down menu and select `Delete Application`. Confirm application deletion by following the on-screen instructions. + * Give this a few minutes. If the application does not delete: + * Expand `Nodes` + * For each node: + * Expand the node and select the application that matches the engine version number of the application that is being attempted to be deleted. + * Expand each level up to and including `Code Packages`. + * Click on the drop down menu for `Code` and select `Restart`. Confirm application restart by following the on-screen instructions. + * Give this a few minutes. Once all nodes have been restarted the application should be deleted and disappear from the list of applications. + ## Preserve installation files diff --git a/content/en/docs/2024.9/_shared/upgrade/2024.9/upgrade-web-application-server/delete-old-execution-services.md b/content/en/docs/2024.9/_shared/upgrade/2024.9/upgrade-web-application-server/delete-old-execution-services.md deleted file mode 100644 index 01a34a339..000000000 --- a/content/en/docs/2024.9/_shared/upgrade/2024.9/upgrade-web-application-server/delete-old-execution-services.md +++ /dev/null @@ -1,12 +0,0 @@ - -1. Navigate to the service fabric explorer in a web browser. -1. Expand `Cluster` then `Applications` then `Cortex.Innovation.Execution`. -1. For all old execution applications: - * Click on the drop down menu and select `Delete Application`. - * Give this a few minutes. If the application does not delete. - * Expand `Nodes` - * For each node: - * Expand the node and select the application that matches the engine version number of the application that is being attempted to be deleted. - * Expand each level up to `Code Packages`. - * Click on the drop down menu for `Code` and select `Restart`. - * Give this a few minutes. The application should be deleted and disappear from the list of applications. diff --git a/content/en/docs/2024.9/_shared/upgrade/2024.9/upgrade-web-application-server/republish-packages.md b/content/en/docs/2024.9/_shared/upgrade/2024.9/upgrade-web-application-server/republish-packages.md deleted file mode 100644 index 8cf2dbe0f..000000000 --- a/content/en/docs/2024.9/_shared/upgrade/2024.9/upgrade-web-application-server/republish-packages.md +++ /dev/null @@ -1,12 +0,0 @@ - -1. Log in to Gateway with a user that has the `Admin` role. -1. Click on the `Admin` charm, then `Packages`. -1. In the `Package Definitions` grid, select `Is Published` filter option on the `Is Published` column to show all published packages. -1. For each published package version: - * Select the package. - * 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. See [Troubleshooting][] for more information. - * Click `Create New Version` then click `Save` and wait for the new version to be created. - * 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. See [Troubleshooting][] for more information. - * 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. - -[Troubleshooting]: {{< url path="Cortex.Reference.Troubleshooting.Upgrade.TroubleshootingDuringUpgrade" >}}