Professional Documents
Culture Documents
V100R002
Command Reference
Issue 07
Date 2010-05-20
Website: http://www.huawei.com
Email: support@huawei.com
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.
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.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
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
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
B Glossary......................................................................................................................................B-1
C Acronyms and Abbreviations................................................................................................C-1
Figures
Tables
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.
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.
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.
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
Symbol Description
General Conventions
The general conventions that may be found in this document are defined as follows.
Convention Description
Command Conventions
The command conventions that may be found in this document are defined as follows.
Convention Description
GUI Conventions
The GUI conventions that may be found in this document are defined as follows.
Convention Description
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.
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.
This chapter describes the command line interface (CLI), and how to configure and manage the
storage system through the CLI.
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.
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.
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.
3. In the COM1 Properties dialog box, set the parameters as shown in Figure 1-3. Click
OK.
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
5. In the CLI, enter the user name and the password in sequence. See Figure 1-5.
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.
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.
4. Enter the user name and the password in the prompt of the CLI interface, as shown in
Figure 1-8.
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.
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.
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.
This chapter describes the modes, levels, and types of commands according to the functions.
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.
Convention Description
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.
logout
Classification Command
showsysfail
showtemperature
showvoltage
showsn
showlicense
showctrlinfo
exportblackbox
exportconf
importconf
exportstat
chgstatswitch
statperf
statres
Classification Command
staterr
cleanerr
synchronize
showsesmac
showsesversion
upgradeses
showmaster
addtrapip
deletetrapip
chgtrapip
Classification Command
Classification Command
deletesubrack
chgdisklight
showcomsleep
showupsstat
chgfps
showsasmode
showiscsiip
chgiscsiip
chgiscsiroute
chgiscsiname
showiscsiroute
showfcmode
chgfcmode
showfcport
deleterg
chgrg
showrg
chgrgredundantcopy
showrgredundantcopy
deletelun
chglun
showlun
deletehostgroup
chghostgroup
showhostgroup
addhost
chghost
deletehost
showhost
showfreeport
addport
showhostport
deleteport
chgport
Classification Command
showunmap
addmap
showmap
deletemap
startcopyback
showdisk
chgdisktype
chgcache
showemail
showsms
chghyimgname
showlunforpool
addluntopool
rmlunfrompool
showpoollun
showpoolinfo
chgpoolalarmvalue
showlunforhyimg
createhyimg
deletehyimg
disablehyimg
cancelrollbackhyimg
rollbackhyimg
recreatehyimg
activehyimg
Classification Command
createhyimgcp
chghyimgrollbackspeed
createtimehyimg
stoptimehyimg
chgtimehyimg
showhyimgoflun
deletetimehyimg
showtimehyimg
showlunoftimehyimg
showlunfortimehyimg
showhycpluninfo
chghycpinfo
deletehycplun
deletehycp
chghycpstatus
showlunforhycp
createhycp
taghycp
addhycplun
showexplunmember
rmlunfromexplun
showlunforexplun
addluntoexplun
showexplunnum
connecttgt
chgtgt
Classification Command
disconnecttgt
chgiscsiininame
showiscsiname
deletetgtinfo
chgini
showarraylinkinfo
createvirlunmask
cancelvirlunmask
showthirdpartyluninfo
statlink
testlink
chglinkstat
showlinkperiod
chglicensestatus
showincrementlicense
Basic operation commands are used to set the basic information of the storage system.
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
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
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.
AUTHOR
Written by Qiao Lina.
COPYRIGHT
All right reserved (C), 2008, Huawei Technologies Co., Ltd.
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.
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.1 autobat
3.3.1 autobat
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
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
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
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.
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
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.
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
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
System management commands are mainly used to configure and query the running information
of the storage system.
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
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.
4.1.3 showtemperature
Function
The command showtemperature is used to query the temperature of the controller, expander
module, or host port module.
Format
showtempetarure -t type
Parameters
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
Parameters
Keyword and Value Description Default Value
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.
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
============================================
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
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.
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
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.
===============================================
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.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
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.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
Parameters
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 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.
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
Modes
Normal mode.
Level
Super administrator level and administrator level.
Usage Guidelines
When using this command, note the following items:
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.
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
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.
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
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
Parameters
Keyword and Value Description Default Value
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.
4.5.1 showstatswitch
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.
4.5.2 chgstatswitch
Function
The command chgstatswitch is used to set the status of the system performance statistics.
Format
chgstatswitch -c | -o
Parameters
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.
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
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.
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.
4.5.4 statres
Function
The command statres is used to collect statistics on cache usage.
Format
statres [ -c controller ID ]
Parameters
Modes
Normal mode.
Level
Super administrator level, administrator level and guest level.
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
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 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.
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
Modes
Normal mode.
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
Example
Clear the error codes of FC host ports on controller A.
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 ]
Parameters
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/.
Run the command synchronize on the primary controller to synchronize the latest version to it.
4.6.2 synchronize
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.
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.
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
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 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
Modes
Normal mode, safe mode, and upgrade mode.
Level
Super administrator level and administrator level.
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/.
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.
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.
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.
4.8.1 resetsys
4.8.1 resetsys
Function
The command resetsys is used to reset the system.
Format
resetsys [ -f ]
Parameters
Modes
Normal mode.
Level
Super administrator level and administrator level.
Usage Guidelines
When using this command, note the following items:
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...
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
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.
Example
Change the system time to 2008-12-17/11:05:00.
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
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.
4.11.1 showtrapip
4.11.2 addtrapip
4.11.3 deletetrapip
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
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.
4.11.2 addtrapip
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
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
Parameters
Keyword and Value Description Default Value
Modes
Normal mode.
Level
Super administrator level and administrator level.
Usage Guidelines
None.
Example
Delete the Trap IP whose index is 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]
Parameters
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.
4.12.1 cleancofferdb
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.
4.13.1 showallver
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.
B 03 Initiator 007
=================================================
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
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.
Device management commands are used to configure and query the device information of the
storage system.
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.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
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.
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
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.
5.2.1 showdiskinfo
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
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
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
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.
5.3.1 showctrlboard
5.3.2 chgctrlmodel
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
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.
5.3.2 chgctrlmodel
Function
The command chgctrlmodel is used to set the mode of the controller.
Format
chgcache -m model
Parameters
Keyword and Value Description Default Value
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.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 ]
Parameters
Keyword and Value Description Default Value
Modes
Normal mode.
Level
Super administrator level and administrator level.
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.
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
Modes
Normal mode.
Level
Super administrator level, administrator level and guest level.
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.
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
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.
5.6.1 showexpboard
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
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
-------------------------------------------------------------------------
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.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
Modes
Normal mode.
Level
Super administrator level, administrator level and guest level.
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
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
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
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.
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.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.
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
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.
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.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
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 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.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.
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
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
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
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.
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
Modes
Normal mode.
Level
Super administrator level and administrator level.
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.
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
Modes
Normal mode.
Level
Super administrator level, administrator level and guest level.
Usage Guidelines
When using this command, note the following items:
Example
Query the information about all mini SAS host ports in the system.
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
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.
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
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.
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
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.
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
Modes
Normal mode.
Level
Super administrator level and administrator level.
Usage Guidelines
None.
Example
Set the iSCSI host port name to 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
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.
5.13.9 showfcmode
Function
The command showfcmode is used to query the topology of the current FC port.
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.
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
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.
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。
Service management commands are used to configure and query the service information of the
storage system.
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
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
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
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.
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
Parameters
Keyword and Value Description Default Value
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.
6.1.4 showrg
Function
The command showrg is used to query the information about a RAID group.
Format
showrg [ -i RAID group ID ]
Parameters
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 .
6.1.5 chgrgredundantcopy
Function
The command chgrgredundantcopy is used to set the redundant copy status of a RAID group.
Format
chgrgredundantcopy -t type
Parameters
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.
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.
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.
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
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.
6.2.2 deletelun
Function
The command deletelun is used to delete a LUN.
Format
deletelun [ -f ] -i LUN ID
Parameters
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]
Parameters
Keyword and Value Description Default Value
Modes
Normal mode.
Level
Super administrator level and administrator level.
Usage Guidelines
None.
Example
Change the name of the LUN 2 to qwe.
6.2.4 showlun
Function
The command showlun is used to query the details about a LUN.
Format
showlun [ -i LUN ID ]
Parameters
Keyword and Value Description Default Value
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.
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
Parameters
Keyword and Value Description Default Value
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.
6.3.2 deletehostgroup
Function
The command deletehostgroup is used to delete a host group.
Format
deletehostgroup [ -f ] -i host group ID
Parameters
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
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.
6.3.4 showhostgroup
Function
The command showhostgroup is used to query the details about a host group.
Format
showhostgroup [ -i host group ID ]
Parameters
Keyword and Value Description Default Value
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
Parameters
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.
6.3.6 chghost
Function
The command chghost is used to change the host name.
Format
chghost -i host ID -n host name
Parameters
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
Parameters
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.
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
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.
Example
Query the information about all free host ports.
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
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.
Format
showhostport -i host ID
Parameters
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
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.
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
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.
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.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
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 .
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
-gi 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
The command showmap is used to query the LUN mapping list.
Example
Query the LUN mapping list by specifying the host ID to 0.
6.3.17 deletemap
Function
The command deletemap is used to delete a host LUN mapping.
Format
deletemap [ -f ] -i map ID
Parameters
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.
6.4.1 startrecon
6.4.2 startcopyback
6.4.3 showdisk
6.4.4 chgdisktype
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
Modes
Normal mode.
Level
Super administrator level and administrator level.
Usage Guidelines
The command startrecon is used to enable the hard disk reconstruction function.
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
-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
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
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.
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
Modes
Normal mode.
Level
Super administrator level and administrator level.
Usage Guidelines
When using this command, note the following items:
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.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
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 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.
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]
Parameters
Keyword and Value Description Default Value
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
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
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
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.
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.
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
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.
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.
SMS INFORMATION
------------------------------
Send Country | China
Receiver Number | 88037312
Send Level | Minor
Is Need Send | YES
==============================
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
Modes
Normal mode.
Level
Super administrator level.
Usage Guidelines
The command adduser is used to add a user.
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.
8.2.1 deleteuser
8.2.1 deleteuser
Function
The command deleteuser is used to delete a user.
Format
deleteuser -u name
Parameters
Modes
Normal mode.
Level
Super administrator level.
Usage Guidelines
When using this command, note the following items:
Example
Delete the user whose name is user1.
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
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.
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.1 chguserlevel
8.4.1 chguserlevel
Function
The command chguserlevel is used to change the user level.
Format
chguserlevel -u name -l level
Parameters
Modes
Normal mode.
Level
Super administrator level.
Usage Guidelines
The command chguserlevel is used to change the level of a specified user.
Example
Change the level of user1 to guest.
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.
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
Value-added service management commands are used to manage the value-added service of the
storage system.
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
Function
The command showhyimginfo is used to query HyperImage information.
Format
showhyimginfo [-i HyperImage ID]
Parameters
-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.
System Response
None.
9.1.2 chghyimgname
Function
The command chghyimgname is used to change the HyperImage name.
Format
chghyimgname -i HyperImage ID -n name
Parameters
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.
System Response
When the command is complete, you can run the showhyimginfo command to view the result.
9.1.3 showlunforpool
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.
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
Parameters
-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.
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
Parameters
-i LUN ID The LUN ID. The value ranges from 0 to 511. None.
-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.
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]
Parameters
-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, 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.
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
Parameters
Modes
Normal mode.
Level
Super administrator level, administrator level and guest level.
Usage Guidelines
None.
Example
Query information on resource pool A.
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
Parameters
-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.
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.
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.
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
Parameters
-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.
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.
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
Parameters
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.
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
Parameters
Modes
Normal mode.
Level
Super administrator level and administrator level.
Usage Guidelines
None.
Example
Stop the HyperImage with the ID of 13.
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
Parameters
Modes
Normal mode.
Level
Super administrator level and administrator level.
Usage Guidelines
None.
Example
Cancel rollback of the HyperImage with ID of 19.
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
Parameters
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.
System Response
None.
9.1.15 recreatehyimg
Function
The command recreatehyimg is used to recreate a HyperImage.
Format
recreatehyimg -i {HyperImage ID...}
Parameters
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.
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 ...}
Parameters
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.
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
Parameters
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.
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
Parameters
-l speed level The rollback rate. The value ranges from 1 to 4. None.
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.
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
Parameters
-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.
-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.
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.
9.1.20 stoptimehyimg
Function
The command stoptimehyimg is used to stop a timing HyperImage.
Format
stoptimehyimg -i session ID
Parameters
Modes
Normal mode.
Level
Super administrator level and administrator level.
Usage Guidelines
None.
Example
Stop creating the timing HyperImage with the ID of 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.
Format
chgtimehyimg -si session ID [-n maximum numbers] [-ti time interval] [-i source LUN ID] [-
st start time]
Parameters
-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.
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
-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.
System Response
None.
9.1.23 deletetimehyimg
Function
The command deletetimehyimg is used to delete a timing HyperImage.
Format
deletetimehyimg -i session ID
Parameters
Modes
Normal mode.
Level
Super administrator level and administrator level.
Usage Guidelines
None.
Example
Delete the timing HyperImage with the ID of 0.
System Response
None.
9.1.24 showtimehyimg
Function
The command showtimehyimg is used to query information on a timing HyperImage.
Format
showtimehyimg [-i session ID]
Parameters
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.
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
Parameters
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.
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
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.
System Response
None.
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.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
-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.
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
-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 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.
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
-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.
-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.
Example
Change the HyperCopy type with the ID of 2 to incremental copy, and perform initial
synchronization.
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
-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
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.
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
-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.
System Response
When the command is complete, you can run the showhycpinfo command to view the result.
9.2.6 chghycpstatus
Function
The command chghycpstatus is used to change the HyperCopy status.
Format
chghycpstatus -i HyperCopy ID -s|-e|-p|-c
Parameters
-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
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:
Example
Set the type of the HyperCopy with ID of 1 to Start.
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
-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.
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.
System Response
None.
9.2.8 createhycp
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
-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.
-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.
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.
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
-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
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.
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
-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.
-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.
System Response
When the command is complete, you can run the showhycpluninfo command to view the result.
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
-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.
Example
Queries detailed information of all the expanded LUNs in the system.
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
-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.
Example
Query detailed information of the member LUNs in the expanded LUN with the ID of 23 .
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
-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.
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.
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
Modes
Normal mode.
Level
Super administrator level, administrator level and guest level.
Usage Guidelines
None.
Example
To query the slave LUN that can be used to expand LUN in the system.
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
-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.
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.
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
-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.
System Response
None.
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
-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.
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.
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
-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.
System Response
None.
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
-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.
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).
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
-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.
-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.
Modes
Normal mode.
Level
Super administrator level and administrator level.
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.
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
-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.
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
Modes
Normal mode.
Level
Super administrator level and administrator level.
Usage Guidelines
None.
Example
Change the name of an iSCSI initiator to abida.
System Response
When the command is complete, you can run the showiscsiname command to view the result.
9.4.7 showiscsiname
Function
The command showiscsiname is used to query names of the iSCSI initiator and target
(controller).
Format
showiscsiname
Parameters
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.
System Response
None.
9.4.8 deletetgtinfo
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
-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.
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
Parameters
-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.
System Response
None.
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]
Parameters
-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.
System Response
None.
9.5.2 showarraylinkinfo
Function
The command showarraylinkinfo is used to query array link information.
Format
showarraylinkinfo -i array ID [-li link ID]
Parameters
-i array ID The array ID. The value ranges from 0 to 31. None.
-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.
System Response
None.
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
-i array ID The array ID. The value ranges from 0 to 31. None.
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.
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
Parameters
-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.
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.
Format
cancelvirlunmask -m virtual lunmask map ID
Parameters
Modes
Normal mode.
Level
Super administrator level and administrator level.
Usage Guidelines
None.
Example
Cancel the virtual lunmasking with the ID of 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]}
Parameters
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.
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
Parameters
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.
System Response
None.
9.6.6 testlink
Function
The command testlink is used to test the statistics time of the link.
Format
testlink -i Link ID
Parameters
Modes
Normal mode.
Level
Super administrator level and administrator level.
Usage Guidelines
None.
Example
Test the statistics time of the link 0.
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
Parameters
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.
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
Parameters
Keyword and Value Description Default Value
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.
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
Parameters
Modes
Normal mode.
Level
Super administrator level and administrator level.
Usage Guidelines
None.
Example
Open the license of HyperImage.
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]
Parameters
Keyword and Value Description Default
Value
Modes
Normal mode.
Level
Super administrator level, administrator level and guest level.
Usage Guidelines
None.
Example
Query the license information of HyperImage.
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.
To better solve the problems, use the documents before you contact Huawei for technical support.
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).
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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
UI user interface