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 By Executing a Script (Recommended)

Installing UltraPath for ESXi By Executing a Script (Recommended)

This section describes how to execute a script to install UltraPath for ESXi. Script-based UltraPath for ESXi installation includes two modes: silent installation and non-silent installation.

Silent Installation

This section describes how to install UltraPath for ESXi in silent installation mode. Before installing UltraPath, you must configure the parameters of the configuration file used for silent installation. The UltraPath installation process does not involve user interactions, enabling one-click installation.

Precautions

In a VMware HA cluster, to ensure VM service continuity, you must enable a host to enter the maintenance mode and ensure that the VMs on the host are 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 all files in the UltraPath for ESXi installation package. In the following example, the UltraPath-XX.XX.XXX-ESXi6.x-offline-bundle.zip installation package and the install.sh and unattend_install.conf files are saved in the /opt directory.

  2. Log in to the ESXi host.
  3. Determine whether the LUNs of the storage device that will be taken over by UltraPath have been mapped to the host.

    On the application server, run the esxcli storage core device list command to check the mapped virtual disks. The following uses the S5500T as an example.

     
    [root@local22:~] esxcli storage core device list 
    naa.60022a11000beb2a03707dd900000009 
      Display Name: HUAWEI iSCSI Disk (naa.60022a11000beb2a03707dd900000009) 
        Has Settable Display Name: true 
     Size: 2048 
     Device Type: Direct-Access  
     Multipath Plugin: NMP 
     Devfs Path: /vmfs/devices/disks/naa.60022a11000beb2a03707dd900000009 
     Vendor: HUAWEI 
     Model: S5500T           
     Revision: 2105 
     SCSI Level: 4 
     Is Pseudo: false 
      Status: on     
    • In the command output, if the information about the storage device that will be taken over exists in the Vendor and Model items, go to 4.
    • In the command output, if the information about the storage device that will be taken over does not exist in the Vendor and Model items, go to 5.

  4. Set the items of the unattend_install.conf file used for silent installation. For details about the parameters, see Table 2-3.

    Table 2-3 Parameters of the configuration item

    Parameter

    Description

    Value

    lun_exist_continue

    This parameter is used to determine whether UltraPath installation continues or exits after the LUNs of the storage device that is taken over by UltraPath are mapped to the host.

    If the system boot disk is a Huawei storage device, you are advised to set the parameter to y.

    NOTE:

    If disks of a storage system already exist on the host before you install UltraPath, the disks are not taken over by UltraPath after you set the parameter to y.

    [Value range]

    • y: The LUN exists and UltraPath installation continues.
    • n: The LUN exists and UltraPath installation exits.

    [Default value]

    n

    restart

    This parameter is used to determine whether the host is restarted after UltraPath is installed.

    [Value range]

    • y: The host is restarted after the installation.
    • n: The host is not restarted after the installation.

    [Default value]

    n

  5. In the /opt directory, run the sh install.sh -f unattend_install.conf command to start installation.

    In the following example, lun_exist_continue is set to y.

     
    sh install.sh -f unattend_install.conf 
    WARNING: Some LUNs which should be managed by UltraPath are already managed by NMP or other third-party MPP. 
    Please delete these LUNs before installing UltraPath, or reboot system after UltraPath is installed. 
    * Are you sure that you want to continue the UltraPath installation? [y,n,?] : y 
    Unattend install configuration item 'lun_exist_continue' set to 'y'. Unattend installation will continue. 
    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:  
    Please make sure your host name is uniqueness in data center. 
    WARNING: Some LUNs which should be managed by UltraPath are already managed by NMP or other third-party MPP. 
    Please reboot system to make these LUNs managed by UltraPath, otherwise these LUNs may work abnormally. 
    Reboot system now? (n|y) [n] : n 
    Unattend install configuration item 'restart' set to 'n'. The system will not be restarted after the unattend installation. 
    Please reboot system later. 
    Please restart the /etc/init.d/hostd manually.     
    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, when the ESXi version is 5.0 or 5.1, the following prompt information will be displayed at the beginning of command output after command execution:

    Because VMware stops providing signature authentication for the software package of the ESXi 5.0/ESXi 5.1 system, the software package is not certified and signed by VMware. An alarm will be reported in vCenter if an unsigned package is used.

  6. Run the esxcli software vib list |grep ultrapath command to check whether UltraPath for ESXi is installed successfully. If the ultrapath.cim, ultrapath.cli, and ultrapath.mpp files are displayed, UltraPath for ESXi is installed successfully. The command output is as follows:

     
    esxcli software vib list |grep ultrapath 
    ultrapath.cim                  XX.XX.XXX-00                           HUAWEI  VMwareAccepted    2016-03-14 
    ultrapath.cli                  XX.XX.XXX-00                           HUAWEI  VMwareAccepted    2016-03-14 
    ultrapath.mpp                  XX.XX.XXX-00                           HUAWEI  VMwareAccepted    2016-03-14

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:

    Run /etc/init.d/hostd restart to restart the /etc/init.d/hostd service.

    ~ # /etc/init.d/hostd restart
  • 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.

Non-Silent Installation

This section describes how to install UltraPath for ESXi in non-silent installation mode. In the UltraPath installation process, you must perform operations according to the prompt information.

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 and install.sh file as an example.

  2. Log in to the ESXi host.
  3. In the /opt directory, run sh install.sh to start the installation.

    ~ # sh install.sh 
    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:  
    Please make sure your host name is uniqueness in data center. 
    Please restart the /etc/init.d/hostd manually.     
    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, when the ESXi version is 5.0 or 5.1, the following prompt information will be displayed at the beginning of command output after command execution:

    Because VMware stops providing signature authentication for the software package of the ESXi 5.0/ESXi 5.1 system, the software package is not certified and signed by VMware. An alarm will be reported in vCenter if an unsigned package is used.

  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     

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:

    Run /etc/init.d/hostd restart to restart the /etc/init.d/hostd service.

    ~ # /etc/init.d/hostd restart
  • 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: 14543

Downloads: 145

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