HP P9000 RAID Manager Reference Guide Abstract This guide provides a command reference for HP P9000 RAID Manager Software on HP P9000 disk arrays. The intended audience is a storage system administrator or authorized service provider with independent knowledge of HP P9000 disk arrays and the HP Remote Web Console.
© Copyright 2010, 2011 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.
Contents 1 Overview of commands............................................................................12 Command summary................................................................................................................12 Command format...................................................................................................................16 Differences from Remote Web Console......................................................................................
Error codes.......................................................................................................................58 Examples..........................................................................................................................59 horctakeover..........................................................................................................................59 Syntax.......................................................................................................
Examples..........................................................................................................................86 horcmstart.............................................................................................................................87 Syntax..............................................................................................................................87 Options and parameters....................................................................................
Syntax............................................................................................................................107 Options and parameters...................................................................................................107 Examples........................................................................................................................110 mkconf...................................................................................................................
Examples........................................................................................................................126 raidcom get external_grp.......................................................................................................126 Syntax............................................................................................................................126 Options and parameters.............................................................................................
Options and parameters...................................................................................................140 Examples........................................................................................................................141 raidcom add ldev.................................................................................................................141 Syntax....................................................................................................................
Examples........................................................................................................................158 raidcom disconnect path.......................................................................................................158 Syntax............................................................................................................................158 Options and parameters..............................................................................................
Options and parameters...................................................................................................173 Examples........................................................................................................................174 raidcom get resource............................................................................................................174 Syntax.....................................................................................................................
Syntax............................................................................................................................185 Options and parameters...................................................................................................185 Examples........................................................................................................................186 raidcom delete resource..................................................................................................
1 Overview of commands NOTE: The raidcom commands described in this guide are supported only on the P9000 disk arrays. All other commands are supported on both the P9000 and the XP24000/XP20000, XP12000/XP10000, SVS200, and XP1024/XP128 disk arrays. The GUI illustrations in this guide were created using a Windows computer with the Internet Explorer browser. Actual windows may differ depending on the operating system and browser used.
Table 1 Replication commands (continued) Command Description (paircurchk), decides the takeover function based on the attributes, executes the chosen takeover function, and returns the result. paircreate Creates a new volume pair from two unpaired volumes. paircurchk Checks the current status of the Continuous Access Synchronous secondary volume(s) by evaluating the data consistency based on pair status and fence level.
Table 2 Command tools for RAID Manager Subcommand Description inqraid 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. mkconf Used to make a configuration file from a special file (raw device file) provided via STDIN. The following table describes the environment variable subcommands.
Table 5 Configuration setting commands (continued) Command Description raidcom get host_grp Displays the host group information. raidcom add hba_wwn Registers a host to a host group. raidcom delete hba_wwn Deletes a host (WWN) from a host group. raidcom get hba_wwn Displays WWN information of a registered host bus 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.
Table 5 Configuration setting commands (continued) Command Description raidcom delete rcu_path Deletes a logical path between RCUs. raidcom add journal Registers a journal volume to a journal. 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 Snapshot.
Table 6 Description convention of the command format Name Description <> The item enclosed in this symbol is variable. | Displays as the meaning of “or” between the multiple items. (Vertical bar) For example, -A | -B Specifies “A” or “B”. [] Braket The item enclosed in this symbol can be omitted. When some items are set off with the vertical bar, specify one or omit all the items. For example, [ -A ] Specifies nothing or specifies A. For example, [ -a | -b ] Specifies nothing or specifies A or B.
Figure 1 List of usable character codes for RAID Manager commands The following shows the characters that can be used for Remote Web Console commands in the ASCII codes.
Figure 2 List of usable character codes for Remote Web Console Settable character length The settable character lengths might be different between RAID Manager commands and Remote Web Console. If using a RAID Manager command and Remote Web Console in parallel, adjust the number of characters to the smaller number and define the names.
Table 7 List of settable character lengths (continued) Name RAID Manager command Remote Web Console User name (User ID) 63 characters 256 characters User name (Password) 63 characters 256 characters Differences with Remote Web Console The operation procedures and the operatable contents are partly different between RAID Manager and Remote Web Console. The following table shows the operational differences with Remote Web Console.
2 Replication commands This chapter provides specifications for the replication commands. paircreate CAUTION: Use the paircreate command with caution. The command starts the Continuous Access Synchronous, Continuous Access Journal, and Business Copy initial copy operations, which overwrite all data on the secondary/target volume.
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.
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. -split Business Copy only. Splits the paired volume after the initial copy operation is complete.
Option Description The user or application can specify the Pool ID so that they can specify independent ID for Snapshot pool different from [CTGID] for splitting at time. LDEVs in a group which was specified by “PID” belong to the specified Pool for the Snapshot. If “PID” is not specified, then the corresponding LDEVs belong to the default pool ID(0). -fq Business Copy only. This option is used when specifying the mode whether “-split” is performed or not as “QUICK”.mode = normal.
Option Description If Sidefile quantity is over limit of Sidefile Area then host side Write I/O is waited for enough space of Sidefile when storing next new write data until this timeout value (1 second to 255(600) seconds). Default timeout value are 90(60)seconds. If the timeout happens with this waiting state, then the pair state is changed from “PAIR” to “PFUS” state of sidefile (Journal) Full, and its host side Write I/O is continued and Writing data is managed by BITMAP mode.
Category Error code Error message Recommended action Value EX_INVSTP Invalid pair status Confirm pair status using pairdisplay. 228 Unrecoverable EX_ENQSIZ Unmatched volume size Confirm volume size or number of LUSE for pairing volume using raidscan f, and make sure volume sizes are identical. Resource EX_ENOCTG Not enough CT groups Choose an existing CTGID (pairvolchk 217 in the RAID displays CTGIDs).
Figure 5 Example for creating a suspended journal volume Example 3 The following figure shows a takeover example used to suspend a journal volume. NOTE: The pairresync command must be issued after CA_Sync volume became S-VOL_SSWS or P-VOL_COPY/PAIR through the horctakeover command. Figure 6 Takeover example used to suspend a journal volume pairsplit The pairsplit command is used to split and delete volume pairs.
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.
Option Description -I [TC] [SI] [instance#] -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.
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 is used. -E Business Copy only. Suspends a paired volume forcibly when a failure occurs. Not normally used.
Table 9 Specific error codes for pairsplit Category Error code Error message Recommended action Volume status EX_ENQVOL Unmatched volume status within the group Confirm status using the pairdisplay 236 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. 229 EX_INVVOL Invalid volume status Confirm volume status/attribute using pairdisplay l or 'raidvchkdsp v aou'.
Pairresync terminates before resynchronization of the secondary (or primary) volume is complete. Use the pair event waiting (pairevtwait) or pairdisplay command to verify that the resync operation completed successfully (status changes from COPY to PAIR). The execution log file also shows completion of the resync operation. The status transition of the paired volume is judged by the status of the primary volume.
Figure 11 Normal Resync and Business Copy Restore Resync Figure 12 Normal Resync and Business Copy Restore Resync Syntax pairresync { -h | -q | -z | -g | -d | -d[g] [MU#] | -FHORC [MU#] | -FMRCF [MU#] | -d[g] [MU#] |-c | -nomsg | -l | -restore | -swaps | -swapp | -fq | -cto | -f[g] [CTGID]} Options and parameters The primary volume’s server is automatically detected by the pairresync command, so the server does
Option Description -I [H] [M] [instance#] Specifies the command as [HORC]/[HOMRCF] or [Continuous Access Synchronous]/[Business Copy], and used when specifying the RAID Manager instance number. or -I [TC] [SI] [instance#] -g Used to specify 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.
Option Description Executes the equivalent of a -swaps from the original P-VOL side. Unlike -swaps, -swapp does require the cooperation of hosts at both sides. -fq XP1024/XP128 Disk Array Business Copy only. Specifies the mode whether “pairresync” is performed or not as “QUICK”. mode = normal pairresync is performed as Non quick mode regardless of setting of $HORCC_RSYN environment variable and/or the system option mode 87 via SVP.
Option Description specified, then “60” seconds is set as default. If “o-time=0” is specified, then sets as “OFF” that does not control Inflow. If Sidefile quantity is over limit of Sidefile Area then host side Write I/O is waited for enough space of Sidefile when storing next new write data until this timeout value (1 second to 255(600) seconds). Default timeout value are 90(60)seconds.
Abnormal termination: Other than 0, see the execution logs for error details. Error codes Unrecoverable errors are fixed and not resolved, even after re-executing the command. If the command failed, the detailed status is logged in the RAID Manager command log ($HORCC_LOG), even if the user script has no error handling. The primary and secondary volumes must not be mounted on any UNIX system, because the pairresync command renews data on both the primary and secondary volumes.
Figure 15 Swap operation Figure 16 Example of -swaps option with -FHORC [MU#] pairevtwait The pairevtwait (pair event waiting) command is used to wait for completion of pair creation and pair resynchronization 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.
Figure 17 Pair Event Waiting Syntax pairevtwait{ -h | -q | -z | -I[H][M][instance#] or I[CA][BC][instance#] | -g | -d | -d[g] [MU#] | -FHORC [MU#] | -FMRCF [MU#] | -d[g] [MU#] | -s [s] ... | -t [intervall] | -nowait[s] | -l | -nomsg } Options and parameters Option Description -h Displays Help/Usage and version information. -q Terminates the interactive mode and exits this command.
Option Description Business Copy volume on a local host (near site). If no -l option is specified, this option tests status of a cascading Business Copy volume on a remote host (far site). The target Business Copy volume must be P-VOL or SMPL. -d[g] Searches a group on the configuration definition file (local instance) for the specified LDEV, and if [MU#] the specified LDEV is contained in the group, the target volume is executed as the paired logical volume (-d) or group (-dg).
Table 11 Pairevtwait Returned Values (continued) Condition Value The status is PSUE. When the -nowait and/or nowaits Normal termination: 0. When monitoring groups, 0 = normal termination for all option is not specified: pairs. Abnormal termination: Other than 0 to 127, see the execution logs for error details. Error codes Unrecoverable errors are fixed and not resolved, even after re-executing the command.
Figure 19 Example of -FMRCF option for Pairevtwait Using -ss ... and -nowaits option In P-VOL_PSUS & S-VOL_COPY state of HOMRCF quick mode, pairevtwait will return immediately even if the S-VOL is still in S-VOL_COPY state because P-VOL is already in P-VOL_PSUS state. If you want to wait the S-VOL_SSUS state, then use -ss and -nowaits option in order for waiting the pair status on S-VOL side. This is needed for operating pairresync -restore or pairsplit -S.
The pair status transition events exist in the HORCM pair state transfer queue. The -resevt option (reset event) deletes one/all events from the HORCM pair state transfer queue. If reset event is not specified, the pair state transfer queue is maintained. If the -s option is not specified, pairmon displays all events for which it receives information from HORCM. If the -s option is specified, only the specified status transitions are displayed.
Pair vol: The paired volume name (dev_name) in the specified group which is described in the configuration definition file. Port targ# lun#: The port ID, TID, and LUN which is described in the configuration definition file. For further information on fibre-to-SCSI address conversion, see the HP P9000 RAID Manager Installation and Configuration User Guide. LDEV#: The LDEV ID for the specified device. Oldstat: The old pair status when the status of the volume is changed.
Options and parameters Option Description -h Displays Help/Usage and version information. -q Terminates the interactive mode and exits the pair volume check command. -z or -zx Makes the pairvolchk command enter the interactive mode. The -zx option guards performing of the HORCM in the interactive mode. When this option detects a HORCM shutdown, interactive mode terminates.
Returned values The pairvolchk command sets the following returned values during exit, allowing you to check the execution results. Table 14 pairvolchk returned values Condition Value When the -ss option is not specified Normal termination: 1: The volume attribute is SMPL. 2: The volume attribute is P-VOL. 3: The volume attribute is S-VOL. Abnormal termination: Other than 0 to 127, see the execution log files for error details. When the -ss Normal termination: option is specified 11: The status is SMPL.
Table 14 pairvolchk returned values (continued) Condition Value 237: EX_CMDIOE 235: EX_EVOLCE ... When the -c option is specified only. 242: EX_ENORMT... When the -c option is specified only. For a Snapshot Volume The Snapshot needs to show the status of Full of the Snapshot Pool as Snapshot condition. For this purpose, Snapshot also uses PFUL and PFUS status which is the status of Full of the sidefile for Continuous Access Asynchronous. The APP can refer this status as the return value.
Display example for Continuous Access Synchronous Sync CTG: # pairvolchk -g oradb pairvolchk : Volstat is P-VOL.[status = PAIR fence = DATA CTGID = 2 MINAP = 2 ] Display example for Continuous Access Asynchronous: # pairvolchk -g oradb pairvolchk : Volstat is P-VOL.
Example 4 The following shows examples of the pairvolchk command and its output. # pairvolchk -g oradb pairvolchk : Volstat is P-VOL.[status # pairvolchk -g oradb pairvolchk : Volstat is P-VOL.[status pairvolchk -g oradb pairvolchk : Volstat is P-VOL.[status # pairvolchk -g oradb pairvolchk : Volstat is P-VOL.
Table 15 Truth table for pairvolchk group status display (continued) Option -ss COPY/RCPY PSUE PDUB PFUS PSUS PFUL PAIR Group status false false false false false TRUE x PFUL false false false false false false TRUE PAIR TRUE x x x x x x COPY/RCPY false TRUE x x x x x PSUE false false TRUE x x x x PDUB false false false x x TRUE x PFUL false false false x x false TRUE PAIR false false false TRUE false false false PFUS false false fa
Option Description -I[CA][BC] [instance#] -g Specifies the 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 This option is used to specify 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.
Option Description # pairdisplay -g horc0 -fdxe Group ... LDEV#.P/S,Status,Fence,Seq#,P-LDEV# M CTG JID AP EM E-Seq# E-LDEV# horc0 ... 41.P-VOL PAIR ASYNC ,63528 40 - 0 - 2 - - - horc0 ... 40.S-VOL PAIR ASYNC ,----- 41 - 0 - - - - Display example for Business Copy/Snapshot: # pairdisplay -g horc0 -fe Group ... Seq#,LDEV#.P/S,Status, Seq#,P-LDEV# M CTG CM EM E-Seq# E-LDEV# horc0 ... 63528 65.P-VOL COPY,63528 64 - - N - - - horc0 ... 63528 64.
Option Description Display example: Group PairVol L/R Port# TID LU-M Seq# LDEV# P/S Status Seq# P-LDEV# M homrcf1 deva0 L CL1-D 3 5 0 30053 271 P-VOL PAIR 30053 263 - homrcf1 deva1 L CL1-D 3 5 1 30053 271 SMPL - - - homrcf1 deva2 L CL1-D 3 5 2 30053 271 SMPL - - - - -m 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.
Option Description Status: The status of the paired volume in first LDEV of the specified group. AP: Displays the number of Active Path in HORC links on P-VOL, also displays the number of active path in Cnt Ac-J links on P-VOL and S-VOL, ‘Unknown’ is shown as ‘-’. U(%):The usage sidefile/ journal data, it is valid at PAIR state. For Continuous Access Asynchronous: The sidefile percentage for CT Group in relationship to a 100% full sidefile in cache.
1: The volume attribute is SMPL. 2: The volume attribute is P-VOL. 3: The volume attribute is S-VOL. When displaying groups, 1/2/3 = normal termination for all pairs. Abnormal termination (other than 0 to 127): See the execution log files for error details. Examples The following examples are of the pairdisplay command and its output.
(Port#,TID,LU-M) (Business Copy) = Port number, TID, LUN, and MU number as described in the configuration definition file. Seq# = Serial number of the RAID storage system. LDEV# = Logical device number. P/S = Volume attribute. Status = Status of the paired volume. Fence (Continuous Access Synchronous only) = Fence level. % (Continuous Access Synchronous only) = Copy operation completion, or percent pair synchronization. Vol.
is specified for a group, the data consistency of each volume in the group is checked, and all inconsistent volumes are found in the execution log file and displayed. Paircurchk is also executed as part of the Continuous Access Synchronous takeover (horctakeover) command.
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 shutdown, interactive mode terminates. OpenVMS cannot use the -zx option.
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 command example # 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...
Option Description -I[H][M] [instance#] Specifies the command as [HORC]/[HOMRCF] or [Continuous Access Synchronous]/[Business Copy], and used to specify the RAID Manager instance number. or -I[CA][BC] [instance#] -g Specifies a group name defined in the configuration definition file. The command is executed for the specified group unless the -d option is specified. -d Specifies paired logical volume name defined in the configuration definition file.
status is logged in the RAID Manager command log ($HORCC_LOG), even if the user script has no error handling. Table 18 Error codes for horctakeover Category Error code Error message Recommended action Volume status EX_ENQVOL Unmatched volume status within the group Confirm status using pairdisplay 236 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.
Option Description -p [hgrp] Specifies the port ID of the port to be scanned. Valid ports are CL1-A to CL1-R and CL2-A to CL2-R (excluding CL1-I, CL1-O, CL2-I, CL2-O). • For XP24000/XP20000 Disk Array: CL3-a to CL3-r, or CLG-a to CLG-r for the expanded port. • For XP12000 Disk Array: CL3-a to CL3-r, or CLG-a to CLG-r for the expanded port. • For XP10000 Disk Array: CL3-a to CL3-h, or CL8-a to CL8-h for the expanded port.
Option Description CL1-C 2 3 30053 1 261 P-VOL PAIR NEVER 30053 269 -m option. To display the cascading mirror descriptor for Cnt Ac-J, -m must be specified in Continuous Access Synchronous or Business Copy command environment. If you want to display all cascading mirror descriptor, specify “-m all” for displaying all MUs. -pi Changes a strings via STDIN for -find option to ““.
Option Description NOTE: When multiple device files share the same LDEV, the first device file is registered to the LDEV map table. • Group: This displays the group name (dev_group) defined in the configuration definition file. • PairVol: This displays the paired volume name (dev_name) within the group defined in the configuration definition file. • PORT: This displays the port number (port#) defined in the configuration definition file.
Option Description # cat /etc/horcmperm.
Option Description (3) Sync has the following behavior on any conditions: • If the logical drive which corresponds to a [-g name] is not open by any applications, then sync flushes the system buffer to a drive and makes the dismount state for this drive. • If the logical drive which corresponds to a [-g name] is already opened by any applications, then sync flushes only the system buffer to a drive.
TARG: Displays the target ID (which was converted by the fibre conversion table). LUN: Displays the LUN (which was converted by the fibre conversion table). SERIAL: Displays the production (serial#) number of the RAID storage system. LDEV: Displays the LDEV# within the RAID storage system. PRODUCT_ID: Displays product-id field in the STD inquiry page.
Option Description -s [interval] or -sm [interval] Designates the time interval in seconds. -s Interprets the time interval as seconds. -sm Interprets the time interval as minutes. [ interval] Designates the time interval value (1 to 60). If not specified, the default interval (3) is used. [count] Designates number of repeats. When omitted, this command repeats until CNTL-C. Returned values None Error codes None Examples An example of the raidar command and its output follows.
Option Description -I[H][M] [instance#] Specifies the command as [HORC]/[HOMRCF] or [Continuous Access Synchronous]/[Business Copy], and used when specifying the RAID Manager instance number. or -I[CA][BC] [instance#] -l Displays the configuration information for the local host and the local RAID storage system. -r Displays the configuration information for the remote host and the remote storage system which contains the specified group.
Cache(MB): Shows the logical cache capacity (in MB) of the storage system connected to the local or remote host. The -l option specifies local host, and -r specifies remote host. Example 2 # raidqry -g GNo Group 1 ora 2 orb 3 orc RAID_type HTC_RAID XP_RAID HTC_DF IV/H 12 12 8 IV/M 9 9 6 MUN/H 4 4 1 MUN/M 64 64 1 GNo: The order of the group name (dev_group) described in the configuration definition file. Group: The group name (dev_group) described in the configuration definition file.
Option Description -d[g] [MU#] Searches a group on the configuration definition file (local instance) for the specified raw_device, and if the specified raw_device is contained 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 the raw_device is contained in two or more groups, the command is executed on the first group.
Option Description protect the absolute volume from the writing by the copy processing of the copy series program product. • [rtime]: Specifies the retention time, in units of day. If [rtime] is not specified, the default time defined by the storage system is used. The default time is “zero” in XP1024/XP128 Disk Array 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.
Disables writing to volumes in oralog group: raidvchkset -g oralog -vg wtd 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.
Option Description -fe Displays the serial# and LDEV# of the external LUNs mapped to the LDEV for the target volume by adding to last column (ignores the format of 80 column). -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.
Returned values None Error codes None Examples Example 1: raidvchkdsp Command Examples with -fd and -fe options The followings show examples of the raidvchkdsp command and its outputs. raidvchkdsp -g vg01 -fd -v cflag Group PairVol Device_File Seq# LDEV# vg01 oradb1 Unknown 2332 vg01 oradb2 c4t0d3 2332 3 # raidvchkdsp -g horc0 -v gflag -fe Group ... TID LU Seq# LDEV# GI-C-R-W-S horc0 ... 0 20 63528 65 E E E E E horc0 ... 0 20 63528 66 E E E E E <= Example of -fd option showing Unknown vol.
D: Checking for CHK-F3 on Write is disabled. B =E: Checking for CHK-F3 in the data block #0 is enabled. D: Checking for CHK-F3 in the data block #0 is disabled. BR-W-B-Z: This column displays the flags for checking regarding CHK-F2 in the data block. R =E: Checking for CHK-F2 on Read is enabled. D: Checking for CHK-F2 on Read is disabled. W =E: Checking for CHK-F2 on Write is enabled. D: Checking for CHK-F2 on Write is disabled. B =E: Comparing for CHK-F2 in the data block is enabled.
Example 5: raidvchkdsp Command Example with the -v gflag option # raidvchkdsp -g vg01 -fd -v gflag <=Example of -v gflag option. Group PairVol Device_File Seq# LDEV# GI-C-R-W-S PI-C-R-W-S R-Time vg01 oradb1 c4t0d2 2332 2 E E D D E E E D D E 365 vg01 oradb2 c4t0d3 2332 3 E E D D E E E D D E - Output of the raidvchkdsp command with -v gflag option: GI-C-R-W-S: Displays the flags for guarding as for the target volume. I=E: Enabled for Inquiry command. D: Disabled for Inquiry command.
Example 7: raidvchkdsp command example with -v aou option [Display example] # raidvchkdsp -v aou -g AOU Group PairVol Port# TID AOU AOU_001 CL2-D 2 AOU AOU_002 CL2-D 2 LU 7 10 Seq# LDEV# 62500 167 62500 170 Used(MB) LU_CAP(MB) U(%) T(%) PID 20050 1100000 10 70 1 110000 1100000 10 70 1 Output of the raidvchkdsp command with the -v aou option: Used(MB): Displays the usage size of the allocated block on this LUN.
Option Description For XP1024/XP128 Disk Array: CL3-a to CL3-r, or CL4-a to CL4-r for the expanded port. The port is not case sensitive (For example, CL1-A= cl1-a= CL1-a= cl1-A, CL3-a= CL3-A= cl3-a= cl3-A). This option must be specified if “-find” or “-pd “option is not specified. Specify [hgrp] to display only the LDEVs mapped to a host group on a port (XP1024/XP128 Disk Array and later). -pd[g] Specifies the raw device name.
R =E: Checking for data block size on Read is enabled. D: Checking for data block size on Read is disabled. W =E: Checking for data block size on Write is enabled. D: Checking for data block size on Write is disabled. E =L: Data block on Read/Write is interpreted as little endian format. B: Data block on Read/Write is interpreted as big endian format. E =W: Shows the Warning that Read/Write is not rejected when validation error is detected.
ENLBA: Displays the End of LBA on a target volume for checking, in units of 512 bytes. Note: If STLBA and ENLBA are both zero, this means to check all blocks. 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.
D: ”S” flag cannot be changed to enable. 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”. Audit lock status is shown as the retention time plus 1000000. “R-Time + 1000000” shows the retention time with Audit lock status.
Option Description -z or -zx Makes the raidvchkscan command enter the interactive mode. The -zx option guards performing of the HORCM in the interactive mode. When this option detects a HORCM shutdown, interactive mode terminates. OpenVMS cannot use the -zx option. -I[H][M] [instance#] Specifies the command as [HORC]/[HOMRCF] or [Continuous Access Synchronous]/[Business Copy], and used when specifying the RAID Manager instance number.
AP: Displays the following conditions (status) according to the pair status. Shows the number of active paths on the initiator port in Cnt Ac-J links. ‘Unknown’ is shown as ‘-’. AM: The activity monitor that detects whether or not there is a request for data from the initiator at regular intervals. If AM detects a time-out, the P-JNL state is changed from P-JNN to PJSE. Note: The same path information is used for AP for three commands (pairvolchk, pairdisplay, raidvchkscan).
Table 20 Detailed status of the journal volume (continued) JNLS Other information Description P-JNL S-JNL QCNT AP PJNN - N - Normal state of the journal volume with data SJNN N N Normal state of the journal volume with data 0 Still normal state of the journal volume at Link failure 0 - Suspended journal volume via operation N - Suspending the journal volume (PJNS) - (SJNS) PJSN SJSN PJNF - N - High water mark state PJSF SJSF 0 - Suspended journal volume due to full journa
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 raidvchkdsp command enter the interactive mode. The -zx option guards performing of the HORCM in the interactive mode. When this option detects a HORCM shutdown, interactive mode terminates. OpenVMS cannot use the -zx option.
Capacity(MB): Displays the total capacity in the Snapshot/Thin Provisioning pool. Seq#: Displays the serial number of the RAID storage system. Num: Displays the number of LDEV configured the Snapshot/Thin Provisioning pool. LDEV#: Displays the first number of LDEV configured the Snapshot/Thin Provisioning pool. H(%): Displays the threshold rate being set to the Snapshot/Thin Provisioning pool as High water mark. ‘Unknown’ is shown as ‘-’.
Option Description (Environment variables set by the user become invalid.) When this option is not specified, the horcmstart shell script starts 1 HORCM and uses the environment variables set by the user. If you have designated full environment variables, use horcmstart.sh without any arguments.
horcctl The HORCM and Continuous Access Synchronous software have logs that identify the cause of software and/or hardware errors as well as a tracing function for investigating such errors. The location of the log files depends on the user’s command execution environment and the HORC Manager’s execution environment. The command trace file and core file reside together under the directory specified in the HORC Manager’s execution environment.
Option Description -S Shuts down HORCM. -D Displays the command device name currently used by HORCM. If the command device is blocked due to online maintenance (microcode replacement) of the storage system, you can check the command device name in advance using this option. -c Changes the command device name being used by HORCM and displays the new command device name.
Option Description -z or -zx Makes the raidvchkdsp command enter the interactive mode. The -zx option guards performing of the HORCM in the interactive mode. When this option detects a HORCM shutdown, interactive mode terminates. OpenVMS cannot use the -zx option. -I[H][M] [instance#] Specifies the command as [HORC]/[HOMRCF] or [Continuous Access Synchronous]/[Business Copy], and used when specifying the RAID Manager instance number.
Error codes If the command failed, then the detailed status is logged in RAID Manager command log ($HORCC_LOG), even though the user script has no error handling.
Example 3 horctakeoff command on L1 remote site # horctakeoff horctakeoff : horctakeoff : horctakeoff : horctakeoff : horctakeoff : horctakeoff : horctakeoff : horctakeoff : -g G1 -gs G2 'pairsplit -g G2 -S' is in progress. 'pairsplit -g G1' is in progress. 'pairsplit -g G1 -FHORC 2 -S' is in progress. 'paircreate -g G2 -vl -nocopy -f async -jp 0 -js 1' is in progress. 'pairsplit -g G2' is in progress. 'pairresync -g G1' is in progress. 'pairresync -g G2' is in progress. horctakeoff done.
Using this function, a client can confirm that a commit() has reached the remote site, and also the backup utility on a remote site can split the cascading Business Copy volumes (Continuous Access Asynchronous/Cnt Ac-J to Continuous Access Asynchronous/Business Copy/Cnt Ac-J) without splitting Continuous Access Asynchronous/Cnt Ac-J. More robust systems need to confirm the data consistency between the Continuous Access Asynchronous/Cnt Ac-J PVol and S-VOL. In DB operations (e.g.
Option Description -g Specifies a group name defined in the configuration definition file. The command is executed for the specified group unless the -d option is specified. -d Specifies paired logical volume name defined in the configuration definition file. When this option is specified, the command is executed for the specified paired logical volume.
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, see the execution logs for error details. 0: The status is DONE (completion of synchronization). 1: The status is TIMEOUT (timeout).
QM-Cnt: The number of remaining Q-Markers within CT group of the Unit. HORCAsync/Cnt Ac-J sends a token called “dummy recordset” at regular intervals, therefore QM-Cnt always shows “2” or “3” even if Host has NO writing. Following is an 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.
3 Subcommands This chapter desscribes the subcommands. Windows subcommands The RAID Manager software provides subcommands for the Windows platforms that are executed as options (-x ) of another command. 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, place the other option after the subcommand.
Example 4 findcmddev subcommand example D:\HORCM\etc> raidscan -x findcmddev hdisk0, 20 cmddev of Ser# 62496 = \\.\PhysicalDrive0 cmddev of Ser# 62496 = \\.\E: cmddev of Ser# 62496 = \\.\Volume{b9b31c79-240a-11d5-a37f-00c00d003b1e} 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.
SSID: Shows the SSID of the specified volume. CTGID (Continuous Access Asynchronous/Cnt Ac-J only): Shows the consistency group ID of specified volume. 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.
Syntax -x -x -x -x -x sync[d] sync[d] sync[d] sync[d] sync[d] A: B: C: ... all drive#(0-N) Volume# ... D:\Directory or \Directory pattern... Arguments Argument Description A: B: C: [\directory or \Directory pattern] Specifies the logical drive that you want to synchronize. Data is flushed into the specified logical drive and the physical drive corresponding to the logical drive.
NOTE: Sync has the following behavior on any conditions: If the logical drives designated as the objects of the sync command are not opened to any applications, then sync flushes the system buffer to a drive and makes the dismount state for this drive. If the logical drives designated as the objects of the sync command are already opened to any applications, then sync only flushes the system buffer to a drive.
Argument Description If [\directory] is detected as mount point with embedded space (For example, 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 ... Harddisk3 The same method is used for “inqraid $LETALL” and “raidscan -pi $LETALL -find” command.
Syntax -x umount[d] drive: [time] -x umount[d] drive:[\directory] [time] (for Windows 2008/2003/2000) Argument Argument Description drive Specifies the mounted logical drive. [\directory] Specifies the directory mount point on the logical drive. This command option calls “mountvol /P” internally, if “USE_MOUNTVOL_P” environment variable will be specified. In case of Windows 2008, it is required to specify “USE_MOUNTVOL_P” variable to avoid a problem of mount.
NOTE: The umount command flushes (sync) the system buffer of the associated drive before deleting the drive letter. If umount fails, confirm the following conditions: 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.
Environment variable subcommand examples raidscan[HORC]: raidscan[MRCF]: -x setenv HORCC_MRCF 1 raidscan[MRCF]: raidscan[HORC]: -x usetenv HORCC_MRCF 106 Subcommands
4 Command tools This chapter describes 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.
Option Description -gvinf Windows systems only. -gvinfex is for GPT disk. -gvinfex Gets the signature and volume layout information of a raw device file provided via STDIN or arguments, and saves this information to the system disk with the following format: \WindowsDirectory\VOLssss_llll.ini where ssss = serial#, llll = LDEV# Normally this option is used to save the signature and volume layout information once after setting the new partition for S-VOL using the Windows Disk Management.
Option Description -fg (XP1024/XP128 Disk Array and later): Shows a LUN on the host view by finding a host group for (XP1024/XP128 Disk Array and later). -fw: Displays all of the cascading volume statuses on the STD Inquiry Page. If this option is not specified, then only four cascading mirrors are displayed. Example: # ls /dev/rdsk/* | inqraid -CLI -fw DEVICE_FILE PORT SERIAL LDEV CTG H../M/..
Option Description inst command on the RM (local) server imports the device information, and registers it into the HORCM deamon. See Remote Volume Discovery in the User and Reference Guide for more details.
CA = P-VOL BC[MU#0 = SMPL MU#1 = SMPL MU#2 = SMPL] RAID5[Group 2- 1] SSID = 0x0008 CTGID = 3 /dev/rdsk/c0t4d0 -> [HP] CL2-D Ser = 30053 LDEV = 14 [HP ] [OPEN-3-CM RAID5[Group 2- 1] SSID = 0x0008 ] AIX system: # lsdev -C -c disk | grep hdisk | .
HORC: Displays the attribute (“P-VOL/S-VOL/SMPL”) of a volume as Continuous Access Synchronous in the RAID storage system. HOMRCF: Displays the attribute (“P-VOL/S-VOL/SMPL”) of a volume as MU#0-2 of Business Copy/Snapshot in the RAID storage system. Group: Displays the physical position of an LDEV according to mapping of LDEV in the RAID storage system.
# echo /dev/rdsk/c23t0d0 /dev/rdsk/c23t2d3 | ./inqraid -findc -CLI DEVICE_FILE M Group PairVol P/S Stat R_DEVICE M P/S Stat LK c23t0d0 0 horc1 dev00 S-VOL SSUS c23t0d1 0 P-VOL PSUS OK c23t2d3 0 horc1 dev10 S-VOL SSUS c23t2d2 0 P-VOL PSUS OK 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 (P-VOL or S-VOL or simplex).
inqraid: example of -cliwp and -cliwn options (HP-UX) # echo /dev/rdsk/c23t0d0 /dev/rdsk/c23t0d1 | ./inqraid -CLIWP DEVICE_FILE PWWN AL PORT LUN SERIAL LDEV PRODUCT_ID c23t0d0 500060e802f01018 - CL2-J 61456 192 OPEN-3 c23t0d1 500060e802f01018 - CL2-J 61456 193 OPEN-3 # echo /dev/rdsk/c0t2d3 | ./inqraid -CLIWN DEVICE_FILE NWWN AL PORT LUN c0t2d3 5000E000E0005000 - CL1-A - SERIAL 30015 LDEV PRODUCT_ID 2054 OPEN3-CVS DEVICE_FILE: Displays the device file name only.
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.
horcm9.conf # vi *.conf 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.
5 Configuration setting commands This chapter describes the configuration setting commands. NOTE: The raidcom configuration commands are supported only on P9500 arrays. raidcom The configuration change is instructed. Executes by specifying respective parameters and values that are expressed in “raidcom add copy_grp” (page 119) and later.
Option Description [-nomsg] This option deters displaying messages. This option is required to be defined at the beginning of the command parameter. [ -zt ] This option specifies a script file. [-load ] This option specifies a file name of a file (configuration file) that is created for implementation check. Examples Performing user authentication (login) by the user ID: USER01 and the password: PASS01. raidcom –login USER01 PASS01 Performing log-out.
(b) Creating journal Create a journal by a specified LDEV. raidcom add journal –journal_id 1 -ldev_id 265 266 267 268 raidcom add journal -journal_id 1 -ldev_id 265-268 raidcom add journal -journal_id 1 -ldev_id 265 -cnt 4 (c) Creating pool Create a pool for Snapshot by a specified LDEV. raidcom add snap_pool -pool 1 -ldev_id 365 366 367 raidcom add snap_pool -pool 1 -ldev_id 365-367 raidcom add snap_pool -pool 1 -ldev_id 365 -cnt 3 Create a pool for Thin Provisioning by a specified LDEV.
Option Description If this number is omitted (by raidcom get copy_grp), “-” is displayed. [ -journal_id ] Specifies a journal number (0-255). If the specification is omitted (by raidcom get copy_grp), “-” is displayed. Examples Creating a copy group (ora) by device groups (grp1, grp2). raidcom add copy_grp -copy_grp_name ora grp1 grp2 raidcom delete copy_grp Deletes the specified copy group.
If -mirror_id is not specified at the creation, “-” is displayed. JID# Journal number to which device group belongs Serial# Product serial number raidcom add device_grp Assigns a device name to the specified LDEV and creates a device group. If the group exists, the LDEV is added to the group. If the LDEV also already exists in the specified device group, the specified LDEV name is set.
Options and parameters Option Description -device_grp_name Specifies a device group name (max. 32 characters). -ldev_id … Specifies a CU:LDEV hexadecimal address double octet or an LDEV number (0-65279) or a range. For example: • -ldev_id AB:CD • -ldev_id 43981 • -ldev_id 01:2C-01:31 [ -cnt ] Specifies a count (2-64). The count becomes singular if the specification is omitted. Examples Deleting the LDEV400 from the device group: grp1.
Device name in the device group LDEV# LDEV number Serial# Product serial number raidcom add external_grp Maps (creates LDEVs) to add some external VOLs. Only one external VOL is operated in one operation. This makes an external volume to the specified external Group, and connects to an external LUN on the specified external port /wwn. If the external volume group exists, the external volume is added to the external volume group. This command is executed asynchronously with the command input.
raidcom check_ext_storage external_grp Specifies the external volume group, check the connection for the external VOL, and then restart using. One external VOL is operated in one operation. An LDEV or a device group can be specified instead of the external volume group. • If an LDEV is specified: It searches the external volume groups where the relevant LDEV belongs to, and the result is displayed in the console window.
raidcom delete external_grp Release the mapping of the external volume to delete the registered external VOLs from the configuration. One external VOL is deleted in one operation. A path group is deleted when the last external volume is deleted. This command is executed asynchronously with the command input. Check the completion of this process on the raidcom get command_status command.
Option Description For example: • -ldev_id AB:CD • -ldev_id 43981 • -ldev_id 01:2C-01:31 -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 Specifies the name of device group (max. 32 characters) to be operated. To operate an LDEV in the device group, specify the device name of LDEV (max.
GROUP This displays the External Volume Group number. Num_LDEV This displays the number of LDEV assigned to this External Volume Group. U(%) This displays the usage rate of this External Volume Group. AV_CAP(GB) This displays the available capacity (Free space) for this External Volume Group. R_LVL This displays the RAID level of the parity group. As the external volume group is not relevant, “-” (bar) is displayed. E_TYPE This displays the base emulation type of the external volume group.
SIZE_LBA This displays the 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 (specified cache mode, cache inflow control mode, and MP Blade ID setting).
Options and parameters Option Description -port Specifies the number of the port whose attribute is “ELUN(External).” For example: • CL1-A Displays an external port. Examples Displaying the external storage system ports from the port: CL1-A.
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 255) -host_grp_name Specifies a HOST group name. Up to 64 characters can be set by RAID Manager. When more than 64 characters name is set, a command that is specified host group name by Remote Web Console 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.
Options and parameters Option Description -port [] Specifies a port number, a host group ID, and a host group name. It cannot be specified when more than 64 characters is set for the host group name. Use the host group ID. For example: • CL1-A • CL1-A-g (g is from 0 to 255) • CL1-A Linux_X86 If you specified these settings, the information about all host groups that are defined on the specified port is displayed, regardless of the examples.
41 Prioritized device recognition command 42 Prevent "OHUB PCI retry" 43 Queue Full Response 48 ESAM Svol Read Option 54 Support Option for the EXTENDED COPY command raidcom modify host_grp This sets a host mode to the host group on the specified port. If you want to set Host mode option, then specify “-host_mode_opt” option. If you want to reset Host mode option, then specify “-host_mode_opt 100.” It ignores when no specified host group does not exist.
Option Description 22: Veritas Cluster Server 23: REC command support 33: Invalidating setting and reporting of device identifiers 40: V-Vol extension 41: Prioritized device recognition command 42: Inhibiting "OHUB PCIretry" 43: Queue Full Response 48: ESAM Svol Read Option 54: Support Option for the EXTENDED COPY command This parameter is used when setting the option bits for the host mode option. For more details, see the HP P9000 Provisioning for Open Systems User Guide.
Option Description For example: • 21000e08b0256f8 • 21000e0,8b0256f8 (The value can be split in units of 4 bytes by “,” (commas).) Examples Setting the WWN of host bus adapter: 210000e0, 8b0256f8 to the port: CL4-E, the host group #0. raidcom add hba_wwn -port CL4-E-0 -hba_wwn 210000e0,8b0256f8 raidcom delete hba_wwn Deletes the host (WWN) from the host group. Ignored if the specified WWN does not exist.
Option Description If setting the host group ID or if the host group name is omitted, the information about host group ID 0 is displayed. For example: • CL1-A • CL1-A-g (g is from 0 to 255) • CL1-A Linux_X86 Examples Displaying the WWN of the host bus adapter set for the port: CL4-E, the host group 0.
Options and parameters Option Description -journal_id Specifies a journal number (0-255). -ldev_id … Specifies a CU:LDEV hexadecimal address double octet or an LDEV number (0-65279) or a range. Up to 64 LDEVs can be specified at a time. For example: • -ldev_id AB:CD • -ldev_id 43981 • -ldev_id 01:2C-01:31 [ -cnt ] Specifies a count (2-64). The count becomes singular if the specification is omitted. In this command, effective value is up to 64.
A device group can also be specified instead of an LDEV. If the both LDEV or 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.
Examples Displaying journal information. # raidcom get journal JID MU CTG JNLS AP U(%) Q-Marker Q-CNT D-SZ(BLK) Seq# Num LDEV# 001 0 1 PJNN 4 21 43216fde 30 512345 62500 4 265 002 1 2 PJNF 4 95 3459fd43 52000 512345 62500 3 270 002 2 2 SJNS 4 95 3459fd43 52000 512345 62500 3 270 003 0 3 PJSN 4 0 - - 512345 62500 1 275 004 0 4 PJSF 4 45 1234f432 78 512345 62500 1 276 005 0 5 PJSE 0 0 - - 512345 62500 1 277 Displaying Timer related information of the journal.
It shows the number of Q-markers remaining in the P-VOL journal volume. D-SZ(BLK) It shows the capacity of the data block size of the journal volume in units of 512 bytes. Seq# Sequential number. Num It shows the number of LDEVs configuring the journal volume. LDEV # LDEV number. DOW This displays “Data Overflow Watch” timer (in unit of Sec.) setting per the Journal. PBW This displays “Path Blockade Watch” (in unit of Sec.) timer setting per the Journal.
MP# This displays MP Blade ID. raidcom modify journal Changes an option of Cnt Ac-J to be used at journal. It sets a specified control parameter to the journal. If the -mp_blade_id option is specified, the other option (-data_overflow_watch, path_blocked_watch, -cache_mode, -timer_type) cannot be specified. “-timer_type” option must be specified to the journal on “M/F System”. This means that this option cannot be used for changing from “Open System” to ”M/F System.
Option Description For example: • -mp 2 -mirror_id Specifies a Mirror ID. If the setting is omitted, “0” is used. Examples Changing the setting of a journal: 6. Changing the data overflow watch time to 15 seconds. # raidcom modify journal -journal_id 6 -data_overflow_watch 15 Changing the setting of a journal: 6. Changing the data overflow watch time to 15 seconds. Changing the timer type to the system clock of the mainframe host.
Option Description When specifying just a number, it is recognized as a pool ID. Therefore, when you specify a pool that the pool name is only a number, operate by specifying pool ID instead of specifying pool name. When creating V-VOL to a pool for Snapshot, specify “snap”. -ldev_id … Specifies a CU:LDEV hexadecimal address double octet or an LDEV number (0-65279) or a range. For example: • -ldev_id AB:CD • -ldev_id 43981 • -ldev_id 01:2C-01:31 - capacity Specifies a capacity.
Creating LDEV following these items. Parity group: 33-16, The location of the parity group: automatic allocation, Emulation type: OPEN-V, Size: 10M cylinder (Cylinder specification), LDEV: 120. raidcom add ldev -parity_grp_id 33-16 -ldev_id 100 -cylinder 10m 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.
Syntax raidcom extend ldev {-ldev_id | -grp_opt -device_grp_name []} -capacity | -offset_capacity | -cylinder Options and parameters Option Description -ldev_id … Specifies a CU:LDEV hexadecimal address double octet or an LDEV number (0-65279) or a range. Specify LDEVs for Thin Provisioning/Smart Tiers.
Options and parameters Option Description -ldev_id … Specifies a CU:LDEV hexadecimal address double octet or an LDEV number (0-65279) or a range. For example: • -ldev_id AB:CD • -ldev_id 43981 • -ldev_id 01:2C-01:31 -dldev_id Specifies the relevant LDEV with a device file. [ -cnt ] Specifies a count (2-65280). The count becomes singular if the specification is omitted.
CL : 0 VOL_TYPE : OPEN-V-CVS VOL_Capacity(BLK) : 2181120 VOL_Capacity(cyl ) : 22720 (Displayed only when the attribute is MF-VOL) 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 OPE_RATE : 100 MP# : 2 Description on each column in output example -Serial# Product seria
PORTs It lists up the ports defined to the paths for the relevant LDEV. F_POOLID This displays a pool ID if the LDEV is a component of the pool. In other cases, “NONE” is displayed. VOL_ATTR It lists up the attributes of the following LDEVs. CMD: Command device CLUN: Cache LUN (DCR) CVS: CVS volume LUSE: LUSE volume ALUN: Auto LUN volume ELUN: External volume OLG: OpenLDEV Guard volume VVOL: VVOL HARD: Oracle H.A.R.
NML: Normal BLK: Blocked BSY: Status is changing NONE: unknown state (not supported) OPE_TYPE It shows the in current operation. FMT: Formatting QFMT: Quick Formatting CCOPY: Copying the collections CACCS: Accessing to collections NONE: Not in operation SHRD: Shredding ZPD: Page Discarding OPE_RATE It shows the progress situation when formatting or shredding. When the status is other than formatting or shredding, 100 is displayed. If the process ends abnormally, “BSY” is displayed on the “STS”.
This displays the device identification information in the SCSI information of the external volume (display in hexadecimal notation). E_VOLID_C This displays the PRODUCT information in the SCSI information of the external volume (ASCII display). NUM_E_PROTs This displays the number of alternate paths. E_PORTs It enumerates the defined alternate paths. Examples If the LDEV number 160 is an external volume, its back-end (RAID Group) information is displayed.
raidcom initialize ldev Formats LDEVs. The operation that can be specified is Quick Format, Normal Format, and Shredding. A device group can also be specified instead of an LDEV. This command is executed asynchronously with the command input. Check the completion of this process on the raidcom get command_status command.
Switching LDEV normal and LDEV blockade Setting LDEV nickname Setting MP Blade ID of LDEV Setting the start/stop of reallocation of V-VOL for Smart Tiers Instructing the page discarding of V-VOL for Thin Provisioning/Smart Tiers Setting SSID Setting command device attribute When executing LDEV blocking or recovery operation, this command is executed asynchronously with the command input. Check the completion of this process on the raidcom get command_status command.
Option Description n: Command device attribute disabled. Specifies the value of command device security (0-7). Examples Restoring the LDEV: 200. raidcom modify ldev -status nml -ldev_id 200 Blocking the LDEV: 200.
Option Description For example: • CL1-A-g (g: 0-255) • CL1-A Linux_X86 -ldev_id … Specifies a CU:LDEV hexadecimal address double octet or an LDEV number (0-65279) or a range. For example: • -ldev_id AB:CD • -ldev_id 43981 • -ldev_id 01:2C-01:31 -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.
Option Description For example: • CL1-A-g (g: 0-255) • CL1-A Linux_X86 -lun_id Specifies a LUN number (0-2047). -ldev_id … Specifies a CU:LDEV hexadecimal address double octet or an LDEV number (0-65279) or a range. For example: • -ldev_id AB:CD • -ldev_id 43981 • -ldev_id 01:2C-01:31 -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.
Examples Displaying LUs defined to the external storage system port: 50060e80,1611a870 connected to the port: CL7-A (External port).
CL4-E CL4-E CL4-E CL4-E CL4-E 0 0 0 0 0 LINUX/IRIX LINUX/IRIX LINUX/IRIX LINUX/IRIX LINUX/IRIX 2 3 4 5 6 1 1 1 1 1 2 3 4 992 993 63528 2 63528 2 63528 2 - 63528 - 63528 13 13 13 2 13 2 13 Description on each column in output example PORT This displays the port number. GID This displays the host group ID on port. HMD This displays the following HOST MODE for the host adapter setting on host group.
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.
Option Description For example: • 21000e08b0256f8 • 21000e0,8b0256f8 Examples Restoring a path of external volume path group number: 1, External port CL1-A, and external storage system port 50060e80,05fa0f36. raidcom check_ext_storage path -path_grp 1 -port CL1-A -external_wwn 50060e80,05fa0f36 raidcom delete path Deletes the external path or alternative path to an external volume. Only one path is operated in one operation. This command is executed asynchronously with the command input.
Options and parameters Option Description -path_grp Specifies an external VOL path group number (0-63231). -port Specifies the number of the port whose attribute is ELUN (External). For example: • CL1-A -external_wwn Specifies a WWN value (hexadecimal value) of the external storage system in 8 bytes. The value can be split in units of 4 bytes by “,” (commas).
This displays the following status of the external volume. - NML: this means the status of “Normal” in external volume. - CHK: this means the status of “Checking” in external volume. - SYN: this means the status of “Cache Destage” in external volume. - DSC: this means the status of “Disconnect” in external path for an external volume. - BLK: this means the status of “blockading” in external path for an external volume. - UNK: this means the status of “Unknown” in external volume.
Syntax raidcom delete pool -pool { | } Options and parameters Option Description -pool { | } When specifying a number, it is recognized as a pool ID. Therefore, when you specify a pool that is only a number, operate by specifying pool ID instead of specifying pool name. Examples Deletes a pool of pool ID: 5.
- POLE: “Pool failure” (The pool is suspended in the failure status.) In this status, the pool information cannot be displayed. U(%) This displays the usage rate of the pool. SSCNT This displays the number of volumes in the pool. POOL_NAME This displays the pool name. Available (MB) This displays the capacity available to the volume data in the pool. Capacity (MB) This displays the total capacity of the pool. Seq# Product serial number. Num This displays the number of LDEV configured the pool.
Option Description The valid range for Snapshot is20-95%. • For Thin Provisioning/Smart Tiers, you may specify two user-defined thresholds, and their valid ranges are 1-100%, respectively. If you specify and : The value of is set as the threshold for WARNING specified to a pool. The value of is set as the threshold for High water mark specified to a pool.
Syntax raidcom get port [-port ] Options and parameters Option Description [-port ] Specifies a port number. If the port number is specified for the port which is enabled LUN security, it displays LOGIN WWN. For example: CL1-A Examples Displaying port information. In case of mainframe port (ESCON, FICON), "-" is displayed to the rows from SPD to SSW.
FCAL/PtoP SSW This displays the LUN security setting on a port as Y (enabled) or N (disabled). SL This displays the SLPR number where a port is belonging. Serial# Product serial number. WWN This displays the external WWN PHY_PORT When the version of DKCMAIN program is "70-02-0X-XX/XX", "-" is displayed. Displaying the information of the port CL4-E.
This displays VP Index, but this value is always zero currently. FCF_I This displays FCF Index, but this value is always zero currently. raidcom modify port Sets the attribute value of the specified port. The specified port must be “TYPE=FIBRE and ATTR=TAR”, if not it will be rejected with EX_ENOOBJ. When transmitting a fiber channel frame over Ethernet, this specifies the Port speed: 10G, Port topology: f_port.
Examples Changing the port attributes (the Loop ID and the topology of the Port) of a port CL3-E. raidcom modify port -port CL3-E -loop_id 0xAB -topology fl_port Changing the port attributes of the port CL3-E to the External Initiator port (ELUN). raidcom modify port -port CL3-E -port_attribute ELUN raidcom get parity_grp Displays parity group information.
This displays the SLPR number to which a Parity Group or an external volume group belongs. CL This displays the CLPR number to which a Parity Group an external volume group belongs. DRIVE_TYPE This displays PRODUCT_ID of the drive configuring the Parity Group.
Options and parameters Option Description -cu_free -cu_free This parameter is used to specify CU free that is specified by Serial#, id#, pid#. < id > is used to set RAID Type, and it can be specified the following strings. XP12000 Disk Array/XP10000 Disk Array:R500, XP24000/XP20000 Disk Array:R600, P9500:R700 < pid> is used to set the path group ID (1-255). -mcu_port Specifies a port number of the MCU.
Options and parameters Option Description [-cu_free ] -cu_free This parameter is used to specify CU free that is specified by Serial#, id#, pid#. < id > is used to set RAID Type, and it can be specified in the following strings. XP12000 Disk Array/XP10000 Disk Array:R500, XP24000/XP20000 Disk Array:R600, P9500:R700 is used to set the path group ID (0-255). Examples Displaying RCU information.
This displays the number of path as minimum. -NP This displays the number of path setting between MCU and RCU. -IM This displays the incident mode setting to RCU. MR: it sends incident to MCU host and RCU host RO: it sends incident only to RCU host If CU free is specified for RCU, "-" is displayed. -FZ This displays the freeze option. D: the freeze option is disable E: the freeze option is enable If CU free is specified for RCU, "-" is displayed.
-PNO This displays the path number. -MPORT This displays the MCU port number. -RPORT This displays the RCU port number. -STS_CD This displays the following status of the path. - NML_01: this means the status of “Normal” in path. - ERR_02: this means the status of “Initialization Failed” in path. - ERR_03: this means the status of “Communication timeout” in path. - ERR_04: this means the status of “Logical Blockade” in path. - ERR_05: this means the status of “Resource Shortage” in path.
Examples For the RCU for which the product number; 64034, the RAID type: P9500 and the path ID: 1 are set, setting the options: the minimum number of paths -4, RIO MIH time15 seconds, and Roud trip time 20 are set. raidcom modify rcu -cu_free 64034 R700 1 -rcu_option 4 15 20 raidcom add rcu_path Adds logical paths to RCUs. This command is executed asynchronously with the command input. Check the completion of this process on the raidcom get command_status command.
Option Description XP12000 Disk Array/XP10000 Disk Array:R500, XP24000/XP20000 Disk Array:R600, P9500:R700 < pid> is used to set the path group ID (1-255). -mcu_port Specifies a Port number on the MCU. -rcu_port Specifies a 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).
In authentication mode, the user executing this command must have permission for the resource group name. Syntax raidcom lock resource -resource_name [-time ] Options and parameters Option Description - resource_name Specifies a name of resource group (max. 32 characters). Only the “meta_resource” group is defined (which cannot be changed). Specify “meta_resource”.
Specify either a pool ID or a pool name. If the specification of both pool ID and pool name is omitted, it will be rejected with EX_REQARG. This command is executed asynchronously with the command input. Check the completion of this process on the raidcom get command_status command.
Using LDEVs:600, 601, and 602, creating a pool of Pool ID: 2, Pool Name: Allocated automatically for Snapshot. # raidcom add snap_pool -pool_id 2 -ldev_id 600 601 602 Using LDEV belonging to the device group: grp1, creating a pool of Pool ID: 1, Pool Name: Allocated automatically for Snapshot. raidcom add snap_pool -pool_id 1 -grp_opt ldev -device_grp_name grp1 raidcom get snap_pool Displays pool information for Snapshot.
H (%) This displays the threshold value for a pool. raidcom add thp_pool Creates a Pool for Thin Provisioning/Smart Tiers. Or, adds a pool volume. A device group can also be specified instead of an LDEV. When specifying a pool that is already created for Snapshot, the specified LDEV is added as a pool volume. Specify either one of pool ID or pool name certainly. If the specification of both pool ID and pool name is omitted, it will be rejected with EX_REQARG.
Option Description When you add a pool volume, this option is ignored even if it is specified. If you want to change the user defined threshold value of the additional pool volume, execute the raidcom modify pool command. Examples By using LDEVs:400, 401, and 402, creating a pool of Pool ID:1, pool name: my_pool for Thin Provisioning.
- POLN: “Pool Normal” (The pool is in the normal status.) - POLF: “Pool Full” (The pool is in the overflow status exceeding the threshold.) - POLS: “Pool Suspend” (The pool is in the overflow status exceeding the threshold and is suspended.) - POLE: “Pool failure” (The pool is suspended in the failure status.) In this status, the pool information cannot be displayed. U(%) This displays the usage rate of the pool.
DEF: The mode in which the start/termination of the monitor is performed by the instruction of the CLI, and the Tier range setting is performed by the automatic calculation of the DKC. AUT: The mode in which the start/termination of the monitor is performed by time specification and the Tier range setting is performed by the automatic calculation of the DKC. Note: AUT cannot be instructed from the CLI. Only performed if displayed when set from the SN2.
Syntax aidcom set hba_wwn -port [] -hba_wwn -wwn_nickname Options and parameters Option Description -port [] Specifies a port number. For example: • CL1-A-g (g: 0-255) • 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)).
raidcom reset hba_wwn -port CL4-E-0 –hba_wwn 210000e0,8b0256f8 raidcom monitor pool Sets the start or stop of performance monitoring of a pool for Smart Tiers. Syntax raidcom monitor pool -pool { | } -operation Options and parameters Option Description -pool { | } Specifies a pool ID (0-127) or a pool name of a pool for Smart Tiers. -operation Instructs the operation of performance monitoring.
Examples Starting the tier reallocation of a pool for Smart Tiers of the Pool: 20. raidcom reallocate pool -pool 20 -operation start Starting the tier reallocation of a pool for Smart Tiers of the Pool Name: my_tier_pool. # raidcom reallocate pool -pool my_tier_pool -operation start Stopping the reallocation of a pool for Smart Tiers of the Pool: 20. raidcom reallocate pool -pool 20 -operation stop Stopping the reallocation of a pool for Smart Tiers of the Pool Name: my_tier_pool.
Either of the following returned values is returned to exit (), which allows users to check the execution results using a user program or a script. • 0: Normal termination • 1: One or more errors occurred. Abnormal termination EX_EWSTOT : Timeout while waiting the result of the command execution raidcom reset command_status Resets the error information of the configuration setting command, which is stored in the DKC and executed asynchronously (Asynchronous command).
Option Description For example: • -ldev_id AB:CD • -ldev_id 43981 • -ldev_id 01:2C-01:31 -port Specifies a port number. Specifies the number of the port whose attribute is ELUN (External). (e.g.) • CL1-A -port Specifies a port number, a host group ID, and a host group name. It cannot be specified when more than 65 characters is set for the host group name. Use the host group ID. (e.g.
Options and parameters Option Description -resource_name Specifies a resource group name. Up to 32 characters can be specified. -ldev_id … Specifies a CU:LDEV hexadecimal address double octet or an LDEV number (0-65279) or a range. For example: • -ldev_id AB:CD • -ldev_id 43981 • -ldev_id 01:2C-01:31 -port Specifies a port number. Specifies the number of the port whose attribute is ELUN (External). (e.g.
6 Support and other resources Contacting HP For worldwide technical support information, see the HP support website: http://www.hp.
In the Storage section, click Disk Storage Systems for hardware or Storage Software for software, and then select your product. HP websites For additional information, see the following HP websites: • http://www.hp.com • http://www.hp.com/go/storage • http://www.hp.com/service_locator • http://www.hp.com/support/manuals • http://www.hp.com/support/downloads • http://www.hp.
Table 21 Document conventions (continued) Convention Element Monospace text • File and directory names • System output • Code • Commands, their arguments, and argument values Monospace, italic text • Code variables • Command variables Monospace, bold text WARNING! CAUTION: IMPORTANT: NOTE: TIP: Emphasized monospace text Indicates that failure to follow directions could result in bodily harm or death. Indicates that failure to follow directions could result in damage to equipment or data.
Glossary AL Arbitrated loop. allocation The ratio of allocated storage capacity versus total capacity as a percentage. Allocated storage refers to those logical devices (LDEVs) that have paths assigned to them. Allocated storage capacity is the sum of the storage of these LDEVs. Total capacity is the sum of the capacity of all LDEVs on the disk array. BC P9000 or XP Business Copy. An HP application that provides volume-level, point-in-time copies in the disk array.
HORCM_MON A section of the RAID Manager instance configuration file that describes the host name or IP address, the port number, and the paired volume error monitoring interval of the local host. instance A running copy of RAID Manager. Instances can be local or remote. Multiple instances can run on the same host. instance configuration file A RAID Manager file that defines the link between a volume and a RAID Manager instance.
synchronous Describes computing models that perform tasks in chronological order without interruption. In synchronous replication, the source waits for data to be copied at the destination before acknowledging that it has been written at the source. takeover The process in which a remote standby disk array takes over processing from the previously active local disk array. TID Target ID. UID Unit identification. V-VOL Virtual Volume. VOL, vol Volume. volume Volume on disk.
Index C contacting HP, 188 conventions document, 189 storage capacity values, 189 text symbols, 190 D document conventions, 189 related information, 188 documentation HP website, 188 providing feedback, 188 H help obtaining, 188 HP technical support, 188 R related documentation, 188 S storage capacity values conventions, 189 Subscriber's Choice, HP, 188 symbols in text, 190 T technical support HP, 188 service locator website, 189 text symbols, 190 typographic conventions, 189 W websites HP , 189 HP Su
