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 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).
Installing UltraPath for vSphere By Executing a Script

Installing UltraPath for vSphere By Executing a Script

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

Silent Installation

This section describes how to install UltraPath for vSphere 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 vSphere on the host.

Procedure

  1. Save the UltraPath for vSphere 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 vSphere installation package. In the following example, the UltraPath-8.XX.XXX-ESXi5.0-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-2.

    Table 2-2  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.

    [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

    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.

  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_8.06.010-00, HUAWEI_bootbank_ultrapath.cli_8.06.010-00, HUAWEI_bootbank_ultrapath.mpp_8.06.010-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.
    

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

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

Follow-up Procedure

  • In SAN boot scenarios, restart the EXSi host immediately after UltraPath for vSphere is installed. In non-SAN boot scenarios, perform the following operations:
    1. Run /etc/init.d/hostd restart command to restart the /etc/init.d/hostd service on ESXCLI.
      ~ # /etc/init.d/hostd restart
    2. If the CIM Agent service is disabled, or the ESXi 6.0 system is installed on the host before you install UltraPath for vSphere, 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.
  • 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 vSphere 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 vSphere on the host.

Procedure

  1. Save the UltraPath for vSphere 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-8.XX.XXX-ESXi5.0-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_8.06.010-00, HUAWEI_bootbank_ultrapath.cli_8.06.010-00, HUAWEI_bootbank_ultrapath.mpp_8.06.010-00
       VIBs Removed: 
       VIBs Skipped: 
    Please make sure your host name is uniqueness in data center.
    Please restart the /etc/init.d/hostd manually.
    

  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         8.06.010-00                         HUAWEI    VMwareAccepted    2016-04-22  
    ultrapath.cli         8.06.010-00                         HUAWEI    VMwareAccepted    2016-04-22  
    ultrapath.mpp         8.06.010-00                         HUAWEI    VMwareAccepted    2016-04-22  
    

Follow-up Procedure

  • In SAN boot scenarios, restart the EXSi host immediately after UltraPath for vSphere is installed. In non-SAN boot scenarios, perform the following operations:
    1. Run /etc/init.d/hostd restart command to restart the /etc/init.d/hostd service on ESXCLI.
      ~ # /etc/init.d/hostd restart
    2. If the CIM Agent service is disabled, or the ESXi 6.0 system is installed on the host before you install UltraPath for vSphere, 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.
  • 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-03-06

Document ID: EDOC1000105152

Views: 37431

Downloads: 782

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