You are on page 1of 274

OceanStor S2600 Storage System

V100R002

Command Reference

Issue 07
Date 2010-05-20

Huawei Proprietary and Confidential


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


Huawei Technologies Co., Ltd. provides customers with comprehensive technical support and service. For any
assistance, please contact our local office or company headquarters.

Huawei Technologies Co., Ltd.


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

Website: http://www.huawei.com
Email: support@huawei.com

Copyright © Huawei Technologies Co., Ltd. 2010. 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 the property 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 the statements, information, and
recommendations in this document do not constitute a warranty of any kind, express or implied.

Huawei Proprietary and Confidential


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference Contents

Contents

About This Document.....................................................................................................................1


1 Introduction to the CLI.............................................................................................................1-1
1.1 Overview of the CLI.......................................................................................................................................1-2
1.2 Configuring and Managing the Storage System Through the CLI.................................................................1-2
1.2.1 Logging In to the Command Line Interface...........................................................................................1-2
1.2.2 Configuration and Management.............................................................................................................1-7

2 Introduction to the CLI Commands........................................................................................2-1


2.1 Overview of the CLI Commands....................................................................................................................2-2
2.1.1 Mode.......................................................................................................................................................2-2
2.1.2 Level.......................................................................................................................................................2-2
2.1.3 Operation Guide.....................................................................................................................................2-2
2.2 Command Classification.................................................................................................................................2-4
2.2.1 Basic Operation Commands...................................................................................................................2-4
2.2.2 System Management Commands...........................................................................................................2-5
2.2.3 Device Management Commands...........................................................................................................2-6
2.2.4 Service Management Commands...........................................................................................................2-8
2.2.5 Alarm Management Commands.............................................................................................................2-9
2.2.6 User Management Commands...............................................................................................................2-9
2.2.7 Value-Added Service Management Commands..................................................................................2-10

3 Basic Operation Commands.....................................................................................................3-1


3.1 Help Command...............................................................................................................................................3-2
3.1.1 clihelp.....................................................................................................................................................3-2
3.2 System Exit and Logout Commands...............................................................................................................3-3
3.2.1 exit..........................................................................................................................................................3-3
3.2.2 logout......................................................................................................................................................3-4
3.3 Batch Processing Command............................................................................................................................3-4
3.3.1 autobat....................................................................................................................................................3-4
3.4 Commands of Setting the IP Address of the Management Network Interface on the Controller...................3-6
3.4.1 chgctrlip..................................................................................................................................................3-6
3.4.2 showctrlip...............................................................................................................................................3-7
3.5 CLI Idle Time Setting Command....................................................................................................................3-8
3.5.1 chgidletime.............................................................................................................................................3-8

Issue 07 (2010-05-20) Huawei Proprietary and Confidential i


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Contents Command Reference

4 System Management Commands............................................................................................4-1


4.1 System Information Query Commands...........................................................................................................4-3
4.1.1 showsys..................................................................................................................................................4-3
4.1.2 showsysfail.............................................................................................................................................4-4
4.1.3 showtemperature....................................................................................................................................4-4
4.1.4 showvoltage............................................................................................................................................4-5
4.1.5 showsn....................................................................................................................................................4-6
4.1.6 showlicense............................................................................................................................................4-7
4.2 Controller Configuration Commands..............................................................................................................4-8
4.2.1 offline.....................................................................................................................................................4-8
4.2.2 showctrlinfo............................................................................................................................................4-9
4.3 File Management Command.........................................................................................................................4-10
4.3.1 exportalm..............................................................................................................................................4-10
4.4 Configuration Management Commands.......................................................................................................4-11
4.4.1 exportcofferdb......................................................................................................................................4-11
4.4.2 exportblackbox.....................................................................................................................................4-13
4.4.3 exportconf.............................................................................................................................................4-14
4.4.4 importconf............................................................................................................................................4-15
4.4.5 exportstat..............................................................................................................................................4-16
4.5 Statistics Management Commands...............................................................................................................4-17
4.5.1 showstatswitch.....................................................................................................................................4-18
4.5.2 chgstatswitch........................................................................................................................................4-18
4.5.3 statperf..................................................................................................................................................4-19
4.5.4 statres....................................................................................................................................................4-21
4.5.5 staterr....................................................................................................................................................4-22
4.5.6 cleanerr.................................................................................................................................................4-23
4.6 Software Upgrade Commands......................................................................................................................4-24
4.6.1 upgradesys............................................................................................................................................4-24
4.6.2 synchronize...........................................................................................................................................4-25
4.6.3 showsesmac..........................................................................................................................................4-26
4.6.4 showsesversion.....................................................................................................................................4-27
4.6.5 upgradeses............................................................................................................................................4-28
4.7 Primary/Secondary Switchover Commands..................................................................................................4-29
4.7.1 swapsys.................................................................................................................................................4-29
4.7.2 showmaster...........................................................................................................................................4-30
4.8 System Reset Command................................................................................................................................4-31
4.8.1 resetsys.................................................................................................................................................4-31
4.9 System Time Changing Command...............................................................................................................4-32
4.9.1 chgsystime............................................................................................................................................4-32
4.10 CHAP Setting Command............................................................................................................................4-33
4.10.1 chap....................................................................................................................................................4-33
4.11 TrapIP Management Commands.................................................................................................................4-37

ii Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference Contents

4.11.1 showtrapip..........................................................................................................................................4-38
4.11.2 addtrapip.............................................................................................................................................4-38
4.11.3 deletetrapip.........................................................................................................................................4-39
4.11.4 chgtrapip.............................................................................................................................................4-40
4.12 Command of Clearing the DB Configuration of the Coffer........................................................................4-41
4.12.1 cleancofferdb......................................................................................................................................4-42
4.13 Version Information Query Command.......................................................................................................4-42
4.13.1 showallver..........................................................................................................................................4-43
4.14 Mirroring Information Query Commands...................................................................................................4-44
4.14.1 showmirror.........................................................................................................................................4-44

5 Device Management Commands............................................................................................5-1


5.1 Disk Enclosure Configuration Commands......................................................................................................5-3
5.1.1 showsubrack...........................................................................................................................................5-3
5.1.2 deletesubrack..........................................................................................................................................5-4
5.2 Disk Management Commands........................................................................................................................5-4
5.2.1 showdiskinfo..........................................................................................................................................5-5
5.2.2 chgdisklight............................................................................................................................................5-5
5.3 Controller Management Commands...............................................................................................................5-6
5.3.1 showctrlboard.........................................................................................................................................5-7
5.3.2 chgctrlmodel...........................................................................................................................................5-8
5.4 Hibernation Management Commands.............................................................................................................5-9
5.4.1 chgcomsleep...........................................................................................................................................5-9
5.4.2 showcomsleep......................................................................................................................................5-12
5.5 Command of Querying the Information About a Host Port Module............................................................5-13
5.5.1 showinterface.......................................................................................................................................5-13
5.6 Expander Module Management Command...................................................................................................5-14
5.6.1 showexpboard.......................................................................................................................................5-15
5.7 UPS Information Query Commands.............................................................................................................5-16
5.7.1 showupstime.........................................................................................................................................5-16
5.7.2 showupsstat..........................................................................................................................................5-17
5.8 Command of Managing the Power Supply Information...............................................................................5-18
5.8.1 showpowerinfo.....................................................................................................................................5-18
5.9 Power off the device command.....................................................................................................................5-19
5.9.1 shutdown..............................................................................................................................................5-19
5.10 BBU Information Query Command............................................................................................................5-20
5.10.1 showbbu.............................................................................................................................................5-20
5.11 Command of Querying the Fan Group Information....................................................................................5-21
5.11.1 showfan..............................................................................................................................................5-21
5.12 Commands of Querying the Information About Buzzer Status..................................................................5-22
5.12.1 showbuzzerstatus................................................................................................................................5-22
5.12.2 chgbuzzerstatus..................................................................................................................................5-23
5.13 Host Port Configuration Commands...........................................................................................................5-24

Issue 07 (2010-05-20) Huawei Proprietary and Confidential iii


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Contents Command Reference

5.13.1 showfps...............................................................................................................................................5-24
5.13.2 chgfps.................................................................................................................................................5-26
5.13.3 showsasmode......................................................................................................................................5-27
5.13.4 showiscsiip.........................................................................................................................................5-28
5.13.5 chgiscsiip............................................................................................................................................5-29
5.13.6 chgiscsiroute.......................................................................................................................................5-31
5.13.7 chgiscsiname......................................................................................................................................5-32
5.13.8 showiscsiroute....................................................................................................................................5-33
5.13.9 showfcmode.......................................................................................................................................5-34
5.13.10 chgfcmode........................................................................................................................................5-35
5.13.11 showfcport........................................................................................................................................5-36

6 Service Management Commands............................................................................................6-1


6.1 RAID Group Configuration Commands.........................................................................................................6-2
6.1.1 createrg...................................................................................................................................................6-2
6.1.2 deleterg...................................................................................................................................................6-3
6.1.3 chgrg.......................................................................................................................................................6-4
6.1.4 showrg....................................................................................................................................................6-5
6.1.5 chgrgredundantcopy...............................................................................................................................6-6
6.1.6 showrgredundantcopy............................................................................................................................ 6-7
6.2 LUN Configuration Commands......................................................................................................................6-8
6.2.1 createlun.................................................................................................................................................6-8
6.2.2 deletelun...............................................................................................................................................6-10
6.2.3 chglun...................................................................................................................................................6-11
6.2.4 showlun................................................................................................................................................6-13
6.3 LUN Mapping Configuration Commands.....................................................................................................6-15
6.3.1 createhostgroup....................................................................................................................................6-15
6.3.2 deletehostgroup....................................................................................................................................6-16
6.3.3 chghostgroup........................................................................................................................................6-17
6.3.4 showhostgroup.....................................................................................................................................6-18
6.3.5 addhost.................................................................................................................................................6-19
6.3.6 chghost.................................................................................................................................................6-20
6.3.7 deletehost..............................................................................................................................................6-21
6.3.8 showhost...............................................................................................................................................6-22
6.3.9 showfreeport.........................................................................................................................................6-23
6.3.10 addport................................................................................................................................................6-24
6.3.11 showhostport......................................................................................................................................6-25
6.3.12 deleteport............................................................................................................................................6-26
6.3.13 chgport................................................................................................................................................6-27
6.3.14 showunmap.........................................................................................................................................6-28
6.3.15 addmap...............................................................................................................................................6-29
6.3.16 showmap.............................................................................................................................................6-30
6.3.17 deletemap...........................................................................................................................................6-30

iv Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference Contents

6.4 Disk Configuration Commands.....................................................................................................................6-31


6.4.1 startrecon..............................................................................................................................................6-32
6.4.2 startcopyback........................................................................................................................................6-33
6.4.3 showdisk...............................................................................................................................................6-34
6.4.4 chgdisktype...........................................................................................................................................6-35
6.5 Cache Configuration Commands..................................................................................................................6-36
6.5.1 showcache............................................................................................................................................6-36
6.5.2 chgcache...............................................................................................................................................6-37

7 Alarm Management Commands.............................................................................................7-1


7.1 Alarm Email Management Commands...........................................................................................................7-2
7.1.1 chgemail.................................................................................................................................................7-2
7.1.2 showemail...............................................................................................................................................7-4
7.2 Alarm Short Message Management Commands.............................................................................................7-4
7.2.1 chgsms....................................................................................................................................................7-5
7.2.2 showsms.................................................................................................................................................7-6

8 User Management Commands................................................................................................8-1


8.1 User Adding Command...................................................................................................................................8-2
8.1.1 adduser...................................................................................................................................................8-2
8.2 User Deleting Command.................................................................................................................................8-3
8.2.1 deleteuser................................................................................................................................................8-3
8.3 User Information Query Command.................................................................................................................8-4
8.3.1 showuser.................................................................................................................................................8-4
8.4 User Level Change Command........................................................................................................................8-5
8.4.1 chguserlevel............................................................................................................................................8-5
8.5 User Password Change Command..................................................................................................................8-6
8.5.1 chgpasswd..............................................................................................................................................8-6
8.6 User Logout Command...................................................................................................................................8-7
8.6.1 logout......................................................................................................................................................8-7

9 Value-Added Service Management Commands.................................................................. 9-1


9.1 Hyperimage Configuration Commands..........................................................................................................9-2
9.1.1 showhyimginfo.......................................................................................................................................9-2
9.1.2 chghyimgname.......................................................................................................................................9-3
9.1.3 showlunforpool.......................................................................................................................................9-4
9.1.4 addluntopool...........................................................................................................................................9-5
9.1.5 rmlunfrompool.......................................................................................................................................9-6
9.1.6 showpoollun...........................................................................................................................................9-7
9.1.7 showpoolinfo..........................................................................................................................................9-8
9.1.8 chgpoolalarmvalue.................................................................................................................................9-9
9.1.9 showlunforhyimg.................................................................................................................................9-10
9.1.10 createhyimg........................................................................................................................................9-11
9.1.11 deletehyimg........................................................................................................................................9-12

Issue 07 (2010-05-20) Huawei Proprietary and Confidential v


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Contents Command Reference

9.1.12 disablehyimg......................................................................................................................................9-13
9.1.13 cancelrollbackhyimg..........................................................................................................................9-14
9.1.14 rollbackhyimg.....................................................................................................................................9-15
9.1.15 recreatehyimg.....................................................................................................................................9-16
9.1.16 activehyimg........................................................................................................................................9-17
9.1.17 createhyimgcp....................................................................................................................................9-18
9.1.18 chghyimgrollbackspeed......................................................................................................................9-19
9.1.19 createtimehyimg.................................................................................................................................9-20
9.1.20 stoptimehyimg....................................................................................................................................9-22
9.1.21 chgtimehyimg.....................................................................................................................................9-22
9.1.22 showhyimgoflun.................................................................................................................................9-24
9.1.23 deletetimehyimg.................................................................................................................................9-25
9.1.24 showtimehyimg..................................................................................................................................9-25
9.1.25 showlunoftimehyimg..........................................................................................................................9-26
9.1.26 showlunfortimehyimg........................................................................................................................9-27
9.2 Hypercopy Configuration Commands..........................................................................................................9-28
9.2.1 showhycpinfo.......................................................................................................................................9-29
9.2.2 showhycpluninfo..................................................................................................................................9-30
9.2.3 chghycpinfo..........................................................................................................................................9-32
9.2.4 deletehycplun.......................................................................................................................................9-34
9.2.5 deletehycp.............................................................................................................................................9-35
9.2.6 chghycpstatus.......................................................................................................................................9-35
9.2.7 showlunforhycp....................................................................................................................................9-37
9.2.8 createhycp.............................................................................................................................................9-38
9.2.9 taghycp.................................................................................................................................................9-41
9.2.10 addhycplun.........................................................................................................................................9-42
9.3 LUN-Expanding Management Commands...................................................................................................9-44
9.3.1 showexpluninfo....................................................................................................................................9-44
9.3.2 showexplunmember.............................................................................................................................9-45
9.3.3 rmlunfromexplun..................................................................................................................................9-46
9.3.4 showlunforexplun.................................................................................................................................9-47
9.3.5 addluntoexplun.....................................................................................................................................9-48
9.3.6 showexplunnum...................................................................................................................................9-49
9.4 Initiator and target (controller) Configuration Commands...........................................................................9-50
9.4.1 addtgt....................................................................................................................................................9-50
9.4.2 showtgt.................................................................................................................................................9-52
9.4.3 connecttgt.............................................................................................................................................9-53
9.4.4 chgtgt....................................................................................................................................................9-53
9.4.5 disconnecttgt.........................................................................................................................................9-55
9.4.6 chgiscsiininame....................................................................................................................................9-56
9.4.7 showiscsiname......................................................................................................................................9-57
9.4.8 deletetgtinfo..........................................................................................................................................9-57

vi Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference Contents

9.4.9 chgini....................................................................................................................................................9-58
9.5 Link information Configuration Commands.................................................................................................9-59
9.5.1 showlinkinfo.........................................................................................................................................9-59
9.5.2 showarraylinkinfo.................................................................................................................................9-60
9.6 Other Configuration Commands...................................................................................................................9-62
9.6.1 showarrayinfo ......................................................................................................................................9-62
9.6.2 createvirlunmask..................................................................................................................................9-63
9.6.3 cancelvirlunmask..................................................................................................................................9-64
9.6.4 showthirdpartyluninfo..........................................................................................................................9-65
9.6.5 statlink..................................................................................................................................................9-66
9.6.6 testlink..................................................................................................................................................9-67
9.6.7 chglinkstat............................................................................................................................................9-68
9.6.8 showlinkperiod.....................................................................................................................................9-69
9.6.9 chglicensestatus....................................................................................................................................9-70
9.6.10 showincrementlicense........................................................................................................................9-71

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


A.1 Preparations For Contacting Huawei.............................................................................................................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-2
A.4 Ways to Contact Huawei...............................................................................................................................A-3

B Glossary......................................................................................................................................B-1
C Acronyms and Abbreviations................................................................................................C-1

Issue 07 (2010-05-20) Huawei Proprietary and Confidential vii


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


Downloaded from www.Manualslib.com manuals search engine
OceanStor S2600 Storage System
Command Reference Figures

Figures

Figure 1-1 Connection Description......................................................................................................................1-3


Figure 1-2 Connect To......................................................................................................................................... 1-3
Figure 1-3 COM1 Properties................................................................................................................................1-4
Figure 1-4 Interface for successful connection between the controller subrack and the maintenance terminal
...............................................................................................................................................................................1-4
Figure 1-5 Interface for successful login..............................................................................................................1-5
Figure 1-6 PuTTY Configuration.........................................................................................................................1-6
Figure 1-7 Logging to the server through the PuTTY software...........................................................................1-6
Figure 1-8 Interface of successful login...............................................................................................................1-7

Issue 07 (2010-05-20) Huawei Proprietary and Confidential ix


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


Downloaded from www.Manualslib.com manuals search engine
OceanStor S2600 Storage System
Command Reference Tables

Tables

Table 2-1 Conventions of the CLI commands......................................................................................................2-3


Table 2-2 Basic operation command set...............................................................................................................2-4
Table 2-3 System management command set...................................................................................................... 2-5
Table 2-4 Device management command set.......................................................................................................2-6
Table 2-5 Service configuration command set.....................................................................................................2-8
Table 2-6 Alarm management command set........................................................................................................2-9
Table 2-7 User management command set.........................................................................................................2-10
Table 2-8 Value-added service management commands set..............................................................................2-10

Issue 07 (2010-05-20) Huawei Proprietary and Confidential xi


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


Downloaded from www.Manualslib.com manuals search engine
OceanStor S2600 Storage System
Command Reference About This Document

About This Document

Purpose
This document describes how to configure and manage the storage system through the CLI
provided by the OceanStor S2600 Storage System, and how to use the commands according to
the functions.

Related Versions
The following table lists the product versions related to this document.

Product Name Version

OceanStor S2600 Storage System V100R002

Intended Audience
This document is intended for:
l Data configuration engineers
l Management and maintenance personnel

Organization
This document is organized as follows.

Chapter Description

1 Introduction to the CLI This chapter describes the CLI and how to configure and
manage the storage system through the CLI.

2 Introduction to the CLI This chapter describes the modes, levels, and types of
Commands commands according to the functions.

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 1


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
About This Document Command Reference

Chapter Description

3 Basic Operation This chapter describes how to use the basic operation
Commands commands.

4 System Management This chapter describes how to use the system management
Commands commands.

5 Device Management This chapter describes how to use the device management
Commands commands.

6 Service Management This chapter describes how to use the service configuration
Commands commands.

7 Alarm Management This chapter describes how to use the alarm management
Commands commands.

8 User Management This chapter describes how to use the user management
Commands commands.

9 Value-Added Service This chapter describes how to use the value-added service
Management Commands management commands.

A How to Obtain Help This chapter describes preparations and ways for obtaining help
from Huawei.

B Glossary This chapter describes the terms referred to in this document.

C Acronyms and This chapter describes the acronyms and abbreviations referred
Abbreviations to in this document.

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

Symbol Description

Indicates a hazard with a high level of risk, which if not


avoided, will result in death or serious injury.
DANGER

Indicates a hazard with a medium or low level of risk, which


if not avoided, could result in minor or moderate injury.
WARNING

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.

2 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference About This Document

Symbol Description

NOTE Provides additional information to emphasize or


supplement important points of the main text.

General Conventions
The general conventions that may be found in this document are defined as follows.

Convention Description

Times New Roman Normal paragraphs are in Times New Roman.

Boldface Names of files, directories, folders, and users are in


boldface. For example, log in as user root.

Italic Book titles are in italics.


Courier New Examples of information displayed on the screen are in
Courier New.

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.

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

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 3


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
About This Document Command Reference

Convention Description

Boldface Buttons, menus, parameters, tabs, window, and dialog titles


are in boldface. For example, click OK.

> Multi-level menus are in boldface and separated by the ">"


signs. For example, choose File > Create > Folder.

Keyboard Operations
The keyboard operations that may be found in this document are defined as follows.

Format Description

Key Press the key. For example, press Enter and press Tab.

Key 1+Key 2 Press the keys concurrently. For example, pressing Ctrl+Alt
+A means the three keys should be pressed concurrently.

Key 1, Key 2 Press the keys in turn. For example, pressing Alt, A means
the two keys should be pressed in turn.

Mouse Operations
The mouse operations that may be found in this document are defined as follows.

Action Description

Click Select and release the primary mouse button without moving
the pointer.

Double-click Press the primary mouse button twice continuously and


quickly without moving the pointer.

Drag Press and hold the primary mouse button and move the
pointer to a certain position.

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

Updates in Issue 07 (2010-05-20)


The seventh commercial release.

Add showlicense, showvoltage and showfcport commands.

4 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference About This Document

Updates in Issue 06 (2010-04-15)


The sixth commercial release.
Modify commands description.

Updates in Issue 05 (2010-01-19)


The fifths commercial release.
Add descriptions of chgctrlip command.
Add descriptions of Hyper Terminal.

Updates in Issue 04 (2009-11-15)


The fourth commercial release has the following updates:
Add two commands.
Brand changes.

Updates in Issue 03 (2009-10-27)


The third commercial release has the following updates:
Bugs revised.

Updates in Issue 02 (2009-09-30)


The second commercial release has the following updates:
Bugs revised.

Updates in Issue 01 (2009-08-31)


Initial field trial release.

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 5


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


Downloaded from www.Manualslib.com manuals search engine
OceanStor S2600 Storage System
Command Reference 1 Introduction to the CLI

1 Introduction to the CLI

About This Chapter

This chapter describes the command line interface (CLI), and how to configure and manage the
storage system through the CLI.

1.1 Overview of the CLI


Provided by the OceanStor S2600 storage system (hereinafter referred to as S2600), the CLI
supports batch processing operations, which helps you manage and maintain the devices
efficiently and quickly.
1.2 Configuring and Managing the Storage System Through the CLI
This document describes how to configure and manage the storage system through the CLI.

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 1-1


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
1 Introduction to the CLI Command Reference

1.1 Overview of the CLI


Provided by the OceanStor S2600 storage system (hereinafter referred to as S2600), the CLI
supports batch processing operations, which helps you manage and maintain the devices
efficiently and quickly.

The CLI helps users query, set, manage, and maintain the storage system. The CLI supports
batch processing operations, which helps you maintain the devices efficiently and quickly.

The CLI supports the following functions:

l Querying, configuring, and managing the services of the S2600


l Maintaining the S2600 routinely
l Running scripts

1.2 Configuring and Managing the Storage System Through


the CLI
This document describes how to configure and manage the storage system through the CLI.

1.2.1 Logging In to the Command Line Interface


The CLI that provided by the ISM helps you to query, configure, and manage the services of the
storage system.
1.2.2 Configuration and Management
This topic introduces the settings you are recommended to do when you first log in to the CLI.

1.2.1 Logging In to the Command Line Interface


The CLI that provided by the ISM helps you to query, configure, and manage the services of the
storage system.

NOTE

You can log in to the CLI interface in the following two ways:
l through the management network port
After connect the maintenance terminal to the controller subrack through the serial cable (DB-9 to
DB-9), you can connect to the CLI of the controller through the Hyper Terminal or other terminal
programs provided by the Windows operating system.
l through the management network port
After connecting the maintenance terminal to the management network port of the controller subrack,
you can log in to the CLI through the remote login software that supports the SSH protocol.

Log in to the CLI through the serial port


1. Takes the Windows operating system as an example, run Hyper Terminal (generally, you
can find Hyper Terminal along the following route: Start > All Programs > Accessories
> Hyper Terminal), and a dialog box displays showing in Figure 1-1. Type a name, select
any icon, and click OK. Type a name, select any icon, and click OK.

1-2 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 1 Introduction to the CLI

Figure 1-1 Connection Description

2. The Connect To dialog box is displayed as shown in Figure 1-2. In the Connect using
drop-down list, select a serial port, for example, COM1, and click OK.

Figure 1-2 Connect To

3. In the COM1 Properties dialog box, set the parameters as shown in Figure 1-3. Click
OK.

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 1-3


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
1 Introduction to the CLI Command Reference

Figure 1-3 COM1 Properties

4. Press the Enter key. If the controller subrack is connected to the maintenance terminal
successfully, the system displays the following information. See Figure 1-4.

Figure 1-4 Interface for successful connection between the controller subrack and the
maintenance terminal

1-4 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 1 Introduction to the CLI

5. In the CLI, enter the user name and the password in sequence. See Figure 1-5.

Figure 1-5 Interface for successful login

Log in to the CLI through management network port


NOTE

This document takes the PuTTY software as an example. You can download the PuTTY software on related
websites.

1. Run the PuTTY software and the PuTTY Configuration dialog box is displayed, as shown
in Figure 1-6.

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 1-5


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
1 Introduction to the CLI Command Reference

Figure 1-6 PuTTY Configuration

2. Enter the IP address of the management network port in Specify your connection by host
name or IP addressHost Name (or IP address). Select Protocol as SSH.
3. Click Open and the displayed interface is as shown in Figure 1-7.

Figure 1-7 Logging to the server through the PuTTY software

1-6 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 1 Introduction to the CLI

4. Enter the user name and the password in the prompt of the CLI interface, as shown in
Figure 1-8.

Figure 1-8 Interface of successful login

CAUTION
The initial user name of the system administrator is admin. The initial password is
123456. After the first login, you need to change the password to ensure the system security.
You can use the 8.5.1 chgpasswd command to change the password.

It is recommended to set the Internet Protocol (IP) of the controller for the first login. To set the
IP of the controller, you can use the 3.4.1 chgctrlip command.

After configuring the IP addresses of the management network port, you can log in to the storage
system remotely for routine maintenance and management.

1.2.2 Configuration and Management


This topic introduces the settings you are recommended to do when you first log in to the CLI.

You are recommended to set the IP address of the management network interface on the
controller when you first log in to the CLI. For the commands and methods used in the settings,
see 3.4 Commands of Setting the IP Address of the Management Network Interface on the
Controller.

NOTE

The initial IP addresses of the management network interfaces of the controllers are 192.168.128.101 and
192.168.128.102.

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 1-7


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
1 Introduction to the CLI Command Reference

After setting the IP addresses of the management network interfaces, you can log in to the storage
system remotely over the secure shell (SSH) protocol for routine maintenance and management.

1-8 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 2 Introduction to the CLI Commands

2 Introduction to the CLI Commands

About This Chapter

This chapter describes the modes, levels, and types of commands according to the functions.

2.1 Overview of the CLI Commands


This topic introduces the features, modes, and management levels of the CLI commands.
2.2 Command Classification
The CLI commands are classified into the basic operation commands, system management
commands, device management commands, service management commands, alarm
management commands, user management commands and value-added service management
commands.

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 2-1


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
2 Introduction to the CLI Commands Command Reference

2.1 Overview of the CLI Commands


This topic introduces the features, modes, and management levels of the CLI commands.

2.1.1 Mode
The CLI commands can be classified into normal mode, safe mode and upgrade mode.
2.1.2 Level
The CLI command level can be classified into super administrator level, administrator level and
guest level.
2.1.3 Operation Guide
This topic describes the format of the CLI commands and shows how to use the commands in
the CLI.

2.1.1 Mode
The CLI commands can be classified into normal mode, safe mode and upgrade mode.
The CLI commands can be classified into the following modes:
l Normal mode
The mode when the system is in the normal state.
l Safe mode
The mode when system configuration data is inconsistent.
l Upgrade mode
The mode during a system upgrade.

2.1.2 Level
The CLI command level can be classified into super administrator level, administrator level and
guest level.
The command level can be classified into the following types:
l Super administrator level
Only the super administrator can use the commands of this level. The administrator and
guest cannot use the commands of this level.
l Administrator level
Only the super administrator and administrator can use the commands of this level. The
guest cannot use the commands of this level.
l Guest level
The super administrator, administrator and the guest can use the commands of this level.

2.1.3 Operation Guide


This topic describes the format of the CLI commands and shows how to use the commands in
the CLI.
When using the CLI commands, follow the conventions of the CLI commands.
Table 2-1 lists the conventions of the CLI commands.

2-2 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 2 Introduction to the CLI Commands

Table 2-1 Conventions of the CLI commands

Convention Description

Boldface The keywords of a command line are in boldface.

Italic Command arguments are in italics.

[] Items (keywords or arguments) in square 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.

You can use the command completion function by press the Tab key.

After you enter part of a command and press Tab, the system does not display any information.
Press Tab again, all the commands that start with what you have entered are displayed. After
you enter part of a command, if the system can identify the command through the entered letters,
you can complete the command by pressing Tab.

