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

Reminder

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

upgrade

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 ESXCLI

Installing UltraPath for ESXi on the ESXCLI

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

Precautions

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.

Procedure

  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 UltraPath-XX.XX.XXX-ESXi6.x-offline-bundle.zip installation package as an example.

  2. Log in to the ESXi host.
  3. Run esxcli software vib install -d /opt/UltraPath-XX.XX.XXX-ESXi6.x-offlinebundle.zip to start the installation.

    ~ # esxcli software vib install -d /opt/UltraPath-XX.XX.XXX-ESXi6.x-offline-bundle.zip 
    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: 
    NOTE:

    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 esxcli software vib install -d /opt/UltraPath-XX.XX.XXX-ESXi5.0-offline-bundle.zip --no-sig-check command when the ESXi version is 5.0 or 5.1.

  4. 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     
    NOTE:

    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.
      NOTE:
  • 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.
Translation
Download
Updated: 2019-06-29

Document ID: EDOC1100052672

Views: 14690

Downloads: 147

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