From 5e6b7dbc9b1eb466f0e7175cab89465cb52acc18 Mon Sep 17 00:00:00 2001 From: Esha Noronha Date: Tue, 8 Oct 2024 15:43:51 +0200 Subject: [PATCH 1/4] Updated article --- .../product-upgrades/minor-upgrades.md | 43 +++++++++++-------- 1 file changed, 26 insertions(+), 17 deletions(-) diff --git a/umbraco-cloud/product-upgrades/minor-upgrades.md b/umbraco-cloud/product-upgrades/minor-upgrades.md index e8dc427f8b4..4fcd24f8df4 100644 --- a/umbraco-cloud/product-upgrades/minor-upgrades.md +++ b/umbraco-cloud/product-upgrades/minor-upgrades.md @@ -1,24 +1,29 @@ --- -description: This article explains how Minor upgrades on Umbraco Cloud works. +description: This article explains how Minor upgrades work in Umbraco Cloud. --- # Minor Upgrades -When a new minor version is released, there are two ways of upgrading your project. For existing projects, you can opt-in for automatic minor upgrades. +When a new minor version is released, there are two ways to upgrade your project: -To enable Automatic Minor Upgrades follow these steps: +- [Automatic Minor Upgrades](#automatic-minor-upgrades) +- [Manual Minor Upgrades](#manual-minor-upgrades) + +## Automatic Minor Upgrades + +To enable automatic minor upgrades, follow these steps: 1. Go to your Umbraco Cloud project. -2. Go to `Settings` -> `Automatic Upgrades`. +2. Navigate to **Configuration** -> **Automatic Upgrades**.
Settings Umbraco Cloud

Settings Umbraco Cloud

-3. Enable Automatic Minor Upgrades +3. Enable **Automatic Minor Upgrades**.

Enable Minor Upgrades

