0% found this document useful (0 votes)
123 views104 pages

OceanStor Ultrapath For Windows User Guide - (V100R002 - 01)

Huawei OceanStor Ultrapath for Windows User Guide

Uploaded by

sandra
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
0% found this document useful (0 votes)
123 views104 pages

OceanStor Ultrapath For Windows User Guide - (V100R002 - 01)

Huawei OceanStor Ultrapath for Windows User Guide

Uploaded by

sandra
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
You are on page 1/ 104

OceanStor UltraPath for Windows

V100R002

User Guide

Issue 01
Date 2011-05-09

HUAWEI TECHNOLOGIES CO., LTD.


Copyright © Huawei Technologies Co., Ltd. 2011. All rights reserved.
No part of this document may be reproduced or transmitted in any form or by any means without prior written
consent of Huawei Technologies Co., Ltd.

Trademarks and Permissions

and other Huawei trademarks are trademarks of Huawei Technologies Co., Ltd.
All other trademarks and trade names mentioned in this document are the property of their respective holders.

Notice
The purchased products, services and features are stipulated by the contract made between Huawei and the
customer. All or part of the products, services and features described in this document may not be within the
purchase scope or the usage scope. Unless otherwise specified in the contract, all statements, information,
and recommendations in this document are provided "AS IS" without warranties, guarantees or representations
of any kind, either express or implied.

The information in this document is subject to change without notice. Every effort has been made in the
preparation of this document to ensure accuracy of the contents, but all statements, information, and
recommendations in this document do not constitute the warranty of any kind, express or implied.

Huawei Technologies Co., Ltd.


Address: Huawei Industrial Base
Bantian, Longgang
Shenzhen 518129
People's Republic of China

Website: http://www.huawei.com
Email: [email protected]

Issue 01 (2011-05-09) Huawei Proprietary and Confidential i


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
User Guide About This Document

About This Document

Product Version
The related product versions are described as follows:
Product Name Product Version

OceanStor V1000 Series Storage System V100R001

OceanStor S2000 Series Storage System V100R001

OceanStor S5000 Series Storage System V100R001, V100R002, and V100R005

OceanStor VIS6000 Storage System V100R001 and V100R002

OceanStor S3900 Storage System V100R001

OceanStor S5900 Storage System V100R001

OceanStor S6900 Storage System V100R001

Intended Audience
This document describes the functions and features of the UltraPath for Windows, preparations
before installation, methods to install, remove, and use the UltraPath for Windows, and the
commands commonly used.
This document is intended for:
l Technical support engineers
l Installation and commissioning engineers

Symbol Conventions
The symbols that may be found in this document are defined as follows.

Issue 01 (2011-05-09) Huawei Proprietary and Confidential iii


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
About This Document User Guide

Symbol Description

Indicates a potentially hazardous situation, which if not


avoided, could result in equipment damage, data loss,
CAUTION
performance degradation, or unexpected results.
TIP Indicates a tip that may help you solve a problem or save
time.

NOTE Provides additional information to emphasize or supplement


important points of the main text.

Command Conventions
The command conventions that may be found in this document are defined as follows.

Convention Description

Boldface The keywords of a command line are in boldface.

Italic Command arguments are in italics.

[] Items (keywords or arguments) in brackets [ ] are optional.

{ x | y | ... } Optional items are grouped in braces and separated by


vertical bars. One item is selected.

[ x | y | ... ] Optional items are grouped in brackets and separated by


vertical bars. One item is selected or no item is selected.

{ x | y | ... }* Optional items are grouped in braces and separated by


vertical bars. A minimum of one item or a maximum of all
items can be selected.

[ x | y | ... ]* Optional items are grouped in brackets and separated by


vertical bars. Several items or no item can be selected.

&<1-n> The parameter before the & sign can be repeated 1 to n times.

# A line starting with the # sign is comments.

Update History
Updates between document issues are cumulative. Therefore, the latest document issue contains
all updates made in previous issues.

Updates in Issue 01 (2011-05-09)


Initial commercial release.

iv Huawei Proprietary and Confidential Issue 01 (2011-05-09)


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
User Guide Contents

Contents

About This Document...................................................................................................................iii


1 Overview of the UltraPath for Windows...............................................................................1-1
1.1 Introduction.....................................................................................................................................................1-2
1.2 Functions.........................................................................................................................................................1-3
1.3 Requirements on Operating Environment.......................................................................................................1-4
1.3.1 Application Server..................................................................................................................................1-4
1.3.2 Storage System.......................................................................................................................................1-9

2 Installation and Uninstallation...............................................................................................2-1


2.1 Preparations Before Installation......................................................................................................................2-2
2.2 Installing the UltraPath for Windows for the First Time................................................................................2-2
2.2.1 Setting Driver Signing............................................................................................................................2-2
2.2.2 Installing the UltraPath for Windows Through the Installation Program..............................................2-3
2.2.3 Installing the UltraPath for Windows Through the Scripts..................................................................2-11
2.2.4 Scanning LUN......................................................................................................................................2-12
2.3 Reinstalling the UltraPath for Windows.......................................................................................................2-13
2.4 Uninstalling the UltraPath for Windows.......................................................................................................2-14
2.4.1 Uninstall through Install Wizard..........................................................................................................2-14
2.4.2 Uninstall through Control Panel...........................................................................................................2-17

3 Instructions on UltraPath for Windows Manager...............................................................3-1


3.1 Usage Description...........................................................................................................................................3-2
3.2 Function Description.......................................................................................................................................3-2
3.2.1 Querying List of Virtual Disks...............................................................................................................3-3
3.2.2 Querying Details of Virtual Disks..........................................................................................................3-5
3.2.3 Querying Information of LUN...............................................................................................................3-6
3.2.4 Querying Partitioning Information of Virtual Disks..............................................................................3-9
3.2.5 Querying and Setting Information of Configuration............................................................................3-10
3.2.6 Querying Storage System Information.................................................................................................3-15
3.2.7 Querying Path Information on Controller............................................................................................3-16
3.2.8 Querying All LUNs I/O Count.............................................................................................................3-18
3.2.9 Querying IO Performance Information................................................................................................3-19
3.2.10 Querying Version Information...........................................................................................................3-20
3.2.11 Supplementary Functions...................................................................................................................3-21

Issue 01 (2011-05-09) Huawei Proprietary and Confidential v


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
Contents User Guide

3.3 Common Commands.....................................................................................................................................3-22


3.3.1 Enabling the disk performance monitoring..........................................................................................3-23
3.3.2 Listing all commands...........................................................................................................................3-24
3.3.3 Displaying commands help document in Html....................................................................................3-25
3.3.4 Listing version information of the multipath software.........................................................................3-25
3.3.5 Listing disk mapping information........................................................................................................3-25
3.3.6 Listing array information connected to the AS....................................................................................3-26
3.3.7 Listing information of the controller connected to the AS...................................................................3-26
3.3.8 Listing IO statistics information of the virtual LUN............................................................................3-27
3.3.9 Listing IO performance of the virtual LUN.........................................................................................3-28
3.3.10 Listing SCSI address of the physical LUN corresponding to the virtual LUN..................................3-29
3.3.11 Listing basic information of the virtual LUN.....................................................................................3-29
3.3.12 Listing information of physical LUN.................................................................................................3-30
3.3.13 Listing the number of the virtual LUNs.............................................................................................3-30
3.3.14 Listing the status of the log switch.....................................................................................................3-31
3.3.15 Listing path verification settings........................................................................................................3-31
3.3.16 Listing IO retry settings......................................................................................................................3-32
3.3.17 Listing status of the cluster switch.....................................................................................................3-32
3.3.18 Listing IO load balancing policy........................................................................................................3-33
3.3.19 Listing status of the IO load balancing switch...................................................................................3-33
3.3.20 Listing status of the Failover switch..................................................................................................3-34
3.3.21 Setting status of the log switch...........................................................................................................3-34
3.3.22 Setting function of the path verification.............................................................................................3-34
3.3.23 Setting IO retry parameters................................................................................................................3-35
3.3.24 Setting cluster function.......................................................................................................................3-35
3.3.25 Setting IO load balancing policy........................................................................................................3-36
3.3.26 Setting load balancing switch.............................................................................................................3-36

A How to Obtain Help................................................................................................................ A-1


A.1 Preparations For Contacting Huawei Symantec............................................................................................A-2
A.1.1 Collecting Troubleshooting Information..............................................................................................A-2
A.1.2 Making Debugging Preparations..........................................................................................................A-2
A.2 How to Use the Document............................................................................................................................A-2
A.3 How to Obtain Help from Website................................................................................................................A-3
A.4 Ways to Contact Huawei Symantec..............................................................................................................A-3

B Initializing Disks......................................................................................................................B-1
C Failing to Open the UltraPath Software...............................................................................C-1
D Glossary..................................................................................................................................... D-1
E Acronyms and Abbreviations.................................................................................................E-1

vi Huawei Proprietary and Confidential Issue 01 (2011-05-09)


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
User Guide Figures

Figures

Figure 1-1 Typical networking mode 1................................................................................................................1-2


Figure 1-2 Typical networking mode 2................................................................................................................1-3
Figure 1-3 Software Update Installation Wizard interface..............................................................................1-6
Figure 1-4 iSCSI Initiator Properties dialog box..................................................................................................1-7
Figure 1-5 iSCSI Initiator Properties dialog box..................................................................................................1-8
Figure 1-6 Log On to Target dialog box..............................................................................................................1-8
Figure 2-1 Driver Signing Options dialog box.....................................................................................................2-3
Figure 2-2 Basic conditions checklist interface....................................................................................................2-4
Figure 2-3 iSCSI environment checklist interface...............................................................................................2-5
Figure 2-4 UltraPath for Windows - Install Wizard interface.........................................................................2-6
Figure 2-5 Customer Information interface.......................................................................................................2-7
Figure 2-6 Ready to Install the Program interface............................................................................................2-8
Figure 2-7 Installing UltraPath for Windows interface....................................................................................2-8
Figure 2-8 Security Alert - Driver Installation interface..................................................................................2-9
Figure 2-9 Install Wizard Completed interface.................................................................................................2-9
Figure 2-10 UltraPath for Windows Installer Information dialog box.........................................................2-10
Figure 2-11 Computer Management interface................................................................................................2-11
Figure 2-12 Viewing the LUN mapped to the AS from the storage system......................................................2-13
Figure 2-13 UltraPath for Windows - Install Wizard interface..........................................................................2-15
Figure 2-14 Confirm to uninstall dialog box......................................................................................................2-15
Figure 2-15 Uninstalling interface.....................................................................................................................2-16
Figure 2-16 Uninstall Completed interface........................................................................................................2-16
Figure 2-17 Restart Computer prompt interface................................................................................................2-17
Figure 2-18 Add or Remove Programs dialog box............................................................................................2-17
Figure 3-1 Main Interface of the UltraPath for Windows Manager.....................................................................3-2
Figure 3-2 Virtual Disks List interface.................................................................................................................3-4
Figure 3-3 Virtual Disk Details interface.............................................................................................................3-5
Figure 3-4 LUN Information interface.................................................................................................................3-7
Figure 3-5 LUN Information interface.................................................................................................................3-8
Figure 3-6 MPIO Disk Map interface................................................................................................................3-10
Figure 3-7 Configuration interface.....................................................................................................................3-11
Figure 3-8 Cluster networking that uses load balancing....................................................................................3-15
Figure 3-9 Array interface..................................................................................................................................3-16

Issue 01 (2011-05-09) Huawei Proprietary and Confidential vii


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
Figures User Guide

Figure 3-10 Physical Disks via Controller interface..........................................................................................3-17


Figure 3-11 IO Count interface..........................................................................................................................3-18
Figure 3-12 IO performance...............................................................................................................................3-19
Figure 3-13 Version interface.............................................................................................................................3-20
Figure 3-14 UltraPath for Windows Manager interface.....................................................................................3-21
Figure B-1 Viewing logical disks........................................................................................................................B-1
Figure B-2 Initialize Disk menu..........................................................................................................................B-2
Figure B-3 Initialize Disk interface.....................................................................................................................B-2
Figure B-4 Initialize Disks complete...................................................................................................................B-3
Figure C-1 Restarting the WMI service..............................................................................................................C-1
Figure C-2 Changing the WMI properties...........................................................................................................C-2
Figure C-3 Renaming the repository file folder..................................................................................................C-2

viii Huawei Proprietary and Confidential Issue 01 (2011-05-09)


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
User Guide Tables

Tables

Table 3-1 Parameters on the virtual disks list interface........................................................................................3-4


Table 3-2 Parameters on the Virtual Disk Details interface.................................................................................3-5
Table 3-3 Parameters on the LUN Information interface.....................................................................................3-8
Table 3-4 Status of the log..................................................................................................................................3-11
Table 3-5 Values of path verification.................................................................................................................3-12
Table 3-6 Values of the retry timer....................................................................................................................3-12
Table 3-7 Status of the cluster............................................................................................................................3-13
Table 3-8 Status of the LoadBalance..................................................................................................................3-13
Table 3-9 Status of the LBController.................................................................................................................3-14
Table 3-10 Status of the FailOver.......................................................................................................................3-15
Table 3-11 Parameters on the array interface.....................................................................................................3-16
Table 3-12 Parameters on the Physical Disks via Controller interface..............................................................3-17
Table 3-13 Parameters on the IO Count interface..............................................................................................3-18
Table 3-14 Parameters on the version interface.................................................................................................3-21
Table 3-15 Description for the buttons of the supplementary functions............................................................3-22
Table 3-16 Parameters to be specified during querying information of the controller connected to the server
.............................................................................................................................................................................3-27
Table 3-17 Parameters to be specified during querying IO performance of the virtual LUN............................3-28

Issue 01 (2011-05-09) Huawei Proprietary and Confidential ix


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
User Guide 1 Overview of the UltraPath for Windows

1 Overview of the UltraPath for Windows

About This Chapter

