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 vCenter (for vCenter 6.X)

Installing UltraPath for vCenter (for vCenter 6.X)

Installation methods for vCenter 6.X running on different host operating systems are different. This section describes how to install UltraPath for vCenter on Windows and Linux operating systems (VCSA 6.X).

Installing UltraPath for vCenter (for vCenter 6.X deployed on Windows)

This section describes how to install UltraPath for vCenter in vCenter 6.0, vCenter 6.5 and vCenter 6.7 running on Windows.

Precautions
  • You can only use a browser in Windows to access vSphere Web Client (Flex). Supported browsers include:
    • Microsoft Internet Explorer 10.0.22 or later
    • Mozilla Firefox 34 or later
    • Google Chrome 39 or later
  • If the version of UltraPath for vCenter is earlier than that of UltraPath for ESXi, update the version of UltraPath for vCenter so that the versions of UltraPath for vCenter and UltraPath for ESXi are same. If the version of UltraPath for ESXi is V100R008, new functions of UltraPath cannot be queried and configured in UltraPath for vCenter. You are advised to update the versions of UltraPath for ESXi to 21.1.X or later.
  • UltraPath for vCenter provides both Chinese (simplified) and English (US) versions.
  • For scenarios where platform service controllers (PSCs) are configured externally and manage multiple vCenter servers, you are advised to install UltraPath for vCenter on each vCenter server so that each vCenter management interface can use UltraPath properly. For vCenter 6.X, restart VMware vSphere Web Client after UltraPath for vCenter is installed on each vCenter server.
Procedure
  1. Use a digital signature verification tool to verify integrity of the software package.

    NOTE:

    Download the digital signature verification tool from http://support.huawei.com/enterprise/ to verify integrity of the software package. If the verification fails, contact technical support engineers to obtain the correct and secure software package.

  2. Decompress the UltraPath for vCenter installation package and copy Windows under /VMware_vCenter/Packages/VMware_vSphere_6.X to any directory of the vCenter server.
  3. Log in to the vCenter server.
  4. Open the Windows file folder and double-click the UltraPath-XX.XX.XXX-vCenter6.exe icon. The UltraPath for vCenter installation wizard and the Figure 2-23 dialog box are displayed.

    Figure 2-23 UltraPath for vCenter installation wizard

  5. Click Next. The UltraPath for vCenter installation page is displayed, as shown in Figure 2-24.

    Figure 2-24 UltraPath for vCenter installation startup page

  6. Click Install to start the installation.

    The installation is complete, as shown in Figure 2-25.

    Figure 2-25 UltraPath for vCenter installation completion page

  7. Click Finish.

    After UltraPath for vCenter is installed, the dialog box for registering UltraPath for vCenter is displayed, as shown in Figure 2-26. Click Ok.

    Figure 2-26 UltraPath for vCenter installation completion page

  8. Register the UltraPath for vCenter plug-in.

    For vCenter 6.0:

    1. Copy the install-config.xml file in the extension-registration\vCenter6.0 folder to any directory of host that installed VMware vSphere Client.
    2. Log in to VMware vSphere Client in the host that installed VMware vSphere Client.
    3. On the vSphere Client management interface, choose Plug-ins > Manage Plug-ins.

      The Plug-ins Manager dialog box is displayed.

    4. Right-click the blank area in the dialog box that is displayed and choose New Plug-in from the shortcut menu.

      The Register Plug-in dialog box is displayed.

    5. Click Browse and select the UltraPath for vCenter plug-in install-config.xml file that you want to install.
    6. Click Register Plug-in.

      A success dialog box is displayed indicating that the vCenter plug-in is successfully registered.

    7. Click OK.

    For vCenter 6.5:

    1. Run cmd.
    2. Go to the extension-registration\vCenter6.5\prebuilt registration directory and run extension-registration.bat -url https://xxx.xxx.xxx.xxx/sdk -username xxx -password xxx.

      -url https://xxx.xxx.xxx.xxx/sdk is the host IP address used for registration. -username xxx is the vCenter user name. -password xxx is the vCenter password. For example:

      C:\Users\Administrator\Desktop\Windows\extension-registration\vCenter6.5\prebuilt>extension-registration.bat -url https://127.0.0.1/sdk -username administrator@vsphere.local -password Huawei@123 
      INFO: Not using https for your plugin URL is OK for testing but not recommended for production. 
      Users will have to include the flag allowHttp=true in their vSphere Client webclient.properties otherwise the http URL will be ignored 
      Plugin: com.storage.issp.ultrapathplugin has been successfully registered in vCenter <https://127.0.0.1/sdk>.

    For vCenter 6.7:

    1. Run cmd.
    2. Go to the extension-registration\vCenter6.7\prebuilt registration directory and run extension-registration.bat -url https://xxx.xxx.xxx.xxx/sdk -username xxx -password xxx.

      -url https://xxx.xxx.xxx.xxx/sdk is the host IP address used for registration. -username xxx is the vCenter user name. -password xxx is the vCenter password. For example:

      C:\Users\Administrator\Desktop\Windows\extension-registration\vCenter6.7\prebuilt>extension-registration.bat -url https://127.0.0.1/sdk -username administrator@vsphere.local -password Huawei@123 
      INFO: Not using https for your plugin URL is OK for testing but not recommended for production. 
      Users will have to include the flag allowHttp=true in their vSphere Client webclient.properties otherwise the http URL will be ignored 
      Plugin: com.storage.issp.ultrapathplugin has been successfully registered in vCenter <https://127.0.0.1/sdk>.

    If you are using a browser to visit vCenter 6.x while installing UltraPath for vCenter, UltraPath for vCenter that you have installed can only take effect after you re-log in after logout or restarting the browser.

