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: support/edge/manageability/update-install-rollback-failures.md
+91-7Lines changed: 91 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -69,17 +69,101 @@ Most Edge and WebView2 installation, update, and rollback failures are caused by
69
69
70
70
## Solution
71
71
72
-
To resolve this problem, collect and package the following diagnostic logs. Then, submit them to the Microsoft Support Team for analysis:
72
+
### Common troubleshooting checks
73
+
74
+
Before contacting Microsoft support, you should complete the following common troubleshooting checks. These steps resolve the majority of Microsoft Edge and Edge WebView2 update, installation, or rollback issues.
75
+
76
+
#### Restart the device
77
+
78
+
A system restart clears temporary system states that may block Edge or Edge WebView2 updates.
79
+
80
+
Restarting the device helps to:
81
+
82
+
- Complete any pending system reboot required by previous updates
83
+
- Release locked files used by Edge or Edge WebView2 processes
84
+
- Reset Windows Installer and related update services
85
+
86
+
After restarting, ensure no Edge or Edge WebView2-based applications are running before retrying the install, update, or rollback operation.
87
+
88
+
#### Verify available disk space
89
+
90
+
Insufficient disk space may cause Edge or Edge WebView2 install, update, or rollback failures. During installation, setup packages need temporary space to extract files and complete the process.
91
+
92
+
_Recommended_: At least 1-2 GB of free disk space on the system drive (usually `C:`).
93
+
94
+
1. Open **File Explorer**.
95
+
1. Check the available space on the system drive.
96
+
1. Free up disk space if needed (for example, remove temporary files or unused applications).
97
+
98
+
#### 3. Run installation as an administrator
99
+
100
+
Edge and Edge WebView2 install, update, and rollback operations require administrative privileges to:
101
+
102
+
- Write to system directories (for example, `Program Files`)
103
+
- Register system components
104
+
- Modify services and scheduled tasks
105
+
106
+
To run the install, update, or rollback as an administrator:
107
+
108
+
1. Right-click the installer file (`.exe` or `.msi`).
109
+
1. Select **Run as administrator**.
110
+
1. Approve the [User Account Control (UAC)](/windows/security/application-security/application-control/user-account-control/) prompt.
111
+
112
+
> [!NOTE]
113
+
> On managed or enterprise devices, ensure the account used has local administrator permissions.
114
+
115
+
#### Close Edge and Edge WebView2-based applications
116
+
117
+
Running Edge or Edge WebView2-based applications may lock files required during install, update, or rollback operations.
118
+
119
+
Common WebView2-based applications include (but are not limited to):
> Follow your organization's security policies. If disabling security software is not allowed, contact your IT administrator for assistance.
141
+
142
+
Some third-party antivirus, endpoint protection, or application control solutions may block:
143
+
144
+
- Installer execution (for example, `msedgeupdate.exe`, `msiexec.exe`)
145
+
- File replacement during update or rollback
146
+
- Service registration or scheduled task creation
147
+
148
+
Follow these steps:
149
+
150
+
1. Temporarily disable third-party security software, if permitted by organizational policy.
151
+
1. Retry the installation or update.
152
+
1. Re-enable security software immediately after completion.
153
+
154
+
### Contact support
155
+
156
+
If the steps in [Common troubleshooting checks](#common-troubleshooting-checks) do not resolve your problem, collect and package the following diagnostic logs. Then, submit them to the Microsoft Support Team for analysis:
73
157
74
158
- Edge installation and update logs
75
159
- Edge policy JSON export
76
160
- Process Monitor (PML) log
77
161
78
-
### Collect Edge installation and update logs
162
+
####Collect Edge installation and update logs
79
163
80
164
Collect logs from the following locations based on your installation type:
81
165
82
-
#### Update logs
166
+
#####Update logs
83
167
84
168
- If Edge is installed for all users:
85
169
@@ -89,7 +173,7 @@ Collect logs from the following locations based on your installation type:
89
173
90
174
`%LOCALAPPDATA%\Temp\MicrosoftEdgeUpdate.log`
91
175
92
-
#### Installation logs
176
+
#####Installation logs
93
177
94
178
- If Edge is installed for all users:
95
179
@@ -99,15 +183,15 @@ Collect logs from the following locations based on your installation type:
99
183
100
184
`%LOCALAPPDATA%\Temp\msedge_installer.log`
101
185
102
-
### Export Edge policy settings
186
+
####Export Edge policy settings
103
187
104
188
Follow these steps to export the Edge policy information:
105
189
106
190
1. Open Microsoft Edge and go to `edge://policy`.
107
191
1. Select **Export to JSON**.
108
192
1. Save the exported JSON file.
109
193
110
-
### Collect a Process Monitor log
194
+
####Collect a Process Monitor log
111
195
112
196
[Process Monitor](/sysinternals/downloads/procmon) is a Windows monitoring tool that captures real-time file system, registry, and process/thread activity.
113
197
@@ -142,7 +226,7 @@ Follow these steps to collect a Process Monitor log:
142
226
-**Format**: _Native Process Monitor Format (PML)_
143
227
-**Path**: Choose the desired folder to save the log file
144
228
145
-
### Submit the diagnostic package
229
+
####Submit the diagnostic package
146
230
147
231
After packaging the collected logs, submit the files to the [Microsoft Support Team](TODO). The support team will analyze the logs and help you resolve the problem.
0 commit comments