The UltraPath for Windows is the driver of the application server (AS) developed by Huawei
Technologies Co., Ltd. It is based on Windows MultiPath Input Output (MPIO) architecture. It
controls the AS in accessing the storage system, provides path selection between the AS and the
storage system, and manages paths.
1.1 Introduction
The UltraPath for Windows is applicable to the scenario where the AS runs on Windows. The
software not only can improve the reliability of data transmission to secure the path between the
AS and the storage system, but also provide a multipath solution for the AS to access the storage
system, to improve the security, reliability and maintainability of enterprise data storage.
1.2 Functions
In this section, functions of the UltraPath for Windows are introduced. The UltraPath for
Windows can select an optimal path between a server and a storage device. In addition, it supports
failover, failback, I/O load balance, and AS clustering.
1.3 Requirements on Operating Environment
Before installing the UltraPath for Windows, you need to check the AS and the storage system.
To ensure a successful installation, install the UltraPath for Windows in the environments
described in the section.

Issue 01 (2011-05-09) Huawei Proprietary and Confidential 1-1


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
1 Overview of the UltraPath for Windows User Guide

1.1 Introduction
The UltraPath for Windows is applicable to the scenario where the AS runs on Windows. The
software not only can improve the reliability of data transmission to secure the path between the
AS and the storage system, but also provide a multipath solution for the AS to access the storage
system, to improve the security, reliability and maintainability of enterprise data storage.

To improve the reliability of data transmission, multiple paths are generally selected for the
connection between the AS and the storage system. Without being supported by multipath
software, however, this mode always leads to the following problems:

l Creating an illusion of multiple redundant disks


If a storage system maps a logical unit number (LUN) for an AS and multiple paths are
used for connection, multiple unreal redundant mapped disks are seen at the AS, thus
creating a false appearance.
l Inability to demonstrate the advantages of path redundancy
Despite the fact that there are multiple paths between the AS and the storage system, the
OS does not know when to use the redundant paths, leaving path redundancy existed in
name.
l Posing risks to data
As the AS fails to detect the real mapped disks, the OS cannot distinguish them. In this
case, data overwriting or I/O error may occur if data is saved to the disks.

Installing the UltraPath for Windows will solve these problems as the UltraPath for Windows
can be applied in the networking environment formed by the AS installed with the software and
the storage system.

Figure 1-1 and Figure 1-2 shows the typical networking mode.

Figure 1-1 Typical networking mode 1

AS
UltraPath
HBA1 / NIC1 HBA2 / NIC2

00 01 00 01
Controller A Controller B
Controller subrack

Front-End host port Cable


Port of AS

1-2 Huawei Proprietary and Confidential Issue 01 (2011-05-09)


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
User Guide 1 Overview of the UltraPath for Windows

NOTE

l HBA:Host Bus Adapter


l NIC:Network Interface Card

Figure 1-2 Typical networking mode 2

AS
UltraPath
HBA1 / NIC1 HBA2 / NIC2

network1 network2

00 01 00 01
Controller A Controller B
Controller subrack

Front-End host port


Cables
Port of AS

NOTE

In Figure 1-2:
l For system networking through FC switch, network 1 (network 2) denotes a fabric. A fabric is figured
as an FC switch typically.
l For system networking through Ethernet switch, network 1 (network 2) denotes a subnet. One or more
Ethernet switches can form a subnet.
l For system networking through Ethernet switch ,if the controller is reset, it takes about 2 minutes for
the services to switch to the other controller because the iSCSI initiator is configured with default
parameter. To shorten the switch time, please consult Microsoft on how to configure the parameters
for the iSCSI initiator.

1.2 Functions
In this section, functions of the UltraPath for Windows are introduced. The UltraPath for
Windows can select an optimal path between a server and a storage device. In addition, it supports
failover, failback, I/O load balance, and AS clustering.
The UltraPath for Windows provides the following functions:

Issue 01 (2011-05-09) Huawei Proprietary and Confidential 1-3


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
1 Overview of the UltraPath for Windows User Guide

l Selecting paths between the AS and the storage system


After an AS is installed with the UltraPath for Windows, the UltraPath for Windows is
loaded to Windows kernel as a driver. With the UltraPath for Windows, the AS can select
the optimal path to communicate with the storage system.
NOTE

One controller supports up to 4 paths, so a dual-controller storage system supports up to 8 paths for
each mapped LUN and the 32–node VIS storage system supports up to 128 paths.
l Failover
Failover refers to switchover upon failure. To ensure a high reliability of data transmission,
multiple paths are required between AS and storage system. When the path that has I/O
transmission fails, the UltraPath for Windows provides Failover to automatically switch
the services to other path in order to avoid any service interruption due to single point
failure.
l Failback
Failback refers to recovery from failure. In the case of failover, when the recovered path
can transmit I/O streams after a fault is rectified or recovered, the Failback supported by
the UltraPath for Windows Manager will automatically switch the I/O transmission path
to the recovered path.
l I/O load balance
I/O load balance is designed to share the network traffic and expand the bandwidth. Multiple
paths bear the I/O traffic flowing to the same destination. When there are two or more paths
from AS to the same controller of the storage system, the user can set proper path selection
policy on the UltraPath for Windows Manager to achieve load balance.
l Cluster
The cluster is a group of running Microsoft Cluster Service (MSCS) which monitors storage
resources and ASs and automatically identifies and restores the failed independent server.
The UltraPath for Windows supports server cluster.

1.3 Requirements on Operating Environment


Before installing the UltraPath for Windows, you need to check the AS and the storage system.
To ensure a successful installation, install the UltraPath for Windows in the environments
described in the section.

1.3.1 Application Server


In this section, the installation of the OSs that the UltraPath for Windows supports, and the
requirements on Microsoft iSCSI and HBA are introduced.
1.3.2 Storage System
In order to install the UltraPath for Windows successfully, before installing the UltraPath for
Windows, the port module must be configured properly by the controller subrack on the storage
system.

1.3.1 Application Server


In this section, the installation of the OSs that the UltraPath for Windows supports, and the
requirements on Microsoft iSCSI and HBA are introduced.

1-4 Huawei Proprietary and Confidential Issue 01 (2011-05-09)


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
User Guide 1 Overview of the UltraPath for Windows

Requirements on the OS
The UltraPath for Windows supports the following Windows OSs:
l Windows Server 2008 Enterprise Edition amd64 SP1 (Service Pack 1) (64 bits).
l Windows Server 2008 Enterprise Edition x86 SP1 (32 bits).
l Windows Server 2003 Enterprise Edition amd64 SP1 (64 bits).
l Windows Server 2003 Enterprise Edition x86 SP1 (32 bits).
l Windows Server 2000 SP4,use IE 6.0 or a later version.

If you plan to set the cluster function, the UltraPath for Windows supports the following
Windows OSs:
l Windows Server 2008 Enterprise Edition amd64 SP1(64 bits)
l Windows Server 2003 Enterprise Edition amd64 SP2 (64 bits)
l Windows Server 2003 Enterprise Edition x86 SP2 (32 bits)

CAUTION
l After the UltraPath for Windows is successfully installed on the AS on which Windows
Server 2003 Enterprise Edition amd64 SP1 is installed, virtual disks cannot be created. It is
suggested to restart the computer three times or upgrade the version of the OS to SP2.
l Windows Server 2003 Enterprise Edition amd64 SP2 does not support cluster networking
through iSCSI.
l Due to the upgrade of software version, the actual installation path of the UltraPath for
Windows may be different from the installation path described in this document. Please
determine the installation path according to the specific circumstance.

Requirements on Microsoft iSCSI Initiator


For the networking with the iSCSI protocol, you need to install the Microsoft iSCSI Initiator on
the AS. The UltraPath for Windows supports the Microsoft iSCSI Initiator.

NOTE

l Both Windows Server 2008 Enterprise Edition amd64 SP1 and Windows Server 2008 Enterprise
Edition x86 SP1 have built-in iSCSI Initiator. Therefore, you do not need to install it additionally. Click
Start, choose Administrative Tools > iSCSI Initiator, then you can run iSCSI Initiator built in
Windows Server 2008.
l You can download the installation program of the Microsoft iSCSI Initiator from the website of
Microsoft. Ensure that the version of the Microsoft iSCSI Initiator is 2.01 or later.
l For Windows Server 2008 R1 SP1 (32 bit/64 bit) and Windows Server 2008 R1 SP2 (32 bit/64 bit)
with iSCSI networks, you need to install corresponding patch for the NIC. You can download the patch
on http://support.microsoft.com/kb/970658.

The precautions on installing the Microsoft iSCSI Initiator are as follows:


l Install the Microsoft iSCSI Initiator before installing the UltraPath for Windows.
l When installing the Microsoft iSCSI Initiator, do not install the multipath driver provided
by iSCSI.

Issue 01 (2011-05-09) Huawei Proprietary and Confidential 1-5


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
1 Overview of the UltraPath for Windows User Guide

When installing the Microsoft iSCSI Initiator, do not select Microsoft MPIO
Multipathing Support for iSCSI, as shown in Figure 1-3.

Figure 1-3 Software Update Installation Wizard interface

l Before installing the UltraPath for Windows, ensure no IP addresses are displayed on the
Microsoft iSCSI initiator tab. Delete the existing IP address if there are.
Select Discovery tab for running the Microsoft iSCSI Initiator, if the dialog box is displayed
as shown in Figure 1-4, it shows the previous IP address. You should click Remove to
delete the IP address.

1-6 Huawei Proprietary and Confidential Issue 01 (2011-05-09)


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
User Guide 1 Overview of the UltraPath for Windows

Figure 1-4 iSCSI Initiator Properties dialog box

l Before installing the UltraPath for Windows, delete the existing connections if there are,
and make sure the Microsoft iSCSI Initiator is not connected.
Select Persistent Targets tab, if the interface is displayed as shown in Figure 1-5, it shows
the last target. You should click Remove to delete target.
NOTE

For running iSCSI Initiator built in Windows Server 2008, select Favorite Targets tab to check if
any connection exist. If so, you should click Remove to delete target.

Issue 01 (2011-05-09) Huawei Proprietary and Confidential 1-7


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
1 Overview of the UltraPath for Windows User Guide

Figure 1-5 iSCSI Initiator Properties dialog box

l When connecting Microsoft iSCSI Initiator, select the automatically restore connection
function.
Run Microsoft iSCSI Initiator first. Select Targets tab and click Log On..., the Log On to
Target dialog box is displayed. Select Automatically restore this connection when the
system boots, as shown in Figure 1-6.

Figure 1-6 Log On to Target dialog box

1-8 Huawei Proprietary and Confidential Issue 01 (2011-05-09)


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
User Guide 1 Overview of the UltraPath for Windows

Requirements on HBA Card

CAUTION
l The AS must install fiber channel (FC) host bus adapter (HBA) when networking through
FC.
l The driver for the HBA in the AS of each node must support the StorPort driver.

The UltraPath for Windows supports FC HBA. For installation of HBA on the AS, contact
Huawei for technical support.
For the FC HBA, note the following:
l The UltraPath for Windows cannot coexist with the Failover and Failback of an HBA, so
make sure the Failover and Failback are disabled on the HBA.
l To install the UltraPath for Windows, you must install the same model of HBA from the
same manufacturer on the same AS.
l Before installing the UltraPath for Windows, make sure that the HBA driver is installed
correctly.
l Restart the node AS after installing the HBA driver.
l If the system cannot scan any physical LUN, uninstall the HBA driver and reinstall it. Make
sure that the HBA driver does not bring about any problem caused by plug and play (PnP).

1.3.2 Storage System


In order to install the UltraPath for Windows successfully, before installing the UltraPath for
Windows, the port module must be configured properly by the controller subrack on the storage
system.

CAUTION
If the storage system is configured with iSCSI host port or FC host port, the same model of HBA
from the same manufacturer should be installed on the same AS.

Issue 01 (2011-05-09) Huawei Proprietary and Confidential 1-9


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
User Guide 2 Installation and Uninstallation

2 Installation and Uninstallation

About This Chapter

In this chapter, the operation processes of installing and uninstalling the UltraPath for Windows
are introduced.
2.1 Preparations Before Installation
This chapter describes the preparations for installing the UltraPath for Windows.
2.2 Installing the UltraPath for Windows for the First Time
In this section, the methods of setting driver signing, installing the UltraPath for Windows, and
scanning LUNs are introduced.
2.3 Reinstalling the UltraPath for Windows
In this section, the methods of reinstalling or upgrading the UltraPath for Windows is introduced.
2.4 Uninstalling the UltraPath for Windows
In this section, two ways of uninstalling the UltraPath for Windows are introduced. You can
uninstall the UltraPath for Windows through install wizard or control panel.

Issue 01 (2011-05-09) Huawei Proprietary and Confidential 2-1


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
2 Installation and Uninstallation User Guide

2.1 Preparations Before Installation


This chapter describes the preparations for installing the UltraPath for Windows.

Procedure
Step 1 Check whether the versions of Windows OS and the service pack installed on the AS meet the
requirements for installing the UltraPath for Windows. For details, see 1.3.1 Application
Server.
Step 2 Ensure that the version of Internet Explorer (IE) on the AS is 6.0 or higher.
Step 3 Ensure that the current version of the UltraPath for Windows installation package matches with
the type of Windows OS installed on the AS.
Step 4 Check whether an old version of the UltraPath for Windows is installed on the AS. If so, uninstall
the old version of the UltraPath for Windows properly before the installation.
Step 5 If the OS of the AS where the UltraPath for Windows is to be installed is Windows 2000, ensure
that the AS is installed with the Support Tools that are contained in Windows 2000 OS
Installation CD.
Step 6 If Microsoft iSCSI Initiator is installed on the AS, see 1.3.1 Application Server to check whether
Microsoft iSCSI Initiator meets the requirements for installing the UltraPath for Windows.
Step 7 If FC HBAs are installed on the AS, see 1.3.1 Application Server to check whether the HBAs
meet the requirements for installing the UltraPath for Windows.

----End

2.2 Installing the UltraPath for Windows for the First Time
In this section, the methods of setting driver signing, installing the UltraPath for Windows, and
scanning LUNs are introduced.
2.2.1 Setting Driver Signing
In this section, way of setting driver signing is introduced. If driver signing is set to be neglected
before installation, you do not need to perform this operation.
2.2.2 Installing the UltraPath for Windows Through the Installation Program
In this section, the way of installing the UltraPath for Windows through the installation program
is introduced.
2.2.3 Installing the UltraPath for Windows Through the Scripts
In this section, the way of installing the UltraPath for Windows through the scripts is introduced.
2.2.4 Scanning LUN
After the UltraPath for Windows is installed, you need to scan on the application server for the
mapped LUNs, making the LUNs available.

