Skip to content

Commit 7611c65

Browse files
committed
Add common troubleshooting checks
1 parent fb9472b commit 7611c65

1 file changed

Lines changed: 91 additions & 7 deletions

File tree

support/edge/manageability/update-install-rollback-failures.md

Lines changed: 91 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -69,17 +69,101 @@ Most Edge and WebView2 installation, update, and rollback failures are caused by
6969
7070
## Solution
7171

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):
120+
121+
- Microsoft Edge
122+
- [Microsoft Teams](/microsoftteams/teams-overview)
123+
- [Outlook (new client)](/microsoft-365-apps/outlook/overview-new-outlook-windows)
124+
- [Windows Widgets](/windows/apps/design/widgets/)
125+
- Custom line-of-business applications
126+
127+
Follow these steps:
128+
129+
1. Close all open applications.
130+
1. Open **Task Manager**.
131+
1. Confirm there are no running processes such as:
132+
- `msedge.exe`
133+
- `msedgewebview2.exe`
134+
1. End any remaining processes if necessary.
135+
1. Retry the install, update, or rollback operation.
136+
137+
#### Temporarily disable third-party security software (if applicable)
138+
139+
> [!IMPORTANT]
140+
> 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:
73157

74158
- Edge installation and update logs
75159
- Edge policy JSON export
76160
- Process Monitor (PML) log
77161

78-
### Collect Edge installation and update logs
162+
#### Collect Edge installation and update logs
79163

80164
Collect logs from the following locations based on your installation type:
81165

82-
#### Update logs
166+
##### Update logs
83167

84168
- If Edge is installed for all users:
85169

@@ -89,7 +173,7 @@ Collect logs from the following locations based on your installation type:
89173

90174
`%LOCALAPPDATA%\Temp\MicrosoftEdgeUpdate.log`
91175

92-
#### Installation logs
176+
##### Installation logs
93177

94178
- If Edge is installed for all users:
95179

@@ -99,15 +183,15 @@ Collect logs from the following locations based on your installation type:
99183

100184
`%LOCALAPPDATA%\Temp\msedge_installer.log`
101185

102-
### Export Edge policy settings
186+
#### Export Edge policy settings
103187

104188
Follow these steps to export the Edge policy information:
105189

106190
1. Open Microsoft Edge and go to `edge://policy`.
107191
1. Select **Export to JSON**.
108192
1. Save the exported JSON file.
109193

110-
### Collect a Process Monitor log
194+
#### Collect a Process Monitor log
111195

112196
[Process Monitor](/sysinternals/downloads/procmon) is a Windows monitoring tool that captures real-time file system, registry, and process/thread activity.
113197

@@ -142,7 +226,7 @@ Follow these steps to collect a Process Monitor log:
142226
- **Format**: _Native Process Monitor Format (PML)_
143227
- **Path**: Choose the desired folder to save the log file
144228

145-
### Submit the diagnostic package
229+
#### Submit the diagnostic package
146230

147231
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.
148232

0 commit comments

Comments
 (0)