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).
Viewing Virtual LUN Information

Viewing Virtual LUN Information

Function

The show vlun command is used to query information about a specified LUN or all LUNs mapped from a storage system to an application server.

Format

show vlun [ -l vlun-id [ -v ] | -a array-id | -d diskname [ -v ] | -t type ]

Parameters

Keyword and Parameter

Description

Default Value

-a array-id

ID of a storage system.

You can run show diskarray without an ID to display all storage system IDs.

None

-l vlun-id

ID of a virtual LUN.

You can run show vlun without an ID to display all virtual LUN IDs.

NOTE:

There are two kinds of values:

  • -l ID: ID of a single virtual LUN.
  • -l ID1,ID2...: IDs of multiple virtual LUNs which are not necessarily related. You can query a maximum of eight virtual LUNs' performance statistics at a time.

None

-d diskname

Drive letter name of a virtual LUN.

NOTE:

You can run this command to view information about only one virtual LUN at a time.

None

-v

Viewing path information about a virtual LUN.

NOTE:

Parameter -v can be used to view detailed information about a specified virtual LUN only when it is used together with either parameter -l or -d.

None

-t type

View the virtual LUN information of a specific type. If the -t parameter is not specified, common virtual LUN information will be queried.

Possible values are all, hypermetro, migration, and pe, where:

  • all: all virtual LUNs
  • hypermetro: virtual HyperMetro LUNs
  • migration: virtual migration LUNs
  • pe: PE LUN

None

Level

User root

Usage Guidelines

  • Run show vlun to query information about all common virtual LUNs mounted on the application server.
  • Run show vlun -a array-id to view common virtual LUN information about a specified storage system.
  • Run show vlun -l vlun-id to view information about a specified common virtual LUN.
  • Run show vlun -d diskname to view information about a specified common virtual LUN.
  • Run show vlun -l vlun-id -v to view details configuration information about a specified common virtual LUN.
  • Run show vlun -d diskname -v to view details configuration information about a specified common virtual LUN.
  • Run show vlun -t all to query information about all virtual LUNs mounted on the application server.
  • Run show vlun -a array-id -t all to view all virtual LUN information about a specified storage system.
  • Run show vlun -t hypermetro to query information about all virtual HyperMetro LUNs mounted on the application server.
  • Run show vlun -l vlun-id -t all to view information about a specified virtual LUN.
  • Run show vlun -d diskname -t all to view information about a specified virtual LUN.
  • Run show vlun -l vlun-id -t hypermetro to view information about a specified virtual HyperMetro LUN.
  • Run show vlun -d diskname -t hypermetro to view information about a specified virtual HyperMetro LUN.

