Disabling PDL AutoRemove feature vSphere ESXI
Article ID: 310084
Updated On:
Products
VMware vSphere ESXi
Issue/Introduction
This article provides information on the Permanent Device Loss (PDL) AutoRemove feature. This is enabled by default in all supported ESXi versions.
For more information regarding Permanent Device Loss (PDL) and how this differs from All-Paths-Down, see Permanent Device Loss (PDL) and All-Paths-Down (APD) in vSphere ESXI.
Environment
VMware vSphere ESXi 7.X
VMware vSphere ESXi 8.X
Resolution
Permanent Device Lost (PDL) is a situation that can occur when a disk device either fails or is removed from the vSphere host in an uncontrolled fashion. PDL detects if a disk device has been permanently removed, that is, the device will not return based on SCSI sense codes.
When the device enters this PDL state, the vSphere host can take action to prevent directing any further, unnecessary I/O to this device. This alleviates other conditions that might arise on the host as a result of this unnecessary I/O.
PDL AutoRemove automatically removes a device from a host when it enters a PDL state. Because vSphere ESXi hosts have a limit of 255 disk devices per host, a device that is in a PDL state can no longer accept I/O, but can still occupy one of the available disk device spaces. Therefore, it is better to remove the device from the host.
PDL AutoRemove occurs only if there are no open handles left on the device. The auto-remove takes place when the last handle on the device closes. Owing to this, if the device recovers, or if it is re-added after having been inadvertently removed, it would be treated as a new device.
The PDL AutoRemove feature is enabled by default.
To verify this, run this command to validate the current status of the setting:
esxcli system settings advanced list -o /Disk/AutoremoveOnPDL
Path: /Disk/AutoremoveOnPDL
Type: integer
Int Value: 1
Default Int Value: 1
Min Value: 0
Max Value: 1
String Value:
Default String Value:
Valid Characters:
Description: Autoremove paths to a disk that is in PDL (Permanent Device Loss)
When the device enters this PDL state, the vSphere host can take action to prevent directing any further, unnecessary I/O to this device. This alleviates other conditions that might arise on the host as a result of this unnecessary I/O.
PDL AutoRemove automatically removes a device from a host when it enters a PDL state. Because vSphere ESXi hosts have a limit of 255 disk devices per host, a device that is in a PDL state can no longer accept I/O, but can still occupy one of the available disk device spaces. Therefore, it is better to remove the device from the host.
PDL AutoRemove occurs only if there are no open handles left on the device. The auto-remove takes place when the last handle on the device closes. Owing to this, if the device recovers, or if it is re-added after having been inadvertently removed, it would be treated as a new device.
The PDL AutoRemove feature is enabled by default.
To verify this, run this command to validate the current status of the setting:
esxcli system settings advanced list -o /Disk/AutoremoveOnPDL
Path: /Disk/AutoremoveOnPDL
Type: integer
Int Value: 1
Default Int Value: 1
Min Value: 0
Max Value: 1
String Value:
Default String Value:
Valid Characters:
Description: Autoremove paths to a disk that is in PDL (Permanent Device Loss)
Note: VMware does not recommend to have the PDL AutoRemove feature disabled. Unless explicitly requested by your Storage Vendor.
VMware recommends you not to disable the AutoRemoveOnPDL feature in vSphere .
In vSphere, the expectation is that a device in a PDL state will not return. Therefore, the device needs to be removed from the ESXi host, before it can be recovered. If the AutoRemoveOnPDL feature is disabled, a manual rescan is required to remove the device while in a PDL state.
In vSphere, the expectation is that a device in a PDL state will not return. Therefore, the device needs to be removed from the ESXi host, before it can be recovered. If the AutoRemoveOnPDL feature is disabled, a manual rescan is required to remove the device while in a PDL state.
Note: For vSphere Metro Storage Cluster (vMSC) environments, VMware recommends to have AutoremoveOnPDL set to 1 explicitly for vSphere.
If you wish to proceed with disabling the AutoRemoveOnPDL feature, apply these steps:
- Connect to the ESXi host through SSH.
- Run this command to disable PDL AutoRemove:
esxcli system settings advanced set -o "/Disk/AutoremoveOnPDL" -i 0
- There is no guarantee of data integrity can be given if a device returns from a PDL.
- To re-enable the AutoRemove feature, run this command from a shell session to the ESXi host:
esxcli system settings advanced set -o "/Disk/AutoremoveOnPDL" -i 1
Feedback
Yes
No
Powered by