NOTE

l If no character is entered on the CLI, no information is displayed when you press Tab for the first time.
All commands are displayed after you press Tab again.
l After part of a command is entered, if no information is displayed after you press Tab twice, it indicates
that the command start with the entered letters does not exist.
l If multiple commands match with what you have entered, a list of possible commands is displayed.
l If only one command matches with what you have entered, the command is completed automatically,
and then the cursor moves to the end of the command.

For example, on the CLI, enter a, and press Tab. No information is displayed.

OceanStor: admin> a

If you press Tab again, the commands start with the letter a are displayed.

OceanStor: admin> a
addhost addmap addport
adduser autobat

Enter add, and press Tab. No information is displayed. Press Tab again, the commands that
start with letters add are displayed.

OceanStor: admin> add

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 2-3


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
2 Introduction to the CLI Commands Command Reference

addhost addmap addport


adduser

Enter addu, and press Tab. The command is completed automatically.

OceanStor: admin> adduser

2.2 Command Classification


The CLI commands are classified into the basic operation commands, system management
commands, device management commands, service management commands, alarm
management commands, user management commands and value-added service management
commands.

2.2.1 Basic Operation Commands


The basic operation commands are mainly used to set the basic information of storage system.
2.2.2 System Management Commands
The system management commands are mainly used to configure and query the running
information of the storage system.
2.2.3 Device Management Commands
The device management commands are mainly used to configure and query the hardware
information of the storage system.
2.2.4 Service Management Commands
The service configuration commands are mainly used to configure and query the service
information of the storage system.
2.2.5 Alarm Management Commands
The alarm management commands are mainly used to configure and query the alarm information
of the storage system.
2.2.6 User Management Commands
The user management commands are mainly used to configure and query the user information
of the storage system.
2.2.7 Value-Added Service Management Commands
Value-added service management commands are used to manage the value-added service of the
storage system.

2.2.1 Basic Operation Commands


The basic operation commands are mainly used to set the basic information of storage system.
Table 2-2 lists the basic operation commands.

Table 2-2 Basic operation command set


Classification Command

Help command clihelp

System exiting and logout commands exit

logout

2-4 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 2 Introduction to the CLI Commands

Classification Command

Batch processing command autobat

Commands of setting the IP address of the chgctrlip


management network interface on the
controller showctrlip

CLI idle time setting command chgidletime

2.2.2 System Management Commands


The system management commands are mainly used to configure and query the running
information of the storage system.
Table 2-3 lists the system management commands.

Table 2-3 System management command set


Classification Command

System information query commands showsys

showsysfail

showtemperature

showvoltage

showsn

showlicense

Controller management commands offline

showctrlinfo

Alarm log exporting or log exporting exportalm


commands

Configuration management commands exportcofferdb

exportblackbox

exportconf

importconf

exportstat

Statistics management commands showstatswitch

chgstatswitch

statperf

statres

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 2-5


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
2 Introduction to the CLI Commands Command Reference

Classification Command

staterr

cleanerr

Software upgrade commands upgradesys

synchronize

showsesmac

showsesversion

upgradeses

Primary/secondary switchover commands swapsys

showmaster

System resetting command resetsys

System time changing command chgsystime

CHAPa setting command chap

Trap IP management commands showtrapip

addtrapip

deletetrapip

chgtrapip

Command for clearing the DBb configuration cleancofferdb


of the coffer

Version information query command showallver

Mirroring Information Query Commands showmirror

a: Challenge Handshake Authentication Protocol


b: Database

2.2.3 Device Management Commands


The device management commands are mainly used to configure and query the hardware
information of the storage system.

Table 2-4 lists the device management commands.

Table 2-4 Device management command set

Classification Command

Disk enclosure configuration commands showsubrack

2-6 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 2 Introduction to the CLI Commands

Classification Command

deletesubrack

Disk management commands showdiskinfo

chgdisklight

Controller information management showctrlboard


command
chgctrlmodel

Hibernation management commands chgcomsleep

showcomsleep

Command of querying the information showinterface


about a host port module

Expander module management showexpboard


command

UPSa information query commands showupstime

showupsstat

Power information query command showpowerinfo

Power off the device command shutdown

BBUa information query command showbbu

Fan information query command showfan

Commands of querying the information showbuzzerstatus


about buzzer status
chgbuzzerstatus

Host port configuration commands showfps

chgfps

showsasmode

showiscsiip

chgiscsiip

chgiscsiroute

chgiscsiname

showiscsiroute

showfcmode

chgfcmode

showfcport

a: Backup Battery Unit

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 2-7


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
2 Introduction to the CLI Commands Command Reference

2.2.4 Service Management Commands


The service configuration commands are mainly used to configure and query the service
information of the storage system.
Table 2-5 lists the service configuration commands.

Table 2-5 Service configuration command set


Classification Command

RAIDa group configuration commands createrg

deleterg

chgrg

showrg

chgrgredundantcopy

showrgredundantcopy

LUNb configuration commands createlun

deletelun

chglun

showlun

LUN mapping configuration commands createhostgroup

deletehostgroup

chghostgroup

showhostgroup

addhost

chghost

deletehost

showhost

showfreeport

addport

showhostport

deleteport

chgport

2-8 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 2 Introduction to the CLI Commands

Classification Command

showunmap

addmap

showmap

deletemap

Disk configuration commands startrecon

startcopyback

showdisk

chgdisktype

Cache configuration commands showcache

chgcache

a: Redundant Array of Independent Disks


b: Logical Unit Number

2.2.5 Alarm Management Commands


The alarm management commands are mainly used to configure and query the alarm information
of the storage system.
Table 2-6 lists the alarm management commands.

Table 2-6 Alarm management command set


Classification Command

Alarm email management commands chgemail

showemail

Alarm short message management commands chgsms

showsms

2.2.6 User Management Commands


The user management commands are mainly used to configure and query the user information
of the storage system.
Table 2-7 lists the user management commands.

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 2-9


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
2 Introduction to the CLI Commands Command Reference

Table 2-7 User management command set


Classification Command

User adding command adduser

User deleting command deleteuser

User information query command showuser

User level changing command chguserlevel

User password changing command chgpasswd

User logout command logout

2.2.7 Value-Added Service Management Commands


Value-added service management commands are used to manage the value-added service of the
storage system.
Table 2-8 lists the value-added service management commands.

Table 2-8 Value-added service management commands set


Classification Command

Hyperimage configuration commands showhyimginfo

chghyimgname

showlunforpool

addluntopool

rmlunfrompool

showpoollun

showpoolinfo

chgpoolalarmvalue

showlunforhyimg

createhyimg

deletehyimg

disablehyimg

cancelrollbackhyimg

rollbackhyimg

recreatehyimg

activehyimg

2-10 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 2 Introduction to the CLI Commands

Classification Command

createhyimgcp

chghyimgrollbackspeed

createtimehyimg

stoptimehyimg

chgtimehyimg

showhyimgoflun

deletetimehyimg

showtimehyimg

showlunoftimehyimg

showlunfortimehyimg

Hypercopy configuration commands showhycpinfo

showhycpluninfo

chghycpinfo

deletehycplun

deletehycp

chghycpstatus

showlunforhycp

createhycp

taghycp

addhycplun

LUN-expanding management commands showexpluninfo

showexplunmember

rmlunfromexplun

showlunforexplun

addluntoexplun

showexplunnum

Initiator and target (controller) Configuration addtgt


Commands
showtgt

connecttgt

chgtgt

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 2-11


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
2 Introduction to the CLI Commands Command Reference

Classification Command

disconnecttgt

chgiscsiininame

showiscsiname

deletetgtinfo

chgini

Link information Configuration Commands showlinkinfo

showarraylinkinfo

Other Configuration Commands showarrayinfo

createvirlunmask

cancelvirlunmask

showthirdpartyluninfo

statlink

testlink

chglinkstat

showlinkperiod

chglicensestatus

showincrementlicense

2-12 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 3 Basic Operation Commands

3 Basic Operation Commands

About This Chapter

Basic operation commands are used to set the basic information of the storage system.

3.1 Help Command


Help command is used to query the function and usage of every command.
3.2 System Exit and Logout Commands
System exit and logout commands are used to exit the storage system.
3.3 Batch Processing Command
Batch processing command is used to execute the command scripts.
3.4 Commands of Setting the IP Address of the Management Network Interface on the Controller
Commands of setting the IP address of the management network interface on the controller is
used to set the IP address of the management network interface on the controller.
3.5 CLI Idle Time Setting Command
CLI idle time setting command is used to set CLI idle time.

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 3-1


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
3 Basic Operation Commands Command Reference

3.1 Help Command


Help command is used to query the function and usage of every command.

3.1.1 clihelp

3.1.1 clihelp

Function
The command clihelp is used to query the syntax and details about the commands supported by
the CLI.

Format
clihelp [ -h command name ]

Parameters
Keyword and Value Description Default Value

-h command name The command name. None.

Modes
Normal mode, safe mode, and upgrade mode.

Level
Super administrator level, administrator level and guest level.

Usage Guidelines
When using this command, note the following items:
l Each user can only query the command help information under the related rights.
l The command clihelp is used to query the information about all the commands in current
mode.
l The command clihelp -h command name is used to query the help information about the
command.

Example
Query the help information about the chgrg command.
OceanStor: admin> clihelp -h chgrg
CHGRG(1) User Commands CHGRG(1)

NAME

3-2 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 3 Basic Operation Commands

chgrg -modify the name of the RAID group

SYNOPSIS
chgrg -i RAID group ID -n RAID group name.

DESCRIPTION
You can modify the name of the RAID group through the CLI.

OPTIONS
-i RAID group ID
ID of the RAID group whose name is to be modified, ranges fr
om 0 to 31.

-n RAID group name


New name of the RAID group. The string contains at most 32 c
haracters made up of letters or numbers or - or _, and - may
not be the first.

AUTHOR
Written by Qiao Lina.

COPYRIGHT
All right reserved (C), 2008, Huawei Technologies Co., Ltd.

SEPTEMBER 2006 CHGRG(1)

3.2 System Exit and Logout Commands


System exit and logout commands are used to exit the storage system.

3.2.1 exit
3.2.2 logout

3.2.1 exit

Function
The command exit is used to exit the CLI.

Format
exit

Parameters
None.

Modes
Normal mode, safe mode, and upgrade mode.

Level
Super administrator level, administrator level and guest level.

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 3-3


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
3 Basic Operation Commands Command Reference

Usage Guidelines
When you need to log out the storage system , use the command exit .

Example
Exit the CLI.
OceanStor: admin> exit

3.2.2 logout

Function
The command logout is used to log out of the CLI.

Format
logout

Parameters
None.

Modes
Normal mode, safe mode, and upgrade mode.

Level
Super administrator level, administrator level and guest level.

Usage Guidelines
The command logout is used to log out of the CLI.

Example
Log out of the CLI.
OceanStor: admin> logout

3.3 Batch Processing Command


Batch processing command is used to execute the command scripts.

3.3.1 autobat

3.3.1 autobat

3-4 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 3 Basic Operation Commands

Function
The command autobat is used to execute the CLI command scripts.

Format
autobat -i Host IP address -u user name -p password -f file

Parameters
Keyword and Value Description Default Value

-i Host IP address File Transfer Protocol (FTP) None.


Server IP address. It is
requested that the FTP server
can access the storage
network.

-u user name The user name of the FTP None.


server.

-p password The password of the FTP None.


server.

-f file The path where the batch file None.


is stored on the FTP server,
and the file name.

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
When using this command, note the following items:
l One line is for one command only.
l Commands such as chgpasswd that require manual entering the parameter cannot be used.

Example
Execute the cmdfile script. The IP address of the FTP server is 10.10.10.1. The user name is
root, and the password is 123456. The batch process file, whose name is cmdfile, is stored in
the path /home/ISM/ on the FTP server.
OceanStor: admin> autobat -i 10.10.10.1 -u root -p 123456 -f /home/ISM/cmdfile
Lun ID Name Status
0 LUNXX fault
Raid Group ID Name Level Status
0 RAIDXX 10 fault

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 3-5


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
3 Basic Operation Commands Command Reference

3.4 Commands of Setting the IP Address of the Management


Network Interface on the Controller
Commands of setting the IP address of the management network interface on the controller is
used to set the IP address of the management network interface on the controller.

3.4.1 chgctrlip
3.4.2 showctrlip

3.4.1 chgctrlip

Function
The command chgctrlip is used to set the IP address of the management network interface on
the controller, the storage system will automatically restart after the IP address is modified.

Format
chgctrlip -c controller ID [ -a IP address ] [ -s subnet mask ] [-g gateway ]

Parameters
Keyword and Value Description Default Value

-c controller ID The controller ID. The value None.


is A or B, and is case
insensitive.

-a IP address The IP address of the None.


management network
interface on the controller.

-s subnet mask The subnet mask. None.

-g gateway The gateway. None.

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
The command chgctrlip is used to set the IP address of the management network interface on
the controller.

3-6 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 3 Basic Operation Commands

Example
Set the IP address of the management network interface on the controller A to 10.10.10.1 , the
subnet mask to 255.255.0.0, and the gateway to 10.10.10.0.
OceanStor: admin> chgctrlip -c a -a 10.10.10.1 -s 255.255.0.0 -g 10.10.10.0

3.4.2 showctrlip

Function
The command showctrlip is used to query the information about the IP address of the controller.

Format
showctrlip[ -c controller ID ]

Parameters
Keyword and Value Description Default Value

-c controller ID The controller ID. The value None.


is A or B, and is case
insensitive.

Modes
Normal mode.

Level
Super administrator level, administrator level and guest level.

Usage Guidelines
When using this command, note the following items:

l The command showctrlip is used to query the information about the IP addresses of all
controllers.
l The command showctrlip -c controller ID is used to query the information about the IP
address of a specified controller.

Example
Query the information about the IP addresses of all controllers.

OceanStor: admin> showctrlip


Controller IP Address Subnet Mask Gateway MAC Address
A 129.26.10.31 255.255.0.0 0.0.0.0 00:12:34:56:70:46
B 129.26.10.32 255.255.255.0 0.0.0.0 00:12:34:56:79:92

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 3-7


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
3 Basic Operation Commands Command Reference

3.5 CLI Idle Time Setting Command


CLI idle time setting command is used to set CLI idle time.

3.5.1 chgidletime

3.5.1 chgidletime

Function
The command chgidletime is used to set the system idle time.

Format
chgidletime -t time

Parameters
Keyword and Value Description Default Value

-t time The CLI idle time. The value None.


is an integer and is equal to or
more than two minutes. The
unit can be s (second), m
(minute), h (hour). The
default unit is s (second).

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
If the user does not perform any operation during the idle time, the user exits the CLI
automatically after the idle time.

Example
Set the CLI idle time to ten minutes.
OceanStor: admin> chgidletime -t 10m

3-8 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 4 System Management Commands

4 System Management Commands

About This Chapter

System management commands are mainly used to configure and query the running information
of the storage system.

4.1 System Information Query Commands


System information query commands are used to query the version information and license
information about the system, the temperature information and voltage information about the
device.
4.2 Controller Configuration Commands
The controller configuration commands are used to set the status of the controller to offline, and
to query the information about the controller.
4.3 File Management Command
File management command is used to download the alarms and logs on the storage system.
4.4 Configuration Management Commands
The configuration management commands are used to export the debug information, system
configuration information, and to import and export the configuration file.
4.5 Statistics Management Commands
The performance statistics management commands are used to make statistics upon performance
based on the interfaces or LUNs, and they are also used to clear the error codes on the FC host
ports.
4.6 Software Upgrade Commands
Software upgrade commands are used to upgrade the system software and SCSI Enclosure
Services (SES) Fiemware version.
4.7 Primary/Secondary Switchover Commands
Primary/Secondary switchover commands are used to set the state for system swapping and
query the system swapping state of the controller that the user logs in to.
4.8 System Reset Command
System reset command is used to reset the system.
4.9 System Time Changing Command
System time changing command is used to change the system time.

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 4-1


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
4 System Management Commands Command Reference

4.10 CHAP Setting Command


CHAP setting command is used to create, change, delete, and query CHAP user.
4.11 TrapIP Management Commands
TrapIP management commands are used to manage the Trap IP.
4.12 Command of Clearing the DB Configuration of the Coffer
Command of clearing the DB configuration of the coffer is used to clear the DB configuration
of the coffer.
4.13 Version Information Query Command
Version information query command is used to query the version information of the storage
system, including software version, product version, SES version, and logic version.
4.14 Mirroring Information Query Commands
Mirroring information query commands are used to query the mirroring information.

4-2 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 4 System Management Commands

4.1 System Information Query Commands


System information query commands are used to query the version information and license
information about the system, the temperature information and voltage information about the
device.

4.1.1 showsys
4.1.2 showsysfail
4.1.3 showtemperature
4.1.4 showvoltage
4.1.5 showsn
4.1.6 showlicense

4.1.1 showsys

Function
The command showsys is used to query the information about the storage system.

Format
showsys

Parameters
None.

Modes
Normal mode.

Level
Super administrator level, administrator level and guest level.

Usage Guidelines
The command showsys is used to query the information about the storage system.

Example
Query the system information.
OceanStor: admin> showsys
===================================================
System Information
---------------------------------------------------
System Name | aaa

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 4-3


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
4 System Management Commands Command Reference

Device Model | OceanStor S2600


Current System Mode | Single Controller Normal
Location | aaa
System Time | 2008-01-10 20:04:35
Device Serial Number | test007
Product Version | V100R002C01
iSCSI Device Name | --
===================================================

4.1.2 showsysfail

Function
The command showsysfail is used to query the cause of the system power-on failure and the
system status due to the power-on failure.

Format
showsysfail

Parameters
None.

Modes
Normal mode.

Level
Super administrator level, administrator level and guest level.

Usage Guidelines
The command showsysfail is used to query the cause of the system power-on failure and the
system status due to the power-on failure.

Example
Query the cause of the system power-on failure and the system status due to the power-on failure.

OceanStor: admin> showsysfail


Power On Fail Reason: None
After Power on Fail System Status: Normal mode

4.1.3 showtemperature

Function
The command showtemperature is used to query the temperature of the controller, expander
module, or host port module.

4-4 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 4 System Management Commands

Format
showtempetarure -t type

Parameters

Keyword and Value Description Default Value

-t type The object to be queried. None.


The value ranges can be 0 , 1
or 2:
l 0: The controller.
l 1: The expander module.
l 2: The host port module.

Modes
Normal mode.

Level
Super administrator level, administrator level and guest level.

Usage Guidelines
The command showtemperature is used to query the temperature of the controller, expander
module, or host port module.

Example
Query the temperature of the controller.
OceanStor: admin> showtemperature -t 0
Controller board temperature information:
CPU(°C) South bridge(°C) North bridge(°C) Air inlet(°C)
32 32 36 33

4.1.4 showvoltage

Function
The command showvoltage is used to query the voltage of the controller or expander module.

Format
showvoltage -t type

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 4-5


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
4 System Management Commands Command Reference

Parameters
Keyword and Value Description Default Value

-t type The object to be queried. The None.


value can be 0 or 1.
l 0: The controller.
l 1: The expander module.

Modes
Normal mode.

Level
Super administrator level, administrator level and guest level.

Usage Guidelines
The command showvoltage is used to query the voltage of the controller or expander module.

Example
Query the voltage of the controller.
OceanStor: admin> showvoltage -t 0
Controller board voltage information:
Power supply(V) South/north bridge chip(V) Memory(V) CPU kernel(V)
11.9 1.2 1.2 1.2

4.1.5 showsn

Function
The command showsn is used to query the serial number of the device.

Format
showsn

Parameters
None.

Modes
Normal mode.

Level
Super administrator level, administrator level and guest level.

4-6 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 4 System Management Commands

Usage Guidelines
The command showsn is used to query the serial number of the device.

Example
Query the serial number of the device.
OceanStor: admin> showsn
Subrack ID Serial Number
0 21023151270000002655
1 37567384

4.1.6 showlicense

Function
showlicense is used to query license, including the total and the used number of the license
which the system supports.

Format
showlicense

Parameters
None.

Modes
Normal mode.

Level
Super administrator level, administrator level and guest level.

Usage Guidelines
showlicense is used to query licenses for basic service and valued-added service, such as disk
license and LUN license.

Example
Query the license of the device.
OceanStor: admin> showlicense
============================================
License Information
--------------------------------------------
Used LUN Mapping License | 1
Total LUN Mapping License | 48
Used Disk License | 4
Total Disk License | 84
============================================

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 4-7


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
4 System Management Commands Command Reference

4.2 Controller Configuration Commands


The controller configuration commands are used to set the status of the controller to offline, and
to query the information about the controller.

4.2.1 offline
4.2.2 showctrlinfo

4.2.1 offline

Function
The command offline is used to disable the services of the controller.

Format
offline -c controller ID

Parameters
Keyword and Value Description Default Value

-c controller ID The controller ID. The value None.


is A or B, and is case
insensitive.

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
When using this command, note the following items:
l For a storage system configured with two controllers, the command is used when the system
works properly.
l For a storage system configured with one controller, the command cannot be used.

Example
Disable the services of controller A.

OceanStor: admin> offline -c a

4-8 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 4 System Management Commands

the impact of this operation is great!


do you want to continue? y or n: y
the command has been sent, please wait...

4.2.2 showctrlinfo

Function
The command showctrlinfo is used to query the information about all online controllers.

Format
showctrlinfo [ -c controller ID ]

Parameters
Keyword and Value Description Default Value

-c controller ID The controller ID. The value None.


is A or B, and is case
insensitive.

Modes
Normal mode and upgrade mode.

Level
Super administrator level, administrator level and guest level.

Usage Guidelines
When using this command, note the following items:
l The command showctrlinfo is used to query the information about all online controllers.
l The command showctrlinfo -c controller ID is used to query the information about a
specified online controller.

Example
Query the information about all online controllers.

OceanStor: admin> showctrlinfo


===============================================
Controller Information
-----------------------------------------------
Controller | A
CPU Utility(%) | 3
Master Status | Master
IP Address for Management | 129.26.10.31
Running Status | Normal
Software Version | 1.04.01.101.T09
===============================================

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 4-9


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
4 System Management Commands Command Reference

===============================================
Controller Information
-----------------------------------------------
Controller | B
CPU Utility(%) | 4
Master Status | Slave
IP Address for Management | 129.26.10.32
Running Status | Normal
Software Version | 1.04.01.101.T09
===============================================

4.3 File Management Command


File management command is used to download the alarms and logs on the storage system.

4.3.1 exportalm

4.3.1 exportalm

Function
The command exportalm is used to export alarm logs or logs.

Format
exportalm -i host IP address -u user name -p password -f file directory -t type

Parameters

Keyword and Value Description Default Value

-i host IP address The IP address of the FTP None.


server. It is requested that the
FTP server can access the
storage network system.

-u user name The user name of the FTP None.


server.

-p password The password of the FTP None.


server.

-f file directory The path that stores the alarm None.


file on the FTP server.

-t type The type of the logs. The None.


value can be 1 or 2.
l 1: Exports alarm logs.
l 2: Exports logs.

4-10 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 4 System Management Commands

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
When using this command, note the following items:

l Because the system automatically names the file of exported logs, you are not recommended
to store the file of exported logs under the specified directory; otherwise, files with the
same name are overwritten.
l Before you run this command, ensure that the FTP service is enabled on the FTP server.

Example
Download logs. The IP address of the FTP server is 10.10.10.1. The user name is root, and the
password is 123456. The log file is stored in the path /home/ISM.
OceanStor: admin> exportalm -i 10.10.10.1 -u root -p 123456 -f /home/ISM -t 1

4.4 Configuration Management Commands


The configuration management commands are used to export the debug information, system
configuration information, and to import and export the configuration file.

4.4.1 exportcofferdb
4.4.2 exportblackbox
4.4.3 exportconf
4.4.4 importconf
4.4.5 exportstat

4.4.1 exportcofferdb

Function
The command exportcofferdb is used to export the data of the configuration file from the coffer.

Format
exportcofferdb -i host IP address -di coffer disk ID -u user name -p password -f file

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 4-11


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
4 System Management Commands Command Reference

Parameters

Keyword and Value Description Default Value

-i host IP address The IP address of the FTP None.


server. It is requested that the
FTP server can access the
storage network.

-di cofferdisk ID The location of the None.


configuration file stored in
the coffer. The value ranges
from 0 to 3:
l 0: The coffer disk stored in
slot 0.
l 1: The coffer disk stored in
slot 1.
l 2: The coffer disk stored in
slot 2.
l 3: The coffer disk stored in
slot 3.
NOTE
When the storage system is in
the normal state, the
configuration files stored in the
coffer disks in slots 0, 1, 2, and
3 are the same. When the
configuration files are different,
the storage system switches to
the safe mode. It is
recommended to back up the
configuration files periodically.
When the system fails, you can
restore the settings of the
system by using the
importconf command. For
details on the importconf
commands, see 4.4.4
importconf.

-u user name The user name of the FTP None.


server.

-p password The user password of the FTP None.


server.

-f file The path where the alarm file None.


is stored on the FTP server,
and the file name.

Modes
Normal mode and safe mode.

4-12 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 4 System Management Commands

Level
Super administrator level and administrator level.

Usage Guidelines
When using this command, note the following items:

l Ensure that the configuration file is a .dat file; otherwise, the data of the configuration file
cannot be imported into the system.
l Before you run this command, ensure that the FTP service is enabled on the FTP server.

Example
Export the data of the configuration file from the coffer in slot 3. The IP address of the FTP
server is 10.10.10.1. The data of the configuration file is stored in cofferdb.dat in /home/temp/.
The FTP user name is root, and the password is adfjla.

OceanStor: admin> exportcofferdb -i 10.10.10.1 -di 3 -u root -p adfjla -f /home/


temp/cofferdb.dat

4.4.2 exportblackbox

Function
The command exportblackbox is used to export the debugging information from the black box.

Format
exportblackbox -i host IP address -u user name -p password -f file

Parameters

Keyword and Value Description Default Value

-i host IP address The IP address of the FTP None.


server. It is requested that the
FTP server can access the
storage network.

-u user name The user name of the FTP None.


server.

-p password The user password of the FTP None.


server.

-f file The path where the None.


debugging information is
stored on the FTP server, and
the file name.

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 4-13


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
4 System Management Commands Command Reference

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
When using this command, note the following items:

l It is recommended that the file is a .tgz file.


l Before you run this command, ensure that the FTP service is enabled on the FTP server.
NOTE

When a fault or an exception occurs in the system, the debugging information stored in the black box helps
maintenance personnel to determine the fault and analyze the cause.

Example
Export the debugging information from the black box and save it on the FTP server with the IP
address 10.10.10.1. The debugging information is saved in information.tgz in /home/temp/. The
FTP user name is root, and the password is adfjla.

OceanStor: admin> exportblackbox -i 10.10.10.1 -u root -p adfjla -f /home/temp/


information.tgz

4.4.3 exportconf

Function
The command exportconf is used to export the data of the configuration file from the memory.

Format
exportconf -i host IP address -u user name -p password -f file

Parameters

Keyword and Value Description Default Value

-i host IP address The IP address of the FTP None.


server. It is requested that the
FTP server can access the
storage network system.

-u user name The user name of the FTP None.


server.

-p password The user password of the FTP None.


server.

4-14 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 4 System Management Commands

Keyword and Value Description Default Value

-f file The path of the configuration None.


file that is stored on the FTP
server, and the file name.

Modes
Normal mode and safe mode.

Level
Super administrator level and administrator level.

Usage Guidelines
When using this command, note the following items:
l Ensure that the configuration file is a .dat file; otherwise, the data of the configuration file
cannot be imported into the system.
l When you run this command, ensure that the FTP service is enabled on the FTP server.

Example
Export the data of the configuration file. The IP address of the FTP server is 10.10.10.1. The
user name is root, and the password is 123456. The configuration file, configurefile.dat , is stored
in the path /home/ISM.

OceanStor: admin> exportconf -i 10.10.10.1 -u root -p 123456 -f /home/ISM/


configurefile.dat

4.4.4 importconf

Function
The command importconf is used to import the data of the configuration file.

Format
importconf -i host IP address -u user name -p password -f file

Parameters
Keyword and Value Description Default Value

-i host IP address The IP address of the FTP None.


server. It is requested that the
FTP server can access the
storage network system.

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 4-15


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
4 System Management Commands Command Reference

Keyword and Value Description Default Value

-u user name The user name of the FTP None.


server.

-p password The user password of the FTP None.


server.

-f file The path of the configuration None.


file that is stored on the FTP
server, and the file name.

Modes
Normal mode and safe mode.

Level
Super administrator level and administrator level.

Usage Guidelines
When using this command, note the following items:
l The file is a .dat file.
l Importconf is not allowed when LUN is formatting.
l The command importconf can be used only on the primary controller.
l When you run this command, ensure that the FTP service is enabled on the FTP server.

Example
Import the data of the configuration file. The IP address of the FTP server is 10.10.10.1. The
user name is root, and the password is 123456. The configuration file, configurefile.dat, is stored
in the path /home/ISM.
OceanStor: admin> importconf -i 10.10.10.1 -u root -p 123456 -f /home/ISM/
configurefile.dat
if the file is imported, the system will be restarted!
do you want to continue? y or n: y
the system is going to reboot...

4.4.5 exportstat

Function
The command exportstat is used to export the configuration information from the system. The
configuration file is a readable .txt file.

Format
exportstat -i host IP address -u user name -p password -f file

4-16 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 4 System Management Commands

Parameters
Keyword and Value Description Default Value

