No relevant resource is found in the selected language.

This site uses cookies. By continuing to browse the site you are agreeing to our use of cookies. Read our privacy policy>Search


To have a better experience, please upgrade your IE browser.


OceanStor UltraPath for vSphere 21.3.0 User Guide 03

This document covers the functions, features, installation, configuration, upgrade, uninstallation, maintenance, troubleshooting, and FAQs of OceanStor UltraPath for vSphere (UltraPath forvSphere). UltraPath for vSphere is the multipathing software developed by HuaweiTechnologies Co., Ltd (Huawei for short). The document aims at helping users to be fully familiar with UltraPath for vSphere and its use.
Rate and give feedback:
Huawei uses machine translation combined with human proofreading to translate this document to different languages in order to help you better understand the content of this document. Note: Even the most advanced machine translation cannot match the quality of professional translators. Huawei shall not bear any responsibility for translation accuracy and it is recommended that you refer to the English document (a link for which has been provided).
Converting APD to PDL

Converting APD to PDL


The set apdtopdl command is used to convert APD to PDL.


set apdtopdl -m mode -t timeout




Default Value

-m mode

Enable or disable conversion from APD to PDL.

Possible values are on or off, where:

  • on: enables the conversion from APD to PDL.
  • off: disables the conversion from APD to PDL.

The default value is off.

-t timeout

Timeout period of converting APD to PDL.

The value ranges from 1 to 140, expressed in seconds.



User root

Usage Guidelines

  • When the conversion from APD to PDL is enabled and its timeout period is set to N seconds, all logical paths of the virtual LUNs become faulty. After this situation lasts for N seconds, UltraPath sets the corresponding SCSI device of the virtual LUNs to PDL.
  • When APD to PDL is enabled, the disk status will be set to PDL if all paths are faulty. If VMs are using this disk whose status is PDL, the disk will not be removed automatically. After the paths are recovered, the disk cannot return to the normal status. After enabling APD to PDL, set Disk.terminateVMOnPDLDefault to True (for ESXi 5.0/5.1) or select VMkernel.Boot.terminateVMOnPDL (for ESXi 5.5 or later) in Advanced Settings.


The conversion from APD to PDL is enabled, and its timeout period is set to 60 seconds.

~ # esxcli upadm set apdtopdl -m on -t 60 
Succeeded in executing the command.     

System Response


Updated: 2019-06-29

Document ID: EDOC1100052672

Views: 14733

Downloads: 147

Average rating:
This Document Applies to these Products
Related Documents
Related Version
Previous Next