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).
Commands for Configuring and Managing HyperMetro

Commands for Configuring and Managing HyperMetro

This topic describes how to configure the HyperMetro working mode and manage HyperMetro.

Setting the HyperMetro Working Mode

Function

The set hypermetro workingmode command is used to set the HyperMetro working mode.

Format

set hypermetro workingmode -m mode -p primary_array_id [ -l vlun_id ]

Parameters

Parameter

Description

Default Value

workingmode={ priority | balance }

HyperMetro working mode.

Possible values are priority and balance, where:

  • priority: primary array mode
  • balance: load balance mode

priority

NOTE:

In default configurations, namely manual configuration has not been performed, the system compares the array SNs and selects the largest numbered array as the preferred one.

primary_array_id=ID

ID of the primary array.

You can run show diskarray to display all array IDs.

NOTE:
  • In priority mode, the primary array indicates the array that delivers I/O first.
  • In balance mode, the primary array indicates the array where the first fragment range resides.
  • If an array is connected to multiple hosts, the array ID varies on different hosts. Use the array SN to determine whether the arrays queried on different hosts are the same.

None

-l vlun_id

ID of an virtual HyperMetro LUN.

Run the show vlun type=hypermetro command to obtain the IDs of the virtual HyperMetro LUNs.

None

Level

User root

Usage Guidelines
NOTE:
  • Setting the HyperMetro working mode of a specified virtual LUN with a higher priority than that of storage systems. If the HyperMetro working mode of a virtual LUN has been set, its working mode remains unchanged after the HyperMetro working mode of storage systems is set.
  • When the working mode is set to load balance mode, UltraPath chooses to deliver a specific array based on the start address of I/Os, fragment size, and priority array.

    For example, if the fragment size is 128 MB, then the I/Os with start addresses from 0 MB to 128 MB are delivered to the priority array, and the I/Os with start addresses from 128 MB to 256 MB are delivered to non-priority arrays. When the working mode is set to primary array mode, UltraPath delivers I/Os to the priority array. UltraPath will deliver I/Os to non-priority arrays only when the primary array encounters a fault.

  • Run the set hypermetro workingmode -m { priority | balance } -p primary_array_id command to set the HyperMetro working mode for all storage systems.
  • Run the set hypermetro workingmode -m { priority | balance } -p primary_array_id -l vlun_id command to set the HyperMetro working mode of a specific virtual LUN.
Example
  • Set the HyperMetro working mode to primary array mode for all storage systems, and set the storage systems whose ID is 0, to the primary array.
    ~ # esxcli upadm set hypermetro workingmode -m priority -p 0  
    Succeeded in executing the command.     
  • Set the HyperMetro working mode of the virtual LUNs whose ID is 0, to primary array mode, and set the storage systems whose ID is 0, to the primary array.
    ~ # esxcli upadm set hypermetro workingmode -m priority -p 0 -l 0 
    Succeeded in executing the command.     
System Response

None

Setting the Size of a HyperMetro Fragment

Function

The set hypermetro split_size command is used to set the fragment size when HyperMetro cross-array load balancing is applied.

Format

set hypermetro splitsize -s size [ -l vlun_id ]

Parameters

Parameter

Description

Default Value

-s size

Fragment size.

The value ranges from 512 bytes to 1 GB. The unit is byte.

NOTE:

The value must be an integer multiple of 512 and a power of 2.

128 MB

-l vlun_id

ID of an virtual HyperMetro LUN.

Run the show vlun -t hypermetro command to obtain the IDs of the virtual HyperMetro LUNs.

None

Level

User root

Usage Guidelines
  • Run the set hypermetro splitsize -s size command to set the HyperMetro fragment size for all storage systems.
  • Run the set hypermetro splitsize -s size -l vlun_id command to set the HyperMetro fragment size of the virtual LUNs.
Example
  • Set the HyperMetro fragment size to 128 MB for all storage systems.
    ~ # esxcli upadm set hypermetro splitsize -s 128M  
    Succeeded in executing the command.     
  • Set the HyperMetro fragment size of the virtual LUNs whose ID is 0 to 128 MB.
    ~ # esxcli upadm set hypermetro splitsize -s 128M -l 0 
    Succeeded in executing the command.     
System Response

None

Setting Load Balance Mode for a HyperMetro System

Function

You can run the set hypermetro loadbalancemode command to set load balance mode for HyperMetro configured across arrays.

Format

set hypermetro loadbalancemode -m mode [ -l vlun_id ]

Parameters

Parameter

Description

Default Value

-m mode

Load balance mode for a HyperMetro system

Its value can be split-size or round-robin. Parameter descriptions are as follows:

  • split-size: splitting mode across arrays.
  • round-robin: round-robin mode across arrays.
NOTE:
  • Load balance mode of a HyperMetro storage system only takes effect when the HyperMetro working mode is set to balance.

split-size

-l vlun_id

Specifies the ID of a virtual HyperMetro LUN.

Run the show vlun type =hypermetro command to obtain ID information about HyperMetro virtual LUNs.

None

Level

root user

Usage Guidelines
  • Descriptions about load balance mode for a HyperMetro system are as follows:
    • If split-size mode is selected, UltraPath delivers I/Os to a specific storage array based on the start addresses of I/Os, the size of slices that are set, and the preferred storage array. If the fragment size is 128 MB, the I/Os with start addresses from 0 MB to 128 MB are delivered to the preferred storage array, and the I/Os with start addresses from 128 MB to 256 MB are delivered to the non-preferred storage array.
    • If round-robin mode is selected, UltraPath delivers I/Os to two storage systems in turn.
  • Run the set hypermetro loadbalancemode -m mode command to set the HyperMetro working mode for all storage systems.
  • Run the set hypermetro loadbalancemode -m mode -l vlun_id command to set the HyperMetro working mode of a specific virtual LUN.
Example
  • Set HyperMetro load balance mode of all storage systems to split-size.
    UltraPath CLI #2 >set hypermetro loadbalancemode=split-size 
    Succeeded in executing the command     
  • Set HyperMetro load balance mode of virtual LUNs with an ID of 0 to split-size.
    UltraPath CLI #3 > set hypermetro loadbalancemode=split-size vlun_id=0 
    Succeeded in executing the command.     
System Response

None

Translation
Download
Updated: 2019-06-29

Document ID: EDOC1100052672

Views: 14494

Downloads: 145

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