You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: 16/umbraco-cms/fundamentals/setup/upgrading/upgrade-details.md
+1-57Lines changed: 1 addition & 57 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -8,11 +8,10 @@ In this article, you will find everything you need to upgrade your Umbraco CMS p
8
8
9
9
If you are new to upgrades, be sure to read the [introduction to upgrades in Umbraco first](./upgrade-introduction.md).
10
10
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.
12
12
13
13
*[Upgrade to a new Major](./#upgrade-to-a-new-major)
14
14
*[Upgrade to a new Minor](./#upgrade-to-a-new-minor)
15
-
*[Run an unattended upgrade](./#run-an-unattended-upgrade)
16
15
*[Legacy Umbraco](./#legacy-umbraco)
17
16
18
17
## Upgrade to a new Major
@@ -134,60 +133,6 @@ When the command completes, open the `.csproj` file to make sure the package ref
134
133
```
135
134
{% endcode %}
136
135
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
-
191
136
## Legacy Umbraco
192
137
193
138
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
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