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).
Installing UltraPath for ESXi on the vSphere CLI

Installing UltraPath for ESXi on the vSphere CLI

This section describes how to install UltraPath for ESXi on the vSphere CLI.


To ensure uninterrupted virtual machine (VM) services in a VMware HA cluster, you must enter the maintenance node on a host and wail until all VMs on the host have been migrated before installing UltraPath for ESXi on the host.


  1. Save the UltraPath for ESXi installation package to any directory on the ESXi host.

    You are advised to create a new directory to save the installation package. This section uses the /opt directory to save the installation package as an example.

  2. Log in to the application server (running Windows or Linux) where VMware vSphere CLI has been installed. The application server running Windows is used as an example.
  3. Run the following command to install UltraPath.

    C:\Program Files (x86)\VMware\VMware vSphere CLI\bin>esxcli --server X.X.X.X 
    --username root --password xxxxxx software vib install -d /opt/     

    The following command output is displayed.

    Installation Result 
     Message: Operation finished successfully. 
     Reboot Required: false 
       VIBs Installed: HUAWEI_bootbank_ultrapath.cim_XX.XX.XXX-00, HUAWEI_bootbank_ultrapath.cli_XX.XX.XXX-00, HUAWEI_bootbank_ultrapath.mpp_XX.XX.XXX-00 
     VIBs Removed:  
     VIBs Skipped: 
    • If you cannot log in to the ESXi host using VMware vSphere CLI 6.0, see VMware Official Knowledge Base to troubleshoot fault.
    • VMware stops providing signature authentication for the software packages of ESXi 5.0 and 5.1 operating systems, so the software packages are not authenticated with signatures. Therefore, run the following command when the ESXi version is 5.0 or 5.1:
      C:\Program Files (x86)\VMware\VMware vSphere CLI\bin>esxcli --server X.X.X.X  --username root --password xxxxxx software vib install -d /opt/ --no-sig-check

  4. Login ESXi host and run esxcli software vib list |grep ultrapath to check whether the installation is successful. If the ultrapath.cim, ultrapath.cli, and ultrapath.mpp files are all displayed, the installation is successful. The following figures show possible outputs:

    ~ # esxcli software vib list |grep ultrapath                                               
    ultrapath.cim         XX.XX.XXX-00                         HUAWEI    VMwareAccepted    2016-04-22 
    ultrapath.cli         XX.XX.XXX-00                         HUAWEI    VMwareAccepted    2016-04-22 
    ultrapath.mpp         XX.XX.XXX-00                         HUAWEI    VMwareAccepted    2016-04-22 

    If Pre-Installation Check is not properly completed, restart the ESXi host.

Follow-up Procedure

  • After the installation is complete, perform the following steps to check whether UltraPath is successfully installed:
    1. Run the esxcli upadm show version command to check whether the current UltraPath version is consistent with the driver version.
      ~ # esxcli upadm show version 
       Software Version   : XX.XX.XXX 
       Driver   Version   : XX.XX.XXX 
    2. Run the esxcli upadm show upconfig command to check the UltraPath configuration. If the configuration information is displayed, UltraPath is successfully installed.
  • In SAN boot scenarios, restart the EXSi host immediately after UltraPath for ESXi is installed.
  • In non-SAN boot scenarios, if you do not restart the ESXi host after UltraPath for ESXi is installed, perform the following steps:
    1. Run /etc/init.d/hostd restart to restart the /etc/init.d/hostd service.
      ~ # /etc/init.d/hostd restart
    2. Restart the CIM Agent service.
      1. If the CIM Agent service is disabled, or the ESXi 6.0 system is installed on the host before you install UltraPath for ESXi, enable the CIM Agent service after the installation.
        ~ # /sbin/esxcfg-advcfg -A CIMvmw_ultrapath-providerProviderEnabled -T int -E "Enable or Disable the CIMvmw_ultrapath-providerProviderEnabled" -F 1 -N 0 -M 1
        ~ # esxcfg-advcfg --set 1 /UserVars/CIMvmw_ultrapath-providerProviderEnabled
        ~ # /etc/init.d/sfcbd-watchdog restart
        ~ # /etc/init.d/sfcbd-watchdog status   
        sfcbd is running.
      2. For the ESXi 6.5 and ESXi 6.7 system, perform the following command to restart the CIM Agent service.
        /etc/init.d/sfcbd-watchdog restart
        /etc/init.d/sfcbd-watchdog status
  • After the UltraPath is installed, change the system log size to provide sufficient storage space for system logs, facilitating subsequent analysis and maintenance of the UltraPath. You are advised to set the sizes of both syslog.log and vmkernel.log to 30M and keep the default value 8 of rotations. For details about how to set these parameters, see How to Set System Logs? Select one method.
Updated: 2019-06-29

Document ID: EDOC1100052672

Views: 14800

Downloads: 147

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