Follow-up Procedure

Method used to go to the UltraPath management page of vCenter:

  1. Run a web browser and type https://XXX.XXX.XXX.XXX:9443 in the address box and press Enter.

    XXX.XXX.XXX.XXX is the vCenter server's IP address. 9443 is the port for accessing the ESXi host information. If the IP address does not have 9443, you cannot view UltraPath for vCenter.

  2. Enter the vCenter user name and password to go to the vSphere web client management page.
  3. Click Hosts and Clusters.
  4. Select a host that you want to manage.
    • For vCenter 6.0, click Manage > UltraPath on the right page, as shown in Figure 2-27.
      Figure 2-27 UltraPath management page (vCenter 6.0)
    • For vCenter 6.5 and vCenter 6.7, choose Configure > More > UltraPath on the right to go to the UltraPath management interface. as shown in Figure 2-28.
      Figure 2-28 UltraPath management page (vCenter 6.5)

Installing UltraPath for vCenter (Applicable to vCenter 6.X on VCSA 6.X)

This section describes how to install UltraPath for vCenter in vCenter 6.0 deployed on VCSA 6.0, vCenter 6.5 deployed on VCSA 6.5 and vCenter 6.7 deployed on VCSA 6.7.

Prerequisites

In scenarios where vCenter 6.0 is deployed in VCSA 6.0, VMware vSphere Client that can connect to VCSA has been installed on the host.

Precautions
  • You can only use a browser in Windows to access vSphere Web Client (Flex).Supported browsers include:
    • Microsoft Internet Explorer 10.0.22 or later
    • Mozilla Firefox 34 or later
    • Google Chrome 39 or later
  • If the version of UltraPath for vCenter is earlier than that of UltraPath for ESXi, update the version of UltraPath for vCenter so that the versions of UltraPath for vCenter and UltraPath for ESXi are same. If the version of UltraPath for ESXi is V100R008, new functions of UltraPath cannot be queried and configured in UltraPath for vCenter. You are advised to update the versions of UltraPath for ESXi to 21.1.X or later.
  • Strictly follow the sequence of the steps to install UltraPath for vCenter. Otherwise, irrevocable errors may be generated in the environment.
  • UltraPath for vCenter provides both Chinese (simplified) and English (US) versions.
  • For scenarios where platform service controllers (PSCs) are configured externally and manage multiple vCenter servers, you are advised to install UltraPath for vCenter on each vCenter server so that each vCenter management interface can use UltraPath properly. For vCenter 6.X, restart VMware vSphere Web Client after UltraPath for vCenter is installed on each vCenter server.