-i host IP address The IP address of the FTP None.


server. It is requested that the
FTP server can access the
storage network system.

-u user name The user name of the FTP None.


server.

-p password The user password of the FTP None.


server.

-f file The path of the configuration None.


file that is stored on the FTP
server, and the file name.

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
When using this command, note the following items:
l This command exports the configuration information in readable file mode. The file,
however, cannot import configuration information.
l When you run this command, ensure that the FTP service is enabled on the FTP server.

Example
Query the configuration information about the system. The IP address of the FTP server is
10.10.10.1. The user name is root, and the password is 123456. The system configuration file,
configurefile.txt, is stored in the path /home/ISM.

OceanStor: admin> exportstat -i 10.10.10.1 -u root -p 123456 -f /home/ISM/


configurefile.txt

4.5 Statistics Management Commands


The performance statistics management commands are used to make statistics upon performance
based on the interfaces or LUNs, and they are also used to clear the error codes on the FC host
ports.

4.5.1 showstatswitch

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 4-17


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
4 System Management Commands Command Reference

4.5.2 chgstatswitch
4.5.3 statperf
4.5.4 statres
4.5.5 staterr
4.5.6 cleanerr

4.5.1 showstatswitch

Function
The command showstatswitch is used to query the status of system performance statistics.

Format
showstatswitch

Parameters
None.

Modes
Normal mode.

Level
Super administrator level, administrator level and guest level.

Usage Guidelines
The command showstatswitch is used to query the status of system performance statistics.

Example
Query the status of system performance statistics.

OceanStor: admin> showstatswitch


Statistic status: Open

4.5.2 chgstatswitch

Function
The command chgstatswitch is used to set the status of the system performance statistics.

Format
chgstatswitch -c | -o

4-18 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 4 System Management Commands

Parameters

Keyword and Value Description Default Value

-c Disables the performance None.


statistics of the system.

-o Enables the performance None.


statistics of the system.

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
The command chgstatswitch is used to set the status of the system performance statistics.

Example
Disable system performance statistics.

OceanStor: admin> chgstatswitch -c

4.5.3 statperf

Function
The command statperf is used to collect performance statistics of the system.

Format
statperf [ -p -t type ] | -l -i LUN/Port ID

Parameters

Keyword and Value Description Default Value

-p Collect port-based None.


performance statistics.

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 4-19


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
4 System Management Commands Command Reference

Keyword and Value Description Default Value

-t type The port type. The value can None.


be 1, 2 or 3:
l 1 stands for FC host ports.
l 2 stands for iSCSI host
ports.
l 3 stands for SAS host
ports.

-l Collects LUN-based None.


performance statistics.

-i LUN/port ID The LUN ID or port ID. None.


l The LUN ID. The value
ranges from 0 to 511.
l The port ID.
– For S2600F and
S2600i, the value
ranges from 0 to 7 (port
0~3 belong to controller
A and port 4~7 belong
to controller B.)
l For S2600S, the value
ranges from 0 to 3 (port 0
and 1 belong to controller
A, port 2 and 3 belong to
controller B.)
l For S2600C, the value can
be 0, 1, 4 and 5 (port 0 and
1 belong to controller A,
port 4 and 5 belong to
controller B.)

Modes
Normal mode.

Level
Super administrator level, administrator level and guest level.

Usage Guidelines
When using this command, note the following items:

l Before running the command, ensure that the performance statistics of the system is
enabled.

4-20 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 4 System Management Commands

l The command statperf -l -i LUN ID is used to collect LUN ID-based performance statistics
of the system.
l The command statperf -p -t type -i Port ID is used to collect port-based performance
statistics of the system.

Example
Collect LUN 0-based performance statistics of the system.

OceanStor: admin> statperf -l -i 0


================================================
Performance Statistic Information
------------------------------------------------
Total IO Number | 0
Read IO Rate(%) | 0
Write IO Rate(%) | 0
Current Bandwidth(MB/s) | 0
Max Bandwidth(MB/s) | 0
Current IOPS(IO/s) | 0
Max IOPS(IO/s) | 0
Cache Hit(%) | 0
Local Cache(%) | 0
Mirror Cache(%) | 0
================================================

4.5.4 statres

Function
The command statres is used to collect statistics on cache usage.

Format
statres [ -c controller ID ]

Parameters

Keyword and Value Description Default Value

-c controller ID The controller ID. The value None.


is A or B, and is case
insensitive.

Modes
Normal mode.

Level
Super administrator level, administrator level and guest level.

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 4-21


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
4 System Management Commands Command Reference

Usage Guidelines
The command statres is used to collect statistics on cache usage.

Example
Collect statistics on cache usage.
OceanStor: admin> statres
Controller 4KUsage(%) ChunkUsage(%)
A 4 0
B 4 0

4.5.5 staterr

Function
The command staterr is used to display the link status of Fiber Channel (FC) host ports, Internet
Small Computer Systems Interface (iSCSI) host ports, or mini Serial Attached SCSI (mini SAS)
host ports, collect statistics on error codes, and query the performance of front-end host ports.

Format
staterr -c controller ID -f | -i | -s

Parameters

Keyword and Value Description Default Value

-c controller ID The controller ID. The value None.


is A or B, and is case
insensitive.

-f Collect statistics on error None.


codes of FC host ports.

-i Collect statistics on error None.


codes of iSCSI host ports.

-s Collect statistics on error None.


codes of the mini SAS host
ports.

Modes
Normal mode.

Level
Super administrator level, administrator level and guest level.

4-22 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 4 System Management Commands

Usage Guidelines
When using this command, note the following items:

l The command staterr -c controller ID -f is used to collect statistics on error codes of the
FC host ports on a specified controller.
l The command staterr -c controller ID -i is used to collect statistics on error codes of the
iSCSI host ports on a specified controller.
l The command staterr -c controller ID -c is used to collect statistics on error codes of the
mini SAS host ports on a specified controller.

Example
Collect statistics on error codes of the FC host ports on controller A.

OceanStor: admin> staterr -c a -f


Controller Port ID Link Status LSGENum BRCENum LSYNum LFENum
StartTime
A 00 Connected 1 765 255 1
2009-08-25 08:43:12
A 01 Connected 1 765 255 1
2009-08-25 08:43:12
A 02 Connected 1 765 255 1
2009-08-25 08:43:12
A 03 Connected 5 771 255 1
2009-08-25 08:43:12

4.5.6 cleanerr

Function
The command cleanerr is used to clear the error codes of the FC host ports and restart the
statistics of error codes.

Format
cleanerr [ -c controller ID ]

Parameters

Keyword and Value Description Default Value

-c controller ID The controller ID. The value None.


is A or B, and is case
insensitive.

Modes
Normal mode.

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 4-23


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
4 System Management Commands Command Reference

Level
Super administrator level and administrator level.

Usage Guidelines
When using this command, note the following items:
l The command cleanerr is used to clear the error codes of all the FC host ports.
l The command cleanerr -c controller ID is used to clear the error codes of the FC host ports
on a specified controller.
NOTE

This command is only applicable to FC host interfaces in the storage system.

Example
Clear the error codes of FC host ports on controller A.

OceanStor: admin> cleanerr -c a

4.6 Software Upgrade Commands


Software upgrade commands are used to upgrade the system software and SCSI Enclosure
Services (SES) Fiemware version.

4.6.1 upgradesys
4.6.2 synchronize
4.6.3 showsesmac
4.6.4 showsesversion
4.6.5 upgradeses

4.6.1 upgradesys

Function
The command upgradesys is used to upgrade the system software.

Format
upgradesys -i host IP address -u user name -p password -f file [ -force ]

4-24 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 4 System Management Commands

Parameters

Keyword and Value Description Default Value

-i host IP address The IP address of the FTP None.


Server. It is requested that the
FTP Server can access the
storage network.

-u user name The user name of the FTP None.


server.

-p password The password of the FTP None.


server.

-f file The path of the upgrade file None.


that is stored on the FTP
Server, and the file name.

-force Mandatory upgrade. None.

Modes
Normal mode, safe mode, and upgrade mode.

Level
Super administrator level and administrator level.

Usage Guidelines

Example
Upgrade the storage system software.

Log in to the current secondary controller of the system. The IP address of the FTP Server is
10.10.10.1. The user name is root, and the password is 123456. The upgrade file,
ISM_20081218.tgz, is stored in the path /home/.

OceanStor: admin> upgradesys -i 10.10.10.1 -u root -p 123456 -f /home/


ISM_20081218.tgz
if the software is imported, the system will be restarted.
do you want to continue? y or n y
system is going to upgrade...

Run the command synchronize on the primary controller to synchronize the latest version to it.

OceanStor: admin> synchronize

4.6.2 synchronize

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 4-25


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
4 System Management Commands Command Reference

Function
The command synchronize is used to synchronize the system software.

Format
synchronize

Parameters
None.

Modes
Normal mode, safe mode, and upgrade mode.

Level
Super administrator level and administrator level.

Usage Guidelines
The command synchronize is used to synchronize the system software. When the system in
dual-controller mode, you should run the command upgradesys to upgrade the system software
on the secondary controller first. After upgraded, the secondary controller is automatically reset.
Then run the command synchronize on the primary controller to synchronize the latest version
to it.

Example
Synchronize the system software.

OceanStor: admin> synchronize

4.6.3 showsesmac

Function
The command showsesmac is used to query the SES version's MAC address about the controllers
or the expander modules.

Format
showsesmac

Parameters
None.

Modes
Normal mode.

4-26 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 4 System Management Commands

Level
Administrator level and guest level.

Usage Guidelines
None.

Example
Query the SES version's MAC address about all controllers and expander modules.
OceanStor: admin> showsesmac
Subrack ID MAC Address
0 00:18:82:f3:15:52

4.6.4 showsesversion

Function
The command showsesversion is used to query the SES Firmware version about the controllers
or the expander modules.

Format
showsesversion [ -s subrack ID [ -i board ID ] ]

Parameters

Keyword and Value Description Default Value

-s subrack ID The enclosure ID. None.


The value ranges from 0 to 7.

-i board ID The ID of the controller or the None.


expander module.
The value can be 0 or 1.

Modes
Normal mode.

Level
Super administrator level, administrator level and guest level.

Usage Guidelines
When using this command, note the following items:

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 4-27


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
4 System Management Commands Command Reference

l The command showsesversion is used to query the SES versions about all controllers and
expander modules.
l The command showsesversion -s subrack ID -i board ID is used to query the SES version
about a specified controller or expander module of a specified enclosure.

Example
Query the SES versions about all controllers and expander modules.
OceanStor: admin> showsesversion
Subrack ID Board ID Version
0 0 S008
0 1 S008

4.6.5 upgradeses

Function
The command upgradeses is used to upgrade the SES firmware software.

Format
upgradeses -i host IP address -u user name -p password -f file

Parameters

Keyword and Value Description Default Value

-i host IP address The IP address of the FTP None.


Server. It is requested that the
FTP Server can access the
storage network system.

-u user name The user name of the FTP None.


server.

-p password The password of the FTP None.


server.

-f file The path of the SES package None.


that is stored on the FTP
Server, and the file name.

Modes
Normal mode, safe mode, and upgrade mode.

Level
Super administrator level and administrator level.

4-28 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 4 System Management Commands

Usage Guidelines
When using this command, note the following items:

l In dual-controller storage system, the command upgradeses can only be used on the
primary controller.
l Ensure that the FTP service is enabled on the remote server for login.
l Before you run this command, ensure that the FTP service is enabled on the FTP Server.

Example
Upgrade SES Firmware. The IP address of the FTP Server is 10.10.10.1. The user name of the
FTP server is admin, and the password is 123456. The upgrade file, ISM.tar, is stored in the
path /home/.

OceanStor: admin> upgradeses -i 10.10.10.1 -u admin -p 123456 -f /home/ISM.tar


Are you sure to upgrade SES? y or n y

4.7 Primary/Secondary Switchover Commands


Primary/Secondary switchover commands are used to set the state for system swapping and
query the system swapping state of the controller that the user logs in to.

4.7.1 swapsys
4.7.2 showmaster

4.7.1 swapsys

Function
The command swapsys is used to switch the state of the primary/secondary controller.

Format
swapsys

Parameters
None.

Modes
Normal mode and upgrade mode.

Level
Super administrator level and administrator level.

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 4-29


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
4 System Management Commands Command Reference

Usage Guidelines
When using this command, note the following items:

l The command swapsys can be used only when the storage system is in dual-controller
mode and it's two controllers are in the normal state.
l The interval between two operations of the swapsys command is at least ten seconds.

Example
Switch over the primary controller to the secondary controller.

OceanStor: admin> swapsys


This operation will affect services.
Do you want to continue? y or n: y
The command has been sent, please wait...

4.7.2 showmaster

Function
The command showmaster is used to query the primary and secondary state of the controller
that the user logs in to.

Format
showmaster

Parameters
None.

Modes
Normal mode.

Level
Super administrator level, administrator level and guest level.

Usage Guidelines
The command can be used only when the storage system is in dual-controller mode and it's two
controllers are in the normal state.

Example
Query the primary and secondary state of the controller that the user admin logs in to.

OceanStor: admin> showmaster


the controller you log in is master controller!

4-30 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 4 System Management Commands

4.8 System Reset Command


System reset command is used to reset the system.

4.8.1 resetsys

4.8.1 resetsys

Function
The command resetsys is used to reset the system.

Format
resetsys [ -f ]

Parameters

Keyword and Value Description Default Value

-f The system is reset in None.


mandatory mode.

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
When using this command, note the following items:

l The command resetsys is used to reset the system in general mode.


l The command resetsys -f is used to reset the system in mandatory mode.

Example
Reset the system.
OceanStor: admin> resetsys
the system will be reset and restarted, which will cause temporary service
interruption!
do you want to continue? y or n: y
the system is going to be reset, please wait...

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 4-31


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
4 System Management Commands Command Reference

4.9 System Time Changing Command


System time changing command is used to change the system time.

4.9.1 chgsystime

4.9.1 chgsystime

Function
The command chgsystime is used to change the system time.

Format
chgsystime -t time string

Parameters

Keyword and Value Description Default Value

-t time string The system time. The format None.


is yyyy-mm-dd/hh:mm:ss,
and the items is described as
follows:
l yyyy: stands for year
l mm: stand for month
l dd: stands for day
l hh: stands for hour
l mm: stands for minute
l ss: stands for second

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
The command chgsystime is used to change the system time. The time ranges from 1970-01-01
00:00:00 to 2069-12-31 23:59:00.

4-32 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 4 System Management Commands

Example
Change the system time to 2008-12-17/11:05:00.

OceanStor: admin> chgsystime -t 2008-12-17/11:05:00

4.10 CHAP Setting Command


CHAP setting command is used to create, change, delete, and query CHAP user.

4.10.1 chap

4.10.1 chap

Function
The command chap is used to set CHAP-related functions for iSCSI host ports.

Format
chap { -adduser -user username -password password |-adduser -initiator initiator name -
user username |-chgpassword -user username -password password |-showuser [ -initiator
initiator name ] |-deluser [ -initiator initiator name] -user username1...usernameN | -
showinitiator [ -user username | -free ] |-chgchapuser -initiator initiator name1...initiator
nameN -status { START | STOP } |-addinitiator -initiator initiator name1 ...initiator
nameN |-delinitiator -initiator initiator name1 ...initiator nameN }

Parameters

Keyword and Value Description Default Value

-adduser -user username - The command provides the None.


password password functions of adding a CHAP
user and setting the
password.
l -user username:
CHAP user name. The
name contains 4 to 25
characters, including
numbers, letters,
underscores, and hyphens.
The first character must be
a letter.
l -password password:
The password. It contains
12 to 16 characters.

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 4-33


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
4 System Management Commands Command Reference

Keyword and Value Description Default Value

-adduser -initiator initiator The command provides the None.


name -user username function of adding created
CHAP user to a specified
iSCSI host port.
l -initiator initiator name:
The name of the iSCSI
host port.
l -user username:
CHAP user name. The
name contains 4 to 25
characters, including
numbers, letters,
underscores, and hyphens.
The first character must be
a letter.

-chgpassword -user The command provides the None.


username -password function of changing the
password password.

-showuser [ -initiator initiator The command queries None.


name ] created CHAP user names or
the CHAP user names for a
specified iSCSI host port.
l -initiator initiator name:
The name of the iSCSI
host port.
l -showuser: queries
created CHAP user names.
NOTE
chap -showuser -initiator
initiator name: queries the
CHAP user name for a specified
iSCSI host port.

4-34 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 4 System Management Commands

Keyword and Value Description Default Value

-deluser [ -initiator initiator The command deletes the None.


name ] -user CHAP user for a specified
username1...usernameN iSCSI host port or deletes the
system CHAP user.
l -initiator initiator name:
The name of the iSCSI
host port.
l -user
username1...usernameN:
CHAP user name. The
name contains 4 to 25
characters, including
numbers, letters,
underscores, and hyphens.
The first character must be
a letter. You can enter
multiple names at a time.
NOTE
l chap -deluser -initiator
initiator name -user
username1...usernameN:
deletes the CHAP user for a
specified iSCSI host port.
l chap -deluser -user
username1...usernameN:
deletes the CHAP user of the
storage system.

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 4-35


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
4 System Management Commands Command Reference

Keyword and Value Description Default Value

-showinitiator [ -user Provides the function for None.


username | -free ] querying the CHAP setting
for an iSCSI host port.
l -user username:
CHAP user name. The
name contains 4 to 25
characters, including
numbers, letters,
underscores, and hyphens.
The first character must be
a letter.
l -free:
The CHAP setting is not
enabled.
NOTE
l chap -showinitiator:
queries whether the CHAP
setting for an iSCSI host port
is enabled.
l chap -showinitiator -user
username: queries the
information about all
interfaces corresponding to
a specified CHAP user
name.
l chap -showinitiator -free:
queries the information
about an iSCSI host port of
which the CHAP setting is
not enabled.

-chgchapuser -initiator Enables or disables the None.


initiator name1...initiator CHAP setting for an iSCSI
nameN -status { START | host port.
STOP } l -initiator initiator
name1...initiator nameN:
The name of the iSCSI
host port .
l -status { START |
STOP } :
START means to enable
the CHAP setting. STOP
means to disable the
CHAP setting.

4-36 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 4 System Management Commands

Keyword and Value Description Default Value

-addinitiator -initiator Adds an iSCSI host port. None.


initiator name1 ...initiator -initiator initiator
nameN name1 ...initiator nameN
indicates the name of an
iSCSI host port to be added.
You can enter multiple
names at a time.

-delinitiator -initiator Deletes a specified iSCSI None.


initiator name1 ...initiator host port.
nameN -initiator initiator
name1 ...initiator nameN
indicates the name of an
iSCSI host port to be deleted.
You can enter multiple
names at a time.

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
The command chap is used to set CHAP-related functions for iSCSI host ports.

NOTE

The command sets can be used only when the storage system uses the S2600i or S2600C controller
enclosure.

Example
Add a CHAP user. Set the name to chap1 and the password to 1234567890123.

OceanStor: admin> chap -adduser -user chap1 -password 1234567890123


Are you sure to create the CHAP user(y/n)?y

4.11 TrapIP Management Commands


TrapIP management commands are used to manage the Trap IP.

4.11.1 showtrapip
4.11.2 addtrapip
4.11.3 deletetrapip

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 4-37


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
4 System Management Commands Command Reference

4.11.4 chgtrapip

4.11.1 showtrapip

Function
The command showtrapip is used to query the information about a Trap IP.

Format
showtrapip [-i index]

Parameters

Keyword and Value Description Default Value

-i index The index of a Trap IP None.


The value ranges from 0 to 3.

Modes
Normal mode.

Level
Super administrator level, administrator level and guest level.

Usage Guidelines
l Enter showtrapip to query the information of all Trap IPs, including the index number, IP
address, port number, and version number.
l Enter showtrapip -i index to query the information of a designated Trap IP, including the
IP address, port number, and version number.

Example
Query the information about the Trap IP.

OceanStor: admin> showtrapip


Index IP Address Port ID Version
0 129.24.11.81 167 SNMPv1
1 129.24.11.82 167 SNMPv1
2 129.24.11.83 167 SNMPv1
3 129.24.11.84 167 SNMPv1

4.11.2 addtrapip

4-38 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 4 System Management Commands

Function
The command addtrapip is used to add a Trap IP.

Format
addtrapip -p port ID -a IP address -v version

Parameters
Keyword and Value Description Default Value

-p port ID The port ID of Trap IP None.


The value ranges from 1 to
65535.

-a IP address The Trap IP address None.

-v version The version number of Trap None.


IP
The value can be 1 or 2.

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
Add four Trap IPs at most.

Example
Add a Trap IP. The port ID of the Trap IP is 2234, the IP address is 129.16.101.127, and the
version number is 1
OceanStor: admin> addtrapip -p 2234 -a 129.16.101.127 -v 1

4.11.3 deletetrapip

Function
The command deletetrapip is used to delete a Trap IP.

Format
deletetrapip -i index

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 4-39


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
4 System Management Commands Command Reference

Parameters
Keyword and Value Description Default Value

-i index The index of the Trap IP to be None.


deleted.
The value ranges from 0 to
3, which can be obtained
through the command
showtrapip.

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
None.

Example
Delete the Trap IP whose index is 1.

OceanStor: admin> deletetrapip -i 1

4.11.4 chgtrapip

Function
The command chgtrapip is used to modify the information about a designated Trap IP.

Format
chgtrapip -i index [-p port ID][-a IP address][-v version]

4-40 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 4 System Management Commands

Parameters

Keyword and Value Description Default Value

-i index The index of the Trap IP to be None.


deleted
The value ranges from 0 to
3, which can be obtained
through the command
showtrapip.

-p port ID The port ID of the Trap IP None.


The value ranges from 1 to
65535.

-a IP address The address of the Trap IP. None.

-v version The version number of the None.


Trap IP
The value can be 1 or 2.

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
When using the command chgtrapip, the parameter -i is indispensable, and at least one
parameter of -p, -a and -v must be entered.

Example
Modify the port ID of the Trap IP whose index is 1 to 210.

OceanStor: admin> chgtrapip -i 1 -p 210

4.12 Command of Clearing the DB Configuration of the


Coffer
Command of clearing the DB configuration of the coffer is used to clear the DB configuration
of the coffer.

4.12.1 cleancofferdb

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 4-41


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
4 System Management Commands Command Reference

4.12.1 cleancofferdb

Function
The command cleancofferdb is used to clear the DB configuration of a coffer.

Format
cleancofferdb

Parameters
None.

Modes
Normal mode and safe mode.

Level
Super administrator level and administrator level.

Usage Guidelines
When using this command, note the following items:

l On a storage system in dual-controller mode, this command can be used only on the primary
controller.
l Perform this operation with caution, because the command will clear all the configuration
data in the storage system.
l After you enter this command, the system prompts you to enter the password. The default
password is 654321.
l The system will restart automatically after executing the cleancofferdb command.

Example
Clear the DB configuration of a coffer.

OceanStor: admin> cleancofferdb


Enter Password:
this operation will lead to clean up the DB configuration!
do you want to continue? y or n: y

4.13 Version Information Query Command


Version information query command is used to query the version information of the storage
system, including software version, product version, SES version, and logic version.

4.13.1 showallver

4-42 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 4 System Management Commands

4.13.1 showallver

Function
The command showallver is used to query the version information.

Format
showallver

Parameters
None.

Modes
Normal mode.

Level
Super administrator level, administrator level and guest level.

Usage Guidelines
The command showallver is used to query the version information. The version information
includes software version information, product version information, SES version information,
logic version information and SAS version information.

Example
Query the version information.

OceanStor: admin> showallver


=================================================
Software Version:
Controller Software Version
A 1.04.02.101.T01
B 1.04.02.101.T01
-------------------------------------------------
Product Version:
V100R002C01
-------------------------------------------------
SES Version:
Subrack ID Board ID SES Version
0 0 S022
0 1 S022
------------------------------------------------
Logic Version:
Controller Logic Version
A 230T02
B 230T02
-------------------------------------------------
SAS Version:
Controller Port ID Mode FirmwareVersion
A 02 Initiator 007
A 03 Initiator 007
B 02 Initiator 007

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 4-43


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
4 System Management Commands Command Reference

B 03 Initiator 007
=================================================

4.14 Mirroring Information Query Commands


Mirroring information query commands are used to query the mirroring information.

4.14.1 showmirror

4.14.1 showmirror

Function
The command showmirror is used to query whether a specified LUN is mirrored.

Format
showmirror -i lun id

Parameters

Keyword and Value Description Default Value

-i lun id The ID of the LUN to be None.


queried. The value is an
integer, ranging from 0 to
511.

Modes
Normal mode.

Level
Super administrator level, administrator level and guest level.

Usage Guidelines
The command showmirror is used to query whether a specified LUN is mirrored.

Example
Query whether LUN 1 is mirrored.

OceanStor: admin> showmirror -i 1


MIRROR RESULT: MIRROR

4-44 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 5 Device Management Commands

5 Device Management Commands

About This Chapter

Device management commands are used to configure and query the device information of the
storage system.

5.1 Disk Enclosure Configuration Commands


Disk enclosure configuration commands are used to query the disk enclosure information ,
change the disk enclosure ID, and delete the disk enclosure.
5.2 Disk Management Commands
Disk management commands are used to manage disks.
5.3 Controller Management Commands
The controller management commands are used to manage the controller.
5.4 Hibernation Management Commands
Hibernation management commands are used to manage the hibernation of the components.
5.5 Command of Querying the Information About a Host Port Module
Command of querying the information about a host port module is used to query the information
about the host port module.
5.6 Expander Module Management Command
Expander module management command is used to manage the expander module.
5.7 UPS Information Query Commands
UPS information query commands are used to query the UPS information.
5.8 Command of Managing the Power Supply Information
Command of managing the power supply information is used to manage the information about
power supply.
5.9 Power off the device command
The command is used to power off the device.
5.10 BBU Information Query Command
BBU information query command is used to query the information about BBU.
5.11 Command of Querying the Fan Group Information

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 5-1


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
5 Device Management Commands Command Reference

Command of querying the fan group information is used to query the information about the fan
group.
5.12 Commands of Querying the Information About Buzzer Status
Commands of querying the information about buzzer status are used to query the information
about the buzzer status.
5.13 Host Port Configuration Commands
Host port configuration commands are used to configure and query the information about the
host port.

5-2 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 5 Device Management Commands

5.1 Disk Enclosure Configuration Commands


Disk enclosure configuration commands are used to query the disk enclosure information ,
change the disk enclosure ID, and delete the disk enclosure.

5.1.1 showsubrack
5.1.2 deletesubrack

5.1.1 showsubrack

Function
The command showsubrack is used to query the disk enclosure information.

Format
showsubrack [ -s subrack ID ]

Parameters
Keyword and Value Description Default Value

-s subrack ID The ID of a disk enclosure. None.


The value ranges from 0 to 7.

Modes
Normal mode.

Level
Super administrator level, administrator level and guest level.

Usage Guidelines
When using this command, note the following items:
l The command showsubrack is used to query the information about all enclosures of the
system.
l The command showsubrack -s subrack ID is used to query the information about a
specified enclosure.

Example
Query the information about all enclosures.

OceanStor: admin> showsubrack

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 5-3


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
5 Device Management Commands Command Reference

Subrack ID Type Status Temperature(°C) Physical Type Serial


Number
0 Controller Online -- SAS
000000000031

5.1.2 deletesubrack

Function
The command deletesubrack is used to delete a disk enclosure.

Format
deletesubrack -s subrack ID

Parameters
Keyword and Value Description Default Value

-s subrack ID The ID of a disk enclosure. None.


The value ranges from 1 to 7.

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
When using this command, note the following items:
l The command deletesubrack can be used only when the storage system is in dual-
controller mode and it's two controllers are in the normal state.
l The disk enclosure must be in the offline state and have no member disk of a RAID group.

Example
Delete a disk enclosure 1.

OceanStor: admin> deletesubrack -s 1


delete subrack 1? y or n:y

5.2 Disk Management Commands


Disk management commands are used to manage disks.

5.2.1 showdiskinfo

5-4 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 5 Device Management Commands

5.2.2 chgdisklight

5.2.1 showdiskinfo

Function
The command showdiskinfo is used to query the information about disk manufacturers.

Format
showdiskinfo -s subrackid

Parameters
Keyword and Value Description Default Value

-s subrackid The enclosure ID. The value None.


ranges from 0 to 7.

Modes
Normal mode.

Level
Super administrator level, administrator level and guest level.

Usage Guidelines
The command showdiskinfo is used to query the information about disk manufacturers.

Example
Query the manufacturer information about the disks in the controller enclosure.
OceanStor: admin> showdiskinfo -s 0
Subrack ID 0 disk info
DiskID Vendor
0 SEAGATE
1 SEAGATE
2 SEAGATE
3 SEAGATE
4 SEAGATE
5 SEAGATE
6 SEAGATE
7 SEAGATE
8 SEAGATE
9 SEAGATE
10 SEAGATE
11 SEAGATE

5.2.2 chgdisklight

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 5-5


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
5 Device Management Commands Command Reference

Function
The command chgdisklight is used to set the status of the running indicator on a disk.

Format
chgdisklight -o operate code -s subrack id -sl slot id

Parameters

Keyword and Value Description Default Value

-o operate code The operation code. The None.


value can be 0 or 1, and is
described as follows:
l 0: The indicator is off.
l 1: The indicator is on.

-s subrack id The enclosure ID. The value None.


ranges from 0 to 7.

-sl slot id The slot ID of a disk. The None.