2.2.1 Setting Driver Signing


In this section, way of setting driver signing is introduced. If driver signing is set to be neglected
before installation, you do not need to perform this operation.

2-2 Huawei Proprietary and Confidential Issue 01 (2011-05-09)


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
User Guide 2 Installation and Uninstallation

Context
This operation is selected. If you do not select ignore the driver signing, Figure 2-7 will display
during installing the UltraPath for Windows.

Procedure
Step 1 Right-click My Computer and select Properties in the shortcut menu.

Step 2 Select Hardware tab in the System Properties dialog box.

Step 3 Click Driver Signing, the Driver Signing Option dialog box is displayed, as shown in Figure
2-1.

Figure 2-1 Driver Signing Options dialog box

Step 4 Select Ignore - Install the software anyway and don't ask for my approval and click OK.

----End

2.2.2 Installing the UltraPath for Windows Through the Installation


Program
In this section, the way of installing the UltraPath for Windows through the installation program
is introduced.

Caution
l Before installing the UltraPath for Windows, stop all services upon the mapped disk.

Issue 01 (2011-05-09) Huawei Proprietary and Confidential 2-3


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
2 Installation and Uninstallation User Guide

l Before installing the UltraPath for Windows, disconnect the application server from the
storage system.
l Before installing the UltraPath for Windows, ensure that no third-party multipathing
software exists on the application server.
l Before installing the UltraPath for Windows, log in to the application server as an
administrator. Otherwise, the UltraPath Manager cannot work normally.

Procedure
Step 1 Log in to the AS to be installed with UltraPath for Windows as administrator.

Step 2 Copy the installation program of the UltraPath for Windows to the AS.
NOTE

l You can obtain the UltraPath for Windows installer from the CD shipped with the product of Huawei.
l Because the UltraPath for Windows is subject to frequent version upgrades, the actual file path of the
installation package may be different from that specified in the manual. Therefore, operations must
vary according to the actual situation.

Step 3 The installation program of current version is in the windows/Packages directory. Run the
corresponding application program matching with the OS version. The interface of basic
conditions checklist is displayed, as shown in Figure 2-2.

Figure 2-2 Basic conditions checklist interface

Step 4 Check the condition items in turn. If one of them is not met, exceptions may occur during
installation or running.

Step 5 After all the condition items are checked, click Next to go to the interface of iSCSI environment
checklist, as shown in Figure 2-3.

2-4 Huawei Proprietary and Confidential Issue 01 (2011-05-09)


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
User Guide 2 Installation and Uninstallation

Figure 2-3 iSCSI environment checklist interface

NOTE
When the environment is not iSCSI networking, check all the condition items and then click Next.

Step 6 Check the condition items of iSCSI environment in turn. If one of them is not met, exceptions
may occur during installation or running.
Step 7 After all condition items are checked, click Next to go to the UltraPath for Windows-Install
Wizard interface, as shown in Figure 2-4.

Issue 01 (2011-05-09) Huawei Proprietary and Confidential 2-5


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
2 Installation and Uninstallation User Guide

Figure 2-4 UltraPath for Windows - Install Wizard interface

Step 8 Click Next. The Customer Information interface is displayed, as shown in Figure 2-5.
NOTE
The user can customize the name input in Organization, this document takes huawei as an example.

2-6 Huawei Proprietary and Confidential Issue 01 (2011-05-09)


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
User Guide 2 Installation and Uninstallation

Figure 2-5 Customer Information interface

Step 9 Enter the information of the user name and organization.


Step 10 Click Next. The Ready to Install the Program interface is displayed, as shown in Figure
2-6.

Issue 01 (2011-05-09) Huawei Proprietary and Confidential 2-7


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
2 Installation and Uninstallation User Guide

Figure 2-6 Ready to Install the Program interface

Step 11 Click Install. The installing UltraPath for Windows interface is displayed, as shown in Figure
2-7.

Figure 2-7 Installing UltraPath for Windows interface

If you do not ignore the driver signing in the section "2.2.1 Setting Driver Signing", the dialogue
box will show in Figure 2-8 during the installation. Click Yes, Figure 2-9 will be displayed.

2-8 Huawei Proprietary and Confidential Issue 01 (2011-05-09)


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
User Guide 2 Installation and Uninstallation

Figure 2-8 Security Alert - Driver Installation interface

Step 12 The installation is complete. The Install Wizard Completed interface is displayed, as shown
in Figure 2-9.

Figure 2-9 Install Wizard Completed interface

Issue 01 (2011-05-09) Huawei Proprietary and Confidential 2-9


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
2 Installation and Uninstallation User Guide

Step 13 Click Finish. The UltraPath for Windows Installer Information dialog box is displayed, as
shown in Figure 2-10.

Figure 2-10 UltraPath for Windows Installer Information dialog box

Step 14 Click Yes to restart the AS.


Step 15 Check whether the UltraPath for Windows is installed successfully.
Once the UltraPath for Windows is installed successfully, there should be an UltraPath Manager
icon on the desktop. Choose Start > All Programs > UltraPath for Windows > Launch
UPManager.exe. To verify whether the UltraPath for Windows is installed successfully,
perform the following steps.
1. Right-click on My Computer and choose Management in the shortcut menu. The
Computer Management interface is displayed.
2. Click Device Manager in the navigation tree on the left side of Computer
Management.
3. For Windows 2003 or Windows 2000, expand SCSI and RAID Controller node on the
right side. If the manager is installed successfully, there will be Multi-Path Support, as
shown in Figure 2-11. For Windows 2008, expand System devices node on the right side.
If the manager is installed successfully, there will be UltraPath Device Specific
Module.

2-10 Huawei Proprietary and Confidential Issue 01 (2011-05-09)


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
User Guide 2 Installation and Uninstallation

Figure 2-11 Computer Management interface

NOTE

l SCSI: Small Computer System Interface


l RAID: Redundant Array of Independent Disks

CAUTION
After installing the UltraPath for Windows, do not move, modify or delete any file under the
catalog of \UltraPath, and you should not run install.bat or uninstall.bat.

----End

2.2.3 Installing the UltraPath for Windows Through the Scripts


In this section, the way of installing the UltraPath for Windows through the scripts is introduced.

Caution
l Before installing the UltraPath for Windows, stop all services upon the mapped disk.
l Before installing the UltraPath for Windows, disconnect the application server from the
storage system.
l Before installing the UltraPath for Windows, ensure that no third-party multipathing
software exists on the application server.

Issue 01 (2011-05-09) Huawei Proprietary and Confidential 2-11


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
2 Installation and Uninstallation User Guide

l Before installing the UltraPath for Windows, log in to the application server as an
administrator. Otherwise, the UltraPath Manager cannot work normally.

Procedure
Step 1 Log in to the AS to be installed with UltraPath for Windows as administrator.

Step 2 Copy the installation program of the UltraPath for Windows to the AS.
NOTE

l You can obtain the UltraPath for Windows installation program from the CD shipped with the product
of Huawei.
l Because the UltraPath for Windows is subject to frequent version upgrades, the actual file path of the
installation package may be different from that specified in the manual. Therefore, operations must
vary according to the actual situation.

Step 3 Run the install.vbs script in the xxx/Windows directory (xxx indicates the path where the
installation package is located). The installation script selects the package corresponding to the
OS model to install the UltraPath for Windows.

And then follow Step 3 to Step 15 in 2.2.2 Installing the UltraPath for Windows Through
the Installation Program to finish the installation.

----End

2.2.4 Scanning LUN


After the UltraPath for Windows is installed, you need to scan on the application server for the
mapped LUNs, making the LUNs available.

Prerequisite
Before scanning LUNs, check and ensure that the IP address of the service interface on the
storage system already exists in iSCSI Initiator Properties and its status is Connected.

Context
After the OS restarts, the storage resources on the storage system can be mapped to the AS. For
example: Two LUNs on the storage system are mapped to the AS and a storage device and a AS
adopts redundant connections with two paths.

Procedure
Step 1 Right-click on My Computer and choose Management in the shortcut menu. The Computer
Management interface is displayed.

Step 2 Choose System Tools > Device Manager, right-click Disk Drive, and choose Scan for
Hardware Changes in the pop up menus.

The system scans four disk drives generated from redundant connection and two virtual LUN
mapping disk drives after the UltraPath for Windows shields the ghost effect of the LUN, as
shown in Figure 2-12.

2-12 Huawei Proprietary and Confidential Issue 01 (2011-05-09)


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
User Guide 2 Installation and Uninstallation

Figure 2-12 Viewing the LUN mapped to the AS from the storage system

NOTE

l For Windows Server 2008, by default the physical drives are invisible at this place, you must select
View > Show hidden devices on the menu bar to display the physical drives.
l Multi-Path Disk Device shown on the interface indicates the virtual disk drive is usable after the
UlraPath for Windows shields the ghost effect of the LUN. SCSI Disk Device means disk drives
generated from redundant path connection. These drives are unusable after the UltraPath for Windows
is installed in the system.

At this time, the AS is able to initialize the mapping disk like local disks if you choose
Storage > Disk Management .

For details about disk initialization, refer to "B Initializing Disks". After disk initialization, you
can perform partitioning, formatting and data access to the disks.

----End

2.3 Reinstalling the UltraPath for Windows


In this section, the methods of reinstalling or upgrading the UltraPath for Windows is introduced.

Caution
Before reinstalling or upgrading the UltraPath for Windows, you should stop the I/O. Restarting
the OS after uninstalling the UltraPath for Windows.

Procedure
Step 1 Uninstall the original Ultrapath for Windows on the AS. For details, see section "2.4
Uninstalling the UltraPath for Windows".

Issue 01 (2011-05-09) Huawei Proprietary and Confidential 2-13


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
2 Installation and Uninstallation User Guide

Step 2 Install the UltraPath for Windows. For details, see section "2.2 Installing the UltraPath for
Windows for the First Time".

----End

2.4 Uninstalling the UltraPath for Windows


In this section, two ways of uninstalling the UltraPath for Windows are introduced. You can
uninstall the UltraPath for Windows through install wizard or control panel.

Context

CAUTION
l Before uninstalling the UltraPath for Windows, please check and ensure that all the
connections in iSCSI Initiator are disconnected. If a connection fails to be disconnected,
please contact the technical support engineer.
l For Windows Server 2008, after uninstalling the UltraPath for Windows successfully, right-
click on My Computer and choose Management in the shortcut menu. The Computer
Management interface is displayed. Click Device Manager in the navigation tree on the
left side of Computer Management. Expand Storage controllers node on the right side,
there will be Microsoft Multi-Path Bus Driver. Right-click on Microsoft Multi-Path Bus
Driver, please do not choose uninstall. This will cause UltraPath for Windows can not be
installed anymore.
l Before you uninstall UltraPath for Windows, check whether the application server runs the
Oracle database services. If yes, disable these services or stop all corresponding processes.

2.4.1 Uninstall through Install Wizard


In this section, way of uninstalling the UltraPath for Windows with Install Wizard is introduced.
2.4.2 Uninstall through Control Panel
In this section, way of uninstalling the UltraPath for Windows through the control panel is
introduced.

2.4.1 Uninstall through Install Wizard


In this section, way of uninstalling the UltraPath for Windows with Install Wizard is introduced.

Caution
l Disconnect the AS from the storage system before uninstalling the UltraPath for Windows.
l Restart the AS after the UltraPath for Windows is uninstalled.

Procedure
Step 1 Run the installation program of the UltraPath for Windows, and the system goes to the UltraPath
for Windows - Install Wizard interface, as shown in Figure 2-13.

2-14 Huawei Proprietary and Confidential Issue 01 (2011-05-09)


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
User Guide 2 Installation and Uninstallation

Figure 2-13 UltraPath for Windows - Install Wizard interface

Step 2 The confirming interface is displayed, as shown in Figure 2-14. Click Yes to uninstall the
software, otherwise click No.

Figure 2-14 Confirm to uninstall dialog box

Step 3 The uninstalling interface is displayed, as shown in Figure 2-15.

Issue 01 (2011-05-09) Huawei Proprietary and Confidential 2-15


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
2 Installation and Uninstallation User Guide

Figure 2-15 Uninstalling interface

Step 4 The Uninstall Complete interface is displayed, as shown in Figure 2-16.

Figure 2-16 Uninstall Completed interface

Step 5 Choose Yes, I want to restart my computer now. Click Finish to display the dialogue box
shown in Figure 2-17.

2-16 Huawei Proprietary and Confidential Issue 01 (2011-05-09)


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
User Guide 2 Installation and Uninstallation

Figure 2-17 Restart Computer prompt interface

Step 6 Click Finish to restart the AS. By now, the UltraPath for Windows is successfully uninstalled.
NOTE

When some remote users log into the AS and run some applications at the same time, the AS might not
restart automatically, you must restart the AS manually after uninstalling the UltraPath for Windows.

----End

2.4.2 Uninstall through Control Panel


In this section, way of uninstalling the UltraPath for Windows through the control panel is
introduced.

Procedure
Step 1 Choose Start > Control Panel > Add or Remove Programs.
Step 2 Select UltraPath for Windows and click Delete. The Add or Remove Programs dialog box
is displayed, as shown in Figure 2-18.

Figure 2-18 Add or Remove Programs dialog box

Issue 01 (2011-05-09) Huawei Proprietary and Confidential 2-17


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
2 Installation and Uninstallation User Guide

Step 3 Click Yes. The system starts uninstall the UltraPath for Windows.
Step 4 Reboot the AS. The UltraPath for Windows is uninstalled successfully.

----End

2-18 Huawei Proprietary and Confidential Issue 01 (2011-05-09)


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
User Guide 3 Instructions on UltraPath for Windows Manager

3 Instructions on UltraPath for Windows


Manager

About This Chapter

