HP XP P9000 RAID Manager Reference Guide (T1610-96061, January 2014)

ManualsBrandsHP ManualsStorageHP XP P9500 Disk Array

HP XP P9000 RAID Manager Reference

Guide

Abstract

This guide provides a command reference for HP XP P9000 RAID Manager Software on HP XP P9000 disk arrays. The intended

audience is a storage system administrator or authorized service provider with independent knowledge of HP XP P9000 disk

arrays and the HP Remote Web Console.

HP Part Number: T1610-96061

Published: January 2014

Edition: Twelfth

Summary of content (294 pages)

PAGE 1
HP XP P9000 RAID Manager Reference Guide Abstract This guide provides a command reference for HP XP P9000 RAID Manager Software on HP XP P9000 disk arrays. The intended audience is a storage system administrator or authorized service provider with independent knowledge of HP XP P9000 disk arrays and the HP Remote Web Console.
PAGE 2
© Copyright 2010, 2014 Hewlett-Packard Development Company, L.P. Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. The information contained herein is subject to change without notice.
PAGE 3
Contents 1 Overview of commands............................................................................14 Summary of commands...........................................................................................................14 Data management commands.............................................................................................14 Configuration setting commands..........................................................................................15 Subcommands...................
PAGE 4
paircurchk ............................................................................................................................63 Syntax..............................................................................................................................64 Options and parameters.....................................................................................................65 Returned values..................................................................................................
PAGE 5
Options and parameters.....................................................................................................93 Returned values.................................................................................................................93 Error codes.......................................................................................................................93 Examples..................................................................................................................
PAGE 6
Example.........................................................................................................................113 4 Command tools......................................................................................114 inqraid................................................................................................................................114 Syntax............................................................................................................................
PAGE 7
Example.........................................................................................................................142 raidcom check_ext_storage external_grp..................................................................................142 Syntax............................................................................................................................143 Options and parameters...................................................................................................
PAGE 8
Options and parameters...................................................................................................153 Examples........................................................................................................................153 raidcom delete journal..........................................................................................................154 Syntax.....................................................................................................................
PAGE 9
raidcom get lun....................................................................................................................177 Syntax............................................................................................................................177 Options and parameters...................................................................................................177 Examples..............................................................................................................
PAGE 10
Example.........................................................................................................................191 raidcom delete rcu................................................................................................................191 Syntax............................................................................................................................191 Options and parameters..........................................................................................
PAGE 11
Options and parameters...................................................................................................204 Examples........................................................................................................................204 raidcom set hba_wwn...........................................................................................................206 Syntax.......................................................................................................................
PAGE 12
Syntax............................................................................................................................215 Options and parameters...................................................................................................216 Examples........................................................................................................................216 raidcom get snapshot.....................................................................................................
PAGE 13
Generic error codes (raidscan, raidqry, raidar, horcctl).........................................................238 Specific error codes.........................................................................................................239 SSB codes......................................................................................................................240 SSB codes returned by a replication command................................................................
PAGE 14
1 Overview of commands This chapter provides an overview of the RAID Manager (RAID Manager) commands. Summary of commands RAID Manager is command-line interface (CLI) software that enables you to perform operations on Hitachi RAID storage systems. RAID Manager can be used from attached hosts and from Storage Navigator computers. This document describes and provides the specifications for the RAID Manager commands.
PAGE 15
Table 1 Data management commands (continued) Command Description pairmon Obtains the pair status transition of each volume pair and reports it. If the pair status changes (due to an error or a user-specified command), the pairmon command issues a message. pairresync Re-establishes a split pair volume and then restarts the update copy operations to the secondary volume. The pairresync command can resynchronize either a paired logical volume or a group of paired volumes.
PAGE 16
Table 2 Configuration setting commands (continued) 16 Command Description raidcom get hba_wwn Displays WWN information of a registered host adapter. raidcom add lun Sets the LU paths. raidcom delete lun Deletes a LU path on the host group of the specified port. raidcom get lun Displays LU path information. raidcom modify port Sets port. raidcom get port Displays Port information. raidcom get ldev Displays LDEV information.
PAGE 17
Table 2 Configuration setting commands (continued) Command Description raidcom delete journal Deletes a journal volume from a journal. and delete the journal. raidcom modify journal Changes an option of Continuous Access Journal to be used at a journal. raidcom get journal Displays a journal group information. raidcom add snap_pool Creates a pool for Fast Snap or Snapshot. raidcom add thp_pool Creates a pool for Thin Provisioning and Thin Provisioning Z.
PAGE 18
Subcommands RAID Manager provides subcommands that are executed as options of RAID Manager commands. The RAID Manager subcommands include the Windows subcommands and the environment variable subcommands. Table 3 (page 18) lists the Windows subcommands in alphabetical order and provides a brief description of each subcommand. Table 4 (page 18) lists the environment variable subcommands in alphabetical order and provides a brief description of each subcommand.
PAGE 19
Typographic conventions for command format Convention Description Bold Indicates text on a window, other than the window title, including menus, menu options, buttons, fields, and labels. Example: Click OK. Italic Indicates a variable, which is a placeholder for actual text provided by the user or system. Example: copy source-file target-file Note: Angled brackets (< >) are also used to indicate variables. screen/code Indicates text that is displayed on screen or entered by the user.
PAGE 20
The following characters are not supported by both RAID Manager and Remote Web Console. To ensure that names are usable in both RAID Manager and Remote Web Console, do not use these characters in names.
PAGE 21
Figure 1 Usable characters for RAID Manager commands Differences between RAID Manager and Remote Web Console 21
PAGE 22
Figure 2 Usable characters for Remote Web Console Maximum number of characters There are some differences between the maximum number of characters for names in RAID Manager commands and the maximum number of characters for names in Remote Web Console. Because of this, you should always try to use the number of characters that can be used in both RAID Manager and Remote Web Console.
PAGE 23
Table 6 Maximum number of characters (continued) Name RAID Manager command Remote Web Console Device name 32 characters - LDEV nickname 32 characters 32 characters WWN nickname 64 characters 64 characters Copy group name 32 characters 32 characters Pool name 32 characters 32 characters Resource group name 32 characters 32 characters User name (User ID) 63 characters 256 characters User name (Password) 63 characters 256 characters Operational differences Table 7 (page 23) lists the
PAGE 24
Table 7 Operational differences between RAID Manager and Remote Web Console (continued) 24 Operation RAID Manager Remote Web Console Deleting PFC group The registration of PFC in the specified port is released by deleting WWN from the group. WWN is deleted from the group, but the PFC registration is maintained. Moving the parity groups which configure the distributed parity group between the CLPRs Parity groups cannot be moved. All parity groups which are concatenated are moved.
PAGE 25
2 Data management commands This chapter provides the specifications for the RAID Manager data management (replication and protection) commands. paircreate WARNING! Use the paircreate command with caution. The command starts the initial copy operation, which overwrites all data on the secondary/target volume of the pair.
PAGE 26
Options and parameters Option Description -h Displays help/usage and version information. -q Terminates the interactive mode and exits the command. -z or -zx Makes the paircreate command enter interactive mode. The -zx option guards performing of the HORCM in interactive mode. When this option detects a HORCM shutdown, interactive mode terminates. OpenVMS cannot use the -zx option.
PAGE 27
Option Description In Continuous Access Synchronous Z, when you specify the number less than or equal to 3, the copy speed is 3 tracks. When you specify the number more than or equal to 4, the copy speed is 15 tracks. In Business Copy, when you specify 1 or 2, the copy speed is slow, when you specify 3, the copy speed is medium, and when you specify 4, the copy speed is fast. -nocopy Creates paired volumes without copying data when the data consistency of simplex volumes is assured by the user.
PAGE 28
Option Description -jq The ESAM configuration only. Specifies the quorum ID with -f fence (never) option when creating a ESAM volume. And the following conditions must be met in the case of ESAM configuration. • It is not a CT group. • The fence level is set to 'Never'. • The RCU path is set to 'CU Free'. -js Continuous Access Journal only. This option is used when specifying a journal ID for SVOL.
PAGE 29
Option Description -gs : This 's' option is used when specifying a group name for cascading SVOL (defined in the configuration definition file). The command is executed for the specified group unless the -ds option shown below is specified. -ds : The following options can be specified for cascading S-VOL. -d[g]s [MU#] ... -d[g]s [MU#] -cto [c-time] [r-time] Continuous Access Synchronous Async and Continuous Access Journal only.
PAGE 30
Returned values The paircreate command sets either of the following returned values in exit (), which allows users to check the execution results using a user program. Normal termination: 0. When creating groups, 0 = normal termination for all pairs. Abnormal termination: other than 0. Refer to the error code for error details. Error codes Unrecoverable errors are fixed and not resolved, even after re-executing the command.
PAGE 31
volume, the data consistency is not guaranteed by the pairsplit command (including pairsplit -FMRCF) of the continuing I/O. • Registration and limitations of the number of CTGID When a pair creating, the RAID Manager maps and assigns the configuration definition file group to CTGID managed by storage system equiptment. The maximum number of the group that can be resistered to the storage system is 128 (from 0 to 127 for group ID).
PAGE 32
Example 3 The following figure shows a takeover example used to suspend a journal volume. Note: The pairresync command must be issued after Cnt Ac-S_Sync volume became SVOL_SSWS or PVOL_COPY/PAIR through the horctakeover command. Figure 6 Takeover example used to suspend a journal volume pairsplit The pairsplit command is used to split volume pairs.
PAGE 33
Figure 7 Pair Splitting The primary volume's server is automatically detected by the pairsplit command, so the server does not need to be specified in the pairsplit command parameters. If the -S option (simplex) is used, the volume pair is deleted, the volumes are returned to the simplex state, and the primary and secondary volume status is lost. Paired volumes are split as soon as the pairsplit command is issued.
PAGE 34
Option Description -g Specifies a group name defined in the configuration definition file. This option must always be specified. The command is executed for the specified group unless the -d option is specified. -d Specifies the paired logical volume name defined in the configuration definition file. When this option is specified, the command is executed for the specified paired logical volumes.
PAGE 35
Option Description Copies difference data retained in the primary volume into the secondary volume, then enables reading and writing from/to the secondary volume after completion of the copying. (This is the default option.) For , specify the copy pace for the pairsplit (range = 1 to 15 track extents). If not specified, the value used for paircreate or pairresync is used. -E Business Copy/Snapshot only. Suspends a paired volume forcibly when a failure occurs. Not normally used.
PAGE 36
the detailed status is logged in the RAID Manager command log ($HORCC_LOG), even if the user script has no error handling. Table 8 Specific Error Codes for pairsplit Category Error Code Error Message Volume status EX_ENQVOL Unmatched volume Confirm status using the pairdisplay 236 status within the group command. Make sure all volumes in the group have the same fence level and volume attributes. EX_INCSTG Inconsistent status in group Confirm pair status using pairdisplay.
PAGE 37
only), the pair is resynchronized in the reverse direction (that is, secondary volume to primary volume). The primary volume remains accessible during pairresync, except when the -restore option is specified. The secondary volume becomes write-disabled when the pairresync command is issued. The pairresync command cannot be used for Auto LUN. The pairresync command terminates before resynchronization of the secondary (or primary) volume is complete.
PAGE 38
Figure 11 Normal Resync and Business Copy Restore Resync NOTE: Read* : Option when the pair creating. If you specified '-m noread', it is not readable.
PAGE 39
Option Description -d[g] [MU#] Searches whether the specified LDEV is included in a group on the configuration definition file (local instance). If it is in the group, the target volume is executed as the paired logical volume (-d) or group (-dg). This option is effective without specification of '-g ' option. If the specified LDEV is contained in two or more groups, the command is executed on the first group.
PAGE 40
Option Description pairresync is performed as Non quick mode regardless of setting of $HORCC_RSYN environment variable and/or the system option mode 87 via SVP. mode = quick pairresync is performed as Quick Resync regardless of setting of $HORCC_RSYN environment variable and/or the system option mode 87 via SVP.
PAGE 41
Option Description to 255 seconds. If this option is not specified, then '90' seconds is set as default. For Continuous Access Journal, o-time can be specified from 1 to 600 seconds. If this option is not specified, then '60' seconds is set as default. If 'o-time=0' is specified, the inflow of Write I/O becomes invalid.
PAGE 42
Attribute Options -f fence -fg fence -fg fence CTGID Cmd rejected/Abnormal term.: Command execution is rejected, and the operation terminates abnormally. *If the identical CTGID is specified with the different group name of RAID Manager, then the command is rejected. So different CTGID must be specified for the different group name. Returned values The pairresync command sets the following returned values during exit allowing you to check the execution results. Normal termination: 0.
PAGE 43
Figure 13 Example of -FMRCF Option for pairresync Figure 14 Swap Operation Figure 15 Example of -swaps option with -FHORC [MU#] pairevtwait The pairevtwait (pair event waiting) command is used to wait for completion of pair creation and to confirm the status of pair operations. It waits ('sleeps') until the paired volume status becomes identical to a specified status and then completes. The pairevtwait command can be used for a paired logical volume or a group of paired volumes.
PAGE 44
detected by the pairevtwait command, so the server does not need to be specified in the pairevtwait command parameters. The pairevtwait command waits until the specified status is established, and terminates abnormally if an abnormal status is detected. The transition of the paired volume status is judged by the status of the primary volume. If the pairevtwait command is issued for a group, the command waits until the status of each volume in the group changes to the specified status.
PAGE 45
Option Description specified raw_device is contained in two or more groups, the command is executed for the first group. -FHORC [MU#] or -FCA [MU#] Forcibly specifies a cascading remote copy volume for specified pair logical volumes on local copy environment. If the -l option is specified, this option tests status of a cascading remote copy volume on a local host (near site). If no -l option is specified, this option tests status of a cascading remote copy volume on a remote host (far site).
PAGE 46
Table 10 Pairevtwait Returned Values (continued) Condition Value 4:The status is PSUS. 5:The status is PSUE. When monitoring groups, 1/2/3/4/5 = normal termination for all pairs. Abnormal termination: other than 0 to 127, refer to the error codes for error details. When the -nowaits option is specified: Normal termination: 1:The status is SMPL. 2:The status is COPY or RCPY. 3:The status is PAIR. 4:The status is SSUS (Note that SVOL_PSUS appears as SSUS). 5:The status is PSUE.
PAGE 47
Examples Figure 17 Example of -FHORC Option for Pairevtwait Figure 18 Example of -FMRCF Option for Pairevtwait Using -ss ... and -nowaits option In PVOL_PSUS and SVOL_COPY state of HOMRCF quick mode, pairevtwait will return immediately even if the S-VOL is still in SVOL_COPY state because PVOL is already in PVOL_PSUS state. If you want to wait the SVOL_SSUS state, then use the -ss and -nowaits options to wait for the pair status on SVOL side.
PAGE 48
The horctakeover command suspends G2(CA-Jnl) automatically if horctakeover returns 'Swap-takeover' as an exit code. In DC1 host failure, if APP1 wants to wait until DC3 becomes the suspend state, then they can verify the 'SSUS' state by using the pairevtwait command as shown below.
PAGE 49
Option Description -allsnd Reports all events if there is pair status transition information. -resevt Reports events if there is pair status transition information, and then resets all events. -nowait When this option is specified, the command does not wait when there is no pair status transition information. -s ... Specifies the pair status transition to be reported: smpl, copy (includes rcpy), pair, psus, psue.
PAGE 50
Table 12 Results of pairmon command options (continued) -D -nowait -resevt -allsnd Actions Invalid -nowait -resevt - When HORCM does not have an event, this option reports event nothing. If one or more events exist, then it reports one event and resets all events. Invalid -nowait -resevt -allsnd When HORCM does not have an event, this option reports event nothing. If one or more events exist, then it reports all events and resets all events.
PAGE 51
Option Description -c Checks the conformability of the paired volumes of the local and remote hosts and reports the volume attribute of the remote host. If this option is not specified, the volume attribute of the local host is reported. -ss Used when acquiring the attribute of a volume and the pair status of a volume. If this option is not specified, the volume attribute of the local host is reported. -nomsg Suppresses messages to be displayed when this command is executed.
PAGE 52
Table 13 pairvolchk returned values (continued) Condition Value 45: The status is PVOL_PSUE. 46: The status is PVOL_PDUB. (Continuous Access Synchronous & LUSE volume only) 47: The status is PVOL_PFUL. 48: The status is PVOL_PFUS. 52: The status is SVOL_COPY or SVOL_RCPY. 53: The status is SVOL_PAIR. 54: The status is SVOL_PSUS. 55: The status is SVOL_PSUE. 56: The status is SVOL_PDUB. (Continuous Access Synchronous & LUSE volume only) 57: The status is SVOL_PFUL. 58: The status is SVOL_PFUS.
PAGE 53
# pairvolchk -g oradb pairvolchk : Volstat is P-VOL.[status = PAIR ] Display example for Business Copy (specified with '-m grp' option): # pairvolchk -g oradb pairvolchk : Volstat is P-VOL.[status = PAIR, CTGID = 1 ] Display example for Continuous Access Synchronous: # pairvolchk -g oradb pairvolchk : Volstat is P-VOL.[status = PAIR, fence = DATA, MINAP = 2 ] Display example for Continuous Access Synchronous Sync CTG: # pairvolchk -g oradb pairvolchk : Volstat is P-VOL.
PAGE 54
SVOL_ SSUS(SSWS): MINAP shows the result of the suspend operation that indicates whether or not the remaining All data on PVOL were Passed (synchronized) to SVOL completely. If MINAP is 'one', All data were passed. If not, all data were not passed from PVOL. Note: If RAID F/W is not supporting the active paths, then the 'MINAP' item is not displayed as follows: pairvolchk : Volstat is P-VOL.
PAGE 55
Figure 21 Example of -FHORC option for pairvolchk Figure 22 Example of -FMRCF option for pairvolchk The following table shows the truth table for pairvolchk group status display.
PAGE 56
Table 14 Pairvolchk group status (continued) Option COPY/RCPY PSUE PDUB PFUS PSUS PFUL PAIR Group status not-exist : the target status not existing in the group The PFUL state appears as PAIR by all commands (except the -fc option of the pairdisplay command), since PFUL indicates PAIR state with sidefile at the HWM. The PFUS state appears as PSUS by all commands (except the -fc option of the pairdisplay command), since PFUS indicates SUSPENDED state due to sidefile full.
PAGE 57
Option Description copy volume on a local host (near site). If no -l option is specified, this option displays status of a cascading remote copy volume on a remote host (far site). This option cannot be specified with -m option on the same command line. -FMRCF [MU#] or -FBC [MU#] Forcibly specifies a cascading local copy volume for specified pair logical volumes on remote copy environment.
PAGE 58
Option Description CTG: For Continuous Access Synchronous/Continuous Access Synchronous Async/Continuous Access Journal, it displays the CT group ID when the Fence is shown as ASYNC. For Continuous Access Synchronous Sync CTG, displays the CT group ID when the Fence is shown as DATA/STATUS/NEVER. For Business Copy, it displays the CT group ID on at-time split volumes using Business Copy. JID: The journal ID for PVOL or SVOL.
PAGE 59
Option Description - homrcf1 deva2 - - -m L CL1-D 3 5 2 30053 271 SMPL - - Used when displaying a paired status of each mirror descriptors for the specified pair logical volume, and used for paired status indication of the cascading volume. The option can be designated 'cas' or 'all' : • The 'cas' option is used when displaying a paired status of specified group that is registered to the mirror descriptor (MU#) on the cascading configuration file.
PAGE 60
Option Description CTG P/S Status AP U(%) Q-Marker CT/m RT/m QM-Cnt SF(%) Seq# IFC OT/s 001 5 P-VOL PAIR 5 2 0 00000080 3 50 63528 ON 90 001 - S-VOL PAIR - - 0 0000007d - 50 63528 - - CTG: Displays the CT group ID. P/S: The attribute of a volume in first LDEV of the specified group. Status: The status of the paired volume in first LDEV of the specified group.
PAGE 61
Option Description H(%): Displays the threshold rate being set to the Snapshot pool as High water mark. 'Unknown' is shown as '-'. Note: This option displays nothing if the target volume is NOT Snapshot volume. -v pid -FMRCF The '-FBC [MU#]' option is used for displaying the pool information of cascading Snapshot volume, so that you can know/monitor the pool status on remote host connected to cascading Continuous Access Synchronous_PVOL to Continuous Access Synchronous_SVOL/Snapshot_PVOL.
PAGE 62
oradb2 oradev21(R) 30053 272 W oradb oradev1(R) ----- 266 - (CL1-D , 3, 2-1) 30053 268....P-VOL PSUS, (CL1-D , 3, 2) 30053 268....S-VOL COPY, Seq#, LDEV#..P/S, Status, 30052 266....SMPL ----, 30052 266....SMPL ----, 30052 266....SMPL ----, 30052 266....P-VOL PAIR, 30053 268....P-VOL COPY, 30053 268....P-VOL PSUS, 30053 268....SMPL 30053 268....
PAGE 63
% = copy operation completion, or percent pair synchronization Vol.
PAGE 64
Table 15 Data consistency displayed by the paircurchk command Object Volume Currency Attribute Status Fence Paircurchk SVOL_takeover SMPL - - To be confirmed - P-VOL - - To be confirmed - S-VOL COPY Data Inconsistent Inconsistent Async Inconsistent Inconsistent Data OK OK Status OK OK Never To be analyzed To be analyzed Async To be analyzed OK (assumption) To be analyzed OK (assumption) Data Suspected Suspected Status Suspected Suspected Never Suspected Suspect
PAGE 65
Options and parameters Option Description -h Displays Help/Usage and version information. -q Terminates the interactive mode and exits the command. -z or -zx Makes the paircurchk command enter the interactive mode. The -zx option guards performing of the HORCM in the interactive mode. When this option detects a HORCM shut down, interactive mode terminates. OpenVMS cannot use the -zx option.
PAGE 66
Examples The following shows an example of the paircurchk command for a group and the resulting display of inconsistent volumes in the specified group. # paircurchk -g oradb Group Pair vol Port targ# lun# LDEV# oradb oradb1 CL1-A 1 5 145 oradb oradb2 CL1-A 1 6 146 Volstatus S-VOL S-VOL Status PAIR PSUS Fence NEVER STATUS To be... Analyzed Suspected horctakeover The horctakeover command is a scripted command for executing several takeover operations.
PAGE 67
Option Description specified raw_device is contained in two or more groups, the command is executed for the first group. -d[g] [MU#] Searches whether the specified LDEV is included in a group on the configuration definition file (local instance). If it is in the group, the target volume is executed as the paired logical volume (-d) or group (-dg). This option is effective without specification of '-g ' option.
PAGE 68
Table 17 Specific error codes for horctakeover (continued) Category Timer Error Code Error Message Recommended Action Value EX_EVOLCE Pair Volume combination error Confirm pair status using pairdisplay, and change combination of volumes. 235 EX_VOLCUR S-VOL currency error Check volume list to see if an operation 225 was directed to the wrong S-VOL. EX_VOLCUE Local Volume currency Confirm pair status of the local volume.
PAGE 69
Option Description if the '-find' option is not specified. If this option is specified, the following -s option is invalid. The -pdg option is used when displaying a LUN on the host view by finding a host group (XP1024/XP128 Disk Array and later). -s Used to specify the Seq# (serial#) of the storage system when this option cannot specify the unit ID which is contained for '-p ' option.
PAGE 70
Option Description -find [op] [MU#] Executes the specified [op] using a raw device file provided via STDIN. If the -pi option is specified, this option does not use a strings via STDIN, and -pi is used as input. Restrictions: Special files via STDIN are specified in the following ways: • HP-XP: /dev/rdsk/* or /dev/rdisk/disk* • Solaris: /dev/rdsk/*s2 or c*s2 • Linux: /dev/sd... or /dev/rd..., /dev/raw/raw*. • zLinux: /dev/sd... or /dev/dasd… or /dev/rd... /dev/raw/raw*.
PAGE 71
Option Description -find verify [MU#] Displays the relation between Group on the configuration definition file and Device_File registered to the LDEV map tables, based on the Device File name (raw device file provided via STDIN). This option can be used with '-fx' and '-fd' options. This option is affected by the command execution environment (HORCC_MRCF).
PAGE 72
Option Description If the target device has shared an LDEV among multiple device files and an LDEV is displayed by another target device already, then its target device is suppressed as a comment as shown below: # ERROR [LDEV LINK] /dev/rdsk/c24t0d3 SER = 61456 LDEV = 195 [FIBRE FCTBL = 4] If the target device does not have a valid MU#, then its target device is suppressed as a comment as shown below: # ERROR [INVALID MUN (2 < 1)] /dev/rdsk/c24t0d3 SER = 61456 LDEV = 195 [ OPEN-3 ] If the target device is
PAGE 73
Returned values -- Error codes -- Examples raidscan command examples for fibre-channel ports # raidscan -p cl1-r PORT#/ALPA/C,TID#,LU#Num(LDEV#...)P/S,Status,Fence,LDEV#,P-Seq#P-LDEV# CL1-R/ ce/15,15, 7 5(100,101..)P-VOL PAIR NEVER 100,5678 200 CL1-R/ ce/15,15, 6 5(200,201..)SMPL ------- ---- ---- ----# raidscan -p cl1-r -f PORT#/ALPA/C,TID#,LU#Num(LDEV#...)P/S,Status,Fence,LDEV#,Vol.Type CL1-R/ ce/15,15, 7 5(100,101..)P-VOLPAIRNEVER100,OPEN-3 CL1-R/ ce/15,15, 6 5(200,201..
PAGE 74
The I/O activity of a Continuous Access Synchronous/ Continuous Access SynchronousAsync/Continuous Access Journal S-VOL in the COPY or PAIR state includes Continuous Access Synchronous/Continuous Access Synchronous Async/Continuous Access Journal remote I/Os (update copy operations) in addition to host-requested I/Os. The I/O activity of a Business Copy/Snapshot/Auto LUN S-VOL in the COPY or PAIR state includes only host-requested I/Os (Business Copy/Snapshot/Auto LUN update copy operations are excluded).
PAGE 75
Error codes -- Examples The following shows an example of the raidar command and its output. # raidar -p cl1-a 15 6 -p cl1-b 14 5 -p cl1-a TIME[03]PORTTLVOLSTATUSIOPSHIT(%)W(%)IOCNT 13:45:25--------13:45:28CL1-A156SMPL---200.080.040.0600 CL1-B145P-VOLPAIR133.335.013.4400 CL1-A123P-VOLPSUS200.035.040.6600 12 3 -s 3 Output of the raidar command: IOPS: # of I/Os (read/write) per second (total I/O rate). HIT(%): Hit rate for read I/Os (read hit rate).
PAGE 76
Returned values — Error codes — Examples Example 1 The following shows an example of the raidqry command and its output.
PAGE 77
RAID_type: The type of RAID configured in the group. IV/H: The interface version for Continuous Access Synchronous/Continuous Access Synchronous Async/Continuous Access Journal in a group, and this is used for maintenance. IV/M: The interface version for Business Copy/Snapshot/Auto LUN i in a group, and this is used for the maintenance. MUN/H: The number of maximum MUs for Continuous Access Journal in a group. MUN/M: The number of maximum MUs for Business Copy/Snapshot in a group.
PAGE 78
Option Description -nomsg Suppresses messages to be displayed when this command is executed. It is used to execute this command from a user program. This option must be specified at the beginning of a command argument. The command execution log is not affected by this option. -vt [type] Specifies the following data type that assumes the target volumes as Oracle database. If [type] is not specified, then this option will disable all of the checking.
PAGE 79
Option Description microcode version 21-08-xx. This option is ignored (default = infinite) in XP1024/XP128 Disk Array microcode version 21-06-xx or 21-07-xx. • This option sets each four flags for guarding type as follows: typeINQRCAPREADWRITE inv1111Sz00111rwd0011wtd0001 -vext Used when extending the LUN capacity of Thin Provisioning volume. is used when specifying the extension data size in units of 'G,g,M,m,K,k'.
PAGE 80
Disables writing and sets retention time to volumes in oralog group: raidvchkset -g oralog -vg wtd 365 Releases all guarding to volumes in oralog group: raidvchkset -g oralog -vg raidvchkdsp The raidvchkdsp command displays the parameters for validation checking of the specified volumes. Unit of checking for the validation is based on the group of RAID Manager configuration definition file.
PAGE 81
Option Description -c When RAID Manager starts, HORCM_DEV in horcm.conf is translated from Port/target/lun numbers to the CU:Ldev information, on one hand HORCM_LDEV in horcm.conf is translated from the CU:Ldev information to Port/target/lun numbers, because RAID needs to specify 'Port#, Targ#, Lun#' and 'LDEV' for specifying the target device, and then HORCM keeps this information as internal database for the configuration.
PAGE 82
Returned values -- Error codes -- Examples Example 1 Example of raidvchkdsp command with -fd option: raidvchkdsp -g vg01 -fd -v cflag Group PairVol Device_File Seq# LDEV# BR-W-E-E MR-W-B BR-W-B SR-W-B-S vg01 oradb1 Unknown 2332 - - - - - - - - - - - vg01 oradb2 c4t0d3 2332 3 D E B R D D D D E E D E D D Example 2 Example of raidvchkdsp command with -fe option and its output: # raidvchkdsp -g horc0 -v gflag -fe Group... TID LU Seq# LDEV# GI-C-R-W-S PI-C-R-W-S R-Time EM E-Seq# horc0...
PAGE 83
W=E: Checking for data block size on Write is enabled. W=D: Checking for data block size on Write is disabled. E=L: Data block on Read/Write is interpreted as little endian format. E=B: Data block on Read/Write is interpreted as big endian format. E=W: This shows the Warning that Read/Write is not rejected when validation error is detected. E=R: This shows the Reject that Read/Write is rejected when validation error is detected. MR-W-B: Displays the flags for checking CHK-F3 in the data block.
PAGE 84
BNM: Displays the number of bits for checking regarding CHK-F2, in units of bits. If BNM is zero, this means the checking for CHK-F2 is disabled.
PAGE 85
R-Time: Displays the retention time for write protect, in units of day. The hyphen (-) shows that the retention time is infinite. The application knows whether the target volume is denied to change to writing enable by referring 'R-Time'. R-time (Rtime) is identical to rtime and both of them indicate Retention Time. This setting value can normally be identified as a value of R-time that is output by raidychkdsp (the logging format is Rtime=xxxx).
PAGE 86
Note: This command is rejected with EX_ERPERM by connectivity checking between RAID Manager and the RAID storage system. Syntax raidvchkscan { -h | -q | -z | -I[H][M][instance#] or I[TC][SI][instance#] | -p [hgrp] | -pd[g] | -s | -t | -l | [ -f[x] ] | -v } Options and parameters Option Description -h Displays Help/Usage and version information. -q Terminates the interactive mode and exits the command.
PAGE 87
Option Description pool: This option displays the pool capacity and the usable capacity for the pool ID to which the LDEV belongs. This is needed to help the decision whether the restore operation is possible or not, because the pool capacity is consumed by the restore operation of the Snapshot. aou[b]: Displays the LUN capacity and usage rate for only Thin Provisioning volume mapped to the specified port, and displays the ID of the pool to which LDEV belongs.
PAGE 88
B=D: Comparing for CHK-F2 in the data block is disabled. Z =E: The NON zero checking for CHK-F2 in the data block is enabled. D: The NON zero checking for CHK-F2 in the data block is disabled. SR-W-B-S: Displays the flags for checking regarding CHK-F1 in the data block. R =E: Checking for CHK-F1 on Read is enabled. D: Checking for CHK-F1 on Read is disabled. W =E: Checking for CHK-F1 on Write is enabled. D: Checking for CHK-F1 on Write is disabled. B =E: Checking for CHK-F1 in the data block #0 is enabled.
PAGE 89
SCEC: Displays the error counter for checking of CHK-F1 validation. BNEC: Displays the error counter for checking of CHK-F2 validation.
PAGE 90
Output of the raidvchkscan command with -v aou option: Used(MB): Displays the usage size the allocated block on this LUN. Range: 0 ≤ Used (MB) < LU_CAP(MB) + 42MB LU_CAP(MB): Displays the LUN capacity responded to the 'Readcapacity' command as SCSI interface. LU_CAP(BLK): Displays the LUN capacity (in block/512 bytes) responded to the 'Readcapacity' command as SCSI interface. U(%): Displays the usage rate of the allocated block on the Thin Provisioning pool containing this LU.
PAGE 91
Examples Example 1 Example of raidvchkscan command with -v jnl 0 option # raidvchkscan -v jnl 0 JID MU CTG JNLS AP U(%) 001 0 1 PJNN 4 21 002 1 2 PJNF 4 95 002 2 2 SJNS 4 95 003 0 3 PJSN 4 0 004 0 4 PJSF 4 45 005 0 5 PJSE 0 0 006 - SMPL 007 0 6 SMPL 4 5 Q-Marker 43216fde 3459fd43 3459fd43 1234f432 345678ef Q-CNT 30 52000 52000 78 66 D-SZ(BLK) 512345 512345 512345 512345 512345 512345 512345 512345 Seq# Nnm LDEV# 62500 2 265 62500 3 270 62500 3 270 62500 1 275 62500 1 276 62500 1 277 62500 1 278 62500 1
PAGE 92
Figure 23 Example of Q-Marker and Q-CNT U(%): Displays the usage rate of the journal data. D-SZ: Displays the capacity for the journal data on the journal volume. Seq#: Displays the serial number of the RAID storage system. Num: Displays the number of LDEV configured the journal volume. LDEV#: Displays the first number of the LDEV that is configured for the journal volume. Using a combination of JNLS status and other information, the application will know the following detail state.
PAGE 93
Example 2 Example of raidvchkscan command with -v jnlt option # raidvchkscan -v jnlt JID MU CTG JNLS AP U(%) 001 0 1 PJNN 4 21 002 1 2 PJNF 4 95 003 0 3 PJSN 4 0 Q-Marker 43216fde 3459fd43 - Q-CNT 30 52000 - D-SZ(BLK) 512345 512345 512345 Seq# DOW PBW APW 63528 20 300 40 63528 20 300 40 63528 20 300 40 Output of the raidvchkscan command with -v jnlt option: DOW: Data Overflow Watch' timer (in seconds) setting per the Journal. PBW: Path Blockade Watch timer setting (in seconds) per the Journal.
PAGE 94
Examples Example of raidvchkscan command example with -v pid option # raidvchkscan -v pid 0 PID POLS U(%) SSCNT H(%) 001 POLN 10 330 002 POLF 95 9900 003 POLS 100 10000 004 POLE 0 0 Available(MB) 10000000 100000 100 0 Capacity(MB) Seq# Num LDEV# 1000000000 1000000000 1000000000 0 62500 62500 62500 62500 2 3 1 0 265 270 275 0 80 70 70 80 Output of the raidvchkscan command with -v pid option: PID: Displays the Fast Snap/Snapshot/Thin Provisioning pool ID.
PAGE 95
W(%): Displays the threshold value for 'WARNING' set for this Thin Provisioning pool. H(%): Displays the threshold rate set for the Thin Provisioning pool as high water mark. Num: Displays the number of LDEVs configured the Thin Provisioning pool. LDEV#: Displays the first number of LDEV configured the Thin Provisioning pool. LCNT: Displays the total number of Thin Provisioning volumes mapped to this Thin Provisioning pool.
PAGE 96
Option Description HORCMSTART_WAIT (for waiting the RAID Manager instance with start-up). Horcmgr does fork/exec() horcmd_XX as daemon process, and verifies/waits until HORCM become ready state. The timeout is used for only avoiding infinite loop, currently the default time is 200 sec in consideration of maximum LDEV. However, it may be needed to change the default timeout value for starting HORCM under high-loading of the server, or the remote command device.
PAGE 97
Syntax horcctl { -h | -q | -z | -I[H][M][instance#] or I[TC][SI][instance#] | -d | -c | -l | -b | -s | -t | -S | -D[I] | -C | [-u <-unitid> | -ND | -NC | -g } Options and parameters Option Description -h Displays Help/Usage and version information. -q Terminates the interactive mode and exits the command. -z or -zx Makes the horcctl command enter the interactive mode. The -zx option guards performing of the HORCM in the interactive mode.
PAGE 98
Option Description Current control device = /dev/rdsk/c0t0d0 AI = 14 TI = 0 CI = 1 where AI : NUM of actual instances in use TI : NUM of temporary instances in RAID CI : NUM of instances using current (own) instance -u Used when specifying the unit ID of a command device as the target. This option is effective when the -D or -C option is specified. If this option is not specified, the unit ID is 0. -ND -g Displays the network address and port name being used by HORCM.
PAGE 99
Option Description -d[g][s] [MU#] Searches the configuration definition file (local instance) for a volume that matches the specified sequence # and LDEV. If a volume is found, the command is executed on the paired logical volume (-d) or group (-dg).This option is effective without specification of the '-g ' option. If the specified LDEV is listed in multiple device groups, this will apply to the first one encountered.
PAGE 100
Examples Example 1 horctakeoff command on L1 local site # horctakeoff -g G1 -gs G2 horctakeoff : 'pairsplit -g G1 -S -FHORC 2' is in progress horctakeoff : 'pairsplit -g G1' is in progress horctakeoff : 'pairsplit -g G2 -S' is in progress horctakeoff : 'paircreate -g G1 -gs G2 -FHORC 2 -nocopy -f async -jp 0 -js 1' is in progress horctakeoff : 'pairsplit -g G1 -FHORC 2' is in progress horctakeoff : 'pairresync -g G1' is in progress horctakeoff : 'pairresync -g G1 -FHORC 2' is in progress horctakeoff : horc
PAGE 101
# horctakeoff -g G1 -gs G2 horctakeoff : 'pairsplit -g G2 -S' is in progress. horctakeoff : 'pairsplit -g G1' is in progress. horctakeoff : 'pairsplit -g G1 -FHORC 2 -S' is in progress. horctakeoff : 'paircreate -g G2 -vl -nocopy -f async -jp 0 -js 1' is in progress. horctakeoff : 'pairsplit -g G2' is in progress. horctakeoff : 'pairresync -g G1' is in progress. horctakeoff : 'pairresync -g G2' is in progress. horctakeoff : horctakeoff done.
PAGE 102
More robust systems need to confirm the data consistency between the Continuous Access Synchronous Async/Continuous Access Journal PVol and SVOL. In DB operations (for example, Oracle), the commit() of DB transaction (see the following figure) is needed to confirm that a last writing for the commit() on a local site reached the remote site by using RAID Manager-unique API command.
PAGE 103
Option Description -d[g] [MU#] Searches whether the specified raw_device is included in a group on the configuration definition file (local instance). If it is in the group, the target volume is executed as the paired logical volume (-d) or group (-dg). This option is effective without specification of -g option. If the specified raw_device is contained in two or more groups, the command is executed for the first group.
PAGE 104
Returned values The pairsyncwait command sets the following returned values during exit allowing you to check the execution results. Condition Returned Value When the -nowait option is specified • Normal termination: 0: The status is NOWAIT. When the -nowait option is not specified • Normal termination: • Abnormal termination: other than 0 to 127, refer to the error code for error details. 0: The status is DONE (completion of synchronization). 1: The status is TIMEOUT (timeout).
PAGE 105
QM-Cnt: The number of remaining Q-Markers within CT group of the Unit. Continuous Access Synchronous Async/Continuous Access Journal sends a token called 'dummy recordset' at regular intervals, therefore QM-Cnt always shows '2' or '3' even if Host has NO writing. Arithmetic expression for determining the remaining data in a CT group: Remaining data in CT group = Sidefile capacity * Sidefile percentage / 100 Sidefile percentage is the rate showed to '%' column with 'PAIR' state by Pairdisplay command.
PAGE 106
3 Subcommands This chapter provides the specifications for the RAID Manager subcommands. Windows subcommands The RAID Manager provides the following subcommand for allowing the operation of the HORC and HORCM on WindowsNT/2000/2003/2008/2012 in the same way as on UNIX. When you specify a subcommand as the only option of a command, you do not need to start HORCM. If another option of the command and the subcommand are specified on the same command line, it places the other option after the subcommand.
PAGE 107
drivescan The drivescan subcommand displays the relationship between the disk numbers assigned by the Windows system and the LDEVs on the RAID storage system, and also displays attribute and status information for each LDEV. Syntax -x drivescan drive#(0-N) Argument drive#(0-N): Specifies the range of data drive numbers on the Windows system. Example The following shows an example of the drivescan subcommand used as an option of the raidscan command and its output.
PAGE 108
portscan The portscan subcommand displays the devices on the specified port(s). Syntax -x portscan port#(0-N) Argument port#(0-N): Specifies the range of port numbers on the Windows system. Example The following shows an example of the portscan subcommand used as an option of the raidscan command and its output. This example displays the devices for the range of ports from 0 to 20. raidscan -x portscan port0,20 PORT[ 0] IID [ 7] SCSI Devices PhId[ 0] TId[ 3] Lun[ 0] [MATSHIT] [CD-ROM CR-508]...
PAGE 109
Argument Description pairsplit -x sync D: [SYNC] D: HarddiskVolume2 [SYNC] D:\hd1 HarddiskVolume8 [SYNC] D:\hd2 HarddiskVolume9 [\directory or \Directory pattern] is used to find the directory mount point on the logical drive. If the directory is specified, then SYNC does execute to a directory mounted volume only. pairsplit -x sync D:\hd1 [SYNC] D:\hd1 HarddiskVolume8 If the directory pattern is specified, then SYNC does execute to any directory mounted volumes identified to '\directory pattern'.
PAGE 110
pairsplit -x sync C: WARNING: Only flushed to [\\.\C:] drive due to be opening [SYNC] C: HarddiskVolume3 Note: Syncd has the following behavior as well: • If the logical drives designated as the objects of the sync command are not opened to any applications, then syncd flushes the system buffer to a drive and waits (30 sec) the delayed (paging) IO for dismount after made the dismount state about the drive.
PAGE 111
CAUTION: The partition on the specified data drive must be recognized on the Windows system. [\directory] for the mount must be specified a mount point without embedded space character. If [\directory] is detected as mount point with embedded space (that is, aaa bbb), then the directory is shown by adding '…' to first strings as below. pairsplit -x mount Drive FS_name VOL_name Device Partition ... Port PathID Targ Lun D: NTFS Null Harddiskvolume3 ... Harddisk2 D:\aaa… NTFS Null Harddiskvolume4 ...
PAGE 112
umount, umountd The umount subcommand unmounts the specified logical drive and deletes the drive letter. Before deleting the drive letter, this subcommand executes sync internally for the specified logical drive and flushes unwritten data. The umountd subcommand unmounts the logical drive after waiting the delayed IO for dismount.
PAGE 113
The logical and physical drives designated as the objects of the umount command are not opened to any applications. For example, confirm that Explore is not pointed on the target drive. If it is, then the target drive is opening. Umount command does not ignore the detected error on the NT file system, so that umount is successful in a normal case (NO ERROR case) only on NT file system. For example, confirm the target drive has no failure on the system for Event Viewer.
PAGE 114
4 Command tools This chapter provides the specifications for the RAID Manager command tools. inqraid The inqraid command is a RAID Manager command tool used to confirm the drive connection between the storage system and host system. The inqraid command displays the relation between special file(s) on the host system and actual physical drive of the RAID storage system.
PAGE 115
Option Description -CLI Specifies the display of structured column output for command line interface (CLI) parsing. Also used for '-find' option. The delimiters between columns can be spaces and/or dashes (-). -CLIWP, -CLIWN Displays the WWN (world wide name for host adapter) with command line interface (CLI) format, also used for '-find' option. -sort[CM] Sorts the target devices by Serial#,LDEV# order.
PAGE 116
Option Description DEVICE_FILE PORT SERIAL LDEV CTG H/M/12 SSID R:Group PRODUCT_ID Volume{cec25efe-d3b8-11d4-aead-00c00d003b1e}\Vol3\Dsk0 CL2-D 62496 256 - OPEN-3-CVS-CM -fp or -fl or -pin - - - If the target device file is set as a protection volume or PIN track volume is occurred by dual failure of the RAID, the device file name is shown by appending '*'. It is valid when specified with "-CLI" option. If the -fp option is specified, the data protection volume is a Database Validator volume.
PAGE 117
Option Description c1t0d4 CL1-E 63516 12800 0 0 11 11605 OPEN-8 c1t0d5 CL1-E 63516 12801 0 0 13 11605 OPEN-8*2 c1t0d6 CL1-E 63516 13057 0 0 21 11605 OPEN-L c2t0d6 CL2-E 63516 13057 0 0 21 11605 OPEN-L SL: Shows the SLPR number of LDEV. CL: Shows the CLPR number of LDEV. +CA/CAJ: Shows the accumulated total of differential Bitmap for the Continuous Access Synchronous or Continuous Access Journal.
PAGE 118
Option Description • WindowsNT: hdX-Y, $LETALL, $Phys, D:\DskX\pY, \DskX\pY • Windows: hdX-Y,$LETALL,$Volume,$Phys, D:\Vol(Dms,Dmt,Dmr)X\DskY, \Vol(Dms,Dmt,Dmr)X\DskY. For information about LDM volumes for Windows systems, see Remote Volume Discovery in the P9000 RAID Manager User Guide. Lines starting with '#' via STDIN are interpreted as comments.
PAGE 119
SSID = 0x0008 CTGID = 3 /dev/rdisk/dsk11c -> [SQ] CL2-D Ser = 30053 LDEV = 14 [HITACHI ] [OPEN-3-CM ] RAID5[Group 2- 1] SSID = 0x0008 DYNIX system: # dumpconf -d | grep sd | ./inqraid sd1-> [SQ] CL2-D Ser = 30053 LDEV = 9 [HITACHI ] [OPEN-3 ] HORC = P-VOL HOMRCF[MU#0 = SMPL MU#1 = SMPL MU#2 = SMPL] RAID5[Group 2- 1] SSID = 0x0008 CTGID = 3 Sd2-> [SQ] CL2-D Ser = 30053 LDEV = 14 [HITACHI] [OPEN-3-CM] RAID5[Group 2- 1] SSID = 0x0008 IRIX system with FC_AL: # ls /dev/rdsk/*vol | .
PAGE 120
LDEV Mapping Display Formats External LUN E-LUN[Group External Group number] Thin Provisioning volume A-LUN[PoolID poolID number ] SSID: Displays Sub System ID of the LDEV in the RAID storage system. Note: SSID is the parameter for enterprise storage systems. CTGID: Displays CT group ID of Continuous Access Synchronous Async/Continuous Access Journal when the LDEV has been defined as the PVOL or SVOL of the Continuous Access Synchronous Async/Continuous Access Journal.
PAGE 121
DEVICE_FILE: Device file name. M: MU# of local and remote. Group: Group name (dev_group) defined in the configuration file. PairVol: Paired vol. name (dev_name) within the group defined in the configuration file. P/S: Volume attribute (PVOL or SVOL or simplex). Stat: Status of the paired volume. R_DEVICE: Device file name of remote site. LK: Check result of the paired volume connection path. Example 5: inqraid with -cli option (Linux shown) # ls /dev/sd* | .
PAGE 122
c23t0d0 c23t0d1 500060e802f01018 500060e802f01018 - CL2-J - CL2-J - # echo /dev/rdsk/c0t2d3 | ./inqraid -CLIWN DEVICE_FILE NWWN AL PORT LUN c0t2d3 5000E000E0005000 - CL1-A - 61456 61456 192 193 OPEN-3 OPEN-3 SERIAL LDEV PRODUCT_ID 30015 2054 OPEN3-CVS DEVICE_FILE: Displays the device file name only. WWN: CLIWP option displays Port_WWN of the host adapter included in the STD inquiry page. CLIWN option displays Node_WWN of host adapter included in STD inquiry page. AL: Always displays '-'.
PAGE 123
mkconf The mkconf command is a RAID Manager command tool used to make a configuration file from a special file (raw device file) provided via STDIN. Syntax /HORCM/usr/bin/mkconf.sh (UNIX systems) \HORCM\Tool\mkconf.exe (Windows and OpenVMS systems) mkconf.sh [ -g[g] [-m ] [-i ] [-s ] [-a] ] mkconf.exe [ -g[g] [-m ] [-i ] [-s ] [-a] [-c ] ] Options and parameters Option Description No argument No option displays Help/Usage.
PAGE 124
/dev/rdsk/c23t0d5 ORA ORA_005 CL2-J 0 5 0 61456 /dev/rdsk/c23t0d6 ORA ORA_006 CL2-J 0 6 0 61456 /dev/rdsk/c23t0d7 - 0 61456 HORCM Shutdown inst 9 !!! Please check '/tmp/test/horcm9.conf','/tmp/test/log9/curlog/ horcm_*.log', and modify 'ip_address & service'. # ls horcm9.conf # vi *.conf 257 258 259 <=Verify configuration and log files. log9 <=Verify config file, check ip address & service. # Created by mkconf.sh on Mon Jan 22 17:59:11 JST 2001 HORCM_MON #ip_address 127.0.0.
PAGE 125
• If the STDIN device does not have appropriate mirror description (MU#), the target device is excepted as a comment as shown below:# ERROR [INVALID MUN (2 < 1)] /dev/rdsk/c24t0d3 SER = 61456 LDEV = 195 [ OPEN-3 ] • If the STDIN device is mixed among the storage systems of differential mirror control, the target device is excepted as a comment as shown below:# ERROR [MIXING RAID TYPE] /dev/rdsk/c24t0d3 SER = 61456 LDEV = 195 [ OPEN-3 ] rmawk The rmawk command is a scriptable command for associating with
PAGE 126
Option Description or "@variable" with the field variables of STDIN can be included in the command line. When "@variable" is specified as "@C#/C#*", the variable is interpreted as character string. When "@variable" is specified as "@C#?/C#+/L/C/R", the variable is interpreted as integer. exe="prints…. " The printing range is from "print" to the end including spaces. Example: exe="printn PORT=@1 LDEV=@3" Note: "print..." is printing in the "@0*" string variables.
PAGE 127
Option Description -AT • When "-AT" is specified (the default setting does not specify this option) Specifies to testing or waiting until the conditions become TRUE in all the command lines, by interpreting the output of the specified command with the specified conditions. Testing ends as an ERROR (1) if there is even one FALSE in the specified condition.
PAGE 128
Option Description • @C#?x A variable that can be specified within exe="…" to print the C#? variable as hexadecimal strings by adding 0x. • @@ A variable that can be specified within exe="…" to print the @ character. operators (-operator:) Uses to specify the following comparison operation. Variables in the field are operated in 64 bit integers. The numerical values in the field strings are "1234..." or "0x1234..." format without octal code.
PAGE 129
Returned values The rmawk command sets the following returned values during exit allowing you to check the execution results. Normal termination: 0: The command ends normally with the specified condition. 1: • Testing: The specified condition is FALSE. • Waiting: The specified condition is Timeout. Abnormal termination: 125: The command ends with a syntax error. 126: The command ends with a system error. Examples For examples of display, see (page 170).
PAGE 130
Command | rmawk @1-eq:PAIR -a @2-ne:0 • Performs the operation as a testing if there is one "exe="..."" but no "@variable" in the specified option. rmawk exe="Command line" [@expression1] Logical operator [@expression2] … Example: rmawk exe="Command line" @2-eq:PAIR -o @2-eq:PSUS And performs as an waiting command if "timeout=value" is specified as an option.
PAGE 131
5 Configuration setting commands This chapter provides the specifications for the RAID Manager configuration setting (raidcom) commands. raidcom Specifies a configuration change. Executes by specifying respective parameters and values that are expressed in (page 138) and later.
PAGE 132
Option Description Precheck: When this option is specified, the actual process is not executed for the storage system even if the command is executed. This option is available to specify the setting of $HORCC_NO_EXEC environment variable and $HORCC_CTX_CHK environment variable. [ -store ] Specifies the file name of the configuration file to be created for implementation check. [-nomsg] Prevents displaying messages.
PAGE 133
Method for specifying LDEVs by device group When you configure multiple LDEVs for pools or journals (for example, changing the resource group), you must issue the command to each LDEV. However, if you define LDEVs that configure pools or journals, you can issue the command to all LDEVs defined as a device group by specifying each device group at a time. If you issue the command to LDEVs by specifying a device group, the command is executed in each LDEV registered in the device group.
PAGE 134
# raidcom add device_grp -device_grp_name DevG2 dev101 -ldev_id 101 -cnt 5 (e) Deleting a device group # raidcom delete device_grp -device_grp_name DevG3 -ldev_id 200 201 204 # raidcom delete device_grp -device_grp_name DevG3 -ldev_id 200-204 # raidcom delete device_grp -device_grp_name DevG3 -ldev_id 200 -cnt 5 Resource group operation When you have multiple resource group authorities, use the -resource option to see the resource group information.
PAGE 135
Examples • Performing a user authentication by User ID: USER01, Password: PASS01. # raidcom -login USER01 PASS01 • Locking a resource group: rsg001. # raidcom lock resource -resource_name rsg001 • Creating LDEV#100 and #101.
PAGE 136
Res.
PAGE 137
Res.
PAGE 138
Res. group Port Host group Parity group External LDEV volume/VDEV Lock/auth - - Lock/auth - Lock/auth - - - Lock/auth Command Option - raidcom delete resource -parity_grp_id - raidcom delete resource -external_ grp_id Setting range of command parameter The effective range of parameters in the following table differs by the storage system type. Even if the command of RAID Manager is accepted, the error may occur in the storage system.
PAGE 139
raidcom delete copy_grp Deletes the specified copy group. Syntax raidcom delete copy_grp -copy_grp_name Options and parameters Option Description -copy_grp_name Example Deleting the copy group: ora. # raidcom delete copy_grp -copy_grp_name ora raidcom get copy_grp Displays the information of the specified copy group. Syntax raidcom get copy_grp Options and parameters None.
PAGE 140
Options and parameters Option Description device_grp_name Specifies the device group name (maximum 32 characters) and the device name in the device group (maximum 32 characters). If multiple LDEVs are specified, the same device name is set for all of them. -ldev_id … Specifies the LDEV number (0-65279). When you specify an LDEV that is part of a LUSE volume, all LDEVs in the LUSE volume will have the same name.
PAGE 141
raidcom get device_grp Displays the LDEV information for the specified device group, or lists all device groups. Syntax raidcom get device_grp [-device_grp_name ] Options and parameters Option Description [ -device_grp_name ] Displays the device (LDEV) information for the specified device group (maximum 32 characters). If this option is omitted, the list of the registered device groups is displayed. Examples Displaying device group information.
PAGE 142
Options and parameters Option Description -path_grp Specifies the external VOL path group number (0-63231). -external_grp_id Specifies the external volume group number (gno:1-16384, sgno:1-4096). For example: -port Specifies the port number. Specifies the port number whose attribute is External. For example: • 52-11 • CL1-A Displays an external port. -external_wwn Specifies the WWN value (hexadecimal value) of the external storage system in 8 bytes.
PAGE 143
If no LDEV exists in the external volume, the command is rejected with EX_ENOOBJ. Syntax raidcom check_ext_storage external_grp {-external_grp_id | -ldev_id } | -grp_opt -device_grp_name []} Options and parameters Option Description -external_grp_id Specifies the external volume group number (gno:1-16384, sgno:1-4096). For example: -ldev_id Specifies the LDEV number (0-65279).
PAGE 144
Example Deleting the external volume group #1-1. # raidcom delete ext_grp -ext_grp 01-01 raidcom disconnect external_grp Disconnects the connection to the external volumes. Only one external VOL is operated in each operation. You can specify an LDEV defined for the external volume group or a device group to which the LDEV in the external volume group belongs instead of the external volume group.
PAGE 145
Syntax raidcom get external_grp [-external_grp_id ] Options and parameters Option Description [-external_grp_id ] Specifies the external volume group number (gno:1-16384, sgno:1-4096). If this option is omitted, the list of the registered external volumes is displayed. If this option is specified. the LDEV information defined for the specified external volume group is displayed.
PAGE 146
- DEL: an LDEV is being deleted. LOC_LBA: starting point of LBA for this partition on this External Volume Group, in units of 512 bytes. SIZE_LBA: partition size of this External Volume Group, in units of 512 bytes. Serial#: Product serial number. raidcom modify external_grp Changes the attribute of external volume options (cache mode, cache inflow control mode, and MP blade ID setting).
PAGE 147
Syntax raidcom discover external_storage -port Options and parameters Option Description -port Specifies the port number. Specifies the port number where the attribute is "ELUN(External)". For example: • CL1-A Displays an external port. Example Displaying the external storage system ports from the port: CL1-A.
PAGE 148
Options and parameters Option Description -port Specifies the port number and the host group ID. For example: CL1-A-g (g is from 0 to 254) -host_grp_name Specifies the HOST group name. Up to 64 characters can be set by RAID Manager. If more than 64 characters are set, commands that specify host group name by RAID Manager cannot be executed. Examples Creating a host group ID: 3, the host group name: a host group of Win_export, to the port: CL4-E.
PAGE 149
Options and parameters Option Description -port [] Specifies the port number, host group ID, and host group name. If the host group name is more than 64 characters, use the host group ID. For example: • CLI-A • CL1-A-g (g is from 0 to 254) • CL1-A Linux_X86 If you specified the above settings, the information about all host groups that are defined on the specified port is displayed regardless of the examples.
PAGE 150
To set a host mode option, specify the "-host_mode_opt" option. To reset a host mode option, specify the "-host_mode_opt 100" . If the specified host group does not exist, the command is ignored. Syntax raidcom modify host_grp -port [] -host_mode < host mode> [-host_mode_opt … ] Options and parameters Option Description -port [
PAGE 151
Clearing the host mode options of the host mode: HP-XP of the port: CL4-E, the host group: #2. # raidcom modify host_grp -port CL4-E-2 -host_mode HP-XP -host_mode_opt 100 raidcom add hba_wwn Registers the WWN of the host adapter to the host group on the specified port. If the specified WWN already exists, this command is ignored.
PAGE 152
Example Deleting the WWN of host adapter: 210000e0,8b039800 set for the port: CL4-E, the host group #0. # raidcom delete hba_wwn -port CL4-E-0 -hba_wwn 210000e0,8b039800 raidcom get hba_wwn Displays the WWN of the HBA registered to the host group. Syntax raidcom get hba_wwn -port [] Options and parameters Option Description -port [] Specifies s a port number, a host group ID, and a host group name.
PAGE 153
Syntax raidcom add journal -journal_id {-ldev_id … [-cnt ] | -grp_opt -device_grp_name []} [-mp_blade_id | -timer_type ] Options and parameters Option Description -journal_id Specifies the journal number (0-255). -ldev_id … Specifies the LDEV number (0-65279). Up to 64 LDEVs can be specified at a time.
PAGE 154
raidcom delete journal Deletes a journal from the specified journal. A device group can also be specified instead of an LDEV. If the LDEV and device group are not specified, journal is deleted. This command is executed asynchronously with the command input. Check the completion of this process on the raidcom get command_status command.
PAGE 155
Options and parameters Option Description [-key ] Specifies the display keyword. Specify opt as . Examples Displaying journal information.
PAGE 156
Num: Number of LDEVs configuring the journal volume. LDEV#: LDEV number. DOW: Data Overflow Watch timer setting (in seconds) per the Journal. PBW: Path Blockade Watch timer setting (in seconds) per the Journal. If the setting is more than 3600 seconds, it displays 6000 seconds. APW: Active Path Watch timer setting (in seconds) to detect any link failures. TYPE: Open or M/F system. TTYPE: Timer type for mainframe: System or Local.
PAGE 157
Options and parameters Option Description -journal_id Specifies the journal number (0-255). -data_overflow_watch The data overflow watch timer (0-600) (second). Specifies the watch time for the journal data area being full. If 0 is specified, the setting of the data overflow watch timer is changed and the inflow control for journals is set to disabled. -path_blocked_watch The watch for the path blockage (1-60) (minute).
PAGE 158
raidcom add ldev Adds an LDEV to the specified parity group or the external volume group. Or this adds V-VOL for Thin Provisioning, Thin Provisioning Z, Smart Tiers, Smart Tiers Z, Fast Snap, or Snapshot to the specified pool. This command is executed asynchronously with the command input. Check the completion of this process on the raidcom get command_status command.
PAGE 159
Option Description In case of volumes other than OPEN-V, more free space than the capacity that was actually specified is required. For details, see the HP XP P9000 Provisioning for Open Systems User Guide or Provisioning Guide. When you specify "all" instead of digits to create an OPEN-V LDEV and no LDEV has been created in the specified parity group* or the external volume group, the system allocates all empty space for the LDEV.
PAGE 160
Creating an LDEV with the following conditions: Parity group: 33-17, location of the parity group: automatic allocation, Emulation type: 3390-3, Size: 10M cylinder (Cylinder specification), LDEV: 120. # raidcom add ldev -parity_grp_id 33-17 -ldev_id 120 -cylinder 10m -emulation 3390-3 Creating an LDEV of position in the external volume: allocated automatically, emulation type: OPEN-V, External volume: 01-02, Capacity: 200MB, and LDEV number: 200.
PAGE 161
If the specified LDEV is not a V-VOL of Thin Provisioning, Thin Provisioning Z, or Smart Tiers, or Smart Tiers Z, the command is rejected with EX_ENOOBJ. A device group can also be specified instead of an LDEV. Syntax raidcom extend ldev {-ldev_id | -grp_opt -device_grp_name []} -capacity | -offset_capacity | -cylinder Options and parameters Option Description -ldev_id (0-65279) Specifies the LDEV number (0-65279).
PAGE 162
name> [] | -ldev_list } [-key ][{-check_status | -check_status_not} [-time ]] Options and parameters Option Description -ldev_id … Specifies the LDEV number (0-65279). For example: • -ldev_id 200 • -ldev_id 100-110 • -ldev_id 100 -cnt 10 [-cnt ] Specifies the count (2-65280). If this option is omitted, the count is set to one.
PAGE 163
Option Description [-check_status [-time Check if the LDEV is in the state as shown in . ]] The following strings are specified in the .
PAGE 164
Option Description The following strings are specified in the .
PAGE 165
Examples Internal volume examples Displaying the information of the LDEV number 577 (internal VOL) # raidcom get ldev -ldev_id 577 Serial# : 63502 LDEV : 577 SL : 0 CL : 0 VOL_TYPE : OPEN-V-CVS VOL_Capacity(BLK) : 2181120 NUM_LDEV : 1 LDEVs : 577 NUM_PORT : 2 PORTs : CL2-E-0 1 Linux_X86 : CL2-E-1 1 Solaris F_POOLID : NONE VOL_ATTR : CVS RAID_LEVEL : RAID1 RAID_TYPE : 2D+2D NUM_GROUP : 1 RAID_GROUPs : 02-01 DRIVE_TYPE : DKS2C-K072FC DRIVE_Capa : 141822798 LDEV_NAMING : Oracle_data_1 STS : NML OPE_TYPE : QFMT
PAGE 166
VOL_ATTR: attributes of the LDEV.
PAGE 167
• OPE_TYPE: current operation. ◦ FMT: Formatting ◦ QFMT: Quick formatting ◦ CCOPY: Copying the collections ◦ CACCS: Accessing to collections ◦ NONE: Not in operation ◦ SHRD: Shredding ◦ ZPD: Page Discarding ◦ SHRPL: Deleting from the pool ◦ RLC: Pool relocating ◦ RBL: Pool rebalancing • OPE_RATE: progress of the format or shred operation. When the status is other than formatting or shredding, 100 is displayed. If the process ended abnormally, "BSY" is displayed on the "STS".
PAGE 168
External volume examples Displaying the information of the LDEV number 160 (external VOL) # raidcom get ldev -ldev_id 160 Serial# : 63502 LDEV : 160 SL : 0 CL : 0 VOL_TYPE : OPEN-V VOL_Capacity(BLK) : 4385280 NUM_PORT : 0 PORTs : F_POOLID : NONE VOL_ATTR : ELUN E_VendorID : HITACHI E_ProductID : OPEN-V E_VOLID : 484954414348492052353030463830453030364100000000000000000000000000 000000 E_VOLID_C : HITACHI R500F80E006A................
PAGE 169
SSID : 103F QRDID : 16 Description of a column in output example QRDID: The ID of the Quorum Disk for ESAM.
PAGE 170
TIER_Relocation: Status of the relocation setting: • Enable: The status where the relocation is enabled • Disable: The status where the relocation is disabled TIER_LEVEL: Shows the level of tiering policy that is used for reallocation. • all: Shows that all tiers of the pool to which the relevant LDEV is allocated are being used. • 1-5: Shows the Tiering Policy level that is configured to the relevant LDEV.
PAGE 171
64558 2100 64558 546 29442 0 0 0 0 29443 0 0 0 0 OPEN-V-CVS 10924032 73 CVS|HDP|HDT 1092 4032 E 13 1596 1638 OPEN-V-CVS 10924032 73 CVS|HDP|HDT 1092 4032 E 18 1134 3654 Total = T#1(MB):8064 T#2(MB):5292 T#3(MB):4620 raidcom initialize ldev Formats LDEVs. You can specify Quick Format, Normal Format, or Shredding. A device group can also be specified instead of an LDEV. This command is executed asynchronously with the command input.
PAGE 172
Examples Performing Quick Format for an LDEV: 200. # raidcom initialize ldev -operation qfmt -ldev_id 200 Performing Quick Format for an LDEV belonging to the device group: grp1. # raidcom initialize ldev -operation qfmt -grp_opt ldev -device_grp_name grp1 Performing Normal Format for an LDEV: 200. # raidcom initialize ldev -operation fmt -ldev_id 200 Performing Shredding (Pattern: 0x55aa55aa) for an LDEV: 200.
PAGE 173
Option Description disable_reallocation| disable_relocation : Relocation of LDEV (V-VOL for Smart Tiers/Smart Tiers Z) disabled discard_zero_page: Discarding 0 page of LDEV(V-VOL) for Thin Provisioning, Thin Provisioning Z, or Smart Tiers, and /Smart Tiers Z. enable_relocation_policy : Enables the LDEV relocation for Smart Tiers and sets the level or customized policy of the Tier to be used for the relocation by Policy ID. : • all: Uses all tiers in the pool.
PAGE 174
Option Description • 6: Security: ON, User authentication: ON, Group information acquisition: OFF • 7: Security: ON, User authentication: ON, Group information acquisition: ON Examples Restoring the LDEV: 200. # raidcom modify ldev -status nml -ldev_id 200 Blocking the LDEV: 200.
PAGE 175
Not allowed: • Mapping the same LDEV to another LUN in the same host group. • Overwriting the same LUN to another LDEV. CAUTION: • LDEVs in LUSE volumes cannot be configured with this command. • If you execute this command on an LDEV with the command device attribute already set and the LDEV already has a defined/configured paths, the command device attribute will be released.
PAGE 176
If an LDEV does not exist on the specified port /host group/LUN, this command is rejected with EX_ENLDEV or EX_ENOOBJ. When deleting the LU path, stop the I/O for the LU path to be deleted. In the last one path, LDEV must be specified as SMPL volume. Note: LDEVs in LUSE volumes cannot be configured with this command. Do not execute this command to the LDEV whose command device attribute is set. If the command is executed, the command device attribute is released.
PAGE 177
Options and parameters Option Description -port Specifies the Port number. It specifies a with an attribute of External. For example: • CL1-A -external_wwn Specifies the WWN (hexadecimal value) of the external storage system in 8 bytes. The value can be split in units of 4 bytes by "," (commas). For example: • 21000e08b0256f8 • 21000e0,8b0256f8 Examples Displaying LUs defined to the external storage system port: 50060e80, 06fc3850 connected to the port: CL5-A (External port).
PAGE 178
Option Description For example, • CLI-A • CL1-A-g (g: 0-254) • CL1-A Linux_X86 -key ] Specifies opt as to display the status of the host-reserved LUN. Examples Displaying the LU information defined to the port CL4-E, the host group #0.
PAGE 179
raidcom add path Adds and changes an external path to an external volume. Only one path is operated in one operation. The order of priority for the oath is allocated in accordance with the order of adding paths. This command is executed asynchronously with the command input. Check the completion of this process on the raidcom get command_status command.
PAGE 180
Options and parameters Option Description -path_grp Specifies the external VOL (0-63231) path group number. -port Specifies the port number. Specifies the number of the port whose attribute is ELUN (External). For example: • CL1-A -external_wwn Specifies the WWN (hexadecimal value) of the external storage system in 8 bytes. The value can be split in units of 4 bytes by "," (commas).
PAGE 181
raidcom disconnect path Blocks the usage of external paths to external VOLs. Only one path is operated in one operation. This command is executed asynchronously with the command input. Check the completion of this process on the raidcom get command_status command. Syntax raidcom disconnect path -path_grp -port -external_wwn Options and parameters Option Description -path_grp Specifies the external VOL path group number (0-63231).
PAGE 182
1 1-1 NML E D 2 CL1-A 50060e8005fa0f36 1 3 NML 60010 VSP 1 1-1 NML E D 2 CL2-A 50060e8005fa0f38 2 3 NML 60010 VSP N N Description of each column in output example: PHG: Displays the path group number for the external volume. GROUP: Displays the external volume group number. STS: Displays the following status of the external volume. • NML: "Normal" • CHK: "Checking" • SYN: "Cache Destage" • DSC: "Disconnect" in the external path for the external volume.
PAGE 183
When LDEVs or device groups are specified, LDEVs are deleted from the specified pools. This command is executed asynchronously with the command input. Check the completion of this process on the raidcom get command_status command.
PAGE 184
002 POLF 95 9900 100000 1000000000 62500 3 370 70 003 POLS 100 10000 100 1000000000 62500 1 375 70 004 POLE 0 0 0 0 62500 0 0 80 Displaying pool name.
PAGE 185
| -subscription <%> | -pool_attribute | -monitor_mode } Options and parameters Option Description -pool { | } Specifies the Pool ID (0-127) or pool name for Snapshot/Thin Provisioning/Thin Provisioning Z/Smart Tiers/Smart Tiers Z. When only a number is specified, it is recognized as a pool ID. Therefore, to specify a pool whose name is a number, use the pool ID instead of the pool name. -status Specifies the status of the pool.
PAGE 186
# raidcom modify pool -pool 6 -status nml Restoring the status of a pool name: my_ss_pool. # raidcom modify pool -pool my_ss_pool -status nml Changing the user-defined thresholds of the pool ID:6 of the pool for Thin Provisioning, Thin Provisioning Z, and Smart Tiers, and Smart Tiers Z, WARNING to 70% and High water mark to 80%. # raidcom modify pool -pool 6 -user_threshold 70 80 Changing the user-defined threshold of the pool ID: 6 of the pool for Fast Snap or Snapshot to 80%.
PAGE 187
# raidcom rename pool -pool_id 1 -pool_name my_pool raidcom get port Displays Port information. This queries the setting informations on all port. Syntax raidcom get port [-port [-key opt]] Options and parameters Option Description [-port ] Specifies the Port number. If the port number is specified for the port which is enabled LUN security, it displays LOGIN WWN.
PAGE 188
Serial#: Product serial number. WWN: Displays the external WWN. PHY_PORT: Displays the port number of the physical port in a resource ID takeover configuration. Displaying the information of the port CL4-E. # raidcom get port -port CL4-E PORT LOGIN_WWN Serial# CL4-E 210000e08b0256f8 63528 OLA_NODE0_CTL_0 CL4-E 210000e08b039c15 63528 OLA_NODE1_CTL_0 Description of each column in output example PORT: Displays the port numbers. LOGIN_WWN: Displays WWN of the host adapter login to this port.
PAGE 189
Options and parameters Option Description -port Specifies the port number. For example: • CL1-A [-port_speed ] Specifies the HOST speed (0, 1, 2, 4, 8, 10) as follows. 0: AUTO 1: 1G 2: 2G 4: 4G 8: 8G 10: 10G [-loop_id ] Specifies the Loop ID (0x01-0xEF) of the Port.
PAGE 190
Option Description If this option is specified, the LDEV and free space information defined in the specified parity group is displayed. For example: • 3-1 Examples Displaying parity group information. # T R R raidcom get parity_grp GROUP Num_LDEV U(%) AV_CAP(GB) R_LVL R_TYPE SL CL DRIVE_TYPE 5-2 4 45 140000 RAID1 2D+2D 0 0 DKS2C-K072FC 5-3 4 45 140000 RAID1 2D+2D 0 0 DKS2C-K072FC Description of each column in output example T: Displays the type of the volume group.
PAGE 191
raidcom add rcu Registers RCUs. This command is executed asynchronously with the command input. Check the completion of this process on the raidcom get command_status command. Syntax raidcom add rcu {-rcu -ssid | -cu_free -mcu_port -rcu_port Options and parameters Option Description -rcu Specifies the CU by serial number, , , and .
PAGE 192
Options and parameters Option Description -rcu Specifies the CU by serial number, , and . You can use hexadecimal numbers (add "0x" prefix) or decimal numbers for and . -ssid Specifies the subsystem ID. You can use hexadecimal numbers (add "0x" prefix) or decimal numbers for . -cu_free Specifies the CU free by serial#, id#, pid# for setting the RCU to be deleted.
PAGE 193
# raidcom get rcu Serial# ID PID MCU RCU 64034 R7 - 1C 23 RCU 64034 R7 - 1C 23 RCU 64034 R7 1 - - MCU E M/R T F NML F NML NML 4 STS 4 8 4 8 8 - MP NP IM FZ RTO(s) RTT(ms) MR D 15 20 RO E 15 20 - 15 20 Description of each column in output example Serial#: Product serial number. ID: Displays the ID for identifying RAID type: R7 = P9500, R6 = XP24000/XP20000 Disk Array, R5 = XP12000 Disk Array/XP10000 Disk Array PID: Displays a path group ID. If CU is specified for RCU, "-" is displayed.
PAGE 194
-MCU: Displays the CU number (hexadecimal) as MCU. If CU free is specified for RCU, "-" is displayed. -RCU: Displays the CU number (hexadecimal) as RCU. If CU free is specified for RCU, "-" is displayed. -M/R: Displays the CU type as MCU/RCU. -T: Displays the type of physical path: F: FIBRE, E:ESCON. -PNO: Displays the path number. -MPORT: Displays the MCU port number. -RPORT: Displays the RCU port number.
PAGE 195
Option Description < pid> specifies the path group ID (1-255). Note: The RCU is displayed by default on the GUI of Continuous Access Synchronous, Continuous Access Journal, or Continuous Access Journal Z when "0" is specified for . -rcu_option [fzd | fze] Specifies CU control parameters: • : minimum number of paths (1-8) • : RIO timeout value (10-100) (second) for RIO (Remote IO) setting between MCU and RCU.
PAGE 196
Option Description -mcu_port Specifies the port number on the MCU. -rcu_port Specifies the port number on the RCU (storage system port on the remote side). Specify the port that the attribute is MCU initiator port (MCU) or RCU target port (RCU). Examples To the RCU for which the product number: 64034, the RAID type: R700 and the path ID: 1 are set, adding RCU path: mcu port: CL1-A, rcu port CL1-B.
PAGE 197
raidcom add ssid Adds the specified SSID to the RCU that is specified by serial number, , and . Syntax raidcom add ssid -rcu -ssid Options and parameters Option Description -rcu Specifies the CU by serial number, , , and . You can use hexadecimal (add the prefix 0x) or decimal for the and numbers . Use the following strings for to specify the RAID storage system type: • For P9500, use "R700".
PAGE 198
Options and parameters None. Examples Displaying a resource group and resource group lock information. # raidcom get resource RS_GROUP RGID stat Lock_owner meta_resource 0 Unlocked - Lock_host - Serial# 64556 Description of each column in output example. RS_GROUP: Resource group name. RGID: resource group ID. RGID=0 is used for meta resource group. stat: locking status of the resource group name on P9500. Lock_owner: owner (authorized user) who locks the resource group name.
PAGE 199
Option Description If this parameter is not specified, all resource groups that are assigned to the user are locked. [-time ] This parameter is used for specifying the latency until the specified resource is locked. The TOV time of the lock instruction is specified. When is specified as "0", it is executed as "nowait (no waiting time)" mode. If this parameter is not specified, the default waiting time (7200 seconds) is used.
PAGE 200
Syntax raidcom add snap_pool {{-pool_id [-pool_name ] | -pool_name [-pool_id ]} | -pool_id -pool_name }} {-ldev_id …[-cnt] | -grp_opt -device_grp_name []} [-user_threshold <%> ][-thinsnap] Options and parameters Option Description -pool_id Specifies the Pool ID (0-127) of a Fast Snap or Snapshot pool.
PAGE 201
Examples Using LDEVs:400, 401, and 402, creating a pool of Pool ID:1, Pool Name: my_ss_pool for Snapshot. # raidcom add snap_pool -pool_id 1 -pool_name my_ss_pool -ldev_id 400 401 402 Using LDEVs:410, 411, and 412, creating a pool of Pool ID:3, Pool Name: my_ss_pool for Fast Snap. # raidcom add snap_pool -pool_id 3 -pool_name my_ss_pool -ldev_id 410 411 412 -thinsnap Using LDEVs:500, 501, and 502, creating a pool of Pool ID: Allocated automatically, Pool Name: my_ss_pool for Snapshot.
PAGE 202
H(%): threshold value for the pool raidcom add thp_pool Create a pool for Thin Provisioning or Thin Provisioning Z by the specified LDEVs. Or, add pool volumes to the pools for Thin Provisioning, Thin Provisioning Z, and Smart Tiers, and Smart Tiers Z. A device group can also be specified instead of an LDEV. When specifying a pool that is already created for Thin Provisioning/Thin Provisioning Z/Smart Tiers/Smart Tiers Z, the specified LDEV is added as a pool volume.
PAGE 203
Option Description -grp_opt Specifies the device information extracted from the LDEV belonging to the device group.Specify "ldev" (fixed). The information of LDEV belonging to the device group is used. -device_grp_name [] characters) within the device group.
PAGE 204
Options and parameters Option Description [-key [-fx] Specifies the display keyword. Specify opt as . If you specify opt, information about Smart Tiers and Smart Tiers Z pool is displayed. If you specify the -fx option, TL_RANGE and TD_RANGE are displayed in hexadecimal notation. [-pool { | } ] Specifies the pool ID or the pool name of Smart Tiers/Smart Tiers Z when you want to display the range for each tiering level of Smart Tiers/Smart Tiers Z pools.
PAGE 205
001 80 001 80 002 80 POLN 54 POLN 54 POLF 54 DEF 98 DEF 98 AUT 100 STP VAL 2 30 CM STP VAL 3 40 PM MON PND 1 2 PM 00003000 00002000 400000 1000000 00002000 00002000 600000 1000000 500000 1000000 - - When you specify -pool, displays the range for each tiering level of corresponding pools.
PAGE 206
Tier range number TL_RANGE: Lowest limit value of the Tier in IOPH. 0 (0x00000000) to 4294967294 (0xFFFFFFFE): When "all" is set to the level of tiering policy, the lowest limit value of the tier is displayed. When there is no V-VOL where "all" is set to the level of tiering policy, or when there is no V-VOL related to the pool, the invalid value "-" (0xFFFFFFFF) is displayed. If the -fix option is specified, this displays the value in parentheses given in hexadecimal.
PAGE 207
Options and parameters Option Description -port [] Specifies the port number. For example: • CL1-A-g (g: 0-254) • CL1-A Linux_X86 -hba_wwn Specifies WWN values (hexadecimal value). For example: • 21000e08b0256f8 • 21000e0,8b0256f8 (The value can be split in units of 4 bytes by "," (commas). -wwn_nickname port.
PAGE 208
Syntax raidcom monitor pool -pool { | } -operation Options and parameters Option Description -pool { | } Specifies the pool ID (0-127) or pool name of a pool for Smart Tiers or Smart Tiers Z. -operation Instructs the operation of performance monitoring. When specifying just a number, it is recognized as a pool ID.
PAGE 209
Starting the tier relocation of a pool for Smart Tiers/Smart Tiers Z with Pool Name: my_tier_pool. # raidcom reallocate pool -pool my_tier_pool -operation start Stopping the relocation of a pool for Smart Tiers/Smart Tiers Z with Pool: 20. # raidcom reallocate pool -pool 20 -operation stop Stopping the relocation of a pool for Smart Tiers/Smart Tiers Z with Pool Name: my_tier_pool.
PAGE 210
EX_EWSTOT : Timeout while waiting the result of the command execution raidcom reset command_status Resets the error information of the configuration setting command that is stored in the storage system and executed asynchronously (Asynchronous command). Syntax raidcom reset command_status Options and parameters None Examples Resetting the error information of the asynchronous command. # raidcom reset command_status raidcom add resource Creating resource groups.
PAGE 211
Option Description -external_grp_id Specifies the external volume group number (gno:1-16384, sgno:1-4096) (for example, 52-11, "E" is not required). -grp_opt Specifies the device information extracted from the LDEV in the device group. Specify "ldev" (fixed). The information about the LDEV in the device group is used. -device_grp_name [] Specifies the name of the device group (maximum 32 characters).
PAGE 212
Options and parameters Option Description -resource_name Specifies the resource group name. Up to 32 characters can be specified. -ldev_id Specifies the LDEV number (0-65279). For example: • -ldev_id 200 -port [] Specifies the port number, host group ID, and host group name. If the host group name is more than 64 characters, use the host group ID instead of the host group name.
PAGE 213
Option Description : Specifies SSB1 of the error code. : Specifies SSB2 of the error code. Example Displaying the error message for the error code whose SSB1 is 0x2E00 and SSB2 is 0x0023. # raidcom get error_message -ssb 0x2E00 0x0023 CAUSE : Volume capacity is too small. raidcom get clpr Displays the CLPR information for the storage system.
PAGE 214
Option Description For example: • -ldev_id 200 You cannot specify the LDEV that configures a LUSE by using this command. For other notes, see the HP XP P9000 Performance for Open and Mainframe Systems User Guide. -parity_grp_id Specifies a parity group number (gno: 1-32, sgno: 1-16). For example: • 3-1 -external_grp_id Specifies an external volume group number (gno: 1-16384, sgno: 1-4096). For example: • 52-11 Examples Moving the LDEV 02:00 to the CLPR number 2.
PAGE 215
Examples Adding a combination of the P-VOL (LDEV number 10:10), the S-VOL (LDEV number 20:20), and the Pool (SnapPool00) to the snapshot group (db1). # raidcom add snapshot -ldev_id 0x1010 0x2020 -pool SnapPool00 -snapshotgroup db1 raidcom delete snapshot Deletes the snapshot data and the snapshot group. The relevant snapshot data of the LDEV is deleted from the snapshot group by specifying LDEV number. When no snapshot data left in the snapshot group, the snapshot group is deleted.
PAGE 216
Options and parameters Option Description -ldev_id Specifies the LDEV number of P-VOL (or S-VOL) to be performed. -snapshotgroup Specifies the snapshot group name in which the snapshot data is included. -mirror_id Specifies the mirror ID of a snapshot data. -snapshot_data Specifies the operation to be performed for the specified snapshot group. The parameter of the operation to be specified is the following: • create: Creates a snapshot data.
PAGE 217
# raidcom modify snapshot -ldev_id 0x1010 –mirror_id 10 -snapshot_data create Creating a snapshot data for the S-VOL (LDEV number 20:10). # raidcom modify snapshot -ldev_id 0x2010 -snapshot_data create Creating a snapshot data for all the P-VOLs that are included in the snapshot group (db1). # raidcom modify snapshot -snapshotgroup db1 -snapshot_data create Discarding the snapshot data for the P-VOL (LDEV number 10:10) and the mirror ID 10.
PAGE 218
Option Description If the snapshot group or the snapshot data is not in the specified state, the operation ends normally. When it is in the specified status, the operation is placed in wait status for the time (seconds) set by the if "-time" is specified. If "-time" is not specified, the operation soon ends abnormally. Examples Displaying the list of snapshot groups.
PAGE 219
raidcom add pfc_wwn Specifies the Performance Control name for preferred/non-preferred WWNs. Syntax raidcom add pfc_wwn -port -pfc_name -hba_wwn Options and parameters Option Description -port Specifies the port number with the Target attribute, for example: • CL1-A -pfc_name Specifies the PFC name. Up to 64 characters can be specified by CLI. PFC names are managed uniquely in the entire system.
PAGE 220
raidcom delete pfc_wwn Deletes WWN from the Performance Control targets. Syntax raidcom delete pfc_wwn -port [-hba_wwn | -pfc_name ] Options and parameters Option Description -port Specifies the port number whose attribute is Target. For example: • CL1-A -hba_wwn Specifies WWN which will be deleted. -pfc_name Specifies the PFC name to be deleted. WWN is specified in hexadecimal number of 16 digits.
PAGE 221
Syntax raidcom modify pfc_wwn -port [-pfc_priority ] {-limit_io | -limit_kb | -limit_mb } {-hba_wwn | -pfc_name } Options and parameters Option Description -port Specifies the port number whose attribute is Target. For example: • CL1-A -pfc_priority Specifies preferred/non-preferred WWN.
PAGE 222
Syntax raidcom modify pfc_group -port [-pfc_priority ] {-limit_io | -limit_kb | -limit_mb } -pfc_group Options and parameters Option Description -port Specifies the port number whose attribute is Target. For example: • CL1-A -pfc_priority Specifies preferred/non-preferred WWN. • y: preferred WWN • n: non-preferred WWN {-limit_io | -limit_kb | -limit_mb } Specifies maximum value/threshold value by the I/O rate or the transmission rate.
PAGE 223
Options and parameters Option Description -port Specifies the port number whose attribute is Target. For example: • CL1-A -hba_wwn Specifies WWN that you get the PFC informartion. -pfc_name Specifies the PFC name that you get the PFC information. WWN is specified in hexadecimal of 16 digits. The 17th digit is ignored. Up to 64 characters can be specified by CLI. Examples Gets the PFC information of WWN that belongs to the specified port (CL4-E).
PAGE 224
If the PRI setting is Y, displays the threshold. If the PRI setting is N, displays the maximum value. If the value is set by the current transferred rate (KBps), displays a hyphen (-). KBps If the PRI setting is Y, displays the threshold. If the PRI setting is N, displays the maximum value. If the value is set by the current IO rate (IOps), displays a hyphen (-). If the value is set by MB, 1 MB is calculated as 1024 KB, and displays the value by KB.
PAGE 225
Displays the Seq#. raidcom monitor pfc_wwn Gets the monitoring information of Performance Control target WWN Syntax raidcom monitor pfc_wwn {-hba_wwn | -pfc_name } Options and parameters Option Description -hba_wwn Specifies WWN that you get the monitoring informartion. -pfc_name Specifies the PFC name that you get the monitoring information. WWN is specified in hexadecimal of 16 digits. The 17th digit is ignored.
PAGE 226
Options and parameters Option Description -pfc_group Specifies the PFC group name. Up to 64 characters can be specified by CLI. Examples Specifies the PFC group name (WWN_GRP_LINUX) to get the monitoring information. # raidcom monitor pfc_group -pfc_group WWN_GRP_LINUX PORT PFC_MD IOps KBps Serial# CL4-E PORT 5000 5000000 63528 Description on each column in output example PORT Displays the port to which the WWN is set. PFC_MD Displays the Control mode of the PFC.
PAGE 227
6 Troubleshooting This chapter provides troubleshooting information for RAID Manager. General troubleshooting If you have a problem with the RAID Manager software, first make sure that the problem is not being caused by the UNIX/PC server hardware or software, and try restarting the server. Problem Recommended action Deprecated SCSI ioctl RAID Manager currently uses the ioctl(SCSI_IOCTL_SEND_COMMAND) for sending the The following message control command to the command device. However, in RHEL 4.
PAGE 228
is detected, please collect the data in the error log file and trace data (all files in HORCM_LOG directory), and report the failure to your HP representative. Condition Recommended action Startup/shutdown restrictions When the server starts up, the secondary volume may be updated by the primary volume's server. The secondary volume must not be mounted automatically in the startup sequence. If the secondary volume is used by the LVM, the volume group of the LVM must be deactivated.
PAGE 229
Condition Recommended action Maintenance Restart of HORCM is required if the storage system configuration is changed (for example, microcode exchange, cache memory install/uninstall). Continuous Access Synchronous only: In the case of an error (for example, single error in cache memory) which made the pair volume is accompanied by maintenance work, the pairresync or paircreate command cannot execute copy rejection.
PAGE 230
Condition Recommended action The command of second line will remove "/var/tmp/.lcm*" directory after 720 Hr from HORCM startup, even though RAID Manager command is used. Action: So administrator needs to add the following command in order to avoid this problem: -----------------------------------------------------------/bin/touch -c /var/tmp/.
PAGE 231
Table 20 System log messages (continued) Message ID Condition Cause Recommended action HORCM_101 HORC/HOMRCF and the RAID Manager software communication fails. A system I/O error occurred or an error exists in the HORCM configuration file ($HORCM_CONF). Refer to the HORCM startup log to identify the cause of the error. HORCM_102 The volume is suspended. The pair status was suspended due to code XXXX. Contact the HP Technical Support.
PAGE 232
Table 21 Command error messages (continued) Error code Error Condition Recommended action Value Verify the device or group name and 247 add it to the configuration file of the remote and local hosts. message EX_ENOENT No such device or group The designated device or group name does not exist in the configuration file. EX_ENODEV No such device The designated device name Verify the device name and add it 246 does not exist in the to the configuration file of the remote configuration file.
PAGE 233
Table 21 Command error messages (continued) Error code Error Condition Recommended action Value message ($HORCM_LOG), and contact the HP Technical Support. EX_CMDRJE An order to the control/command device was rejected The request to the command Verify Continuous Access device failed or was Synchronous/Business Copy rejected. functions are installed. Note: This error code is sometimes caused by the operating system and reported as EX_CMDIOE instead of EX_CMDRJE (see next row).
PAGE 234
Table 21 Command error messages (continued) Error code Error Condition Recommended action Value Detected a suspended status (PSUE) for the paired volume, before it made it to the designated status. Please issue the pairresync 234 command manually to the identified failed paired volume to try to recover it. message EX_EWSUSE Pair suspended at WAIT state If the problem persists, contact the HP Technical Support.
PAGE 235
Table 21 Command error messages (continued) Error code Error Condition Recommended action Value 217 message EX_ENOCTG Not enough CT groups in the RAID CTGID could not be registered due to being beyond the max number of CT groups (0-255 for XP24000/XP20000 Disk Array, 0-255 for XP12000 Disk Array/XP10000 Disk Array, 0-127 for XP1024/XP128 Disk Array, 0-15 for XP256 Disk Array) for an async volume. Choose an existing CTGID (use pairvolchk to display CTGIDs).
PAGE 236
Table 21 Command error messages (continued) Error code Error Condition Recommended action Value message EX_ESPERM Permission denied with the SLPR A specified command device Please make the SLPR so that the 207 does not have a permission target port and the command device to access other SLPR. belongs to the same SLPR. EX_ENOPOL Not enough Pool in RAID Could not retain the pool for executing a command due to be exceeded the threshold rate.
PAGE 237
Table 21 Command error messages (continued) Error code Error Condition Recommended action argument of option exceeded the maximum. of option, or the total number of characters are to be appropriate number of characters. Value message EW_MAXARG Maximum argument The total number of option or the argument of option exceeded the maximum. Check the total number of option or 131 argument of option. EW_ENFILE No such file The specified file dies not exist.
PAGE 238
Table 22 Generic error codes (horctakeover and pair commands) (continued) Category Error code Error message Value EX_INVRCD Invalid return code 226 Configuration EX_ENOGRP No such group 239 (Unrecoverable) EX_ENOENT No such device or group 247 EX_ENODEV No such device 246 EX_ENLDEV No such LDEV within the RAID 227 EX_ENOUNT No such RAID unit 219 EX_INVMUN Invalid mu# with HORC or HOMRCF 220 EX_ENQSER Unmatched Serial# vs RAID unitID 218 EX_EXTCTG Extended CTgroup across RAIDs
PAGE 239
Table 23 Generic error codes (raidscan, raidqry, raidar, horcctl) Category Error code Error message Value Syntax for Argument EX_REQARG Required Arg list 254 (Unrecoverable) EX_INVARG Invalid argument 253 EX_INVNAM Invalid name of option 249 EX_UNWOPT Unknown option 252 EX_UNWCOD Unknown function code 238 EX_UNWCMD Unknown command 230 EX_ERANGE Result too large 244 EX_ENAMLG File name too long 243 EX_INVRCD Invalid return code 226 Configuration EX_ENLDEV No such LDEV withi
PAGE 240
Table 24 Specific error codes Category Error code Error message Value Volume Status EX_ENQVOL Unmatched volume status within the group 236 (Unrecoverable) EX_INCSTG Inconsistent status in group 229 EX_INVVOL Invalid volume status 222 EX_EVOLCE Pair Volume combination error 235 EX_INVSTP Invalid pair status 228 EX_VOLCUR S-VOL currency error 225 EX_VOLCUE Local Volume currency error 224 EX_VOLCRE Local and Remote Volume currency error 223 EX_EWSUSE Pair suspended at WAIT state
PAGE 241
The following describes the SSB codes that are returned by the replication commands and the configuration setting command (raidcom). SSB codes returned by a replication command When one of the replication commands returns an SSB code, refer to the troubleshooting information in the user documentation for the product.
PAGE 242
Table 25 SSB codes returned by the configuration setting command (common) common Error message Executing/ Asynchronous Error code Description SSB1 SSB2 CMDRJE Executing/ 2E10 8000 Get Command Status Asynchronous Unavailable to operate because another application is in progress on Remote Web Console or SVP. CMDRJE Executing 2E11 2205 The resource group to which the operation object belongs is locked by the other user.
PAGE 243
Table 26 SSB codes returned by raidcom add external_grp (continued) raidcom add external_grp Error message Executing/ Asynchronous Error code Description SSB1 SSB2 Get Command Status Asynchronous 2E30 4119 The external volume cannot be added because the number of virtual volumes that can be created in the system exceeded the maximum number. Get Command Status Asynchronous 2E30 4201 The specified external LU has mapped already.
PAGE 244
Table 28 SSB codes returned by raidcom delete external_grp raidcom delete external_grp Error message Executing/ Asynchronous Error code SSB1 SSB2 CMDRJE Executing 2E00 4100 The external volume group # is in the effective range. Get Command Status Asynchronous 2E10 0012 LDEVs in the external volume group are devices that have a CC/XRC attributes. CMDRJE Executing 2E11 0153 The specified external volume group is used in another operation.
PAGE 245
Table 28 SSB codes returned by raidcom delete external_grp (continued) raidcom delete external_grp Error message Executing/ Asynchronous Error code Description SSB1 SSB2 Get Command Status Asynchronous 2E31 0001 The target external group cannot be deleted because a ESAM Quorum disk exists in it. CMDRJE Executing 2EDA 00EE The command cannot be accepted. After a while, execute the same command. Get Command Status Asynchronous 2EE8 FFFB An internal error occurred.
PAGE 246
Table 30 SSB codes that are returned by raidcom disconnect external_grp command raidcom disconnect external_grp Error message Executing/ Asynchronous Error code Description SSB1 SSB2 CMDRJE Executing 2E00 4100 The external volume group is not in the effective range. CMDRJE Executing 2E10 0000 The specified LDEV is used as a Business Copy pair. CMDRJE Executing 2E10 0001 It is used as a Continuous Access Journal pair.
PAGE 247
Table 30 SSB codes that are returned by raidcom disconnect external_grp command (continued) raidcom disconnect external_grp Error message Executing/ Asynchronous Error code SSB1 Description SSB2 Call HP Technical Support. Table 31 SSB codes that are returned by raidcom modify external_grp command raidcom modify external_grp Error message Executing/ Asynchronous Error code Description SSB1 SSB2 CMDRJE Executing 2E00 4100 The external volume group is not in the effective range.
PAGE 248
Table 32 SSB codes that are returned by raidcom modify port -loop_id command (continued) raidcom modify port -loop_id Error message Executing/ Asynchronous Error code Description SSB1 SSB2 CMDRJE Executing B955 1039 The command device being used at the local RAID Manager exists under the port. CMDRJE Executing B955 104F The program product is not installed. CMDRJE Executing B955 113D Invalid host speed is set for the 4Gbps fibre adapter.
PAGE 249
Table 34 SSB codes that are returned by raidcom modify port -security _switch command (continued) raidcom modify port -security _switch Error message Executing/ Asynchronous Error code Description SSB1 SSB2 CMDRJE Executing B955 05A7 The other than "P-to-P (point to point)" cannot be specified when specifying a topology of the package for Fibre Channel over Ethernet. CMDRJE Executing B955 1039 The command device being used at the local RAID Manager exists under the port.
PAGE 250
Table 35 SSB codes that are returned by raidcom add ldev command (continued) raidcom add ldev Error message Executing/ Asynchronous Error code SSB1 SSB2 CMDRJE Executing 2E10 0003 The specified LDEV is used as a Compatible FlashCopy pair. Get Command Status Asynchronous 2E10 001F The operation cannot be done because the total capacity of virtual volumes for Smart Tiers in the system exceeds the maximum.
PAGE 251
Table 35 SSB codes that are returned by raidcom add ldev command (continued) raidcom add ldev Error message Executing/ Asynchronous Error code Description SSB1 SSB2 CMDRJE/Get Command Status Executing/ 2E23 0001 It exceeds the range of LDEV# that can be created. CMDRJE Executing 2E30 0020 The specified SSID is already used in another CU. CMDRJE Executing 2E30 0021 The SSID is allocated to the CU already.
PAGE 252
Table 36 SSB codes that are returned by raidcom delete journal command raidcom delete journal Error message Executing/ Asynchronous Error code Description SSB1 SSB2 CMDRJE Executing 2E00 0000 The number of specified LDEV is invalid. Get Command Status Asynchronous 2E00 0023 The specified volume capacity is too small. CMDRJE Executing 2E00 5000 The specified journal ID is exceeds the range.
PAGE 253
Table 37 SSB codes that are returned by raidcom add journal command (continued) raidcom add journal Error message Executing/ Asynchronous Error code Description SSB1 SSB2 Get Command Status Asynchronous 2E00 500A The journal start threshold value, or the journal end threshold value is incorrect. Get Command Status Asynchronous 2E00 7000 The specified CLPR number is incorrect.
PAGE 254
Table 37 SSB codes that are returned by raidcom add journal command (continued) raidcom add journal Error message Executing/ Asynchronous Error code SSB1 SSB2 Get Command Status Asynchronous 2E30 0005 The specified volume cannot be used as a journal volume because it is set by Cache Residency or Cache Residency Z. Get Command Status Asynchronous 2E30 0006 The specified volume cannot be used because it is used in FICON(R) Data Migration.
PAGE 255
Table 37 SSB codes that are returned by raidcom add journal command (continued) raidcom add journal Error message Executing/ Asynchronous Error code Description SSB1 SSB2 Get Command Status Asynchronous 2E30 0074 The specified LDEV cannot be operated because it is an external volume mapped for online data migration. CMDRJE Executing 2EE4 08E6 The command cannot be accepted. After a while, execute the same command. Get Command Status Asynchronous 2EE4 50EE An internal error occurred.
PAGE 256
Table 38 SSB codes that are returned by raidcom modify journal command (continued) raidcom modify journal Error message Executing/ Asynchronous Error code SSB1 Description SSB2 Call HP Technical Support. Table 39 SSB codes that are returned by raidcom modify ldev -mp_blade_id command raidcom modify ldev -mp_blade_id Error message Executing/ Asynchronous Error code Description SSB1 SSB2 CMDRJE Executing 2E00 0000 The number of LDEV exceeded the range.
PAGE 257
Table 41 SSB codes that are returned by raidcom add device_grp command (continued) raidcom add device_grp Error message Executing/ Asynchronous Error code Description SSB1 SSB2 CMDRJE Executing 2E30 0072 The specified resource group ID of the LDEV cannot be registered because it is different from other resource group ID of the LDEV in the specified device group. CMDRJE Executing 2EEA FEEC An internal error occurred. Call HP Technical Support.
PAGE 258
Table 43 SSB codes that are returned by raidcom initialize ldev command (continued) raidcom initialize ldev Error message Executing/ Asynchronous Error code SSB1 SSB2 CMDRJE Executing 2E11 0153 The parity group or the external volume group to which the specified LDEV belongs is used in another operation. Get Command Status Asynchronous 2E11 6004 The operation of Thin Provisioning V-VOL cannot be done because there is a blocked pool.
PAGE 259
Table 44 SSB codes that are returned by raidcom modify ldev -command_device raidcom modify ldev -command_device Error message CMDRJE Executing/ Asynchronous Error code Description SSB1 SSB2 Executing 2E10 0000 The command device cannot be set to the specified LDEV because of the following causes. • The LDEV is used as a Business Copy pair. • The reserve attribute of a Business Copy is configured.
PAGE 260
Table 45 SSB codes that are returned by raidcom modify ldev -ssid command raidcom modify ldev -ssid Error message Executing/ Asynchronous Error code Description SSB1 SSB2 CMDRJE Executing 2E11 0023 SSID cannot be changed because there are LDEVs in the boundary where the specified LDEV belongs. CMDRJE Executing 2E22 7201 The specified SSID is used for the other boundary. CMDRJE Executing 2EE8 FEEC An internal error occurred. Call HP Technical Support.
PAGE 261
Table 46 SSB codes that are returned by raidcom modify ldev -status nml command (continued) raidcom modify ldev -status nml Error message Executing/ Asynchronous Error code Description SSB1 SSB2 Get Command Status Asynchronous 2E31 0017 LDEV cannot be restored because there is no connection path to the normal external path. CMDRJE Executing 2EE8 00EE The command cannot be accepted. After a while, execute the same command.
PAGE 262
Table 47 SSB codes that are returned by raidcom modify ldev -status blk command (continued) raidcom modify ldev -status blk Error message Executing/ Asynchronous Error code Description SSB1 SSB2 Get Command Status Asynchronous 2E30 0060 It is used as a command device that is used at extended consistency group. Get Command Status Asynchronous 2E31 0001 Maintenance work cannot be performed because the target LDEV is a ESAM Quorum disk.
PAGE 263
Table 50 SSB codes that are returned by raidcom modify ldev -status discard_zero_page command (continued) raidcom modify ldev -status discard_zero_page Error message Executing/ Asynchronous Error code Description SSB1 SSB2 CMDRJE Executing 2E10 0005 The specified LDEV is used as a Auto LUN pair. CMDRJE Executing 2E10 0011 The specified LDEV is blocked. CMDRJE Executing 2E10 600B The associated pool is blocked.
PAGE 264
Table 51 SSB codes that are returned by raidcom delete lun command (continued) raidcom delete lun Error message Executing/ Asynchronous Error code Description SSB1 SSB2 CMDRJE Executing B958 09A1 Another LDEV is already mapped in the specified LUN. CMDRJE Executing B9F9 B9F9 The command device is being used in the local RAID Manager.
PAGE 265
Table 52 SSB codes that are returned by raidcom add lun command (continued) raidcom add lun Error message Executing/ Asynchronous Error code Description SSB1 SSB2 CMDRJE Executing B958 0947 Another LDEV is already mapped to the specified LUN. CMDRJE Executing B958 0956 The value of Host group ID exceeds the maximum. CMDRJE Executing B958 0957 The program product is not installed. CMDRJE Executing B958 0959 The specified host group is not installed.
PAGE 266
Table 53 SSB codes that are returned by raidcom modify pool command (continued) raidcom modify pool Error message Executing/ Asynchronous Error code Description SSB1 SSB2 CMDRJE Executing 2E10 6015 The operation cannot be done because the Tier is being deterred reallocation. CMDRJE Executing 2E10 6017 The operation cannot be done because collecting the performance monitoring data is being prepared. CMDRJE Executing 2E11 9400 The command cannot be accepted.
PAGE 267
Table 54 SSB codes that are returned by raidcom rename pool command raidcom rename pool Error message Executing/ Error code Asynchronous SSB1 SSB2 Description CMDRJE Executing 2E00 6000 The value of pool ID is out of range. CMDRJE Executing 2E10 6016 The pool name cannot be changed because the pool configuration is being changed. CMDRJE Executing 2E20 6000 Invalid pool ID. CMDRJE Executing 2E31 6001 The pool name is duplicated with another pool.
PAGE 268
Table 55 SSB codes that are returned by raidcom delete pool command (continued) raidcom delete pool Error message Executing/ Asynchronous Error code Description SSB1 SSB2 Get Command Status Asynchronous 2E20 0003 The operation cannot be done because the pool volume is not of a specified pool. CMDRJE Executing/Asynchronous 2E20 6000 Pool ID is not installed. CMDRJE Executing 2E30 0052 The specified LDEV cannot be deleted because it is a top VOL of the pool.
PAGE 269
Table 56 SSB codes that are returned by raidcom add snap_pool command (continued) raidcom add snap_pool Error message Executing/ Asynchronous Error code Description SSB1 SSB2 Get Command Status Asynchronous 2E22 000D The larger number of drive types than the supported configuration cannot be added to the specified pool.
PAGE 270
Table 57 SSB codes that are returned by raidcom add ssid command raidcom add ssid Error message Executing/ Asynchronous Error code Description SSB1 SSB2 CMDRJE Executing 2E00 3001 The CU number of the RCU exceeds the effective value. CMDRJE Executing 2E00 3008 The command cannot be executed because the parameter of the specified RCU is invalid. CMDRJE Executing 2E00 7100 The CU number is out of effective range.
PAGE 271
Table 59 SSB codes that are returned by raidcom add thp_pool command raidcom add thp_pool Error message Executing/ Asynchronous Error code Description SSB1 SSB2 Get Command Status Asynchronous 2E00 0000 LDEV number is out of rage. CMDRJE Executing 2E00 6000 The value of pool ID is out of range. CMDRJE Executing 2E00 6002 The maximum reserve ratio of V-VOL is out of range. CMDRJE Executing 2E00 6009 The threshold of the specified High water mark is out of range.
PAGE 272
Table 59 SSB codes that are returned by raidcom add thp_pool command (continued) raidcom add thp_pool Error message Executing/ Asynchronous Error code Description SSB1 SSB2 Get Command Status Asynchronous 2E30 0038 It cannot be used as a pool volume because the size of specified LDEV is less than 8GB. Get Command Status Asynchronous 2E30 005C The specified LDEV is used as a V-VOL. Get Command Status Asynchronous 2E30 005D The specified LDEV is a volume of unsupported Smart Tiers.
PAGE 273
Table 60 SSB codes that are returned by raidcom modify rcu command raidcom modify rcu Error message Executing/ Asynchronous Error code Description SSB1 SSB2 CMDRJE Executing 2E00 3001 CU# of RCU exceed the effective value. CMDRJE Executing 2E00 3002 The value of least path number is invalid. CMDRJE Executing 2E00 3003 The value of RIO MIH time is invalid. CMDRJE Executing 2E00 3004 The value of Round-trip response time is invalid.
PAGE 274
Table 61 SSB codes that are returned by raidcom delete rcu_path command (continued) raidcom delete rcu_path Error message Executing/ Asynchronous Error code Description SSB1 SSB2 CMDRJE Executing 2E00 8400 The value of specified port is invalid. Get Command Status /Asynchronous Get Command Status Asynchronous 2E10 3101 Failed to establish a path or the deletion operation. The following factor can be thought. • Input parameter is invalid.
PAGE 275
Table 62 SSB codes that are returned by raidcom add rcu_path command (continued) raidcom add rcu_path Error message Executing/ Asynchronous Get Command Status /Asynchronous CMDRJE Executing Get Command Status /Asynchronous Get Command Status Asynchronous Error code Description SSB1 SSB2 2E00 8400 The value of specified port is invalid. 2E10 3101 Failed to establish a path or the deletion operation. The following factor can be thought. • Input parameter is invalid.
PAGE 276
Table 63 SSB codes that are returned by raidcom delete rcu command (continued) raidcom delete rcu Error message Executing/ Asynchronous Error code Description SSB1 SSB2 CMDRJE Executing 2E00 8400 The value of specified port is invalid. Get Command Status /Asynchronous Get Command Status Asynchronous 2E11 8004 The operation cannot be done because the microcode is being changed. CMDRJE Executing 2E11 9400 The command cannot be accepted. After a while, execute the same command.
PAGE 277
Table 64 SSB codes that are returned by raidcom add rcu command (continued) raidcom add rcu Error message Get Command Status Executing/ Asynchronous Error code Description SSB1 SSB2 Asynchronous 2E10 3101 Failed to establish a path or the deletion operation. The following factor can be thought. • Input parameter is invalid. • Port status or the MP Blade status is in the state of abnormal. • Cable is not connected correctly. • Port is specified incorrectly.
PAGE 278
Table 65 SSB codes that are returned by raidcom delete ldev command (continued) raidcom delete ldev Error message Executing/ Asynchronous Error code Description SSB1 SSB2 Get Command Status Asynchronous 2E10 0003 The specified LDEV is used as a Compatible FlashCopy pair. Get Command Status Asynchronous 2E10 0004 The specified LDEV is used as a Snapshot pair. Get Command Status Asynchronous 2E10 0008 The specified LDEV is used as a system disk.
PAGE 279
Table 66 SSB codes that are returned by raidcom delete hba_wwn command raidcom delete hba_wwn Error message Executing/ Asynchronous Error code Description SSB1 SSB2 CMDRJE Executing B957 404F The program product is not installed. CMDRJE Executing B957 4087 The host group ID exceeds the maximum value. CMDRJE Executing B957 4089 The specified host group is not installed. CMDRJE Executing B957 408A The attribute of specified port is Initiator or External.
PAGE 280
Table 69 SSB codes that are returned by raidcom reset hba_wwn command (continued) raidcom reset hba_wwn Error message Executing/ Asynchronous Error code Description SSB1 SSB2 CMDRJE Executing B957 408A The attribute of the specified port is Initiator or External. CMDRJE Executing B957 4385 The specified WWN does not exists.
PAGE 281
Table 72 SSB codes that are returned by raidcom modify port -port_speed command (continued) raidcom modify port -port_speed Error message Executing/ Asynchronous Error code Description SSB1 SSB2 CMDRJE Executing B955 05A7 The other than "P-to-P (point to point)" cannot be specified when specifying a topology of the package for Fibre Channel over Ethernet. CMDRJE Executing B955 1039 The command device being used at the local RAID Manager exists under the port.
PAGE 282
Table 74 SSB codes that are returned by raidcom delete host_grp command raidcom delete host_grp Error message Executing/ Asynchronous Error code Description SSB1 SSB2 CMDRJ Executing B956 302C The cancelling of the host mode option 61 setting was aborted. CMDRJE Executing B956 304F The program product is not installed. CMDRJE Executing B956 3071 The value of host group ID exceeds the maximum. CMDRJE Executing B956 3077 The attribute of the specified port is Initiator or External.
PAGE 283
Table 77 SSB codes that are returned by raidcom disconnect path command raidcom disconnect path Error message Executing/ Asynchronous Error code Description SSB1 SSB2 CMDRJE Executing 2E00 4500 The path group is out of the enabled range. CMDRJE Executing 2E00 8400 The value of specified port is invalid. Get Command Status Asynchronous 2E10 4301 The specified external path has already disconnected the path, or is in the process of checking path.
PAGE 284
Table 78 SSB codes that are returned by raidcom delete path command (continued) raidcom delete path Error message Executing/ Asynchronous Error code Description SSB1 SSB2 2E23 4300 Paths cannot be deleted because there are no normal paths. Get Command Status /Asynchronous CMDRJE Executing Get Command Status /Asynchronous CMDRJE Executing 2E30 8400 The port attribute is not External (ELUN). CMDRJE Executing 2EDA 00EE The command cannot be accepted.
PAGE 285
Table 80 SSB codes that are returned by raidcom -login command raidcom -login Error message CMDRJE Executing/ Asynchronous Error code Description SSB1 SSB2 Executing 2E31 9100 The command cannot be executed because the user authentication is not performed. Table 81 SSB codes that are returned by raidcom -logout command raidcom -logout Error message CMDRJE Executing/ Asynchronous Error code Description SSB1 SSB2 Executing 2E01 2200 Failed to release the resource lock.
PAGE 286
Table 83 SSB codes that are returned by raidcom reallocate pool command (continued) raidcom reallocate pool Error message Executing/ Asynchronous Error code Description SSB1 SSB2 CMDRJE Executing 2E10 6008 Tier Reallocation cannot be started because the state of performance monitor information is not enabled. Start the performance monitor again. CMDRJE Executing 2E10 6009 Reallocation cannot be started because it is reallocating.
PAGE 287
Table 85 SSB codes that are returned by raidcom delete resource command (continued) raidcom delete resource Error message Executing/ Asynchronous Error code Description SSB1 SSB2 CMDRJE Executing 2E22 2203 A resource cannot be deleted from the resource group because the specified LDEV number is not the top LDEV number in the LUSE volume. CMDRJE Executing 2ECA FEEC An internal error occurred. Call HP Technical Support.
PAGE 288
Table 87 SSB codes that are returned by raidcom get resource command raidcom get resource Error message CMDRJE Executing/ Asynchronous Error code Description SSB1 SSB2 Executing 2EF0 FEEC An internal error occurred. Call HP Technical Support. Table 88 SSB codes that are returned by raidcom unlock resource command raidcom unlock resource Error message CMDRJE Executing/ Asynchronous Error code Description SSB1 SSB2 Executing 2E10 2200 Cannot unlock because it is locked in another session.
PAGE 289
Table 89 SSB codes that are returned by raidcom modify clpr command (continued) raidcom modify clpr Error message CMDRJE Executing/ Asynchronous Error code Description SSB1 SSB2 Executing 2EE8 FEEC An internal error occurred. Call HP Technical Support. CMDRJE Executing 2EF3 0102 The specified parameter is invalid. Check the HP XP P9000 RAID Manager Reference Guide. CMDRJE Executing 2EF6 FEEC An internal error occurred. Call HP Technical Support.
PAGE 290
Table 93 SSB codes that are returned by raidcom add pfc_wwn command raidcom add pfc_wwn Error message Executing/ Asynchronous Error code Description SSB1 SSB2 CMDRJE Executing B9D4 B9D0 Performance Control is being used by Remote Web Console. CMDRJE Executing B9D4 B9D4 Performance Control program product is not installed. CMDRJE Executing B9D4 B9D7 The specified PFC name has already existed.
PAGE 291
7 Support and other resources Contacting HP For worldwide technical support information, see the HP support website: http://www.hp.
PAGE 292
Conventions for storage capacity values P9000 disk arrays use the following values to calculate physical storage capacity values (hard disk drives): • 1 KB (kilobyte) = 1,000 bytes • 1 MB (megabyte) = 1,0002 bytes • 1 GB (gigabyte) = 1,0003 bytes • 1 TB (terabyte) = 1,0004 bytes • 1 PB (petabyte) = 1,0005 bytes • 1 EB (exabyte) = 1,0006 bytes P9000 disk arrays use the following values to calculate logical storage capacity values (logical devices): • 1 KB (kilobyte) = 1,024 bytes • 1 MB (megab
PAGE 293
CAUTION: IMPORTANT: NOTE: TIP: Indicates that failure to follow directions could result in damage to equipment or data. Provides clarifying information or specific instructions. Provides additional information. Provides helpful hints and shortcuts.
PAGE 294
Index commands error messages and troubleshooting, 231 contacting HP, 291 conventions document, 292 storage capacity values, 292 text symbols, 292 general, 227 generic error codes (horctakeover and pair commands), 237, 240 generic error codes (raidscan, raidqry, raidar, horcctl), 238 notes and restrictions, 227 specific codes, 239 system log messages, 230 typographic conventions, 292 D W document conventions, 292 related information, 291 documentation HP website, 291 providing feedback, 291 web sites H