Example

  • View information about all common virtual LUNs.
    ~ # esxcli upadm show vlun 
    ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- 
     Vlun ID                  Disk                      Name                   Lun WWN               Status  Capacity  Ctrl(Own/Work)       Array Name        Dev Lun ID  No. of Paths(Available/Total)  
        1     naa.64846fb1008ca15f2015a48700000091  test_210_0000  64846fb1008ca15f2015a48700000091  Normal 1.00GB       0B/0B       Huawei.Storage217.210     145                   2/2               
        2     naa.64846fb1008ca15f2015a4c500000092  test_210_0001  64846fb1008ca15f2015a4c500000092  Normal 1.00GB       0A/0A       Huawei.Storage217.210     146                   2/2               
    ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------     
  • View common virtual LUN information about the storage system whose ID is 0.
    ~ # esxcli upadm show vlun -a 0 
    ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- 
     Vlun ID                  Disk                      Name                   Lun WWN               Status  Capacity  Ctrl(Own/Work)       Array Name        Dev Lun ID  No. of Paths(Available/Total)  
        1     naa.64846fb1008ca15f2015a48700000091  test_210_0000  64846fb1008ca15f2015a48700000091  Normal 1.00GB       0B/0B       Huawei.Storage217.210     145                   2/2               
        2     naa.64846fb1008ca15f2015a4c500000092  test_210_0001  64846fb1008ca15f2015a4c500000092  Normal 1.00GB       0A/0A       Huawei.Storage217.210     146                   2/2               
    ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
  • View details about the common virtual LUN whose ID is 1.
    ~ # esxcli upadm show vlun -l 1 
    ======================================================= 
                      VLUN#1 Information                    
    ======================================================= 
    Disk                  : naa.64846fb1008ca15f2015a48700000091 
    Name                  : test_210_0000 
    Status                : Normal 
    Capacity              : 1.00GB 
    Driver                : Vendor-specific(DEFAULT) 
    Product Name          : XSG1             
    Vendor Name           : HUAWEI   
    Owning Controller     : 0B 
    Working Controller    : 0B 
    Num of Paths          : 2 
    LUN WWN               : 64846fb1008ca15f2015a48700000091 
    Array Name            : Huawei.Storage217.210 
    Controller 0A 
        Path 0 [vmhba33:C1:T38:L1]  : Normal 
        Path 4 [vmhba33:C1:T39:L1]  : Normal 
    Dev Lun ID        : 145 
    -------------------------------------------------------
  • View information about the virtual LUN whose drive letter name is naa.64846fb1008ca15f2015a48700000091.
    ~ # esxcli upadm show vlun -d naa.64846fb1008ca15f2015a48700000091 
    ======================================================= 
                      VLUN#1 Information                    
    ======================================================= 
    Disk                  : naa.64846fb1008ca15f2015a48700000091 
    Name                  : test_210_0000 
    Status                : Normal 
    Capacity              : 1.00GB 
    Driver                : Vendor-specific(DEFAULT) 
    Product Name          : XSG1             
    Vendor Name           : HUAWEI   
    Owning Controller     : 0B 
    Working Controller    : 0B 
    Num of Paths          : 2 
    LUN WWN               : 64846fb1008ca15f2015a48700000091 
    Array Name            : Huawei.Storage217.210 
    Controller 0A 
        Path 0 [vmhba33:C1:T38:L1]  : Normal 
        Path 4 [vmhba33:C1:T39:L1]  : Normal 
    Dev Lun ID        : 145 
    -------------------------------------------------------
  • View details configuration information about the common virtual LUN whose ID is 1.
    ~ # esxcli upadm show vlun -l 1 -v 
    ======================================================= 
                      VLUN#1 Information                    
    ======================================================= 
    Disk                  : naa.64846fb1008ca15f2015a48700000091 
    Name                  : test_210_0000 
    Status                : Normal 
    Capacity              : 1.00GB 
    Driver                : Vendor-specific(DEFAULT) 
    Product Name          : XSG1             
    Vendor Name           : HUAWEI 
    Owning Controller     : 0B 
    Working Controller    : 0B 
    Num of Paths          : 2 
    LUN WWN               : 64846fb1008ca15f2015a48700000091 
    Array Name            : Huawei.Storage217.210 
    Controller 0A 
        Path 0 [vmhba33:C1:T38:L1]  : Normal 
        Path 4 [vmhba33:C1:T39:L1]  : Normal 
    Working Mode      : load balancing within controller 
    LUN Trespass      : on 
    LoadBalance Mode  : min-queue-depth 
    Loadbanlance io threshold : 1 
    Max io retry timeout      : 1800 
    Dev Lun ID        : 145 
    -------------------------------------------------------     
  • View details configuration information about the common virtual LUN whose drive letter name is naa.64846fb1008ca15f2015a48700000091.
    ~ # esxcli upadm show vlun -d naa.64846fb1008ca15f2015a48700000091 -v 
    ======================================================= 
                      VLUN#1 Information                    
    ======================================================= 
    Disk                  : naa.64846fb1008ca15f2015a48700000091 
    Name                  : test_210_0000 
    Status                : Normal 
    Capacity              : 1.00GB 
    Driver                : Vendor-specific(DEFAULT) 
    Product Name          : XSG1             
    Vendor Name           : HUAWEI 
    Owning Controller     : 0B 
    Working Controller    : 0B 
    Num of Paths          : 2 
    LUN WWN               : 64846fb1008ca15f2015a48700000091 
    Array Name            : Huawei.Storage217.210 
    Controller 0A 
        Path 0 [vmhba33:C1:T38:L1]  : Normal 
        Path 4 [vmhba33:C1:T39:L1]  : Normal 
    Working Mode      : load balancing within controller 
    LUN Trespass      : on 
    LoadBalance Mode  : min-queue-depth 
    Loadbanlance io threshold : 1 
    Max io retry timeout      : 1800 
    Dev Lun ID        : 145 
    -------------------------------------------------------     
  • View information about all virtual LUNs.
    ~ # esxcli upadm show vlun -t all 
    ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- 
     Vlun ID                  Disk                       Name                   Lun WWN               Status  Capacity  Ctrl(Own/Work)       Array Name        Dev Lun ID  No. of Paths(Available/Total) 
        0     naa.64846fb1008ca15f1460f8b100000076 lm_test0000    64846fb1008ca15f1460f8b100000076  Normal 1.00GB       0A/0B       Huawei.Storage217.210     118                   1/1 
        1     naa.64846fb1008ca15f1460f8e400000077 lm_test0001    64846fb1008ca15f1460f8e400000077  Normal 1.00GB       0B/0B       Huawei.Storage217.210     119                   1/1 
        2     naa.64846fb1008ca15f1460f92300000078 lm_test0002    64846fb1008ca15f1460f92300000078  Normal 1.00GB       0A/0B       Huawei.Storage217.210     120                   1/1 
        3     naa.64846fb1008ca15f14610e9400000079 lm_test_0003 64846fb1008ca15f14610e9400000079  Normal 2.00GB       0B/0B       Huawei.Storage217.210     121                   1/1 
        4     naa.64846fb1008ca15f14828bcd0000007a lm_test_0004 64846fb1008ca15f14828bcd0000007a  Normal 5.00GB       0A/0B       Huawei.Storage217.210     122                   1/1 
        5     naa.63237361003130411fdda86c00000138  eDevLUN143_001  63237361003130411fdda86c00000138  Normal 1.00GB       0B/0B       Huawei.Storage217.210     142                   1/1 
        6     naa.63237361003130411fdda89600000139  eDevLUN143_002  63237361003130411fdda89600000139  Normal 1.00GB       0A/0B       Huawei.Storage217.210     143                   1/1 
    -----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
  • View all virtual LUN information about the storage system whose ID is 0.
    ~ # esxcli upadm show vlun -a 0 -t all 
    ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- 
     Vlun ID                  Disk                       Name                   Lun WWN               Status  Capacity  Ctrl(Own/Work)       Array Name        Dev Lun ID  No. of Paths(Available/Total) 
        0     naa.64846fb1008ca15f1460f8b100000076 lm_test0000    64846fb1008ca15f1460f8b100000076  Normal 1.00GB       0A/0B       Huawei.Storage217.210     118                   1/1 
        1     naa.64846fb1008ca15f1460f8e400000077 lm_test0001    64846fb1008ca15f1460f8e400000077  Normal 1.00GB       0B/0B       Huawei.Storage217.210     119                   1/1 
        2     naa.64846fb1008ca15f1460f92300000078 lm_test0002    64846fb1008ca15f1460f92300000078  Normal 1.00GB       0A/0B       Huawei.Storage217.210     120                   1/1 
        3     naa.64846fb1008ca15f14610e9400000079 lm_test_0003 64846fb1008ca15f14610e9400000079  Normal 2.00GB       0B/0B       Huawei.Storage217.210     121                   1/1 
        4     naa.64846fb1008ca15f14828bcd0000007a lm_test_0004 64846fb1008ca15f14828bcd0000007a  Normal 5.00GB       0A/0B     Huawei.Storage217.210     122                   1/1 
        5     naa.63237361003130411fdda86c00000138  eDevLUN143_001  63237361003130411fdda86c00000138  Normal 1.00GB       0B/0B       Huawei.Storage217.210     142                   1/1 
        6     naa.63237361003130411fdda89600000139  eDevLUN143_002  63237361003130411fdda89600000139  Normal 1.00GB       0A/0B       Huawei.Storage217.210     143                   1/1 
    -----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
  • View information about all virtual HyperMetro LUNs.
    ~ # esxcli upadm show vlun -t hypermetro 
    --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- 
     Vlun ID                  Disk                      Name                  Lun WWN               Status  Capacity  Ctrl(Own/Work)       Array Name        Dev Lun ID  No. of Paths(Available/Total) 
        0     naa.64846fb1008ca15f1460f8b100000076  lm_test0000 64846fb1008ca15f1460f8b100000076  Normal 1.00GB       0A/0B       Huawei.Storage217.210     118                   1/1 
        1     naa.64846fb1008ca15f1460f8e400000077  lm_test0001 64846fb1008ca15f1460f8e400000077  Normal 1.00GB       0B/0B       Huawei.Storage217.210     119                   1/1 
        4     naa.64846fb1008ca15f14828bcd0000007a  lm_test_0004  64846fb1008ca15f14828bcd0000007a  Normal 5.00GB       0A/0B       Huawei.Storage217.210     122                   1/1 
    ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------     
  • View details about the virtual LUN whose ID is 2.
    ~ # esxcli upadm show vlun -l 2 -t all 
    ======================================================= 
                      VLUN#2 Information 
    ======================================================= 
    Disk                  : naa.64846fb1008ca15f1460f92300000078 
    Name                  : lm_test0002 
    Status                : Normal 
    Capacity              : 1.00GB 
    Driver                : Vendor-specific(DEFAULT) 
    Product Name          : XSG1 
    Vendor Name           : HUAWEI 
    Owning Controller     : 0A 
    Working Controller    : 0B 
    Num of Paths          : 1 
    LUN WWN               : 64846fb1008ca15f1460f92300000078 
    Array Name            : Huawei.Storage217.210 
    Controller 0B 
        Path 0 [vmhba4:C0:T7:L4]  : Normal 
    Dev Lun ID        : 120 
    -------------------------------------------------------
  • View information about the virtual LUN whose drive letter name is naa.64846fb1008ca15f1460f92300000078.
    ~ # esxcli upadm show vlun -d naa.64846fb1008ca15f1460f92300000078 -t all 
    ======================================================= 
                      VLUN#2 Information 
    ======================================================= 
    Disk                  : naa.64846fb1008ca15f1460f92300000078 
    Name                  : lm_test0002 
    Status                : Normal 
    Capacity              : 1.00GB 
    Driver                : Vendor-specific(DEFAULT) 
    Product Name          : XSG1 
    Vendor Name           : HUAWEI 
    Owning Controller     : 0A 
    Working Controller    : 0B 
    Num of Paths          : 1 
    LUN WWN               : 64846fb1008ca15f1460f92300000078 
    Array Name            : Huawei.Storage217.210 
    Controller 0B 
        Path 0 [vmhba4:C0:T7:L4]  : Normal 
    Dev Lun ID        : 120 
    -------------------------------------------------------
  • View details about the virtual HyperMetro LUN whose ID is 2.
    ~ # esxcli upadm show vlun -l 2 -t hypermetro 
    ======================================================= 
                      VLUN#8 Information 
    ======================================================= 
    Disk                     : naa.64846fb1008ca15f1460f8b100000076 
    Aggregation Type         : Hyper Metro 
    Aggregation Specific Attribution 
        WorkingMode            : read write within primary array 
        Primary Array SN       : SN987654321076543210 
    Aggregation Member#0 Infomation 
        Name              : lm_test0000 
        Status            : Fault 
        Capacity          : 1.00GB 
        Aggregation Specific Attribution : N/A 
        LUN WWN           : 64846fb1008ca15f1460f8b100000076 
        Array Name        : Huawei.Storage217.210 
        Array SN          : SN987654321076543210 
        Driver            : Vendor-specific(DEFAULT) 
        Product Name      : XSG1 
        Vendor Name       : HUAWEI 
        Reservation       : 0 
        Queued I/O        : 0 
        Owning Controller : 0A 
        Working Controller: 0B 
        Num of Paths      : 2 
        Controller 0A 
            Path 6 [vmhba3:C0:T7:L2]  : Fault 
        Controller 0B 
            Path 5 [vmhba3:C0:T8:L2]  : Fault 
    Aggregation Member#1 Infomation 
        Name              : lm_test_74_0000 
        Status            : Normal 
        Capacity          : 1.00GB 
        Aggregation Specific Attribution : N/A 
        LUN WWN           : 64846fb1008ca15f1460f8b100000076 
        Array Name        : Storage217_74 
        Array SN          : 210235980510E8000015 
        Driver            : Vendor-specific(DEFAULT) 
        Product Name      : XSG1 
        Vendor Name       : HUAWEI 
        Reservation       : 0 
        Queued I/O        : 0 
        Owning Controller : 0B 
        Working Controller: 0A 
        Num of Paths      : 1 
        Controller 0A 
            Path 4 [vmhba3:C0:T6:L1]  : Normal 
    -------------------------------------------------------     
  • View details about the virtual HyperMetro LUN whose drive letter name is naa.64846fb1008ca15f1460f8b100000076.
    ~ # esxcli upadm show vlun -d naa.64846fb1008ca15f1460f8b100000076 -t hypermetro 
    ======================================================= 
                      VLUN#8 Information 
    ======================================================= 
    Disk                     : naa.64846fb1008ca15f1460f8b100000076 
    Aggregation Type         : Hyper Metro 
    Aggregation Specific Attribution 
        WorkingMode            : read write within primary array 
        Primary Array SN       : SN987654321076543210 
    Aggregation Member#0 Infomation 
        Name              : lm_test0000 
        Status            : Fault 
        Capacity          : 1.00GB 
        Aggregation Specific Attribution : N/A 
        LUN WWN           : 64846fb1008ca15f1460f8b100000076 
        Array Name        : Huawei.Storage217.210 
        Array SN          : SN987654321076543210 
        Driver            : Vendor-specific(DEFAULT) 
        Product Name      : XSG1 
        Vendor Name       : HUAWEI 
        Reservation       : 0 
        Queued I/O        : 0 
        Owning Controller : 0A 
        Working Controller: 0B 
        Num of Paths      : 2 
        Controller 0A 
            Path 6 [vmhba3:C0:T7:L2]  : Fault 
        Controller 0B 
            Path 5 [vmhba3:C0:T8:L2]  : Fault 
    Aggregation Member#1 Infomation 
        Name              : lm_test_74_0000 
        Status            : Normal 
        Capacity          : 1.00GB 
        Aggregation Specific Attribution : N/A 
        LUN WWN           : 64846fb1008ca15f1460f8b100000076 
        Array Name        : Storage217_74 
        Array SN          : 210235980510E8000015 
        Driver            : Vendor-specific(DEFAULT) 
        Product Name      : XSG1 
        Vendor Name       : HUAWEI 
        Reservation       : 0 
        Queued I/O        : 0 
        Owning Controller : 0B 
        Working Controller: 0A 
        Num of Paths      : 1 
        Controller 0A 
            Path 4 [vmhba3:C0:T6:L1]  : Normal 
    -------------------------------------------------------     