To help you better manage and monitor the multiple paths on the AS running on Windows, the
UltraPath for Windows provides UltraPath for Windows Manager. In this chapter, usage and
function of the UltraPath for Windows Manager is introduced.
3.1 Usage Description
In this section, usage of the UltraPath for Windows Manager is introduced. After you install the
UltraPath for Windows properly and obtain the stored resources from the storage system, double-
click Launch UPManager.exe to perform related operations.
3.2 Function Description
In this section, functions of the UltraPath for Windows Manager are introduced in detail.
3.3 Common Commands
This chapter describes the common commands for the UltraPath for Windows.

Issue 01 (2011-05-09) Huawei Proprietary and Confidential 3-1


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
3 Instructions on UltraPath for Windows Manager User Guide

3.1 Usage Description


In this section, usage of the UltraPath for Windows Manager is introduced. After you install the
UltraPath for Windows properly and obtain the stored resources from the storage system, double-
click Launch UPManager.exe to perform related operations.

For Windows 2003 or Windows 2008, Figure 3-1 shows the main interface of the UltraPath for
Windows Manager.

Figure 3-1 Main Interface of the UltraPath for Windows Manager

3.2 Function Description


In this section, functions of the UltraPath for Windows Manager are introduced in detail.
3.2.1 Querying List of Virtual Disks
In this section, way of querying list of virtual disks is introduced. And the parameters in the list
are explained.
3.2.2 Querying Details of Virtual Disks
In this section, take Windows 2003 as an example, way of querying details of virtual disks is
introduced. And the parameters of disks are explained.
3.2.3 Querying Information of LUN

3-2 Huawei Proprietary and Confidential Issue 01 (2011-05-09)


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
User Guide 3 Instructions on UltraPath for Windows Manager

In this section, take Windows 2003 as an example, way of querying information of LUN is
introduced. And parameters related to LUN are explained.
3.2.4 Querying Partitioning Information of Virtual Disks
In this section, take Windows 2003 as an example, way of querying partitioning information of
virtual disks is introduced.
3.2.5 Querying and Setting Information of Configuration
In this section, ways of querying and setting the status of the log, the values of path verification,
the values of the retry timer, the status of the cluster, the policy of LoadBalance, the status of
LBController, and the status of FAILOVER are introduced.
3.2.6 Querying Storage System Information
In this section, take Windows 2003 as an example, way of querying storage system information
is introduced. And parameters of the system information are explained.
3.2.7 Querying Path Information on Controller
In this section, take Windows 2003 as an example, way of querying path information on
controller is introduced. And parameters of the path information on controller are explained.
3.2.8 Querying All LUNs I/O Count
In this section, take Windows 2003 as an example, way of querying I/O count of all LUNs is
introduced. And I/O parameters are explained.
3.2.9 Querying IO Performance Information
In this section, take Windows 2003 as an example, way of querying IO performance information
is introduced. And parameters for querying the IO performance are explained.
3.2.10 Querying Version Information
In this section, way of querying version information is introduced. And parameters on the version
information are explained.
3.2.11 Supplementary Functions
This section describes the supplementary functions of the UltraPath for Windows Manager.

3.2.1 Querying List of Virtual Disks


In this section, way of querying list of virtual disks is introduced. And the parameters in the list
are explained.

CAUTION
If you modify the mapping LUNs of the storage system, please scan LUN in AS, see section
"2.2.4 Scanning LUN", then click Refresh.

Click MPIOList tab on the interface of UltraPath for Windows Manager, then click Refresh.
For Windows 2003, the interface is displayed as shown in Figure 3-2. The interface shows the
information about virtual disks allocated by the storage system to the AS.

Issue 01 (2011-05-09) Huawei Proprietary and Confidential 3-3


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
3 Instructions on UltraPath for Windows Manager User Guide

Figure 3-2 Virtual Disks List interface

Table 3-1 describes the parameters on the interface.

Table 3-1 Parameters on the virtual disks list interface


Name Description

Number of Virtual Disks Total number of virtual disks.

Number of Physical Disks Total number of physical disks.

Max. Number of LUNs Maximum number of LUNs supported by the AS.

Max. Number of Paths Maximum number of paths supported by each LUN.

Virtual Disk Sequence Number Serial number of a mapping disk.

Virtual Disk Name Name of a mapping disk.

Number of Paths Number of paths of the mapping disk from the storage
system to the AS.

LUN WWNa WWN of the LUN.

LUN Name Name of the LUN.

a:WWN (World-Wide Number)

3-4 Huawei Proprietary and Confidential Issue 01 (2011-05-09)


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
User Guide 3 Instructions on UltraPath for Windows Manager

NOTE

All serial numbers involved in the UltraPath for Windows Manager, including path number, LUN virtual
disk number, are numbered from 0.

3.2.2 Querying Details of Virtual Disks


In this section, take Windows 2003 as an example, way of querying details of virtual disks is
introduced. And the parameters of disks are explained.

Enter the sequence number of a mapping disk in the text box Virtual Disk Sequence
Number: and click Query in the frame Virtual Disk Details. The interface is displayed as
shown in Figure 3-3. You can view the details of the mapping disk on the interface.

Figure 3-3 Virtual Disk Details interface

Table 3-2 describes the parameters on the interface.

Table 3-2 Parameters on the Virtual Disk Details interface

Name Description

Virtual Disk Sequence Number Serial number of a mapping disk.

Number of Paths Number of paths of the mapping disk from the storage
system to the AS.

Issue 01 (2011-05-09) Huawei Proprietary and Confidential 3-5


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
3 Instructions on UltraPath for Windows Manager User Guide

Name Description

Number of Failover Groups Number of Failover Groups.


NOTE
Failover Group: When any path in the group is disconnected
and Failover function is enabled, other paths in the group also
enable Failover.

Number of MultiPath Groups Number of MultiPath Groups.


NOTE
MultiPath Group: A group of all available paths for AS to
access one LUN. When one of the paths fails, other paths can
take over the services.

Path Details: The following shows the information about the path of the mapping disk
from the storage system to the AS.

Using Path Indicates whether the current path is the working path
for the mapping disk to transmit data.
Y: yes. N: no.

Preferred Path Indicates whether the current path is the preferred path
for the mapping disk.
Y: yes. N: no.
NOTE
Preferred path: Path selected by the multipath that performs the
optimal I/O performance .

Port Number Port number of HBA card These four fields compose
on the AS. the unique SCSI address,
indicating the SCSI
SCSI Path ID SCSI path ID, to identify address of the physical
an SCSI array. LUN.
Target ID SCSI bus address of the
controller.

LUN An unique ID assigned to


a LUN by an AS when the
LUN is mapped to the AS.

3.2.3 Querying Information of LUN


In this section, take Windows 2003 as an example, way of querying information of LUN is
introduced. And parameters related to LUN are explained.
Enter the port number of HBA card, the SCSI path ID, the SCSI bus address, the LUN ID in the
text box SCSI Address in sequence. Click Query in the frame LUN Information.
l For the VIS disk, the interface is displayed as shown in Figure 3-4.
l For the non-VIS disk, the interface is displayed as shown in Figure 3-5.
You can view the details of LUNs on the interface.

3-6 Huawei Proprietary and Confidential Issue 01 (2011-05-09)


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
User Guide 3 Instructions on UltraPath for Windows Manager

Figure 3-4 LUN Information interface

Issue 01 (2011-05-09) Huawei Proprietary and Confidential 3-7


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
3 Instructions on UltraPath for Windows Manager User Guide

Figure 3-5 LUN Information interface

Table 3-3 describes the parameters on the interface.

Table 3-3 Parameters on the LUN Information interface


Name Description

NumberRead Number of read requests.

NumberWrite Number of write requests.

BytesRead Number of read bytes .

BytesWrite Number of write bytes .

Using Path Indicates whether the current path is the working path
for the mapping disk to transmit data.
Y: yes. N: no.

Preferred Path Indicate whether the current path is the preferred path
for the mapping disk.
Y: yes. N: no.
NOTE
Preferred path: Path selected by the multipath that performs the
optimal I/O performance .

3-8 Huawei Proprietary and Confidential Issue 01 (2011-05-09)


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
User Guide 3 Instructions on UltraPath for Windows Manager

Name Description

LUN WWN WWN of the LUN.

Virtual Disk Name Name of a virtual disk.

VIS Connected Controller ID The ID of the controller that is connected to the LUN for
the VIS disk.

Connected Controller ID The ID of the controller that is connected to the LUN for
the non-VIS disk.

Port Number Port number of HBA on These four fields compose


the AS. the unique SCSI address,
indicating the SCSI
SCSI Path ID SCSI path ID, to identify address of the physical
an SCSI array. LUN.
Target ID SCSI bus address of the
controller.

LUN An unique ID assigned to


a LUN by an AS when the
LUN is mapped to the AS.

3.2.4 Querying Partitioning Information of Virtual Disks


In this section, take Windows 2003 as an example, way of querying partitioning information of
virtual disks is introduced.
Select MPIO Disk Map tab on the interface of the UltraPath for Windows Manager, and click
Refresh. The interface is displayed as shown in Figure 3-6. It shows the current partition
information of each mapping disk.

NOTE

To query the partition information of mapping disks, you must enable disk performance monitoring. It is
enabled by default in Windows. If the query fails, type in diskperf -y under the command prompt.

Issue 01 (2011-05-09) Huawei Proprietary and Confidential 3-9


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
3 Instructions on UltraPath for Windows Manager User Guide

Figure 3-6 MPIO Disk Map interface

3.2.5 Querying and Setting Information of Configuration


In this section, ways of querying and setting the status of the log, the values of path verification,
the values of the retry timer, the status of the cluster, the policy of LoadBalance, the status of
LBController, and the status of FAILOVER are introduced.
Click Configuration tab on the interface of the UltraPath for Windows Manager.
For Windows Server 2003 or Windows Server 2008, the interface is displayed as shown in
Figure 3-7. It shows the information of configuration.

3-10 Huawei Proprietary and Confidential Issue 01 (2011-05-09)


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
User Guide 3 Instructions on UltraPath for Windows Manager

Figure 3-7 Configuration interface

Log
Table 3-4 describes the status on the interface.

Table 3-4 Status of the log

Status Description

Log Enable Log recording is enabled.

Log Disable Log recording is disabled.


NOTE
Logs can be viewed by choosing Computer Management > System Tools > Event Viewer > System.

The button in the frame Log are described as follows:

l Apply
This button is used to set the log status to the current input value.
l Use Default
This button is used to restore the log status to default value. Log is enabled by default.

Issue 01 (2011-05-09) Huawei Proprietary and Confidential 3-11


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
3 Instructions on UltraPath for Windows Manager User Guide

PathVerify
Table 3-5 describes the values on the interface.

Table 3-5 Values of path verification

Value Description

PathVerify Enable Path verify is opened to enable Failback.


NOTE
It is recommended to set PathVerify Open to ensure Failback
is performed properly.

PathVerify Disable Path verify is closed.

Path Verification Period Path scan interval.


Value range: 0 to 36000.
Unit: second.

Deferral Time of Virtual Disk Mapping disk removal delay.


Removal Value range: 0 to 36000.
Unit: second.

The button in the frame PathVerify are described as follows:

l Apply
This button is used to set the path verification value entered to the current input value.
l Use Default
This button is used to restore the path verification value to default value. By default,
PathVerify is enabled, path scan interval under Windows 2003 is 30 seconds, path scan
under Windows 2008 is 600 seconds. The mapping disk removal delay is 20 seconds.

Retry
Table 3-6 describes the values on the interface.

Table 3-6 Values of the retry timer

Value Description

Retry Interval Retry interval after path verify fails.


Value range: 0 to 10.
Unit: second.

Retry Count Times of retry after path verify fails.


Value range: 0 to 20.
Unit: times.

3-12 Huawei Proprietary and Confidential Issue 01 (2011-05-09)


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
User Guide 3 Instructions on UltraPath for Windows Manager

The buttons in the frame Retry are described as follows:


l Apply
This button is used to set the retry timer value entered to the current input value.
l Use Default
This button is used to restore retry timer value to default value. By default, the retry interval
after path verify fails is 5 seconds, and the number of retry times are 15.

Cluster

CAUTION
l After setting a cluster or the value of Persistent Reservation Key, the AS must be restarted
to validate the setting.
l In one cluster system, the system can support up to eight nodes.

Table 3-7 describes the status on the interface.

Table 3-7 Status of the cluster

Status Description

Cluster Enable The cluster function is enabled.

Cluster Disable The cluster function is disabled.

Persistent Reservation Key It is used to identify the nodes in the cluster, and different
values should be set for the nodes.
Length: 8 bits, digit only.
Value range: 00000000 to 99999999.

Apply button in the frame Cluster is described as follows:


This button is used to set the cluster value entered to the current input value.

LoadBalance
Table 3-8 describes the status on the interface.

Table 3-8 Status of the LoadBalance

Status Description

ROUND_ROBIN The data is sent alternately over the available


paths.

LEAST_QUEUE_DEPTH The data is sent over the path with the


minimum unaccomplished IOs.

Issue 01 (2011-05-09) Huawei Proprietary and Confidential 3-13


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
3 Instructions on UltraPath for Windows Manager User Guide

Status Description

LEAST_TASK The data is issued over the path with the least
unaccomplished data.

Apply button in the frame LoadBalance is described as follows:


This button is used to set the load balance value entered to the current input value.

LBController
This parameter is used to enable or disable the load balancing function between controllers. The
load balancing function between controllers are realized by the following schemes.
1. Determine the prior controller of the LUN first, and then perform load balancing among
the multiple paths inside the prior controller.
2. Set lbcontroller to on, and then load balancing will be performed on all paths of all
controllers.
Table 3-9 describes the status of the LBController.

Table 3-9 Status of the LBController


Status Description

Enable LBController Enable the load balancing function between


the controllers.

Disable LBController Disable the load balancing function between


the controllers.

Apply button in the frame LBController is described as follows:


This button is used to set the LBController to the status selected.

FAILOVER
By default, the UltraPath for Windows enables the switchover between operating and owning
controllers of the LUN. That is, when all the paths of the prior controller are faulty, the UltraPath
for Windows not only sends the I/O to the alternate controller, but also uses the alternate
controller of the LUN to replace the operating controller. Some types of networking, however,
are special. For example, the cluster networking that uses load balancing: Two ASs are connected
to two controllers of a storage system respectively and can access the same LUN, as shown in
Figure 3-8.