value ranges from 0 to 11.

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
The command chgdisklight is used to set the status of the running indicator on a disk.

Example
Set the status of the running indicator on the disk in slot 4, enclosure 0 to be on.

OceanStor: admin> chgdisklight -o 1 -s 0 -sl 4

5.3 Controller Management Commands


The controller management commands are used to manage the controller.

5.3.1 showctrlboard
5.3.2 chgctrlmodel

5-6 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 5 Device Management Commands

5.3.1 showctrlboard

Function
The command showctrlboard is used to query the state information about a controller.

Format
showctrlboard [ -c controller ID ]

Parameters
Keyword and Value Description Default Value

-c controller ID The controller ID. The value None.


is A or B, and is case
insensitive.

Modes
Normal mode.

Level
Super administrator level, administrator level and guest level.

Usage Guidelines
When using this command, note the following items:
l The command showctrlboard is used to query the state information about all controllers.
l The command showctrlboard -c controller ID is used to query the state information about
a specified controller.

Example
Query the state information about all controllers.

OceanStor: admin> showctrlboard


=========================================================================
Controller Board Information
-------------------------------------------------------------------------
Controller Board ID | A
Type | SAS Controller Board
Status | On
Primary Port | Not Connected
UPS Serial Port | Not Connected
Management Serial Port | Not Connected
Network Port | Connected
Heartbeat Port | Connected
Logic Version | 230T02
PCB Version | STE1SCUA VER.C
BIOS Version | T02

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 5-7


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
5 Device Management Commands Command Reference

Electronic Label | /$[ArchivesInfo Version]


| /$ArchivesInfoVersion=3.0
|
|
| [Board Properties]
| BoardType=STE1MCONS
| BarCode=03G015Z094000169
| Item=0303G015
| Description=Main Control Unit
| Manufactured=2009-04-25
| VendorName=Huawei
| IssueNumber=00
| CLEIcode=
| BOM=
=========================================================================
=========================================================================
Controller Board Information
-------------------------------------------------------------------------
Controller Board ID | B
Type | SAS Controller Board
Status | On
Primary Port | Not Connected
UPS Serial Port | Not Connected
Management Serial Port | Not Connected
Network Port | Connected
Heartbeat Port | Connected
Logic Version | 230T02
PCB Version | STE1SCUA VER.C
BIOS Version | T02
Electronic Label | /$[ArchivesInfo Version]
| /$ArchivesInfoVersion=3.0
|
|
| [Board Properties]
| BoardType=STE1MCONS
| BarCode=03G015Z094000123
| Item=0303G015
| Description=Main Control Unit
| Manufactured=2009-04-23
| VendorName=Huawei
| IssueNumber=00
| CLEIcode=
| BOM=
=========================================================================

5.3.2 chgctrlmodel

Function
The command chgctrlmodel is used to set the mode of the controller.

Format
chgcache -m model

5-8 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 5 Device Management Commands

Parameters
Keyword and Value Description Default Value

-m model The mode of the controller. None.


The value is 0 or 1:
l 0: The mode of the
controller is double
controllers fault mode.
l 1: The mode of the
controller is single
controller normal mode. (1
is recommended.)

Modes
Normal mode.

Level
Administrator level.

Usage Guidelines
None.

Example
Set the mode of the controller is single controller normal mode.
OceanStor: admin> chgctrlmodel -m 1

5.4 Hibernation Management Commands


Hibernation management commands are used to manage the hibernation of the components.

5.4.1 chgcomsleep
5.4.2 showcomsleep

5.4.1 chgcomsleep

Function
The command chgcomsleep is used to allow or prohibit hibernation of a component.

Format
chgcomsleep -o operate type -i component id -t component type [ -id idle time ]

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 5-9


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
5 Device Management Commands Command Reference

Parameters
Keyword and Value Description Default Value

-o operate type The operation type. None.


The value can be 1 ,2 or 3 and
is described as follows:
l 0: The component online.
l 1: Prohibit components
from hibernating.
l 2: Allow components
hibernating.

-i compose id The component ID. The None.


value ranges from 0 to 31.

-t compose type The component type. The None.


value is 1, indicating RAID.

5-10 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 5 Device Management Commands

Keyword and Value Description Default Value

-id idle time The wait time before None.


hibernation. When the
components are allowed to
hibernate, if no operation is
performed during the wait
time, the components
hibernate.
The value ranges from 0 to 7
and is described as follows:
l 0: The components
hibernate after 10 minutes
in the case of no
operations.
l 1: The components
hibernate after 30 minutes
in the case of no
operations.
l 2: The components
hibernate after one hour in
the case of no operations.
l 3: The components
hibernate after three hours
in the case of no
operations.
l 4: The components
hibernate after five hours
in the case of no
operations.
l 5: The components
hibernate after twelve
hours in the case of no
operations.
l 6: The components
hibernate after one day in
the case of no operations.
l 7: The components
hibernate after two days in
the case of no operations.

Modes
Normal mode.

Level
Super administrator level and administrator level.

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 5-11


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
5 Device Management Commands Command Reference

Usage Guidelines
When using this command, note the following items:

l If the member disks of a RAID group contains coffer disks, the RAID group cannot be set
to hibernate.
l The RAID groups in abnormal state cannot be set to hibernate.

Example
Set RAID group 0 to hibernate and the wait time to 10 minutes.

OceanStor: admin> chgcomsleep -o 2 -i 0 -t 1 -id 0

5.4.2 showcomsleep

Function
The command showcomsleep is used to query whether components are allowed to hibernate. If
allowed, query whether the components are in hibernation state and the wait time before
hibernation.

Format
showcomsleep [ -i raid id ] -t component type

Parameters

Keyword and Value Description Default Value

-i raid id The RAID ID. The value None.


ranges from 0 to 31.

-t component type The component type. The None.


value can be 1 or 2, and is
described as follows:
l 1: The RAID.
l 2: The disk. -i is
unavailable.

Modes
Normal mode.

Level
Super administrator level, administrator level and guest level.

5-12 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 5 Device Management Commands

Usage Guidelines
The command showcomsleep -t component type is used to query whether all components are
allowed to hibernate. If allowed, query whether the components are in hibernation state and the
wait time before hibernation.

The command showcomsleep -i raid id -t component type is used to query whether specified
component is allowed to hibernate. If allowed, query whether the components are in hibernation
state and the wait time before hibernation.

Example
Query whether the components are allowed to hibernate, If allowed, query whether the
components are in the hibernation state and the wait time before hibernation.

OceanStor: admin> showcomsleep -i 0 -t 1


RAID Id Is Allow Hibernate Hibernate Status Idle Time
0 Yes sleep ten minutes

5.5 Command of Querying the Information About a Host


Port Module
Command of querying the information about a host port module is used to query the information
about the host port module.

5.5.1 showinterface

5.5.1 showinterface

Function
The command showinterface is used to query the information about an host port module.

Format
showinterface [ -c controller ID [ -i interface ID ] ]

Parameters

Keyword and Value Description Default Value

-c controller ID The controller ID. The value None.


is A or B, and is case
insensitive.

-i interface ID The ID of an host port 0.


module.

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 5-13


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
5 Device Management Commands Command Reference

Modes
Normal mode.

Level
Super administrator level, administrator level and guest level.

Usage Guidelines
When using this command, note the following items:
l The command showinterface is used to query the information about all host port modules
in the system.
l The command showinterface -c controller ID is used to query the information about all
host port modules on a specified controller.
l The command showinterface -c controller ID -i interface ID is used to query the
information about a specified host port module on a controller.

Example
Query the information about all host port modules in the system.

OceanStor: admin> showinterface


Controller Interface ID Type Status Port0 Port1
Port2 Port3 PCBVer
A 0 4*FC online Connected Connected Connected
Connected STE1FCHA VER.B
Electronic Label:
[Board Properties]
BoardType=STE1FCHA
BarCode=02G055Z094000017
Item=0302G055
Description=FC Host Interface Card
Manufactured=2009-04-24
VendorName=Huawei
IssueNumber=00
CLEIcode=
BOM=

B 0 4*FC online Connected Connected Connected


Not connected STE1FCHA VER.B
Electronic Label:
[Board Properties]
BoardType=STE1FCHA
BarCode=02G055Z094000038
Item=0302G055
Description=FC Host Interface Card
Manufactured=2009-04-24
VendorName=Huawei
IssueNumber=00
CLEIcode=
BOM=

5.6 Expander Module Management Command


Expander module management command is used to manage the expander module.

5.6.1 showexpboard

5-14 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 5 Device Management Commands

5.6.1 showexpboard

Function
The command showexpboard is used to query the state information about an expander module.

Format
showexpboard [ -s subrack ID [ -i board ID ] ]

Parameters
Keyword and Value Description Default Value

-s subrack ID The ID of an enclosure to None.


which an expander module
belongs. The value ranges
from 0 to 7.

-i board ID The ID of an expander None.


module. The value can be 0
or 1.

Modes
Normal mode.

Level
Super administrator level, administrator level and guest level.

Usage Guidelines
When using this command, note the following items:
l The command showexpboard is used to query the information about all expander modules.
l The command showexpboard -s subrack ID is used to query the information about all
expander modules for a specified enclosure.
l The command showexpboard -s subrack ID -i board ID is used to query the information
about an expander module in a specified enclosure and board.

Example
Query the information about an expander module by specifying its enclosure ID to 1 and board
ID to 1.
OceanStor: admin> showexpboard -s 1 -i 1
=========================================================================
Expander Board Infomation
-------------------------------------------------------------------------

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 5-15


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
5 Device Management Commands Command Reference

Subrack ID | 1
Expander Board ID | 1
Type | SAS Expander Board
Status | Online
Expander Port 0 | Connected
Expander Port 1 | Not Connected
Logic Version | 120T01
PCB Version | STE1DACA VER.B
Electronic Label | [Board Properties]
| BoardType=STE1DACA
| BarCode=02G051Z09C000095
| Item=0302G051
| Description=JBOD controller
| Manufactured=2009-12-10
| VendorName=Huawei
| IssueNumber=00
| CLEICode=
| BOM=
=========================================================================

5.7 UPS Information Query Commands


UPS information query commands are used to query the UPS information.

5.7.1 showupstime
5.7.2 showupsstat

5.7.1 showupstime

Function
The command showupstime is used to query the system time of a UPS.

Format
showupstime -i ups id

Parameters

Keyword and Value Description Default Value

-i ups id The UPS ID. The value can None.


be 0 or 1.

Modes
Normal mode.

Level
Super administrator level, administrator level and guest level.

5-16 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 5 Device Management Commands

Usage Guidelines
The command showupstime is used to query the system time of a UPS.

Example
Query the system time of UPS 1.
OceanStor: admin> showupstime -i 1
Ups 1 System Time: 20090205193459

5.7.2 showupsstat

Function
The command showupsstat is used to query the information about all the states of a UPS.

Format
showupsstat [ -i ups id ]

Parameters
Keyword and Value Description Default Value

-i ups id The UPS ID. The value can None.


be 0 or 1.

Modes
Normal mode.

Level
Super administrator level, administrator level and guest level.

Usage Guidelines
The command showupsstat is used to query the information about all the states of a UPS.

Example
Query the information about all the states of a UPS.
OceanStor: admin> showupsstat
================================================
Ups Id 1 Information
------------------------------------------------
Heathy Status | Normal
Operate Status | OnLine
Enough Time To Write | yes
Discharge Status | No Discharge
Charge Status | Not Average Charge

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 5-17


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
5 Device Management Commands Command Reference

Last Discharge Time | 20090116042710


Version | 00
Manufacture | 1
Protocol Version | HS-S-A01
================================================

5.8 Command of Managing the Power Supply Information


Command of managing the power supply information is used to manage the information about
power supply.

5.8.1 showpowerinfo

5.8.1 showpowerinfo

Function
The command showpowerinfo is used to query the power supply information.

Format
showpowerinfo [ -s subrack id -i power id ]

Parameters

Keyword and Value Description Default Value

-s subrack id The subrack ID. The value None.


ranges from 0 to 7.

-i power id The power ID. The value can None.


be 0 or 1.

Modes
Normal mode.

Level
Super administrator level, administrator level and guest level.

Usage Guidelines
When using this command, note the following items:

l The command showpowerinfo is used to query the information about all power supplies.
l The command showpowerinfo [ -s subrack id -i power id ] is used to query the information
about a specified power supply in an enclosure.

5-18 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 5 Device Management Commands

Example
Query the information about the current power supply in the system.
OceanStor: admin> showpowerinfo
Power Location Status Temperature Vendor Type Version Date
PowerType
(0, 0) Normal N/A DELTA DPS-700EBG 01 N/A
alternate
(0, 1) Normal N/A VAPEL DPS-700EBA N/A N/A
alternate
(1, 1) Normal N/A VAPEL DPS-700EBA N/A N/A
alternate

5.9 Power off the device command


The command is used to power off the device.

5.9.1 shutdown

5.9.1 shutdown

Function
The command shutdown is used to power off the device.

Format
shutdown

Parameters
None.

Modes
Normal mode.

Level
Administrator level.

Usage Guidelines
When using this command, note the following items:
l If the system do not permit power off the device by CLI, the interface will prompts The
system can not permit to power off by CLI!.
l If the system permit power off the device by CLI, the interface will prompts whether power
off the device or not.

Example
Power off the device.

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 5-19


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
5 Device Management Commands Command Reference

OceanStor: admin> shutdown


The system will power off, which will cause service interruption!
Do you want to continue? y/Y or n/N : n

5.10 BBU Information Query Command


BBU information query command is used to query the information about BBU.

5.10.1 showbbu

5.10.1 showbbu

Function
The command showbbu is used to query the information about the backup battery unit (BBU).

Format
showbbu [-i bbu id]

Parameters
Keyword and Value Description Default Value

-i bbu id The ID of the BBU to be None.


queried.

Modes
Normal mode.

Level
Super administrator level, administrator level and guest level.

Usage Guidelines
When using this command, note the following items:
l Enter showbbu to query all information about the BBU, such as the ID, present status,
BBU status, and if it is fully charged.
l Enter showbbu -i bbu id to query the information about a designated BBU, including the
present status and if it is fully charged.

Example
Query the all information about the BBU.

OceanStor: admin> showbbu


================================================

5-20 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 5 Device Management Commands

BBU Information
------------------------------------------------
BBU ID | 0
Present Status | Present
BBU Status | Normal
Is Charge Full | Yes
================================================

================================================
BBU Information
------------------------------------------------
BBU ID | 1
Present Status | Present
BBU Status | Normal
Is Charge Full | Yes
================================================

5.11 Command of Querying the Fan Group Information


Command of querying the fan group information is used to query the information about the fan
group.

5.11.1 showfan

5.11.1 showfan

Function
The command showfan is used to query the state information about a fan group.

Format
showfan [ -s subrack ID [ -i fan ID ] ]

Parameters

Keyword and Value Description Default Value

-s subrack ID The controller enclosure or None.


the disk enclosure ID. The
value ranges from 0 to 7.

-i fan ID The fan group ID. The value None.


can be 0 or 1.

Modes
Normal mode.

Level
Super administrator level, administrator level and guest level.

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 5-21


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
5 Device Management Commands Command Reference

Usage Guidelines
When using this command, note the following items:
l The command showfan is used to query the state information about all fan groups in the
system.
l The command showfan -s subrack ID is used to query the state information about all fan
groups in a specified enclosure.
l The command showfan -s subrack ID -i fan ID is used to query the state information about
a specified fan in an enclosure.

Example
Query the state information about all fan groups in the system.
OceanStor: admin > showfan
Subrack ID Fan Group ID Status Level
0 0 Normal Medium
0 1 Normal Medium
1 0 Second fan fault N/A
1 1 Second fan fault N/A

5.12 Commands of Querying the Information About Buzzer


Status
Commands of querying the information about buzzer status are used to query the information
about the buzzer status.

5.12.1 showbuzzerstatus
5.12.2 chgbuzzerstatus

5.12.1 showbuzzerstatus

Function
The command showbuzzerstatus is used to query the state information about a buzzer.

Format
showbuzzerstatus

Parameters
None.

Modes
Normal mode.

Level
Super administrator level, administrator level and guest level.

5-22 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 5 Device Management Commands

Usage Guidelines
The command showbuzzerstatus is used to query the state information about a buzzer.

Example
Query the state information about a buzzer.
OceanStor: admin > showbuzzerstatus
Buzzer status: Open

5.12.2 chgbuzzerstatus

Function
The command chgbuzzerstatus is used to set the state of a buzzer.

Format
chgbuzzerstatus -c | -o

Parameters

Keyword and Value Description Default Value

-c The command is used to None.


disable the buzzer.

-o The command is used to None.


enable the buzzer.

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
The command chgbuzzerstatus is used to set the state of a buzzer. After you run the
chgbuzzerstatus -o command to enable the buzzer, the buzzer generates a sound when a critical
alarm is generated.

Example
Disable the buzzer.
OceanStor: admin > chgbuzzerstatus -c

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 5-23


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
5 Device Management Commands Command Reference

5.13 Host Port Configuration Commands


Host port configuration commands are used to configure and query the information about the
host port.

5.13.1 showfps
5.13.2 chgfps
5.13.3 showsasmode
5.13.4 showiscsiip
5.13.5 chgiscsiip
5.13.6 chgiscsiroute
5.13.7 chgiscsiname
5.13.8 showiscsiroute
5.13.9 showfcmode
5.13.10 chgfcmode
5.13.11 showfcport

5.13.1 showfps

Function
The command showfps is used to query the rates of FC host ports.

Format
showfps [ -c controller ID [ -i port ID ] ]

Parameters
Keyword and Value Description Default Value

-c controller ID The controller ID. The value None.


is A or B, and is case
insensitive.

5-24 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 5 Device Management Commands

Keyword and Value Description Default Value

-i port ID The ID of an FC host port. None.


The value ranges from 0 to 3.
l S2600F: Each host port
module is configured with
four FC host ports. From
left to right, the host ports
are numbered 0, 1, 2, and
3 in sequence.
l S2600C: Each host port
module is configured with
two FC host ports and two
iSCSI host ports. From left
to right, the FC host ports
are numbered 0 and 1 in
sequence.

Modes
Normal mode.

Level
Super administrator level, administrator level and guest level.

Usage Guidelines
The command applies to FC host ports on the controller of the storage device.

l The command showfps is used to query the rates of all FC host ports.
l The command showfps -c controller ID -i port ID is used to query the rate of a specified
FC host port on a controller.
NOTE

The command can be used only when the storage system uses the S2600F or S2600C controller enclosure.

Example
Query the current rates of the FC host ports.

OceanStor: admin> showfps


Controller FCPort ID Speed
A 0 4G
A 1 4G
A 2 4G
A 3 4G
B 0 4G
B 1 4G
B 2 4G
B 3 Auto

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 5-25


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
5 Device Management Commands Command Reference

5.13.2 chgfps

Function
The command chgfps is used to change the rates of FC host ports.

Format
chgfps -c controller ID -i port ID -s speed

Parameters
Keyword and Value Description Default Value

-c controller ID The controller ID. The value None.


is A or B, and is case
insensitive.

-i port ID The ID of an FC port. The ID None.


value ranges from 0 to 3.
l S2600F: Each host port
module is configured with
four FC host ports. From
left to right, the host ports
are numbered 0, 1, 2, and
3 in sequence.
l S2600C: Each host port
module is configured with
two FC host ports and two
iSCSI host ports. From left
to right, the FC host ports
are numbered 0 and 1 in
sequence.

-s speed The rate of an FC host port. None.


The value can be 0, 1, 2, or 4.
l 0: Auto-adaptation.
l 1: The rate of 1 Gbit/s.
l 2: The rate of 2 Gbit/s.
l 4: The rate of 4 Gbit/s.

Modes
Normal mode.

Level
Super administrator level and administrator level.

5-26 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 5 Device Management Commands

Usage Guidelines
The command chgfps can be used only when the storage system uses the S2600F or S2600C
controller enclosure.

Example
On controller A, change the rate of the FC host port 0 to 2 Gbit/s.

OceanStor: admin> chgfps -c a -i 0 -s 2


If change the speed online, this operation will lead to interrupt the service!
Do you want to continue? y or n: y

5.13.3 showsasmode

Function
The command showsasmode is used to query the information about Serial Attached SCSI (SAS)
host ports.

Format
showsasmode [-c controller ID -i port ID]

Parameters

Keyword and Value Description Default Value

-c controller ID The controller ID. The value None.


is A or B, and is case
insensitive.

-i port ID The ID of a mini SAS host None.


port. The value ranges from 0
(or 00) to 3 (or 03). 0 (or 00)
and 1 (or 01) indicate targets.
2 (or 02) and 3 (or 03)
indicate initiators.

Modes
Normal mode.

Level
Super administrator level, administrator level and guest level.

Usage Guidelines
When using this command, note the following items:

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 5-27


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
5 Device Management Commands Command Reference

l The command showsasmode -c controller ID -i port ID is used to query the information


about a specified mini SAS host port in a controller.
l When the front-end host port is a mini SAS host port, you can run the command to print
the information about initiators and targets. When the front-end host port is an FC or iSCSI
host port, you can run the command to print the information about initiators.

Example
Query the information about all mini SAS host ports in the system.

OceanStor: admin> showsasmode


Controller Port ID Mode FirmwareVersion
A 02 Initiator 000
A 03 Initiator 000
B 02 Initiator 000
B 03 Initiator 000

5.13.4 showiscsiip

Function
The command showiscsiip is used to query the IP addresses of all iSCSI host ports.

Format
showiscsiip [-c controller ID -p port ID ]

Parameters

Keyword and Value Description Default Value

-c controller ID The controller ID. The value None.


is A or B, and is case
insensitive.

-p port ID The iSCSI host port ID. The None.


ID value ranges from 0 to 3.
l S2600i: Each host port
module is configured with
four iSCSI host ports.
From left to right, the host
ports are numbered 0, 1, 2,
and 3 in sequence.
l S2600C: Each host port
module is configured with
two FC host ports and two
iSCSI host ports. From left
to right, the iSCSI host
ports are numbered 0 and
1 in sequence.

5-28 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 5 Device Management Commands

Modes
Normal mode.

Level
Super administrator level, administrator level and guest level.

Usage Guidelines
When using this command, note the following items:
l The command showiscsiip is used to query the IP addresses of all iSCSI host ports.
l The command showiscsiip -c controller ID -p port ID is used to query the IP address of a
specified iSCSI host port on a controller.
NOTE

The command is only applicable to iSCSI host ports on the controller of the storage device.

Example
Query the IP addresses of all iSCSI host ports.

OceanStor: admin> showiscsiip


Controller Port ID IP Address Subnet Mask
A 0 192.168.1.153 255.255.255.0
B 0 192.168.26.1 255.255.255.0

5.13.5 chgiscsiip

Function
The command chgiscsiip is used to change the IP addresses of iSCSI host ports.

Format
chgiscsiip -c controller ID -p Port ID -a IP address -s subnet mask -m config mode

Parameters
Keyword and Value Description Default Value

-c controller ID The controller ID. The value None.


is A or B, and is case
insensitive.

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 5-29


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
5 Device Management Commands Command Reference

Keyword and Value Description Default Value

-p Port ID The iSCSI host port ID. The None.


value ranges from 0 to 3.
l S2600i: Each host port
module is configured with
four iSCSI host ports.
From left to right, the host
ports are numbered 0, 1, 2,
and 3 in sequence.
l S2600C: Each host port
module is configured with
two FC host ports and two
iSCSI host ports. From left
to right, the iSCSI host
ports are numbered 0 and
1 in sequence.

-a IP address The IP address of an iSCSI None.


host port.

-s subnet mask The subnet mask. None.

-m config mode The configuration mode. The None.


value can be 2 or 3 and is
described as follows:
l 2: The Trunk mode.
l 3: The normal mode.

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
The IP addresses of iSCSI host ports and that of the management network interface cannot be
on the same network segment.
NOTE

The command is only applicable to iSCSI host ports on the controller of the storage device.

Example
On controller A , change the IP address of iSCSI host port 1 to 10.10.10.2, and the subnet mask
to 255.255.255.0.

OceanStor: admin> chgiscsiip -c a -p 1 -a 10.10.10.2 -s 255.255.255.0 -m 3

5-30 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 5 Device Management Commands

This operation will lead to interrupt the service!


Do you want to continue? y or n: y

5.13.6 chgiscsiroute

Function
The command chgiscsiroute is used to set the routing information about an iSCSI host port.

Format
chgiscsiroute [ -d ] -c controller ID -p Port ID -a Dest IP address -s subnet mask -g gateway

Parameters

Keyword and Value Description Default Value

-d Delete the routing settings of None.


a specified iSCSI host port.

-c controller ID The controller ID. The value None.


is A or B, and is case
insensitive.

-p Port ID The ID of the iSCSI host port None.


on the controller. The value
ranges from 0 to 3.
l S2600i: Each host port
module is configured with
four iSCSI host ports.
From left to right, the host
ports are numbered 0, 1, 2,
and 3 in sequence.
l S2600C: Each host port
module is configured with
two FC host ports and two
iSCSI host ports. From left
to right, the iSCSI host
ports are numbered 0 and
1 in sequence.

-a Dest IP address The network segment which None.


the destination host belongs
to.

-s subnet mask The subnet mask of the None.


destination host.

-g gateway The gateway of the iSCSI None.


host port on the controller.

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 5-31


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
5 Device Management Commands Command Reference

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
The command chgiscsiroute is used to set the routing information about an iSCSI host port.

NOTE

The command is applicable only to the iSCSI host ports on the controller of the storage device.

Example
On controller A, set the routing information about iSCSI host port with ID 1. Set the network
segment of the destination host to 129.16.11.0, subnet mask of the destination host to
255.255.255.0, and gateway of the iSCSI host port to 192.168.1.1.

OceanStor: admin> chgiscsiroute -c a -p 1 -a 129.16.11.0 -s 255.255.255.0 -g


192.168.1.1

5.13.7 chgiscsiname

Function
The command chgiscsiname is used to modify the name of an iSCSI host port.

Format
chgiscsiname -n iscsiname

Parameters
Keyword and Value Description Default Value

-n iscsiname The changed name of an None.


iSCSI host port. The name
contains 1 to 32 characters,
including numbers, letters,
underscores, and hyphens.
The first character cannot be
a hyphen. The host port
names must be unique.

Modes
Normal mode.

5-32 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 5 Device Management Commands

Level
Super administrator level and administrator level.

Usage Guidelines
None.

Example
Set the iSCSI host port name to iSCSI.

OceanStor: admin> chgiscsiname -n iSCSI

System Response
None.

5.13.8 showiscsiroute

Function
The command showiscsiroute is used to query the routing configurations information about an
iSCSI host port.

Format
showiscsiroute -c controller ID -p Port ID

Parameters
Keyword and Value Description Default Value

-c controller ID The controller ID. The value None.


is A or B, and is case
insensitive.

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 5-33


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
5 Device Management Commands Command Reference

Keyword and Value Description Default Value

-p Port ID The ID of an iSCSI host port. None.


The value ranges from 0 to 3.
l S2600i: Each host port
module is configured with
four iSCSI host ports.
From left to right, the host
ports are numbered 0, 1, 2,
and 3 in sequence.
l S2600C: Each host port
module is configured with
two FC host ports and two
iSCSI host ports. From left
to right, the iSCSI host
ports are numbered 0 and
1 in sequence.

Modes
Normal mode.

Level
Super administrator level, administrator level and guest level.

Usage Guidelines
The command showiscsiroute is used to query the routing configurations information about an
iSCSI host port.

NOTE

The command is only applicable to iSCSI host ports on the controller of the storage device.

Example
On controller A, query the configurations of iSCSI host port with ID 1.

OceanStor: admin> showiscsiroute -c a -p 1


Controller Port ID Dest IP Subnet Mask Gateway
A 1 192.12.5.0 255.255.255.0 192.168.200.1

5.13.9 showfcmode

Function
The command showfcmode is used to query the topology of the current FC port.

5-34 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 5 Device Management Commands

Format
showfcmode

Parameters
None.

Modes
Normal mode.

Level
Guest level and administrator level.

Usage Guidelines
None.

Example
Query the topology of the current FC port.

OceanStor: admin> showfcmode


Controller Port ID Mode
A 0 Loop
A 1 Loop
B 0 Loop
B 1 Loop

5.13.10 chgfcmode

Function
The command chgfcmode is used to change the topology of the current FC port.

Format
chgfcmode -c controller ID -i Port ID -m mode

Parameters

Keyword and Value Description Default Value

-c controller ID The controller ID. The value None.


is A or B, and is case
insensitive.

-i Port ID The ID of an FC port. The ID None.


value ranges from 0 to 3.

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 5-35


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
5 Device Management Commands Command Reference

Keyword and Value Description Default Value

-m mode The topology of an FC port. None.


The value ranges from 1 to 3.
l 1: Fabric.
l 2: Loop.
l 3: Point to Point.

Modes
Normal mode.

Level
administrator level.

Usage Guidelines
None.

Example
On controller A, change the topology of the current FC port 1 to 2 Gbit/s.
OceanStor: admin> chgfcmode -c a -i 1 -m 1
This operation will lead to interrupt the service!
Do you want to continue? y/Y or n/N: y

5.13.11 showfcport

Function
showfcport is used to query the detail information of all FC host ports exist in the system.

Format
showfcport

Parameters
None.

Modes
Normal mode.

Level
Guest level and administrator level.

5-36 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 5 Device Management Commands

Usage Guidelines
showfcport is used to query the detail information of all FC host ports exist in the system,
including port mode and WWN.

