XP7 RAID Manager Reference Guide Abstract This document describes and provides instructions for using RAID Manager (RAID Manager) to configure and perform operations on the RAID storage systems.
© Copyright 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.
Contents 1 Overview of commands............................................................................14 Summary of commands...........................................................................................................14 Data management commands.............................................................................................14 Configuration setting commands..........................................................................................15 Subcommands...................
Examples..........................................................................................................................61 paircurchk (for Continuous Access Synchronous).........................................................................63 Syntax..............................................................................................................................65 Options and parameters....................................................................................................
Syntax..............................................................................................................................94 Options and parameters.....................................................................................................94 Returned values.................................................................................................................94 Error codes.............................................................................................................
Arguments......................................................................................................................114 Example.........................................................................................................................114 4 Command tools......................................................................................116 inqraid................................................................................................................................
Syntax............................................................................................................................144 Options and parameters...................................................................................................144 Example.........................................................................................................................144 raidcom check_ext_storage external_grp..................................................................................
raidcom add journal.............................................................................................................155 Syntax............................................................................................................................155 Options and parameters...................................................................................................155 Examples.................................................................................................................
Options and parameters...................................................................................................180 Examples........................................................................................................................180 raidcom get lun....................................................................................................................180 Syntax..................................................................................................................
Syntax............................................................................................................................194 Options and parameters...................................................................................................194 Example.........................................................................................................................195 raidcom delete rcu.......................................................................................................
raidcom get thp_pool............................................................................................................207 Syntax............................................................................................................................207 Options and parameters...................................................................................................207 Examples.................................................................................................................
Examples........................................................................................................................218 raidcom modify snapshot......................................................................................................219 Syntax............................................................................................................................219 Options and parameters...............................................................................................
HP websites....................................................................................................................231 Conventions for storage capacity values..................................................................................231 Typographic conventions.......................................................................................................231 Glossary..................................................................................................233 Index..........
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 Remote Web Console computers. This document describes and provides the specifications for the RAID Manager commands.
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.
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.
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.
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.
Typographic conventions for command format This document uses the following terminology conventions for command format. Note that if you specify the parameter that is not described in the options and parameters of the command, the parameter will be ignored. Convention Description Bold Indicates text on a window, other than the window title, including menus, menu options, buttons, fields, and labels. Example: Click OK.
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.
Figure 1 Usable characters for RAID Manager commands Differences between RAID Manager and Remote Web Console 21
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.
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
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.
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.
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 In Continuous Access Synchronous Z, when you specify the number less than or equal to 3, the copy pace is 3 tracks. When you specify the number more than or equal to 4, the copy pace is 15 tracks. In Business Copy, when you specify 1 or 2, the copy pace is slow, when you specify 3, the copy pace is medium, and when you specify 4, the copy pace is fast. -nocopy Creates paired volumes without copying data when the data consistency of simplex volumes is assured by the user.
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.
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. For XP7, specify the number of which 300,000 is added to the serial number for . -ds : The following options can be specified for cascading S-VOL. -d[g]s [MU#] ...
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. If the command fails, the detailed status is logged in the RAID Manager command log ($HORCC_LOG), even if the user script has no error handling.
that can be registered to the storage system is 128 (from 0 to 127 for group ID). If registered over 128, the pair creation will be terminated with EX_ENOCTG error. Examples Example 1 The following figure shows an example of creating a cascading configuration with -g and -gs option from the local node (takeover node). Figure 4 Creating a cascading configuration from the local node Example 2 The following figure shows an example for creating a suspended journal volume.
Figure 6 Takeover example used to suspend a journal volume pairsplit The pairsplit command is used to split volume pairs. This command stops updates to the secondary volume of a pair and can either maintain (status = PSUS) or delete (status = SMPL) the pairing status of the volumes. The pairsplit command can be applied to a paired logical volume or a group of paired volumes. The pairsplit command allows read access or read/write access to the secondary volume, depending on the selected options.
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 #> values can be specified in hexadecimal (add the '0x' prefix) or decimal notation. For XP7, specify the number of which 300,000 is added to the serial number for . -r or -rw Continuous Access Synchronous/Continuous Access Synchronous Async/Continuous Access Journal only. Specifies a mode of access to the SVOL after paired volumes are split. The -r option (default) allows read-only to the SVOL. The -rw option enables read and write access to the SVOL.
Option Description (far site). The target remote copy volume must be a P-VOL, or '-R[S][B]' option can be specified on SVOL. -FMRCF [MU#] or -FBC [MU#] Forcibly specifies a cascading local copy volume for specified volume pair on remote copy environment. If the -l option is specified, a cascading local copy volume is split on a local host (near site). If -l option is not specified, a cascading local copy volume is split on a remote host (far site).
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. 229 EX_INVVOL Invalid volume status Confirm volume status/attribute using pairdisplay -l or 'raidvchkdsp -v aou'.
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.
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.
Option Description (-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. The values can be specified in hexadecimal (add the '0x' prefix) or decimal notation. For XP7, specify the number of which 300,000 is added to the serial number for .
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.
Option Description to 255 seconds. If this option is not specified, 90 seconds is set as default. For Continuous Access Journal, o-time cannot be specified. If you want to change the value for offloading timer, use the raidcom modify journal command. If you do not change the value by executing the raidcom modify journal command, 60 seconds is set as default. If o-time=0 is specified, the inflow of Write I/O becomes invalid.
Returned values The pairresync command sets the following returned values during exit allowing you to check the execution results. Normal termination: 0. When resynchronizing groups, 0 = normal termination for all pairs. Abnormal termination: other than 0, refer to the error codes for error details. Error codes Unrecoverable errors are fixed and not resolved, even after re-executing the command.
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.
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. The primary volume's server is automatically 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.
Option Description -d[g] Searches whether the specified raw_device is included in a group on the configuration definition [MU#] 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.
Table 10 pairevtwait Returned Values Condition Value When the -nowait 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 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.
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 & SVOL_COPY state of Business Copy/Snapshot 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.
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.
Option Description -D Selects the default report mode. In the default mode, if there is pair status transition information to be reported, one event is reported and the event is reset. If there is no pair status transition information to be reported, the command waits. The report mode consists of the three flags: -allsnd, - resevt, and -nowait options. -allsnd Reports all events if there is pair status transition information.
Table 12 Results of pairmon command options (continued) -D -nowait -resevt -allsnd Actions Invalid -nowait - -allsnd When HORCM does not have an event, this option reports event nothing. If one or more events exist, then it reports all events. 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.
Option Description notation. For XP7, specify the number of which 300,000 is added to the serial number for . -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.
Table 13 pairvolchk returned values (continued) Condition Value For Continuous Access 42: The status is PVOL_COPY. Synchronous Async 43: The status is PVOL_PAIR. and Continuous 44: The status is PVOL_PSUS. Access Journal 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.
Examples Example 1 Display example for Business Copy/Snapshot: # 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.
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.
Figure 21 Example of -FHORC option for pairvolchk Figure 22 Example of -FMRCF option for pairvolchk The following table shows the pairvolchk group status.
Table 14 pairvolchk group status (continued) Option COPY/RCPY PSUE PDUB PFUS PSUS PFUL PAIR Group status not-exist not-exist not-exist not-exist exist not-exist not-exist PSUS exist : the target status existing in the group not-exist : the target status not existing in the group Note: This option can be used only when 'pairvolchk -s' has the variable, USE_OLD_VCHK.
Option Description -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 displays status of a cascading remote 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.
Option Description horc0 ... 63528 - 64.S-VOL COPY,----- 65 - - N - - 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 pair splitting with specifying the consistency group volumes using Business Copy.
Option Description 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 -v ctg This option finds the CT group for each local and remote interconnected to the group via the specified group or , and displays any information of each CT group corresponding the local and remote. The first line shows the CT group information for the local host, second line shows the CT group information for the remote host.
Option Description 127 POLN 0 864 80 6 3000 3000 63528 2 # pairdisplay -g VG01 -v pid -l PID POLS U(%) SSCNT Available(MB) Capacity(MB) LDEV# H(%) 127 POLN 864 80 0 6 3000 Seq# Num 3000 63528 2 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.
Display example for -m cas: # pairdisplay -g oradb -m cas Group PairVol(L/R) (Port#,TID,LU-M), Seq#, P-LDEV# M oradb oradev1(L) (CL1-D , 3, 0-0) ----- ---oradb oradev1(L) (CL1-D , 3, 0) 30053 268 oradb1 oradev11(R) (CL1-D , 3, 2-0) 30053 270 oradb2 oradev21(R) (CL1-D , 3, 2-1) 30053 272 W oradb oradev1(R) (CL1-D , 3, 2) ----- 266 Display examples for -m all: # pairdisplay -g oradb -m all Group PairVol(L/R) (Port#,TID,LU-M), Seq#, P-LDEV# M oradb oradev1(L) (CL1-D , 3, 0-0) ---- ------------(L) (CL1-D , 3, 0
(Port#,TID,LU-M) (Business Copy/Snapshot) = port number, TID, LUN, and MU number as described in the configuration definition file. Seq# = serial number of the RAID storage system For XP7, the number of which 300,000 is added to the serial number is displayed.
command. The paircurchk command assumes that the target is an S-VOL. If the paircurchk command 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. The paircurchk command is also executed as part of the horctakeover command (see next section).
Syntax paircurchk { -h | -q | -z | -I[H][M][instance#] or I[TC][SI][instance#] | -g | -d | -d[g] [MU#] | -d[g] [MU#] | -nomsg } 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.
Table 16 Specific error code for paircurchk Category Error Code Error Message Recommended Action Volume status EX_VOLCUR S-VOL currency error Check volume list to see if an operation 225 was directed to the wrong S-VOL. (Unrecoverable) Value Examples The following shows an example of the paircurchk command for a group and the resulting display of inconsistent volumes in the specified group.
Option Description -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. -d[g] Searches whether the specified raw_device is included in a group on the configuration definition [MU#] file (local instance). If it is in the group, the target volume is executed as the paired logical volume (-d) or group (-dg).
Table 17 Specific error codes for horctakeover Category Error Code Error Message Volume status EX_ENQVOL Unmatched volume Confirm status using 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. 229 EX_EVOLCE Pair Volume combination error Confirm pair status using pairdisplay, and change combination of volumes.
Option Description This option must be specified if '-find' or '-pd 'option is not specified. [hgrp] is specified 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. This option finds Seq# and port_name of the storage system to which the specified device can be connected, and scans the port of the storage system which corresponds with the unit ID that searches the unit ID from Seq#.
Option Description CL1-C 30053 2 269 3 30053 1 261 P-VOL PAIR NEVER -m This option is used for displaying only the specified mirror descriptor. If you want to display all mirror descriptor, specify '-m all' for displaying all MUs. -pi Changes a strings via STDIN for -find option to ''. If this option is specified, the -find option is ignored a raw device file provided via STDIN, and is used as input. A must be specified within 255 characters.
Option Description • PORT: Displays the port number (port#) defined in the configuration definition file. • TARG: Displays the targetID (TargetID) defined in the configuration definition file. • LUN: Displays the LUN (LU#) defined in the configuration definition file. • M: Displays the MUN (MU#) defined in the configuration definition file. MU# for Continuous Access Synchronous are shown as '-', and MU# for Business Copy/Snapshot are shown as '0', '1', '2'.
Option Description #dev_group dev_name port# TargetID LU# MU# # /dev/rdsk/c23t0d0 SER = 61456 LDEV = 192 [ FIBRE FCTBL = 4 ] ORA ORA_000 CL2-J 0 0 0 # /dev/rdsk/c23t0d1 SER = 61456 LDEV = 193 [ FIBRE FCTBL = 4 ] ORA ORA_001 CL2-J 0 1 0 # /dev/rdsk/c23t0d2 SER = 61456 LDEV = 194 [ FIBRE FCTBL = 4 ] ORA ORA_002 CL2-J 0 2 0 # /dev/rdsk/c23t0d3 SER = 61456 LDEV = 195 [ FIBRE FCTBL = 4 ] ORA ORA_003 CL2-J 0 3 0 # ERROR [CMDDEV] /dev/rdsk/c23t0d7 SER = 61456 LDEV = 259 [ OPEN-3-CM ] If the target device has shar
Option Description (2) The option cannot be specified the device object name as follows: D:\Vol(Dms,Dmt,Dmr)X\DskY,\Vol(Dms,Dmt,Dmr)X\DskY (3) Sync executes the following behavior under any conditions: • If the logical drive which corresponds to a [-g ] is not open by any applications, then sync flushes the system buffer to a drive and makes the dismount state for this drive.
PORT: Displays the RAID storage system port number TARG: Displays the target ID (that was converted by the fibre conversion table) LUN: Displays the LUN (that was converted by the fibre conversion table) SERIAL: Displays the production (serial#) number of the RAID storage system For XP7, the number of which 300,000 is added to the serial number is displayed.
Option Description -pd[g] Allows designation of an LDEV by raw device file name. The -pdg option is used to show a LUN on the host view by finding a host group (XP1024/XP128 Disk Array and later). -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.
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#] -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.
HORCM_ver: This column shows the version of the HORC Manager on the local or remote host. The -l option specifies local host. The -r option specifies remote host. Uid Serial# Micro_ver: This column shows unitID, serial number, and (DKCMAIN) microcode version of the storage system which is connected to the local or remote host. The -l option specifies local host. The -r option specifies remote host. For XP7, the number of which 300,000 is added to the serial number is displayed.
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 Specifies a group name written in the configuration definition file. -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.
Option Description The following values are available to specify on [type]. • inv: The target volumes are concealed from SCSI Inquiry command by responding 'unpopulated volume'. • sz0: The target volumes replies with 'SIZE 0' through SCSI Read capacity command. • rwd: The target volumes are prohibited from reading and writing. • wtd: The target volumes are prohibited from writing. • svd: If the target volume is SMPL, it is protected from paircreate (from becoming an SVOL).
raidvchkset -g oralog -vt redo8 Sets volumes in oradat group as data file that Oracle block size is 8KB: raidvchkset -g oradat -vt data8 -vs 16 Sets volumes in oradat group as data file that Oracle block size is 16KB: raidvchkset -g oradat -vt data8 -vs 32 Releases all checking to volumes in oralog group: raidvchkset -g oralog -vt Sets Oracle10g volumes for oralog group as redolog file: raidvchkset -g oralog -vt rd10g Sets Oracle10g volumes for oradat group as data file with block size of 8KB: raidvchk
Option Description the 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.
Option Description Note: If there have not been any changes to the specified volumes, this option displays nothing. For XP7, the number of which 300,000 is added to the serial number is displayed. -v [op] Specifies the following operation that displays each parameter for validation checking: • cflag: Displays all flags for checking regarding data block validation for target vols.
• BH = Mapped E-lun as hidden from the host, but LDEV blockading. • BV = Mapped E-lun as visible to the host, but LDEV blockading. • B = Unmapped to the E-lun, but LDEV blockading. E-Seq#: production (serial) number of the external LUN ('Unknown' shown as '-'). For XP7, the number of which 300,000 is added to the serial number is displayed. E-LDEV#: LDEV# of the external LUN ('Unknown' shown as '-').
R=D: Checking for CHK-F1 on Read is disabled. W=E: Checking for CHK-F1 on Write is enabled. W=D: Checking for CHK-F1 on Write is disabled. B=E: Checking for CHK-F1 in the data block #0 is enabled. B=D: Checking for CHK-F1 in the data block #0 is disabled. S=E: Referring for CHK-F1 flag contained in the data block is enabled. S=D: Referring for CHK-F1 flag contained in the data block is disabled.
D: Disabled for Read command. W=E: Enabled for Write command. D: Disabled for Write command. S=E: Enabled for becoming the SVOL. D: Disabled for becoming the SVOL. PI-C-R-W-S: Displays the permission flags that show whether each mode flag can be changed to enable or not. I=E: 'I' flag can be changed to enable. D: 'I' flag cannot be changed to enable. C=E: 'C' flag can be changed to enable. D: 'C' flag cannot be changed to enable. R=E: 'R' flag can be changed to enable.
70 AOU 70 1 AOU_002 CL2-D 2 10 62500 170 110000 1100000 10 1 Output of the raidvchkdsp command with the -v aou option: Used(MB): Displays the usage size of the allocated block on this LUN. Range: 0 ≤ Used (MB) < LU_CAP(MB) + 42 MB 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.
Option Description -pdg (XP1024/XP128 Disk Array and later): Shows a LUN on the host view by finding a host group. -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. This option scans the port specified by '-p ' option of the storage system which corresponds with the unit ID that searches the unit ID from Seq#.
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. R: This shows the Reject that Read/Write is rejected when validation error is detected. MR-W-B: Displays the flags for checking regarding CHK-F3 in the data block. R =E: Checking for CHK-F3 on Read is enabled. D: Checking for CHK-F3 on Read is disabled. W =E: Checking for CHK-F3 on Write is enabled. D: Checking for CHK-F3 on Write is disabled.
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.
R=E: 'R' flag can be changed to enable. D: 'R' flag cannot be changed to enable. W=E: 'W' flag can be changed to enable. D: 'W' flag cannot be changed to enable. S=E: 'S' flag can be changed to enable. 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'.
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 raidvchkscan 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.
• P(S)JSN: This means 'P(S) Journal Volume is suspended in Normal status'. • PJNF: This means 'P(S) Journal Volume is in Full status'. • P(S)JSF: This means 'P(S) Journal Volume is suspended in Full status'. • P(S)JSE: This means 'P(S) Journal Volume is suspended by an error (including link failures)'. • AP: Displays the following two conditions (status) according to the pair status. Shows the number of active paths on the initiator port in Continuous Access Journal links.
Table 19 Detailed Status of the Journal Volume JNLS P-JNL Other Information S-JNL SMPL Description QCNT AP 0 - Configured as journal volume, but NOT pair N - Deleting the journal volume 0 - Normal state of the journal volume without data PJNN SJNN (PJNS) (SJNS) 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 -
Syntax raidvchkscan { -h | -q | -z | -I[H][M][instance#] or I[TC][SI][instance#] | -v pid[a][s] [unit#] | [ -s ] | [ -f[x ] | } 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 shut down, interactive mode terminates.
U(%): Displays the usage rate of the Fast Snap/Snapshot/Thin Provisioning pool. SSCNT: Displays the number of Fast Snaps/Snapshot volume in Fast Snap/Snapshot pool or the total number of Thin Provisioning volumes mapped in this Thin Provisioning pool. Available(MB): Displays the available capacity for the volume data on the Fast Snap/Snapshot/Thin Provisioning pool. Capacity(MB): Displays the total capacity in the Fast Snap/Snapshot/Thin Provisioning pool.
Options and parameters Option Description inst Specifies the HORCM instance number (range= from 0 to 2047). When this option is specified, the horcmstart shell script sets the environment variables (HORCMINST, HORCM_CONF, HORCM_LOG, HORCM_LOGS) corresponding to the instance number, and starts the specified HORCM instance. (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.
Options and parameters Option Description inst Specifies the HORCM (RAID Manager) instance number (range= from 0 to 2047). When this option is specified, the command stops the specified HORCM instance. When this option is not specified, the command refers to the instance (environment variable HORCMINST) of the execution environment of this shell script and stops the following the HORCM instance.
Option Description -d Interprets the control options following this option (-l , -b , -s , and -t ) as the parameters of the RAID Manager commands. -c Interprets the control options following this option (-l , -b and -t ) as the parameters of the HORC Manager (HORCM). -l Sets the trace level (range = 0 to 15). If a negative value is specified, the trace mode is canceled. A negative value 'n' must be specified as '--n'.
stopping the APP. The granularity of either a logical volume or volume group can be specified with this command. Syntax horctakeoff | -h | -q | -z | -I[H][M][instance#] or I[TC][SI][instance#] | -g[s] | -d[s] | -d[g][s] [MU#] | -d[g][s] [MU#] | -jp | -js | [-t ]| -nomsg } Options and parameters Option Description -h Displays Help/Usage and version information. -q Terminates the interactive mode and exits the command.
Returned values The horctakeoff command sets the following returned values during exit allowing you to check the execution results. Normal termination: 0 Abnormal termination: The horctakeoff command returns the following error codes as well as generic error. Error codes Unrecoverable error should have been done without re-execute by handling of an error code.
Example 2 horctakeoff command on L2 local site # horctakeoff -g G1 -gs G3 horctakeoff : 'pairsplit -g G1 -S -FHORC 1' is in progress. horctakeoff : 'pairsplit -g G1' is in progress. horctakeoff : 'pairsplit -g G3 -S' is in progress. horctakeoff : 'paircreate -g G1 -gs G3 -FHORC 1 -nocopy -f async -jp 0 -js 1' is in progress. horctakeoff : 'pairsplit -g G1 -FHORC 1' is in progress. horctakeoff : 'pairresync -g G1' is in progress. horctakeoff : 'pairresync -g G1 -FHORC 1' is in progress.
horctakeoff command on L2 remote site # horctakeoff -g G1 -gs G3 horctakeoff : 'pairsplit -g G3 -S' is in progress. horctakeoff : 'pairsplit -g G1' is in progress. horctakeoff : 'pairsplit -g G1 -FHORC 1 -S' is in progress. horctakeoff : 'paircreate -g G3 -vl -nocopy -f async -jp 0 -js 1' is in progress. horctakeoff : 'pairsplit -g G3' is in progress. horctakeoff : 'pairresync -g G1' is in progress. horctakeoff : 'pairresync -g G3' is in progress. horctakeoff : horctakeoff done.
Figure 24 Synchronization for Continuous Access Synchronous Async/Continuous Access Journal Syntax pairsyncwait{ -h | -q | -z | -I[H][M][instance#] or I[TC][SI][instance#]| -g | -d | -d[g] [MU#] | -d[g] [MU#]| -m | -t | -nowait | -nomsg | -fq } Options and parameters Option Description -h Displays Help/Usage and version information. -q Terminates the interactive mode and exits the command.
Option Description specified LDEV is contained in two or more groups, the command is executed on the first group. The values can be specified in hexadecimal (add the '0x' prefix) or decimal notation. For XP7, specify the number of which 300,000 is added to the serial number for . -m Specifies the sequence # of MCU PVOL in 10-digit hexadecimal, called the Q-marker.
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).
Remaining data in CT group = Sidefile capacity * Sidefile percentage / 100 Sidefile percentage is the rate showed to '%' column with 'PAIR' state by pairdisplay command. Sidefile capacity is the capacity within 30% to 70% of the cache setting as the sidefile.
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.
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.
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]...
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'.
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.
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 ...
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.
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.
raidscan[HOMRCF]: raidscan[HORC]: -x usetenv HORCC_MRCF Environment variable subcommands 115
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.
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. For XP7, the number of which 300,000 is added to the serial number is displayed for Serial#.
Option Description Example: C:\HORCM\etc>inqraid -CLI $Vol -fv 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.
Option Description c1t0d0 CL1-E 63516 0 0 0 - - OPEN-9-CM c1t0d1 CL1-E 63516 12288 0 0 1 11605 OPEN-3 c1t0d2 CL1-E 63516 12403 0 0 3 11605 OPEN-9 c1t0d3 CL1-E 63516 12405 0 0 10 11605 OPEN-E 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.
Option Description • DYNIX: /dev/rdsk/sd* or sd* for only unpartitioned raw device • IRIX64: /dev/rdsk/*vol or /dev/rdsk/node_wwn/*vol/* or /dev/dsk/*vol or /dev/dsk/node_wwn/*vol/* • OpenVMS: $1$* or DK* or DG* or GK* • 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 HP XP7 RAID Manager User Guide.
Tru64 UNIX system: # ls /dev/rdisk/dsk* | ./inqraid /dev/rdisk/dsk10c -> [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 /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 | .
LDEV Mapping Display Formats Unmapped UNMAP[Group 00000] 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.
c23t0d0 c23t2d3 0 horc1 0 horc1 dev00 S-VOL SSUS dev10 S-VOL SSUS c23t0d1 c23t2d2 0 P-VOL PSUS OK 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 (PVOL or SVOL or simplex). Stat: Status of the paired volume. R_DEVICE: Device file name of remote site.
Example 6: inqraid with -cliwp and -cliwn options (HP-XP shown) # 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 LDEV PRODUCT_ID 30015 2054 OPEN3-CVS DEVICE_FILE: Displays the device file name only.
for SVOL, but a Device object (\Device\HarddiskVolume#) and Volume{guid} is created by using -svinf option after splits the SVOL. 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.
/dev/rdsk/c23t0d2 ORA ORA_002 CL2-J 0 2 0 61456 /dev/rdsk/c23t0d3 ORA ORA_003 CL2-J 0 3 0 61456 /dev/rdsk/c23t0d4 ORA ORA_004 CL2-J 0 4 0 61456 /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 194 195 256 257 258 259 <=Verify configuration and log files.
• 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
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: "prints..." is used to print to the strings buffer of '@0*'.
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.
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.
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 “With using the rmawk command examples” (page 173).
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.
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 “raidcom add copy_grp” (page 140) and later.
Option Description [ -checkmode < check Specifies when executing Precheck function (execute checking commands only). It specifies the mode> ] following value. 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.
-ldev_id 300 -cnt 6 -ldev_id 300 301 302 303 304 305 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.
(d) Creating a device group # raidcom add device_grp -device_grp_name DevG2 dev101 -ldev_id 101 105 201 # raidcom add device_grp -device_grp_name DevG2 dev101 -ldev_id 101-105 # 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 Specifying and displ
• reset • reallocate • monitor The following examples show locking resource groups, executing commands, and then unlocking resource groups. 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.
Res.
Res.
Res.
Option Description If this option is omitted (by raidcom get copy_grp), "-" is displayed. Example 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. Syntax raidcom delete copy_grp -copy_grp_name Options and parameters Option Description -copy_grp_name
raidcom add device_grp Assigns a device name to the specified LDEV, and creates a device group. If the group already 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.
Option Description Up to 64 of LDEVs can be specified. When you specify an LDEV in a LUSE volume, the number of LDEVs in the LUSE volume is included. [-cnt ] Specifies the count (2-64). If this option is omitted, the count is set to one. Example Deleting the LDEV400 from the device group: grp1. # raidcom delete device_grp -device_grp_name grp1 -ldev_id 400 raidcom get device_grp Displays the LDEV information for the specified device group, or lists all device groups.
Syntax raidcom add external_grp -path_grp -external_grp_id -port -external_wwn -lun_id [-emulation ][-clpr ] 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.
An LDEV or device group can be specified instead of an external volume group. • If an LDEV is specified, RAID Manager finds the external volume groups to which the specified LDEV belongs and displays the result. • If a device group is specified, RAID Manager finds the external volume groups to which the specified device group belongs and displays the result. If no LDEV exists in the external volume, the command is rejected with EX_ENOOBJ.
Options and parameters Option Description -external_grp_id Specifies the external volume group number (gno:1-16384, sgno:1-4096). For example: • 52-11 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.
Disconnect the connection to the external volume group including the LDEV belonging to the device group: grp1. # raidcom disconnect external_grp -grp_opt ldev -device_grp_name grp1 raidcom get external_grp Displays the information of registered external volumes. 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).
GROUP: external volume group number. P_NO: partition number in this external volume group. LDEV#: LDEV number assigned to this external volume group. STS: displays the following status. - NML: an LDEV is installed. - REG: an LDEV is being created. - 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.
Examples Turning the cache mode of the External Volume Group#01-01 ON. # raidcom modify external_grp -external_grp_id 01-01 -cache_mode y Enabling the Cache Inflow Control mode of the External Volume Group#01-01 ON. # raidcom modify external_grp -external_grp_id 01-01 -cache_inflow y Changing the MP blade ID of the External Volume Group#01-01 to "3".
raidcom add host_grp Creates a host group on the specified port. If the specified port does not exist, the command is rejected with EX_ENOOBJ. If the specified port/host group already exists, the existing host group name is changed to the specified host group name. The specified host group name must be unique in a port. Syntax raidcom add host_grp -port -host_grp_name Options and parameters Option Description -port Specifies the port number and the host group ID.
raidcom get host_grp Displays the information about all host groups that are defined on the specified port. Syntax raidcom get host_grp -port [] [-key ] 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.
HMD: Displays the following HOST MODE for the host adapter setting on host group. • HP-XP, SOLARIS, AIX, WIN, LINUX/IRIX, TRU64, DYNIX, OVMS, NETWARE, HI-UX • VMWARE, HP-XP, VMWARE_EX, WIN_EX, Ext Stor HMO_BITs: Displays the host mode options of the host group. For details, see the section Creating host groups and registering hosts in host groups (in a Fibre Channel environment) in the HP XP7 Provisioning for Open Systems User Guide.
Examples Setting the host mode: HP-XP for the port: CL4-E, the host group: #2. # raidcom modify host_grp -port CL4-E-2 -host_mode HP-XP Setting the host mode: HP-XP and the host mode option: 2, 13 for the port: CL4-E, the host group: #2. # raidcom modify host_grp -port CL4-E-2 -host_mode HP-XP -host_mode_opt 2 13 Clearing the host mode options of the host mode: HP-XP of the port: CL4-E, the host group: #2.
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: • CL1-A-g (g is from 0 to 254) • CL1-A Linux_X86 -hba_wwn Specifies the WWN value (hexadecimal value) of the host adapter. For example: • 210000e08b0256f8 • 210000e0,8b0256f8 (The value can be split in units of 4 bytes by "," (commas).
raidcom add journal Registers (adds) a volume to a journal. This makes a Journal for "Open System" or "M/F System" to the specified LDEVs. If the journal already exists, the specified LDEV is added to the journal. If the journal does not exist, you must create it first, and then add an LDEV. If the -timer_type option is specified, this command makes a journal as "M/F System". If not, this command makes a journal as "Open System". A device group can also be specified instead of an LDEV.
Creating a journal #1 of LDEVs: 265, 266, 267, and 278. # raidcom add journal -journal_id 1 -ldev_id 265 266 267 268 Creating a journal #1 with an LDEV belonging to the device group: grp1. # raidcom add journal -journal_id 1 -grp_opt ldev -device_grp_name grp1 Example for mainframe: Creating a journal #1 with LDEVs: 265, 266, 267, and 278. As a timer type, the system clock of the mainframe host is used.
raidcom get journal Displays the information of registered journal. Syntax Displaying journal information raidcom get journal [-key ] Displaying timer related information raidcom get journalt Options and parameters Option Description [-key ] Specifies the display keyword. Specify opt as . Examples Displaying journal information.
AP: Number of active link paths of Continuous Access Journal. U(%): Usage rate of journal volumes assuming the entire relevant volume is 100%. Q-Marker: The PVOL journal volume shows the newest sequential number (Q-marker) at the time of receiving WRITE data. The SVOL journal volume shows the newest sequential number (Q-marker) written to the cache. Q-CNT: Number of Q-markers remaining in the PVOL journal volume. D-SZ(BLK): Capacity of the data block size of the journal volume in units of 512 bytes.
Syntax When changing the data overflow watching time of journal data area, path blocked watch or the timer type, specify more than one option. # raidcom modify journal -journal_id {[-data_overflow_watch
Examples Changing the data overflow watch time for journal "6" to 15 seconds. # raidcom modify journal -journal_id 6 -data_overflow_watch 15 Changing the settings for journal 6: data overflow watch time to 15 seconds, and the timer type to the system clock of the mainframe host . # raidcom modify journal -journal_id 6 -data_overflow_watch 15 -timer_type system Changing the the MP blade ID for journal "6" to 2.
Option Description If you specify -tse_ldev_id option, the volume is the same as the volume used by FlashCopy SE. When using -tse_ldev_id option, you must create the virtual volumes in Thin Provisioning Z. Examples: • -ldev_id 200 • -tse_ldev_id 400 -capacity Specifies the capacity. The size can be specified in bytes or LBAs. When specifying bytes, the unit is t/T (terabyte), g/G (gigabyte), m/M (megabyte), or k/K (kilobyte). If this option is omitted, block (512KB) is used.
Option Description • 6586-G, 6586-J, 6586-K, 6586-KA, 6586-KB, 6586-KC • 6588-1, 6588-3, 6588-9, 6588-3A, 6588-3B, 6588-3C, 6588-9A, 6588-9B, 6588-9C, 6588-L, 6588-LA, 6588-LB, 6588-LC Some emulation types cannot be specified depending on the emulation type. Caution: You can specify 3390-3 or 3390-3R as the emulation type, but these are unable to be mixed.
Options and parameters Option Description -ldev_id (0-65279) Specifies the LDEV number (0-65279). For example: -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. • -ldev_id 200 -device_grp_name
Option Description -capacity 1G, -capacity 1g, -capacity 1024M, -capacity 1024m, -capacity 1048576K, -capacity 1048576k, -capacity 2097152 -offset_capacity Specifies capacity. Corrects the size as well as GUI for the specified capacity. The capacity can be specified in bytes or blocks. -cylinder Specifies the size in cylinder unit. When specifying, the unit is g/G (gigabyte), m/M (megabyte), or k/K (kilobyte). Cylinder is applied if you do not specify the unit.
Option Description -ldev_list Specifies the type of LDEVs to display. Specify one of the following LDEV list options. • defined: Displays all implemented LDEVs. • thp_volume: Displays LDEVs that have Thin Provisioning attributes. Combining this with -pool_id specification displays LDEVs that have Thin Provisioning attributes related to the specified POOL. • external_volume: Displays external volumes. • undefined: Displays all LDEV numbers that are not implemented.
Option Description The following strings are specified in the .
Option Description The following strings are specified in the .
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
PORTs: ports defined to the paths for the relevant LDEV. It lists up the ports defined to the paths for the relevant LDEV. When the relevant LDEV is a mainframe volume or a multiplatform volume without the LU path definition, the port number of the dummy LU is displayed. F_POOLID: pool ID if the LDEV is a component of the pool. In other cases, "NONE" is displayed. VOL_ATTR: attributes of the LDEV.
• ◦ BSY: Status is changing ◦ NONE: unknown state (not supported) OPE_TYPE: current operation. ◦ FMT: Formatting ◦ QFMT: Quick formatting ◦ CCOPY: Data copying (Correction copy / Copy back / Drive copy / Dynamic sparing) ◦ 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.
(The command fails if the FMT does not change (is not complete) in the 30 seconds.) 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.......
E_PORTs : CL2-H-0 1 50060e8006fc1f37 LDEV_NAMING : STS : NML OPE_TYPE : NONE OPE_RATE : 100 MP# : 2 SSID : 103F QRDID : 16 Description of a column in output example QRDID: The ID of the Quorum Disk for ESAM.
Used_Block(BLK): Number of blocks used in the pool. 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.
64558 0 64558 2100 64558 546 29441 0 0 0 0 29442 0 0 0 0 29443 0 0 0 0 OPEN-V-CVS 10924032 73 CVS|HDP|HDT 1092 4032 E 6 5334 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.
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. # raidcom initialize ldev -operation shrd 0x55aa55aa -ldev_id 200 Stopping Shredding.
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.
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.
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.
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.
Options and parameters Option Description -port Specifies the Port number. It specifies a port of which attribute is 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).
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.
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 path 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.
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).
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).
1 1-1 NML E D 2 CL2-A 50060e8005fa0f38 2 3 NML 60010 VSP PHG 5 5 5 5 GROUP STS CM IF MP# PORT WWN PR LUN PHS 1-1 NML E D 0 CL3-B 50060e8006fc3222 1-1 NML E D 0 CL5-A 50060e8006fc4150 1-2 NML E D 2 CL3-B 50060e8006fc3222 1-2 NML E D 2 CL5-A 50060e8006fc4150 N Serial# PRODUCT_ID LB PM 1 0 NML 64562 VSP N M - - UNK 64562 VSP N M - - UNK 64562 VSP N A 1 0 NML 64562 VSP N A Description of each column in output example: PHG: Displays the path group number for the external volume.
- S: Single path mode - A: APLB mode - AL: ALUA mode - MA: Multiple path mode (changeable to ALUA mode) - SA: Single path mode (changeable to ALUA mode) raidcom delete pool Deletes the specified Pool for Fast Snap, Snapshot, Thin Provisioning, Thin Provisioning Z, and Smart Tiers, and Smart Tiers Z. When LDEVs or device groups are specified, LDEVs are deleted from the specified pools. This command is executed asynchronously with the command input.
Options and parameters Option Description [-key ] Specifies when displaying a pool name. Specify "opt" as the . Examples Displaying pool information. # raidcom get pool PID POLS U(%) SSCNT Available(MB) Capacity(MB) Seq# Num LDEV# H(%) 001 POLN 10 330 10000000 1000000000 62500 2 365 80 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.
• NT: The pool for Fast Snap is in the normal status. • ST: The pool for Fast Snap is shrinking or rebalancing. raidcom modify pool Sets the options of a pool for Fast Snap, Snapshot, Thin Provisioning, Thin Provisioning Z, and Smart Tiers, and Smart Tiers Z. When the -status option is specified, the operation is executed asynchronously with the command input. Check the completion of this process on the raidcom get command_status command.
Option Description -pool_attribute Specifies when changing the pool from Thin Provisioning/Thin Provisioning Z to Smart Tiers/Smart Tiers Z, or from Smart Tiers/Smart Tiers Z to Thin Provisioning/Thin Provisioning Z. Specifies the following value depend on the type of pool desired to be changed. • smart_manual: Changes the pool from Thin Provisioning/Thin Provisioning Z to Smart Tiers/Smart Tiers Z. It is changed to manual relocation.
Syntax raidcom rename pool -pool_id -pool_name Options and parameters Option Description -pool_id Specifies a pool ID (0-127). If a -pool_id option is non-numeric, the specified value is recognized as a pool name to identify the pool ID. -pool_name Specifies a new pool name. You can specify up to 32 characters. The -pool_name option cannot be specified by configuring only in numeric because numeric values are preferentially identified as a pool ID.
PORT: Displays the port numbers. TYPE: Displays the following package type on a port: FIBRE, SCSI, ISCSI, ENAS, ESCON, FICON, FCoE ATTR: Displays the following attribute setting on a port. One of the following items is displayed. • TAR: Fibre target port (target port) • MCU: MCU initiator port (initiator port) • RCU: RCU target port (RCU target port) • ELUN: External initiator port (External port) SPD: Displays the transfer rate setting on a port.
VP_I: Displays the virtual port index (zero is currently displayed). FCF_I: Displays the FCoE index (zero is currently displayed). raidcom modify port This sets the attribute value of the specified port. When the value other than the port attribute value is specified, the specified port must be "TYPE=FIBRE or FCoE package and ATTR=TAR". If not, this command is rejected with EX_ENOOBJ. When using a package of Fiber Channel over Ethernet, specify Port speed: 10G, Port topology: f_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. Syntax raidcom get parity_grp [-parity_grp_id ] Options and parameters Option Description [-parity_grp_id ] Specifies the parity group number (gno: 1-32, sgno: 1-16). If this option is omitted, the list of parity groups defined in the storage system is displayed.
P_NO: Displays the partition number partitioning this Parity Group. LDEV#: Displays LDEV number. STS: Displays the following status. • NML: LDEV is installed or free space is settled. • REG: LDEV is being created. • DEL: LDEV is being deleted. LOC_LBA: Displays the Start of LBA for this partition on this Parity Group, in units of 512 bytes. SIZE_LBA: Displays the size for this partition on this Parity Group, in units of 512 bytes. Serial#: Product serial number.
Option Description -mcu_port Specifies the port number of 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). Example Register P9500 of Serial number: 64034 with CU free. Sets the path group ID: 0, the port on MCU: CL1-A, and the port on RCU: CL1-B.
Syntax raidcom get rcu [-rcu -ssid | -cu_free Options and parameters Option Description -rcu Specifies the CU specified by serial number, , . For XP7 Storage, specify the number of which 300,000 is added to the serial number for . You can use hexadecimal numbers (add "0x" prefix) or decimal numbers for and . -ssid Specifies the subsystem ID.
• ERR: Failing • UNK: Unknown, displayed when the target of the pair is MCU. MP: Displays the number of path as minimum. NP: Displays the number of path setting between MCU and RCU. IM: 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: Displays the freeze option. • D: the freeze option is disabled. • E: the freeze option is enabled.
• - ERR_80: RCU Port Number Mismatch • - ERR_81: RCU Port Type Mismatch • - ERR_82: Communication Failed. If the path creation or the path deletion is in progress, "-" is displayed. -SSIDs: Displays the SSIDs (hexadecimal) setting to RCU. If CU free is specified for RCU, "-" is displayed. raidcom modify rcu This sets the control parameters to specified CU that is specified using two way.
Examples For the RCU for which the product number: 64034, the RAID type: R700 and the path ID: 1 are set, setting the options: the minimum number of paths 4, RIO MIH time15 seconds, and round trip time 20 milliseconds 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.
This command is executed asynchronously with the command input. Check the completion of this process on the raidcom get command_status command. Syntax raidcom delete rcu_path {-rcu -ssid | -cu_free } -mcu_port -rcu_port Options and parameters Option Description -rcu Specifies the CU specified by serial number, , and .
Options and parameters Option Description -rcu Specifies the CU specified by serial number, , , and . For XP7 Storage, specify the number of which 300,000 is added to the serial number for . 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". • For XP24000/XP20000 Disk Array, use "R600".
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. Lock_owner: owner (authorized user) who locks the resource group name. Lock_host: host name of a user who locks the resource group name.
Option Description When
Options and parameters Option Description -pool_id Specifies the Pool ID (0-127) of a Fast Snap or Snapshot pool. If a -pool_id option is non-numeric, the specified value is recognized as a pool name to identify the pool ID. When you omit specifying -pool_id option, you need to specify -pool_name option. When specifying -pool_name option without specifying -pool_id option, a pool ID is allocated automatically.
Using LDEVs:500, 501, and 502, creating a pool of Pool ID: Allocated automatically, Pool Name: my_ss_pool for Snapshot. # raidcom add snap_pool -pool_name my_ss_pool -ldev_id 500 501 502 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.
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. Specify either one of Pool ID or Pool Name certainly. If both the Pool ID and Pool Name options are omitted, this command is 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.
Option Description If the device name is omitted, all the LDEVs belonging in the device group are operated. When the -pool_name option is omitted, the device group name will change into the pool name. [-user_threshold [] ] 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.
Option Description 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. When you specify only digits, it is recognized as a pool ID. When the pool name consists of digits, specify the pool ID instead of the pool name.
002 80 POLF AUT 54 100 MON PND 1 2 PM - - 500000 1000000 When you specify -pool, displays the range for each tiering level of corresponding pools.
is displayed. If the -fix option is specified, this displays the value in parentheses given in hexadecimal. TD_RANGE: Delta 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.
Examples Giving the nickname of "ORA_NODE0_CTL_0" to the connection host "WWN: 210000e0,8b0256f8" to which the port: CL4-E and host group #0 are set. # raidcom set hba_wwn -port CL4-E-0 -hba_wwn 210000e0,8b0256f8 -wwn_nickname ORA_NODE0_CTL_0 raidcom reset hba_wwn Deletes the nickname from the specified WWN on the specified port. If there is no specified port, the command is rejected with EX_ENOOBJ.
Examples Starting the performance monitoring of a pool for Smart Tiers/Smart Tiers Z with Pool ID: 20. # raidcom monitor pool -pool 20 -operation start Starting the performance monitoring of a pool for Smart Tiers/Smart Tiers Z with Pool Name: my_tier_pool. # raidcom monitor pool -pool my_tier_pool -operation start Stopping the performance monitoring of a pool for Smart Tiers/Smart Tiers Z with Pool ID: 20.
However, an error from the second time occurrence, error codes of SSB1 and SSB2 will not be stored. To be able to refer the error code when an error occurs, reset the error information that is stored by the storage system by executing raidcom reset command_status before and after executing asynchronous command. Syntax raidcom get command_status [-time ] Options and parameters Option Description [-time ] Specifies waiting time to complete the process of asynchronous command.
raidcom add resource Creating resource groups. If you specify only the resource group name, an empty resource group is created. When you input a resource group name and a resource group ID, the current name of the resource group whose ID you specify is changed to the new resource group name. When you specify resource group name, LDEV number, port number, host group number, parity group ID or an external group ID, the specified resource is registered to the specified resource group.
# raidcom add resource -resource_name sql_srv -ldev_id 400 Adding a port of CL1-A to a resource group: sql_srv. # raidcom add resource -resource_name sql_srv -port CL1-A Adding a host group of CL1-A-0 to a resource group: sql_srv. # raidcom add resource -resource_name sql_srv -port CL1-A-0 Adding a parity group:5-2 to a resource group: sql_srv. # raidcom add resource -resource_name sql_srv -parity_grp_id 5-2 Adding an external volume group:01-02 to a resource group: sql_srv.
# raidcom delete resource -resource_name sql_srv -ldev_id 400 Deleting a port of CL1-A from the resource group: sql_srv. # raidcom delete resource -resource_name sql_srv -port CL1-A Deleting a host group of CL1-A-0 from the resource group: sql_srv. # raidcom delete resource -resource_name sql_srv -port CL1-A-0 Deleting a parity group: 5-2 from the resource group: sql_srv.
WP_CAP(MB): capacity of write pending data of the CLPR SF_CAP(MB): capacity of sidefiles of the CLPR U(%): usage rate of cache memory of the CLPR W(%): rate of write pending data of the CLPR S(%): usage rate of sidefiles of the CLPR raidcom modify clpr Modifies a CLPR. Syntax raidcom modify clpr -clpr { -ldev_id | -parity_grp_id | -external_grp_id } Options and parameters Option Description -clpr Specifies a CLPR number (0-31).
Options and parameters Option Description -ldev_id Specifies the LDEV number to be created the snapshot data. LDEV numbers for P-VOL and S-VOL must be included. -pool { | } Specifies the pool ID or the pool name created for Snapshot. -snapshotgroup Specifies a name to be given for snapshot group. [-snap_mode ] Specifies the mode to create a snapshot group. The following mode can be specified: = CTG: For creating in CTG mode.
# raidcom delete snapshot -snapshotgroup db1 Deleting the snapshot data of the P-VOL (LDEV number 10:10) and the Mirror ID (10). # raidcom delete snapshot -ldev_id 0x1010 –mirror_id 10 Deleting the snapshot data of the LDEV number 10:10 that is included in the snapshot group (db1). # raidcom delete snapshot -ldev_id 0x1010 -snapshotgroup db1 # raidcom delete snapshot -snapshotgroup db1 -ldev_id 0x1010 Deleting the snapshot data of the S-VOL (LDEV number 20:10).
When discarding or restoring the snapshot data (when specifying resync/restore) # The ways to specify the parameter CTG mode normal mode 1 LDEV number and snapshot group. P-VOL in the snapshot group. P-VOL in the snapshot group and the smallest number of MU. 2 LDEV number and MU Specified P-VOL and MU number. number. Specified P-VOL and MU number. 3 LDEV number only (Specifying S-VOL). P-VOL and MU number that are mapped by the specified S-VOL.
Option Description • PFUL: Indicates that the Fast Snap or Snapshot pool exceeds the threshold in the PAIR status. • PFUS: Indicates that the Fast Snap or Snapshot pool exceeds the threshold in the PSUS status. • RCPY: Shows that the copying is in progress by resynchronization. If the snapshot group or the snapshot data is in the specified state, the operation ends normally.
P/S: Displays the attribute of the target LDEV. It displays P-VOL for the P-VOL and S-VOL for the S-VOL. In the list of snapshot, "-" is displayed. STAT: Displays the status of each snapshot data. For details, see “pairdisplay” (page 56). Serial#: Displays the product serial number. For XP7 Storage, the number of which 300,000 is added to the serial number is displayed. LDEV#: Displays the LDEV number related to the snapshot. MU#: Displays the Mirror ID.
Options and parameters Option Description -port Specifies the port number whose attribute is Target. For example: • CL1-A -pfc_group Specifies the PFC group name and PFC name. [] Up to 64 characters can be specified by CLI. If a is omitted, you must specify the -hba_wwn option. PFC group names are managed uniquely in the entire system. -hba_wwn Specifies PFC target WWN. WWN is specified in hexadecimal of 16 digits. The 17th digit is ignored.
Options and parameters Option Description -port Specifies the port number whose attribute is Target. For example: • CL1-A -pfc_group Specifies the PFC group name. Up to 64 characters can be specified by CLI. Examples Deletes the PFC group (WWN_GRP_LINUX). # raidcom delete pfc_group -port CL4-E -pfc_group WWN_GRP_LINUX raidcom modify pfc_wwn Specifies the Performance Control information to the Performance Control target WWN.
# raidcom modify pfc_wwn -port CL4-E -pfc_priority n -limit_mb 500 -pfc_name WWN_NICK_LINUX Specifies WWN (50060e8005fa0f36) as preferred WWN, and specifies 5000/[I/O] (I/O rate) as the threshold value. # raidcom modify pfc_wwn -port CL4-E -pfc_priority y -limit_io 5000 -hba_wwn 50060e80,05fa0f36 Specifies the PFC name (WWN_NICK_LINUX) as preferred WWN, and specifies 500000[KB/s] (transmission rate) as the maximum value.
Specifies the PFC group name (WWN_GRP_LINUX) as preferred WWN, and specifies 500000[KB/s] (transmission rate) as the threshold value. # raidcom modify pfc_group –port CL4-E –pfc_priority y –limit_kb 500000 –pfc_group WWN_GRP_LINUX Deletes the PFC information of the PFC group name (WWN_GRP_LINUX). # raidcom modify pfc_group –port CL4-E –pfc_group WWN_GRP_LINUX raidcom get pfc_wwn Gets the Performance Control information of the Performance Control target WWN.
Displays the PFC group name to which the WWN belongs. If the WWN does not belong to the group, a hyphen (-) is displayed. Serial# Displays the Seq#. For XP7 Storage, the number of which 300,000 is added to the serial number is displayed. PRI Displays the settings of the priority. • Y: Preferred • N: Non-preferred IOps 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 transferred rate (KBps), displays a hyphen (-).
Displays the settings of the priority. • Y: Preferred • N: Non-preferred IOps 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 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 IO rate (IOps), displays a hyphen (-).
KBps Displays the current transferred rate (KBps) of the specified WWN or the specified PFC name. Serial# Displays the Seq#. For XP7 Storage, the number of which 300,000 is added to the serial number is displayed. raidcom monitor pfc_group Gets the monitoring information of Performance Control target WWN by the Performance Control group unit. Syntax raidcom monitor pfc_group -pfc_group Options and parameters Option Description -pfc_group Specifies the PFC group name.
6 Support and other resources Contacting HP For worldwide technical support information, see the HP support website: http://www.hp.
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 20 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 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.
to be associated with 1 to 36 LDEVs. Essentially, LUSE makes it possible for applications to access a single large pool of storage. M-VOL Main volume. MCU Main control unit. OPEN-x A general term describing any of the supported OPEN emulation modes (for example, OPEN-E). There are two types of OPEN-x devices: legacy OPEN-x devices with a fixed size (such as OPEN-3, OPEN-8, OPEN-9, and OPEN-E), and OPEN-V, which has a variable size and is a CVS-based volume.
Index C contacting HP, 230 conventions document, 231 storage capacity values, 231 text symbols, 232 D document conventions, 231 related information, 230 documentation HP website, 230 providing feedback, 230 H help obtaining, 230 HP subscription service, 230 technical support, 230 R related documentation, 230 S storage capacity values conventions, 231 subscription service, HP, 230 symbols in text, 232 T technical support HP, 230 service locator website, 231 text symbols, 232 typographic conventions, 231