3-14 Huawei Proprietary and Confidential Issue 01 (2011-05-09)


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
User Guide 3 Instructions on UltraPath for Windows Manager

Figure 3-8 Cluster networking that uses load balancing

In this cluster networking, the UltraPath for Windows on AS A tries to use controller A as the
operating controller of the LUN, whereas the UltraPath for Windows on AS B tries to use
controller B as the operating controller of the LUN. As a result, the switchover of operating
controller goes ceaseless between controller A and controller B. To stop the switchover, set
Failover to off.
Table 3-10 describes the status of the FailOver.

Table 3-10 Status of the FailOver


Status Description

Enable FailOver Enable the FailOver function of the LUN.

Disable FailOver Disable the FailOver function of the LUN.

Apply button in the frame FAILOVER is described as follows:


This button is used to set the FailOver to the status selected.

3.2.6 Querying Storage System Information


In this section, take Windows 2003 as an example, way of querying storage system information
is introduced. And parameters of the system information are explained.

Issue 01 (2011-05-09) Huawei Proprietary and Confidential 3-15


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
3 Instructions on UltraPath for Windows Manager User Guide

Click Array tab on the interface of the UltraPath for Windows Manager. The interface is
displayed as shown in Figure 3-9.

Figure 3-9 Array interface

Table 3-11 describes the parameters on the interface.

Table 3-11 Parameters on the array interface

Name Description

Array WWN WWN of storage system.

Array Name Name of storage system.

AVTa Enabled AVT enable status.

a:AVT (Auto Volume Transfer)

3.2.7 Querying Path Information on Controller


In this section, take Windows 2003 as an example, way of querying path information on
controller is introduced. And parameters of the path information on controller are explained.

3-16 Huawei Proprietary and Confidential Issue 01 (2011-05-09)


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
User Guide 3 Instructions on UltraPath for Windows Manager

NOTE

l For non-VIS or two-node VIS, enter A or a, B or b (case insensitive) in Controller ID for query.
l For multi-node VIS, enter 0 to 31 in Controller ID for query.

Enter the WWN of the storage system in the text box Array WWN and the controller ID in the
text box Controller ID, and then click Query. Taking Array WWN is 210000e0fccecc48, and
Controller ID is a as an example, the interface is displayed as shown in Figure 3-10. You can
query the information about all paths for relevant controller on the interface.

Figure 3-10 Physical Disks via Controller interface

Table 3-12 describes the parameters on the interface.

Table 3-12 Parameters on the Physical Disks via Controller interface

Name Description

Physical Disk Number of physical disk.

Port Number Port number of HBA card on These four fields compose
the AS. the unique SCSI address,
indicating the SCSI address
SCSI Path ID SCSI path number. of the physical LUN.
Target ID SCSI bus address of the
controller.

Issue 01 (2011-05-09) Huawei Proprietary and Confidential 3-17


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
3 Instructions on UltraPath for Windows Manager User Guide

Name Description

LUN An unique ID assigned to a


LUN by an AS when the
LUN is mapped to the AS.

3.2.8 Querying All LUNs I/O Count


In this section, take Windows 2003 as an example, way of querying I/O count of all LUNs is
introduced. And I/O parameters are explained.
Click All LUNs IO Count tab on the main interface of the UltraPath for Windows Manager,
then click Refresh. The interface is displayed as shown in Figure 3-11. You can query I/O count
about all LUNs on the interface.

Figure 3-11 IO Count interface

Table 3-13 describes the parameters on the interface.

Table 3-13 Parameters on the IO Count interface

Name Description

Host LUN ID The LUN ID of host.

3-18 Huawei Proprietary and Confidential Issue 01 (2011-05-09)


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
User Guide 3 Instructions on UltraPath for Windows Manager

Name Description

Preferred Controller ID The ID of the preferred controller of the LUN.

Working Controller ID The ID of the working controller of the LUN.

PathX X indicates the number of the path.

3.2.9 Querying IO Performance Information


In this section, take Windows 2003 as an example, way of querying IO performance information
is introduced. And parameters for querying the IO performance are explained.

Click IO PERFORMANCE tab on the interface of the UltraPath for Windows Manager, and
input WWN of the storage system, LUN ID and interval in the Array WWN, LUN, and
Interval textbox respectively (Array WWN and LUN ID can be obtained in 3.2.6 Querying
Storage System Information and 3.2.1 Querying List of Virtual Disks).

Taking the array WWN is 210000e0fccecc48, LUN ID is 0, and interval is 3 seconds as an


example. After clicking Start, the system is displayed as shown in Figure 3-12. The IO
performance is displayed and refreshed every three seconds.

Figure 3-12 IO performance

Issue 01 (2011-05-09) Huawei Proprietary and Confidential 3-19


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
3 Instructions on UltraPath for Windows Manager User Guide

NOTE
The content must be input for Array WWN textbox, while the content for LUN and interval textbox is
optional to be input. If no value is input for LUN textbox, then performance of all the LUNs on the
corresponding storage array mapped to the server will be queried. If no value is input for Interval textbox,
then the IO performance statistics will be refreshed once a second by default.

3.2.10 Querying Version Information


In this section, way of querying version information is introduced. And parameters on the version
information are explained.
Click Version tab on the interface of the UltraPath for Windows Manager.
For Windows 2003 or Windows 2008, the interface is displayed as shown in Figure 3-13. You
can query version on the interface.

Figure 3-13 Version interface

NOTE

The version may be different from the description in the manual as the UltraPath for Windows is subject
to update from time to time. The actual version prevails.

Table 3-14 describes the parameters on the interface.

3-20 Huawei Proprietary and Confidential Issue 01 (2011-05-09)


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
User Guide 3 Instructions on UltraPath for Windows Manager

Table 3-14 Parameters on the version interface


Name Description

UltraPath for Windows Version Version of UltraPath for Windows.

DSM Version Version of the Device Specific Module (DSM).

MPIO Version Version of the Multi-path Input/Output


(MPIO).

3.2.11 Supplementary Functions


This section describes the supplementary functions of the UltraPath for Windows Manager.
There are the following buttons on the interface of the UltraPath for Windows Manager:
, English, help, and Close, as shown in Figure 3-14.

Figure 3-14 UltraPath for Windows Manager interface

The buttons of the supplementary functions are described in Table 3-15.

Issue 01 (2011-05-09) Huawei Proprietary and Confidential 3-21


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
3 Instructions on UltraPath for Windows Manager User Guide

Table 3-15 Description for the buttons of the supplementary functions

Name Description

Switch the interface language of the


UltraPath for Windows Manager to
Chinese.

English Switch the interface language of the


UltraPath for Windows Manager to
English.

Help Open the UltraPath for Windows help


documentation.

Close Close the interface of the UltraPath for


Windows Manager.

3.3 Common Commands


This chapter describes the common commands for the UltraPath for Windows.

3.3.1 Enabling the disk performance monitoring


The following describes the command for enabling the disk performance monitoring.
3.3.2 Listing all commands
All of the commands are listed by executing this command.
3.3.3 Displaying commands help document in Html
The help document of all of the commands is displayed in Html by executing this command.
3.3.4 Listing version information of the multipath software
The version information of the multipath software can be queried by executing this command.
3.3.5 Listing disk mapping information
The current disk mapping information can be queried by executing this command.
3.3.6 Listing array information connected to the AS
The array information currently connected to the AS can be queried by executing this command.
3.3.7 Listing information of the controller connected to the AS
The information of the controller currently connected to the AS can be queried by executing this
command.
3.3.8 Listing IO statistics information of the virtual LUN
The IO statistics information of the virtual LUN can be queried by executing this command.
3.3.9 Listing IO performance of the virtual LUN
The IO performance of the virtual LUN can be queried by executing this command.
3.3.10 Listing SCSI address of the physical LUN corresponding to the virtual LUN
The SCSI address of the physical LUN corresponding to the virtual LUN can be queried by
executing this command.
3.3.11 Listing basic information of the virtual LUN

3-22 Huawei Proprietary and Confidential Issue 01 (2011-05-09)


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
User Guide 3 Instructions on UltraPath for Windows Manager

The basic information of the virtual LUN can be queried by executing this command, including
the host LUN ID, number of paths, LUN WWN, and LUN name.
3.3.12 Listing information of physical LUN
The information of the physical LUN can be queried by executing this command, including the
number of the read/write IOs, LUN WWN, virtual disk name, and the ID of the controller
connected to it.
3.3.13 Listing the number of the virtual LUNs
The number of the virtual LUNs in the current AS can be queried by executing this command.
3.3.14 Listing the status of the log switch
The status of the log switch in the current AS can be queried by executing this command.
3.3.15 Listing path verification settings
The information of path verification settings can be queried by executing this command,
including status of the path verification switch, verification interval, and delete time interval.
3.3.16 Listing IO retry settings
The information of the IO retry settings can be queried by executing this command, including
retry interval and retry times.
3.3.17 Listing status of the cluster switch
The status of the cluster switch in the current AS can be queried by executing this command.
3.3.18 Listing IO load balancing policy
The IO load balancing policy in the current AS can be queried by executing this command.
3.3.19 Listing status of the IO load balancing switch
The status of the IO load balancing switch in the current AS can be queried by executing this
command.
3.3.20 Listing status of the Failover switch
The status of the Failover switch in the current AS can be queried by executing this command.
3.3.21 Setting status of the log switch
The status of the log switch in the current AS can be set by executing this command.
3.3.22 Setting function of the path verification
The path verification function in the current AS can be set by executing this command.
3.3.23 Setting IO retry parameters
The IO retry parameters in the current AS can be set by executing this command.
3.3.24 Setting cluster function
The cluster function in the current AS can be set by executing this command.
3.3.25 Setting IO load balancing policy
The IO load balancing policy in the current AS can be set by executing this command.
3.3.26 Setting load balancing switch
The load balancing switch in the current AS can be set by executing this command.

3.3.1 Enabling the disk performance monitoring


The following describes the command for enabling the disk performance monitoring.
On the main interface of the UltraPath for Windows Manager, select the MPIO Disk Map tab,
and then click Refresh. You need to enable the disk performance monitoring to query
information on the partitions of mapped disks successfully. In Windows OS, the disk

Issue 01 (2011-05-09) Huawei Proprietary and Confidential 3-23


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
3 Instructions on UltraPath for Windows Manager User Guide

performance monitoring is enabled by default. If the query fails, enter the following command
in the CLI to enable the disk performance monitoring.

Format
diskperf -y

Parameter Descriptions
None

Usage Guidelines
None

Output Descriptions
After the command is performed successfully, click Refresh again in the MPIO Disk Map tab
on the main interface of the UltraPath for Windows Manager. The correct information on the
partitions of mapped disks is displayed.

3.3.2 Listing all commands


All of the commands are listed by executing this command.

Format
upadm.exe help

Parameter Descriptions
None

Usage Guidelines
None

Output Descriptions
After the command is executed successfully, similar information to the following is displayed.
upadm.exe help : Get help about commands meanings
upadm.exe helpHtml : Get help about commands meanings by html document
upadm.exe version : Query Version of UltraPath for Windows

upadm.exe show diskMap : Query Disk Map Information


upadm.exe show array : Query Information of Array
upadm.exe show arrayCtrl : Query Physical Disks Information via controller of
Array
upadm.exe show lunIo : Query all LUNs IO Count Information
upadm.exe show lunIoPerf : Query one LUN's IO Performance Information
upadm.exe show lunScsi : Query Virtual Disk Details Information
upadm.exe show lunBasic : Query Virtual Disks List Information
upadm.exe show lunPath : Query Lun Information via SCSI Address
upadm.exe show lunNum : Query Disk Number Information

3-24 Huawei Proprietary and Confidential Issue 01 (2011-05-09)


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
User Guide 3 Instructions on UltraPath for Windows Manager

upadm.exe show config : Query Configuration Information of UltraPath for


Windows
upadm.exe set config : Set Configuration Information of UltraPath for
Windows

3.3.3 Displaying commands help document in Html


The help document of all of the commands is displayed in Html by executing this command.

Format
upadm.exe helpHtml

Parameter Descriptions
None

Usage Guidelines
None

Output Descriptions
After the command is executed successfully, the help document of all of the commands are
displayed in Html.

3.3.4 Listing version information of the multipath software


The version information of the multipath software can be queried by executing this command.

Format
upadm.exe version

Parameter Descriptions
None

Usage Guidelines
None

Output Descriptions
After the command is executed successfully, similar information to the following is displayed.
UltraPath for Windows Version : 01.01.19T01
DSM Version : 1.0.1.B
MPIO Version : 1.21.3790.2191

3.3.5 Listing disk mapping information


The current disk mapping information can be queried by executing this command.

Issue 01 (2011-05-09) Huawei Proprietary and Confidential 3-25


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
3 Instructions on UltraPath for Windows Manager User Guide

Format
upadm.exe show diskMap

Parameter Descriptions
None

Usage Guidelines
None

Output Descriptions
After the command is executed successfully, similar information to the following is displayed.
Virtual Disk Name : MPIO Disk17
Disk:2 -- partition: "H:"

3.3.6 Listing array information connected to the AS


The array information currently connected to the AS can be queried by executing this command.

Format
upadm.exe show array

Parameter Descriptions
None

Usage Guidelines
The information can be queried including array WWN, array name, and AVT settings.

Output Descriptions
After the command is executed successfully, similar information to the following is displayed.
Array WWN : 210000e0fccecc48
Array Name : HUAWEI S5300
AVT Enabled : FALSE

3.3.7 Listing information of the controller connected to the AS


The information of the controller currently connected to the AS can be queried by executing this
command.

Format
upadm.exe show arrayCtrl

3-26 Huawei Proprietary and Confidential Issue 01 (2011-05-09)


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
User Guide 3 Instructions on UltraPath for Windows Manager

Parameter Descriptions
Array WWN and Controller ID are required to be input sequentially after executing this
command. The two parameters are explained in Table 3-16.

Table 3-16 Parameters to be specified during querying information of the controller connected
to the server
Parameter name Parameter description

Array WWN Array WWN. Each array has a unique WWN,


which can be queried by executing the
upadm.exe show array command.

Controller ID Number of the controller. The value is A/a or