Example
Query the information of all the FC host ports。

OceanStor: admin> showfcport


Controller Port ID Mode WWN
A 0 Loop 2200001882f4a59a
A 1 Loop 2201001882f4a59a
B 0 Loop 2210001882f4a59a
B 1 Loop 2211001882f4a59a

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 5-37


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


Downloaded from www.Manualslib.com manuals search engine
OceanStor S2600 Storage System
Command Reference 6 Service Management Commands

6 Service Management Commands

About This Chapter

Service management commands are used to configure and query the service information of the
storage system.

6.1 RAID Group Configuration Commands


RAID group configuration commands are used to create or delete RAID groups, change the
names, and query the information of RAID groups.
6.2 LUN Configuration Commands
LUN configuration commands are used to create, delete, change, format, and query the
information about a LUN.
6.3 LUN Mapping Configuration Commands
LUN mapping configuration commands are used to manage the hostgroups, hosts, host ports,
and mappings of LUNs.
6.4 Disk Configuration Commands
Disk configuration commands are used to enable the disk reconstruction function and the disk
copyback function, query the details and set the type for a disk.
6.5 Cache Configuration Commands
Cache configuration commands are used to set the cache water level and query the details about
the cache.

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 6-1


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
6 Service Management Commands Command Reference

6.1 RAID Group Configuration Commands


RAID group configuration commands are used to create or delete RAID groups, change the
names, and query the information of RAID groups.

6.1.1 createrg
6.1.2 deleterg
6.1.3 chgrg
6.1.4 showrg
6.1.5 chgrgredundantcopy
6.1.6 showrgredundantcopy

6.1.1 createrg

Function
The command createrg is used to create a RAID group.

Format
createrg [ -n name ] -l level [ -m mirrordisk number ] -d subrack ID, slot ID :subrack ID, slot
ID : … :

Parameters

Keyword and Value Description Default Value

-n name The name of a RAID group. RAIDXXX.


The name contains 1 to 32
characters, including
numbers, letters,
underscores, and hyphens.
The first character cannot be
a hyphen.
The name of the RAID
groups is case sensitive, and
must be unique. The default
name can be used for only
once.

-l level The RAID group level. The None.


value can be 0, 1, 3, 5, 6 or
10.

6-2 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 6 Service Management Commands

Keyword and Value Description Default Value

-m mirrordisk number The number of mirroring None.


disks. You cannot use this
parameter when the RAID
level is RAID 0 or RAID 3 or
RAID 5 or RAID 6. You must
use this parameter when the
RAID level is RAID 1 or
RAID 10. The number of
mirroring disks must be more
than or equal to 2. The
number of disks in a RAID
group is the multiple of the
number of mirroring disks.

-d subrack ID, slot ID The enclosure ID and the slot None.


ID. The disk to be chosen
must be a normal free disk.

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
Note the following items when creating RAID group:
l The number of disks in a RAID 0 ranges from 1 to 24.
l The number of disks in a RAID 1 ranges from 2 to 24.
l The number of disks in a RAID 3 group ranges from 3 to 24.
l The number of disks in a RAID 5 group ranges from 3 to 24.
l The number of disks in a RAID 6 or RAID 10 group ranges from 4 to 24.
l The enclosure number ranges from 0 to 7. The slot number ranges from 0 to 11.
l The colon (:) is the end symbol.

Example
Create a RAID group by specifying the RAID level to 1, number of mirroring disks to 2, and
disk list to 0,5:0,3:
OceanStor: admin> createrg -l 1 -m 2 -d 0,5:0,3:

6.1.2 deleterg

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 6-3


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
6 Service Management Commands Command Reference

Function
The command deleterg is used to delete a RAID group.

Format
deleterg [ -f ] -i RAID group ID

Parameters
Keyword and Value Description Default Value

-f When you delete a RAID None.


group, you do not need to
enter the confirmation
information, the system will
delete the RAID group
automatically.

-i RAID group ID The RAID group ID. The None.


value ranges from 0 to 31.

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
The command deleterg can only be used in the RAID group without a LUN.

Example
Delete RAID group 1.

OceanStor: admin> deleterg -i 1


If the RAID group is deleted, the data of the RAID group will be lost. Are you sure
you want to delete the RAID group(y/n)?y

6.1.3 chgrg

Function
The command chgrg is used to change the name of a RAID group.

Format
chgrg -i RAID group ID -n RAID group name

6-4 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 6 Service Management Commands

Parameters
Keyword and Value Description Default Value

-i RAID group ID The RAID group ID. The None.


value ranges from 0 to 31.

-n RAID group name The new name of the RAID None.


group. The name contains 1
to 32 characters, including
numbers, letters,
underscores, and hyphens.
The first character cannot be
a hyphen. The name of a
RAID group is case sensitive,
and must be unique.

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
The command chgrg is used to change the name of a RAID group.

Example
Change the name of RAID group 1 to asd.

OceanStor: admin> chgrg -i 1 -n asd

6.1.4 showrg

Function
The command showrg is used to query the information about a RAID group.

Format
showrg [ -i RAID group ID ]

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 6-5


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
6 Service Management Commands Command Reference

Parameters

Keyword and Value Description Default Value

-i RAID group ID The RAID group ID. The None.


value ranges from 0 to 31.

Modes
Normal mode.

Level
Super administrator level, administrator level and guest level.

Usage Guidelines
When using this command, note the following items:

l The command showrg is used to query the information about all RAID groups in the
system.
l The command showrg -i RAID group ID is used to query the details about a specified RAID
group.

Example
Query the information about RAID group 0 .

OceanStor: admin> showrg -i 0


=====================================
RAID Group Information
-------------------------------------
ID | 0
Name | RAID001
Level | RAID0
Total Capacity(MB) | 1400087
Free Capacity(MB) | 1377557
Status | Normal
Member disk list | 0,0;0,1;
Maximum Capacity(MB) | 1377557
=====================================

6.1.5 chgrgredundantcopy

Function
The command chgrgredundantcopy is used to set the redundant copy status of a RAID group.

Format
chgrgredundantcopy -t type

6-6 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 6 Service Management Commands

Parameters

Keyword and Value Description Default Value

-t type The redundant copy status of 1.


a RAID group. The value can
be 1 or 2:
l 1: Enable redundant copy
function.
l 2: Disable redundant copy
function.

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
The command chgrgredundantcopy is used to set the redundant copy status of a RAID group.

Example
Set the redundant copy status of a RAID group to enable.

OceanStor: admin> chgrgredundantcopy -t 1

6.1.6 showrgredundantcopy

Function
The command showrgredundantcopy is used to query the redundant copy status of a RAID
group.

Format
showrgredundantcopy

Parameters
None.

Modes
Normal mode.

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 6-7


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
6 Service Management Commands Command Reference

Level
Super administrator level, administrator level and guest level.

Usage Guidelines
The command showrgredundantcopy is used to query the redundant copy status of a RAID
group.

Example
Query the redundant copy status of a RAID group.

OceanStor: admin> showrgredundantcopy


RAID redundant copy started.

6.2 LUN Configuration Commands


LUN configuration commands are used to create, delete, change, format, and query the
information about a LUN.

6.2.1 createlun
6.2.2 deletelun
6.2.3 chglun
6.2.4 showlun

6.2.1 createlun

Function
The command createlun is used to create a LUN.

Format
createlun -i RAID group ID [ -n name] -s size -u su size -c controller ID -w is write through -
m is mirror [ -p prefetchtype [-v prefetch value ] ]

Parameters
Keyword and Value Description Default Value

-i RAID group ID The RAID group ID. None.

6-8 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 6 Service Management Commands

Keyword and Value Description Default Value

-n name The LUN name. The name LUNXXX.


contains 1 to 32 characters,
including numbers, letters,
underscores, and hyphens.
The first character cannot be
a hyphen.
The LUN name is case
sensitive, and must be
unique. The default name can
be used for once only.

-s size The LUN size. The unit can M.


be M (m), G (g), or T (t). The
LUN size must be an integer.

-u su size The strip unit size. The value None.


ranges from 4 to 512 in KB.

-c controller ID The ID for a LUN owning A.


controller.

-w is write through The way to write the cache. 1.


The value can be 1 ,2 or 3:
l 1: Write-back.
l 2: Write-through.
l 3: Write back mandatory.

-m is mirror Whether the cache is 1.


mirroring. The value can be 0
or 1:
l 0: Unmirroring.
l 1: Mirroring.

-p prefetchtype The cache prefetch strategy. 3.


The value ranges from 0 to 3:
l 0: Non-prefetch.
l 1: Constant prefetch.
l 2: Variable prefetch.
l 3: Intelligent prefetch.

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 6-9


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
6 Service Management Commands Command Reference

Keyword and Value Description Default Value

-v prefetch value The cache prefetch value. None.


l When the cache prefetch
strategy is the constant
prefetch, the parameter
means constant prefetch
value. The value ranges
from 0 to 1024 in KB.
l When the cache prefetch
strategy is the variable
prefetch, the parameter
means a multiple for
prefetch. The value ranges
from 0 to 65535.
NOTE
l You should use this
parameter when the cache
prefetch strategy is constant
prefetch or variable
prefetch. You do not need to
use this parameter when the
cache prefetch strategy is
intelligent prefetch or non-
prefetch.

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
When you use this command to create LUNs, the number of LUNs cannot be more than 512.

Example
Create a LUN in RAID group 1 by specifying the LUN size to 200 MB, strip unit size to 32
KB, LUN name to asd, write-back, mirroring, constant prefetch, and cache prefetch value to 1
KB.

OceanStor: admin> createlun -i 1 -s 200 -u 32 -n asd -w 1 -m 1 -p 1 -v 1

6.2.2 deletelun

6-10 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 6 Service Management Commands

Function
The command deletelun is used to delete a LUN.

Format
deletelun [ -f ] -i LUN ID

Parameters

Keyword and Value Description Default Value

-f When you delete a LUN, you None.


do not need to enter the
confirmation information.

-i LUN ID The LUN ID. The value None.


ranges from 0 to 511.

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
The command deletelun is used to delete a LUN.

Example
Delete LUN 9 without confirmation.
OceanStor: admin> deletelun -f -i 9

6.2.3 chglun

Function
The command chglun is used to change the parameters of a LUN.

Format
chglun -i LUN ID -n name | -c controller ID | -w is write through | -m is mirror | -p
prefetchtype [-v prefetch value]

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 6-11


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
6 Service Management Commands Command Reference

Parameters
Keyword and Value Description Default Value

-i LUN ID The LUN ID. The value None.


ranges from 0 to 511.

-n name The LUN name. The name None.


contains 1 to 32 characters,
including numbers, letters,
underscores, and hyphens.
The first character cannot be
a hyphen. The name of a
LUN is case sensitive, and
must be unique.

-c controller ID The ID of the LUN owning None.


controller.

-w is write through The way to write the cache. None.


The value can be 1 or 2:
l 1: Write-back.
l 2: Write-through.

-m is mirror Whether the cache is None.


mirroring. The value can be 0
or 1:
l 0: Non-mirroring.
l 1: Mirroring.

-p prefetchtype The cache prefetch strategy. 3.


The value ranges from 0 to 3:
l 0: None-prefetch.
l 1: Constant prefetch.
l 2: Variable prefetch.
l 3: Intelligent prefetch.

6-12 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 6 Service Management Commands

Keyword and Value Description Default Value

-v prefetch value The cache prefetch value. None.


l When the cache prefetch
strategy is the constant
prefetch, the parameter
means constant prefetch
value. The value ranges
from 0 to 1024 in KB.
l When the cache prefetch
strategy is the variable
prefetch, the parameter
means a multiple for
prefetch. The value ranges
from 0 to 65535.
NOTE
l You should use this
parameter when the cache
prefetch strategy is constant
prefetch or variable
prefetch. You do not need to
use this parameter when the
cache prefetch strategy is
intelligent prefetch or non-
prefetch.

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
None.

Example
Change the name of the LUN 2 to qwe.

OceanStor: admin> chglun -i 2 -n qwe

6.2.4 showlun

Function
The command showlun is used to query the details about a LUN.

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 6-13


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
6 Service Management Commands Command Reference

Format
showlun [ -i LUN ID ]

Parameters
Keyword and Value Description Default Value

-i LUN ID The LUN ID. The value None.


ranges from 0 to 511.

Modes
Normal mode.

Level
Super administrator level, administrator level and guest level.

Usage Guidelines
When using this command, note the following items:
l The command showlun is used to query the information about all LUNs in the system.
l The command showlun -i LUN ID is used to query the details about a specified LUN.

Example
Query the information about LUN 0.

OceanStor: admin> showlun -i 0


=========================================================================
LUN Information
-------------------------------------------------------------------------
ID | 0
Name | 10g_1
LUN WWN | 60:01:88:21:00:E8:41:29:00:08:7F:AD:00
| :00:00:00
Status | Fault
Capacity(MB) | 10240
Strip Unit Size(KB) | 64
RAID Group ID | 1
Format Progress(%) | --
Ascription Controller | A
Working Controller | A
Cache Prefetch Policy | Intelligent
Cache Write Policy | Write back; Mirroring
Running Cache Write Policy | Write back; Mirroring
Changed Strip Unit Size(KB) | --
Strip Unit Size Progress(%) | --
Strip Unit Size Speed | --
Whether Private LUN | No
Expanded LUN | --
Pool ID | --
SnapShot ID | --
HyperCopy ID | --
=========================================================================

6-14 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 6 Service Management Commands

6.3 LUN Mapping Configuration Commands


LUN mapping configuration commands are used to manage the hostgroups, hosts, host ports,
and mappings of LUNs.

6.3.1 createhostgroup
6.3.2 deletehostgroup
6.3.3 chghostgroup
6.3.4 showhostgroup
6.3.5 addhost
6.3.6 chghost
6.3.7 deletehost
6.3.8 showhost
6.3.9 showfreeport
6.3.10 addport
6.3.11 showhostport
6.3.12 deleteport
6.3.13 chgport
6.3.14 showunmap
6.3.15 addmap
6.3.16 showmap
6.3.17 deletemap

6.3.1 createhostgroup

Function
The command createhostgroup is used to create a host group.

Format
createhostgroup -n name -t OS type

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 6-15


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
6 Service Management Commands Command Reference

Parameters
Keyword and Value Description Default Value

-n name The name of a host group. None.


The name contains 1 to 32
characters, including
numbers, letters,
underscores, and hyphens.
The first character cannot be
a hyphen. The name of a host
group is case sensitive, and
must be unique.

-t OS type The OS type. The value None.


ranges from 0 to 4:
l 0: Linux.
l 1: Windows.
l 2: Solaris.
l 3: HP-UX.
l 4: AIX.

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
The command createhostgroup is used to create a host group.

Example
Create a host group with name abc, and the OS type is Linux.

OceanStor: admin> createhostgroup -n abc -t 0

6.3.2 deletehostgroup

Function
The command deletehostgroup is used to delete a host group.

Format
deletehostgroup [ -f ] -i host group ID

6-16 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 6 Service Management Commands

Parameters

Keyword and Value Description Default Value

-f When you delete a host None.


group, you do not need to
enter the confirmation
information.

-i host group ID The host group ID. The value 0.


ranges from 0 to 31.

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
When you run this command to delete a host group, ensure that the host group does not contain
a host or a mapping.

Example
Delete host group 2 without confirmation.
OceanStor: admin> deletehostgroup -f -i 2

6.3.3 chghostgroup

Function
The command chghostgroup is used to change the name and the OS type of a host group.

Format
chghostgroup -i host group ID [-n host group name] | [-t OS type]

Parameters

Keyword and Value Description Default Value

-i host group ID The host group ID. The value None.


ranges from 0 to 31.

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 6-17


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
6 Service Management Commands Command Reference

Keyword and Value Description Default Value

-n host group name The changed name of the host None.


group. The name contains 1
to 32 characters, including
numbers, letters,
underscores, and hyphens.
The first character cannot be
a hyphen. The name of a host
group is case sensitive, and
must be unique.

-t OS type The changed OS type for a None.


host group. The value ranges
from 0 to 4:
l 0: Linux.
l 1: Windows.
l 2: Solaris.
l 3: HP-UX.
l 4: AIX.

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
After changing the name and the OS type of a host group, you can run the command
showhostgroup to view the details about the host group.

Example
Change the name of the host group 2 to bcd and the OS type to Windows.

OceanStor: admin> chghostgroup -i 2 -n bcd -t 1

6.3.4 showhostgroup

Function
The command showhostgroup is used to query the details about a host group.

Format
showhostgroup [ -i host group ID ]

6-18 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 6 Service Management Commands

Parameters
Keyword and Value Description Default Value

-i host group ID The host group ID. The value None.


ranges from 0 to 31.

Modes
Normal mode.

Level
Super administrator level, administrator level and guest level.

Usage Guidelines
When using this command, note the following items:
l The command showhostgroup is used to query the information about all host groups.
l The command showhostgroup -i host group ID is used to query the details about a specified
host group.

Example
Query the information about host group 2.
OceanStor: admin> showhostgroup -i 2
======================
Host Group Information
----------------------
ID | 2
Name | abc
OsType | Linux
======================

6.3.5 addhost

Function
The command addhost is used to add a host to a host group.

Format
addhost [ -i host group ID] -n host name

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 6-19


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
6 Service Management Commands Command Reference

Parameters

Keyword and Value Description Default Value

-i host group ID The host group ID. The value 0.


ranges from 0 to 31.
If you do not specify a host
group for adding a host, the
host is added to the default
host group.

-n host name The name contains 1 to 32 None.


characters, including
numbers, letters, underscores
and hyphens. The first
character cannot be a hyphen.
The name of a host is case
sensitive, and must be
unique.

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
When using this command, note the following items:

l The command addhost -n host name is used to name the host and add it to the default host
group.
l The command addhost -i host group ID -n host name is used to name the host and add it
to a specified host group.

Example
Add the host user into host group 2.

OceanStor: admin> addhost -i 2 -n user

6.3.6 chghost

Function
The command chghost is used to change the host name.

6-20 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 6 Service Management Commands

Format
chghost -i host ID -n host name

Parameters

Keyword and Value Description Default Value

-i host ID The ID of the host to be None.


changed. The value ranges
from 0 to 255.

-n host name The new name of the host. None.


The name contains 1 to 32
characters, including
numbers, letters,
underscores, and hyphens.
The first character cannot be
a hyphen. The name of a host
is case sensitive, and must be
unique.

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
The command chghost is used to change the host name.

Example
Change the name of host 0 to host_1.
OceanStor: admin> chghost -i 0 -n host_1

6.3.7 deletehost

Function
The command deletehost is used to delete a specified host.

Format
deletehost [ -f ] -i host ID

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 6-21


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
6 Service Management Commands Command Reference

Parameters

Keyword and Value Description Default Value

-f When you delete a host, you None.


do not need to enter the
confirmation information.

-i host ID The ID of the host to be None.


deleted. The value ranges
from 0 to 255.

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
When you use this command to delete a specified host, ensure that the host does not contain any
port; otherwise, you cannot delete the host.

Example
Delete host 1 without confirmation.

OceanStor: admin> deletehost -f -i 1

6.3.8 showhost

Function
The command showhost is used to query the list information about a host.

Format
showhost [ -i host group ID ]

Parameters

Keyword and Value Description Default Value

-i host group ID The host group ID. The value None.


ranges from 0 to 31.

6-22 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 6 Service Management Commands

Modes
Normal mode.

Level
Super administrator level, administrator level and guest level.

Usage Guidelines
When using this command, note the following items:

l The command showhost is used to query the list information about all hosts.
l The command showhost -i host group ID is used to query the list information about the
hosts in a specified host group.

Example
Query the information about all hosts.
OceanStor: admin> showhost
Host ID Host Group ID Host Name
0 1 Host_35
1 1 Host_24
2 0 wang

6.3.9 showfreeport

Function
The command showfreeport is used to query the information about all free host ports.

Format
showfreeport

Parameters
None.

Modes
Normal mode.

Level
Super administrator level, administrator level and guest level.

Usage Guidelines
The command showfreeport is used to query the information about all free host ports.

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 6-23


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
6 Service Management Commands Command Reference

Example
Query the information about all free host ports.

OceanStor: admin> showfreeport


Port Type Port Information Status
FC 2100001b328722d0 Connected
FC 2100001b3287e7b1 Connected
FC 2101001b32a74abc Connected
FC 2100001b32870fd3 Connected
FC 2101001b32a722d0 Connected
FC 2101001b32a7e7b1 Connected
FC 2100001b32874abc Connected
FC 2101001b32a70fd3 Connected

6.3.10 addport

Function
The command addport is used to add a host port.

Format
addport -i host ID -t port type -I port information | -w wwn -n name

Parameters
Keyword and Value Description Default Value

-i host ID The host ID. The value None.


ranges from 0 to 255.

-t port type The type of a host port. The None.


value can be 0, 1 or 2.
l 0: The FC host port.
l 1: The iSCSI host port.
l 2: The mini SAS host port.

-I port information The information about iSCSI None.


host ports. The parameter is
required when the iSCSI host
ports are used as the front-
end host ports.

6-24 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 6 Service Management Commands

Keyword and Value Description Default Value

-w wwn The WWNa for an FC host None.


port or a mini SAS host port.
The parameter is required
when the FC host ports or
mini SAS host ports are used
as the front-end host ports.
A WWN contains 8
characters and is formed by
letters A to F and digits 0 to
9.

-n name The host port name. The None.


name contains 1 to 32
characters, including digits,
letters, underscores, and
hyphens. The first character
cannot be a hyphen. The
name of a port is case
sensitive, and must be
unique.

a: World-Wide Name

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
The command addport is used to add a host port.

Example
Add an FC host port on host 5. The WWN is 5001882847b12001 and the name is test_fc.
OceanStor: admin> addport -i 5 -t 2 -w 5001882847b12001 -n test_fc

6.3.11 showhostport

Function
The command showhostport is used to query the list information about a host port based on the
host ID.

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 6-25


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
6 Service Management Commands Command Reference

Format
showhostport -i host ID

Parameters

Keyword and Value Description Default Value

-i host ID The host ID. The value None.


ranges from 0 to 255.

Modes
Normal mode.

Level
Super administrator level, administrator level and guest level.

Usage Guidelines
The command showhostport is used to query the list information about a host port based on the
host ID.

Example
Query the information about host port 0.
OceanStor: admin > showhostport -i 0
Port ID Port Name Port Information Port Type Host ID
0 a34b 2101001b32a34bc6 FC 0
1 834b 2100001b32834bc6 FC 0

6.3.12 deleteport

Function
The command deleteport is used to delete a specified host port.

Format
deleteport [ -f ] -i port ID

Parameters

Keyword and Value Description Default Value

-f When you delete a host port, None.


you do not need to enter the
confirmation information.

6-26 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 6 Service Management Commands

Keyword and Value Description Default Value

-i port ID The ID of a host port. The None.


value ranges from 0 to 255.

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
The command deleteport is used to delete a specified host port.

Example
Delete host port 0.

OceanStor: admin> deleteport -f -i 0

6.3.13 chgport

Function
The command chgport is used to change the name of a host port.

Format
chgport -i port ID -n name

Parameters
Keyword and Value Description Default Value

-i port ID The ID of a host port. The None.


value ranges from 0 to 255.

-n name The port name. The name None.


contains 1 to 32 characters,
including digits, letters,
underscores, and hyphens.
The first character cannot be
a hyphen. The interface name
is case sensitive, and must be
unique.

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 6-27


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
6 Service Management Commands Command Reference

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
The command chgport is used to change the name of a host port.

Example
Change the name of the host port from 0 to 123.

OceanStor: admin> chgport -i 0 -n 123

6.3.14 showunmap

Function
The command showunmap is used to query the list of unmapped device LUNs.

Format
showunmap

Parameters
None.

Modes
Normal mode.

Level
Super administrator level, administrator level and guest level.

Usage Guidelines
The command showunmap is used to query the list of unmapped device LUNs.

Example
Query the list of unmapped device LUNs.
OceanStor: admin> showunmap
Unmap LUN ID RAID ID Status Ctrler Capacity(MB) LUN Name
3 1 Normal A 2048 Lun004
4 0 Not formatted A 1 LUN4

6-28 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 6 Service Management Commands

6.3.15 addmap

Function
The command addmap is used to add a mapping to a host LUN or a host group.

Format
addmap -gi host group ID | -hi host ID [-hl host LUN] -dl device LUN

Parameters
Keyword and Value Description Default Value

-gi host group ID ID of the host group to which 0.


the LUN mapping is to be
added. The value ranges from
0 to 31.

-hi host ID ID of the host to which the None.


LUN mapping to be added.
The value ranges from 0 to
255.

-hl host LUN ID ID of a host LUN . The value None.


ranges from 0 to 511.

-dl device LUN ID ID of a device LUN which is None.


to be mapped. The value
ranges from 0 to 511.

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
When using this command, note the following items:
l The command addmap -gi host group ID | -hi host ID -dl device LUN is used to map a
LUN to a host group or host. The system automatically specifies the host LUN ID.
l The command addmap -gi host group ID | -hi host ID -hl host LUN -dl device LUN is used
to map a specified host LUN to a host group or host.

Example
Map the device LUN 0 to the host 0 and set the host LUN ID to 0 .

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 6-29


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
6 Service Management Commands Command Reference

OceanStor: admin> addmap -hi 0 -hl 0 -dl 0

6.3.16 showmap

Function
The command showmap is used to query the LUN mapping list.

Format
showmap -gi host group ID | -hi host ID | -i LUN map ID

Parameters

Keyword and Value Description Default Value

-gi host group ID The host group ID. The value None.
ranges from 0 to 31.

-hi host ID The host ID. The value None.


ranges from 0 to 255.

-i LUN map ID The ID for a host LUN None.


mapping.

Modes
Normal mode.

Level
Super administrator level, administrator level and guest level.

Usage Guidelines
The command showmap is used to query the LUN mapping list.

Example
Query the LUN mapping list by specifying the host ID to 0.

OceanStor: admin > showmap -hi 0


Map ID Ctrler Dev LUN ID Host LUN Mapped to RAID ID Dev LUN Cap(MB)
0x1010000 A 0 0 Host: 0 0 1048576
0x1010001 A 6 1 Host: 0 2 2096640
0x1010003 B 3 3 Host: 0 1 10240
0x1010004 B 4 4 Host: 0 1 10241

6.3.17 deletemap

6-30 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 6 Service Management Commands

Function
The command deletemap is used to delete a host LUN mapping.

Format
deletemap [ -f ] -i map ID

Parameters

Keyword and Value Description Default Value

-f When you delete a host LUN None.


mapping, you do not need to
enter the confirmation
information.

-i map ID The ID for LUN mapping. None.

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
The command deletemap is used to delete a host LUN mapping.

Example
Delete a LUN mapping by specifying the ID to 0x1010000.

OceanStor: admin> deletemap -i 0x1010000


Are you sure to delete the mapping{y/n}?y

6.4 Disk Configuration Commands


Disk configuration commands are used to enable the disk reconstruction function and the disk
copyback function, query the details and set the type for a disk.

6.4.1 startrecon
6.4.2 startcopyback
6.4.3 showdisk
6.4.4 chgdisktype

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 6-31


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
6 Service Management Commands Command Reference

6.4.1 startrecon

Function
The command startrecon is used to enable the disk reconstruction function.

Format
startrecon [ -f ] -fs failed disk subrack ID -fsl failed disk slot ID -ss spare disk subrack ID -
ssl spare disk slot ID

Parameters

Keyword and Value Description Default Value

-fs failed disk subrack ID The enclosure ID of a failed None.


disk. The value ranges from 0
to 7.

-fsl fail disk slot ID The slot ID of a failed disk. None.


The value ranges from 0 to
11.

-ss spare disk subrack ID The enclosure ID of a hot None.


spare disk. The value ranges
from 0 to 7.

-ssl spare disk slot ID The slot ID of a hot spare None.


disk. The value ranges from 0
to 11.

-f When you enable the hard None.


disk reconstruction function,
you do not need to type the
confirmation information.

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
The command startrecon is used to enable the hard disk reconstruction function.

6-32 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 6 Service Management Commands

Example
Reconstruct the failed disk in slot 1, enclosure 0 to the hot spare disk in slot 2, enclosure 1 without
confirmation.
OceanStor: admin> startrecon -fs 0 -fsl 1 -ss 1 -ssl 2 -f

6.4.2 startcopyback

Function
The command startcopyback is used to enable the copyback function for a disk.

Format
startcopyback [ -f ] -ns new disk subrack ID -nsl new disk slot ID

Parameters

Keyword and Value Description Default Value

-f When you enable the None.


copyback function for a disk,
you do not need to enter the
confirmation information.

-ns new disk subrack ID The enclosure ID of a new None.


disk. The value ranges from 0
to 7.

-nsl new disk slot ID The slot ID of a new disk. The None.
value ranges from 0 to 11.

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
The command startcopyback is used to enable the copyback function for a hard disk.

Example
Copyback the data from the spare disk to the new disk that is in slot 11, enclosure 1 without
confirmation.
OceanStor: admin> startcopyback -f -ns 1 -nsl 11

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 6-33


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
6 Service Management Commands Command Reference

6.4.3 showdisk

Function
The command showdisk is used to query the details about a disk.

Format
showdisk -p | -l | -s subrack ID -sl slot ID | -h

Parameters
Keyword and Value Description Default Value

-p The physical disk. None.

-l The logical disk. None.

-s subrack ID The enclosure ID of a disk. None.


The value ranges from 0 to 7.

-sl slot ID The slot ID of a disk. The None.