-With automatic upgrades enabled it will be applied to all products on Umbraco Cloud: Umbraco CMS, Umbraco Forms, and Umbraco Deploy. Your project does not need to be running the latest minor for automatic upgrades to work. The project will be upgraded to the latest minor when it is released. +With automatic upgrades enabled, it will be applied to all products on Umbraco Cloud: Umbraco CMS, Umbraco Forms, and Umbraco Deploy. Your project does not need to be running the latest minor version for automatic upgrades to work. The project will be upgraded to the latest minor version when it is released. -If you create a new project on Umbraco Cloud the project will by default have automatic minor upgrades enabled. +If you create a new project on Umbraco Cloud, by default, automatic minor upgrades will be enabled. {% hint style="info" %} For projects where automatic minor upgrades are enabled, having a Development environment is not compulsory. However, it is highly recommended to facilitate a smoother and more controlled upgrade experience. In cases where manual upgrades are necessary, a Development environment becomes essential. @@ -26,17 +31,21 @@ For projects where automatic minor upgrades are enabled, having a Development en A development environment is included in all Umbraco Cloud plans, except Starter. Find pricing details for Umbraco Cloud Starter plans on our [website](https://umbraco.com/products/umbraco-cloud/pricing). -A manual upgrade involves a more hands-on approach, where the upgrade process is initiated and controlled by the user or development team. This allows for greater flexibility and oversight, enabling teams to test and adapt the upgrade to their specific needs and configurations. Particularly, it provides an opportunity to thoroughly test the new version in a controlled environment before applying it to live production environments. This ensures compatibility and minimizes disruptions. +## Manual Minor Upgrades + +A manual upgrade involves a more hands-on approach, where the upgrade process is initiated and controlled by the user or development team. This allows for greater flexibility and oversight, enabling teams to test and adapt the upgrade to their specific needs and configurations. A manual upgrade provides an opportunity to thoroughly test the new version in a controlled environment before applying it to live production environments. This ensures compatibility and minimizes disruptions. + +For more information about manual minor upgrades, see the [Manual upgrade of Umbraco CMS](../product-upgrades/manual-upgrades/manual-cms-upgrade.md) article. -## Troubleshooting Automated minor upgrades +## Troubleshooting Automated Minor Upgrades -Umbraco Cloud supports doing minor upgrades to your projects in an automated manner. The feature is available when a new minor version of Umbraco is released (for example 10.5.0 or 10.6.0). +Umbraco Cloud supports performing minor upgrades to your projects automatically. The feature is available when a new minor version of Umbraco is released (for example 10.5.0 or 10.6.0). -The upgrade will cover most issues it encounters, but at certain Umbraco configurations, it needs some manual intervention. This is usually related to custom code being dependent on some APIs that have either changed or been removed for the new minor upgrade. +The upgrade will cover most issues it encounters, but some Umbraco configurations may need some manual intervention. This is usually related to custom code that depends on APIs that have changed or been removed in the new minor version. -In general, if anything should fail during this process, you can reach out for support, using the in-app chat in the bottom right corner. We will help you through the upgrade process, should anything happen. +If anything fails during this process, you can reach out for support using the in-app chat in the bottom right corner. We will assist you through the upgrade process if any issues arise. -## Database upgrade failing +## Database Upgrade Failing Symptoms and feedback are given from the upgrade process: **Unable to run the Umbraco installer** @@ -44,17 +53,17 @@ The first step in the process, after having updated all the files, is to call th It can be code that references APIs that have been deprecated, or code that has some strong references to specific versions. If the error is clear, it will be shown on the screen. It will be a typical ASP.NET error message also called a Yellow Screen of Death (YSOD). You should request the site, and check the error it shows. If the error isn't descriptive, then it is time to clone the repository to your local machine and fix the issue. The usual suspects would be: -* The code you have running is referencing an API that has been changed, is being modified, is obsolete, or removed. -* The `web.config` had assembly bindings for a specific DLL version that doesn't exist anymore. During the upgrade process, we do update the references we are shipping, but there might be something missing. +- The code you have running is referencing an API that has been changed, is being modified, is obsolete, or removed. +- The `web.config` had assembly bindings for a specific DLL version that doesn't exist anymore. During the upgrade process, we do update the references we are shipping, but there might be something missing. Once you have the site running locally, you should push your changes to the repository. This will update the site, and it should now be in a running state. The upgrade process left off when it needed three more steps. These three steps now need to be done manually. 1. Complete the installer - * To complete the installer, you should visit the site: `https://dev-YOURSITEALIAS.euwest01.umbraco.io`. This will show you the installer screen, where you should insert your backoffice credentials and follow the process. It will run through a few steps, and later Umbraco will be updated to the latest version. + - To complete the installer, you should visit the site: `https://dev-YOURSITEALIAS.euwest01.umbraco.io`. This will show you the installer screen, where you should insert your backoffice credentials and follow the process. It will run through a few steps, and later Umbraco will be updated to the latest version. 2. Export the metadata files. - * The second thing you need to do is to regenerate the metadata files used for transferring items like document types, data types, and media types. This is done by accessing the Power tools (Kudu) on the project, opening the cmd prompt, and browsing to the wwwroot/data folder. Once there, you need to enter `echo > deploy-export`. This will generate the required files for the upgraded site to work with Umbraco Deploy. + - The second thing you need to do is to regenerate the metadata files used for transferring items like document types, data types, and media types. This is done by accessing the Power tools (Kudu) on the project, opening the cmd prompt, and browsing to the wwwroot/data folder. Once there, you need to enter `echo > deploy-export`. This will generate the required files for the upgraded site to work with Umbraco Deploy. 3. The last thing to do is to go to the `/site/locks` folder (still through Kudu) and rename the file called `upgrading` to `upgraded-minor` - rename the file by typing `ren upgrading upgraded-minor`. This will indicate to Umbraco Cloud, that the development environment is now ready to deploy all its changes to the next environment. Before deploying the upgrade to the next environment, you should verify that everything looks as expected on the development environment. From 94b9190b67e7832ad897131187634ad6ec029254 Mon Sep 17 00:00:00 2001 From: Esha Noronha <82437098+eshanrnh@users.noreply.github.com> Date: Wed, 9 Oct 2024 10:21:13 +0200 Subject: [PATCH 2/4] Update umbraco-cloud/product-upgrades/minor-upgrades.md Co-authored-by: sofietoft --- umbraco-cloud/product-upgrades/minor-upgrades.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/umbraco-cloud/product-upgrades/minor-upgrades.md b/umbraco-cloud/product-upgrades/minor-upgrades.md index 4fcd24f8df4..308d1d4d3fc 100644 --- a/umbraco-cloud/product-upgrades/minor-upgrades.md +++ b/umbraco-cloud/product-upgrades/minor-upgrades.md @@ -21,7 +21,7 @@ To enable automatic minor upgrades, follow these steps:

Enable Minor Upgrades

-With automatic upgrades enabled, it will be applied to all products on Umbraco Cloud: Umbraco CMS, Umbraco Forms, and Umbraco Deploy. Your project does not need to be running the latest minor version for automatic upgrades to work. The project will be upgraded to the latest minor version when it is released. +With automatic upgrades enabled, all products on Umbraco Cloud will automatically be upgraded. This includes Umbraco CMS, Umbraco Forms, and Umbraco Deploy. Your project does not need to be running the latest minor version for automatic upgrades to work. The project will be upgraded to the latest minor version when it is released. If you create a new project on Umbraco Cloud, by default, automatic minor upgrades will be enabled. From a1d44ec09787db72a5dc39f3e06ffd47ac7d1c1b Mon Sep 17 00:00:00 2001 From: Esha Noronha <82437098+eshanrnh@users.noreply.github.com> Date: Wed, 9 Oct 2024 10:21:25 +0200 Subject: [PATCH 3/4] Update umbraco-cloud/product-upgrades/minor-upgrades.md Co-authored-by: sofietoft --- umbraco-cloud/product-upgrades/minor-upgrades.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/umbraco-cloud/product-upgrades/minor-upgrades.md b/umbraco-cloud/product-upgrades/minor-upgrades.md index 308d1d4d3fc..5e71c5cc1ab 100644 --- a/umbraco-cloud/product-upgrades/minor-upgrades.md +++ b/umbraco-cloud/product-upgrades/minor-upgrades.md @@ -23,7 +23,7 @@ To enable automatic minor upgrades, follow these steps: With automatic upgrades enabled, all products on Umbraco Cloud will automatically be upgraded. This includes Umbraco CMS, Umbraco Forms, and Umbraco Deploy. Your project does not need to be running the latest minor version for automatic upgrades to work. The project will be upgraded to the latest minor version when it is released. -If you create a new project on Umbraco Cloud, by default, automatic minor upgrades will be enabled. +If you create a new project on Umbraco Cloud automatic upgrades are enabled by default. {% hint style="info" %} For projects where automatic minor upgrades are enabled, having a Development environment is not compulsory. However, it is highly recommended to facilitate a smoother and more controlled upgrade experience. In cases where manual upgrades are necessary, a Development environment becomes essential. From 638b76ae6da60ff6e5dcfc005e1d4393fb42ef38 Mon Sep 17 00:00:00 2001 From: Esha Noronha <82437098+eshanrnh@users.noreply.github.com> Date: Wed, 9 Oct 2024 10:21:36 +0200 Subject: [PATCH 4/4] Update umbraco-cloud/product-upgrades/minor-upgrades.md Co-authored-by: sofietoft --- umbraco-cloud/product-upgrades/minor-upgrades.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/umbraco-cloud/product-upgrades/minor-upgrades.md b/umbraco-cloud/product-upgrades/minor-upgrades.md index 5e71c5cc1ab..ffdb1ac7237 100644 --- a/umbraco-cloud/product-upgrades/minor-upgrades.md +++ b/umbraco-cloud/product-upgrades/minor-upgrades.md @@ -41,7 +41,7 @@ For more information about manual minor upgrades, see the [Manual upgrade of Umb Umbraco Cloud supports performing minor upgrades to your projects automatically. The feature is available when a new minor version of Umbraco is released (for example 10.5.0 or 10.6.0). -The upgrade will cover most issues it encounters, but some Umbraco configurations may need some manual intervention. This is usually related to custom code that depends on APIs that have changed or been removed in the new minor version. +The upgrade will resolve most issues it encounters, but some Umbraco configurations may need manual intervention. This is usually related to custom code that depends on APIs that have changed or been removed in the new minor version. If anything fails during this process, you can reach out for support using the in-app chat in the bottom right corner. We will assist you through the upgrade process if any issues arise.