Procedure
  1. Use a digital signature verification tool to verify integrity of the software package.

    NOTE:

    Download the digital signature verification tool from http://support.huawei.com/enterprise/ to verify integrity of the software package. If the verification fails, contact technical support engineers to obtain the correct and secure software package.

  2. Copy the installation file to the vCenter server.

    1. Log in to the Linux host (the vCenter server) where VCSA 6.x resides as user root.

      If the following interface is displayed, perform 2.b.

    2. Run shell.set --enabled True and shell to go to the shell mode.

    3. Run the chsh -s /bin/bash root command to enable the file uploading service on the vCenter server and upload the UltraPath installation package to the vCenter server.
    4. Decompress the UltraPath for vCenter installation package and copy VCSA6.X under /VMware_vCenter/Packages/VMware_vSphere_6.X to any directory of the vCenter server.
    5. Run the chsh -s /bin/appliancesh root command to disable the file uploading service on the vCenter server.

  3. Install UltraPath for vCenter.

    1. Run cd VCSA6.x to go to the VCSA6.x directory.
    2. Run chmod +x install.sh to change the executable permission on the file.
    3. Run sh install.sh to start the installation.
    localhost:~/VCSA6.x> chmod +x install.sh 
    localhost:~/VCSA6.x> sh install.sh 
    Preparing...                ################################################## 
    UltraPath-for-vCenter       ################################################## 
    UltraPath for vCenter has been successfully installed.Please make sure register the UltraPath for vCenter plug-in to make the UltraPath for vCenter plug-in effective.

  4. Register the UltraPath for vCenter plug-in.

    For vCenter 6.0:

    1. Copy the install-config.xml file in the extension-registration/vCenter6.0 folder to any directory of host that installed VMware vSphere Client.
    2. Log in to VMware vSphere Client in the host that installed VMware vSphere Client.
    3. On the vSphere Client management interface, choose Plug-ins > Manage Plug-ins.

      The Plug-ins Manager dialog box is displayed.

    4. Right-click the blank area in the dialog box that is displayed and choose New Plug-in from the shortcut menu.

      The Register Plug-in dialog box is displayed.

    5. Click Browse and select the UltraPath for vCenter plug-in install-config.xml file that you want to install.
    6. Click Register Plug-in.

      A success dialog box is displayed indicating that the vCenter plug-in is successfully registered.

    7. Click OK.

    For vCenter 6.5:

    1. Open the command line interface of VCSA 6.5.
    2. Run cd VCSA6.x to go to the extension-registration/vCenter6.5/prebuilt registration directory.
    3. Run sh extension-registration.sh -url https://xxx.xxx.xxx.xxx/sdk -username xxx -password xxx command.

      -url https://xxx.xxx.xxx.xxx/sdk is the VCSA 6.5 IP address. -username xxx is the vCenter user name. -password xxx is the vCenter password. For example:

      root@vcsa163 [ /usr/VCSA6.x/extension-registration/vCenter6.5/prebuilt ] sh extension-registration.sh -url https://10.46.220.163/sdk -username administrator@vsphere.local -password Huawei@123 
      Picked up JAVA_TOOL_OPTIONS: -Xms32M -Xmx128M 
      INFO: Not using https for your plugin URL is OK for testing but not recommended for production. 
      Users will have to include the flag allowHttp=true in their vSphere Client webclient.properties otherwise the http URL will be ignored 
      Plugin: com.storage.issp.ultrapathplugin has been successfully registered in vCenter <https://10.46.220.163/sdk>.

    For vCenter 6.7:

    1. Open the command line interface of VCSA 6.7.
    2. Run cd VCSA6.x to go to the extension-registration/vCenter6.7/prebuilt registration directory.
    3. Run sh extension-registration.sh -url https://xxx.xxx.xxx.xxx/sdk -username xxx -password xxx command.

      -url https://xxx.xxx.xxx.xxx/sdk is the VCSA 6.7 IP address. -username xxx is the vCenter user name. -password xxx is the vCenter password. For example:

      root@vcsa163 [ /usr/VCSA6.x/extension-registration/vCenter6.7/prebuilt ] sh extension-registration.sh -url https://10.46.220.163/sdk -username administrator@vsphere.local -password Huawei@123 
      Picked up JAVA_TOOL_OPTIONS: -Xms32M -Xmx128M 
      INFO: Not using https for your plugin URL is OK for testing but not recommended for production. 
      Users will have to include the flag allowHttp=true in their vSphere Client webclient.properties otherwise the http URL will be ignored 
      Plugin: com.storage.issp.ultrapathplugin has been successfully registered in vCenter <https://10.46.220.163/sdk>.

    If you are using a browser to visit VCSA 6.x while installing UltraPath for vCenter, UltraPath for vCenter that you have installed can only take effect after you re-log in after logout or restarting the browser.

Follow-up Procedure

Method used to go to the UltraPath management page of vCenter:

  1. Run a web browser and type https://XXX.XXX.XXX.XXX:9443 in the address box and press Enter.

    XXX.XXX.XXX.XXX is the vCenter server's IP address. 9443 is the port for accessing the ESXi host information. If the IP address does not have 9443, you cannot view UltraPath for vCenter.

  2. Enter the vCenter user name and password to go to the vSphere web client management page.
  3. Click Hosts and Clusters.
  4. Select a host that you want to manage.
    • For vCenter 6.0, click Manage > UltraPath on the right page, as shown in Figure 2-29.
      Figure 2-29 UltraPath management page (vCenter 6.0)
    • For vCenter 6.5 and vCenter 6.7, choose Configure > More > UltraPath on the right to go to the UltraPath management interface. as shown in Figure 2-30.
      Figure 2-30 UltraPath management page (vCenter 6.5)
Translation
Download
Updated: 2019-06-29

Document ID: EDOC1100052672

Views: 14624

Downloads: 145

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