B/b when the device connected to the AS is a
storage array or two-node cluster VIS. The
value ranges from 0 to 31 (including 0 and 31)
when the device connected to the AS is a
sixteen-node cluster VIS.

Usage Guidelines
None

Output Descriptions
Taking array WWN is 210000e0fccecc48 and controller ID is A as an example, after the
command is executed successfully, similar information to the following is displayed.
please input Array WWN: 210000e0fccecc48
please input the Controller ID(A/a or B/b)/(0 ~ 31 for VIS): A
Physical Disk 0 : Port Number = 4 SCSI Path ID = 0 Target ID = 6 LUN = 0

3.3.8 Listing IO statistics information of the virtual LUN


The IO statistics information of the virtual LUN can be queried by executing this command.

Format
upadm.exe show lunIo

Parameter Descriptions
None

Usage Guidelines
None

Output Descriptions
After the command is executed successfully, similar information to the following is displayed.

Issue 01 (2011-05-09) Huawei Proprietary and Confidential 3-27


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
3 Instructions on UltraPath for Windows Manager User Guide

Host Preferred Working


LUN ID Contrller Controller Path0 Path1 Path2 Path3 Path4
0 B B 0 5 0 4 0
1 B B 0 58 0 58 0

3.3.9 Listing IO performance of the virtual LUN


The IO performance of the virtual LUN can be queried by executing this command.

Format
upadm.exe show lunIoPerf

Parameter Descriptions
Array WWN, LUN ID, and data refresh interval are required to be input sequentially after
executing this command. These parameters are explained in Table 3-17.

Table 3-17 Parameters to be specified during querying IO performance of the virtual LUN

Parameter name Parameter description

Array WWN Array WWN. Each array has a unique WWN,


which can be queried by executing the
upadm.exe show array command.

LUN ID Device LUN ID, which can be queried by


executing the upadm.exe show lunPath
command, ranges from 0 to 255.

data refresh interval Refresh interval for the statistics, ranges from
1 to 60, and the unit is second.

Usage Guidelines
None

Output Descriptions
Taking array WWN is 210000e0fccecc48, LUN ID is 0, and data refresh interval is 1 second as
an example, after the command is executed successfully, similar information to the following is
displayed.

please input Array WWN: 210000e0fccecc48


please input the LUN ID(0 ~ 255): 0
please input the data refresh interval(1 ~ 60): 1
LUN 0: Total(IOPS | Blk/s) Read(IOPS | Blk/s) Write(IOPS | Blk/s)
real_time: 949 | 485888 462 | 236544 487 | 249344
avg: 474 | 242944 231 | 118272 243 | 124672
controllA
path0: 0 | 0 0 | 0 0 | 0
controllB
path0: 475 | 243200 218 | 111616 257 | 131584

3-28 Huawei Proprietary and Confidential Issue 01 (2011-05-09)


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
User Guide 3 Instructions on UltraPath for Windows Manager

3.3.10 Listing SCSI address of the physical LUN corresponding to


the virtual LUN
The SCSI address of the physical LUN corresponding to the virtual LUN can be queried by
executing this command.

Format
upadm.exe show lunScsi

Parameter Descriptions
The host LUN ID is required to be input after executing this command, which can be queried
by executing the upadm.exe show lunBasic command.

Usage Guidelines
None

Output Descriptions
Taking querying the SCSI address of the physical LUN corresponding to the virtual LUN with
host LUN ID of 0 as an example, after the command is executed successfully, similar information
to the following is displayed.
Please input the Host LUN ID (0~1) you want to query:
0
Virtual Disk Sequence Number : 0
Number of Paths : 4
Number of Failover Groups : 4
Number of MutilPath Groups : 2
Path Details
Using Path : N
Preferred Path : N
Port Number : 4
SCSI Path ID : 0
Target ID : 6
LUN : 0

3.3.11 Listing basic information of the virtual LUN


The basic information of the virtual LUN can be queried by executing this command, including
the host LUN ID, number of paths, LUN WWN, and LUN name.

Format
upadm.exe show lunScsi

Parameter Descriptions
None

Usage Guidelines
None

Issue 01 (2011-05-09) Huawei Proprietary and Confidential 3-29


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
3 Instructions on UltraPath for Windows Manager User Guide

Output Descriptions
After the command is executed successfully, similar information to the following is displayed.
Virtual Disk Sequence Number : 0
Virtual Disk Name : MPIO Disk16
Number of Paths : 4
LUN WWN : 600E0FC100CECC48009E056F00000019
LUN Name : LUN_test

3.3.12 Listing information of physical LUN


The information of the physical LUN can be queried by executing this command, including the
number of the read/write IOs, LUN WWN, virtual disk name, and the ID of the controller
connected to it.

Format
upadm.exe show lunScsi

Parameter Descriptions
Port Number, SCSI Path ID, Target ID, and LUN ID of the virtual LUN is required to be specified
with hyphen between each other. These parameters are explained in Table 3-2.

Usage Guidelines
None

Output Descriptions
Taking querying the physical LUN whose Port Number is 4, SCSI Path ID is 0, Target ID is 6,
and LUN ID is 0 as an example, after the command is executed successfully, similar information
to the following is displayed.
please input LUN's SCSI Adrress with '-' for quering:
4-0-6-0
NumberRead : 0
NumberWrite : 0
Using Path : N
Preferred Path : N
MPIO LUN WWN : 60EFC10CECC4809E56F00019
Virtual Disk Name :MPIO Disk16
Connected Controller ID : A

Port Number : 4
SCSI Path ID : 0
Target ID : 6
LUN : 0

3.3.13 Listing the number of the virtual LUNs


The number of the virtual LUNs in the current AS can be queried by executing this command.

Format
upadm.exe show lunNum

3-30 Huawei Proprietary and Confidential Issue 01 (2011-05-09)


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
User Guide 3 Instructions on UltraPath for Windows Manager

Parameter Descriptions
None

Usage Guidelines
None

Output Descriptions
After the command is executed successfully, similar information to the following is displayed.
Number of Virtual Disks : 2
Number of Physical Disks : 8
Max. Number of LUNs : 256
Max. Number of Paths : 128

3.3.14 Listing the status of the log switch


The status of the log switch in the current AS can be queried by executing this command.

Format
Choose gtlg_st in the configuration type list after executing the upadm.exe show config
command.

Parameter Descriptions
None

Usage Guidelines
None

Output Descriptions
After the command is executed successfully, similar information to the following is displayed.
Log State: enable

3.3.15 Listing path verification settings


The information of path verification settings can be queried by executing this command,
including status of the path verification switch, verification interval, and delete time interval.

Format
Choose gtpthvf_st in the configuration type list after executing the upadm.exe show config
command.

Parameter Descriptions
None

Issue 01 (2011-05-09) Huawei Proprietary and Confidential 3-31


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
3 Instructions on UltraPath for Windows Manager User Guide

Usage Guidelines
None

Output Descriptions
after the command is executed successfully, similar information to the following is displayed.
PathVerify State: Enable
PathVerificationPeriod: 30
PDORemovePeriod: 20

3.3.16 Listing IO retry settings


The information of the IO retry settings can be queried by executing this command, including
retry interval and retry times.

Format
Choose gtrty_st in the configuration type list after executing the upadm.exe show config
command.

Parameter Descriptions
None

Usage Guidelines
None

Output Descriptions
After the command is executed successfully, similar information to the following is displayed.
RetryInterval: 5
RetryCount: 15

3.3.17 Listing status of the cluster switch


The status of the cluster switch in the current AS can be queried by executing this command.

Format
Choose gtcls_st in the configuration type list after executing the upadm.exe show config
command.

Parameter Descriptions
None

Usage Guidelines
None

3-32 Huawei Proprietary and Confidential Issue 01 (2011-05-09)


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
User Guide 3 Instructions on UltraPath for Windows Manager

Output Descriptions
After the command is executed successfully, similar information to the following is displayed.
Cluster State: Disable

3.3.18 Listing IO load balancing policy


The IO load balancing policy in the current AS can be queried by executing this command.

Format
Choose gtlb_st in the configuration type list after executing the upadm.exe show config
command.

Parameter Descriptions
None

Usage Guidelines
None

Output Descriptions
After the command is executed successfully, similar information to the following is displayed.
LoadBalance Type: ROUND_ROBIN

3.3.19 Listing status of the IO load balancing switch


The status of the IO load balancing switch in the current AS can be queried by executing this
command.

Format
Choose gtlb_sw in the configuration type list after executing the upadm.exe show config
command.

Parameter Descriptions
None

Usage Guidelines
None

Output Descriptions
After the command is executed successfully, similar information to the following is displayed.
LoadBalance Switch: disable

Issue 01 (2011-05-09) Huawei Proprietary and Confidential 3-33


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
3 Instructions on UltraPath for Windows Manager User Guide

3.3.20 Listing status of the Failover switch


The status of the Failover switch in the current AS can be queried by executing this command.

Format
Choose gtfo_sw in the configuration type list after executing the upadm.exe show config
command.

Parameter Descriptions
None

Usage Guidelines
None

Output Descriptions
After the command is executed successfully, similar information to the following is displayed.
FailOver Switch: enable

3.3.21 Setting status of the log switch


The status of the log switch in the current AS can be set by executing this command.

Format
Choose stlg_0 or stlg_1 in the configuration type list after executing the upadm.exe set config
command.

Parameter Descriptions
None

Usage Guidelines
Input stlg_0 to disable the log function, or input stlg_1 to enable the log function.

Output Descriptions
Taking disabling the log function, that is executing stlg_0 as an example. After the command is
executed successfully, similar information to the following is displayed.
Set Log disable Succeed

3.3.22 Setting function of the path verification


The path verification function in the current AS can be set by executing this command.

3-34 Huawei Proprietary and Confidential Issue 01 (2011-05-09)


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
User Guide 3 Instructions on UltraPath for Windows Manager

Format
Choose stpthvf_0 or stpthvf_1 in the configuration type list after executing the upadm.exe set
config command.

Parameter Descriptions
None

Usage Guidelines
Input stpthvf_0 to disable the path verification function, or input stpthvf_1 to enable the path
verification function.

Output Descriptions
Taking disabling the path verification function, that is executing stpthvf_0 as an example. After
the command is executed successfully, similar information to the following is displayed.
Set PathVerify disable Succeed

3.3.23 Setting IO retry parameters


The IO retry parameters in the current AS can be set by executing this command.

Format
Choose strty in the configuration type list after executing the upadm.exe set config command.

Parameter Descriptions
None

Usage Guidelines
None

Output Descriptions
Taking setting the IO retry interval as 5 seconds, retry times as 15 as an example. After the
command is executed successfully, similar information to the following is displayed.
Please input Retry Interval time(0~10)(s), 5 is recommended
5
please input Retry counts(0~20)(times), 15 is recommended
15
Set retry time Succeed

3.3.24 Setting cluster function


The cluster function in the current AS can be set by executing this command.

Issue 01 (2011-05-09) Huawei Proprietary and Confidential 3-35


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
3 Instructions on UltraPath for Windows Manager User Guide

Format
Choose stcls_0 or stcls_1 in the configuration type list after executing the upadm.exe set
config command.

Parameter Descriptions
None

Usage Guidelines
Input stcls_0 to disable the cluster function, or input stcls_1 to enable the cluster function.

Output Descriptions
Taking disabling the cluster function, that is executing stcls_0 as an example. After the command
is executed successfully, similar information to the following is displayed.
Set Cluster State disabled successful,but need reboot the computer.

3.3.25 Setting IO load balancing policy


The IO load balancing policy in the current AS can be set by executing this command.

Format
Choose stlb in the configuration type list after executing the upadm.exe set config command.

Parameter Descriptions
None

Usage Guidelines
None

Output Descriptions
Taking setting the IO load balancing policy as ROUND_ROBIN as an example. After the
command is executed successfully, similar information to the following is displayed.
stlb
Please Input LoadBalance Type you want to Set:
Input 0 stands for ROUND_ROBIN
Input 1 stands for LEAST_QUEUE_DEPTH
Input 2 stands for LEAST_TASK
0
Set LoadBalance Type Succeed

3.3.26 Setting load balancing switch


The load balancing switch in the current AS can be set by executing this command.

3-36 Huawei Proprietary and Confidential Issue 01 (2011-05-09)


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
User Guide 3 Instructions on UltraPath for Windows Manager

Format
Choose stlb_0 or stlb_1 in the configuration type list after executing the upadm.exe set config
command.

Parameter Descriptions
None

Usage Guidelines
Input stlb_0 to disable the load balancing function, or input stlb_1 to enable the load balancing
function.

Output Descriptions
Taking disabling the load balancing function, that is executing stlb_0 as an example. After the
command is executed successfully, similar information to the following is displayed.
Disable LBController successful.

Issue 01 (2011-05-09) Huawei Proprietary and Confidential 3-37


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
User Guide A How to Obtain Help

A How to Obtain Help

If a problem persists in routine maintenance or troubleshooting, contact Huawei Symantec for


technical support.

A.1 Preparations For Contacting Huawei Symantec


To better solve the problem, you need to collect troubleshooting information and make
debugging preparations before contacting Huawei Symantec.
A.2 How to Use the Document
Huawei Symantec provides guide documents shipped with the device. The guide documents can
be used to handle the common problems occurring in daily maintenance or troubleshooting.
A.3 How to Obtain Help from Website
Huawei Symantec provides users with timely and efficient technical support through the regional
offices, secondary technical support system, telephone technical support, remote technical
support, and onsite technical support.
A.4 Ways to Contact Huawei Symantec
Huawei Symantec Technologies Co., Ltd. provides customers with comprehensive technical
support and service. For any assistance, contact our local office or company headquarters.

Issue 01 (2011-05-09) Huawei Proprietary and Confidential A-1


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
A How to Obtain Help User Guide

A.1 Preparations For Contacting Huawei Symantec


To better solve the problem, you need to collect troubleshooting information and make
debugging preparations before contacting Huawei Symantec.

A.1.1 Collecting Troubleshooting Information


You need to collect troubleshooting information before troubleshoot.
A.1.2 Making Debugging Preparations
When you contact Huawei Symantec for help, the technical support engineer of Huawei
Symantec might assist you to do certain operations to collect information about the fault or
rectify the fault directly.