value ranges from 0 to 11.

-h The hot spare disk. None.

Modes
Normal mode.

Level
Super administrator level, administrator level and guest level.

Usage Guidelines
When using this command, note the following items:
l The command showdisk -p is used to query the information about a physical disk.
l The command showdisk -l is used to query the information about a logical disk.
l The command showdisk -s subrack ID -sl slot ID is used to query the details about a disk
in a specified disk enclosure and slot.
l The command showdisk -h is used to query the information about a hot spare disk.

Example
Query the details about a hard disk in enclosure 0, slot 4.

OceanStor: admin> showdisk -s 0 -sl 4


==============================================

6-34 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 6 Service Management Commands

Disk Information
----------------------------------------------
Disk Location | (0, 4)
Type | Member disk
Associated Disk | --
Reconstruction Progress | --
RAID Group ID | 2
Logical Status | Fault
Capacity(GB) | 698
Running Time(days) | 87
Physical Status | Normal
Master Path | Normal
Slave Path | Normal
Temperature(¡æ) | 33
Speed(RPM) | 20000
World Wide Name | 5001882e84129104
Vendor | SEAGATE
Model | ST3750330NS
Firmware Number | SN06
Serial Number | 9QK1WT84
Physical Type | SATA
Current Speed(Gbps) | 3.0
==============================================

6.4.4 chgdisktype

Function
The command chgdisktype is used to set the type of a hard disk.

Format
chgdisktype -s subrack ID -sl slot ID -t disk type

Parameters

Keyword and Value Description Default Value

-s subrack ID The enclosure ID of a hard None.


disk. The value ranges from 0
to 7.

-sl slot ID The slot ID of a hard disk. None.


The value ranges from 0 to
11.

-t disk type The disk type. The value can None.


be 1 or 3.
l 1: Free disks.
l 3: Hot spare disks.

Modes
Normal mode.

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 6-35


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
6 Service Management Commands Command Reference

Level
Super administrator level and administrator level.

Usage Guidelines
When using this command, note the following items:

l Only a normal free disk can be set to a hot spare disk.


l Only an unused hot spare disk can be set to a free disk.

Example
Set the free disk in enclosure 1, slot 1 to the hot spare disk.
OceanStor: admin> chgdisktype -s 1 -sl 1 -t 3

6.5 Cache Configuration Commands


Cache configuration commands are used to set the cache water level and query the details about
the cache.

6.5.1 showcache
6.5.2 chgcache

6.5.1 showcache

Function
The command showcache is used to query the cache information.

Format
showcache [ -c controller ID ]

Parameters

Keyword and Value Description Default Value

-c controller ID The controller ID. The value None.


is A or B, and is case
insensitive.

Modes
Normal mode.

6-36 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 6 Service Management Commands

Level
Super administrator level, administrator level and guest level.

Usage Guidelines
When using this command, note the following items:
l The command showcache is used to query the cache information about all controllers.
l The command showcache -c controller ID is used to query the cache information about a
specified controller.

Example
Query the cache information.

OceanStor: admin> showcache


Controller A cache:
==========================================================
Cache Information
----------------------------------------------------------
Memory Capacity(MB) | 2048
Read Cache Utility(%) | 0
Write Cache Utility(%) | 0
Mirroring Write Cache Utility(%) | 0
Cache Hit Percentage(%) | 0
Whether there is dirty data | No
High Water Level(%) | 70
Low Water Level(%) | 20
==========================================================
Controller B cache:
==========================================================
Cache Information
----------------------------------------------------------
Memory Capacity(MB) | 2048
Read Cache Utility(%) | 0
Write Cache Utility(%) | 0
Mirroring Write Cache Utility(%) | 0
Cache Hit Percentage(%) | 0
Whether there is dirty data | No
High Water Level(%) | 70
Low Water Level(%) | 20
==========================================================

6.5.2 chgcache

Function
The command chgcache is used to set high and low water levels of the cache.

Format
chgcache [-h high water position] | [-l low water position]

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 6-37


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
6 Service Management Commands Command Reference

Parameters
Keyword and Value Description Default Value

-h high water position The percentage of high water 70.


level. The value is an integer,
ranging from 2 to 99.

-l low water pisition The percentage of low water 20.


level. The value is an integer,
ranging from 1 to 98.

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
When you use this command to set the cache water level, ensure that the cache high water level
is higher than the cache low water level. The default value of the cache high water level is 70%,
and the default value of the cache low water level is 20%.

Example
Set the cache high water level to 70% and the cache low water level to 20%.
OceanStor: admin> chgcache -h 70 -l 20

6-38 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 7 Alarm Management Commands

7 Alarm Management Commands

About This Chapter

Alarm management commands are used to manage alarms.

7.1 Alarm Email Management Commands


Alarm email management commands are used to manage alarm emails.
7.2 Alarm Short Message Management Commands
Alarm short message management commands are used to manage alarm short message.

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 7-1


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
7 Alarm Management Commands Command Reference

7.1 Alarm Email Management Commands


Alarm email management commands are used to manage alarm emails.

7.1.1 chgemail
7.1.2 showemail

7.1.1 chgemail

Function
The command chgemail is used to set email boxes.

Format
chgemail -s is need send [ -i server ip -r receive email list -e sender email [ -c is need check [ -
u user name -p passwd ] ] [ -l send level ] ]

Parameters
Keyword and Value Description Default Value

-s is need send The parameter indicates 1.


whether an email needs be
sent. The value can be 0 or 1
and is described as follows:
l 0: The email does not need
to be sent.
l 1: The email need to be
sent.

-i server IP The IP address of an SMTP None.


email server.

-r receiver list The email box list of email None.


boxes that receive alarms.
The lists are separated with
colons.

-e sender email The email box of an alarm None.


sender.

7-2 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 7 Alarm Management Commands

Keyword and Value Description Default Value

-c is need check The parameter indicates 1.


whether an SMTP email
server needs be checked.
The value can be 0 or 1 and is
described as follows:
l 0: The SMTP email server
does not need to be
checked.
l 1: The SMTP email server
needs to be checked.

-u user name The user name for logging in None.


to the remote SMTPa email
server.

-p password The password for logging in None.


to the remote SMTP email
server.

-l send level The lowest alarm severity for None.


sending an alarm email.
The value ranges from 2 to 6
and is described as follows:
l 2: Event.
l 3: Warning.
l 4: Minor.
l 5: Major.
l 6: Critical.

a: Simple Mail Transfer Protocol

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
The command chgemail is used to set the email boxes.

Example
Set an email box. The user name for logging in to the SMTP email server is S2600. The password
is 123456. The IP address of the SMTP email server is 129.80.10.46. The email addresses for

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 7-3


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
7 Alarm Management Commands Command Reference

receiving alarms are sohu@sohu.com and s2600@sohu.com. The email address for sending
alarms is hlx11@163.com. Alarms are sent when the alarm severity is set to 3 or above, and the
email server needs be checked.

OceanStor: admin> chgemail -u s2600 -p 123456 -i 129.80.10.46 -r


sohu@sohu.com:s2600@sohu.com -e hlx11@163.com -l 3

7.1.2 showemail

Function
The command showemail is used to query the settings of an email box.

Format
showemail

Parameters
None.

Modes
Normal mode.

Level
Super administrator level, administrator level and guest level.

Usage Guidelines
The command showemail is used to query the settings of an email box.

Example
Query the setting of an email box.

OceanStor: admin> showemail


==========================================================
EMAIL INFORMATION
----------------------------------------------------------
UserName | test1
Server Ip | 129.24.11.213
Sender Email | hjf@s2600v1r2.com
Receiver email list | hjf@r2.com;lsk@r2.com;zcz@r2.com
Is Need Send | YES
Is Need Check | YES
Send Level | Warning
==========================================================

7.2 Alarm Short Message Management Commands


Alarm short message management commands are used to manage alarm short message.

7-4 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 7 Alarm Management Commands

7.2.1 chgsms
7.2.2 showsms

7.2.1 chgsms

Function
The command chgsms is used to set short message.

Format
chgsms -s is need send [ -c send country -r receiver number [ -l sender level ] ]

Parameters

Keyword and Value Description Default Value

-s is need send Whether a short message 1.


needs to be sent. The value
can be 0 or 1 and is described
as follows:
l 0: The short message does
not need to be sent.
l 1: The short message
needs to be sent.

-c send country The code of the country to None.


which a short message is sent.

-r receiver number The short message number of None.


a receiver, namely, the short
message number of a
maintenance person.
You can input multiple
receiver numbers, the total
length is less than 255.

-l sender level The lowest alarm severity for 3.


sending an alarm email.
The value ranges from 3 to 6
and is described as follows:
l 3: Warning.
l 4: Minor.
l 5: Major.
l 6: Critical.

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 7-5


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
7 Alarm Management Commands Command Reference

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
Before running the command chgsms , ensure that the GSM modem is properly installed and
configured. For details, see OceanStor S2600 Storage System Initial Configuration Guide.

Example
Set a short message.

OceanStor: admin> chgsms -c 01 -r 88037312 -l 4

7.2.2 showsms

Function
The command showsms is used to query the settings of a short message sent when an alarm
occurs.

Format
showsms

Parameters
None.

Modes
Normal mode.

Level
Super administrator level, administrator level and guest level.

Usage Guidelines
The command showsms is used to query the settings of a short message notifying an alarm.

Example
Query the setting of a short message notifying an alarm.

OceanStor: admin> showsms


==============================

7-6 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 7 Alarm Management Commands

SMS INFORMATION
------------------------------
Send Country | China
Receiver Number | 88037312
Send Level | Minor
Is Need Send | YES
==============================

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 7-7


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


Downloaded from www.Manualslib.com manuals search engine
OceanStor S2600 Storage System
Command Reference 8 User Management Commands

8 User Management Commands

About This Chapter

User management commands are used to manage user.

8.1 User Adding Command


User adding command is used to add user.
8.2 User Deleting Command
User deleting command is used to delete user.
8.3 User Information Query Command
User information query command is used to query the information about the user.
8.4 User Level Change Command
User level change command is used to change user level.
8.5 User Password Change Command
User password change command is used to change user password.
8.6 User Logout Command
User logout command is used to log out of the current user.

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 8-1


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
8 User Management Commands Command Reference

8.1 User Adding Command


User adding command is used to add user.

8.1.1 adduser

8.1.1 adduser

Function
The command adduser is used to add a user.

Format
adduser -u name -l level

Parameters

Keyword and Value Description Default Value

-u name The user name. The name None.


contains 4 to 32 characters,
including digits, letters,
underscores, and hyphens.
The first character cannot be
a hyphen. The user name
must be unique.

-l level The user level. The value can None.


be 2 or 3 and is described as
follows:
l 2: The administrator level.
l 3: The guest level.

Modes
Normal mode.

Level
Super administrator level.

Usage Guidelines
The command adduser is used to add a user.

8-2 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 8 User Management Commands

1. Run the command adduser -u name -l level to set the user name and the user level, and
then press Enter.
2. The system displays "Input the PassWord." Type the password, and then press Enter.
3. The system displays "Input the PassWord, again." Type the password again, and then press
Enter.

Example
Add a user. The user name is user1, and the user level is guest.

OceanStor: admin> adduser -u user1 -l 3


Input the password:
Input the password again:

8.2 User Deleting Command


User deleting command is used to delete user.

8.2.1 deleteuser

8.2.1 deleteuser

Function
The command deleteuser is used to delete a user.

Format
deleteuser -u name

Parameters

Keyword and Value Description Default Value

-u name The user name. None.

Modes
Normal mode.

Level
Super administrator level.

Usage Guidelines
When using this command, note the following items:

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 8-3


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
8 User Management Commands Command Reference

l Guests cannot delete a user.


l The current user cannot be deleted.

Example
Delete the user whose name is user1.

OceanStor: admin> deleteuser -u user1

8.3 User Information Query Command


User information query command is used to query the information about the user.

8.3.1 showuser

8.3.1 showuser

Function
The command showuser is used to query the information about the user.

Format
showuser [ -u name ]

Parameters

Keyword and Value Description Default Value

-u name The user name. None.

Modes
Normal mode.

Level
Super administrator level, administrator level and guest level.

Usage Guidelines
When using this command, note the following items:

l The command showuser is used to display the basic information about all users.
l The command showuser -u name is used to display the basic information about a specified
user.

8-4 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 8 User Management Commands

Example
Query the information about all users.
OceanStor: admin> showuser
Name Level Status Create Time
admin Admin OnLine 2008-09-27
ivyloo Admin OffLine 1989-12-31
luowei Admin OnLine 1989-12-31
liliang Admin OffLine 1989-12-31
xuhai Admin OffLine 1990-01-05
lishiliang Admin OffLine 1990-01-06
user1 Admin OffLine 1990-01-08

8.4 User Level Change Command


User level change command is used to change user level.

8.4.1 chguserlevel

8.4.1 chguserlevel

Function
The command chguserlevel is used to change the user level.

Format
chguserlevel -u name -l level

Parameters

Keyword and Value Description Default Value

-u name The user name. None.

-l level The user level. The value can None.


be 2 or 3 and is described as
follows:
l 2: The administrator level.
l 3: The guest level.

Modes
Normal mode.

Level
Super administrator level.

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 8-5


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
8 User Management Commands Command Reference

Usage Guidelines
The command chguserlevel is used to change the level of a specified user.

Example
Change the level of user1 to guest.

OceanStor: admin> chglevel -u user1 -l 3

8.5 User Password Change Command


User password change command is used to change user password.

8.5.1 chgpasswd

8.5.1 chgpasswd

Function
The command chgpasswd is used to change the login password of the current user.

Format
chgpasswd

Parameters
None.

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
The command chgpasswd is used to change the login password for the current user only.

Example
Change the login password of the user admin.

OceanStor: admin> chgpasswd


please input old password:
please input new password:
please input new password again:

8-6 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 8 User Management Commands

8.6 User Logout Command


User logout command is used to log out of the current user.

8.6.1 logout

8.6.1 logout

Function
The command logout is used to log out of the current user.

Format
logout

Parameters
None.

Modes
Normal mode.

Level
Guest level and administrator level.

Usage Guidelines
The command logout is used to log out of the current user.

Example
Log out of the current user.
OceanStor: admin> logout

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 8-7


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


Downloaded from www.Manualslib.com manuals search engine
OceanStor S2600 Storage System
Command Reference 9 Value-Added Service Management Commands

9 Value-Added Service Management


Commands

About This Chapter

Value-added service management commands are used to manage the value-added service of the
storage system.

9.1 Hyperimage Configuration Commands


Hyperimage configuration commands are used to create, delete, modify and query Hyperimage
information.
9.2 Hypercopy Configuration Commands
Hypercopy configuration commands are used to create, delete, modify, query Hypercopy
information and label Hypercopy.
9.3 LUN-Expanding Management Commands
LUN-expanding management commands are used to query the information about a expanded
LUN, add or delete a expanded LUN.
9.4 Initiator and target (controller) Configuration Commands
Initiator and target (controller) configuration commands are used to modify the information of
the initiator and target (controller).
9.5 Link information Configuration Commands
Link information configuration commands are used to query and modify link information.
9.6 Other Configuration Commands
Other configuration commands are used to manage some relative information of the storage
system.

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 9-1


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
9 Value-Added Service Management Commands Command Reference

9.1 Hyperimage Configuration Commands


Hyperimage configuration commands are used to create, delete, modify and query Hyperimage
information.

9.1.1 showhyimginfo
9.1.2 chghyimgname
9.1.3 showlunforpool
9.1.4 addluntopool
9.1.5 rmlunfrompool
9.1.6 showpoollun
9.1.7 showpoolinfo
9.1.8 chgpoolalarmvalue
9.1.9 showlunforhyimg
9.1.10 createhyimg
9.1.11 deletehyimg
9.1.12 disablehyimg
9.1.13 cancelrollbackhyimg
9.1.14 rollbackhyimg
9.1.15 recreatehyimg
9.1.16 activehyimg
9.1.17 createhyimgcp
9.1.18 chghyimgrollbackspeed
9.1.19 createtimehyimg
9.1.20 stoptimehyimg
9.1.21 chgtimehyimg
9.1.22 showhyimgoflun
9.1.23 deletetimehyimg
9.1.24 showtimehyimg
9.1.25 showlunoftimehyimg
9.1.26 showlunfortimehyimg

9.1.1 showhyimginfo

9-2 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 9 Value-Added Service Management Commands

Function
The command showhyimginfo is used to query HyperImage information.

Format
showhyimginfo [-i HyperImage ID]

Parameters

Keyword and Value Description Default Value

-i HyperImage ID The HyperImage ID, the value ranges from 0 to 127. None.

Modes
Normal mode.

Level
Super administrator level, administrator level and guest level.

Usage Guidelines
l The showhyimginfo command queries information of all HyperImages.
l The showhyimginfo -i HyperImage ID command queries information of a specific
HyperImage.

Example
Queries information of all HyperImages.

OceanStor: admin> showhyimginfo


Snapshot Name Snapshot ID Type Snapshot Status Time Stamp
HyperImage 12 Public Disable --
HyperImage55 13 Public Active 2008-11-18 15:12:54
CPY_Pair2_Snap 17 Private Active 2008-11-24 16:25:28
Session0_snap00 20 Private Active 2008-11-17 19:53:09
_Lun0004
Session0_snap01 21 Private Disable --
_Lun0004
Session0_snap02 22 Private Disable --
_Lun0004

System Response
None.

9.1.2 chghyimgname

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 9-3


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
9 Value-Added Service Management Commands Command Reference

Function
The command chghyimgname is used to change the HyperImage name.

Format
chghyimgname -i HyperImage ID -n name

Parameters

Keyword and Value Description Default Value

-i HyperImage ID The HyperImage ID. The value ranges from 0 to None.


127.
You can query the information by running the
showhyimginfo command.

-n name The HyperImage name. The name contains 1 to 32 None.


characters, including numbers, letters, underscores,
and hyphens. The first character cannot be a
hyphen.

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
None.

Example
Change the name of the HyperImage with ID of 19 to 456456.

OceanStor: admin> chghyimgname -i 19 -n 456456

System Response
When the command is complete, you can run the showhyimginfo command to view the result.

9.1.3 showlunforpool

9-4 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 9 Value-Added Service Management Commands

Function
The command showlunforpool is used to query all available LUNs that are to be used as source
LUNs and added to the resource pool.

Format
showlunforpool

Parameters
None.

Modes
Normal mode.

Level
Super administrator level, administrator level and guest level.

Usage Guidelines
None.

Example
Query all available LUNs that are to be used as source LUNs and added to the resource pool.

OceanStor: admin> showlunforpool


LUN Name LUN ID Capacity(MB) RAID Group RAID Level
LUN03 2 100 RAID01 RAID0
f3 6 15 RAID01 RAID0
f5 8 10 RAID01 RAID0
f6 9 10 RAID01 RAID0
f7 10 4 RAID01 RAID0

System Response
None.

9.1.4 addluntopool

Function
The command addluntopool is used to add a resource LUN to the resource pool.

Format
addluntopool -i LUN ID -pi pool ID

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 9-5


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
9 Value-Added Service Management Commands Command Reference

Parameters

Keyword and Value Description Default Value

-i LUN ID The LUN ID to be added. The value ranges from 0 None.


to 511.
You can query the information by running the
showlunforpool command.

-pi pool ID The resource pool ID. The value is A or B, and it is None.
case insensitive.

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
None.

Example
Add a resource LUN to pool A. The ID of the LUN is 8.

OceanStor: admin> addluntopool -i 8 -pi a

System Response
None.

9.1.5 rmlunfrompool

Function
The command rmlunfrompool is used to remove a resource LUN from the resource pool.

Format
rmlunfrompool -i LUN ID -pi pool ID

9-6 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 9 Value-Added Service Management Commands

Parameters

Keyword and Value Description Default Value

-i LUN ID The LUN ID. The value ranges from 0 to 511. None.

You can query the information by running the


showpoollun -pi pool ID command.

-pi pool ID The resource pool ID. The value is A or B, and it is None.
case insensitive.

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
None.

Example
Remove the resource LUN with the ID of 8 from resource pool A.

OceanStor: admin> rmlunfrompool -i 8 -pi a

System Response
None.

9.1.6 showpoollun

Function
The command showpoollun is used to query information of resource LUNs in a resource pool.

Format
showpoollun -pi pool ID [-i LUN ID]

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 9-7


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
9 Value-Added Service Management Commands Command Reference

Parameters

Keyword and Value Description Default Value

-pi pool ID The resource pool ID. The value is A or B, and it is None.
case insensitive.

-i LUN ID The LUN ID to be queried. The value ranges from None.


0 to 511.

Modes
Normal mode.

Level
Super administrator level, administrator level and guest level.

Usage Guidelines
l The showpoollun -pi pool ID command queries information of all the resource LUNs in
the resource pool.
l The showpoollun -pi pool ID -i LUN ID command queries information of a specified
resource LUN in the resource pool.

Example
Query information of all the resource LUNs in resource pool A.

OceanStor: admin> showpoollun -pi a


Pool ID Pool LUN ID Pool LUN Status Pool LUN Name
A 8 Free f5

System Response
None.

9.1.7 showpoolinfo

Function
The command showpoolinfo is used to query information on a resource pool.

Format
showpoolinfo -i pool ID

9-8 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 9 Value-Added Service Management Commands

Parameters

Keyword and Value Description Default Value

-i pool ID The resource pool ID. The value is A or B, and it is None.


case insensitive.

Modes
Normal mode.

Level
Super administrator level, administrator level and guest level.

Usage Guidelines
None.

Example
Query information on resource pool A.

OceanStor: admin> showpoolinfo -i a


===================================
Pool Information
-----------------------------------
Pool ID | A
Pool Size(MB) | 2048
Pool Usage(MB) | 0
Pool Alarm(%) | 80
Pool Valid Size(MB) | 2048
===================================

System Response
None.

9.1.8 chgpoolalarmvalue

Function
The command chgpoolalarmvalue is used to set the alarm threshold of a resource pool.

Format
chgpoolalarmvalue -i pool ID -v alarm value

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 9-9


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
9 Value-Added Service Management Commands Command Reference

Parameters

Keyword and Value Description Default Value

-i pool ID The resource pool ID. The value is A or B, and it is None.


case insensitive.

-v alarm value The alarm threshold. The value ranges from 50 to None.
100.

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
None.

Example
Set the alarm threshold of pool A to 70.

OceanStor: admin> chgpoolalarmvalue -i a -v 70

System Response
When the command is complete, you can run the showpoolinfo command to view the result.

9.1.9 showlunforhyimg

Function
The command showlunforhyimg is used to query information of all qualified LUNs that are to
be used as source LUNs of HyperImages. The information includes the LUN name, LUN ID,
capacity, the raid group that the LUN belongs to, and the level of the RAID group.

Format
showlunforhyimg

Parameters
None.

9-10 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 9 Value-Added Service Management Commands

Modes
Normal mode.

Level
Super administrator level, administrator level and guest level.

Usage Guidelines
None.

Example
Query all qualified LUNs that are to be used as source LUNs of HyperImages.

OceanStor: admin> showlunforhyimg


LUN Name LUN ID Capacity(MB) RAID Group RAID Level
LUN01 0 100 RAID01 RAID0
LUN02 1 100 RAID01 RAID0
LUN03 2 100 RAID01 RAID0
h1 3 1000 RAID01 RAID0
f1 4 14 RAID01 RAID0
f3 6 15 RAID01 RAID0
f6 9 10 RAID01 RAID0
f7 10 4 RAID01 RAID0
h2 11 1000 RAID01 RAID0
J1 14 1000 RAID01 RAID0
J2 15 1000 RAID01 RAID0
test 16 100 RAID01 RAID0
e1 23 98 RAID01 RAID0

System Response
None.

9.1.10 createhyimg

Function
The command createhyimg is used to create a HyperImage.

Format
createhyimg -i source LUN ID -n name

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 9-11


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
9 Value-Added Service Management Commands Command Reference

Parameters

Keyword and Value Description Default Value

-i source LUN ID The ID of the source LUN. The value ranges from None.
0 to 511.
You can query the information by running the
showlunforhyimg command.

-n name The HyperImage name. The name contains 1 to 32 None.


characters, including numbers, letters, underscores,
and hyphens. The first character cannot be a
hyphen.

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
None.

Example
Create a HyperImage with the source LUN ID of 9 and name of wwwww.

OceanStor: admin> createhyimg -i 9 -n wwwww

System Response
When the command is complete, you can run the showhyimginfo command to view the result.

9.1.11 deletehyimg

Function
The command deletehyimg is used to delete a HyperImage.

Format
deletehyimg -i HyperImage ID

9-12 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 9 Value-Added Service Management Commands

Parameters

Keyword and Value Description Default Value

-i HyperImage ID The HyperImage ID. The value ranges from 0 to None.


127.
You can query the information by running the
showhyimginfo command.

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
Deleting a HyperImage which is in the active state or rollback state is forbidden.

Example
Delete the HyperImage with the ID of 19.

OceanStor: admin> deletehyimg -i 19

System Response
When the command is complete, you can run the showhyimginfo command to view the result.

9.1.12 disablehyimg

Function
The command disablehyimg is used to stop a HyperImage.

Format
disablehyimg -i HyperImage ID

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 9-13


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
9 Value-Added Service Management Commands Command Reference

Parameters

Keyword and Value Description Default Value

-i HyperImage ID The HyperImage ID. The value ranges from 0 to None.


127.
You can query the information by running the
showhyimginfo command.

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
None.

Example
Stop the HyperImage with the ID of 13.

OceanStor: admin> disablehyimg -i 13


The command has been sent, please wait...

System Response
When the command is complete, you can run the showhyimginfo command to view the result.

9.1.13 cancelrollbackhyimg

Function
The command cancelrollbackhyimg is used to cancel the in-progress rollback of the
HyperImage.

Format
cancelrollbackhyimg -i HyperImage ID

9-14 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 9 Value-Added Service Management Commands

Parameters

Keyword and Value Description Default Value

-i HyperImage ID The HyperImage ID. The value ranges from 0 to None.


127.
You can query the information by running the
showhyimginfo command.

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
None.

Example
Cancel rollback of the HyperImage with ID of 19.

OceanStor: admin> cancelrollbackhyimg -i 19


The command has been sent, please wait...

System Response
None.

9.1.14 rollbackhyimg

Function
The command rollbackhyimg is used to copy data on the HyperImage back to the source LUN,
that is, rolls back the HyperImage.

Format
rollbackhyimg -i HyperImage ID -l speed level

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 9-15


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
9 Value-Added Service Management Commands Command Reference

Parameters

Keyword and Value Description Default Value

-i HyperImage ID The HyperImage ID. The value ranges from 0 to None.


127.
You can query the information by running the
showhyimginfo command.

-l speed level The rollback speed. The value ranges from 1 to 4. 2


l 1 stands for low.
l 2 stands for middle.
l 3 stands for high.
l 4 stands for ASAP.

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
You can only roll back the HyperImage with the Public type and in Active state.

Example
Roll back the HyperImage with the ID of 19. Set rollback speed to high.

OceanStor: admin> rollbackhyimg -i 19 -l 3


The command has been sent, please wait...

System Response
None.

9.1.15 recreatehyimg

Function
The command recreatehyimg is used to recreate a HyperImage.

Format
recreatehyimg -i {HyperImage ID...}

9-16 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 9 Value-Added Service Management Commands

Parameters

Keyword and Value Description Default Value

-i HyperImage ID… The HyperImage ID. This command supports up to None.


eight HyperImage IDs at one time, which are
separated by commas. The value ranges from 0 to
127.
You can query the information by running the
showhyimginfo command.

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
l When the HyperImage is in the activated status, if you want to recreate it , this HyperImage
is stopped, and then activated. The snapshot time is set to the recreated time.
l When the HyperImage is in the stopped status, if you want to recreate it, this HyperImage
is activated. The snapshot time is set to the recreated time.
l When the HyperImage is in the rollback or error status, if you want to recreate it, the system
prompts that recreation fails.

Example
Recreate the HyperImages with the ID of 12 and ID of 27.

OceanStor: admin> recreatehyimg -i 12,27


The command has been sent, please wait...

System Response
When the command is complete, you can run the showhyimginfo command to view the result.

9.1.16 activehyimg

Function
The command activehyimg is used to start a HyperImage.

Format
activehyimg {-i HyperImage ID ...}

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 9-17


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
9 Value-Added Service Management Commands Command Reference

Parameters

Keyword and Value Description Default Value

-i HyperImage ID The HyperImange ID. This command supports up None.


to eight HyperImage IDs, which are separated by
commas.
The value ranges from 0 to 127.
You can query the information by running the
showhyimginfo command.

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
None.

Example
Start the HyperImages with the ID of 12 and ID of 13.

OceanStor: admin> activehyimg -i 12,13


The command has been sent, please wait...

System Response
When the command is complete, you can run the showhyimginfo command to view the result.

9.1.17 createhyimgcp

Function
The command createhyimgcp is used to create a HyperImage copy.

Format
createhyimgcp -i HyperImage ID -n copy name

9-18 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 9 Value-Added Service Management Commands

Parameters

Keyword and Value Description Default Value

-i HyperImage ID The HyperImage ID. The value ranges from 0 to None.


127.
You can query the information by running the
showhyimginfo command.

-n copy name The copy name. The name contains 1 to 32 None.


characters, including numbers, letters, underscores,
and hyphens. The first character cannot be a
hyphen.

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
None.

Example
Create a copy of the HyperImage with the ID of 13 and name of hey.

OceanStor: admin> createhyimgcp -i 13 -n hey


The command has been sent, please wait...