System Response

The following table explains some parameters in the command output:

Parameter

Description

Default Value

Disk

Name of the disk that corresponds to the virtual LUN on an ESX system.

None

Name

Name of the virtual LUN.

NOTE:

The name is specified when the LUN is created on its storage array.

None

Status

Status of the virtual LUN. Possible values are as follows:

  • Normal: The virtual LUN is normal.
  • Fault: The virtual LUN is faulty.
  • Degraded: The virtual LUN is degraded.
  • Unavailable: The virtual LUN is unavailable.
NOTE:
  • If the LUN on the array is in Fault state while the virtual LUN on the host is in Available state (viewed by using UltraPath), the virtual LUN can be accessed by the host.
  • If you remap a LUN from the storage array to a host but do not rescan LUNs on the host, the mapping between the LUN on the storage array and the virtual LUN changes and the status of the virtual LUN is Unavailable.

None

Capacity

Capacity of the virtual LUN.

None

Product Name

Model of the storage system.

None

Vendor Name

Vendor of the storage system.

None

Num of Paths

Number of logical paths.

NOTE:

You can only view the information about a maximum of eight paths on one controller.

None

LUN WWN

WWN of the virtual LUN.

None

Dev Lun ID

ID of the storage system LUN corresponding to the virtual LUN.

None

Aggregation Type

Type of the aggregation LUN. Possible values are as follows:

  • Hyper Metro: virtual HyperMetro LUNs
  • Migration: virtual migration LUNs.

None

Aggregation Specific Attribution

Attribution of the aggregation LUN.

For virtual HyperMetro LUNs:

  • WorkingMode: working mode for virtual HyperMetro LUNs.
  • Primary Array SN: SN of the primary array.

For migration virtual LUNs:

  • IO Direction: switch I/O to the target array or source array.
  • Rollback: enable or disable automatic I/O switchback.

None

No. of Paths(Available/Total)

Number of available logical paths of virtual LUNs/Total number of logical paths of virtual LUNs.

NOTE:
  • Available: Indicates number of available logical paths of virtual LUNs.
  • Total: Indicates total number of logical paths of virtual LUNs.

None

Translation
Download
Updated: 2019-06-29

Document ID: EDOC1100052672

Views: 14617

Downloads: 145

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