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

DescriptionOption
specified raw_device is contained in two or more groups, the command is executed for the first
group.
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[g] <seq#>
<LDEV#> [MU#]
(-d) or group (-dg). This option is effective without specification of '-g <group>' option. If the
specified LDEV is contained in two or more groups, the command is executed on the first group.
The <seq #> <LDEV #> values can be specified in hexadecimal (add the '0x' prefix) or decimal
notation.
Selects and executes SVOL-takeover. The target volume of the local host must be an S-VOL. If this
option is specified, then the following '-l' option is invalid.
-S
Enables read and write to the primary volume(s) by a local host only without a remote host, and
executes PVOL-takeover when the primary volume cannot be used because it is fenced (fence =
-l
DATA or STATUS, state = PSUE or PDUB, or PSUE or PDUB volume is contained in the group).
If the primary volume can be accessed, nop-takeover is executed. The target volume of the local
host must be a P-VOL.
Can be specified for asynchronous pairs only, ignored for synchronous pairs. Specifies the
maximum time to wait (in seconds) for swap-takeover and SVOL-takeover operation to synchronize
-t <timeout>
the P-VOL and S-VOL. If this timeout occurs, the horctakeover command fails with EX_EWSTOT.
To avoid timeout, set this value less than or equal to the start-up timeout value of the HA control
script.
Suppresses messages to be displayed when this command is executed. This option must be
specified at beginning of a command argument. The command execution log is not affected by
this option.
-nomsg
Returned values
The horctakeover command sets the following returned values during exit allowing you to check
the execution results.
Normal termination:
0: Nop-takeover (no operation).
1: Swap-takeover was successfully executed.
2: SVOL-takeover was successfully executed.
3: PVOL-SMPL-takeover was successfully executed.
4: PVOL-PSUE-takeover was successfully executed. (This value depends on the microcode level.)
5: SVOL-SSUS-takeover was successfully executed. (This value depends on the microcode level.)
Abnormal termination: other than 0-5, refer to the error codes for error details.
Error codes
The following table lists and describes the error codes for the horctakeover command. 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.
Table 17 Specific error codes for horctakeover
ValueRecommended ActionError MessageError CodeCategory
236Confirm status using pairdisplay
command. Make sure all volumes in the
Unmatched volume
status within the group
EX_ENQVOLVolume status
(Unrecoverable)
group have the same fence level and
volume attributes.
229Confirm pair status using pairdisplay.Inconsistent status in
group
EX_INCSTG
horctakeover 67