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 V100R008C50 User Guide 06

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).
Setting a Controller's Paths

Setting a Controller's Paths


The set tpgstate command is used to enable or disable the paths of a specified controller.


set tpgstate -a array-id -t tpg-id -s state


Keyword and Parameter


Default Value

-a array-id

ID of a storage system.

You can run show diskarray without an ID to display all storage system IDs.


-t tpg-id

ID of a controller.


-s state

Enabling or disabling a controller's path.

The value is either enable or disable.
  • enable: enables a controller's paths.
  • disable: disables a controller's paths.



User root

Usage Guidelines

Once the command is run, UltraPath will not choose this path to deliver I/O.

When changing the controller of a storage system or before powering off the controller for maintenance, you can run this command to disable paths of the controller. After the paths are disabled, UltraPath for vSphere smoothly switches I/Os over to other controller's paths, preventing I/O latency caused by failback.

After the replacement or maintenance, you can run the command again to enable the paths of the controller, increasing redundance and balancing controller workload.


Enable the paths of controller 0A of the storage system whose ID is 0.

~ # esxcli upadm set tpgstate -a 0 -t 0A -s enable
Succeeded in executing the command.

System Response


Updated: 2019-03-06

Document ID: EDOC1000105152

Views: 38625

Downloads: 783

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