A.1.1 Collecting Troubleshooting Information


You need to collect troubleshooting information before troubleshoot.
You need to collect the following information:
l Name and address of the customer
l Contact person and telephone number
l Time when the fault occurred
l Description of the fault phenomena
l Device type and software version
l Measures taken after the fault occurs and the related results
l Troubleshooting level and required solution deadline

A.1.2 Making Debugging Preparations


When you contact Huawei Symantec for help, the technical support engineer of Huawei
Symantec might assist you to do certain operations to collect information about the fault or
rectify the fault directly.
Before contacting Huawei Symantec for help, you need to prepare the boards, port modules,
screwdrivers, screws, cables for serial ports, network cables, and other required materials.

A.2 How to Use the Document


Huawei Symantec provides guide documents shipped with the device. The guide documents can
be used to handle the common problems occurring in daily maintenance or troubleshooting.
To better solve the problems, use the documents before you contact Huawei Symantec for
technical support.

A-2 Huawei Proprietary and Confidential Issue 01 (2011-05-09)


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
User Guide A How to Obtain Help

A.3 How to Obtain Help from Website


Huawei Symantec provides users with timely and efficient technical support through the regional
offices, secondary technical support system, telephone technical support, remote technical
support, and onsite technical support.
Contents of the Huawei Symantec technical support system are as follows:
l Huawei Symantec headquarters technical support department
l Regional office technical support center
l Customer service center
l Technical support website: http://support.huawei.comhttp://www.huaweisymantec.com

You can query how to contact the regional offices at http://support.huawei.comhttp://


www.huaweisymantec.com.

A.4 Ways to Contact Huawei Symantec


Huawei Symantec Technologies Co., Ltd. provides customers with comprehensive technical
support and service. For any assistance, contact our local office or company headquarters.
Huawei Symantec Technologies Co., Ltd.
Address: Huawei Industrial Base Bantian, Longgang Shenzhen 518129 People’s Republic of
ChinaBuilding 1B,The West Zone Scinece Park of UESTC,No.88,Tianchen Road,Chengdu,
611731 P.R.China
Website: http://www.huawei.comhttp://support.huaweisymantec.com
Telephone number: 86-755-28780808
Customer Service Center
Huawei Symantec phone:0086-755-28560000; 40083021184008882333
Huawei Symantec Service fax: 0086-755-285601110086-28-87897555
Service E-mail: [email protected]@huaweisymantec.com

Issue 01 (2011-05-09) Huawei Proprietary and Confidential A-3


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
User Guide B Initializing Disks

B Initializing Disks

Take Windows 2003 as an example, the procedure for initializing disks is introduced. After the
UltraPath for Windows is installed and OS is restarted, you can map the storage resources on
the storage system to the AS and initialize the mapped disks on the AS.

Procedure
Step 1 Log in to the AS as a user of the administrator group.
Step 2 Right-click My Computer and select Management in the shortcut menu. The Computer
Management interface is displayed.
Step 3 In the navigation tree, choose Storage > Disk Management, right-click Disk Management and
choose Rescan Disk in the shortcut menu. Once the scanning is finished, you can see the drive
letters of logical disks on the right, as shown in Figure B-1.

Figure B-1 Viewing logical disks

Issue 01 (2011-05-09) Huawei Proprietary and Confidential B-1


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
B Initializing Disks User Guide

Step 4 Initialize a logical disk. Right-click Disk 1 that is not initialized to show the menu, as shown in
Figure B-2.

Figure B-2 Initialize Disk menu

NOTE

l For Disk 1 described in Step 4, the 1 indicates the number of the disk, which may be different depending
on the actual circumstances. Here takes Disk 1 as an example.
l For Windows Server 2008, you need to right-click on the disk, then choose Online in the shortcut menu
before initializing the disk.

Step 5 Click Initialize Disk to enter Initialize Disk interface, as shown in Figure B-3.

Figure B-3 Initialize Disk interface

Step 6 Select the check box before Disk 1 by checking, and click OK to finish the disk initialization,
as shown in Figure B-4.

B-2 Huawei Proprietary and Confidential Issue 01 (2011-05-09)


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
User Guide B Initializing Disks

Figure B-4 Initialize Disks complete

To initialize other logical disks, repeat Step 4 to Step 6.

----End

Issue 01 (2011-05-09) Huawei Proprietary and Confidential B-3


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
User Guide C Failing to Open the UltraPath Software

C Failing to Open the UltraPath Software

The UltraPath software fails to be opened by double-clicking its desktop icon.

Symptom
The UltraPath software fails to be opened by double-clicking its desktop icon.

Cause
l The Windows Management Instrumentation (WMI) service is paused or disabled, resulting
in that the UltraPath program cannot connect to the WMI namespace.
l The host system encounters an error (such as a system file or program file loading failure),
causing that during the UltraPath software startup, the thread to query the WMI information
is lagged behind.
l WMI storage repository is damaged, causing that the WMI information fails to be queried
and the window object handle fails to be obtained.

Procedure
l If the WMI service has been paused or disabled, restart it as shown in Figure C-1.

Figure C-1 Restarting the WMI service

Issue 01 (2011-05-09) Huawei Proprietary and Confidential C-1


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
C Failing to Open the UltraPath Software User Guide

l If the host system is partially faulty. stop the WMI service, and then change the WMI
properties to Disabled. Wait for 30 seconds, and then change the properties to
Automatic. Double-click the desktop icon, as shown in Figure C-2.

Figure C-2 Changing the WMI properties

l If the WMI storage repository is damaged, stop the WMI service, go to the C:\WINDOWS
\system32\wbem directory, and rename the Repository file folder (to Rep_back for
example). Double-click its desktop icon, as shown in Figure C-3.

Figure C-3 Renaming the repository file folder

l If the fault persists after the previous three methods have been performed, stop the WMI
service, and change the WMI properties to Disabled. Go to the C:\WINDOWS\system32
\wbem directory, and rename the Repository file folder (to Rep_back for example).
Restart the host, the system automatically reconstructs the storage repository. After the

C-2 Huawei Proprietary and Confidential Issue 01 (2011-05-09)


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
User Guide C Failing to Open the UltraPath Software

resconstruction succeeds and the host restarts, change the WMI properties to Automatic.
Double-click the desktop icon of the UltraPath software.

Issue 01 (2011-05-09) Huawei Proprietary and Confidential C-3


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
User Guide D Glossary

D Glossary

A
Active network The service port that is working currently on the AS.
port
Active/Active The I/O operation can be performed on either of the two controllers.
Mode
Alarm buzzer A component of the controller subrack. When a critical fault occurs in
the OceanStor storage system, the alarm buzzer can generate some buzz.
Application The computer system that is connected to the storage system, stores
server data, and implements I/O access.
Application The LUN that is mapped from storage devices to the application server.
server LUN
Array LUN To differentiate the number between the device LUN and the host LUN.

B
Back-end disk The port for the connection between the controller subrack and the disk
port subrack.
Baud rate The maximum rate of signal state changes per second on a
communications circuit. In low-speed communications, each signal
state corresponds to a code bit, then the baud rate and the bit rate are the
same, that is, the reciprocal of code bits in one second.
Bit error rate The percentage of bits that have errors relative to the total number of
bits received in a transmission.
Boundary scan A test methodology that uses shift registers in the output connections of
integrated circuits. One IC often is connected to the next. A data pattern
is passed through the chain and the observed returned data stream
affected by the circuit conditions gives an indication of any faults
present. The system is defined under IEEE standard 1149.1 and is also
often known as JTAG (Joint Test Action Group).

Issue 01 (2011-05-09) Huawei Proprietary and Confidential D-1


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
D Glossary User Guide

Browser / Server An architecture that defines the roles of browser and server, where the
browser is the service request party and the server is the service provider.

C
Cache A special area of memory, managed by a cache controller, which
improves performance by storing the contents of frequently accessed
memory locations and their addresses.
Cache hit ratio The ratio of directly accessed I/O from Cache to all the I/O operation
during the read operation.
Cache prefetch According to the operation in which data has been read or is being read,
strategy the required data is read from a disk into the cache in advance.
CALL HOME The function that devices send the detected critical events, such as faults,
to maintenance engineers through an E-mail or a short message.
Captive screw After the screw is loosened, screw caps and bolts do not fall off the main
body.
Cascade Connect the OceanStor storage system to more disk subracks through
connection cables, thus expanding the capacity of the OceanStor storage
system.
CHAP Challenge handshake authentication protocol. An authentication
protocol based on the password. This protocol checks that a user has the
right to access a system by using a challenge.
Coffer The hard disks in slots 0 to 3 server as coffers that store the system
configuration data, the alarm log data, and the cache data not written to
the hard disks when the system is powered off for emergency.
Coffer disk Physical storage media. It refers to the hard disks in slots 0 to 3 of the
controller subrack.
Command device Command device for OceanStor Command Line Interface.
Consistency check LUN consistency check is an advanced maintenance function of the
controller. Through the consistency check, the controller can check the
consistency of data on arrays in advance, that is, the validity and
integrity of data.
Constant prefetch A cache prefetch strategy. The size of the data to be prefetched is the
size as set. This strategy applies to the applications that require reading
data of a fixed size in a certain order. An example is the streaming media
demanded by multiple subscribers who use the same bit rate.
Controller It is the core component of the OceanStor storage system, and is mainly
subrack responsible for the storage service. A controller subrack consists of the
controller, hard disk, interface card, power entry module (PEM)/fan
module, battery, and dual in-line package (DIP) switch board.
Conversion board A circuit board in the OceanStor storage system for the conversion of
disks ports.

D-2 Huawei Proprietary and Confidential Issue 01 (2011-05-09)


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
User Guide D Glossary

Cookie A technology that allows a Web site server to store a bit of data in the
disk or memory of a client or read data from the disk of a client.
Copyback The process of copying the data from the hot-spare disk back to the
previous disk when the faulty member disk is restored or replaced by a
new one.
Create RAID To organize free disks into a RAID group with a certain RAID level.
group
Cyclic CRC consists of a great number of bits computed as the data to be
redundancy check protected and append to the data.

D
Data disk The disk for saving service data in RAID groups.
Defragment The process of rewriting LUN data on disks, which helps to continue
the unoccupied free space among LUNs.
Degraded RAID When member disk in a RAID group fails, part or all of the redundancy
group is lost.
Delete RAID To delete a RAID group so that member disk in a RAID group becomes
group a free disk.
DIP switch board It is used to adjust the FC cascading rate and FC disk rate, and can mute
the alarm buzzer.
Dirty page The data that is stored in only the cache but not written into disks.
Disk array A set of disks from one or more commonly accessible disk subsystem,
combined with a body of control software. The control software presents
the disks' storage capacity to hosts as one or more virtual disks.
Disk location Locate a hard disk, that is, determine the subrack number and slot
number of the hard disk in the OceanStor storage system.
Disk subrack It consists of the following parts: expander board, hard disk, PEM/fan
module, and DIP switch board. System capacity can be expanded by
cascading multiple disk subracks.
Disk utilization The percentage of used capacity in the total available capacity.
Dynamic LUN During the operations of defragment, expanding the member disk of
RAID group, modifying the stripe unit size and transferring the level of
RAID group dynamically, create a temporary LUN that can help data
transfer.

E
Expand the To add member disk in a RAID group without interrupting the normal
member disk of services of RAID group.
RAID group
dynamically

Issue 01 (2011-05-09) Huawei Proprietary and Confidential D-3


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
D Glossary User Guide

Expander module A component used for expanding.

F
Failed RAID The number of failed member disk in a RAID group exceeds the
group maximum number, which causes data loss.
Failure tolerance The storage system can provide storage resources normally (system
performance may be compromised) when its one or multiple
components fail.
Field replaceable A module or component which will typically be replaced in its entirety
unit (FRU) as part of a field service repair operation. Any entity that can be replaced
by a user in the field. Examples of this type of FRU might include:
backplane (the Shelf housing, for all practical purposes), PEM/fan
module, optical module, and battery module. (Not all FRU supports hot
swapping.)
Firmware The program that is embedded in a programmable non volatile memory.
Fragment The free physical space that has not been divided among different LUNs
on a disk.
Free disk A hard disk which is available in the OceanStor storage system.
Free hot-spare A hot-spare disk that is available.
disk
Front-end host The port on the controller subrack to connect to the application server
port and transmit service data. There are three types of the front-end host
port: SAS, FC and iSCSI.

G
Gateway The entrance node on another network.
Gateway binding A mode of binding an application server and the network entrance node
it is located in.
Global hot-spare A type of hot spare disk. A global spare disk can serve as the spare disk
disk for multiple RAID groups of an array while a local hot spare disk can
only serve as the spare disk for only one RAID group.
GSM modem A wireless modem used to send the information about alarms.

H
Hard disk tray The tray that bears the hard disk.
Heartbeat cable The heartbeat cable is a dedicated line on the backplane. It can check
the running state of the remote controller in real time. Once the running
controller is in the abnormal state, the remote controller can use the
heartbeat cable to check the related state and take proper measures.

D-4 Huawei Proprietary and Confidential Issue 01 (2011-05-09)


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
User Guide D Glossary

High watermarks The high level of the dirty page stored in cache. When the amount of
the dirty page in cache reaches the high level, cache begins to store the
dirty page into disks.
High-low The low level and high level of the dirty page stored in cache. When the
watermarks amount of the dirty page in cache reaches the high level, cache begins
to store the dirty page into disks. When the amount of the dirty page
reaches the low level, cache stops storing the dirty page into disks.
Host The "host" displayed in the OSM3.0 interface is a created virtual host.
After a port is added to the host, the host can correspond to a physical
application server.
Host port module A module that bears the various types of host ports, for example, SAS
host port, FC host port, and iSCSI host port.
Hot backup/ A form of backup in which the data being backed up may be accessed
Online backup by applications during the backup.
Hot swap In a running system, inserting or removing a blade does not affect
normal running of the system.
Hot-spare disk The disk that is used to replace the damaged member disk in a RAID
group. A spare disk carries the data that is saved on faulty disks.
Hot-spare disk A function of the OceanStor storage system. It refers to the process of
reconstruction restoring the data from the faulty member disk in a RAID group to the
spare disk.
HyperClone Data can be synchronized from the master LUN to the slave LUN
forward or be synchronized from the slave LUN to the master LUN
backward. After the synchronization data is split. A full point-in-time
copy of a LUN is physically created.
HyperClone The clone group includes one master LUN and at most eight slave
group LUNs.
HyperClone The LUN that is accessed and applied.
master LUN
HyperClone pair A master LUN and a slave LUN compose a hyper clone pair.
HyperClone slave The LUN that varies with the master LUN under normal conditions. It
LUN ensures the backup of the master LUN.
HyperMirror HyperMirror, also called remote replication, is the core technology of
disaster-tolerant backup and the basis for hyper data synchronization
and disaster recovery. Depending on the function of remote data
connecting provided by physically separated storage devices, hyper
mirror maintains another mirror remotely. If any disaster occurs, data
backup distributed in other places will not be affected. According to the
fact that whether the requesting-mirror host needs the confirmation of
hyper mirror spot, hyper mirror is classified into synchronous hyper
mirror and asynchronous hyper mirror.
HyperMirror The LUN that is accessed and applied.
master LUN

