Skip to content

Commit dd54984

Browse files
committed
Moved Unattended section into new article
1 parent 1edd87d commit dd54984

File tree

2 files changed

+60
-57
lines changed

2 files changed

+60
-57
lines changed

16/umbraco-cms/fundamentals/setup/upgrading/upgrade-details.md

Lines changed: 1 addition & 57 deletions
Original file line numberDiff line numberDiff line change
@@ -8,11 +8,10 @@ In this article, you will find everything you need to upgrade your Umbraco CMS p
88

99
If you are new to upgrades, be sure to read the [introduction to upgrades in Umbraco first](./upgrade-introduction.md).
1010

11-
You will find instructions on how to upgrade to a new minor or major version as well as how to run upgrades unattended.
11+
You will find instructions on how to upgrade to a new minor or major version.
1212

1313
* [Upgrade to a new Major](./#upgrade-to-a-new-major)
1414
* [Upgrade to a new Minor](./#upgrade-to-a-new-minor)
15-
* [Run an unattended upgrade](./#run-an-unattended-upgrade)
1615
* [Legacy Umbraco](./#legacy-umbraco)
1716

1817
## Upgrade to a new Major
@@ -134,60 +133,6 @@ When the command completes, open the `.csproj` file to make sure the package ref
134133
```
135134
{% endcode %}
136135

137-
## Run an unattended upgrade
138-
139-
When upgrading your Umbraco project, it is possible to enable the upgrade to run unattended. This means that you will not need to run through the installation wizard when upgrading.
140-
141-
Below you will find the steps you need to take in order to upgrade your project unattended.
142-
143-
{% hint style="info" %}
144-
Are you running a load-balanced setup with multiple servers and environments?
145-
146-
Check out the section about [Unattended upgrades in a load-balanced setup](./#unattended-upgrades-in-a-load-balanced-setup).
147-
{% endhint %}
148-
149-
### Enable the unattended upgrade feature
150-
151-
1. Add the `Umbraco:Cms:Unattended:UpgradeUnattended` configuration key.
152-
2. Set the value of the key to `true`.
153-
154-
{% code title="appsettings.json" %}
155-
```json
156-
{
157-
"Umbraco": {
158-
"CMS": {
159-
"Unattended": {
160-
"UpgradeUnattended": true
161-
}
162-
}
163-
}
164-
}
165-
```
166-
{% endcode %}
167-
168-
### Run the upgrade
169-
170-
With the correct configuration applied, the project will be upgraded on the next boot.
171-
172-
#### Boot order
173-
174-
The Runtime level uses `Run` instead of `Upgrade` to allow the website to continue to boot up directly after the migration is run. This happens instead of initiating the otherwise required restart.
175-
176-
{% hint style="info" %}
177-
The upgrade is run after Composers but before Components, and the `UmbracoApplicationStartingNotification`. This is because the migration requires services that are registered in Composers, and Components require that Umbraco and the database are ready.
178-
{% endhint %}
179-
180-
### Unattended upgrades in a load-balanced setup
181-
182-
Follow the steps outlined below to use unattended upgrades in a load-balanced setup.
183-
184-
1. [Upgrade Umbraco via NuGet](./#upgrade-to-a-new-major).
185-
2. Deploy to all environments.
186-
3. Set the `Umbraco:CMS:Unattended:UpgradeUnattended` configuration key to `true` for **the Main server only**.
187-
4. Boot the Main server, and the upgrade will run automatically.
188-
5. Wait for the upgrade to complete.
189-
6. Boot the Read-Only servers and ensure they do not show the “upgrade required” screen.
190-
191136
## Legacy Umbraco
192137

193138
The steps outlined in this article apply to Umbraco version 10 and later versions.
@@ -201,4 +146,3 @@ Are you upgrading to a minor version for Umbraco 6, 7, or 8? You can find the ap
201146
{% content-ref url="version-specific/minor-upgrades-for-umbraco-7.md" %}
202147
[minor-upgrades-for-umbraco-7.md](version-specific/minor-upgrades-for-umbraco-7.md)
203148
{% endcontent-ref %}
204-
Lines changed: 59 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,59 @@
1+
---
2+
description: Learn how to enable unattended upgrades, allowing your project to upgrade without your interference.
3+
---
4+
5+
# Upgrade Unattended
6+
7+
When upgrading your Umbraco project, it is possible to enable the upgrade to run unattended. This means that you will not need to run through the installation wizard when upgrading.
8+
9+
Below you will find the steps you need to take in order to upgrade your project unattended.
10+
11+
{% hint style="info" %}
12+
Are you running a load-balanced setup with multiple servers and environments?
13+
14+
Check out the section about [Unattended upgrades in a load-balanced setup](./#unattended-upgrades-in-a-load-balanced-setup).
15+
{% endhint %}
16+
17+
## Enable the unattended upgrade feature
18+
19+
1. Add the `Umbraco:Cms:Unattended:UpgradeUnattended` configuration key.
20+
2. Set the value of the key to `true`.
21+
22+
{% code title="appsettings.json" %}
23+
24+
```json
25+
{
26+
"Umbraco": {
27+
"CMS": {
28+
"Unattended": {
29+
"UpgradeUnattended": true
30+
}
31+
}
32+
}
33+
}
34+
```
35+
36+
{% endcode %}
37+
38+
## Run the upgrade
39+
40+
With the correct configuration applied, the project will be upgraded on the next boot.
41+
42+
### Boot order
43+
44+
The Runtime level uses `Run` instead of `Upgrade` to allow the website to continue to boot up directly after the migration is run. This happens instead of initiating the otherwise required restart.
45+
46+
{% hint style="info" %}
47+
The upgrade is run after Composers but before Components, and the `UmbracoApplicationStartingNotification`. This is because the migration requires services that are registered in Composers, and Components require that Umbraco and the database are ready.
48+
{% endhint %}
49+
50+
## Unattended upgrades in a load-balanced setup
51+
52+
Follow the steps outlined below to use unattended upgrades in a load-balanced setup.
53+
54+
1. [Upgrade Umbraco via NuGet](./#upgrade-to-a-new-major).
55+
2. Deploy to all environments.
56+
3. Set the `Umbraco:CMS:Unattended:UpgradeUnattended` configuration key to `true` for **the Main server only**.
57+
4. Boot the Main server, and the upgrade will run automatically.
58+
5. Wait for the upgrade to complete.
59+
6. Boot the Read-Only servers and ensure they do not show the “upgrade required” screen.

0 commit comments

Comments
 (0)