System Response
None.

9.1.18 chghyimgrollbackspeed

Function
The command chghyimgrollbackspeed is used to change rollback speed of the HyperImage.

Format
chghyimgrollbackspeed -i HyperImage ID -l speed level

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 9-19


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
9 Value-Added Service Management Commands Command Reference

Parameters

Keyword and Value Description Default Value

-i HyperImage ID The HyperImage ID. The value ranges from 0 to None.


127.
You can query the information by running the
showhyimginfo command.

-l speed level The rollback rate. The value ranges from 1 to 4. None.

l 1 stands for low.


l 2 stands for middle.
l 3 stands for high.
l 4 stands for ASAP.

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
The command is used only when the HyperImage is in the rollback state.

Example
Set rollback speed of the HyperImage with the ID of 19 to low.

OceanStor: admin> chghyimgrollbackspeed -i 19 -l 1


The command has been sent, please wait...

System Response
None.

9.1.19 createtimehyimg

Function
The command createtimehyimg is used to create a HyperImage according to the source LUN
at a specified point-in-time and time interval.

Format
createtimehyimg {-i source LUN ID...} -n nums -st start time -ti time interval

9-20 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 9 Value-Added Service Management Commands

Parameters

Keyword and Value Description Default Value

-i source LUN ID... The source LUN ID. The format is id0, id1... You None.
can enter up to eight source LUN IDs at a time.
Multiple IDs should be separated with commas.
This indicates the creation of multiple timing
HyperImages at a time. The ID value ranges from
0 to 511.

-n nums The HyperImage number created according to the None.


source LUN. The value ranges from 1 to 8.

-st start time The start time. The format is YYYY-MM-DD/ None.
hh:mm:ss.
The start time must be later than the current time
shown on the device.

-ti time interval The time interval. The value ranges from 30 to None.
43200. The unit is minute (min).

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
Unless terminated by the user, the command continually creates the HyperImage at a specified
time interval.

Example
Create HyperImages. The source LUN IDs are 10 and 11, and the HyperImage number is 3. The
start time is 5:00, 11 AM, May 26th, 2009, and the time interval is 30 minutes.

OceanStor: admin> createtimehyimg, -i 10,11 -n 3 -st 2009-05-26/11:05:00 -ti 30

System Response
In this application scenario, the number of snapshots created in each source LUN is 3, and the
interval is 30 minutes, indicating that snapshot data in the latest 90 (3 x 30) minutes is to be
saved. The time to activate the snapshot is 11:05:00, May 26, 2009; therefore three snapshots
are created respectively at 11:05:00, 11:35:00, and 12:05:00. Then, the snapshot data created at
11:05:00 is updated by that created at 12:35:00, the snapshot data created at 11:35:00 is updated
by that created at 13:05:00, and the like.

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 9-21


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
9 Value-Added Service Management Commands Command Reference

9.1.20 stoptimehyimg

Function
The command stoptimehyimg is used to stop a timing HyperImage.

Format
stoptimehyimg -i session ID

Parameters

Keyword and Value Description Default Value

-i session ID The session ID. The value ranges from 0 to 7. None.

You can query the information by running the


showtimehyimg command.

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
None.

Example
Stop creating the timing HyperImage with the ID of 1.

OceanStor: admin> stoptimehyimg -i 1

System Response
When the command is complete, you can run the showtimehyimg command to view the result.

9.1.21 chgtimehyimg

Function
The command chgtimehyimg is used to modify information on a timing HyperImage.

9-22 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 9 Value-Added Service Management Commands

Format
chgtimehyimg -si session ID [-n maximum numbers] [-ti time interval] [-i source LUN ID] [-
st start time]

Parameters

Keyword and Value Description Default Value

-si session ID The section ID. The value ranges from 0 to 7. None.

-n maximum numbers The HyperImage number. The value ranges from 1 None.
to 8.

-ti time interval The time interval. The value ranges from 30 to None.
43200. The unit is minute (min).

-i source LUN ID The source LUN ID.The format is id0, id1... You None.
can enter up to eight source LUN IDs at a time. The
value ranges from 0 to 511.

-st start time The start time. The format is YYYY-MM-DD/ None.
hh:mm:ss.
The start time must be later than the current time
shown on the device.

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
l The chgtimehyimg command modifies the information on a timing HyperImage. The
information includes the source LUN ID, the number of the HyperImages to be created,
the time interval, and start time.
l This command is available only when the HyperImage is stopped. After being modified,
the timing HyperImage task resumes, and the data in the original HyperImage is updated.
l The time to activate the timing HyperImage must be later than the current time shown on
the device.

Example
Change the time interval of creating the HyperImage for the session with the ID of 1 to 40
minutes.

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 9-23


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
9 Value-Added Service Management Commands Command Reference

OceanStor: admin> chgtimehyimg -si 1 -ti 40


The command has been sent, please wait...

System Response
When the command is complete, you can run the showtimehyimg command to view the result.

9.1.22 showhyimgoflun

Function
The command showhyimgoflun is used to query the HyperImage information of a specified
source LUN.

Format
showhyimgoflun -i source lun ID

Parameters

Keyword and Value Description Default Value

-i source lun ID The ID of the source LUN. The ID value ranges None.
from 0 to 511.

Modes
Normal mode.

Level
Super administrator level, administrator level and guest level.

Usage Guidelines
None.

Example
Query the HyperImage information of the source LUN with the ID of 10.

OceanStor: admin> showhyimgoflun -i 10


Snapshot Name Snapshot ID Type Snapshot Status Time Stamp
Session1_snap00 28 Private Disable --
_Lun0010
Session1_snap01 30 Private Disable --
_Lun0010
Session1_snap02 32 Private Disable --
_Lun0010

9-24 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 9 Value-Added Service Management Commands

System Response
None.

9.1.23 deletetimehyimg

Function
The command deletetimehyimg is used to delete a timing HyperImage.

Format
deletetimehyimg -i session ID

Parameters

Keyword and Value Description Default Value

-i session ID The session ID. The value ranges from 0 to 7. None.

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
None.

Example
Delete the timing HyperImage with the ID of 0.

OceanStor: ad> deletetimehyimg -1 0

System Response
None.

9.1.24 showtimehyimg

Function
The command showtimehyimg is used to query information on a timing HyperImage.

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 9-25


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
9 Value-Added Service Management Commands Command Reference

Format
showtimehyimg [-i session ID]

Parameters

Keyword and Value Description Default Value

-i session ID The session ID. The value ranges from 0 to 7. None.

Modes
Normal mode.

Level
Super administrator level, administrator level and guest level.

Usage Guidelines
l The showtimehyimg command queries information on all the timing HyperImages.
l The showtimehyimg -i session ID command queries information on the HyperImages with
a specified session ID.

Example
Query information on all the timing HyperImages.

OceanStor: admin> showtimehyimg


Session ID Source LUN ID Snapshot Times Start Time Time Interval(s)
0 4, 3 2008-11-17 200
19:53:09
1 10,11, 3 2008-11-26 40
11:05:00

System Response
None.

9.1.25 showlunoftimehyimg

Function
The command showlunoftimehyimg is used to query the LUN information on the timing
HyperImage with a specified session ID.

Format
showlunoftimehyimg -i session ID

9-26 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 9 Value-Added Service Management Commands

Parameters

Keyword and Value Description Default Value

-i session ID The session ID. The value ranges from 0 to 7. None.

Modes
Normal mode.

Level
Super administrator level, administrator level and guest level.

Usage Guidelines
None.

Example
Query the LUN information of the timing HyperImage with the ID of 1.

OceanStor: admin> showlunoftimehyimg -i 1


Session ID Source LUN Name Source LUN ID Snapshot Name Snapshot ID
1 f7 10 Session1_snap 28
00_Lun0010
1 h2 11 Session1_snap 29
00_Lun0011
1 f7 10 Session1_snap 30
01_Lun0010
1 h2 11 Session1_snap 31
01_Lun0011
1 f7 10 Session1_snap 32
02_Lun0010
1 h2 11 Session1_snap 33
02_Lun0011

System Response
None.

9.1.26 showlunfortimehyimg

Function
The command showlunfortimehyimg is used to query qualified LUNs for the source LUN of
a timing HyperImage.

Format
showlunfortimehyimg

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 9-27


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
9 Value-Added Service Management Commands Command Reference

Parameters
None.

Modes
Normal mode.

Level
Super administrator level, administrator level and guest level.

Usage Guidelines
None.

Example
Query qualified LUNs in the system for the source LUN of a timing HyperImage.

OceanStor: admin> showlunfortimehyimg


LUN Name LUN ID Capacity(MB) RAID Group RAID Level
LUN01 0 100 RAID01 RAID0
LUN02 1 100 RAID01 RAID0
LUN03 2 100 RAID01 RAID0
h1 3 1000 RAID01 RAID0
f3 6 15 RAID01 RAID0
f6 9 10 RAID01 RAID0
J1 14 1000 RAID01 RAID0
J2 15 1000 RAID01 RAID0
test 16 100 RAID01 RAID0
e1 23 98 RAID01 RAID0

System Response
None.

9.2 Hypercopy Configuration Commands


Hypercopy configuration commands are used to create, delete, modify, query Hypercopy
information and label Hypercopy.

9.2.1 showhycpinfo
9.2.2 showhycpluninfo
9.2.3 chghycpinfo
9.2.4 deletehycplun
9.2.5 deletehycp
9.2.6 chghycpstatus
9.2.7 showlunforhycp
9.2.8 createhycp

9-28 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 9 Value-Added Service Management Commands

9.2.9 taghycp
9.2.10 addhycplun

9.2.1 showhycpinfo

Function
The command showhycpinfo is used to query the HyperCopy information.

Format
showhycpinfo [-i HyperCopy ID]

Parameters

Keyword and Value Description Default Value

-i HyperCopy ID The HyperCopy ID. The value ranges from 0 to 63. None.
You can query the information by running the
showhycpinfo command.

Modes
Normal mode.

Level
Super administrator level, administrator level and guest level.

Usage Guidelines
l The showhycpinfo command queries basic information of all HyperCopies. The
information includes the name, ID, type, state, and status of the HyperCopies.
l The showhycpinfo -i HyperCopy ID command queries detailed information of a specific
HyperCopy. The information includes the HyperCopy ID, HyperCopy name, source LUN
ID, source LUN name, source LUN array name, source LUN array WWN, source LUN
type, source LUN status, source LUN capacity, HyperCopy user, HyperCopy speed,
HyperCopy pair state, HyperCopy status, mark state, marking time, start time, and end time.
Considering a full HyperCopy, if the source LUN is an external LUN, the information
(including link ID, link status, link type, and external array WWN) of the external array
that the source LUN belongs to is displayed.

Example
Query detailed information of the HyperCopy with the ID of 2.

OceanStor: admin> showhycpinfo -i 2


==============================================

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 9-29


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
9 Value-Added Service Management Commands Command Reference

HyperCopy Information
----------------------------------------------
HyperCopy ID | 2
HyperCopy Name | full1
Source LUN ID | --
Source LUN Link ID | 0
Source LUN Link Status | Normal
Source LUN Link Type | FC
Source LUN Array Name | --
Source LUN Array WWN | 2100135790864213
Source LUN WWN | --
Source LUN WWPN | --
Source LUN Number | --
Source LUN Type | External LUN
Source LUN Name | src0
Source LUN Status | Normal
Source LUN Capacity(MB) | 1024
HyperCopy User | Public
HyperCopy Speed | Middle
HyperCopy State | Created
HyperCopy Status | Normal
HyperCopy Progress(%) | 0
HyperCopy Type | Full
Mark | No
MarkTime | --
StartTime | --
EndTime | --
==================================================

System Response
None.

9.2.2 showhycpluninfo

Function
The command showhycpluninfo is used to query information on the target LUN of the
HyperCopy.

Format
showhycpluninfo -i HyperCopy ID [-ti LUN ID]

Parameters

Keyword and Value Description Default Value

-i HyperCopy ID The HyperCopy ID. The value ranges from 0 to 63. None.
You can query the information by running the
showhycpinfo command.

9-30 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 9 Value-Added Service Management Commands

Keyword and Value Description Default Value

-ti LUN ID The target LUN ID. When the target LUN is a None.
"internal LUN", the value ranges from 0 to 511.
When the target LUN is a "external LUN" or "third-
part LUN", the value ranges from 100000 to
101023.
You can query the information by running the
showhycpluninfo command.

Modes
Normal mode.

Level
Super administrator level, administrator level and guest level.

Usage Guidelines
l The showhycpluninfo -i HyperCopy ID command queries basic information of all target
LUNs for HyperCopies, including the LUN name, LUN ID, link ID, link state, target LUN
capacity, and status of the target LUN.
l The showhycpluninfo -i HyperCopy ID -ti LUN ID queries detailed information of a
specific target LUN for the HyperCopy. The information includes the name, type, capacity,
state, number, WWN, and WWPN of the target LUN. If the target LUN is in an external
array, the information (including the external link ID, link type, link status, and external
array WWN) of the external array is displayed.

Example
Query detailed information of the external target LUN with the ID of 101023 on the HyperCopy
with the ID of 1.

OceanStor: admin> showhycpluninfo -i 1 -ti 101023


===================================================
HyperCopy LUN Information
---------------------------------------------------
HyperCopy ID | 1
Destination LUN Name | src0
Destination LUN ID | 101023
Destination LUN Link ID | 0
Destination LUN Link Status | Normal
Destination LUN Link Type | FC
Destination LUN Type | External LUN
Destination LUN Capacity(MB) | 1024
Destination LUN Status | Normal
Destination LUN WWN | --
Destination LUN WWPN | --
Destination LUN Number | --
Array Name | --
Array WWN | 2100135790864213
===================================================

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 9-31


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
9 Value-Added Service Management Commands Command Reference

System Response
If the target LUN is in an external array that belongs to another S2600 device, the link type, link
ID, and link status of the target LUN can be displayed.

9.2.3 chghycpinfo

Function
The command chghycpinfo is used to change properties of the HyperCopy.

Format
chghycpinfo -i HyperCopy ID {[-n the HyperCopy name] [-s the HyperCopy speed] [-t the
HyperCopy type [-is initially synchronize]]}

Parameters

Keyword and Value Description Default Value

-i HyperCopy ID The HyperCopy ID. The value ranges from 0 to None.


63.
You can query the information by running the
showhycpinfo command.

-n the HyperCopy name The HyperCopy name. The name contains 1 to 32 None.
characters, including numbers, letters,
underscores, and hyphens. The first character
cannot be a hyphen.

-s the HyperCopy speed The HyperCopy speed. The value ranges from 1 None.
to 4.
l 1 stands for low.
l 2 stands for middle.
l 3 stands for high.
l 4 stands for ASAP.
NOTE
ASAP is short for As Soon As Possible.

-t the HyperCopy type The HyperCopy type. The value can be 1 or 2. None.

l The value 1 stands for full copy.


l The value 2 stands for increment copy.

9-32 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 9 Value-Added Service Management Commands

Keyword and Value Description Default Value

-is initially synchronize The parameter decides whether to perform initial None.
synchronization. The value can be 1 or 0.
l The value 0 stands for no.
l The value 1 stands for yes.
The parameter takes effect only when the
HyperCopy type is changed from full copy to
increment copy.

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
NOTE
The prerequisites are as follows:
l Name modification: The HyperCopy should be in created mode, copy completed mode or stop mode.
l Speed modification: The HyperCopy should be in normal mode.

l Type modification: The HyperCopy should be in created mode, copy completed mode or stop mode.

l The chghycpinfo -i HyperCopy ID -n the HyperCopy name command modifies the


HyperCopy name.
l The chghycpinfo -i HyperCopy ID -s the HyperCopy speed command modifies the
HyperCopy speed.
l The chghycpinfo -i HyperCopy ID -t the HyperCopy type command modifies the
HyperCopy type.
l The chghycpinfo -i HyperCopy ID -t the HyperCopy type [-is initially synchronize]
command to decide whether to perform initial synchronization when the HyperCopy type
is changed from full copy to incremental copy. (A source LUN can be shared by an
incremental copy task and multiple full copy tasks, but cannot be shared by multiple
incremental copy tasks. When changing from full copy to incremental copy, check whether
the source LUN is occupied by other incremental copy tasks.)

Example
Change the HyperCopy type with the ID of 2 to incremental copy, and perform initial
synchronization.

OceanStor: admin> chghycpinfo -i 2 -t 2 -is 1


The command has been sent, please wait...

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 9-33


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
9 Value-Added Service Management Commands Command Reference

System Response
None.

9.2.4 deletehycplun

Function
The command deletehycplun is used to delete the target LUN of a HyperCopy.

Format
deletehycplun -i HyperCopy ID -ti target LUN ID

Parameters

Keyword and Value Description Default Value

-i HyperCopy ID The HyperCopy ID. The value ranges from 0 to 63. None.
You can query the information by running the
showhycpinfo command.

-ti target LUN ID The target LUN ID. None.

When the LUN is "internal LUN", the value ranges


from o to 511. When the LUN is "external LUN" or
"third-part LUN", the value ranges from 100000 to
101023.
You can query the information by running the
showhycpluninfo command.

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
l Before deleting, you can run the showhycpluninfo command to query the correct target
LUN ID, thus preventing deletion by mistake.
l Failure of a certain target LUN might cause fault of the HyperCopy task. When the failed
target LUN is deleted, the HyperCopy task is started automatically.

Example
Delete the target LUN with the ID of 0 of the HyperCopy with the ID of 0.

9-34 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 9 Value-Added Service Management Commands

OceanStor: admin> deletehycplun -i 0 -ti 0

System Response
When the command is complete, you can run the showhycpluninfo command to view the result.

9.2.5 deletehycp

Function
The command deletehycp is used to delete a HyperCopy.

Format
deletehycp -i HyperCopy ID

Parameters

Keyword and Value Description Default Value

-i HyperCopy ID The HyperCopy ID. The value ranges from 0 to 63. None.
You can query the information by running the
showhycpinfo command.

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
When the HyperCopy is in copying mode or waiting mode, deletion is forbidden.

Example
Delete the HyperCopy with the ID 0.

OceanStor: admin> deletehycp -i 0


The command has been sent, please wait...

System Response
When the command is complete, you can run the showhycpinfo command to view the result.

9.2.6 chghycpstatus

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 9-35


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
9 Value-Added Service Management Commands Command Reference

Function
The command chghycpstatus is used to change the HyperCopy status.

Format
chghycpstatus -i HyperCopy ID -s|-e|-p|-c

Parameters

Keyword and Value Description Default Value

-i HyperCopy ID The HyperCopy ID. The value ranges from 0 to 63. None.
You can query the information by running the
showhycpinfo command.

-s The parameter starts the HyperCopy. None.

-e The parameter ends the HyperCopy. None.

-p The parameter suspends the HyperCopy. None.

-c The parameter resumes the HyperCopy. None.

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
Before starting the HyperCopy:
l Ensure that the HyperCopy is in created mode, copy completed mode, or stop mode.
l Create a resource pool for incremental copy.
l If the maximum number of the HyperCopy tasks supported by the controller is reached,
the HyperCopy tasks is waiting. After a certain HyperCopy task in the copy mode is
complete, a HyperCopy task in the waiting mode is automatically started.
Before ending the HyperCopy:
The HyperCopy should be in created mode, copy completed mode, or stop mode.
When suspending the HyperCopy:
Ensure that the HyperCopy is in waiting or copying mode.
Before resuming the HyperCopy:

9-36 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 9 Value-Added Service Management Commands

Ensure that the HyperCopy is in normally suspended mode.

Example
Set the type of the HyperCopy with ID of 1 to Start.

OceanStor: admin> chghycpstatus -i 1 -s

System Response
None.

9.2.7 showlunforhycp

Function
The command showlunforhycp is used to query information of all qualified LUNs for achieving
the HyperCopy function. The information includes the LUN ID, LUN name, and capacity. You
can add the -li parameter to query information of other qualified LUNs for achieving the
HyperCopy function.

Format
showlunforhycp -t hypercopy type -m|-s [-li link ID]

Parameters

Keyword and Value Description Default Value

-t The HyperCopy type. The value can be 1 or 2. None.

l The value 1 stands for full copy.


l The value 2 stands for increment copy.

-m The source LUN of the HyperCopy. None.

-s The target LUN of the HyperCopy. None.

-li The link ID between devices. The value ranges from None.
0 to 255.
You can query the information by running the
showlinkinfo command.
NOTE
If you don not input this parameter, indicates querying the
LUN on local device. Otherwise, indicates querying the
LUN on remote device.

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 9-37


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
9 Value-Added Service Management Commands Command Reference

Modes
Normal mode.

Level
Super administrator level, administrator level and guest level.

Usage Guidelines
l The showlunforhycp -t hypercopy type -m command queries information of all qualified
source LUNs for achieving the HyperCopy function in the system.
l The showlunforhycp -t hypercopy type -s command queries information of all qualified
target LUNs for achieving the HyperCopy function in the system.
l The showlunforhycp -t hypercopy type -m -li link ID command queries information of all
qualified source LUNs for achieving the HyperCopy function in a remote array.
l The showlunforhycp -t hypercopy type -s -li link ID command queries information of all
qualified target LUNs for achieving the HyperCopy function in a remote array.

Example
Queries information of all qualified source LUNs for achieving the full copy function in the
system.

OceanStor: admin> showlunforhycp -t 1 -m


LUN Name LUN ID LUN Type Capacity(MB) RAID Group RAID Level Copy Type
LUN01 0 Master 100 RAID01 RAID0 Full
LUN02 1 Master 100 RAID01 RAID0 Full
LUN03 2 Master 100 RAID01 RAID0 Full
h1 3 Master 1000 RAID01 RAID0 Full
f1 4 Master 14 RAID01 RAID0 Full
f3 6 Master 15 RAID01 RAID0 Full
f5 8 Master 10 RAID01 RAID0 Full
f6 9 Master 10 RAID01 RAID0 Full
f7 10 Master 4 RAID01 RAID0 Full
h2 11 Master 1000 RAID01 RAID0 Full
HyperImage 12 Master 100 Unknown Full
HyperImage 13 Master 14 Unknown Full
55
J1 14 Master 1000 RAID01 RAID0 Full
J2 15 Master 1000 RAID01 RAID0 Full
test 16 Master 100 RAID01 RAID0 Full
Session0_s 20 Master 14 Unknown Full
nap00_Lun0
004
Session0_s 21 Master 14 Unknown Full
nap01_Lun0
004
Session0_s 22 Master 14 Unknown Full
nap02_Lun0
004
e1 23 Master 98 RAID01 RAID0 Full

System Response
None.

9.2.8 createhycp

9-38 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 9 Value-Added Service Management Commands

Function
The createhycp command creates the HyperCopy based on local S2600 storage systems, other
S2600 storage systems, and remote storage systems.

Format
createhycp -n Hycp name [-ct copy type] [-sl speed level] [-is initially synchronized ] [-sli source
LUN link ID -si source LUN ID]|-si source LUN ID| -swwn source LUN WWN | [-swwpn source
LUN WWPN -sln source LUN number] [-tli target LUN link ID -ti target LUN ID]|-ti target
LUN ID| -twwn target LUN WWN | [-twwpn target LUN WWPN -tln target LUN number]

Parameters

Keyword and Value Description Default Value

-n Hycp name The HyperCopy name. The name contains 1 None.


to 32 characters, including numbers, letters,
underscores, and hyphens. The first character
cannot be a hyphen.

-ct copy type The HyperCopy type. The value can be 1 or 1


2.
l 1 stands for full copy.
l 2 stands for incremental copy.

-sl speed level The HyperCopy speed. The value ranges 2


from 1 to 4.
l 1 stands for low.
l 2 stands for middle.
l 3 stands for high.
l 4 stands for ASAP.

-is initially synchronized This parameter decides whether to perform 1


initial synchronization. The parameter takes
effect only when the HyperCopy type is
changed from full copy to incremental
copy. The value can be 0 or 1.
l 0 stands for no.
l 1 stands for yes.

-sli source LUN link ID The link ID of the source LUN. The value None.
ranges from 0 to 255.

-si source LUN ID The sourceLUN ID. The value ranges from None.
0 to 511.

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 9-39


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
9 Value-Added Service Management Commands Command Reference

Keyword and Value Description Default Value

-swwn source LUN WWN The source LUN WWN. This command is None.
used only when the source LUN is in a third-
party array. The value includes 32
hexadecimal numbers, each two number are
grouped, and groups are separated by colons.

-swwpn source LUN WWPN The source LUN WWPN. This command is None.
used only when the source LUN is in a third-
party array. The value includes 16
hexadecimal numbers.

-sln source LUN number The source LUN number. This number is None.
available only when the swwppn parameter
is valid. The value ranges from 0 to 511.

-tli target LUN link ID The link ID of the target LUN. The value None.
ranges from 0 to 255.

-ti target LUN ID The target LUN ID. The value ranges from 0 None.
to 511.

-twwn target LUN WWN The target LUN WWN. This command is None.
used only when the target LUN is in a third-
party array. The value includes 32
hexadecimal numbers, each two number are
grouped, and groups are separated by colons.

-twwpn target LUN WWPN The target LUN WWPN. This command is None.
used only when the target LUN is in a third-
party array. The value includes 16
hexadecimal numbers

-tln target LUN number The target LUN number. This number is used None.
only when the twwpn parameter is valid. The
value ranges from 0 to 511.

Modes
Normal mode.

Level
Super administrator level and administrator level.

9-40 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 9 Value-Added Service Management Commands

Usage Guidelines
l At least one of the source LUN and target LUN is in the local S2600 storage system. If the
HyperCopy type is incremental copy, the source LUN must be in the local S2600 storage
system.
l The target LUN must be no smaller than the source LUN.
l A target LUN cannot be shared by multiple HyperCopy tasks.
l A source LUN cannot be shared by multiple incremental HyperCopy tasks.

Example
Create a HyperCopy of which the name is full_between_S2600, copy type is full copy, source
LUN ID is 1, target LUN link ID is 0, and target LUN ID is 2.

OceanStor: admin> createhycp -n full_between_S2600 -si 1 -tli 0 -ti 2


The command has been sent, please wait...

System Response
When the command is complete, you can run the showhycpinfo command to view the result.

9.2.9 taghycp

Function
The command taghycp is used to tag a HyperCopy.

Format
taghycp -i HyperCopy ID

Parameters

Keyword and Value Description Default Value

-i HyperCopy ID The HyperCopy ID. The value ranges from 0 to 63. None.
You can query the information by running the
showhycpinfo command.

Modes
Normal mode.

Level
Super administrator level and administrator level.

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 9-41


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
9 Value-Added Service Management Commands Command Reference

Usage Guidelines
l This command is valid only for an incremental HyperCopy. The incremental HyperCopy
should be in created mode, copy completed mode or stop mode.
l If the HyperCopy is tagged at point-in-time A, and is started later at point-in-time B, the
storage system copies data at point-in-time A on the source LUN to the target LUN.

Example
Tag the HyperCopy with the ID of 2.

OceanStor: admin> taghycp -i 2


The command has been sent, please wait...

System Response
You can execute the showhycpinfo -i HyperCopyID command to check whether the HyperCopy
is marked (Mark and Mark Time).

9.2.10 addhycplun

Function
The command addhycplun is used to add a target LUN to the HyperCopy.

Format
addhycplun -i HyperCopy ID -ti target LUN ID| [-tli target LUN link ID -ti target LUN ID] |-
twwn target LUN WWN | [-twwpn target LUN WWPN -tln target LUN number]

Parameters

Keyword and Value Description Default Value

-i HyperCopy ID The HyperCopy ID. The value ranges from 0 None.


to 63.
You can query the information by running the
showhycpinfo command.

-ti target LUN ID The target LUN ID. When the target LUN is None.
"internal LUN", the value ranges from 0 to
511. When the target LUN is "external LUN",
the value ranges from 100000 to 101023.
You can query the information by running the
showlunforhycp command.

9-42 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 9 Value-Added Service Management Commands

Keyword and Value Description Default Value

-tli target LUN link ID The link ID of the target LUN. This command None.
is used only when the target LUN is in another
S2600 array. The value ranges from 0 to 255.

-twwn target LUN WWN The WWN of the target LUN. This command None.
is used only when the target LUN is in a third-
party array. The value consists of 32
hexadecimal numbers, every two numbers are
grouped, and groups are separated by colons.

-twwpn target LUN WWPN The WWPN of target LUN. This command is None.
used only when the target LUN is in a third-
party array. The value consists of 16
hexadecimal numbers.

-tln target LUN number The number of the target LUN. This command None.
is used only when twwpn is valid. The value
ranges from 0 to 511.

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
l If the copy type is full copy and the source LUN is not an internal LUN, the target LUN
must be an internal LUN.
l The HyperCopy should be in the created mode, copy completed mode or stop mode.
l The number of target LUNs has an upper threshold. For the S2600, the maximum is 64.
l A target LUN cannot be shared by multiple HyperCopy processes.
l When adding an external LUN, check the configurations and link status of the external
array, and query the information by using the tli, ti, wwpn, wwn, and tln parameters.

Example
The HyperCopy with the ID of 0 is added with the target LUNs with link ID of 0 and ID of 1.

OceanStor: admin> addhycplun -i 0 -tli 0 -ti 1


The command has been sent, please wait...

System Response
When the command is complete, you can run the showhycpluninfo command to view the result.

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 9-43


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
9 Value-Added Service Management Commands Command Reference

9.3 LUN-Expanding Management Commands


LUN-expanding management commands are used to query the information about a expanded
LUN, add or delete a expanded LUN.

