HP StorageWorks Command View XP Command Line Interface (CLI) reference guide Part number: B9357-96161 Third edition: January 2006
Legal and notice information © Copyright 1999–2006 Hewlett-Packard Development Company, L.P. Hewlett-Packard Company makes no warranty of any kind with regard to this material, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. Hewlett-Packard shall not be liable for errors contained herein or for incidental or consequential damages in connection with the furnishing, performance, or use of this material.
Contents About this guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 Intended audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Prerequisites. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Document conventions and symbols . . . . . . .
list ipaddress. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . manage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . unmanage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . User administration commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4 CLI Commands for the XP48 and XP512 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119 LUN Management Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . add lun_to_lun_group. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . add security_to_lun . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
list list list list list list list dkc_status dkp_status dku_status drr_status . pg_status . sm_status . traps . . . . .. .. .. .. .. .. .. .. .. .. .. .. .. .. . . . . . . . .. .. .. .. .. .. .. . . . . . . . .. .. .. .. .. .. .. .. .. .. .. .. .. .. . . . . . . . .. .. .. .. .. .. .. .. .. .. .. .. .. .. . . . . . . . .. .. .. .. .. .. .. . . . . . . . .. .. .. .. .. .. .. .. .. .. .. .. .. .. . . . . . . . .. .. .. .. .. .. .. .. .. .. .. .. .. .. . . . . . . . .. .. .. .. .. .. ..
About this guide This guide provides information about: • Executing batch processes to run one or more CLI commands • Using the CLI to execute session, device, SNMP IP security, and license key administration commands, and other general commands • Executing LUN and volume management commands to XP disk arrays • Listing details and status for the DKC and DKU components, and SMNP traps • Understanding and resolving error messages Intended audience This guide is intended for use by customers and HP authorized
Document conventions and symbols Document conventions Table 1 Convention Element Medium blue text: Figure 1 Cross-reference links and e-mail addresses Medium blue, underlined text (http://www.hp.
• Operating system type and revision level • Detailed, specific questions For continuous quality improvement, calls may be recorded or monitored. HP strongly recommends that customers sign up online using the Subscriber's choice web site at http://www.hp.com/go/e-updates. • Subscribing to this service provides you with e-mail updates on the latest product enhancements, newest versions of drivers, and firmware documentation updates as well as instant access to numerous other product resources.
1 Getting started The Command View XP Command Line Interface (CLI) is a text-based interface used to manage and retrieve information about XP disk arrays. Use the CLI if you prefer a text-based interface to the graphical user interface (GUI) or when it is more efficient to run scripts or batch files to manage your XP disk arrays. Input can be in the form of single line entries or pre-written batch files. Batch files allow complex commands to be executed quickly and with no input errors.
3. After you un-tar the file, the CLI components are located at /cvcli. It does not matter where you un-tar the files, but all of the following files must be in the same directory: • cli.jar • CLI_Commands.xml • CLIhelp.xml • configModifyScript128_1024_12000.txt • configModifyScript512_48.txt • configscript.txt • configscriptlegacy.txt • cssi_sec_interfaces.jar • cvcli • CVCLI.bat • CVCLI.properties • CVCLI.txt • CVCLIScripting.txt • xerces.jar 4.
Logging in By default, when you run the CLI program, a login window like the one shown in Figure 1 is displayed. Figure 1 Login window To log in, enter your user name and password and click OK. Log in using a valid Command View user name and password. The Command View defaults are administrator/administrator for modify privileges, and user/user for view-only privileges.
Commands and options are not case sensitive or space sensitive. Enter arguments in any order as long as all required parameters are provided. Arguments between “[ ]” are optional and arguments with “...” accept multiple values. Command options -f Get the commands from a batch file (used with the cvcli command when starting the CLI and with the execute command in an interactive session). Specify a path and filename. -p / Bypass the login screen (used only when starting the CLI).
Example output list lun Information about mainframe those volumes, please access web GUI PortName HostGroupNickName CL1-A GrpNick1 CL1-B GrpNick1 CL1-A GrpNick4 CL1-E GrpNick1 CL1-a GrpNick1 and intermediate volumes are not shown. To manage the mainframe management applications using the CV-XP LunID 0 1 1 0 0 CU 0 0 0 0 0 LDEV 00 02 0A 00 00 Example output with -l option list ldev -l Information about mainframe and intermediate volumes are not shown.
Users with modify privileges can perform changes to disk array configurations. Users with view privileges can perform only view-only CLI operations. Only the user “administrator” can change Command View administrative settings, such as adding new disk arrays. The administrator is also a modify user for disk array management operations. When users with modify privileges issue the connect command, Command View tries to acquire exclusive access to the disk array (lock the disk array).
Differences between the disk array family commands Ranges Range arguments for the XP48/XP512 require square brackets around the values (for example, [CL0-A-CL0-D]). Range arguments for the XP128/XP1024/XP10000/XP12000 should be specified without square brackets (for example, 0A-0D). Multiple values For the XP48/XP512, when specifying multiple values, both ranges (for example, [CL1-A-CL1-D]) and sets of values (for example, 0A,0B) are supported.
Getting started
2 CLI commands for common administrative tasks This chapter contains the CLI commands for session, device, SNMP IP security, and license key administration. This chapter also contains general CLI commands, such as execute and update. Some commands described in this chapter are customized for a particular XP disk array. In a few cases, commands are available for the XP128/XP1024/XP10000/XP12000 that are not available for the XP48/XP512, and vice versa.
Session administration commands Use the session administration commands to connect and disconnect sessions, and to display information about a session.
connect Description This command establishes a session to manage a specified disk array. This has to be done before doing any disk array-related operations. If the CLI is started with the -f option and the connect command is in the batch file, this command keeps trying to connect until it establishes a session or until it times out, whichever is earlier. If you execute this command from the CLI prompt, you can see immediately if the connection is successful.
disconnect Description This command disconnects you from the disk array to which you are currently connected.
kill session Description Use the kill session command with the option to terminate the specified client session or with the options to terminate a GUI session. Only users in the Administrators group are permitted to terminate GUI sessions.
list session Description Use this command to list the client sessions for the specified disk array. Syntax list session [-gui] Arguments The serial number of the disk array whose sessions you want to list. [-gui] This is an optional parameter. Use this option to display all non-Command View GUI sessions. This option is only supported for the XP128/XP1024/XP10000/XP12000 arrays.
General commands This section describes the following commands: • execute, page 26 • exit, page 27 • help or ?, page 28 • update, page 29 Command View XP Command Line Interface (CLI) reference guide 25
execute Description This command executes commands from a batch file when you are in an interactive session (that is, the CLI was started without the -f option). You are then returned to the CLI prompt. The file can contain any CLI command except execute or help. Each line in the file must contain only one command. Syntax execute Arguments The file containing the commands to be executed. It can be specified with an absolute or relative path.
exit Description This command exits you from an interactive CLI session.
help or ? Description Either of these commands displays the syntax and description of the commands and their modules. Syntax help [] [] or ? [] [] Arguments [] is optional. If this option is not specified, the syntax of the help command is displayed.The command types are list, create, modify and delete. If only the command type is specified, the usage of all the modules under the specified command is displayed.
update Description The update command forces a new data retrieval cycle and is usually required when the server encounters network errors or the existing data with the server is not the most current. Use this command only after connecting to an array. This command cannot be used in the batch mode.
Device administration commands Use the device administration commands to manage the disk arrays; manage SNMP IP security; and list status and detailed information.
add ipaddress Description This command adds an SNMP manager’s IP address to the list in the disk array. Use this command after connecting to a disk array. This command is supported for the XP48/XP512. Syntax add ipaddress Arguments The IP address of the SNMP manager to be added. There must be at least one IP address specified. Example add ipaddress 15.76.96.152,15.32.72.
delete ipaddress Description This command unregisters SNMP Manager IP addresses from the disk array. The IP address of the Command View management station cannot be deleted unless all the other registered SNMP Manager IP addresses are deleted. Use this command after connecting to a disk array. This command is supported for the XP48/XP512. Syntax delete ipaddress Arguments The IP address of the SNMP manager to be deleted.
get_refresh_status Description This command shows the lock and refresh status of the disk array. This command does not work while connected to an XP128/XP1024/XP10000/XP12000. Instead, use the list array_status command (page 36). Syntax get_refresh_status Arguments The disk array serial number. Example get_refresh_status 10049 LOCK_STATUS: CV unlocked the array 10049.REFRESH_STATUS: CV server has latest data.
list array_config Description This command displays disk array configuration details as displayed on the Status screen of Command View. Some of the configuration details include the firmware version, allocated space, unallocated space, free space, total space, LDEVs per CU, and LDEVs per ACP. This command does not support the -sa, -sd, or -col options. For the XP128/XP1024/XP10000/XP12000, view the port and CHA configurations by using the list port and list cha commands.
Example The following is an example output of the list array_config command.
list array_status Description This command displays the lock, refresh, and get state and status of all managed disk arrays or a specific XP128/XP1024/XP10000/XP12000 disk array. The lock states include: • LOCKED: Command View has locked the disk array. • UNLOCKED: The disk array is not locked by the Command View. • ATTEMPTING: Command View is attempting to lock the disk array. • ERROR: Error while attempting to lock the disk array.
Example XP48/XP512: Serial#,Lock Status,Lock State,Refresh Status,Refresh State,Get Status,Get State 30055,OK,UNLOCKED,OK,REFRESHED,OK,OLD_DATA XP128/XP1024/XP10000/XP12000: Serial# Lock_State Lock_Status Refresh_State Get_Status 10033 UNLOCKED OK IDLE OK 20074 LOCKED OK IDLE OK Refresh_Status COMPLETE OLD_DATA Get_State OK OK [-lock] Serial# 30433 35721 Lock_State UNLOCKED LOCKED [-refresh] Serial# Refresh_State 30433 REFRESHED 35721 ERROR [-get] Serial# 10033 20074 Get_State COMPLETE OLD_DATA Com
list device Description This command lists the disk arrays managed by Command View along with their attribute types and contact information. A disk array can be managed only if the disk array has been added to Command View’s database. Syntax list device Example The output displays the details of the disk arrays that are managed by Command View. Serial#,IPAddress,Type,Contact,Location,Managed,Ftp,Protocol\ 30433 15.76.97.185 XP12000 ISO ISO-B manage noftp rmi\ 10033 15.32.76.
list device_history Description This command displays the device history of the specified disk array. Syntax Before connecting to the disk array: list device_history CV_CLI>list device_history 20036 After connecting to the disk array: list device_history CV_CLI 20036(R/W)>list device_history Arguments The serial number of the disk array whose device history you want to display.
list ipaddress Description This command lists the IP addresses of the SNMP Managers registered with the connected disk array. The host IP address is displayed with the caption “CV IP Address.” Syntax list ipaddress Example SNMP Manager IP Addresses 15.32.72.62 15.76.97.
manage Description Use this command to enable Command View to manage a disk array. A disk array can be managed through Command View only if it has been first been added to the Command View database. Use this command before connecting to a disk array. Syntax manage Arguments The serial number of the disk array to be managed.
unmanage Description Use this command to disable management of a disk array by Command View. A device can be unmanaged only if it is currently managed. Use this command before connecting to a disk array. Syntax unmanage Arguments The serial number of the disk array to be unmanaged.
User administration commands Use the user administration commands to manage user accounts, modify user account attributes, and change passwords. The modifications that you are permitted to make will depend on the user group you belong to. Three types of user groups are provided: • Users: Members of this group have read-only access to array management for the arrays assigned to them.
Table 2 Group Name Properties Group name/Role Users Read-only users Properties This group represents all users who have read-only permissions. Only administrators from the Administrator group can add or delete users from this group. This group and its members are governed by the following rules: • Only the default user with the user ID of “user” is a permanent member of this group. All other users belonging to this group can be deleted.
Table 2 Group Name Properties (continued) Group name/Role Administrators Command View management station administrators (a local group) Properties This group represents all users who are Command View administrators. This group and its members are governed by the following rules: • Only the default user with the user ID of “administrator” is a permanent member of this group. All other users belonging to this group can be deleted.
create user Description Use this command to create a new user account in any of the three groups. The following user groups are available: Users, StorageAdmins, and Administrators. For additional information about these groups, see ”User administration commands” on page 43 and Table 2 on page 44. Only a user belonging to the Administrators group can create user accounts. When you create a user account, the user name must have at least six characters, and cannot have more than 16 characters.
delete user Description Use this command to delete a user account. Only a user belonging to the Administrators group can delete a user. When a user is deleted, all assignments to the array for that user are deleted. Default users (that is, User, StorageAdmin, and Administrator) cannot be deleted. This command is not supported after connecting to a disk array, within a batch file, or with the -f option. In addition, ranges are not supported.
list users Description Use this command to list all users and view specific information about them, such as determining whether the user belongs to the Users, StorageAdmins or Administrators group and a user's assigned arrays and partitions. If the output this command contains partition level information, the following warning message appears: Only viewing of partitioning assignment is allowed in CLI; Partitioning assignment operations are not supported in the CVCLI. Please use the CV-GUI.
modify attributes Description Use this command to modify the attributes of a specified user, such as granting access to or revoking access from an array. Only users belonging to the Administrators group can modify attributes. By default, all users belonging to the Administrators group have access to all the added arrays in modify mode. Default users in the users group have read-only access to the added arrays.
modify password Description Use this command to change a user’s password. This command is not supported after connecting to a disk array, within a batch file, or with the -f option. In addition, ranges are not supported. Users can change their own passwords. However, only a user belonging to the Administrators group can modify other users’ passwords. (Administrators are not required to enter the old password when changing the password.
License key administration commands Use the license key administration commands to display information about the license keys installed on an XP disk array. For the XP128/XP1024/XP10000/XP12000, additional commands are available to install and uninstall license keys on the disk array.
install license_key Description Use this command to install license keys for optional software. You can install more than one license key in one operation. This command is not supported for the XP48/XP512. HP Continuous Access XP must be installed before HP Continuous Access XP Extension is installed. The two items should be specified as separate commands.
list licensekey_info Description This command lists information about the license keys installed on the disk array. list licensekey_info has the following information associated with it: • FunctionalityOption. The list of software and options for which licenses are installed or can be installed. • Status. The installation status of the various software modules. The possible values are “Installed” and “Not Installed.” • KeyKind. The type of the key installed for the software.
uninstall license_key Description Use this command to uninstall license keys for applications. More than one license can be uninstalled in one operation. This command is not supported for the XP48/XP512. HP Continuous Access Extension must be uninstalled before HP Continuous Access is uninstalled. The two names should be specified as separate commands. Example: uninstall license_key HP_CONTINUOUS_ACCESS_EXTENSION uninstall license_key HP_CONTINUOUS_ACCESS_XP Syntax uninstall license_key
3 CLI commands for the XP128/XP1024/XP10000/XP12000 This chapter contains CLI commands for LUN and volume management specifically for the XP128/XP1024/XP10000/XP12000. This chapter also contains additional CLI commands to list information about DKC and DKU components, and SMNP traps.
create host_group Description This command creates host groups. Each port can have up to 128 (XP128/XP1024) or 256 (XP10000/XP12000) host groups. This command permits creating multiple host groups for multiple ports in one operation. Each host group is specified by its nickname. Syntax create host_group , Arguments The port in which the host group is to be created.
create lun Description This command adds paths in the disk array and allows for the addition of multiple paths in the disk array in one operation using range operators. Each host group on an XP128/XP1024 can have a maximum of 256 paths, while each port can have a maximum of 512 paths. For an XP10000/XP12000, each host group can have a maximum of 1024 paths, while each port can have a maximum of 1024 paths. Syntax create lun , , , ,
Example create lun 1A:1B, nick1:nick2, 2:5-7,0,0:5-B creates the following paths in the disk array: 58 1A 1A 1A 1A 1A 1A 1A 1A nick1 nick1 nick1 nick1 nick2 nick2 nick2 nick2 2 5 6 7 2 5 6 7 0 0 0 0 0 0 0 0 0 5 6 7 8 9 A B 1B 1B 1B 1B 1B 1B 1B 1B nick1 nick1 nick1 nick1 nick2 nick2 nick2 nick2 2 5 6 7 2 5 6 7 0 0 0 0 0 0 0 0 0 5 6 7 8 9 A B CLI commands for the XP128/XP1024/XP10000/XP12000
create wwn Description Use this command to add WWNs to host groups. Each host group can have up to 255 WWNs and each port can have a maximum of 128 (XP128/XP1024) or 256 (XP10000/XP12000) host groups. After the WWN is added to the host group, it has access to the LUNs in the host group. Syntax create wwn , , Arguments The port to which the WWNs are to be added.
delete host_group Description Use this command to remove host groups from the disk array. Each port can have up to 128 host groups. This command permits deletion of multiple host groups in one operation. Each host group is specified by its nickname. The default host group in every port cannot be deleted. If you are using firmware version 21.06.22 or later, you can delete host groups (except for host group 0) with or without the port security turned on. Syntax delete host_group
delete lun Description This command deletes one or more paths in the disk array in one operation. Each path is identified by its port name, host group nickname, LUN ID, CU number, and LDEV number. You can also use this command to delete all paths in specified ports and host groups, or CUs and LDEVs. If you are using firmware version 21.06.22 or later, you can delete the last path to a command device, and you can delete LUN paths with or without the port security turned on. Syntax delete lun [
Arguments [-ldev ] Deletes all paths to the specified LDEVs. can be one value, a set of values, or a range of values (for example, A or 0:A:1A or 0-F). LDEVs must be given in hexadecimal and are not case sensitive. -ldev without any arguments generates an error. This option cannot be used along with the -port and -hostgrp options, but must be used with the –cu option. The –ldev option without the –cu option generates an error.
delete wwn Description Use this command to delete WWNs from host groups. Once the WWN is deleted from a host group it can no longer access the LUNs in that host group. You can also use this command to delete multiple WWNs in one operation. The WWNs can be deleted using either the WWN or WWN nickname. If you are using firmware version 21.06.22 or later, you can delete WWNs with or without the port security turned on. Syntax delete wwn [, [,
list lun Description This command displays path related configuration details. Each path is identified by its port name, host group nickname, LUN ID, CU number, and LDEV number. The LUN ID, CU number, and LDEV number are in hexadecimal. Use list lun to query for the following information: • PortName. The port from which the path has been created. Ports in the disk array are identified through their port names (for example, CL1-A and CL1-B). • GroupNickName.
Arguments [-ldev ] Displays only the paths to the specified LDEVs. can be one value, a set of values, or a range of values (for example, A or 0:A:1A or 0-F). LDEVs must be given in hexadecimal and are not case sensitive. -ldev without any arguments generates an error. If the -ldev option is used with the -cu option, the output will consist of all the paths to the specified LDEV in the specified CUs.
list port Description This command displays the port configuration. Each port in the disk array has the following information associated with it: • Portname. Ports in the disk array are identified by their portname (for example, CL1-A and CL1-B). • Type. The type of port. On the XP128/XP1024/XP10000/XP12000, the only port type is Fibre Channel. • Address. The port’s AL-PA address. This column displays Arbitrated Loop Physical Addresses and loop ID values (for example, EF(0) and E8(1)). • Topology.
Arguments [-security] Displays all port names and their security switch status. [-address] Displays all port names and their Fibre Channel addresses (AL-PA and loop ID values). [-topology] Displays all port names and their Fibre Channel topologies. The topology column displays the fabric switch status (ON or OFF) and the topology (FC-AL or point-to-point). [-hostgrp] Displays all ports, all configured host groups for each port and the host mode name for each host group.
Example [-address] PortName CL1-A CL1-B CL1-a CL1-b Address EF(0) E2(3) 73(63) EF(0) The -l option produces the same output as list port -l. [-topology] PortName CL1-A CL1-B CL1-a CL1-b Topology Fabric ON & Point-to-Point Fabric OFF & Point-to-Point Fabric ON & FC-AL Fabric OFF & FC-AL The -l option produces the same output as list port -l.
list wwn Description This command displays the WWN information for the hosts that can access the LUNs. Each host connected to the disk array is identified by its WWN. WWNs are added to host groups within the ports, and all WWNs assigned to a host group can access the LUNs in that host group. If you are using a firmware version before version 21.06.22, the LUN accessibility by the hosts is also limited by the ports security switch. The WWNs can access the LUNs only if the security switch of the ports is ON.
Example list wwn without any options displays all the WWNs configured in the disk array. PortName CL1-A CL1-A CL1-B CL1-B CL1-B CL1-B Wwn HJGHHJGHJGH23423 JJKHKJHHJGH23423 HJhfhdsHJGH878JK HJGHHJGHJGH23423 JJKHKJHHJGH23423 JHNJYGJHHHJGHJJH The -l option output displays all the WWNs configured in the disk array along with the host group nickname and WWN nickname.
modify cmd_device Description Use this command to: • Set an LDEV as a command device • Release an existing command device • Enable (set ON) command device security • Disable (set OFF) command device security If you are using firmware version 21.06.22 or later, you can set or release a command device without a path. Syntax modify cmd_device -set , -security ON|OFF | -release , Arguments -set or -release
modify fibre_address Description Use this command to modify port addresses. It is available for fibre ports only. Syntax modify fibre_address , Arguments The port whose address is to be modified. can be specified as one port, a set of ports, or a range of ports (for example, 1A or 1A:1C:1D or 1A-1E). Port names must be specified in truncated form (for example, 1A and not CL1-A) because the hyphen (-) is used to specify a range.
modify fibre_topology Description This command modifies the port topologies. It is available for fibre ports only. Syntax modify fibre_topology , Arguments The ports whose topologies are to be modified. can be specified as one port, a set of ports, or a range of ports (for example, 1A or 1A:1C:1D or 1A-1E). Port names must be specified in truncated form (for example, 1A and not CL1-A) because the hyphen (-) is used to specify a range.
modify host_group Description This command modifies the host group nickname for a port. You must enable LUN security before using this command (see ”modify lun_security” on page 76). Syntax modify host_group , , Arguments The ports whose host group is to be modified. Port names must be specified in truncated form (for example, 1A and not CL1-A) because the hyphen (-) is used to specify a range.
modify host_mode Description Use this command to modify the host mode for a host group in a port and to modify host modes for multiple host groups in one operation. To perform the modify host_mode operation, the security switch must be set to ON for host groups, except for host group 0. Syntax modify host_mode , , Arguments The port that contains the host groups.
modify lun_security Description This command enables (ON) or disables (OFF) the port security switch. Syntax modify lun_security , ON|OFF Arguments The ports whose security switch is to be modified. can be specified as one port, a set of ports, or a range of ports (for example, 1A or 1A:1C:1D or 1A-1E). Port names must be specified in truncated form (for example, 1A and not CL1-A) because the hyphen (-) is used to specify a range. ON|OFF The switch value.
modify wwn Description Use this command to modify the WWN and WWN nickname of a host. You must enable LUN security before using this command (see modify lun_security, page 76). Syntax modify wwn , , [-wwn | -nickname ] Arguments The port whose WWN or WWN nickname is to be modified. must be specified as one port.
Volume management commands This section describes the following commands: • create custom_ldevs, page 79 • create luse, page 81 • delete ldevs, page 84 • delete luse, page 85 • initialize vdev, page 86 • list ldev, page 87 • list luse, page 91 • list openv_util, page 93 • list parity_group, page 95 • list usable_cus, page 98 • list vsc, page 99 • make volumes, page 101, 78 CLI commands for the XP128/XP1024/XP10000/XP12000
create custom_ldevs Description This command creates new custom LDEVs and can be executed depending on the amount of free space present in the VDEV. You can display a list of available free spaces in the VDEV by using the list parity_group -fs command. You must supply an LDEV ID when you create custom LDEVs. You can list unused LDEV IDs with the list vsc -unused command. The new custom LDEVs that are created have the same emulation type and LDEV size, and are only for one domain, parity group, and VDEV.
Example create custom_ldevs 1, 1, 1, OPEN-3, 500, 00:01, 00:02-04:0D Domain 1 1 1 1 1 1 1 1 1 1 80 PG VDev CU LDev EmulationType 1 1 00 00 OPEN-3 1 1 00 02 OPEN-3 1 1 00 03 OPEN-3 1 1 00 04 OPEN-3 1 1 00 0D OPEN-3 1 1 01 00 OPEN-3 1 1 01 02 OPEN-3 1 1 01 03 OPEN-3 1 1 01 04 OPEN-3 1 1 01 0D OPEN-3 CLI commands for the XP128/XP1024/XP10000/XP12000 LdevSize 500 500 500 500 500 500 500 500 500 500
create luse Description Use this command to create expanded volumes in the disk array. Each LUSE volume can have 2 to 36 LDEVs. This command allows for the creation of only one LUSE volume in one operation. A LUSE volume can be created in one of two modes: continuous or disperse. Optionally, one or more paths can be defined for the LUSE. The existing LUSE volumes can be further expanded to form a larger volume.
Example Using the continuous offset option create luse topCU, topLDev -continuous offset ,hostgrpnickname, lunid] [-lun To use this option, provide the top LDEV and an offset that specifies how many subsequent LDEVs to append to the top LDEV to create a LUSE volume. • If the top LDEV is an existing LUSE volume and the LDEVs under the offset are not LUSE volumes: The new LUSE volume will be formed by combining the LDEVs of the existing top LUSE and the subsequent ascending LDEVs.
Using the disperse option create luse topCU, topLDev -disperse [-lun hostgrpnickname, lunid] , To use this option, provide the top LDEV and the individual device LDEVs to combine. The top LDEV, device LDEVs, or both can be LUSE volumes. The new LUSE will be composed of all the individual LDEVs of input LUSEs. Restriction The CU: LDEV number of additional LDEVs must be larger than the last CU:LDEV number of an existing LUSE volume.
delete ldevs Description This command converts custom LDEVs or normal LDEVs into free space. This command cannot convert the last normal LDEV to free space. The LDEVs to be deleted should not have path added to itself, not be a part of LUSE volume, not be a command device and should not be an Auto LUN reserved volume. The list of LDEVs that can be deleted can be obtained by executing the command list vsc -deletable. Syntax delete ldevs , , , ,
delete luse Description This command releases expanded volumes. This command allows for the release of multiple LUSEs in one operation. Syntax delete luse , Arguments The CU number of the expanded volume. can be one value, a set of values, or a range of values (for example, 0 or 0:2:3 or 0-4). CUs must be given in hexadecimal. The LDEV number of the expanded volume.
initialize vdev Description Use this command to regain the initial configuration of the VDEV. This operation deletes all the custom volumes created on this VDEV and creates the normal LDEVs deleted by the user. A custom LDEV, if present, is deleted. These custom LDEVs cannot have a path assigned, be a part of a LUSE volume, be a command device, or be part of an Auto LUN reserved volume. You need to enter the exact number of LDEV IDs.
list ldev Description This command displays logical device configuration details. Each LDEV is identified by the CU number it belongs to and an LDEV number. CU number and LDEV numbers are represented in hexadecimal. Use list ldev to query the following items: • CU. The CU number to which the LDEV belongs to. With the XP128/XP1024, the CU ranges from 0 to 31. For the XP10000/XP12000, the CU ranges from 0 to 63. • LDEV. The LDEV number. Each CU can have LDEVs numbered between 0 to 255.
Arguments [-cmddev] Displays only the LDEVs that have been designated as command devices. This option also displays whether the command device security status is set to ON or OFF. This option cannot be used with the -lu and -unallocated options. [-lu] Displays the LDEVs that are not expanded (“NOT EXPANDED”) and the top LDEVs in expanded volumes (“EXPANDED TOP”). This option cannot be used with the -cmddev and -unallocated options. [-unallocated] Displays all LDEVs that do not have any paths defined.
Example [-lu] Displays only the “NOT EXPANDED” and the “EXPANDED TOP” LDEVs and the count. CU 0 0 LDEV 08 0F Count 2 6 [-unallocated] The output format is the same as the default output for list ldev. The -l option output is the same as the default output for list ldev with the -l option. [-emulation ] The output displays only the LDEVs with the specified emulation types.
Example [-cu ] The output format is the same as the default output for list ldev and list ldev with -cmddev, -lu, -ldev, -emulation, if those options are used. The output displays only the LDEVs in the specified CUs. The -l option output depends on the options used. The output format will be the same as the output for list ldev -l and list ldev -l with -cmddev, -lu, -ldev, -emulation, if those options are used. The output displays only the LDEVs in the specified CUs.
list luse Description This command displays LUSE configuration details. A LUSE volume consists of more than one LDEV. The LUSE volume can be expanded in either of two modes: continuous, where the LDEVs are consecutive, and disperse, where the LDEVs are non-consecutive. All LDEVs in a LUSE volume must be in the same CU. CU number and LDEV number are represented in hexadecimal. Use list luse to query for the following information: • CU. The CU number of the expanded volume.
Example list luse without any options displays all the expanded luns defined in the disk array. CU 0 0 LDEV 00 0A DeviceLDEVs 01,02,03 0B,0D,0E,0F The -l option output displays all the expanded luns defined in the disk array along with the total number of paths to this LUSE, emulation type, reserved status, device type, and capacity. CU 0 0 LDEV 00 0A DeviceLDEVs TotalPaths 01,02,03 0 0B,0D,0E,0F 2 Emulation Reserve DeviceType CAPACITY OPEN-E RESERVE LUN 40 OPEN-3 NORMAL CmdDev 10 [-cu
list openv_util Description Use this command to calculate the number of LDEV IDs to pass when using the make volumes command (page 101) to create OPEN-V volumes in a VDEV. For XP 128/1024 arrays, if the volume to be created is larger than 60 GB the DKC creates a LUSE volume of equally sized custom volumes. The resulting emulation type is OPEN-V * n ( where n is the size of the LUSE volume). In this case you must pass n number of unused LDEV IDs to the make volumes command to create one volume.
Example LdevCount 40 OPEN-V Size (MB) 92160 OPEN-V Count EmulationType TotalSpaceNeeded(MB) 20 OPEN-V*2 2048000 If the size of the volumes to be created exceeds the available free space an appropriate error message will be displayed.The utility command notifies you if: • The number of volumes to be created exceeds 512 for VDEV of RAID type 7D+1P or 256 for other supported RAID types. • The size of the individual volume is less than 46.8MB or greater than 720GB (XP128/1024) or 2880GB (XP10000/XP12000).
list parity_group Description This command displays parity group configurations. Each parity group in the disk array is identified by its unique parity group name and has the following information associated with it: • Domain. The domain number of the parity group. For parity group 2-1, the domain number is “2.” • PG. The PG number of the parity group. For Parity Group 2-1, the PG number is “1.” • Raid Type. The RAID type of the parity group (for example, RAID5 (3D+1P). • Drive Type.
Example list parity_group without any options displays all domains, parity groups, and VDEVs. Domain 1 1 1 1 PG 1 1 2 3 VDev 1 2 1 1 The -l option output displays all domains, parity groups, and the information associated with each parity group. Domain PG Vdev Emulation RaidLevel IndividualFreeSpace(MB) InitializeCount 1 1 1 OPEN-* RAID5(3D+1P) 1 598.765625 0 1 2 1 OPEN-* RAID5(3D+1P) 5 0.625 3 1 2 1 OPEN-* RAID5(3D+1P) 1 7646.890625 3 1 3 1 OPEN-8 RAID5(3D+1P) 3 762.
[-emulation] Domain 1 1 1 1 1 PG 1 1 1 2 3 VDev 1 1 2 1 1 EmulationType OPEN-* OPEN-* OPEN-3 OPEN-8 OPEN-9 The -l option output is the same as for list parity_group -l. [-domain ] list parity_group -domain 1 Domain PG VDev 1 1 1 1 1 2 1 2 1 1 3 1 The -l option output is the same as for list parity_group. Only information for the specified domain is displayed. The -fs option output is the same as for list parity_group -fs. Only information for the specified domain is displayed.
list usable_cus Description This command lists the usable CUs present in the disk array. This is useful when creating custom LDEVs and initializing parity groups CLI commands. list usable_cus has the following information associated with it: • CUID. This specifies the CU number. For the XP128/XP1024, the CU numbers range from 0 to 31. For the XP10000/XP12000, CU numbers range from 0 to 63. CU numbers are displayed in hexadecimal. The -l and -col options cannot be used with this command.
list vsc Description The list vsc command displays the volume size configuration details for normal and custom volumes. Each LDEV is identified by the domain, parity group, VDEV, CU, and LDEV. list vsc has the following information associated with it: • Domain. The domain to which an LDEV’s parity group belongs. The XP128 can have 1 or 2 domains, the XP1024 can have up to 8 domains, the XP10000 can have upto 4 domains, and the XP12000 can have up to 18 domains. • PG.
Arguments [-domain ] The output displays all LDEVs defined in the disk array for the given domain numbers. [-pg ] The output is limited to the given parity group numbers. [-vdev ] The output is limited to the given VDEV numbers. [-cv] The output is limited to the custom volumes present in the disk array. [-nv] The output is limited to the normal volumes present in the disk array. [-deletable] Displays all LDEVs that can be deleted using the delete ldevs command.
make volumes Description Use this command to create OPEN-V volumes of a specified size from the remaining free space in a VDEV, or to initialize a VDEV and specify the volumes to create. This command is supported only for the OPEN-V emulation type. • The OPEN-V emulation type cannot be mixed with OPEN-3/8/9/E emulation types. • For XP128/1024 arrays with an openvsize less than 60 GB or for XP10000/XP12000 arrays, the number of LDEV IDs to be passed is same as openvcount.
Arguments -fs Specifies that you want to create OPEN-V volumes from the remaining free space of the VDEV. This option cannot be used with the -ts option. -ts Specifies that you want to create OPEN-V volumes that use the entire capacity of the VDEV. This option cannot be used with the -fs option. Example • make volumes 1, 1, 1, 52428800, 4, 00, 00:02-04 -fs This example creates four 50 GB volumes, (00:00) ,(00:02), (00:03), and (00:04), from the remaining 250GB of free space in VDEV 1-1-1.
DKC, DKU, and TRAP commands This section describes the following commands: • list acp_status or list dka_status, page 104 • list chip_status or list cha_status, page 105 • list chp_status, page 106 • list cm_status, page 107 • list csw_status, page 108 • list dkc_status, page 109 • list dkp_status, page 110 • list dku_status, page 111 • list drr_status, page 112 • list pg_status, page 113 • list sm_status, page 115 • list traps, page 117 Command View XP Command Line Interface (CLI) reference guide 103
list acp_status or list dka_status Description This command displays array control processor (ACP) and disk adapter (DKA) details. The terms ACP and DKA refer to the same component. You can also provide ACP/DKA names to view the status of specific ACPs/DKAs. Syntax list acp_status [-acp | -s ] or list dka_status [-dka | -s ] Arguments [-acp ] or [-dka ] Displays the status of the specified ACPs/DKAs.
list chip_status or list cha_status Description This command displays channel host interface processor (CHIP) and channel adapter (CHA) status details. The terms CHIP and CHA refer to the same component. You can also provide CHIP/CHA names to view the status of specific CHIPs/CHAs. NOTE: The output of range commands is not in alphabetical order, but in the order of how the chips or cha boards are configured on the array. Syntax list chip_status [-chip | -s
list chp_status Description This command displays channel processor (CHP) details. You can also provide chip names to view the status of specific CHPs. Syntax list chp_status [-chp | -s ] Arguments [-chp ] Displays the status of the specified CHPs. can be one value, a set of values, or a range of values (for example, 001P or 001P:001Q or 001P-001S). [-s ] Displays only those CHPs with the specified status types.
list cm_status Description This command displays cache memory (CM) details. You can also provide cache memory names to view the status of specific CMs. Syntax list cm_status [-cm | -s ] Arguments [-cm ] Displays the status of the specified CMs. can be one value or a set of values (for example, 1T or 1T:1U). [-s ] Displays only those CMs with the specified status types.
list csw_status Description This command displays cache switch (CSW) details. You can also provide CSW names to view the status of specific CSWs. Syntax list csw_status [-csw | -s ] Arguments [-csw ] Displays the status of the specified CSWs. can be one value or a set of values (for example, 1N or 1A:1Q). [-s ] Displays only those CSWs with the specified status types.
list dkc_status Description This command displays the disk controller (DKC) components and their overall status.
list dkp_status Description This command displays disk processor (DKP) details. You can also provide DKP names to view the status of specific DKPs. Syntax list dkp_status [-dkp | -s ] Arguments [-dkp ] Displays the status of the specified DKPs. can be one value, a set of values, or a range of values (for example, 801C or 801C:801D or 801C-801E). [-s ] Displays only those DKPs with the specified status types.
list dku_status Description This command displays the disk cabinet unit (DKU) component details and status.
list drr_status Description This command displays disk recovery and regeneration (DRR) details. You can also provide DRR names to view the status of specific DRRs. Syntax list drr_status [-drr | -s ] Arguments [-drr ] Displays the status of the specified DRRs. can be one value, a set of values, or a range of values (for example, 801B or 801B:801C or 801D-801E). [-s ] Displays only those DRRs with the specified status types.
list pg_status Description This command displays parity group (PG) status details. Syntax list pg_status [-s ] [-pg | -domain | -dku ] [-disk | -ldev | -map] Arguments [-s ] Displays only parity groups with the specified status types. can be one value or a set of values (for example, acute or acute:service). Values are normal, acute, service, moderate, and serious. [-pg
[-l] DKU# PG Component Status REFCODE Category Error R1 1-1 R120 Service EF2200 Drive error (normal R/W) Dynamic sparing normal end) R1 1-1 R130 Serious 43C300 Drive error (normal R/W) R1 1-2 * Normal R1 1-3 * Normal Drive blockade (Effect of Drive blockade (media) “*” indicates that all the components in that parity group are normal. If any of the components in a parity group have errors, then only those component names are specified.
list sm_status Description This command displays shared memory (SM) details. You can also provide shared memory names to view the status of specific SMs. NOTE: In XP10000 arrays, combination of SM-CHA will provide the unique shared memory information. You need to list both sm_status and cha_status/chip_status to identify the unique shared memory information. Syntax list sm_status [-sm | -s ] Arguments [-sm ] Displays the status of the specified SMs.
Output of list cha_status and sm_status Cluster# 1 1 2 2 1 1 2 2 CHA# 5 5 5 5 6 6 6 6 CHAName Cluster# MIX-1A 1 MIX-1A 2 MIX-2F 1 MIX-2F 2 MIX-1A 1 MIX-1A 2 MIX-2F 1 MIX-2F 2 SM# 0 0 0 0 0 0 0 0 116 CLI commands for the XP128/XP1024/XP10000/XP12000 SMName BASE-1C BASE-2D BASE-1C BASE-2D BASE-1C BASE-2D BASE-1C BASE-2D
list traps Description This command displays all the events from the disk array that have resulted in an SNMP trap. Syntax list traps [-n ] [-r ] [-s ] [-c ] Arguments [-n ] Lists traps for the specified components. can be one value or a set of values (for example, CHA-1P or CHA-1P:DRR80-1D). [-r ] Lists traps with the specified reference codes.
CLI commands for the XP128/XP1024/XP10000/XP12000
4 CLI Commands for the XP48 and XP512 This chapter contains CLI commands for LUN and volume management specifically for the XP48 and XP512. This chapter also contains additional CLI commands to list information about DKC and DKU components, and SMNP traps.
add lun_to_lun_group Description This command appends LUNs (or paths) to an existing LUN group. LUNs must have the same security defined. Syntax add lun_to_lun_group , , Arguments The port to which the LUNs are to be added. Port names are not case sensitive. The LUN group nickname of the LUN group to which the path is to be added. The LUN ID of the path to be added to the LUN group.
add security_to_lun Description This command assigns security to a LUN and associates that LUN with one or more WWNs or WWN groups. Only the host WWN or WWN group associated with this LUN can access this LUN. Syntax add security_to_lun , , , [,, ...] Arguments The port from which the LUN has been created. Port names are not case sensitive. The LUN ID of the LUN to be associated. LUNs must be given in hexadecimal.
add security_to_lun_group Description This command assigns security to a LUN group and associates that LUN group with one or more WWNs or WWN groups. Only the host WWN or WWN group associated with this LUN group can access this LUN group. Syntax add security_to_lun_group , , , [,, ...] Arguments The port from which the LUN group has been created. Port names are not case sensitive.
add wwn Description This command adds one or more WWNs to a port. Any number of WWNs can be given in the same command. Syntax add wwn , , [,, ...] Arguments The port to which the WWNs are to be added. Port names are not case sensitive. The WWN to be added. The WWN nickname to be used for a WWN.
add wwn_to_wwn_group Description This command adds WWNs to an existing WWN group. All the WWNs in a group must have the same security information. Syntax add wwn_to_wwn_group , , Arguments The port of the WWN group to which the WWNs are to be added. Port names are not case sensitive. The WWN group nickname of the WWN group. The WWN to be added.
create lun Description This command creates a LUN (or path). This command executes successfully if no path from the port to the LDEV and no other LUN is assigned for the port, SCSI ID, and LUN ID. This command allows for the addition of multiple paths in the array in one operation. Each port can have maximum of 256 paths. A range can be given for either ports or LUN IDs and LDEVs, but not both. Specify range values within square brackets [ ].
create lun_group Description This command creates a LUN group. If the LUN group already exists, the operation fails. Syntax create lun_group , , Arguments The port from which the LUN group has to be created. Port names are not case sensitive. The LUN group nickname to be created. The LUN ID to assign to the group being created. LUN IDs must be expressed in hexadecimal.
create wwn_group Description This command creates a WWN group with nickname and associates WWNs. All WWNs to be in the group must have same security information. Syntax create wwn_group , , , , [...] Arguments The port to which the WWN group is to be created. Port names are not case sensitive. The WWN group nickname to assign to the WWN group. , The WWNs to be added. There should be at least two WWNs.
delete lun Description This command deletes a specified LUN (or path). A range can be given for either ports or LUN IDs and LDEVs, but not both. Specify range values within square brackets: [ ]. Syntax delete lun , , , , Arguments The port of the path to be deleted. Port names are not case sensitive. The SCSI ID of the path to be deleted. SCSI IDs must be expressed in hexadecimal. The LUN ID of the path to be deleted.
delete lun_from_lun_group Description This command deletes a LUN (or path) from a LUN group. If there is only one LUN in the LUN group, the LUN group is also deleted. Syntax delete lun_from_lun_group , , Arguments The port of the LUN group from which the path is to be deleted. Port names are not case sensitive. The LUN group nickname of the LUN group from which the path is to be deleted.
delete lun_group Description This command deletes a LUN group. Syntax delete lun_group , Arguments The port of the path to be deleted. Port names are not case sensitive. The LUN group nickname that is to be deleted.
delete lun_security Description This command deletes security information for a LUN (or path). Syntax delete lun_security , Arguments The port of the path whose security information is to be deleted. Port names are not case sensitive. The LUN ID of the path whose security information is to be deleted. LUNs must be given in hexadecimal.
delete security_from_lun Description This command disassociates a WWN/WWN group specified in the command from the LUN. Syntax delete security_from_lun , , Arguments The port of the path to be deleted. Port names are not case sensitive. The LUN ID of the LUN whose security is to be deleted. LUNs must be given in hexadecimal.
delete security_from_lun_group Description This command deletes security from a LUN group. You must specify at least one WWN or WWN group nickname. Syntax delete security_from_lun_group , , Arguments The port of the LUN group whose security is to be deleted. Port names are not case sensitive. The LUN group whose security is to be deleted. The WWN or WWN group nickname to be disassociated from the LUN group.
delete wwn Description This command deletes the WWN for a port. Syntax delete wwn , Arguments The port from which the WWN is to be deleted. Port names are not case sensitive. The WWN nickname to be deleted.
delete wwn_from_wwn_group Description This command deletes one or more specified WWNs from a particular WWN group. This command does not allow you to delete WWNs from a WWN group that have less than two WWNs in the group. Syntax delete wwn_from_wwn_group , , Arguments The port of the WWN group from which the WWN is to be deleted. Port names are not case sensitive. The WWN group nickname of the WWN group. The WWN to be deleted.
delete wwn_group Description This command deletes a WWN group. You cannot delete the WWNs defined in the group with this command. To delete the WWNs, use the remove wwn_group command (see page 159). Syntax delete wwn_group , Arguments The port from which the WWN group is to be deleted. Port names are not case sensitive. The WWN group nickname to be deleted.
list cmd_device Description This command lists the command devices on the disk array. If there are no command devices, no values are displayed.
list count_for_volume_initialize Description This command lists the number of normal volumes deleted in the disk array that can be used for volume initialize operation. Syntax list count_for_volume_initialize [-pg ] Arguments [-pg ] If the -pg option is provided, then the output shows only information for the specified parity group.
list free_ldev Description This command lists the free or unallocated LDEVs in the disk array. Free or unallocated LDEVs are LDEVs that do not have paths assigned to them yet. Syntax list free_ldev [-cu ] Arguments [-cu ] If the -cu option is provided, then the output shows all paths relevant to that CU. CUs must be given in hexadecimal.
list lun Description This command displays path related configuration details. This command also lists paths belonging to a particular port. Syntax list lun [-port ] Arguments [-port ] If the -port option is provided, then the output shows only paths for the specified port name. Port names are not case sensitive. Output This command displays the following information: • Port name • SCSI ID • LUN ID • CU • LDEV • Capacity (MB) LUN IDs, CUs, and LDEVs are provided in hexadecimal.
list lun_group Description This command lists LUN group information for the disk array. Syntax list lun_group [-port [-group ]] Arguments [-port [-group ]] If the -port option is provided, you can also use the -group option. The output shows only LUNs for the specified port and group name. Port names are not case sensitive.
list lun_group_security Description This command lists LUN group security information for the disk array. Syntax list lun_group_security [-port [-group ]] Arguments [-port [-group ]] If the -port option is provided, you can also use the -group option. The output shows only the LUN security information for the specified port and group name. Port names are not case sensitive.
list lun_security Description This command lists LUN security information for the disk array. Syntax list lun_security [-port ] Arguments [-port ] If the -port option is provided, then the output shows only LUN security information for the specified port name. Port names are not case sensitive.
list pg_freespace_info Description This command lists the free space available in the parity groups. Syntax list pg_freespace_info [-pg ] Arguments [-pg ] If the -pg option is provided, then the output shows only information for the specified parity group.
list pg_volume_info Description This command lists the CUs in the disk array per parity group. Syntax list pg_volume_info [-pg ] Arguments [-pg ] If the -pg option is provided, then the output shows only information for the specified parity group.
list port Description This command lists all the ports of the disk array.
list security_switch Description This command lists security switch information for the disk array. Syntax list security_switch [-port ] Arguments [-port ] If the -port option is provided, then it lists the LUN security information for that port name. Port names are not case sensitive.
list wwn Description This command lists WWN information for WWNs registered with disk array ports. Syntax list wwn [-port ] Arguments [-port ] If the -port option is provided, then the output shows only WWNs for the specified port name. Port names are not case sensitive.
list wwn_group Description This command lists WWN group information for the disk array. Syntax list wwn_group [-port [-group ]] Arguments [-port [-group ]] If the -port option is provided, you can also use the -group option. The output shows only WWNs for the specified port and group name. Port names are not case sensitive.
modify cmd_device Description Use this command to set an LDEV as a command device or to release an existing command device. Syntax modify cmd_device , , SET|RELEASE Arguments The CU of the LDEV to be set or released as a command device. The CU must be specified in hexadecimal. The LDEV that is to be set or released as a command device. The LDEV must be specified in hexadecimal and is not case sensitive. SET|RELEASE If the flag is has the value SET, the LDEV is made a command device.
modify fibre_address Description This command modifies a port’s Fibre Channel address. Syntax modify fibre_address , Arguments The port address to be modified. Port names are not case sensitive. The address to be set. The fibre address is specified as a loop ID value.
modify fibre_topology Description This command modifies a port’s Fibre Channel topology. Syntax modify fibre_topology , Arguments The port topology to be modified. Port names are not case sensitive. The topology to be set. The fibre topology range is specified between 1 and 4.
modify host_mode Description This command modifies a port’s host mode. Syntax modify host_mode , Arguments The port host mode to be modified. Port names are not case sensitive. The new host mode to be set.
modify lun_group_nickname Description This command modifies a LUN group nickname. Syntax modify lun_group_nickname , , Arguments The port LUN group nickname to be modified. Port names are not case sensitive. The LUN group nickname to be modified. The new LUN group nickname to be set.
modify security_switch Description This command modifies port security by setting the security to ON or OFF. Syntax modify security_switch , ON|OFF Arguments The port security switch to be modified. Port names are not case sensitive. ON | OFF The switch value. The security switch can be ON or OFF.
modify wwn Description This command modifies the WWN for the port and WWN specified. Syntax modify wwn , , Arguments The port whose WWN is to be modified. Only one port can be specified. Port names are not case sensitive. The WWN to be modified. Only one WWN can be specified. Used to specify the new WWN. This must be a 16-digit hexadecimal value and must be unique within the port.
modify wwn_group_nickname Description This command modifies the WWN group nickname. Syntax modify wwn_group_nickname , , Arguments The port whose WWN group nickname is to be modified. Port names are not case sensitive. The WWN group nickname to be modified. The new WWN group nickname to be set.
modify wwn_nickname Description This command modifies a WWN nickname. Syntax modify wwn_nickname , , Arguments The port whose WWN nickname is to be modified. Port names are not case sensitive. The WWN nickname to be modified. The new WWN nickname to be set.
remove wwn_group Description This command deletes a WWN group and the WWNs defined in the group. Syntax remove wwn_group , Arguments The port from which the WWN group is to be deleted. Port names are not case sensitive. The WWN group nickname to be deleted.
Volume Management commands This section describes the following commands: • create custom_volumes, page 161 • delete vsc_volumes, page 162 • expand lun, page 163 • list ldev, page 164 • list ldev_size_info, page 165 • list luse, page 166 • list parity_group, page 167 • list unused_ldev_ids, page 168 • list usable_cus, page 169 • volume initialize, page 170 160 CLI Commands for the XP48 and XP512
create custom_volumes Description This command creates a custom volume. Syntax create custom_volumes , , , , [;, , , ...] Arguments The parity group number for the new custom volume. The CUs for the new custom volume. CUs should be represented in hexadecimal. The LDEV ID for the new custom volume. The LDEV ID should be expressed in hexadecimal. The emulation type of the new custom volume.
delete vsc_volumes Description This command converts a custom or normal volume into free space. This command cannot convert the last normal volume to free space. Syntax delete vsc_volumes , , [;, ...] Arguments The parity group for which the deletion of LDEV is to be done. The CU ID of the LDEV to be deleted. CUs should be represented in hexadecimal. The LDEV ID of the LDEV to be deleted. LDEV IDs should be represented in hexadecimal.
expand lun Description This command creates an expanded LUN. Syntax expand lun , , -lun , , , , or expand lun , -limit -lun , , , , Arguments The CU number of the first LDEV in the expanded volume. should be specified in hexadecimal. The LDEV number of the first LDEV in the expanded volume. should be specified in hexadecimal.
list ldev Description This command lists all the LDEVs that are available in the array. This command also lists LDEV information belonging to a CU. Syntax list ldev [-cu ] Arguments [-cu ] CU number. When used, the command lists only the LDEVs for the specified CU. CUs must be given in hexadecimal.
list ldev_size_info Description This command lists the LDEVs based on the parity group and/or CU numbers. Syntax list ldev_size_info [-pg ] [-cu ] Arguments [-pg ] If the -pg option is provided, then the output shows only information for the specified parity group. [-cu ] If the -cu option is provided, then the output shows only information for the specified CU. CUs must be given in hexadecimal.
list luse Description This command lists LUSE volumes on the disk array. This command also lists LUSE volumes belonging to a particular CU. Syntax list luse [-cu ] Arguments [-cu ] CU number. When used, the command lists only the LUSE volumes for the specified CU. CUs must be given in hexadecimal.
list parity_group Description This command lists all the parity groups of the disk array.
list unused_ldev_ids Description This command lists unused LDEV IDs present in the disk array. This information is generally used for assigning LDEV IDs to the custom and normal volumes created when using the create custom_volumes and volume initialize commands. This is not the same as unallocated LDEVs. For that, refer to list free_ldev on page 139. Syntax list unused_ldev_ids [-cu ] Arguments [-cu ] CU number. When used, the command lists only the unused LDEVs for the specified CU.
list usable_cus Description This command lists the usable CUs present in the disk array. Syntax list usable_cus Example list usable_cus displays all the CU IDs that can be used for configuration in the disk array.
volume initialize Description This command converts the custom volumes to normal volumes in a parity group. Execute the list count_for_volume_initialize command before executing this command to learn the volume count in order to provide the number of LDEVs to be assigned to the normal volumes. Syntax volume initialize , , [;, ...] Arguments The parity group present in the disk array. , The IDs of the new normal LDEVs to be created.
DKC, DKU, and TRAP commands This section describes the following commands: • list acp_status or list dka_status, page 172 • list chip_status or list cha_status, page 173 • list chp_status, page 174 • list cm_status, page 175 • list csw_status, page 176 • list dkc_status, page 177 • list dkp_status, page 178 • list dku_status, page 179 • list drr_status, page 180 • list pg_status, page 181 • list sm_status, page 183 • list traps, page 184 Command View XP Command Line Interface (CLI) reference guide 171
list acp_status or list dka_status Description This command displays array control processor (ACP) and disk adapter (DKA) details. The terms ACP and DKA refer to the same component. You can also provide ACPs/DKAs names to view the status of specific ACPs/DKAs. Syntax list acp_status [ | -s ] [-x] or list dka_status [ | -s ] [-x] Arguments [] or [] Displays the status of the specified ACPs/DKAs. [-s
list chip_status or list cha_status Description This command displays channel host interface processor (CHIP) and channel adapter (CHA) status details. The terms CHIP and CHA refer to the same component. You can also provide chip names to view the status of specific CHIPs/CHAs. Syntax list chip_status [ | -s ] [-x] or list cha_status [ | -s ] [-x] Arguments [] or [] Displays the status of the specified CHIPs/CHAs.
list chp_status Description This command displays channel processor (CHP) details. Syntax list chp_status [ | -s ] [-x] Arguments [] Displays the status of the specified CHPs. [-s ] Displays only those CHPs with the specified status types (for example, acute or service). Values are normal, acute, service, moderate, and serious. [-x] Lists a detailed error status for the CHPs with errors.
list cm_status Description This command displays cache memory (CM) details. You can also provide cache memory names to view the status of specific CMs. Syntax list cm_status [ | -s ] [-x] Arguments [] Displays the status of the specified CMs. [-s ] Displays only those CMs with the specified status types (for example, acute or service). Values are normal, acute, service, moderate, and serious. [-x] Lists a detailed error status for the CMs with errors.
list csw_status Description This command displays cache switch (CSW) details. You can also provide CSW names to view the status of specific CSWs. Syntax list csw_status [ | -s ] [-x] Arguments [] Displays the status of the specified CSWs. [-s ] Displays only those CSWs with the specified status types (for example, acute or service). Values are normal, acute, service, moderate, and serious. [-x] Lists a detailed error status for the CSWs with errors.
list dkc_status Description This command displays the disk controller (DKC) components and their overall status.
list dkp_status Description This command displays disk processor (DKP) details. You can also provide DKP names to view the status of specific DKPs. Syntax list dkp_status [ | -s ] [-x] Arguments [] Displays the status of the specified DKPs. [-s ] Displays only those DKPs with the specified status types (for example, acute or service). Values are normal, acute, service, moderate, and serious. [-x] Lists a detailed error status for the DKPs with errors.
list dku_status Description This command displays the disk cabinet unit (DKU) component details and status.
list drr_status Description This command displays disk recovery and regeneration (DRR) details. You can also provide DRR names to view the status of specific DRRs. Syntax list drr_status [ | -s ] [-x] Arguments [] Displays the status of the specified DRRs. can be one value, a set of values, or a range of values. [-s ] Displays only those DRRs with the specified status types (for example, acute or service).
list pg_status Description This command displays parity group (PG) status details. Syntax list pg_status [-x] [-s ] [-pg | -domain | -dku ] [-disk | -ldev] Arguments [-x] Lists a detailed error status for the parity groups with errors. [-s ] Displays only parity groups with the specified status types (for example, acute or service). Values are normal, acute, service, moderate, and serious. [-pg
Example Example 1 list pg_status -x DKU FB4 PG Status REFCODE Category Error R1 1 1 Service EF2200 Drive error (normal R/W) Dynamic sparing normal end) R1 1 1 Serious 43C300 Drive error (normal R/W) Drive blockade (Effect of Drive blockade (media) Example 2 list pg_status -x -disk DKU PG Disk Status REFCODE Category Error R1 1-1 R120 Service EF2200 Drive error (normal R/W) of Dynamic sparing normal end) R1 1-1 R130 Serious 43C300 Drive error (normal R/W) Drive blockade (Effect Drive blockade (media) Exa
list sm_status Description This command displays shared memory (SM) details. You can also provide shared memory names to view the status of specific SMs. Syntax list sm_status [ | -s ] [-x] Arguments [] Displays the status of the specified SMs. [-s ] Displays only those SMs with the specified status types. Values are normal, acute, service, moderate, and serious. [-x] Lists a detailed error status for the SMs with errors.
list traps Description This command displays all the events from the disk array that have resulted in an SNMP trap. Syntax list traps [-n ] [-r ] [-s ] [-c ] Arguments [-n ] Lists traps for the specified components. [-r ] Lists traps with the specified reference code. [-s ] Lists traps with the specified status types (for example, acute or acute:service).
5 Batch processing Use the Command View CLI to run one or more CLI commands contained in a text file called a batch file. Batch processing features include: • Ability to invoke the CLI, execute commands in a batch file, and then terminate. • Ability to execute a batch file during an interactive CLI session by using the execute command. • Ability to direct output from batch operations to a file. • Faster execution by processing related configuration change commands simultaneously.
• CVCLIScripting.txt: Instructions on running scripts using the -f option method. • configscript.txt: A script file for only listing the disk array configurations for an XP128/XP1024. • configscriptlegacy.txt: A script file for only listing the disk array configurations for an XP48/XP512. • configModifyScript128_1024_12000.txt: A script file for making disk array configuration changes to an XP128/XP1024/XP10000/XP12000. • configModifyScript512_48.
When using the execute command, you cannot use the connect command in the file. It is mandatory to issue the connect command before you issue the execute command. Also, you cannot use the disconnect command in the batch file. You must issue it after processing the execute command. Note that other commands are optional. A typical session sequence will be as follows: connect 10044 other commands... cvcli 10044(R)>execute listlun.txt other commands...
The results are: Sending request to the CV server ... 10039: The server has latest data. Sending output to file: all.out all.out contains: Executing line#1... list port -o port.out Sending output to file : port.out Executing line#2... list ldev -o ldev.out Sending output to file : ldev.out port.out contains: Executing line#1... list port -o port.out PortName CL1-A CL1-B CL1-C CL1-D CL1-E CL1-F Example 2 This command and batch file will execute correctly. list.txt contains: list port -o port.
-category Must be one of the following: • lun • host_group • luse [-col ] Use selective column names if the output file contains more fields than needed for the create or delete commands that are generated. -csv The -csv option must be used to produce comma-separated output. -o The file where the output is to be written. This can be a filename only or a path and filename.
Example 3 Enter: list lun -cmd create -category host_group -col PortName:HostGroupNickname -csv -o createhost_grp.txt CV_CLI 20036 (R)> list lun -cmd create -category host_group -col PortName:HostGroupNickname -csv Sending Request to CV server ... 20036 : The server has latest data.
Example 6 Enter: list wwn -cmd create -category wwn -csv -l -o creatwwn.txt or Enter: list wwn -cmd create -category wwn -csv -col PortName:HostGroupNickname:WWN For creating WWNs without a nickname: CV_CLI 20036 (R)> list wwn -cmd create -category wwn -csv -l Sending Request to CV server ... 20036 : The server has latest data.
Multiple set operations Consecutive related commands in a batch file are grouped together and sent to the Command View server for execution simultaneously. The following groups are the ones under which the commands are grouped. • LIST: Contains all the list commands. • LUN MANAGEMENT: Contains create lun, create luse, modify host_mode, modify cmd_device, modify fibre_topology, modify fibre_address, delete lun, and delete luse commands.
Output The output shows the line number where the error occurred and does not execute any of the commands. NOTE: For the XP48 and XP512, CLI error output does not specify the line numbers containing the errors. Commands not supported in the same batch file The following combinations of commands are not supported in the same batch file due to Mib restrictions. An error will occur if you try to run the following commands in the same file.
Example 6 The combination of modify host mode, modify fibre topology and modify fibre address commands when operated on same port causes an error for the XP512 array. modify host_mode CL1-B,0 modify fibre_topology CL1-B,1 modify fibre_address CL1-B,6 NOTE: This combination of commands works on XP128/XP1024 arrays.
Example 12 Adding and deleting WWNs to or from a WWN group and modifying the WWN group nickname (for the same port and WWN group): add wwn_to_wwn_group CL1-D,wwngrp1,0sanjay,testwwn modify wwn_group_nickname CL1-D,wwngrp1,wwngrp or delete wwn_from_wwn_group CL1-D,wwngrp1,0sanjay,testwwn modify wwn_group_nickname CL1-D,wwngrp1,wwngrp Example 13 Modifying the WWN nickname and then deleting the same WWN from the WWN group: modify wwn_nickname CL1-D,0sanjay,sanjayAG delete wwn_from_wwn_group CL1-D,wwngrp1,0sa
Batch processing
6 Error messages This chapter contains CLI error messages and codes you may encounter if a problem occurs during validation. There are two types of validations performed on CLI commands: • Command syntax validation • Configuration validation Both validation types return error messages or codes if a problem is found with a command. Command syntax validation verifies the syntax of the command, such as the record format, field type, and ranges for CUs, LDEVs, and so forth.
Table 3 Error messages (continued) Error message Problem/resolution COUNT_FOR_VOLUME_INITIALIZE Invalid format. The format should be: list count_For_Volume_Initialize [-pg ]. DEL_LUN_GRP_FORMAT Invalid format. The format should be: PortName, LUNGrpNickname. DEL_WWN_GRP_FORMAT Invalid format. The format should be: PortName, WWNGrpNickname. DELETE_CREATE_USER_ Comma-separated parameters were entered.
Table 3 Error messages (continued) Error message Problem/resolution INVALID_LDEV_TYPE Invalid LDEV value. The value should be a hex string. INVALID_LDEV_VALUE Invalid LDEV value. The LDEV value is out of range. INVALID_LDEVS_TYPE Invalid type. The format of device LDEVs in LUSE must be in hex. INVALID_LENGTH Invalid WWN/WWNGrpName length. INVALID_LIST_FORMAT The list record format is invalid. Use the help command for the actual format.
Table 3 Error messages (continued) Error message Problem/resolution INVALID_WWN_BYTE_SIZE The value should be a 16 character string. INVALID_WWN_GRP_NICKNAME_SIZE Invalid WWN Group Nickname size. The size should be a maximum of 8 bytes. INVALID_WWN_ID_RANGE The WWN ID is out of range. INVALID_WWN_NickName_SIZE Invalid WWN Nickname size. The size should be a maximum: 8 bytes. INVALID_WWN_TYPE Invalid WWN type. Should be a hex string. LIST_COUNT_FOR_VOLUME_INIT _FORMAT Invalid list.
Table 3 Error messages (continued) Error message Problem/resolution MAKE_VOLUME_COUNT Please use list openv_util to calculate the number of volumes to be passed while performing the make volumes operation. MAKE_VOLUMES_SET_OPERATION The make volumes operation was successful. MAKE_VOLUMES_LDEV_COUNT The number of LDEV IDs provided is not equal tot he OPEN-V count. MODI_WWN FORMAT Invalid format. The WWN format should be: PortName, Nickname, NewWWN.
Table 3 Error messages (continued) Error message Problem/resolution WWN_FORMAT Invalid format. The data record format should be: PortName, WWN, WWNNickname. WWN_GRP_FORMAT Invalid format. The format should be: PortName, WWNGrpNickname, WWNs in hex (minimum 2).
Error codes Table 4 XP48/XP512 error codes Error code Description 1000 The request of Host Mode (0xN1, 0xN2) is not matched to both of clusters ports value. Both of them must be the same. 1002 CA and/or BC volumes were tried to set the command Device. 1003 Your request was that the path to LDEV would be configured again. The path was set already from that port. 1004 Your request was that the single combination of Port, SCSI ID, and LUN would be configured for more than one volume.
Table 4 XP48/XP512 error codes (continued) Error code Description 1028 Your request of the combined number of LDEVs was over the specification of LUSE (Up to 36). Or, when LUSE is released, there is some LDEV that is included in the Expanded LU, and be not set. 1029 The size of CV that are combined to expanded LU, are different each other. Or, you want to combine CV and Normal Volume mixed. 1030 The area that was set for DCR is overlap to another DCR area.
Table 4 XP48/XP512 error codes (continued) Error code Description 1054 When specifying Install CV at the time of Normal to CV operation, CU number and LDEV number of Base Volume were not the same as CU number and LDEV number which were specified by CV. 1055 It was going to set up access permission to LUN contained in LUN group. 1056 It was going to set up access permission to WWN contained in WWN group. 1057 It was going to include LUN already contained in a group in other LUN groups.
Table 4 XP48/XP512 error codes (continued) Error code Description 1078 It was going to create Reserve volume for Auto LUN to the volume which constitutes extension LU. 1079 It was going to create Reserve volume for Auto LUN to the volume to which DCR is set. 1080 It was going to create Reserve volume for Auto LUN to the volume blockaded. 1081 It was going to create Reserve volume for Auto LUN to the volume to which the command device is set.
Table 4 XP48/XP512 error codes (continued) Error code Description 1101 CVS operation (Deinstall CV) was demanded from non-mounted volume. 1102 LDEV you tried to delete is the only Normal LDEV in the Parity Group. You cannot delete it by VSC Operation. 1103 The specific parity group is not configured in the Array. 1104 The SubSystem ID (SSID) can be set only by performing VSC operation. 1105 For the VSC operation, LDEV IDs assigned exceeds the number which can be set.
Table 4 XP48/XP512 error codes (continued) Error code Description 1208 In the volume migration request, the emulation type of the source volume is not supported type. Change request to set another source volume. 1209 In the volume migration request, the emulation type of the target volume is not supported type. Change request to set another target volume. 1210 In the volume migration request, the number of the migration volumes are over the upper limit.
Table 4 XP48/XP512 error codes (continued) Error code Description 1227 In the volume migration request, the source volume that is defined is “Secondary Volume” of Hitachi TrueCopy - S/390/HP Continuous Access XP. Change request to define another source volume. 1228 In the volume migration request, “RAID Level” of the source volume is not supported. Change request to define another source volume.
Table 4 XP48/XP512 error codes (continued) Error code Description 1245 Over the upper limit of Request (Instance) Number for the prediction data of Utilization. Delete the instance that is not used. 1246 In the request of Auto LUN configuration data change, more than one same request is set in one PDU. Same type set request send by each other PDU. 1247 In the request of Auto LUN configuration data change, DKP Number that is specified in the request is incorrect.
Table 4 XP48/XP512 error codes (continued) Error code Description 1268 When change request to the configuration data of port control, both of the threshold level for Total priority Port and priority port are set at same time. Change Request and re-send Set-Request. 1269 The priority mode change failed as Host I/Os are in progress. 1270 WWN is not specified in the configuration change request of PPC. 1273 Specified WWN is not configured in the array.
Table 4 XP48/XP512 error codes (continued) Error code Description 2006 Your environment did not include all of needed program product. (Ex: LUN configuration Manager XP or R.C. system resources.) 2007 Your request of LUSE configuration was rejected, because LUN configuration Manager XP was not installed. (R.C. program/LUNM/LUSE) 2008 Your request of LUN security was rejected, because Secure Manager XP was not installed. (R.C. Program/LUN Security).
Table 4 XP48/XP512 error codes (continued) Error code Description 2032 The connection between DKC -SVP is busy. Wait a just moment, and re-try from Refresh Request. 2033 The Configuration data is changing in SVP. Wait a just moment, and re-try from Refresh Request. 2034 XP48/XP512: License Key for PORT CONTROL RESOURCE MANAGER is not installed. Please install the same to perform any PORT CONTROL RESOURCE MANAGER SET operation. 2035 Possible Auto LUN initialization problem.
Table 5 XP128/XP1024/XP10000/XP12000 error codes (continued) Error code Description 11007 An error occurred. If this problem persists, please call the HP Product Support. 11999 Failed to create shared memory. Please call the HP Product Support. 12000 Failed to access shared memory. Please call the HP Product Support. 12001 Failed to reserve memory. Please call the HP Product Support. 12004 An error occurred. If this problem persists, please call the HP Product Support.
Table 5 XP128/XP1024/XP10000/XP12000 error codes (continued) Error code Description 15508 Forced cancel of Modify is executed. Re-execute Modify. 15513 Result of canceling forced Modify. It cannot be executed when some other manager is holding the lock through SNMP or SVP is in Modify. 15515 Result of canceling forced Modify. The user has not logged on or has not exclusively locked the array. 15516 Result of canceling forced Modify.
Table 5 XP128/XP1024/XP10000/XP12000 error codes (continued) Error code Description 22009 Invalid emulation type. The CV server configuration is not valid. Please call the HP Product Support. 22010 Failed to access the environment file (File does not exists). Please call the service personnel. 22011 Requests for configuration change of different products received at the same time. Please contact the HP Product Support. 22013 Internal logical inconsistency.
Table 5 XP128/XP1024/XP10000/XP12000 error codes (continued) Error code Description 31004 Failed to remove the path. The specified path is the last path of TrueCopy/ShadowImage volume. Please Correct the contents of LU path setting, and request the setting of the configuration information again. 31006 The emulation type of the LDEV to be combined as a part of LUSE is not an open volume. Please check the setting. 31007 You are tying to set the LUSE including already expanded LU.
Table 5 XP128/XP1024/XP10000/XP12000 error codes (continued) Error code Description 31033 The size specified during Customize Volume setting is out of the extent. (The value set is smaller than the minimum value, or larger than the maximum value). Note that the size depends on the emulation type of the target volume. 31034 The capacity for CV creation does not exist in the logical parity group.
Table 5 XP128/XP1024/XP10000/XP12000 error codes (continued) Error code Description 31071 The CU specified during the CVS operation (Install CV) cannot be set. Correct the specified contents. 31072 VSC operations (Initialize, Install CV, Delete LDEV) are specified in a single request for the configuration information setting. This combination of settings is not allowed. 31098 The VSC operation is requested for the unmounted volume. Please check the settings.
Table 5 XP128/XP1024/XP10000/XP12000 error codes (continued) Error code Description 31129 For WWN related configuration change requests (add/change), the maximum number that can be set for a port is already reached (range is 0 - 254). Please check the settings. 31130 Configuration change request contains number of host mode settings which exceeds the maximum number if host group IDs in the port. Please check the setting.
Table 5 XP128/XP1024/XP10000/XP12000 error codes (continued) Error code Description 31352 Since the port for which you had performed the configuration change request is the Initiator Port of CA, it cannot be changed. Please change the port attribute. (Change to TarGet or RCU TarGet attribute.) 31353 Since the port for which you had performed the configuration change request is the Initiator Port of CA, it cannot be changed. Please change the port attribute. (Change to TarGet or RCU TarGet attribute.
Table 5 XP128/XP1024/XP10000/XP12000 error codes (continued) Error code Description 32012 Communication failure while connecting to Array. Please check the setting of the LAN. After the check, if the problem persists, please contact HP Product Support. 32013 The Array is locked by another manager through SVP or SNMP. 32014 Communication failure while connecting to Array. The exclusive lock on the array is lost. 32019 VSC related configuration change is being processed in DKC.
Table 5 XP128/XP1024/XP10000/XP12000 error codes (continued) Error code Description 32092 VSC operation cannot be performed. (Maintenance is in process). Please wait for a while and re-execute the operation. 32093 VSC operation cannot be performed. (The function is not supported in the main. The target function is not supported). Please contact the HP Product Support. 32094 I/O exists in the target WWN, or unregistered WWN, or the request is given to the WWN specified to the group.
Table 5 XP128/XP1024/XP10000/XP12000 error codes (continued) Error code Description 55195 This functionality is not available. License Key for SNMP API needs to be installed. Please contact the HP Product Support. 55196 This functionality is not available. License Key for HPAV is required. Please contact the HP Product Support. 55197 This functionality is not available. License Key for PERFORMANCE MANAGEMENT BASE MONITOR is required. Please contact the HP Product Support.
Table 5 XP128/XP1024/XP10000/XP12000 error codes (continued) Error code Description 1105960 Failure while connecting to array because of network error. 1106950 An error occurred. Please contact HP Product Support. 1107990 A trap was generated. 1108090 A trap was generated. 1108091 An error was detected in the system. Please retry the operation. If the error occurs again, please contact the HP Product Support. 1904811 Please enter the nickname. 1904812 Please enter the product name.
Table 5 XP128/XP1024/XP10000/XP12000 error codes (continued) Error code Description 3056903 File not found. Please contact the HP Product Support. 3056904 IP address not set. Please contact the HP Product Support. 3056905 IP address specification error. Please contact the HP Product Support. 3104700 The IP address specified is not valid. 3104701 All fields in the IP address are specified as zero. Invalid IP address. 3104730 Maximum number of IP addresses are already listed. The limit is 32.
Table 5 XP128/XP1024/XP10000/XP12000 error codes (continued) Error code Description 4055618 Failed to access the file. Please contact the HP Product Support. 4056112 I/O in the Extended Copy Manager operation may be in progress. Please stop the I/Os and perform the operation again. 4056655 An internal server error occurred. Please contact HP Product Support. 4056656 Syntax error of the license key file. Please contact HP Product Support. 4056657 Boot mode error.
Table 5 XP128/XP1024/XP10000/XP12000 error codes (continued) Error code Description 5055997 SVP is busy. Please wait for a while and retry. 5056001 SVP is busy. Please wait for a while and retry. 5056002 SVP is busy. Please wait for a while and retry. 5056599 An internal server error occurred. Please contact the HP Product Support. 5056605 An internal server error occurred. Please contact the HP Product Support. 5056606 An internal server error occurred. Please contact the HP Product Support.
Table 5 XP128/XP1024/XP10000/XP12000 error codes (continued) Error code Description 10104049 Duplicate Fibre Address is specified. Please change the content of the change request and re-issue the operation. 10104089 The specified LUN is the last path the Command Device. Command Device needs to be released first. 10105499 The specified Host Mode is not valid. Please specify a correct Host Mode. 10106050 An internal server error occurred. Please contact the HP Product Support.
Table 5 XP128/XP1024/XP10000/XP12000 error codes (continued) Error code Description 20103020 No LUSE volumes available. 20103021 You cannot delete TOP LDEV in a LUSE. Please select a non-TOP LDEV in the LUSE. 20103022 Specified TOP LDEV cannot be used for forming a LUSE. There are no LDEVs available for expanding LDEVs. 20103023 Specified TOP LDEV cannot be used for forming a LUSE. There are no LDEVs available for expanding LDEVs. 51046897 Communication problem between DKCs and SVP.
Table 5 XP128/XP1024/XP10000/XP12000 error codes (continued) Error code Description 52045873 The HDEV specified cannot be configured as the Reserve volume because the HDEV is part of LUSE. Please check the specification. 52045874 Cache LUN is set to the HDEV specified as the Reserve volume. Release the Cache LUN setting. 52045875 Reserve volume cannot be used. If the problem persists after a few trials, please contact the HP Product Support. 52045876 Reserve volume is the command device.
Table 5 XP128/XP1024/XP10000/XP12000 error codes (continued) Error code Description 52046004 The emulation type of the specified target volume is not supported. If the problem persists after a few trials, please contact the HP Product Support. 52046005 The upper limit value is exceeded (Source, Target, Reserve). Please check the number of the volumes which can be set at a time. 52046006 The multiplicity of the copy job is exceeded.
Table 5 XP128/XP1024/XP10000/XP12000 error codes (continued) Error code Description 52046025 The specified source volume is the secondary volume of BC. If the problem persists after a few trials, please contact the HP Product Support. 52046026 The specified source volume is the primary volume of Data Migration. If the problem persists after a few trials, please contact the HP Product Support. 52046027 The specified target volume is the Root volume of the BC.
Table 5 XP128/XP1024/XP10000/XP12000 error codes (continued) Error code Description 52046821 Shared memory failure detected. Please contact the HP Product Support. 52046822 Power failure detected. Please contact the HP Product Support. 52046823 PS OFF is in process. Please contact the HP Product Support. 52046824 Data transfer failure (CHA). Please contact the HP Product Support. 52046825 Data transfer failure (DKA). Please contact the HP Product Support.
Table 5 XP128/XP1024/XP10000/XP12000 error codes (continued) Error code Description 52051305 Lock time-out detected. Please wait for a while and retry. 52051306 Command issuance rejected. Please check the pair status. 52051307 Command issuance treated as NOP. Please check the pair status. 52052195 Auto LUN parameter file access error. Execute the same operation a few times. If the problem persists after retrying, please contact the HP Product Support. 52052196 Auto LUN plan file access error.
Table 5 XP128/XP1024/XP10000/XP12000 error codes (continued) Error code Description 52052214 Invalid Auto LUN reserve information. Execute the same operation a few times. If the problem persists after retrying, please contact the HP Product Support. 52052215 Invalid Auto LUN internal information. Execute the same operation a few times. If the problem persists after retrying, please contact the HP Product Support. 52052216 Failed to create Auto LUN plan. Execute the same operation a few times.
Table 5 XP128/XP1024/XP10000/XP12000 error codes (continued) Error code Description 53049797 The specified PPC group is not configured. Please check the specified content and re-execute the operation. 53049799 The specified PPC group is already registered in the array. Please check the specified content and re-execute the operation. 53049800 The WWN which is the target of monitoring is not mounted in the specified port. Please check the specified content and re-execute the operation.
Table 5 XP128/XP1024/XP10000/XP12000 error codes (continued) Error code Description 53052123 The PP checked in SVP is determined as not installed in DKC. If the problem persists after few retries, please contact the HP Product Support. 53052697 Communication failure occurs. If the problem persists after few retries, please contact the HP Product Support. 53053613 New maintenance call NG. If the problem persists after few retries, please contact the HP Product Support.
Table 5 XP128/XP1024/XP10000/XP12000 error codes (continued) Error code Description 95046518 Failed to operate the file for executing the request. Reboot the SVP PC and re-execute the request. If the problem persists after few retries, please contact the HP Product Support. 95047606 For the requested content, the unexpected parameter is set. Please check the setting. If the problem persists after few retries, please contact the HP Product Support.
Error messages
Index A add ipaddress 31 add lun_to_lun_group 120 add security_to_lun 121 add security_to_lun_group 122 add wwn 123 add wwn_to_wwn_group 124 administrators properties of 45 audience 7 authorized reseller, HP 9 delete wwn_group 136 disconnect 22 disconnecting from a disk array 16 discovering disk arrays 16 document conventions 8 prerequisites 7 related documentation 7 documentation, HP web site 7 E batch mode 12 batch file setup 185 batch processing 185 bypassing the login window 13 ending a CLI session
list cm_status 107, 175 list cmd_device 137 list count_for_volume_initialize 138 list csw_status 108, 176 list device 38 list device_history 39 list dka_status 104, 172 list dkc_status 109, 177 list dkp_status 110, 178 list dku_status 111, 179 list drr_status 112, 180 list free_ldev 139 list ipaddress 40 list ldev 87, 164 list ldev_size_info 165 list licensekey_info 53 list lun 64, 140 list lun_group 141 list lun_group_security 142 list lun_security 143 list luse 91, 166 list openv_util 93 list parity_group
Figures 1 Login window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Tables 1 3 4 5 Document conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Error messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . XP48/XP512 error codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . XP128/XP1024/XP10000/XP12000 error codes. . . . . . . . . . . . .. .. .. .. . . . . .. .. .. .. . . . . .. .. .. .. .. .. .. .. . . . . .. .. .. .. .. .. .. .. . . . . . . . . . . . . . . . . . . . . . . . .8 . . . . . . 197 . . .