Issue 01 (2011-05-09) Huawei Proprietary and Confidential D-5


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
D Glossary User Guide

HyperMirror The LUN that varies with the master LUN of hyper mirror under normal
slave LUN conditions. It ensures the backup of the master LUN of hyper mirror.

I
I/O Data movement process between memory and peripheral devices in the
computer system. I/O is a collective name, indicating the operations
reading data into the memory and writing data to other places from
computer memory.
Inband A method of transmission between the management control information
management on the network and the bearer service information on the user network
through the same logical channel. Inband management enables users to
manage disk arrays through commands. Management commands are
sent through the service channel, that is, the I/O read-and-write channel.
The advantage is quick and stable transmission, which requires no other
management network port.
Inconsistent The protection of the check data block in a redundancy group stripe for
stripe the protected space in the stripe is invalid.
Initialize The process of writing 0 bits in the data area on the logical drive and
generating related parity bits so that the logical drive can be in the ready
state.
initiator A system component that can initiate an I/O operation on an I/O bus or
on a network.
Intelligent A cache prefetch strategy. The system software calculates a proper size
prefetch of prefetched data. This strategy applies to a read application involving
a single bit stream or to the situations where you do not know whether
the data is read in a certain order. An example is reading or writing a
file.
iSCSI host port A port which is on the controller subrack connects to the AS. The port
transmits service data (used in the network and bearing the SCSI
protocol in the IP packet).

L
Link A physical connection between two nodes of a network.
Load balance A method of adjusting the system, application components and data to
averagely distribute the applied I/O or computing requests for physical
resources of the system.
Logical unit The entity is located inside the SCSI object, and can execute I/O
commands. After a SCSI I/O command is sent to an object, the logic
unit inside the object executes this command. Usually, each SCSI
physical disk has one logic unit. A tape drive and array controller may
have multiple logic units, which process different I/O commands. Each
logic unit inside an array controller corresponds to a virtual disk.

D-6 Huawei Proprietary and Confidential Issue 01 (2011-05-09)


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
User Guide D Glossary

Logical unit The SCSI identifier of the internal logical unit of a target.
number
Loose coupling A system based on messages in which the client and the remote services
do not know how the peer side is realized. The communication between
the client and the services is based on message architecture. As long as
the messages comply with the negotiated architecture, the realization of
the client or services can be changed as required without damaging the
peer side.
Low watermarks The low level of the dirty page stored in the cache. When the amount
of the dirty page in the cache reaches the low level, cache stops storing
the data in cache into disks.
LUN format The process of preparation for enabling LUNs. During the process,
necessary information is written to member disks where LUNs are
located.
LUN mapping The OceanStor storage system maps LUNs to ASs so that the ASs can
access the storage reorganization.

M
Maintenance The computer that is connected through a serial port or management
terminal network port and maintains the OceanStor storage system.
Management An entity that provides a means to transmit and process the information
network related to network management.
Management The network port on the controller subrack that is connected to the
network port maintenance terminal. It is provided for the remote maintenance
terminal.
Medium scanning A background program that is run by controllers and provides the
function of detecting disk errors. The medium scanning program detects
and reports errors to the event log module.
Member disk A disk in a redundant array of inexpensive disks (RAID) group in the
OceanStor storage system.
Member disk A function of the OceanStor storage system. It refers to the process of
reconstruction restoring the data from the faulty disk to the new disk after you replace
a faulty member disk in a RAID group with a new one.
Mirroring A form of storage array in which two or more identical copies of data
are maintained on separate media. This prevents data loss due to disk
errors.
Mirroring group In a group of RAID at the RAID 10 level, the member disks that are
mirrors of each other are known as a mirroring group.
Modify the stripe To modify the stripe unit size without interrupting the normal services
unit size of LUN.
dynamically

Issue 01 (2011-05-09) Huawei Proprietary and Confidential D-7


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
D Glossary User Guide

N
Native devices The application server LUN viewed through the device management
software on the application server. The application server can access
the same array LUN through multiple physical paths. Therefore, for the
same array LUN, the number of the application server that is displayed
as the local device is consistent with the number of physical paths.

O
OceanStor A trademark of Huawei storage device.
Online LUN A process of expanding LUN capacity online without interrupting
expansion services.
Outband A management mode used during outband networking. In the outband
management management mode, the management and control information of the
network and the bearer service information of the user network are
transmitted through different logical channels.
Overload The measure of installing addition protection devices in case that the
protection overloaded main power lines cause damage to the protector as result of
overheat.
Owning For a LUN, the user configures the owing controller, that is, specified
controller the created LUN to a certain controller. When the owning controller of
the LUN is invalid, another controller manages the LUN automatically.
When the owning controller of the LUN is restored, the original
controller manages the LUN again.

P
Parity disk The disk for saving check data in RAID groups.
PEM/fan module The PEM/fan module consists of power supply, fans, power switches,
and power sockets.
Physical path The actual path from the HBA card of the application server to the front-
end host port of storage arrays. Regardless of switches on the path, the
physical path is only decided by the corresponding relation between the
host HBA card and the array port.
Port module Port module connects various types of front-end host port, such as the
front-end host ports of SAS, FC and iSCSI.
Power failure When the external power failure occurs, the alternating circuit (AC)
protection power entry module in the OceanStor storage system can use the battery
to supply power. This ensures that dirty page in cache can be written
into the coffer safely and avoids data inconsistency caused by data lost.
Primary Storage The controller which plays a leading role in controlling the management
Controller is primary storage controller. It can perform relevant management
operations on the controller subrack.

D-8 Huawei Proprietary and Confidential Issue 01 (2011-05-09)


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
User Guide D Glossary

Primary/ A procedure during which the two controllers of the OceanStor storage
Secondary system change their master/slave states.
switchover
Prior controller For the application server LUN, prior controller means that the working
controller is the owner controller of the corresponding array LUN.

R
RAID level The application of different redundant types in the logical drive. The
RAID level can improve the fault tolerance and performance and reduce
the available capacity of the logical drive. You must specify a RAID
level for each logical drive.
Reconstruct To restore the data in a member disk, when the member disk in a RAID
group is faulty.
Reconstruct hot- To restore the data from the faulty member disk in a RAID group to the
spare disk spare disk.
Reconstruct To restore the data from the faulty disk to the new disk after you replace
member disk a faulty member disk in a RAID group with a new one.
Reconstruction A function of the OceanStor storage system. It refers to the process of
restoring the data saved in the faulty member disk in a RAID group.
Redhat package Redhat package manager widely applied in Linux.
manager
Redundancy The inclusion of extra components of a given type in a system (beyond
those required by the system to carry out its function) for the purpose
of enabling continued operation in the event of a component failure.
Redundant Array A family of techniques for managing multiple disks to deliver desirable
of Independent cost, data availability, and performance characteristics to host
Disks environments.
Redundant copy When the system monitors that a member disk in the RAID groups is
about to fail, the system copies the data in the disk to a hot-spare disk.
This technology is called redundant copy.
Repair To correct the invalid protection of the check data block in a redundancy
inconsistent stripe group stripe for the protected space in the stripe.

S
Script A collection of data statements used to perform an operation.
Secondary In relation to the primary storage controller, the secondary storage
Storage controller is the backup for the primary storage controller. When the
Controller primary storage controller fails, the secondary controller can be replaced
to be the primary storage controller and performs management
operations on the controller subrack.

Issue 01 (2011-05-09) Huawei Proprietary and Confidential D-9


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
D Glossary User Guide

Serial port An input/output location (channel) that sends and receives data to and
from a computer's CPU or a communications device one bit at a time.
Serial ports are used for serial data communication and as interfaces
with some peripheral devices, such as mouse and printers.
Service data Data which is saved in data disk. Service data is the data source for
computing check data in parity disk.
SFP optical A component that can make data conversion between optical signals
module and electrical signals and that can receive and transmit data.
Simple network An internet engineering task force (IETF) protocol used to monitor and
management manage the systems and devices on a network. The monitored and
protocol (SNMP) managed data is defined by the management information base (MIB).
The protocol supports the following functions: data request, data
retrieval, data setting or data writing, and trap.
Single point Since some components or channels are not redundant, the failure of a
failure device or component causes the breakdown of all devices or
components.
Smooth expansion A process of expanding capacity online without interrupting services.
Standby network In relation to the active network port, the standby network port is a
port redundant network port on an AS. When the active network port fails,
the standby network port is activated to work.
Storage controller The component performs the following functions: operation
conversion, RAID, LUN mapping, disk-striping setting, and other
service and fault alarm. It consists of the controller board and port
module.
Storage system An integrated system. It consists of the following parts: controller,
storage array, host bus adaptor, physical connection between storage
devices, and all control software.
Streaming media A transmission mode in which data is consumed (read, listened to, or
watched) while it is being sent.
Stripe The process of dividing the consecutive data into the same-sized data
blocks and writing the data on each block into different disks. This
technology provides a faster read/write speed than a single disk can
provide.
Stripe depth The number of blocks in a strip in a disk array which uses striped data
mapping. Also, the number of consecutively addressed virtual disk
blocks mapped to consecutively addressed blocks on a single member
extent of a disk array.
Stripe unit The physical extent block that consists of stripes in each physical extent
of a redundancy group.
Stripe verify To verify whether the check data block in a redundancy group stripe
protects the protected space in the stripe.

D-10 Huawei Proprietary and Confidential Issue 01 (2011-05-09)


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
User Guide D Glossary

Subnet mask The technology used by the IP protocol to determine where network
segment packets are destined for. The subnet mask is in binary format.
Stored in a client, server, or router. The subnet mask matches the IP
address.
System bus A mechanism of the computer system to achieve connections between
devices. It is characterized by the signal transmission between two
devices on the bus. One device sends commands and data and the other
device receives commands and data. Only one transmission can be
operated on the bus at any time. Transmission requests of each device
are ranked according to their priorities.

T
target A system component that can receive SCSI I/O operation commands.
topology The logical layout where computer systems and network components
are interconnected with one another. The topological structure gives the
interconnection relationship among the components from the viewpoint
of communication, but the topological structure does not specify the
exact locations of components and the interconnection mode.
Transfer the level To transfer the level of RAID group dynamically without interrupting
of RAID group the normal services of RAID group.
dynamically
Trap A type of SNMP message that indicates the occurrence of an event. This
type of message is transmitted to the received through UDP. The
transmission process is not completely reliable.
Trunk It refers to port trunking which aggregates multiple physical ports into
a logical path through setting configuration software. By combining the
bandwidth of multiple ports, the bandwidth between switches and
network nodes are expanded and the ports are provided an wholly
occupied bandwidth with the speed several times higher than an
independent port.

U
Unload slave LUN The process of unloading the last slave LUN from the connected LUNs.
Used hot-spare A hot-spare disk that is in use.
disk
User interface The interface on which users enter commands for operation.

Issue 01 (2011-05-09) Huawei Proprietary and Confidential D-11


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
D Glossary User Guide

Variable prefetch A cache prefetch strategy. The size of the data to be prefetched is the
multiple for prefetching multiplied by the length of a read command.
This strategy applies to the applications that require reading data of
variable size in a certain order or to the situations where multiple
subscribers read data concurrently but no fixed prefetch size can be set,
because the amount of pre-read data cannot be judged. An example is
the streaming media demanded by multiple subscribers who use
different bit rates.

W
Working The controller used by the array LUN to read and write a disk.
controller
Write hole A potential data corruption problem for parity RAID technology
resulting from any array failure while application I/O is outstanding,
followed by an unrelated member disk failure (some time after the array
has been returned to service). Data corruption can occur if member data
and parity become inconsistent due to the array failure, resulting in a
false regenerating when data failed member disk is subsequently
requested by an application.
Write-back cache A cache technology. When the write operation is completed, the data
continues to be stored in the cache and therefore, the operation of writing
the data to disks will be delayed. No need to access disks during each
write operation.
Write-back cache A cache technology. Data is written to the local cache and at the same
mirroring time written to the opposite cache.
Write-through A cache technology. Data is written to disks. And only when the data
cache is safely written to disks, the procedure of write requests can be ended.
Disks need to be accessed during each write operation.

D-12 Huawei Proprietary and Confidential Issue 01 (2011-05-09)


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
User Guide E Acronyms and Abbreviations

E Acronyms and Abbreviations

A
AVT Auto Volume Transfer

D
DSM Device-Specific Modules

F
FC Fiber Channel

H
HBA Host Bus Adapter

I
iSCSI Internet Small Computer Systems Interface

L
LAN Local Area Network
LUN Logical Unit Number

M
MPIO MultiPath Input Output
MSCS Microsoft Cluster Service

Issue 01 (2011-05-09) Huawei Proprietary and Confidential E-1


Copyright © Huawei Technologies Co., Ltd.
OceanStor UltraPath for Windows
E Acronyms and Abbreviations User Guide

N
NIC Network Interface Card

P
PnP Plug and Play

R
RAID Redundant Array of Independent Disks

S
SAS Serial Attached SCSI
SCSI Small Computer System Interface

W
WWN World Wide Number

E-2 Huawei Proprietary and Confidential Issue 01 (2011-05-09)


Copyright © Huawei Technologies Co., Ltd.

You might also like