9.3.1 showexpluninfo
9.3.2 showexplunmember
9.3.3 rmlunfromexplun
9.3.4 showlunforexplun
9.3.5 addluntoexplun
9.3.6 showexplunnum

9.3.1 showexpluninfo

Function
The command showexpluninfo is used to query detailed information on an expanded LUN.

Format
showexpluninfo [-i expanded LUN ID ]

Parameters

Keyword and Value Description Default Value

-i expanded LUN ID The ID of the expanded LUN. The value ranges None.
from 0 to 127.

Modes
Normal mode.

Level
Super administrator level, administrator level and guest level.

Usage Guidelines
l The showexpluninfo command queries detailed information of the expanded LUNs in the
system.
l The showexpluninfo -i expanded LUN ID command queries detailed information of a
specified expanded LUNs in the system.

9-44 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 9 Value-Added Service Management Commands

Example
Queries detailed information of all the expanded LUNs in the system.

OceanStor: admin> showexpluninfo


Expand Name Expand ID Capacity(MB) Status Controller
e1 23 63 Normal A

System Response
None.

9.3.2 showexplunmember

Function
The command showexplunmember is used to query detailed information on member LUNs of
an expanded LUN.

Format
showexplunmember -i expanded LUN ID [-mi member LUN ID ]

Parameters

Keyword and Value Description Default Value

-i expanded LUN ID The ID of the expanded LUN. The value ranges None.
from 0 to 127.
You can query the information by running the
showexpluninfo command.

-mi member LUN ID The ID of the member LUN. The value ranges from None.
0 to 127.
You can query the information by running the
showexplunmember command.

Modes
Normal mode.

Level
Super administrator level, administrator level and guest level.

Usage Guidelines
NOTE

For other information on LUNs, you can query the information by running the showlun command.

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 9-45


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
9 Value-Added Service Management Commands Command Reference

l The showexplunmember -i expanded LUN ID command queries detailed information of


all the member LUNs in an expanded LUN, including the member LUN ID, name, master-
slave mode, capacity, RAID group that the member LUN belongs to, and level of the RAID
group.
l The showexplunmember -i expanded LUN ID -mi member LUN ID command queries
detailed information on a specified member LUN in an expanded LUN, including the
member LUN ID, name, master-slave mode, capacity, RAID group that the member LUN
belongs to, and level of the RAID group.

Example
Query detailed information of the member LUNs in the expanded LUN with the ID of 23 .

OceanStor: admin> showexplunmember -i 23


LUN Name LUN ID Relation Capacity(MB) RAID Group RAID Level
e1 25 Master 12 RAID01 RAID0
e2 24 Slave 13 RAID01 RAID0
f2 5 Slave 10 RAID01 RAID0
f4 7 Slave 5 RAID01 RAID0
f8 18 Slave 23 RAID01 RAID0

System Response
None.

9.3.3 rmlunfromexplun

Function
The command rmlunfromexplun is used to remove the last slave LUN or all slave LUNs from
the expanded LUN.

Format
rmlunfromexplun -i expanded LUN ID [-si slave LUN ID ]

Parameters

Keyword and Value Description Default Value

-i expanded LUN ID The ID of the expanded LUN. The value ranges None.
from 0 to 511.
You can query the information by running the
showexpluninfo command.

-si slave LUN ID The ID of the last slave LUN to the expanded LUN. None.
The value ranges from 0 to 511.
You can query the information by running the
showexplunmember command.

9-46 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 9 Value-Added Service Management Commands

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
l The rmlunfromexplun -i expanded LUN ID command removes all slave LUNs from the
expanded LUN.
l The rmlunfromexplun -i expanded LUN ID -si slave LUN ID removes the last slave LUN
from the expanded LUN.

Example
Remove the last slave LUN with the ID of 18 from the expanded LUN with the ID of 23.

OceanStor: admin> rmlunfromexplun -i 23 -si 18


The command has been sent, please wait...

System Response
None.

9.3.4 showlunforexplun

Function
The command showlunforexplun is used to query the slave LUN which can used to expand
LUN.

Format
showlunforexplun

Parameters

Keyword and Value Description Default Value

None. None. None.

Modes
Normal mode.

Level
Super administrator level, administrator level and guest level.

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 9-47


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
9 Value-Added Service Management Commands Command Reference

Usage Guidelines
None.

Example
To query the slave LUN that can be used to expand LUN in the system.

OceanStor: admin> showlunforexplun


LUN Name LUN ID Capacity(MB) RAID Group RAID Level
targetLu 12 1024 RAIDXX RAID5

System Response
None.

9.3.5 addluntoexplun

Function
The command addluntoexplun is used to add a slave LUN to the expanded LUN.

Format
addluntoexplun -i expanded LUN ID -si slave LUN ID

Parameters

Keyword and Value Description Default Value

-i expanded LUN ID The ID of the expanded LUN. The value ranges None.
from 0 to 511.
You can query the information by running the
showexpluninfo command.

-si slave LUN ID The ID of the slave LUN. The value ranges from 0 None.
to 511.
You can query the information by running the
showlunforexplun command.

Modes
Normal mode.

Level
Super administrator level and administrator level.

9-48 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 9 Value-Added Service Management Commands

Usage Guidelines
None.

Example
Add a slave LUN to the expanded LUN with the ID of 23. The ID of the slave LUN is 26.

OceanStor: admin> addluntoexplun -i 23 -si 26


The command has been sent, please wait...

System Response
When the command is complete, you can run the showexplunmember command to view the
result.

9.3.6 showexplunnum

Function
The command showexplunnum is used to query the LUN number in an expanded LUN.

Format
showexplunnum -i expanded LUN ID

Parameters

Keyword and Value Description Default Value

-i expanded LUN ID The ID of the expanded LUN. The value ranges None.
from 0 to 511.
You can query the information by running the
showexpluninfo command.

Modes
Normal mode.

Level
Super administrator level, administrator level and guest level.

Usage Guidelines
None.

Example
Query the LUN number of the expanded LUN with the ID of 23.

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 9-49


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
9 Value-Added Service Management Commands Command Reference

OceanStor: admin> showexplunnum -i 23


The number of this expanded LUN is 6

System Response
None.

9.4 Initiator and target (controller) Configuration


Commands
Initiator and target (controller) configuration commands are used to modify the information of
the initiator and target (controller).

9.4.1 addtgt
9.4.2 showtgt
9.4.3 connecttgt
9.4.4 chgtgt
9.4.5 disconnecttgt
9.4.6 chgiscsiininame
9.4.7 showiscsiname
9.4.8 deletetgtinfo
9.4.9 chgini

9.4.1 addtgt

Function
The command addtgt is used to add a related target (controller) to the initiator.

Format
addtgt -c controller ID -p port ID -ip IP address [-port TCP/IP port] [-m recovery mode] [-
chap yes or no] [-user user -pwd password]

Parameters

Keyword and Value Description Default Value

-c controller ID The controller ID. The value is A or B, and it is case None.


insensitive.

9-50 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 9 Value-Added Service Management Commands

Keyword and Value Description Default Value

-p port ID The ID for the iSCSI host port. The value can be 00, None.
01, 10, or 11.

-ip IP address The IP of the iSCSI target to be added. The format None.
is xx.xx.xx.xx.

-port port The TCP/IP port of the iSCSI target to be added. 3260
The value ranges from 0 to 65535.

-m recovery mode The link recovery policy. The value can be 1 or 2. 2


l The value 1 stands for the auto mode.
l The value 2 stands for the manual mode.

-chap yes or no The command enables or disables the CHAP 0


authentication. The value can be 0 or 1.
l The value 0 stands for no. The CHAP
authentication is disabled.
l The value 1 stands for yes. The CHAP
authentication is enabled.

-user user The CHAP user name. It contains 4 to 25 characters, None.


including numbers, letters, underscores. The first
character cannot be a hyphen.

-pwd password The CHAP password. It contains 12 to 16 None.


characters.

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
None.

Example
Add a target to the initiator on controller A. The IP of the target is 128.12.13.25, the iSCSI host
port ID is 00, and the TCP/IP port is 3260. The link recovery policy is manual, and the CHAP
authentication is disabled.

OceanStor: admin> addtgt -c a -p 00 -ip 128.12.13.25

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 9-51


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
9 Value-Added Service Management Commands Command Reference

System Response
When the command is complete, you can run the showtgt command to view the result.

9.4.2 showtgt

Function
The command showtgt is used to query information of the initiator added to a target (controller).

Format
showtgt -c controller ID [-ti target ID]

Parameters

Keyword and Value Description Default Value

-c controller ID The controller ID. The value is A or B, and it is case None.


insensitive.

-ti target ID The target ID. The value ranges from 0 to 7. None.

Modes
Normal mode.

Level
Super administrator level, administrator level and guest level.

Usage Guidelines
l The showtgt -c controller ID command queries information of all the targets (controllers)
added to the initiator.
l The showtgt -c controller ID -ti target ID command queries detailed information of a
specified target (controller) added to the initiator.

Example
Query information of the target on controller A.

OceanStor: admin> showtgt -c a


Controller ID Target ID Target IP Target Port Connect Status
A 0 128.12.13.25 3260 Unconnected

System Response
None.

9-52 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 9 Value-Added Service Management Commands

9.4.3 connecttgt

Function
The command connecttgt is used to connect a specified initiator to a target (controller).

Format
connecttgt -c controller ID -ti target ID

Parameters

Keyword and Value Description Default Value

-c controller ID The controller ID. The value is A or B, and it is case None.


insensitive.

-ti target ID The target ID. The value ranges from 0 to 7. None.

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
None.

Example
Connect to the target with the ID of 1 on controller A.

OceanStor: admin> connecttgt -c a -ti 1

System Response
When the command is complete, you can run the showtgt command to view the result.

9.4.4 chgtgt

Function
The command chgtgt is used to modify configurations of the initiator added to a target
(controller).

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 9-53


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
9 Value-Added Service Management Commands Command Reference

Format
chgtgt -c controller ID -ti target ID [-p port ID][-ip IP address] [-port TCP/IP port] [-m
recovery mode] [-chap yes or no] [-user user -pwd password]

Parameters

Keyword and Value Description Default Value

-c controller ID The controller ID. The value is A or B, and are case None.
insensitive.

-ti target ID The target ID. The value ranges from 0 to 7. None.

-p port ID The ID of the iSCSI port . The value can be 0, 1, 2, None.


or 3.

-ip IP address The IP address of the iSCSI target. The format is None.
xx.xx.xx.xx.

-port TCP/IP port The TCP/IP port ID of the iSCSI target. The value None.
ranges from 0 to 65535.

-m recovery mode The link recovery policy. The value can be 1 or 2. None.
l The value 1 stands for the auto mode.
l The value 2 stands for the manual mode.

-chap yes or no The parameter decides whether to enable the CHAP None.
authentication. The value can be 0 or 1.
l The value 0 stands for no. The CHAP
authentication is disabled.
l The value 1 stands for yes. The CHAP
authentication is enabled.

-user user The CHAP user name. None.

-pwd password The CHAP password. None.

Modes
Normal mode.

Level
Super administrator level and administrator level.

9-54 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 9 Value-Added Service Management Commands

Usage Guidelines
The chgtgt command requires the compulsory parameters -c and -ti, and at least one optional
parameter.

Example
Change IP address of the target on controller A with the ID of 0.to 128.23.25.26, TCP/IP
port to 1234, and Link recovery policy to Auto.

OceanStor: admin> chgtgt -c a -ti 0 -ip 128.23.25.26 -port 1234 -m 1

System Response
When the command is complete, you can run the showtgt command to view the result.

9.4.5 disconnecttgt

Function
The command disconnecttgt is used to disconnect a target (controller) from the initiator.

Format
disconnecttgt -c controller ID -ti Target ID

Parameters

Keyword and Value Description Default Value

-c controller ID The ID of the connected controller . The value is A None.


or B, and it is case insensitive.

-ti Target ID The target ID. The value ranges from 0 to 7. None.

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
None.

Example
Disconnect the target with the ID of 1 on controller A.

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 9-55


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
9 Value-Added Service Management Commands Command Reference

OceanStor: admin> disconnecttgt -c a -ti 1

System Response
When the command is complete, you can run the showtgt command to view the result.

9.4.6 chgiscsiininame

Function
The chgiscsiininame command changes the name of an iSCSI initiator.

Format
chgiscsiininame -c controller ID -n name

Parameters

Keyword and Value Description Default Value

-c controller The controller ID. The value is A or B, and it is case None.


insensitive.

-n name A new name. The name contains 1 to 217 None.


characters, including numbers, letters, dots, colons,
and hyphens. The first character cannot be a
hyphen.

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
None.

Example
Change the name of an iSCSI initiator to abida.

OceanStor: admin> chgiscsiininame -c a -n abida

System Response
When the command is complete, you can run the showiscsiname command to view the result.

9-56 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 9 Value-Added Service Management Commands

9.4.7 showiscsiname

Function
The command showiscsiname is used to query names of the iSCSI initiator and target
(controller).

Format
showiscsiname

Parameters

Keyword and Value Description Default Value

None. None. None.

Modes
Normal mode.

Level
Super administrator level, administrator level and guest level.

Usage Guidelines
None.

Example
Query the name of the iSCSI initiator in the system.

OceanStor: admin> showiscsiname


=========================================================================
iSCSI Name
-------------------------------------------------------------------------
Target | iqn.2006-08.com.huawei:
OceanStor:
210000e0fc000005:notconfig
Initiator (Controller A) | abida
Initiator (Controller B) | iqn.2006-08.com.huawei:
OceanStor:
210000e0fc000005:notconfigB
=========================================================================

System Response
None.

9.4.8 deletetgtinfo

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 9-57


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
9 Value-Added Service Management Commands Command Reference

Function
The command deletetgtinfo is used to delete configurations of the initiator added to a target
(controller).

Format
deletetgtinfo -c controller ID -ti target ID

Parameters

Keyword and Value Description Default Value

-c controller ID The controller ID. The value is A or B, and it is case None.


insensitive.

-ti target ID The target ID. The value ranges from 0 to 7. None.

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
None.

Example
Delete configurations of the target on controller A.

OceanStor: admin> deletetgtinfo -c a -ti 0

System Response
When the command is complete, you can run the showtgt command to view the result.

9.4.9 chgini

Function
The command chgini is used to switchover the initiator of a target (controller).

Format
chgini -c controller ID -ti target ID

9-58 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 9 Value-Added Service Management Commands

Parameters

Keyword and Value Description Default Value

-c controller ID The controller ID. The value is A or B, and it is case None.


insensitive.

-ti target ID The target ID. The value ranges from 0 to 7. None.

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
None.

Example
Switchover the initiator with the ID of 0 on controller A.

OceanStor: admin> chgini -c a -ti 0

System Response
None.

9.5 Link information Configuration Commands


Link information configuration commands are used to query and modify link information.

9.5.1 showlinkinfo
9.5.2 showarraylinkinfo

9.5.1 showlinkinfo

Function
The command showlinkinfo is used to query the link information.

Format
showlinkinfo -t link type [-i link ID]

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 9-59


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
9 Value-Added Service Management Commands Command Reference

Parameters

Keyword and Value Description Default Value

-t link type The link type. The value can be 0 or 1: None.

l 0 stands for local link.


l 1 stands for a third- part link.

-i link ID The link ID. The value ranges from 0 to 255. None.

Modes
Normal mode.

Level
Super administrator level, administrator level and guest level.

Usage Guidelines
l The showlinkinfo -t link type command queries information on all links, including the link
ID, arrays ID, link type, connect status and whether be used.
l The showlinkinfo -t link type -i link ID queries information on a specified link, including
the array ID, link type, local controller, local port, remote controller, remote port, connect
status, whether be used or is a mirrored link, FC local WWPN, FC remote WWPN and
remote WWN.

Example
Query information of local link with ID 4 in the system.

OceanStor: admin> showlinkinfo -t 0 -i 4


================================
Link Information
--------------------------------
Link ID | 4
Array ID | 0
Link Type | iSCSI
Local Controller | B
Local Port | 3
Remote Controller | B
Remote Port | 3
Connect Status | Connect
Whether Be Used | No
Is Mirror Link | No
================================

System Response
None.

9.5.2 showarraylinkinfo

9-60 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 9 Value-Added Service Management Commands

Function
The command showarraylinkinfo is used to query array link information.

Format
showarraylinkinfo -i array ID [-li link ID]

Parameters

Keyword and Value Description Default Value

-i array ID The array ID. The value ranges from 0 to 31. None.

You can query the information by running the


showarrayinfo command.

-li link ID The link ID, the value ranges from 0 to 255. None.

Modes
Normal mode.

Level
Super administrator level, administrator level and guest level.

Usage Guidelines
l The showarraylinkinfo -i array ID command queries link information of a specified array.
l The showarraylinkinfo -i array ID -li link ID command queries information of a specified
link in a specified array.

Example
Query information of the link with the ID of 4 in the array with the ID of 0.

OceanStor: admin> showarraylinkinfo -i 0 -li 4


================================
Link Information
--------------------------------
Link ID | 4
Array ID | 0
Link Type | iSCSI
Local Controller | B
Local Port | 3
Remote Controller | B
Remote Port | 3
Connect Status | Unknown
Whether Be Used | No
Is Mirror Link | No
================================

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 9-61


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
9 Value-Added Service Management Commands Command Reference

System Response
None.

9.6 Other Configuration Commands


Other configuration commands are used to manage some relative information of the storage
system.

9.6.1 showarrayinfo
9.6.2 createvirlunmask
9.6.3 cancelvirlunmask
9.6.4 showthirdpartyluninfo
9.6.5 statlink
9.6.6 testlink
9.6.7 chglinkstat
9.6.8 showlinkperiod
9.6.9 chglicensestatus
9.6.10 showincrementlicense

9.6.1 showarrayinfo

Function
The command showarrayinfo is used to query array information.

Format
showarrayinfo [-i array ID] -s the scope

Parameters

Keyword and Value Description Default Value

-i array ID The array ID. The value ranges from 0 to 31. None.

-s the scope The scope. The value ranges can be 1 or 2. None.

l The value 1 stands for all.


l The value 2 stands for connected (used by LUN
copy).

9-62 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 9 Value-Added Service Management Commands

Modes
Normal mode.

Level
Super administrator level, administrator level and guest level.

Usage Guidelines
l The showarrayinfo -s the scope command queries information on all the arrays
l The showarrayinfo -i array ID -s the scope queries information on a specified array.

Example
Query all the information on the array with the ID of 0.

OceanStor: admin> showarrayinfo -i 0 -s 1


=================================
Array Information
---------------------------------
Array ID | 0
Link ID0 | -1
Link ID1 | -1
WWN | 0x2100269853476258
Name |
Status | Connected
=================================

System Response
None.

9.6.2 createvirlunmask

Function
The command createvirlunmask is used to create a virtual lunmasking.

Format
createvirlunmask -i host or hostgroup ID -t virtual lunmask type

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 9-63


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
9 Value-Added Service Management Commands Command Reference

Parameters

Keyword and Value Description Default Value

-i host or hostgroup ID The host ID or host group ID. The value ranges as None.
follows:
l The value of the host ID ranges from 0 to 31.
You can query the information by running the
showhostgroup command.
l If it is the host ID, the value ranges from 0 to 255.
You can query the information by running the
showhost command.

-t virtual lunmask type The virtual LUN mask type. The value can be 1 or None.
2.
l The value 1 stands for the host, that is, the virtual
LUN mask of the host.
l The value 2 stands for the host group, that is, the
virtual LUN mask of the host group.

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
None.

Example
Create a lunmasking on the host group with the ID of 2.

OceanStor: admin> createvirlunmask -i 2 -t 2

System Response
When the command is complete, you can run the showmap command to view the result.

9.6.3 cancelvirlunmask

Function
The command cancelvirlunmask is used to cancel a virtual lunmasking.

9-64 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 9 Value-Added Service Management Commands

Format
cancelvirlunmask -m virtual lunmask map ID

Parameters

Keyword and Value Description Default Value

-m virtual lunmask map ID The virtual lunmasking ID. None.

You can query the information by running the


showmap command.

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
None.

Example
Cancel the virtual lunmasking with the ID of 0x20003.

OceanStor: admin> cancelvirlunmask -m 0x20003

System Response
When the command is complete, you can run the showmap command to view the result.

9.6.4 showthirdpartyluninfo

Function
The command showthirdpartyluninfo is used to query the LUNs exist in third-part arrays.

Format
showthirdpartyluninfo {[-wwn LUN wwn] | [-wwpn port wwn -n number]}

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 9-65


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
9 Value-Added Service Management Commands Command Reference

Parameters

Keyword and Value Description Default Value

-wwn LUN wwn The LUN WWN. The value None.


includes 32 hexadecimal
numbers.

-wwpn port wwn The LUN WWPN. The value None.


includes 32 hexadecimal
numbers.

-n number The number of the LUNs to None.


be queried. The value ranges
from 0 to 511.

Modes
Normal mode.

Level
Super administrator level, administrator level and guest level.

Usage Guidelines
None.

Example
Query the information of the third-part LUN with wwn
6882C9A10014513F000C398100000001.

OceanStor: admin> showthirdpartyluninfo -wwn 6882C9A10014513F000C398100000001

System Response
None.

9.6.5 statlink

Function
The command statlink is used to query statistics information of a link.

Format
statlink -i Link ID

9-66 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 9 Value-Added Service Management Commands

Parameters

Keyword and Value Description Default Value

-i Link ID The link ID, the value ranges None.


from 0 to 255.
You can query the
information by running the
showlinkinfo command.

Modes
Normal mode.

Level
Super administrator level, administrator level and guest level.

Usage Guidelines
None.

Example
Collect statistics information of the link with ID 0.

OceanStor: admin> statlink -i 0


=========================================
Link Statistic
-----------------------------------------
Link ID | 0
Read IO Number(Bytes) | 0
Write IO Number(Bytes) | 1
Read IO Total(Bytes) | 0
Write IO Total(Bytes) | 0
Current Bandwidth(MB/S) | 0
Max Bandwidth(MB/S) | 0
Current IOPS(IO/S) | 0
Max IOPS(IO/S) | 0
Max Delay(S) | 0
Average Delay(S) | 1
=========================================

System Response
None.

9.6.6 testlink

Function
The command testlink is used to test the statistics time of the link.

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 9-67


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
9 Value-Added Service Management Commands Command Reference

Format
testlink -i Link ID

Parameters

Keyword and Value Description Default Value

-i Link ID Link ID, the value ranges None.


from 0 to 255.
You can query the
information by running the
showlinkinfo command.

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
None.

Example
Test the statistics time of the link 0.

OceanStor: admin> testlink -i 0


link statistic time is:69

System Response
None.

9.6.7 chglinkstat

Function
The command chglinkstat is used to modify the link statistic status and statistic period.

Format
chglinkstat [-o|-c] -t statistic period

9-68 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 9 Value-Added Service Management Commands

Parameters

Keyword and Value Description Default Value

-o Enable the link statistic None.


function.

-c Disable the link statistic None.


function.

-t statistic period The statistic period, the value None.


ranges from 3 to 60, and the
unit is second (s).

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
None.

Example
Enable the link statistic function, and set the period to 3s.

OceanStor: admin> chglinkstat -o -t 3

System Response
When the command is complete, you can run the showlinkperiod command to view the result.

9.6.8 showlinkperiod

Function
The command showlinkperiod is used to query the statistic status and statistic cycle of links.

Format
showlinkperiod

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 9-69


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
9 Value-Added Service Management Commands Command Reference

Parameters
Keyword and Value Description Default Value

None. None. None.

Modes
Normal mode.

Level
Super administrator level, administrator level and guest level.

Usage Guidelines
None.

Example
Query the statistic status and statistic cycle of links.

OceanStor: admin> showlinkperiod


======================================
Link Statistic Period
--------------------------------------
Link Statistic status | 0
Link Statistic Period | 3
======================================

System Response
None.

9.6.9 chglicensestatus

Function
The command chglicensestatus is used to open or close the license.

Format
chglicensestatus -i license ID -o|-c

9-70 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference 9 Value-Added Service Management Commands

Parameters

Keyword and Value Description Default


Value

-i license ID The license ID, the value can be 2 or 3: None.


l 2 stands for HyperImage.
l 3 stands for HyperCopy.

-o open Open license. None.

-c close Close license. None.

Modes
Normal mode.

Level
Super administrator level and administrator level.

Usage Guidelines
None.

Example
Open the license of HyperImage.

OceanStor: admin> chglicensestatus -i 2 -o

System Response
When the command is complete, you can run the showincrementlicense -i license ID command
to view the result.

9.6.10 showincrementlicense

Function
The command showincrementlicense is used to query the license information.

Format
showincrementlicense [-i license ID]

Issue 07 (2010-05-20) Huawei Proprietary and Confidential 9-71


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
9 Value-Added Service Management Commands Command Reference

Parameters
Keyword and Value Description Default
Value

-i license ID License ID, the value can be 2 or 3. None.


l 2 stands for HyperImage.
l 3 stands for HyperCopy.

Modes
Normal mode.

Level
Super administrator level, administrator level and guest level.

Usage Guidelines
None.

Example
Query the license information of HyperImage.

OceanStor: admin> showincrementlicense -i 2


Feature Name Feature ID Lisence Status Open Status Left Time
Snapshot 2 Valid Open 90

9-72 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference A How to Obtain Help

A How to Obtain Help

If a tough or critical problem persists in routine maintenance or troubleshooting, contact


Huawei for technical support.

A.1 Preparations For Contacting Huawei


To better solve the problem, you need to collect troubleshooting information and make
debugging preparations before contacting Huawei.
A.2 How to Use the Document
Huawei 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 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
Huawei Technologies Co., Ltd. provides customers with comprehensive technical support and
service. For any assistance, contact our local office or company headquarters.

Issue 07 (2010-05-20) Huawei Proprietary and Confidential A-1


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
A How to Obtain Help Command Reference

A.1 Preparations For Contacting Huawei


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

A.1.1 Collecting Troubleshooting Information


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

Before contacting Huawei 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 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 for technical support.

A.3 How to Obtain Help from Website


Huawei 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 technical support system are as follows:

A-2 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference A How to Obtain Help

l Huawei headquarters technical support department


l Regional office technical support center
l Customer service center
l Technical support website: http://support.huawei.com

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

A.4 Ways to Contact Huawei


Huawei Technologies Co., Ltd. provides customers with comprehensive technical support and
service. For any assistance, contact our local office or company headquarters.
Huawei Technologies Co., Ltd.
Address: Huawei Industrial Base Bantian, Longgang Shenzhen 518129 People's Republic of
China
Website: http://www.huawei.com
Telephone number: 86-755-28780808
Customer Service Center
Phone: 86-755-28560000; 4008302118
Huawei Service fax: 86-755-28560111
Service E-mail: support@huawei.com

Issue 07 (2010-05-20) Huawei Proprietary and Confidential A-3


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


Downloaded from www.Manualslib.com manuals search engine
OceanStor S2600 Storage System
Command Reference B Glossary

B 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 07 (2010-05-20) Huawei Proprietary and Confidential B-1


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
B Glossary Command Reference

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 The percentage of directly accessed I/O from Cache to all the I/O
percentage 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 A technology for ensuring data security and integrity in the
OceanStor storage system. The hard disks in slots 0 to 3 serving as
coffers, which store the data of system configuration, data of alarm logs,
and the data in the cache that is not written to the disk when the system
power is off for emergency and alarm log data.
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.
Connected LUN Logically consecutive LUNs are connected through connecting
multiple LUN space.
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.

B-2 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference B Glossary

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

Issue 07 (2010-05-20) Huawei Proprietary and Confidential B-3


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
B Glossary Command Reference

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
Expander module A component used for expanding.
Expansion master The first LUN composing the connected LUNs is called expansion
LUN master LUN.

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.

B-4 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference B Glossary

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.
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 ISM 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.

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 interface.

Issue 07 (2010-05-20) Huawei Proprietary and Confidential B-5


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
B Glossary Command Reference

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

B-6 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference B Glossary

M
Maintenance The computer that is connected through a serial port or management
terminal network interface 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 interface 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 RAID group 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

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

Issue 07 (2010-05-20) Huawei Proprietary and Confidential B-7


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
B Glossary Command Reference

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

B-8 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference B Glossary

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

Issue 07 (2010-05-20) Huawei Proprietary and Confidential B-9


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
B Glossary Command Reference

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.
Strip 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.
Strip 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.
Strip unit The physical extent block that consists of strips in each physical extent
of a redundancy group.
Strip verify To verify whether the check data block in a redundancy group strip
protects the protected space in the strip.
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.

B-10 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference B Glossary

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
UltraPath The trademark of multi-path software provided by Huawei.
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.

V
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.

Issue 07 (2010-05-20) Huawei Proprietary and Confidential B-11


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
B Glossary Command Reference

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.

B-12 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
Command Reference C Acronyms and Abbreviations

C Acronyms and Abbreviations

C
CLI command line interface

F
FC fiber channel
FTP file transfer protocol

I
iSCSI internet small computer systems interface
IP internet protocol

L
LUN logic unit number

R
RAID redundant array of independent disks

S
SAS serial attached SCSI
SCSI small computer system interface

Issue 07 (2010-05-20) Huawei Proprietary and Confidential C-1


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine


OceanStor S2600 Storage System
C Acronyms and Abbreviations Command Reference

UI user interface

C-2 Huawei Proprietary and Confidential Issue 07 (2010-05-20)


Copyright © Huawei Technologies Co., Ltd.

Downloaded from www.Manualslib.com manuals search engine

You might also like