Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Feature/add instructions to resolve breaking changes #168

Merged
Prev Previous commit
Next Next commit
updated format of notes
cortex-bt committed Oct 8, 2024
commit dbe123f49a1a8927a15bf4f47f358bbda0b30aae
Original file line number Diff line number Diff line change
@@ -27,7 +27,7 @@ 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" >}}

## Preserve installation files
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
1. Unpublish existing published packages and create new versions
{{< 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 >}}

* Log in to Gateway with a user that has the `Admin` role.
* Click on the `Admin` charm, then `Packages`.
* In the `Package Definitions` grid, select `Is Published` filter on the `Is Published` column to show all published packages.
* 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 CORTEX 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 CORTEX Gateway, or the Application Services aren’t healthy. See Troubleshooting for more information.
Original file line number Diff line number Diff line change
@@ -1,11 +1,9 @@
1. Unpublish existing published packages and create new versions
{{< 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 >}}

* Log in to Gateway with a user that has the `Admin` role.
* Click on the `Admin` charm, then `Packages`.
* In the `Package Definitions` grid, select `Is Published` filter on the `Is Published` column to show all published packages.
* 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 CORTEX 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 CORTEX Gateway, or the Application Services aren’t healthy. See Troubleshooting for more information.
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 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 CORTEX 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 CORTEX Gateway, or the Application Services aren’t healthy. See Troubleshooting for more information.