Skip to content

Commit fc7e89b

Browse files
committed
Common issues merge/edits
1 parent 2194fed commit fc7e89b

1 file changed

Lines changed: 27 additions & 35 deletions

File tree

support/windows-server/backup-and-storage/windows-server-mpio-troubleshooting.md

Lines changed: 27 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -66,9 +66,7 @@ Use this checklist for systematic troubleshooting.
6666
1. Select **Discover Multi-Paths**. Review the list of IDs and fix any errors.
6767
> [!NOTE]
6868
> You can also use the Windows PowerShell `Get-MPIOAvailableHW` and `Get-MPIOSetting` cmdlets, or the command line `mpclaim -e` and `mpclaim -r -i -a` commands to perform these steps.
69-
7069
1. To review and update the storage area network (SAN) policy, open a Windows command prompt window and then run the following command:
71-
**Review and update SAN policy**:
7270

7371
```console
7472
diskpart san policy=OnlineAll
@@ -144,7 +142,7 @@ Use this checklist for systematic troubleshooting.
144142

145143
1. If you're using third-party DSMs, use the Programs and Features control panel to uninstall them.
146144
1. Restart the computer.
147-
1. In the MPIO tool, select **Devices**, and then remove the hardware IDs. from MPIO Devices tab,
145+
1. In the MPIO tool, select **Devices**, and then remove the hardware IDs.
148146
1. Restart the computer again, then in the MPIO tool, re-add the hardware IDs for MSDSM.
149147
1. To make sure that Microsoft DSM claims your disks, run `mpclaim -s -d` at the Windows command prompt.
150148

@@ -157,7 +155,7 @@ The following sections describe the most common issues, and how to fix them.
157155
If you experience this issue, make sure that your computers are up to date. [October 23, 2025—KB5070884 (OS Build 20348.4297)](https://support.microsoft.com/en-us/topic/october-23-2025-kb5070884-os-build-20348-4297-out-of-band-9c001fdc-f0d2-4636-87bb-494a59da55d0) and subsequent updates contain a fix for this issue.
158156

159157
> [!NOTE]
160-
> After you install this update, VMs that have been backed up by using or a host-level backup application might not be able to start. To fix this issue, delete any .rct and .mrt files that are associated with the affected virtual hard disks. Then try again to start the VMs. If the issue persists, contact Microsoft Support.
158+
> After you install this update, VMs that have been backed up by using a host-level backup application might not be able to start. To fix this issue, delete any .rct and .mrt files that are associated with the affected virtual hard disks. Then try again to start the VMs. If the issue persists, contact Microsoft Support.
161159
162160
### Some cluster disk resources remain in "Online Pending" state
163161

@@ -185,52 +183,47 @@ To fix this issue, follow these steps:
185183

186184
### After maintenance or a restart, administrative tools don't show disks or paths
187185

188-
use the iSCSI Initiator tool to review the "Favorite Targets" list (In the search bar, type *iscsiocpl*, and then in the search results, select **iSCI Initiator**, and then select **Favorite Targets**.
189-
190-
- Disk missing in Disk Management or cluster
191-
- "mpclaim -s -d" missing LUNs
192-
- "Discover" option unavailable (greyed out)
193-
- Event log IDs 46, 153, 129
186+
The Disk Management or Failover Cluster Manager tools don't show all of the disks or paths, and the **Discover** option is unavailable. If you run `mpclaim -s -d` at a Windows command prompt, some LUNs might be missing. You might also observer Event ID 46, Event ID 129, or Event ID 153.
194187

195-
#### Resolution
188+
To fix this issue, follow these steps:
196189

197-
1. Check physical and storage connectivity and switch zoning
198-
1. Remove ghost or hidden devices in Device Manager (enable "show hidden") or run devnode clean
199-
1. Uninstall unsupported or duplicate DSMs (Control Panel > Programs and Features)
200-
1. Restart, reinstall, or re-enable the Multipath-IO feature (Install-WindowsFeature Multipath-IO)
201-
1. Run:
190+
1. Check the physical disk connections, switch zoning, and storage connectivity.
191+
1. In Device Manager (enable "show hidden"), remove ghost or hidden devices (or run `devnode clean` at a Windows command prompt).
192+
1. If you're using an unsupported DSM or duplicate DSMs, use the Programs and Features control panel to uninstall them.
193+
1. Restart, reinstall, or re-enable the Multipath-IO feature (to do this, you can run `Install-WindowsFeature Multipath-IO` at a PowerShell command prompt).
194+
1. At a Windows command prompt, run the following commands, in sequence:
202195

203196
```console
204197
mpclaim -e
205198
mpclaim -s -d
206199
mpclaim -r -i -a
207200
```
208201

209-
Add missing hardware IDs in **MPIO Properties** > **Discover Multi-Paths**.
210-
1. Open DiskPart:
202+
1. In the MPIO tool, select **Discover Multi-Paths**, add the missing hardware IDs.
211203

212-
```console
213-
diskpart
214-
san policy=OnlineAll
215-
exit
216-
```
217-
218-
1. Bring missing disks online in Disk Management or through DiskPart.
204+
1. To review and update the storage area network (SAN) policy, open a Windows command prompt window and then run the following command:
219205

220-
### Multipath Failover Delays or Path Flapping
206+
```console
207+
diskpart san policy=OnlineAll
208+
```
221209

222-
#### Symptoms
210+
1. Use Disk Management or diskpart to bring the missing disks online.
223211

224-
- 30+ seconds delay or unresponsiveness during failover
225-
- IO errors
226-
- "MPIO is in a degraded state"
212+
1. To review the "Favorite Targets" list, use the iSCSI Initiator tool (In the search bar, type *iscsiocpl*, and then in the search results, select **iSCI Initiator**, and then select **Favorite Targets**.)
227213

228-
- Event IDs 140, 46, 153, 129
214+
### MPIO is in a degraded state, slow or unresponsive during failover
229215

230-
#### Resolution
216+
During a failover, you observe delays that might exceed thirty seconds. You also observe IO error messages, and messages such as "MPIO is in a degraded state." You might observe the following events:
217+
218+
- Event ID 46
219+
- Event ID 129
220+
- Event ID 140
221+
- Event ID 153
222+
223+
To fix this issue, follow these steps:
231224

232225
1. Update all storage, HBA, and multipath drivers and firmware.
233-
1. Set recommended load-balancing policy and failover parameters:
226+
1. To set recommended load-balancing policy and failover parameters, run the following cmdlets at a Powershell command prompt:
234227

235228
```powershell
236229
Set-MSDSMGlobalDefaultLoadBalancePolicy -Policy RR
@@ -243,9 +236,8 @@ use the iSCSI Initiator tool to review the "Favorite Targets" list (In the searc
243236
```
244237
245238
Restart if prompted to do so.
246-
1. On clusters, increase disk resource timeouts to tolerate slow failover.
247-
248239
240+
1. On clusters, increase disk resource timeouts to tolerate slow failover.
249241
250242
### 4. "Persistent Disk or Path Errors in Event Log"
251243

0 commit comments

Comments
 (0)